@framers/agentos 0.1.111 → 0.1.113

package/dist/orchestration/builders/VoiceNodeBuilder.d.ts

@@ -3,16 +3,27 @@
  * @description DSL builder for voice pipeline graph nodes.
  *
  * `voiceNode()` is the fluent factory for creating `GraphNode` IR entries of
- * type `'voice'`.  It mirrors the ergonomics of `gmiNode()` / `toolNode()` but
+ * type `'voice'`. It mirrors the ergonomics of `gmiNode()` / `toolNode()` but
  * targets the voice executor path, letting authors configure STT/TTS overrides,
  * turn limits, barge-in behaviour, and exit-reason routing in a single
  * declarative chain.
  *
- * Exit-reason routing is the key concept: voice nodes complete with a reason
- * string (e.g. `'completed'`, `'interrupted'`, `'hangup'`), and `on()` maps
- * each reason to the next node id.  These mappings are stored in `edges` on the
- * returned `GraphNode` and are intended to be expanded by the compiler into
- * `GraphEdge` objects during lowering.
+ * ## Exit-reason routing
+ *
+ * Voice nodes complete with a reason string (e.g. `'completed'`, `'interrupted'`,
+ * `'hangup'`, `'turns-exhausted'`, `'keyword:goodbye'`). The `on()` method maps
+ * each reason to the next node id. These mappings are stored in `edges` on the
+ * returned `GraphNode` and are expanded by the compiler into `GraphEdge` objects
+ * during lowering.
+ *
+ * ## Produced GraphNode fields
+ *
+ * | Field           | Value              | Rationale                                        |
+ * |-----------------|--------------------|--------------------------------------------------|
+ * | `type`          | `'voice'`          | Selects the VoiceNodeExecutor at runtime.        |
+ * | `executionMode` | `'react_bounded'`  | Voice nodes run a multi-turn loop, not one-shot. |
+ * | `effectClass`   | `'external'`       | Voice I/O touches the real world (audio).        |
+ * | `checkpoint`    | `'before'`         | Snapshot before session start for crash recovery.|
  *
  * @example
  * ```typescript
@@ -22,13 +33,23 @@
  *   .on('hangup', 'end')
  *   .build();
  * ```
