Skip to content

Conversation

@HavenDV
Copy link
Contributor

@HavenDV HavenDV commented Sep 4, 2025

Summary by CodeRabbit

  • Breaking Changes

    • Removed support for the deprecated word_boost and boost_param fields from transcript requests and responses. Applications using these fields must migrate by removing their usage.
  • Documentation

    • Updated transcript parameter examples and descriptions to exclude the deprecated fields and reflect current behavior.

@coderabbitai
Copy link

coderabbitai bot commented Sep 4, 2025

Walkthrough

Removed word_boost and boost_param properties from transcript-related OpenAPI schemas and examples in src/libs/AssemblyAI/openapi.yaml. TranscriptBoostParam type remains but is no longer referenced. Minor documentation whitespace tweak.

Changes

Cohort / File(s) Summary of Changes
OpenAPI schema updates
src/libs/AssemblyAI/openapi.yaml
Removed word_boost and boost_param from TranscriptOptionalParams and Transcript; scrubbed examples/references from TranscriptParams; retained TranscriptBoostParam definition unused; minor whitespace fix in list transcripts description.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

I twitch my ears at schemas pared,
Two little fields—now unimpaired.
The boost has hopped beyond the spec,
Examples trimmed, a tidy check.
With YAML paths so clean and neat,
I thump my paws—change is complete! 🐇✨

✨ Finishing Touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch bot/update-openapi_202509041825

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore or @coderabbit ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@HavenDV HavenDV merged commit ecd9bd3 into main Sep 4, 2025
2 of 4 checks passed
@HavenDV HavenDV deleted the bot/update-openapi_202509041825 branch September 4, 2025 18:26
@coderabbitai coderabbitai bot changed the title feat:@coderabbitai feat:Remove word_boost and boost_param from transcript OpenAPI schemas Sep 4, 2025
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (4)
src/libs/AssemblyAI/openapi.yaml (4)

1263-1269: Schema bug: use items, not objects, for arrays.

expected_languages uses objects: which is invalid JSON Schema/OpenAPI. This will break generators/validators.

Apply:

 expected_languages:
   x-label: Minimum speakers expected
   description: List of languages expected in the audio file. Defaults to `["all"]` when unspecified.
   type: array
-  objects:
+  items:
     x-label: language
     type: string

2634-2641: Same array bug in Transcript shape.

Duplicate of the above issue in the read-only language_detection_options.expected_languages.

 expected_languages:
   x-label: Minimum speakers expected
   description: List of languages expected in the audio file. Defaults to `["all"]` when unspecified.
   type: array
-  objects:
+  items:
     x-label: language
     type: string

1396-1403: Normalize substitution policy wording to match enum values.

Docs say entity_type in some places and entity_name elsewhere, while enum = entity_name | hash. Align descriptions to entity_name.

- description: The replacement logic for detected PII, can be `entity_type` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/models/pii-redaction) for more details.
+ description: The replacement logic for detected PII, can be `entity_name` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/models/pii-redaction) for more details.

And in SubstitutionPolicy:

- description: The replacement logic for detected PII, can be `entity_name` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/models/pii-redaction) for more details.
+ description: The replacement logic for detected PII, can be `entity_name` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/models/pii-redaction) for more details.

Also applies to: 1893-1906


2210-2222: Fix typo and stray enum label in SpeechModel.

  • Typo: “mutli-language” → “multi-language”.
  • x-aai-enum contains nano which is not in enum list. Remove or add to enum (likely remove).
       description: The model optimized for accuracy, low latency, ease of use, and mu
-      tli-language support.
+      lti-language support.
...
-      x-aai-enum:
-        best:
-          label: Best
-        nano:
-          label: Nano
+      x-aai-enum:
+        best:
+          label: Best

(If nano should exist, add it to the enum and document accordingly instead.)

🧹 Nitpick comments (3)
src/libs/AssemblyAI/openapi.yaml (3)

1691-1706: Orphan type: deprecate or remove TranscriptBoostParam.

TranscriptBoostParam is no longer referenced; keep it only if you need legacy SDKs, but mark it deprecated and ignore for Fern to avoid surfacing unused types.

-    TranscriptBoostParam:
+    TranscriptBoostParam:
       type: string
       x-label: Word boost level
-      description: How much to boost specified words
+      description: (Deprecated) Previously used to control word boosting. No longer supported.
       x-fern-sdk-group-name: transcripts
+      deprecated: true
+      x-fern-ignore: true

5106-5113: Fix prev_url description (points to previous page, not next).

Minor doc accuracy issue.

-          description: The URL to the next page of transcripts. The previous URL always points to a page with older transcripts.
+          description: The URL to the previous page of transcripts. The previous URL always points to a page with older transcripts.

1330-1333: Grammar: “We sends” → “We send”.

User-facing docs.

-            We sends two different types of webhook requests.
+            We send two different types of webhook requests.

Also applies to: 2746-2749

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between e6bc237 and 53117fe.

⛔ Files ignored due to path filters (4)
  • src/libs/AssemblyAI/Generated/AssemblyAI.ITranscriptClient.ListTranscripts.g.cs is excluded by !**/generated/**
  • src/libs/AssemblyAI/Generated/AssemblyAI.Models.Transcript.g.cs is excluded by !**/generated/**
  • src/libs/AssemblyAI/Generated/AssemblyAI.Models.TranscriptOptionalParams.g.cs is excluded by !**/generated/**
  • src/libs/AssemblyAI/Generated/AssemblyAI.TranscriptClient.ListTranscripts.g.cs is excluded by !**/generated/**
📒 Files selected for processing (1)
  • src/libs/AssemblyAI/openapi.yaml (1 hunks)
🔇 Additional comments (1)
src/libs/AssemblyAI/openapi.yaml (1)

175-175: LGTM on copy tweak.

Whitespace/wording adjustment reads fine.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants