Skip to content

feat(types): add typed support for Speech Understanding action_items request and response - #205

Open
pylrn wants to merge 1 commit into
AssemblyAI:mainfrom
pylrn:feat/speech-understanding-action-items
Open

pylrn wants to merge 1 commit into
AssemblyAI:mainfrom
pylrn:feat/speech-understanding-action-items

Conversation

@pylrn

@pylrn pylrn commented Nov 6, 2026

Copy link
Copy Markdown

Summary

Adds typed support for the Speech Understanding action_items feature (ActionItemsRequest, ActionItem, ActionItemsResponse) to SpeechUnderstandingFeatureRequests and SpeechUnderstandingFeatureResponses in the AssemblyAI Node SDK.

While Speech Understanding features like translation, speaker_identification, custom_formatting, and summarization were already typed under speech_understanding.request and speech_understanding.response (and mentioned in comments in src/types/llm-gateway/index.ts), action_items was missing from the SDK's TypeScript types. Setting action_items in TranscriptParams caused TypeScript compiler errors, and receiving speech_understanding.response.action_items required type assertions.

This brings the Node SDK to full parity with the AssemblyAI API, assemblyai-mcp, and the Python SDK.

Changes

  • src/types/openapi.generated.ts:
    • Added ActionItemsRequest type with include_decisions (boolean) and effort (SpeechUnderstandingEffort).
    • Added ActionItem type (action_item, quote, timestamp).
    • Added ActionItemsResponse type (status, effort, items).
    • Added action_items?: ActionItemsRequest to SpeechUnderstandingFeatureRequests.
    • Added action_items?: ActionItemsResponse to SpeechUnderstandingFeatureResponses.
  • package.json & CHANGELOG.md:
    • Incremented version 4.42.0 -> 4.42.1 with matching changelog entry to satisfy the Version Bump Check CI workflow.
  • tests/unit/speech-understanding-action-items.test.ts:
    • Added unit tests verifying typed submission of action_items (include_decisions, effort) through client.transcripts.submit and response typing.
  • tests/unit/exports.test.ts:
    • Added test verifying root export reachability for ActionItemsRequest, ActionItem, and ActionItemsResponse.

Verification

  • npx tsc --noEmit: Clean (0 errors)
  • npx rollup -c: Successfully compiled all 12 distribution bundles (ESM, CJS, Deno, Bun, workerd, browser, UMD)
  • npx prettier --check: Clean formatting across all touched files
  • npx eslint: Clean (0 errors)
  • Unit tests: tests/unit/speech-understanding-action-items.test.ts and tests/unit/exports.test.ts pass cleanly

…request and response

- Add ActionItemsRequest type with include_decisions and effort options
- Add ActionItem and ActionItemsResponse types
- Add action_items to SpeechUnderstandingFeatureRequests and SpeechUnderstandingFeatureResponses
- Bump version to 4.42.1 with matching CHANGELOG.md entry for Version Bump Check workflow
- Add unit tests in tests/unit/speech-understanding-action-items.test.ts
- Update root exports test in tests/unit/exports.test.ts

This branch has not been deployed

No deployments
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.

1 participant