@framers/agentos 0.1.111 → 0.1.113

package/dist/orchestration/runtime/VoiceTransportAdapter.d.ts

@@ -3,16 +3,28 @@
  * @description Bridges graph I/O to the voice pipeline when a workflow runs in
  * voice transport mode.
  *
+ * ## Purpose
+ *
  * `VoiceTransportAdapter` wraps a graph's input/output cycle so that:
  * - **Node input** is obtained by waiting for the user's next speech turn
  *   (`waitForUserTurn()` on the underlying `VoicePipelineOrchestrator`).
  * - **Node output** is delivered to the TTS engine (`pushToTTS()` on the
  *   underlying `VoicePipelineOrchestrator`).
  *
- * The adapter is lazy — it does not create a `VoicePipelineOrchestrator` until
- * `init()` is called.  The pipeline reference is `any` typed to avoid a hard
- * import cycle with the voice subsystem; callers that want stronger types may
- * cast.
+ * ## `getNodeInput` / `deliverNodeOutput` contract
+ *
+ * - `getNodeInput(nodeId)` blocks until the transport emits a `turn_complete`
+ *   event, then resolves with the transcript string. It also emits a
+ *   `voice_turn_complete` GraphEvent so the runtime event bus stays in sync.
+ * - `deliverNodeOutput(nodeId, output)` sends text (or a streaming async
+ *   iterable) to TTS and emits a `voice_audio` outbound GraphEvent.
+ * - Both methods throw if called before `init()`.
+ *
+ * ## Lazy initialisation
+ *
+ * The adapter is lazy -- it does not create a `VoicePipelineOrchestrator` until
+ * `init()` is called. The pipeline reference is `any` typed to avoid a hard
+ * import cycle with the voice subsystem; callers that want stronger types may cast.
  *
  * @example
  * ```typescript
@@ -27,6 +39,9 @@
  * await adapter.deliverNodeOutput('greet', 'Hello, how can I help you today?');
  * await adapter.dispose();
  * ```
+ *
+ * @see {@link VoiceNodeExecutor} -- the executor that consumes this adapter's events.
+ * @see {@link VoiceTransportConfig} -- configuration knobs forwarded to the pipeline.
  */
 import type { GraphState } from '../ir/types.js';
 import type { GraphEvent } from '../events/GraphEvent.js';
@@ -34,8 +49,21 @@ import type { GraphEvent } from '../events/GraphEvent.js';
  * Configuration knobs forwarded to the voice pipeline when the adapter
  * initialises its internal `VoicePipelineOrchestrator` instance.
  *
