QVAC-19094 feat[api]: expose Sortformer v2.1 + AOSC streaming knobs in @qvac/sdk

[pratiknarola-t]

QVAC-19094 feat[api]: expose Sortformer v2.1 + AOSC streaming knobs in @qvac/sdk

🎯 What problem does this PR solve?

• @qvac/transcription-parakeet@0.5.0 added v2.1 Sortformer + AOSC
  (Audio-Online Speaker Cache) support natively, but @qvac/sdk
  exposed no way to opt into the new streaming/AOSC knobs. Consumers
  wanting v2.1's stable speaker-slot anchoring across silence and
  re-entry had to drop down to @qvac/transcription-parakeet
  directly, bypassing the SDK surface.
• The SDK-side surface was deferred from PR feat[api]: add Sortformer v2.1 + AOSC streaming diarization support #2137 (the parakeet PR)
  so the addon could land first; this PR re-applies it now that
  0.5.0 is published and the registry bump is merged.

📝 How does it solve it?

• Add 13 optional fields to parakeetRuntimeConfigSchema covering
  7 streaming-session knobs + 6 AOSC knobs; names, primitive types,
  and positive/non-negative refinements mirror the published addon's
  ParakeetConfig.
• Forward every field through parakeet-transcription/plugin.ts
  into the addon's parakeetConfig literal. The local
  ParakeetModelConfig type is extended with matching declarations
  so the SDK's strict TS settings
  (noPropertyAccessFromIndexSignature, etc.) accept the new
  config.streaming* accesses.
• Add a parakeet-sortformer-streaming.ts example demonstrating
  the streaming + AOSC path with a CLI-provided model source. Once
  the v2.1 GGUF entry lands in models.prod.json, the example
  switches to the auto-generated PARAKEET_SORTFORMER_STREAMING_V21_AOSC
  constant.

🧪 How was it tested?

• ./node_modules/.bin/tsc --noEmit -p tsconfig.json — clean
  (catches the ParakeetModelConfig extension; would fail without
  it under strict TS).
• bun run lint (eslint + typecheck) — clean.
• bun run test/unit/parakeet-schemas.test.ts — 8/8 pass, including
  two new cases: happy-path streaming + AOSC config, and rejection
  of negative streamingSpkCacheLen.
• bun run test/unit/plugin-cancel-capability.test.ts — 7/7
  (touches the parakeet plugin import surface, unchanged).

🔌 API Changes

New optional fields on parakeetConfigSchema / ParakeetConfig.
All .optional() — no breakage for existing callers. Auto-detected
on v2.1 GGUFs via the parakeet.model_variant metadata tag; ignored
by v1/v2 Sortformer and non-Sortformer engines.

import { loadModel } from "@qvac/sdk";

const modelId = await loadModel({
  modelSrc: "<v2.1-sortformer-src>",
  modelType: "parakeet",
  modelConfig: {
    modelType: "sortformer",
    parakeetSortformerSrc: "<v2.1-sortformer-src>",

    // Open a streaming session at load time.
    streaming: true,
    streamingChunkMs: 2000,
    streamingChunkRightContextMs: 560,

    // AOSC (v2.1+ only; auto-detected from GGUF metadata).
    streamingSpkCacheEnable: true,         // default; set false to A/B against v1 path
    streamingSpkCacheLen: 188,             // long-term speaker-cache rows
    streamingFifoLen: 188,                 // FIFO warmup buffer rows
    streamingChunkLeftContextMs: 80,       // ~1 encoder frame
    streamingSpkCacheUpdatePeriod: 144,    // FIFO-overflow pop count
  },
});

Depends on

• @qvac/transcription-parakeet >= 0.5.0 — already pinned on main.
• Registry-server PR for the v2.1 GGUF entry in
  packages/registry-server/data/models.prod.json (separate PR;
  drives the auto-generated PARAKEET_SORTFORMER_STREAMING_V21_AOSC
  constant).

[github-actions]

QVAC E2E — android — ✅ all tests passed (83/91, 3252s)

Config: suite=smoke · filter=(none) · exclude=(none)
View run · Artifacts: reports · Device Farm logs

[github-actions]

QVAC E2E — ios — ✅ all tests passed (82/91, 1078s)

Config: suite=smoke · filter=(none) · exclude=(none)
View run · Artifacts: reports · Device Farm logs

[github-actions]

QVAC E2E — windows — ✅ all tests passed (91/91, 373s)

Config: suite=smoke · filter=(none) · exclude=(none)
View run · Artifacts: reports

[github-actions]

QVAC E2E — linux — ❌ failed

Totals: 87/91 passed · 4 failed · 95.6% · 823s
Config: suite=smoke · filter=(none) · exclude=(none)
View run · Artifacts: reports

Results by section

• finetune: 0/1 ❌
• multi-gpu: 0/2 ❌
• vision: 2/3 ❌

Failed tests

• finetune-start-complete: Test timeout after 120s
• multi-gpu-config-smoke: Expected backendDevice=gpu, got cpu
• multi-gpu-embed-config-smoke: Expected backendDevice=gpu, got cpu
• vision-basic: None of the required strings found: elephant, tusk, trunk. Got: there is no animal in the image. the image only contains text.

[github-actions]

QVAC E2E — macos — ✅ all tests passed (91/91, 292s)

Config: suite=smoke · filter=(none) · exclude=(none)
View run · Artifacts: reports

[github-actions]

Tier-based Approval Status

**PR Tier:** TIER1

**Current Status:** ✅ APPROVED

**Requirements:**
- 1 Team Member approval ✅ (1/1)
- 1 Team Lead OR Management approval ✅ (1/1)



---
*This comment is automatically updated when reviews change.*

[ishanvohra2]

Just one minor comment