+ *
+ * @see {@link VoiceNodeExecutor} -- the runtime executor that processes voice nodes.
+ * @see {@link VoiceNodeConfig} -- the configuration shape from the graph IR.
  */
 import type { GraphNode, VoiceNodeConfig } from '../ir/types.js';
 /**
  * Create a new {@link VoiceNodeBuilder} for a voice pipeline graph node.
  *
- * @param id     - Unique node identifier within the parent graph.
- * @param config - Voice pipeline configuration for this node.
+ * This is the primary entry point for the voice node DSL. Use the returned
+ * builder's `.on()` method to add exit-reason routes and `.build()` to
+ * produce the `GraphNode` IR object.
+ *
+ * @param id     - Unique node identifier within the parent graph. Must be
+ *                 unique across all nodes in the graph to avoid collision
+ *                 in the edge map and checkpoint scratch keys.
+ * @param config - Voice pipeline configuration for this node (mode, STT/TTS
+ *                 overrides, turn limits, exit conditions).
  * @returns A fluent builder; call `.on()` to add exit-reason routes and
  *          `.build()` to produce the `GraphNode` IR object.
  *
@@ -39,21 +60,28 @@ import type { GraphNode, VoiceNodeConfig } from '../ir/types.js';
  *   .on('hangup', 'cleanup')
  *   .build();
  * ```
+ *
+ * @see {@link VoiceNodeBuilder} -- the returned builder class.
  */
 export declare function voiceNode(id: string, config: VoiceNodeConfig): VoiceNodeBuilder;
 /**
  * Fluent DSL builder for voice graph nodes.
  *
- * Collects exit-reason → target-node mappings via {@link on} and produces a
+ * Collects exit-reason -> target-node mappings via {@link on} and produces a
  * fully-specified `GraphNode` via {@link build}.
  *
- * The builder is designed to be chained:
+ * The builder is designed to be chained. Each `on()` call returns `this`,
+ * enabling a declarative voice node definition:
+ *
  * ```typescript
  * voiceNode('listen', { mode: 'conversation', maxTurns: 5 })
  *   .on('completed', 'summarize')
  *   .on('interrupted', 'listen')
  *   .on('hangup', 'end')
  * ```
+ *
+ * @see {@link voiceNode} -- the factory function that creates builder instances.
+ * @see {@link VoiceNodeExecutor} -- resolves the exit reason and looks up the edge map.
  */
 export declare class VoiceNodeBuilder {
     /** The node id assigned at construction time. */
@@ -62,27 +90,46 @@ export declare class VoiceNodeBuilder {
     /**
      * Mapping from exit-reason string to target node id.
      * Populated by successive calls to {@link on}.
+     *
+     * Uses a `Map` rather than a plain object to preserve insertion order
+     * (useful for debugging) and to allow O(1) overwrites when `on()` is
+     * called with an already-registered reason.
      */
     private edgeMap;
     /**
-     * @param id     - Node identifier; exposed as a readonly property for introspection.
-     * @param config - `VoiceNodeConfig` forwarded to the node's `executorConfig`.
+     * Creates a new VoiceNodeBuilder.
+     *
+     * @param id     - Node identifier; exposed as a readonly property for
+     *                 introspection by callers that need to reference this
+     *                 node before building (e.g. for cross-node edge wiring).
+     * @param config - `VoiceNodeConfig` forwarded to the node's `executorConfig`
+     *                 at build time. Immutable after construction.
      */
     constructor(
     /** The node id assigned at construction time. */
     id: string, config: VoiceNodeConfig);
     /**
-     * Register an exit-reason → target-node route.
+     * Register an exit-reason -> target-node route.
      *
      * When the voice node's session ends with `exitReason`, the graph transitions
-     * to `target`.  Multiple calls to `on()` accumulate routes; calling `on()` with
+     * to `target`. Multiple calls to `on()` accumulate routes; calling `on()` with
      * a reason that was already registered overwrites the previous target.
      *
-     * @param exitReason - The reason string returned by the voice executor
-     *                     (e.g. `'completed'`, `'interrupted'`, `'hangup'`,
-     *                     `'turns-exhausted'`, `'silence-timeout'`).
+     * ## Common exit reasons
+     *
+     * | Reason              | When it fires                                    |
+     * |---------------------|--------------------------------------------------|
+     * | `'completed'`       | Session ended normally (catch-all).              |
+     * | `'turns-exhausted'` | `maxTurns` reached.                              |
+     * | `'hangup'`          | Transport disconnected.                          |
+     * | `'interrupted'`     | User barged in (VoiceInterruptError).            |
+     * | `'silence-timeout'` | No speech activity for 30 seconds.               |
+     * | `'keyword:<word>'`  | A `final_transcript` contained an exit keyword.  |
+     *
+     * @param exitReason - The reason string returned by the voice executor.
      * @param target     - Either the string id of the target node, or an object
-     *                     with an `id` property (compatible with builder instances).
+     *                     with an `id` property (compatible with other builder
+     *                     instances, e.g. `voiceNode('other', ...)`).
      * @returns `this` for fluent chaining.
      *
      * @example
@@ -100,16 +147,26 @@ export declare class VoiceNodeBuilder {
      *
      * The returned node has:
      * - `type: 'voice'` in sync with `executorConfig.type`.
-     * - `executionMode: 'react_bounded'` — voice nodes run a multi-turn loop.
-     * - `effectClass: 'external'` — voice I/O touches the real world.
-     * - `checkpoint: 'before'` — snapshot taken before the session starts so the
+     * - `executionMode: 'react_bounded'` -- voice nodes run a multi-turn loop.
+     * - `effectClass: 'external'` -- voice I/O touches the real world.
+     * - `checkpoint: 'before'` -- snapshot taken before the session starts so the
      *   run can be resumed from the start of the voice turn if the process crashes.
-     * - `edges` — plain object mapping exit-reason strings to target node ids,
-     *   populated from all `on()` calls.  The compiler is responsible for
+     * - `edges` -- plain object mapping exit-reason strings to target node ids,
+     *   populated from all `on()` calls. The compiler is responsible for
      *   expanding these into `GraphEdge` instances.
      *
-     * @returns A `GraphNode` cast to `any` to accommodate the `edges` extension
-     *          field not present on the base interface.
+     * @returns A `GraphNode` with the `edges` extension field. Cast to `any`
+     *          to accommodate the `edges` field not present on the base interface.
+     *
+     * @example
+     * ```typescript
+     * const node = voiceNode('greet', { mode: 'conversation' })
+     *   .on('completed', 'process')
+     *   .build();
+     *
+     * console.log(node.type);             // 'voice'
+     * console.log(node.edges.completed);  // 'process'
+     * ```
      */
     build(): GraphNode;
 }

package/dist/orchestration/builders/VoiceNodeBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VoiceNodeBuilder.d.ts","sourceRoot":"","sources":["../../../src/orchestration/builders/VoiceNodeBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAMjE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAE/E;AAMD;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAgB;IAYzB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAbzB;;;OAGG;IACH,OAAO,CAAC,OAAO,CAA6B;IAE5C;;;OAGG;;IAED,iDAAiD;IACxC,EAAE,EAAE,MAAM,EACF,MAAM,EAAE,eAAe;IAO1C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAY7D;;;;;;;;;;;;;;;OAeG;IACH,KAAK,IAAI,SAAS;CAWnB"}
+{"version":3,"file":"VoiceNodeBuilder.d.ts","sourceRoot":"","sources":["../../../src/orchestration/builders/VoiceNodeBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAMjE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAE/E;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAgB;IAqBzB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAtBzB;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO,CAA6B;IAE5C;;;;;;;;OAQG;;IAED,iDAAiD;IACxC,EAAE,EAAE,MAAM,EACF,MAAM,EAAE,eAAe;IAO1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAY7D;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,KAAK,IAAI,SAAS;CAcnB"}

package/dist/orchestration/builders/VoiceNodeBuilder.js

@@ -3,16 +3,27 @@
  * @description DSL builder for voice pipeline graph nodes.
  *
  * `voiceNode()` is the fluent factory for creating `GraphNode` IR entries of
- * type `'voice'`.  It mirrors the ergonomics of `gmiNode()` / `toolNode()` but
+ * type `'voice'`. It mirrors the ergonomics of `gmiNode()` / `toolNode()` but
  * targets the voice executor path, letting authors configure STT/TTS overrides,
  * turn limits, barge-in behaviour, and exit-reason routing in a single
  * declarative chain.
  *
- * Exit-reason routing is the key concept: voice nodes complete with a reason
- * string (e.g. `'completed'`, `'interrupted'`, `'hangup'`), and `on()` maps
- * each reason to the next node id.  These mappings are stored in `edges` on the
- * returned `GraphNode` and are intended to be expanded by the compiler into
- * `GraphEdge` objects during lowering.
+ * ## Exit-reason routing
+ *
+ * Voice nodes complete with a reason string (e.g. `'completed'`, `'interrupted'`,
+ * `'hangup'`, `'turns-exhausted'`, `'keyword:goodbye'`). The `on()` method maps
+ * each reason to the next node id. These mappings are stored in `edges` on the
+ * returned `GraphNode` and are expanded by the compiler into `GraphEdge` objects
+ * during lowering.
+ *
+ * ## Produced GraphNode fields
+ *
+ * | Field           | Value              | Rationale                                        |
+ * |-----------------|--------------------|--------------------------------------------------|
+ * | `type`          | `'voice'`          | Selects the VoiceNodeExecutor at runtime.        |
+ * | `executionMode` | `'react_bounded'`  | Voice nodes run a multi-turn loop, not one-shot. |
+ * | `effectClass`   | `'external'`       | Voice I/O touches the real world (audio).        |
+ * | `checkpoint`    | `'before'`         | Snapshot before session start for crash recovery.|
  *
  * @example
  * ```typescript
@@ -22,6 +33,9 @@
  *   .on('hangup', 'end')
  *   .build();
  * ```
+ *
+ * @see {@link VoiceNodeExecutor} -- the runtime executor that processes voice nodes.
+ * @see {@link VoiceNodeConfig} -- the configuration shape from the graph IR.
  */
 // ---------------------------------------------------------------------------
 // Factory
@@ -29,8 +43,15 @@
 /**
  * Create a new {@link VoiceNodeBuilder} for a voice pipeline graph node.
  *
- * @param id     - Unique node identifier within the parent graph.
- * @param config - Voice pipeline configuration for this node.
+ * This is the primary entry point for the voice node DSL. Use the returned
+ * builder's `.on()` method to add exit-reason routes and `.build()` to
+ * produce the `GraphNode` IR object.
+ *
+ * @param id     - Unique node identifier within the parent graph. Must be
+ *                 unique across all nodes in the graph to avoid collision
+ *                 in the edge map and checkpoint scratch keys.
+ * @param config - Voice pipeline configuration for this node (mode, STT/TTS
+ *                 overrides, turn limits, exit conditions).
  * @returns A fluent builder; call `.on()` to add exit-reason routes and
  *          `.build()` to produce the `GraphNode` IR object.
  *
@@ -41,6 +62,8 @@
  *   .on('hangup', 'cleanup')
  *   .build();
  * ```
+ *
+ * @see {@link VoiceNodeBuilder} -- the returned builder class.
  */
 export function voiceNode(id, config) {
     return new VoiceNodeBuilder(id, config);
@@ -51,21 +74,31 @@ export function voiceNode(id, config) {
 /**
  * Fluent DSL builder for voice graph nodes.
  *
- * Collects exit-reason → target-node mappings via {@link on} and produces a
+ * Collects exit-reason -> target-node mappings via {@link on} and produces a
  * fully-specified `GraphNode` via {@link build}.
  *
- * The builder is designed to be chained:
+ * The builder is designed to be chained. Each `on()` call returns `this`,
+ * enabling a declarative voice node definition:
+ *
  * ```typescript
  * voiceNode('listen', { mode: 'conversation', maxTurns: 5 })
  *   .on('completed', 'summarize')
  *   .on('interrupted', 'listen')
  *   .on('hangup', 'end')
  * ```
+ *
+ * @see {@link voiceNode} -- the factory function that creates builder instances.
+ * @see {@link VoiceNodeExecutor} -- resolves the exit reason and looks up the edge map.
  */
 export class VoiceNodeBuilder {
     /**
-     * @param id     - Node identifier; exposed as a readonly property for introspection.
-     * @param config - `VoiceNodeConfig` forwarded to the node's `executorConfig`.
+     * Creates a new VoiceNodeBuilder.
+     *
+     * @param id     - Node identifier; exposed as a readonly property for
+     *                 introspection by callers that need to reference this
+     *                 node before building (e.g. for cross-node edge wiring).
+     * @param config - `VoiceNodeConfig` forwarded to the node's `executorConfig`
+     *                 at build time. Immutable after construction.
      */
     constructor(
     /** The node id assigned at construction time. */
@@ -75,6 +108,10 @@ export class VoiceNodeBuilder {
         /**
          * Mapping from exit-reason string to target node id.
          * Populated by successive calls to {@link on}.
+         *
+         * Uses a `Map` rather than a plain object to preserve insertion order
+         * (useful for debugging) and to allow O(1) overwrites when `on()` is
+         * called with an already-registered reason.
          */
         this.edgeMap = new Map();
     }
@@ -82,17 +119,27 @@ export class VoiceNodeBuilder {
     // Fluent API
     // -------------------------------------------------------------------------
     /**
-     * Register an exit-reason → target-node route.
+     * Register an exit-reason -> target-node route.
      *
      * When the voice node's session ends with `exitReason`, the graph transitions
-     * to `target`.  Multiple calls to `on()` accumulate routes; calling `on()` with
+     * to `target`. Multiple calls to `on()` accumulate routes; calling `on()` with
      * a reason that was already registered overwrites the previous target.
      *
-     * @param exitReason - The reason string returned by the voice executor
-     *                     (e.g. `'completed'`, `'interrupted'`, `'hangup'`,
-     *                     `'turns-exhausted'`, `'silence-timeout'`).
+     * ## Common exit reasons
+     *
+     * | Reason              | When it fires                                    |
+     * |---------------------|--------------------------------------------------|
+     * | `'completed'`       | Session ended normally (catch-all).              |
+     * | `'turns-exhausted'` | `maxTurns` reached.                              |
+     * | `'hangup'`          | Transport disconnected.                          |
+     * | `'interrupted'`     | User barged in (VoiceInterruptError).            |
+     * | `'silence-timeout'` | No speech activity for 30 seconds.               |
+     * | `'keyword:<word>'`  | A `final_transcript` contained an exit keyword.  |
+     *
+     * @param exitReason - The reason string returned by the voice executor.
      * @param target     - Either the string id of the target node, or an object
-     *                     with an `id` property (compatible with builder instances).
+     *                     with an `id` property (compatible with other builder
+     *                     instances, e.g. `voiceNode('other', ...)`).
      * @returns `this` for fluent chaining.
      *
      * @example
@@ -114,16 +161,26 @@ export class VoiceNodeBuilder {
      *
      * The returned node has:
      * - `type: 'voice'` in sync with `executorConfig.type`.
-     * - `executionMode: 'react_bounded'` — voice nodes run a multi-turn loop.
-     * - `effectClass: 'external'` — voice I/O touches the real world.
-     * - `checkpoint: 'before'` — snapshot taken before the session starts so the
+     * - `executionMode: 'react_bounded'` -- voice nodes run a multi-turn loop.
+     * - `effectClass: 'external'` -- voice I/O touches the real world.
+     * - `checkpoint: 'before'` -- snapshot taken before the session starts so the
      *   run can be resumed from the start of the voice turn if the process crashes.
-     * - `edges` — plain object mapping exit-reason strings to target node ids,
-     *   populated from all `on()` calls.  The compiler is responsible for
+     * - `edges` -- plain object mapping exit-reason strings to target node ids,
+     *   populated from all `on()` calls. The compiler is responsible for
      *   expanding these into `GraphEdge` instances.
      *
-     * @returns A `GraphNode` cast to `any` to accommodate the `edges` extension
-     *          field not present on the base interface.
+     * @returns A `GraphNode` with the `edges` extension field. Cast to `any`
+     *          to accommodate the `edges` field not present on the base interface.
+     *
+     * @example
+     * ```typescript
+     * const node = voiceNode('greet', { mode: 'conversation' })
+     *   .on('completed', 'process')
+     *   .build();
+     *
+     * console.log(node.type);             // 'voice'
+     * console.log(node.edges.completed);  // 'process'
+     * ```
      */
     build() {
         return {
@@ -133,8 +190,11 @@ export class VoiceNodeBuilder {
             executionMode: 'react_bounded',
             effectClass: 'external',
             checkpoint: 'before',
+            // The edges field is an extension not present on the base GraphNode
+            // interface. It is consumed by the graph compiler during lowering and
+            // by VoiceNodeExecutor for runtime route resolution.
             edges: Object.fromEntries(this.edgeMap),
-        }; // GraphNode has more required fields; cast for builder convenience
+        }; // Cast required because GraphNode's base interface doesn't declare `edges`.
     }
 }
 //# sourceMappingURL=VoiceNodeBuilder.js.map

package/dist/orchestration/builders/VoiceNodeBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"VoiceNodeBuilder.js","sourceRoot":"","sources":["../../../src/orchestration/builders/VoiceNodeBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,SAAS,CAAC,EAAU,EAAE,MAAuB;IAC3D,OAAO,IAAI,gBAAgB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,gBAAgB;IAO3B;;;OAGG;IACH;IACE,iDAAiD;IACxC,EAAU,EACF,MAAuB;QAD/B,OAAE,GAAF,EAAE,CAAQ;QACF,WAAM,GAAN,MAAM,CAAiB;QAb1C;;;WAGG;QACK,YAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAUzC,CAAC;IAEJ,4EAA4E;IAC5E,aAAa;IACb,4EAA4E;IAE5E;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,EAAE,CAAC,UAAkB,EAAE,MAA+B;QACpD,IAAI,CAAC,OAAO,CAAC,GAAG,CACd,UAAU,EACV,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAChD,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4EAA4E;IAC5E,cAAc;IACd,4EAA4E;IAE5E;;;;;;;;;;;;;;;OAeG;IACH,KAAK;QACH,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,OAAO;YACb,cAAc,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE;YAC3D,aAAa,EAAE,eAAe;YAC9B,WAAW,EAAE,UAAU;YACvB,UAAU,EAAE,QAAQ;YACpB,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;SACjC,CAAC,CAAC,mEAAmE;IAC/E,CAAC;CACF"}
+{"version":3,"file":"VoiceNodeBuilder.js","sourceRoot":"","sources":["../../../src/orchestration/builders/VoiceNodeBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAIH,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,SAAS,CAAC,EAAU,EAAE,MAAuB;IAC3D,OAAO,IAAI,gBAAgB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,gBAAgB;IAW3B;;;;;;;;OAQG;IACH;IACE,iDAAiD;IACxC,EAAU,EACF,MAAuB;QAD/B,OAAE,GAAF,EAAE,CAAQ;QACF,WAAM,GAAN,MAAM,CAAiB;QAtB1C;;;;;;;WAOG;QACK,YAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAezC,CAAC;IAEJ,4EAA4E;IAC5E,aAAa;IACb,4EAA4E;IAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,EAAE,CAAC,UAAkB,EAAE,MAA+B;QACpD,IAAI,CAAC,OAAO,CAAC,GAAG,CACd,UAAU,EACV,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAChD,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4EAA4E;IAC5E,cAAc;IACd,4EAA4E;IAE5E;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,KAAK;QACH,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,OAAO;YACb,cAAc,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE;YAC3D,aAAa,EAAE,eAAe;YAC9B,WAAW,EAAE,UAAU;YACvB,UAAU,EAAE,QAAQ;YACpB,oEAAoE;YACpE,sEAAsE;YACtE,qDAAqD;YACrD,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;SACjC,CAAC,CAAC,4EAA4E;IACxF,CAAC;CACF"}

package/dist/orchestration/events/GraphEvent.d.ts

@@ -140,7 +140,18 @@ export type GraphEvent =
         code: string;
     };
 }
-/** Live STT transcription — interim and final results. */
+/**
+ * Live STT transcription -- both interim (partial) and final (confirmed) results.
+ *
+ * Emitted by {@link VoiceTurnCollector} for every speech recognition result.
+ * Consumers should check `isFinal` to distinguish speculative partials from
+ * confirmed utterances. Only final results are persisted in the transcript buffer.
+ *
+ * - `speaker` is absent when the STT provider does not support diarization.
+ * - `confidence` ranges from `0` (no confidence) to `1` (maximum confidence).
+ *
+ * @see {@link VoiceTurnCollector} -- the source of these events.
+ */
  | {
     type: 'voice_transcript';
     nodeId: string;
@@ -149,7 +160,19 @@ export type GraphEvent =
     speaker?: string;
     confidence: number;
 }
-/** Audio chunk metadata (actual audio flows via IStreamTransport, not events). */
+/**
+ * Audio chunk metadata emitted when audio data flows through the voice pipeline.
+ *
+ * The actual PCM/opus audio bytes flow via `IStreamTransport`, NOT through events.
+ * This event carries only metadata (direction, format, duration) so that the graph
+ * event bus can track audio flow without handling binary payloads.
+ *
+ * - `direction: 'inbound'` -- user microphone audio arriving at the STT engine.
+ * - `direction: 'outbound'` -- agent TTS audio being sent to the user.
+ * - `durationMs` is `0` for streaming chunks where total duration is unknown.
+ *
+ * @see {@link VoiceTransportAdapter} -- emits outbound events on `deliverNodeOutput()`.
+ */
  | {
     type: 'voice_audio';
     nodeId: string;
@@ -157,14 +180,38 @@ export type GraphEvent =
     format: string;
     durationMs: number;
 }
-/** User barge-in — interrupted the agent mid-speech. */
+/**
+ * User barge-in -- the user interrupted the agent while it was speaking.
+ *
+ * Emitted by {@link VoiceTurnCollector} when the session fires a `barge_in` event.
+ * This signals that TTS playback should be cancelled and the graph may need to
+ * reroute to handle the interruption (e.g. re-enter a listening state).
+ *
+ * - `interruptedText` -- what the agent was saying when interrupted.
+ * - `userSpeech` -- what the user said that triggered the interruption.
+ *
+ * @see {@link VoiceInterruptError} -- the structured error variant for graph-level handling.
+ */
  | {
     type: 'voice_barge_in';
     nodeId: string;
     interruptedText: string;
     userSpeech: string;
 }
-/** User turn complete — endpoint detection fired. */
+/**
+ * User turn complete -- the endpoint detector determined the user finished speaking.
+ *
+ * Emitted by both {@link VoiceTurnCollector} (from session events) and
+ * {@link VoiceTransportAdapter} (from transport events). Carries the full
+ * transcript for the completed turn and the endpoint detection reason.
+ *
+ * - `turnIndex` is 1-based and reflects the post-increment count (includes
+ *   checkpoint-restored turns when resuming from a checkpoint).
+ * - `endpointReason` describes why the endpoint was detected (e.g. `'punctuation'`,
+ *   `'silence'`, `'acoustic'`, `'unknown'`).
+ *
+ * @see {@link VoiceTurnCollector} -- increments turnIndex and emits this event.
+ */
  | {
     type: 'voice_turn_complete';
     nodeId: string;
@@ -172,7 +219,22 @@ export type GraphEvent =
     turnIndex: number;
     endpointReason: string;
 }
-/** Voice session lifecycle — started or ended. */
+/**
+ * Voice session lifecycle event -- signals when a voice session starts or ends.
+ *
+ * Emitted by both {@link VoiceNodeExecutor} (at the graph node level) and
+ * {@link VoiceTransportAdapter} (at the transport level). The `nodeId` is the
+ * graph node id for executor-level events, or `'__transport__'` for
+ * transport-level events.
+ *
+ * - `action: 'started'` -- the session is now active and accepting audio.
+ * - `action: 'ended'` -- the session has terminated; `exitReason` describes why
+ *   (e.g. `'turns-exhausted'`, `'hangup'`, `'interrupted'`, `'error'`,
+ *   `'transport-disposed'`).
+ *
+ * @see {@link VoiceNodeExecutor} -- emits started/ended around the exit condition race.
+ * @see {@link VoiceTransportAdapter} -- emits started on init(), ended on dispose().
+ */
  | {
     type: 'voice_session';
     nodeId: string;

package/dist/orchestration/events/GraphEvent.d.ts.map

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

package/dist/orchestration/events/GraphEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"GraphEvent.js","sourceRoot":"","sources":["../../../src/orchestration/events/GraphEvent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"GraphEvent.js","sourceRoot":"","sources":["../../../src/orchestration/events/GraphEvent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgKH,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,iBAAiB;IAA9B;QACE,gDAAgD;QAC/B,cAAS,GAAuC,EAAE,CAAC;QAEpE;;;WAGG;QACK,WAAM,GAAG,KAAK,CAAC;QAgEvB,8EAA8E;QAC9E,kCAAkC;QAClC,8EAA8E;QAE9E;;;WAGG;QACc,sBAAiB,GAAG,IAAI,GAAG,EAA+B,CAAC;QAE5E;;;WAGG;QACc,qBAAgB,GAAG,IAAI,GAAG,EAAc,CAAC;IA0F5D,CAAC;IAtKC,8EAA8E;IAC9E,iBAAiB;IACjB,8EAA8E;IAE9E;;;;OAIG;IACH,EAAE,CAAC,QAAqC;QACtC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,QAAqC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,KAAiB;QACpB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QAExB,iDAAiD;QACjD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;QAED,6EAA6E;QAC7E,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC9C,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QAEnB,mDAAmD;QACnD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC7C,QAAQ,EAAE,CAAC;QACb,CAAC;IACH,CAAC;IAkBD;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,CAAC,MAAM;QACX,uDAAuD;QACvD,MAAM,KAAK,GAAiB,EAAE,CAAC;QAE/B,gFAAgF;QAChF,IAAI,cAAc,GAAyD,IAAI,CAAC;QAEhF;;WAEG;QACH,MAAM,QAAQ,GAAG,CAAC,KAAiB,EAAQ,EAAE;YAC3C,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;gBAC5B,MAAM,OAAO,GAAG,cAAc,CAAC;gBAC/B,cAAc,GAAG,IAAI,CAAC;gBACtB,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC;QAEF,mFAAmF;QACnF,MAAM,QAAQ,GAAG,GAAS,EAAE;YAC1B,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;gBAC5B,MAAM,OAAO,GAAG,cAAc,CAAC;gBAC/B,cAAc,GAAG,IAAI,CAAC;gBACtB,yDAAyD;gBACzD,OAAO,CAAC,EAAE,KAAK,EAAE,SAAkC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACrE,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEpC,IAAI,CAAC;YACH,+EAA+E;YAC/E,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,uEAAuE;oBACvE,MAAM,KAAK,CAAC,KAAK,EAAG,CAAC;gBACvB,CAAC;qBAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBACvB,sDAAsD;oBACtD,MAAM;gBACR,CAAC;qBAAM,CAAC;oBACN,2EAA2E;oBAC3E,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAA6B,CAAC,OAAO,EAAE,EAAE;wBACvE,cAAc,GAAG,OAAO,CAAC;oBAC3B,CAAC,CAAC,CAAC;oBAEH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;wBAChB,mEAAmE;wBACnE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BACxB,MAAM,KAAK,CAAC,KAAK,EAAG,CAAC;wBACvB,CAAC;wBACD,MAAM;oBACR,CAAC;oBAED,MAAM,MAAM,CAAC,KAAK,CAAC;gBACrB,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,sFAAsF;YACtF,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACvC,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;gBAC5B,sDAAsD;gBACtD,MAAM,OAAO,GAAG,cAA6D,CAAC;gBAC9E,cAAc,GAAG,IAAI,CAAC;gBACtB,OAAO,CAAC,EAAE,KAAK,EAAE,SAAkC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;IACH,CAAC;CACF"}