- * All fields are optional — defaults are resolved from agent.config.json or
- * sensible library defaults.
+ * All fields are optional -- defaults are resolved from agent.config.json or
+ * sensible library defaults within the voice pipeline itself.
+ *
+ * @example
+ * ```ts
+ * const config: VoiceTransportConfig = {
+ *   stt: 'deepgram',
+ *   tts: 'elevenlabs',
+ *   voice: 'rachel',
+ *   bargeIn: 'hard-cut',
+ *   endpointing: 'semantic',
+ *   diarization: true,
+ *   language: 'en-US',
+ * };
+ * ```
  */
 export interface VoiceTransportConfig {
     /** STT provider identifier (e.g. `'deepgram'`, `'openai'`). */
@@ -46,16 +74,16 @@ export interface VoiceTransportConfig {
     voice?: string;
     /**
      * Barge-in handling strategy.
-     * - `'hard-cut'`  — interrupt TTS immediately when speech is detected.
-     * - `'soft-fade'` — ramp TTS volume down before cutting.
-     * - `'disabled'`  — ignore user speech while the agent is speaking.
+     * - `'hard-cut'`  -- interrupt TTS immediately when speech is detected.
+     * - `'soft-fade'` -- ramp TTS volume down before cutting.
+     * - `'disabled'`  -- ignore user speech while the agent is speaking.
      */
     bargeIn?: string;
     /**
      * Endpoint detection mode used to decide when the user has finished speaking.
-     * - `'acoustic'`  — energy/VAD-based detection.
-     * - `'heuristic'` — punctuation + silence heuristics.
-     * - `'semantic'`  — LLM-assisted turn boundary detection.
+     * - `'acoustic'`  -- energy/VAD-based detection.
+     * - `'heuristic'` -- punctuation + silence heuristics.
+     * - `'semantic'`  -- LLM-assisted turn boundary detection.
      */
     endpointing?: string;
     /** Whether to enable speaker diarization for multi-speaker sessions. */
@@ -66,13 +94,26 @@ export interface VoiceTransportConfig {
 /**
  * Adapts a compiled graph's I/O cycle to the real-time voice pipeline.
  *
- * Lifecycle:
+ * ## Lifecycle
+ *
  * 1. Construct with {@link VoiceTransportConfig}, an `IStreamTransport`, and an
  *    event sink callback.
- * 2. Call `init()` once before the graph starts running.
+ * 2. Call `init()` once before the graph starts running. This injects the
+ *    transport into `state.scratch.voiceTransport` and emits a `voice_session`
+ *    started event.
  * 3. Use `getNodeInput()` to obtain the user's transcribed speech for a node.
+ *    Blocks until the transport emits a `turn_complete` event.
  * 4. Use `deliverNodeOutput()` to send the node's response to TTS.
  * 5. Call `dispose()` to clean up resources when the session ends.
+ *
+ * ## Error handling
+ *
+ * Both `getNodeInput()` and `deliverNodeOutput()` throw `Error` if called
+ * before `init()`. After `dispose()`, the adapter is marked as uninitialised
+ * so subsequent calls also throw.
+ *
+ * @see {@link VoiceTransportConfig} -- the config shape forwarded to the pipeline.
+ * @see {@link VoiceNodeExecutor} -- the executor that interacts with the transport.
  */
 export declare class VoiceTransportAdapter {
     private readonly config;
@@ -84,24 +125,35 @@ export declare class VoiceTransportAdapter {
      * In a full implementation this would be `VoicePipelineOrchestrator | null`.
      */
     private pipeline;
-    /** Tracks whether `init()` has been called successfully. */
+    /**
+     * Tracks whether `init()` has been called successfully.
+     * Set to `false` by `dispose()` to prevent use-after-teardown.
+     */
     private initialized;
     /**
-     * @param config     - Voice pipeline configuration knobs.
-     * @param transport  - Bidirectional audio/control stream transport (`IStreamTransport`).
-     * @param eventSink  - Callback receiving all `GraphEvent` values emitted by this adapter.
+     * Creates a new VoiceTransportAdapter.
+     *
+     * @param config     - Voice pipeline configuration knobs. Forwarded to the
+     *                     pipeline when it is initialised.
+     * @param transport  - Bidirectional audio/control stream transport
+     *                     (`IStreamTransport`). Must be an EventEmitter that
+     *                     emits `turn_complete` events for `getNodeInput()`.
+     * @param eventSink  - Callback receiving all `GraphEvent` values emitted by
+     *                     this adapter. Must not throw.
      */
     constructor(config: VoiceTransportConfig, transport: any, // IStreamTransport
     eventSink: (event: GraphEvent) => void);
     /**
      * Initialise the adapter.
      *
-     * Injects the `IStreamTransport` instance into `state.scratch.voiceTransport` so
-     * that graph nodes can access it if needed, then emits a `voice_session` started
-     * event to signal that the voice session is live.
+     * Injects the `IStreamTransport` instance into `state.scratch.voiceTransport`
+     * so that voice graph nodes (specifically {@link VoiceNodeExecutor}) can access
+     * the transport for session event subscription. Then emits a `voice_session`
+     * started event to signal that the voice session is live.
      *
      * Must be called exactly once before {@link getNodeInput} or
-     * {@link deliverNodeOutput}.
+     * {@link deliverNodeOutput}. Calling `init()` multiple times is safe but
+     * redundant -- the transport reference is simply overwritten.
      *
      * @param state - Mutable `GraphState` (or partial) for the current run.
      *               `state.scratch` is created lazily if absent.
@@ -111,39 +163,46 @@ export declare class VoiceTransportAdapter {
      * Wait for the user's next speech turn and return the transcript text.
      *
      * In a full production implementation this delegates to
-     * `VoicePipelineOrchestrator.waitForUserTurn()`.  In the current implementation
+     * `VoicePipelineOrchestrator.waitForUserTurn()`. In the current implementation
      * it listens for a single `'turn_complete'` event from the underlying transport
      * and resolves with the transcript text.
      *
      * Also emits a {@link GraphEvent} of type `voice_turn_complete` so that the
-     * runtime event bus stays in sync.
+     * runtime event bus stays in sync with the transport-level turn lifecycle.
      *
-     * @param nodeId - The id of the graph node requesting input; used to tag the emitted event.
+     * @param nodeId - The id of the graph node requesting input; used to tag the
+     *                emitted event for downstream filtering.
      * @returns Resolved transcript string from the user's speech turn.
-     * @throws {Error} If called before `init()`.
+     * @throws {Error} If called before `init()` or after `dispose()`.
      */
     getNodeInput(nodeId: string): Promise<string>;
     /**
      * Deliver a node's text output to the TTS engine.
      *
      * Accepts either a plain `string` or an `AsyncIterable<string>` of token
-     * chunks (e.g. a streaming LLM response).  In a full production implementation
+     * chunks (e.g. a streaming LLM response). In a full production implementation
      * this delegates to `VoicePipelineOrchestrator.pushToTTS(output)`.
      *
      * Emits a {@link GraphEvent} of type `voice_audio` (direction `'outbound'`)
      * so that the runtime event bus records the TTS delivery.
      *
-     * @param nodeId - The id of the graph node delivering the output.
-     * @param output - Text or async token stream to synthesise as speech.
-     * @throws {Error} If called before `init()`.
+     * @param nodeId - The id of the graph node delivering the output; tags the
+     *                emitted event for downstream filtering.
+     * @param _output - Text or async token stream to synthesise as speech.
+     *                 The underscore prefix indicates it is not yet consumed
+     *                 in the v1 stub implementation.
+     * @throws {Error} If called before `init()` or after `dispose()`.
      */
     deliverNodeOutput(nodeId: string, _output: string | AsyncIterable<string>): Promise<void>;
     /**
      * Handle a user barge-in at the transport level.
      *
      * Should be called by the runtime or transport layer when the user starts
-     * speaking while the agent is mid-utterance.  Emits a `voice_barge_in` event
-     * so that graph event consumers can react (e.g. cancel pending tool calls).
+     * speaking while the agent is mid-utterance. Emits a `voice_barge_in` event
+     * so that graph event consumers can react (e.g. cancel pending tool calls,
+     * stop TTS playback, or reroute the graph).
+     *
+     * @see {@link VoiceInterruptError} -- the structured error used inside the graph executor.
      */
     handleBargeIn(): void;
     /**
@@ -151,6 +210,9 @@ export declare class VoiceTransportAdapter {
      *
      * Marks the adapter as uninitialised so subsequent calls to `getNodeInput()`
      * or `deliverNodeOutput()` will throw, preventing accidental use after teardown.
+     *
+     * This method is idempotent -- calling it multiple times simply re-emits the
+     * ended event and re-sets the initialised flag.
      */
     dispose(): Promise<void>;
 }

package/dist/orchestration/runtime/VoiceTransportAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VoiceTransportAdapter.d.ts","sourceRoot":"","sources":["../../../src/orchestration/runtime/VoiceTransportAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAM1D;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;GAUG;AACH,qBAAa,qBAAqB;IAiB9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAlB5B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAoB;IAEpC,4DAA4D;IAC5D,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;OAIG;gBAEgB,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,GAAG,EAAE,mBAAmB;IACnC,SAAS,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI;IAOzD;;;;;;;;;;;;OAYG;IACG,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAarD;;;;;;;;;;;;;;OAcG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBnD;;;;;;;;;;;;;OAaG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB/F;;;;;;OAMG;IACH,aAAa,IAAI,IAAI;IAarB;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAS/B"}
+{"version":3,"file":"VoiceTransportAdapter.d.ts","sourceRoot":"","sources":["../../../src/orchestration/runtime/VoiceTransportAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAM1D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,wEAAwE;IACxE,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,qBAAqB;IA0B9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IA3B5B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAoB;IAEpC;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;;;;;;;OAUG;gBAEgB,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,GAAG,EAAE,mBAAmB;IACnC,SAAS,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI;IAOzD;;;;;;;;;;;;;;OAcG;IACG,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAcrD;;;;;;;;;;;;;;;OAeG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2BnD;;;;;;;;;;;;;;;;OAgBG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB/F;;;;;;;;;OASG;IACH,aAAa,IAAI,IAAI;IAarB;;;;;;;;OAQG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAS/B"}

package/dist/orchestration/runtime/VoiceTransportAdapter.js

@@ -3,16 +3,28 @@
  * @description Bridges graph I/O to the voice pipeline when a workflow runs in
  * voice transport mode.
  *
+ * ## Purpose
+ *
  * `VoiceTransportAdapter` wraps a graph's input/output cycle so that:
  * - **Node input** is obtained by waiting for the user's next speech turn
  *   (`waitForUserTurn()` on the underlying `VoicePipelineOrchestrator`).
  * - **Node output** is delivered to the TTS engine (`pushToTTS()` on the
  *   underlying `VoicePipelineOrchestrator`).
  *
- * The adapter is lazy — it does not create a `VoicePipelineOrchestrator` until
- * `init()` is called.  The pipeline reference is `any` typed to avoid a hard
- * import cycle with the voice subsystem; callers that want stronger types may
- * cast.
+ * ## `getNodeInput` / `deliverNodeOutput` contract
+ *
+ * - `getNodeInput(nodeId)` blocks until the transport emits a `turn_complete`
+ *   event, then resolves with the transcript string. It also emits a
+ *   `voice_turn_complete` GraphEvent so the runtime event bus stays in sync.
+ * - `deliverNodeOutput(nodeId, output)` sends text (or a streaming async
+ *   iterable) to TTS and emits a `voice_audio` outbound GraphEvent.
+ * - Both methods throw if called before `init()`.
+ *
+ * ## Lazy initialisation
+ *
+ * The adapter is lazy -- it does not create a `VoicePipelineOrchestrator` until
+ * `init()` is called. The pipeline reference is `any` typed to avoid a hard
+ * import cycle with the voice subsystem; callers that want stronger types may cast.
  *
  * @example
  * ```typescript
@@ -27,6 +39,9 @@
  * await adapter.deliverNodeOutput('greet', 'Hello, how can I help you today?');
  * await adapter.dispose();
  * ```
+ *
+ * @see {@link VoiceNodeExecutor} -- the executor that consumes this adapter's events.
+ * @see {@link VoiceTransportConfig} -- configuration knobs forwarded to the pipeline.
  */
 // ---------------------------------------------------------------------------
 // VoiceTransportAdapter
@@ -34,19 +49,38 @@
 /**
  * Adapts a compiled graph's I/O cycle to the real-time voice pipeline.
  *
- * Lifecycle:
+ * ## Lifecycle
+ *
  * 1. Construct with {@link VoiceTransportConfig}, an `IStreamTransport`, and an
  *    event sink callback.
- * 2. Call `init()` once before the graph starts running.
+ * 2. Call `init()` once before the graph starts running. This injects the
+ *    transport into `state.scratch.voiceTransport` and emits a `voice_session`
+ *    started event.
  * 3. Use `getNodeInput()` to obtain the user's transcribed speech for a node.
+ *    Blocks until the transport emits a `turn_complete` event.
  * 4. Use `deliverNodeOutput()` to send the node's response to TTS.
  * 5. Call `dispose()` to clean up resources when the session ends.
+ *
+ * ## Error handling
+ *
+ * Both `getNodeInput()` and `deliverNodeOutput()` throw `Error` if called
+ * before `init()`. After `dispose()`, the adapter is marked as uninitialised
+ * so subsequent calls also throw.
+ *
+ * @see {@link VoiceTransportConfig} -- the config shape forwarded to the pipeline.
+ * @see {@link VoiceNodeExecutor} -- the executor that interacts with the transport.
  */
 export class VoiceTransportAdapter {
     /**
-     * @param config     - Voice pipeline configuration knobs.
-     * @param transport  - Bidirectional audio/control stream transport (`IStreamTransport`).
-     * @param eventSink  - Callback receiving all `GraphEvent` values emitted by this adapter.
+     * Creates a new VoiceTransportAdapter.
+     *
+     * @param config     - Voice pipeline configuration knobs. Forwarded to the
+     *                     pipeline when it is initialised.
+     * @param transport  - Bidirectional audio/control stream transport
+     *                     (`IStreamTransport`). Must be an EventEmitter that
+     *                     emits `turn_complete` events for `getNodeInput()`.
+     * @param eventSink  - Callback receiving all `GraphEvent` values emitted by
+     *                     this adapter. Must not throw.
      */
     constructor(config, transport, // IStreamTransport
     eventSink) {
@@ -59,7 +93,10 @@ export class VoiceTransportAdapter {
          * In a full implementation this would be `VoicePipelineOrchestrator | null`.
          */
         this.pipeline = null; // VoicePipelineOrchestrator (lazy)
-        /** Tracks whether `init()` has been called successfully. */
+        /**
+         * Tracks whether `init()` has been called successfully.
+         * Set to `false` by `dispose()` to prevent use-after-teardown.
+         */
         this.initialized = false;
     }
     // -------------------------------------------------------------------------
@@ -68,19 +105,22 @@ export class VoiceTransportAdapter {
     /**
      * Initialise the adapter.
      *
-     * Injects the `IStreamTransport` instance into `state.scratch.voiceTransport` so
-     * that graph nodes can access it if needed, then emits a `voice_session` started
-     * event to signal that the voice session is live.
+     * Injects the `IStreamTransport` instance into `state.scratch.voiceTransport`
+     * so that voice graph nodes (specifically {@link VoiceNodeExecutor}) can access
+     * the transport for session event subscription. Then emits a `voice_session`
+     * started event to signal that the voice session is live.
      *
      * Must be called exactly once before {@link getNodeInput} or
-     * {@link deliverNodeOutput}.
+     * {@link deliverNodeOutput}. Calling `init()` multiple times is safe but
+     * redundant -- the transport reference is simply overwritten.
      *
      * @param state - Mutable `GraphState` (or partial) for the current run.
      *               `state.scratch` is created lazily if absent.
      */
     async init(state) {
         var _a;
-        // Lazily create the scratch bag if the caller passed a partial state.
+        // Lazily create the scratch bag if the caller passed a partial state
+        // without a pre-existing scratch object.
         const scratch = ((_a = state).scratch ?? (_a.scratch = {}));
         scratch.voiceTransport = this.transport;
         this.initialized = true;
@@ -94,25 +134,29 @@ export class VoiceTransportAdapter {
      * Wait for the user's next speech turn and return the transcript text.
      *
      * In a full production implementation this delegates to
-     * `VoicePipelineOrchestrator.waitForUserTurn()`.  In the current implementation
+     * `VoicePipelineOrchestrator.waitForUserTurn()`. In the current implementation
      * it listens for a single `'turn_complete'` event from the underlying transport
      * and resolves with the transcript text.
      *
      * Also emits a {@link GraphEvent} of type `voice_turn_complete` so that the
-     * runtime event bus stays in sync.
+     * runtime event bus stays in sync with the transport-level turn lifecycle.
      *
-     * @param nodeId - The id of the graph node requesting input; used to tag the emitted event.
+     * @param nodeId - The id of the graph node requesting input; used to tag the
+     *                emitted event for downstream filtering.
      * @returns Resolved transcript string from the user's speech turn.
-     * @throws {Error} If called before `init()`.
+     * @throws {Error} If called before `init()` or after `dispose()`.
      */
     async getNodeInput(nodeId) {
         if (!this.initialized) {
             throw new Error('VoiceTransportAdapter not initialized');
         }
-        // In real implementation: this.pipeline.waitForUserTurn()
-        // For now, listen directly to transport events.
+        // In the full implementation this would delegate to:
+        //   this.pipeline.waitForUserTurn()
+        // For now, listen directly to transport events for the next turn.
         return new Promise((resolve) => {
             this.transport.once('turn_complete', (evt) => {
+                // Accept both `transcript` and `text` fields for compatibility
+                // with different transport implementations.
                 const transcript = evt?.transcript ?? evt?.text ?? '';
                 this.eventSink({
                     type: 'voice_turn_complete',
@@ -129,21 +173,25 @@ export class VoiceTransportAdapter {
      * Deliver a node's text output to the TTS engine.
      *
      * Accepts either a plain `string` or an `AsyncIterable<string>` of token
-     * chunks (e.g. a streaming LLM response).  In a full production implementation
+     * chunks (e.g. a streaming LLM response). In a full production implementation
      * this delegates to `VoicePipelineOrchestrator.pushToTTS(output)`.
      *
      * Emits a {@link GraphEvent} of type `voice_audio` (direction `'outbound'`)
      * so that the runtime event bus records the TTS delivery.
      *
-     * @param nodeId - The id of the graph node delivering the output.
-     * @param output - Text or async token stream to synthesise as speech.
-     * @throws {Error} If called before `init()`.
+     * @param nodeId - The id of the graph node delivering the output; tags the
+     *                emitted event for downstream filtering.
+     * @param _output - Text or async token stream to synthesise as speech.
+     *                 The underscore prefix indicates it is not yet consumed
+     *                 in the v1 stub implementation.
+     * @throws {Error} If called before `init()` or after `dispose()`.
      */
     async deliverNodeOutput(nodeId, _output) {
         if (!this.initialized) {
             throw new Error('VoiceTransportAdapter not initialized');
         }
-        // In real implementation: this.pipeline.pushToTTS(output)
+        // In the full implementation this would delegate to:
+        //   this.pipeline.pushToTTS(output)
         // For now, emit the event to signal delivery.
         this.eventSink({
             type: 'voice_audio',
@@ -160,8 +208,11 @@ export class VoiceTransportAdapter {
      * Handle a user barge-in at the transport level.
      *
      * Should be called by the runtime or transport layer when the user starts
-     * speaking while the agent is mid-utterance.  Emits a `voice_barge_in` event
-     * so that graph event consumers can react (e.g. cancel pending tool calls).
+     * speaking while the agent is mid-utterance. Emits a `voice_barge_in` event
+     * so that graph event consumers can react (e.g. cancel pending tool calls,
+     * stop TTS playback, or reroute the graph).
+     *
+     * @see {@link VoiceInterruptError} -- the structured error used inside the graph executor.
      */
     handleBargeIn() {
         this.eventSink({
@@ -179,6 +230,9 @@ export class VoiceTransportAdapter {
      *
      * Marks the adapter as uninitialised so subsequent calls to `getNodeInput()`
      * or `deliverNodeOutput()` will throw, preventing accidental use after teardown.
+     *
+     * This method is idempotent -- calling it multiple times simply re-emits the
+     * ended event and re-sets the initialised flag.
      */
     async dispose() {
         this.eventSink({

package/dist/orchestration/runtime/VoiceTransportAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"VoiceTransportAdapter.js","sourceRoot":"","sources":["../../../src/orchestration/runtime/VoiceTransportAdapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"VoiceTransportAdapter.js","sourceRoot":"","sources":["../../../src/orchestration/runtime/VoiceTransportAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AA8DH,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,qBAAqB;IAchC;;;;;;;;;;OAUG;IACH,YACmB,MAA4B,EAC5B,SAAc,EAAE,mBAAmB;IACnC,SAAsC;QAFtC,WAAM,GAAN,MAAM,CAAsB;QAC5B,cAAS,GAAT,SAAS,CAAK;QACd,cAAS,GAAT,SAAS,CAA6B;QA3BzD;;;;WAIG;QACK,aAAQ,GAAe,IAAI,CAAC,CAAC,mCAAmC;QAExE;;;WAGG;QACK,gBAAW,GAAG,KAAK,CAAC;IAiBzB,CAAC;IAEJ,4EAA4E;IAC5E,YAAY;IACZ,4EAA4E;IAE5E;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,IAAI,CAAC,KAA0B;;QACnC,qEAAqE;QACrE,yCAAyC;QACzC,MAAM,OAAO,GAAG,OAAE,KAAa,EAAC,OAAO,QAAP,OAAO,GAAK,EAAE,EAAC,CAAC;QAChD,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAExB,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,eAAe;YACvB,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,YAAY,CAAC,MAAc;QAC/B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,qDAAqD;QACrD,oCAAoC;QACpC,kEAAkE;QAClE,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;YACrC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,GAAQ,EAAE,EAAE;gBAChD,+DAA+D;gBAC/D,4CAA4C;gBAC5C,MAAM,UAAU,GAAW,GAAG,EAAE,UAAU,IAAI,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC;gBAE9D,IAAI,CAAC,SAAS,CAAC;oBACb,IAAI,EAAE,qBAAqB;oBAC3B,MAAM;oBACN,UAAU;oBACV,SAAS,EAAE,CAAC;oBACZ,cAAc,EAAE,GAAG,EAAE,MAAM,IAAI,SAAS;iBACzC,CAAC,CAAC;gBAEH,OAAO,CAAC,UAAU,CAAC,CAAC;YACtB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,iBAAiB,CAAC,MAAc,EAAE,OAAuC;QAC7E,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,qDAAqD;QACrD,oCAAoC;QACpC,8CAA8C;QAC9C,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,aAAa;YACnB,MAAM;YACN,SAAS,EAAE,UAAU;YACrB,MAAM,EAAE,KAAK;YACb,UAAU,EAAE,CAAC;SACd,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,WAAW;IACX,4EAA4E;IAE5E;;;;;;;;;OASG;IACH,aAAa;QACX,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,eAAe;YACvB,eAAe,EAAE,EAAE;YACnB,UAAU,EAAE,EAAE;SACf,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,WAAW;IACX,4EAA4E;IAE5E;;;;;;;;OAQG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,eAAe;YACvB,MAAM,EAAE,OAAO;YACf,UAAU,EAAE,oBAAoB;SACjC,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;CACF"}

package/dist/orchestration/runtime/VoiceTurnCollector.d.ts

@@ -3,39 +3,61 @@
  * @description Subscribes to voice pipeline session events and maintains a
  * running transcript buffer, turn counter, and last-speaker tracker.
  *
+ * ## Event bridging strategy
+ *
  * The collector bridges the raw EventEmitter-based voice pipeline session into
  * the typed `GraphEvent` stream consumed by the graph runtime. Four session
  * events are handled:
  *
- * - `interim_transcript` — partial STT result; forwarded as a non-final
- *   `voice_transcript` GraphEvent but **not** buffered (too noisy).
- * - `final_transcript` — confirmed STT result; buffered in `transcript` and
- *   forwarded as a final `voice_transcript` GraphEvent.
- * - `turn_complete` — endpoint detection fired; increments `turnCount` and
- *   emits a `voice_turn_complete` GraphEvent.
- * - `barge_in` — user interrupted the agent mid-speech; emits a
- *   `voice_barge_in` GraphEvent.
+ * | Session event        | GraphEvent emitted       | Buffered? | Why                                                    |
+ * |----------------------|--------------------------|-----------|--------------------------------------------------------|
+ * | `interim_transcript` | `voice_transcript`       | No        | Partials are noisy and would duplicate final entries.   |
+ * | `final_transcript`   | `voice_transcript`       | Yes       | Confirmed utterances form the canonical transcript.     |
+ * | `turn_complete`      | `voice_turn_complete`    | N/A       | Marks endpoint detection; advances the turn counter.    |
+ * | `barge_in`           | `voice_barge_in`         | N/A       | Signals user interruption for downstream handlers.      |
+ *
+ * ## Checkpoint restore
  *
  * The `initialTurnCount` constructor parameter enables checkpoint restore:
  * pass the previously persisted count so that `turnIndex` values continue
- * from where the session left off rather than resetting to zero.
+ * from where the session left off rather than resetting to zero. This is
+ * critical for `maxTurns` enforcement across graph suspensions.
+ *
+ * @see {@link VoiceNodeExecutor} -- creates and owns the collector during voice node execution.
+ * @see {@link VoiceNodeCheckpoint} -- persists `turnIndex` and `transcript` across suspensions.
  */
 import { EventEmitter } from 'events';
 import type { GraphEvent } from '../events/GraphEvent.js';
 /**
  * A single confirmed (final) utterance captured from the voice pipeline.
  *
- * Only `final_transcript` events populate this buffer — interim partials are
- * discarded to keep the transcript clean and avoid duplicate entries.
+ * Only `final_transcript` events populate the transcript buffer -- interim
+ * partials are discarded to keep the transcript clean and avoid duplicate
+ * entries that would corrupt downstream summarisation.
+ *
+ * @example
+ * ```ts
+ * const entry: TranscriptEntry = {
+ *   speaker: 'Speaker_0',
+ *   text: 'Hello, how can I help you?',
+ *   timestamp: Date.now(),
+ * };
+ * ```
  */
 export interface TranscriptEntry {
-    /** Speaker identifier as reported by the STT service (e.g. `"Speaker_0"`). */
+    /**
+     * Speaker identifier as reported by the STT service (e.g. `"Speaker_0"`).
+     * Defaults to `"user"` when the STT service does not provide diarization labels.
+     */
     speaker: string;
     /** Recognised text for this utterance. */
     text: string;
     /**
      * Wall-clock timestamp (milliseconds since Unix epoch) recorded at the
-     * moment the `final_transcript` event was processed.
+     * moment the `final_transcript` event was processed by the collector.
+     *
+     * This is the collector's receive time, not the STT service's recognition
+     * time, so it includes any event loop latency between STT and the collector.
      */
     timestamp: number;
 }
@@ -43,6 +65,11 @@ export interface TranscriptEntry {
  * Stateful collector that subscribes to a voice pipeline session and routes
  * session events into the AgentOS `GraphEvent` stream.
  *
+ * The collector is designed to be short-lived -- created at the start of a
+ * voice node execution and discarded when the node completes. Its state
+ * (transcript, turn count, last speaker) is captured into a
+ * {@link VoiceNodeCheckpoint} by the executor before disposal.
+ *
  * @example
  * ```ts
  * const collector = new VoiceTurnCollector(
@@ -56,39 +83,65 @@ export interface TranscriptEntry {
  * console.log(collector.getTranscript());  // full buffered transcript
  * console.log(collector.getLastSpeaker()); // last identified speaker
  * ```
+ *
+ * @see {@link TranscriptEntry} -- shape of each buffered transcript entry.
+ * @see {@link VoiceNodeExecutor} -- the executor that creates and queries the collector.
  */
 export declare class VoiceTurnCollector {
     private readonly eventSink;
     private readonly nodeId;
-    /** Buffered confirmed utterances in chronological order. */
+    /** Buffered confirmed utterances in chronological order. Append-only. */
     private transcript;
     /** Running count of completed turns (endpoint-detected). */
     private turnCount;
-    /** Speaker identifier from the most recent `final_transcript` event. */
+    /**
+     * Speaker identifier from the most recent `final_transcript` event.
+     * Empty string until the first final transcript arrives.
+     */
     private lastSpeaker;
     /**
+     * Creates a new VoiceTurnCollector and immediately subscribes to session events.
+     *
+     * Subscription is performed in the constructor (rather than a separate `init()`
+     * method) because the collector has no meaningful state before subscription and
+     * there is no cleanup/unsubscribe lifecycle -- the session EventEmitter is
+     * short-lived and garbage-collected with the collector.
+     *
      * @param session          - The voice pipeline `EventEmitter` to subscribe to.
-     * @param eventSink        - Callback invoked synchronously for every emitted `GraphEvent`.
-     * @param nodeId           - Identifies the owning graph node in every emitted event.
-     * @param initialTurnCount - Seed value for `turnCount`; pass a persisted value to
-     *                           resume from a checkpoint rather than starting at zero.
+     *                           Must emit `interim_transcript`, `final_transcript`,
+     *                           `turn_complete`, and `barge_in` events.
+     * @param eventSink        - Callback invoked synchronously for every emitted
+     *                           `GraphEvent`. Must not throw -- exceptions would
+     *                           propagate into the session event loop.
+     * @param nodeId           - Identifies the owning graph node in every emitted
+     *                           event, enabling consumers to filter events by node.
+     * @param initialTurnCount - Seed value for `turnCount`; pass a persisted value
+     *                           to resume from a checkpoint rather than starting at
+     *                           zero. Defaults to `0`.
      */
     constructor(session: EventEmitter, eventSink: (event: GraphEvent) => void, nodeId: string, initialTurnCount?: number);
     /**
      * Returns the total number of completed turns since construction (or since the
      * provided `initialTurnCount` when restoring from a checkpoint).
+     *
+     * @returns The current turn count. Always >= `initialTurnCount`.
      */
     getTurnCount(): number;
     /**
      * Returns a shallow copy of the buffered transcript entries.
      *
      * A copy is returned to prevent external callers from mutating the internal
-     * buffer — entries are append-only and must remain ordered.
+     * buffer -- entries are append-only and must remain in chronological order
+     * for correct checkpoint persistence.
+     *
+     * @returns A new array containing all confirmed transcript entries in order.
      */
     getTranscript(): TranscriptEntry[];
     /**
      * Returns the speaker identifier from the most recent `final_transcript` event,
      * or an empty string if no final transcript has been received yet.
+     *
+     * @returns The last speaker label, or `''` if none.
      */
     getLastSpeaker(): string;
 }

package/dist/orchestration/runtime/VoiceTurnCollector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VoiceTurnCollector.d.ts","sourceRoot":"","sources":["../../../src/orchestration/runtime/VoiceTurnCollector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAM1D;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAkB;IAmB3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAnBzB,4DAA4D;IAC5D,OAAO,CAAC,UAAU,CAAyB;IAE3C,4DAA4D;IAC5D,OAAO,CAAC,SAAS,CAAS;IAE1B,wEAAwE;IACxE,OAAO,CAAC,WAAW,CAAM;IAEzB;;;;;;OAMG;gBAED,OAAO,EAAE,YAAY,EACJ,SAAS,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,EACtC,MAAM,EAAE,MAAM,EAC/B,gBAAgB,SAAI;IA6EtB;;;OAGG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;OAKG;IACH,aAAa,IAAI,eAAe,EAAE;IAIlC;;;OAGG;IACH,cAAc,IAAI,MAAM;CAGzB"}
+{"version":3,"file":"VoiceTurnCollector.d.ts","sourceRoot":"","sources":["../../../src/orchestration/runtime/VoiceTurnCollector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAM1D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,kBAAkB;IAmC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAnCzB,yEAAyE;IACzE,OAAO,CAAC,UAAU,CAAyB;IAE3C,4DAA4D;IAC5D,OAAO,CAAC,SAAS,CAAS;IAE1B;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAM;IAEzB;;;;;;;;;;;;;;;;;;;OAmBG;gBAED,OAAO,EAAE,YAAY,EACJ,SAAS,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,EACtC,MAAM,EAAE,MAAM,EAC/B,gBAAgB,SAAI;IAqGtB;;;;;OAKG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;;;;OAQG;IACH,aAAa,IAAI,eAAe,EAAE;IAIlC;;;;;OAKG;IACH,cAAc,IAAI,MAAM;CAGzB"}