@framers/agentos 0.1.168 → 0.1.169

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

@@ -13,11 +13,11 @@
  *
  * ## `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.
+ * - `getNodeInput(nodeId)` delegates to `pipeline.waitForUserTurn()` when a
+ *   pipeline is available, or falls back to listening for `turn_complete` on
+ *   the transport directly.
+ * - `deliverNodeOutput(nodeId, output)` delegates to `pipeline.pushToTTS()`
+ *   and emits a `voice_audio` outbound GraphEvent.
  * - Both methods throw if called before `init()`.
  *
  * ## Lazy initialisation
@@ -51,19 +51,6 @@ import type { GraphEvent } from '../events/GraphEvent.js';
  *
  * 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'`). */
@@ -98,22 +85,14 @@ export interface VoiceTransportConfig {
  *
  * 1. Construct with {@link VoiceTransportConfig}, an `IStreamTransport`, and an
  *    event sink callback.
- * 2. Call `init()` once before the graph starts running. This injects the
- *    transport into `state.scratch.voiceTransport` and emits a `voice_session`
- *    started event.
+ * 2. Call `init()` once before the graph starts running. This lazily imports
+ *    `VoicePipelineOrchestrator`, creates an instance, and injects the transport
+ *    into `state.scratch.voiceTransport`.
  * 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.
+ *    Delegates to `pipeline.waitForUserTurn()` when a pipeline is available.
+ * 4. Use `deliverNodeOutput()` to send the node's response to TTS via
+ *    `pipeline.pushToTTS()`.
  * 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 `VoiceNodeExecutor` for the executor that interacts with the transport.
  */
 export declare class VoiceTransportAdapter {
     private readonly config;
@@ -122,7 +101,6 @@ export declare class VoiceTransportAdapter {
     /**
      * Lazily-initialised `VoicePipelineOrchestrator` instance.
      * Typed as `any` to avoid a hard import cycle with the voice subsystem.
-     * In a full implementation this would be `VoicePipelineOrchestrator | null`.
      */
     private pipeline;
     /**
@@ -133,11 +111,8 @@ export declare class VoiceTransportAdapter {
     /**
      * 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 config     - Voice pipeline configuration knobs.
+     * @param transport  - Bidirectional audio/control stream transport (`IStreamTransport`).
      * @param eventSink  - Callback receiving all `GraphEvent` values emitted by
      *                     this adapter. Must not throw.
      */
@@ -146,73 +121,36 @@ export declare class VoiceTransportAdapter {
     /**
      * Initialise the adapter.
      *
-     * Injects the `IStreamTransport` instance into `state.scratch.voiceTransport`
-     * so that voice graph nodes (specifically `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 `getNodeInput()` or
-     * `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.
+     * Lazily imports `VoicePipelineOrchestrator`, creates an instance from config,
+     * injects the transport into `state.scratch.voiceTransport`, and emits a
+     * `voice_session` started event.
      */
     init(state: Partial<GraphState>): Promise<void>;
     /**
      * 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
-     * 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 with the transport-level turn lifecycle.
-     *
-     * @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()` or after `dispose()`.
+     * Delegates to `VoicePipelineOrchestrator.waitForUserTurn()` when a pipeline
+     * is available. Falls back to listening for `turn_complete` on the transport.
      */
     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
-     * 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; 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()`.
+     * Delegates to `VoicePipelineOrchestrator.pushToTTS()` when a pipeline is
+     * available, then emits a `voice_audio` outbound GraphEvent.
      */
-    deliverNodeOutput(nodeId: string, _output: string | AsyncIterable<string>): Promise<void>;
+    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,
-     * stop TTS playback, or reroute the graph).
-     *
-     * @see {@link VoiceInterruptError} -- the structured error used inside the graph executor.
+     * Emits a `voice_barge_in` event so that graph event consumers can react.
      */
     handleBargeIn(): void;
     /**
      * Dispose the adapter and emit a `voice_session` ended event.
      *
-     * 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.
+     * Stops the pipeline if one was initialised, then marks the adapter as
+     * uninitialised so subsequent calls throw.
      */
     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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}
+{"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;;;;;;GAMG;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;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,qBAAqB;IAsB9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAvB5B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAoB;IAEpC;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;;;;OAOG;gBAEgB,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,GAAG,EAAE,mBAAmB;IACnC,SAAS,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI;IAOzD;;;;;;OAMG;IACG,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCrD;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuCnD;;;;;OAKG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB9F;;;;OAIG;IACH,aAAa,IAAI,IAAI;IAarB;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAc/B"}

package/dist/orchestration/runtime/VoiceTransportAdapter.js

@@ -13,11 +13,11 @@
  *
  * ## `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.
+ * - `getNodeInput(nodeId)` delegates to `pipeline.waitForUserTurn()` when a
+ *   pipeline is available, or falls back to listening for `turn_complete` on
+ *   the transport directly.
+ * - `deliverNodeOutput(nodeId, output)` delegates to `pipeline.pushToTTS()`
+ *   and emits a `voice_audio` outbound GraphEvent.
  * - Both methods throw if called before `init()`.
  *
  * ## Lazy initialisation
@@ -53,32 +53,21 @@
  *
  * 1. Construct with {@link VoiceTransportConfig}, an `IStreamTransport`, and an
  *    event sink callback.
- * 2. Call `init()` once before the graph starts running. This injects the
- *    transport into `state.scratch.voiceTransport` and emits a `voice_session`
- *    started event.
+ * 2. Call `init()` once before the graph starts running. This lazily imports
+ *    `VoicePipelineOrchestrator`, creates an instance, and injects the transport
+ *    into `state.scratch.voiceTransport`.
  * 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.
+ *    Delegates to `pipeline.waitForUserTurn()` when a pipeline is available.
+ * 4. Use `deliverNodeOutput()` to send the node's response to TTS via
+ *    `pipeline.pushToTTS()`.
  * 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 `VoiceNodeExecutor` for the executor that interacts with the transport.
  */
 export class VoiceTransportAdapter {
     /**
      * 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 config     - Voice pipeline configuration knobs.
+     * @param transport  - Bidirectional audio/control stream transport (`IStreamTransport`).
      * @param eventSink  - Callback receiving all `GraphEvent` values emitted by
      *                     this adapter. Must not throw.
      */
@@ -90,9 +79,8 @@ export class VoiceTransportAdapter {
         /**
          * Lazily-initialised `VoicePipelineOrchestrator` instance.
          * Typed as `any` to avoid a hard import cycle with the voice subsystem.
-         * In a full implementation this would be `VoicePipelineOrchestrator | null`.
          */
-        this.pipeline = null; // VoicePipelineOrchestrator (lazy)
+        this.pipeline = null;
         /**
          * Tracks whether `init()` has been called successfully.
          * Set to `false` by `dispose()` to prevent use-after-teardown.
@@ -105,24 +93,30 @@ export class VoiceTransportAdapter {
     /**
      * Initialise the adapter.
      *
-     * Injects the `IStreamTransport` instance into `state.scratch.voiceTransport`
-     * so that voice graph nodes (specifically `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 `getNodeInput()` or
-     * `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.
+     * Lazily imports `VoicePipelineOrchestrator`, creates an instance from config,
+     * injects the transport into `state.scratch.voiceTransport`, and emits a
+     * `voice_session` started event.
      */
     async init(state) {
         var _a;
-        // 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;
+        // Lazily import to avoid hard dependency cycle with the voice subsystem
+        try {
+            const { VoicePipelineOrchestrator } = await import('../../voice-pipeline/VoicePipelineOrchestrator.js');
+            this.pipeline = new VoicePipelineOrchestrator({
+                stt: this.config.stt ?? 'deepgram',
+                tts: this.config.tts ?? 'elevenlabs',
+                endpointing: this.config.endpointing,
+                bargeIn: this.config.bargeIn,
+                voice: this.config.voice,
+                language: this.config.language,
+            });
+        }
+        catch {
+            // Pipeline unavailable — fall back to transport-only mode
+            this.pipeline = null;
+        }
         this.initialized = true;
         this.eventSink({
             type: 'voice_session',
@@ -130,33 +124,35 @@ export class VoiceTransportAdapter {
             action: 'started',
         });
     }
+    // -------------------------------------------------------------------------
+    // Node I/O
+    // -------------------------------------------------------------------------
     /**
      * 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
-     * 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 with the transport-level turn lifecycle.
-     *
-     * @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()` or after `dispose()`.
+     * Delegates to `VoicePipelineOrchestrator.waitForUserTurn()` when a pipeline
+     * is available. Falls back to listening for `turn_complete` on the transport.
      */
     async getNodeInput(nodeId) {
         if (!this.initialized) {
             throw new Error('VoiceTransportAdapter not initialized');
         }
-        // In the full implementation this would delegate to:
-        //   this.pipeline.waitForUserTurn()
-        // For now, listen directly to transport events for the next turn.
+        // Delegate to pipeline if available
+        if (this.pipeline?.waitForUserTurn) {
+            const turnEvent = await this.pipeline.waitForUserTurn();
+            const transcript = turnEvent?.transcript ?? '';
+            this.eventSink({
+                type: 'voice_turn_complete',
+                nodeId,
+                transcript,
+                turnIndex: 0,
+                endpointReason: turnEvent?.reason ?? 'unknown',
+            });
+            return transcript;
+        }
+        // Fallback: listen on transport directly
         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',
@@ -172,27 +168,17 @@ 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
-     * 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; 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()`.
+     * Delegates to `VoicePipelineOrchestrator.pushToTTS()` when a pipeline is
+     * available, then emits a `voice_audio` outbound GraphEvent.
      */
-    async deliverNodeOutput(nodeId, _output) {
+    async deliverNodeOutput(nodeId, output) {
         if (!this.initialized) {
             throw new Error('VoiceTransportAdapter not initialized');
         }
-        // In the full implementation this would delegate to:
-        //   this.pipeline.pushToTTS(output)
-        // For now, emit the event to signal delivery.
+        // Delegate to pipeline TTS if available
+        if (this.pipeline?.pushToTTS) {
+            await this.pipeline.pushToTTS(output);
+        }
         this.eventSink({
             type: 'voice_audio',
             nodeId,
@@ -207,12 +193,7 @@ 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,
-     * stop TTS playback, or reroute the graph).
-     *
-     * @see {@link VoiceInterruptError} -- the structured error used inside the graph executor.
+     * Emits a `voice_barge_in` event so that graph event consumers can react.
      */
     handleBargeIn() {
         this.eventSink({
@@ -228,13 +209,13 @@ export class VoiceTransportAdapter {
     /**
      * Dispose the adapter and emit a `voice_session` ended event.
      *
-     * 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.
+     * Stops the pipeline if one was initialised, then marks the adapter as
+     * uninitialised so subsequent calls throw.
      */
     async dispose() {
+        if (this.pipeline?.stopSession) {
+            await this.pipeline.stopSession('adapter-disposed');
+        }
         this.eventSink({
             type: 'voice_session',
             nodeId: '__transport__',
@@ -242,6 +223,7 @@ export class VoiceTransportAdapter {
             exitReason: 'transport-disposed',
         });
         this.initialized = false;
+        this.pipeline = null;
     }
 }
 //# sourceMappingURL=VoiceTransportAdapter.js.map

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"VoiceTransportAdapter.js","sourceRoot":"","sources":["../../../src/orchestration/runtime/VoiceTransportAdapter.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos",
-  "version": "0.1.168",
+  "version": "0.1.169",
   "description": "Modular AgentOS orchestration library",
   "type": "module",
   "main": "dist/index.js",