mojentic 1.4.0 → 1.5.0

package/dist/llm/tools/runner.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * Tool runner abstraction for executing batches of tool calls.
+ *
+ * Provides pluggable execution strategies (serial, parallel) so brokers
+ * can stay independent of concurrency policy.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParallelToolRunner = exports.SerialToolRunner = void 0;
+const error_1 = require("../../error");
+const NOT_FOUND_ERROR = (name) => new Error(`Tool ${name} not found`);
+async function executeOne(call, tools, context) {
+    const start = Date.now();
+    context?.onCallStart?.(call);
+    const tool = tools.find((t) => t.matches(call.name));
+    if (!tool) {
+        const outcome = {
+            id: call.id,
+            name: call.name,
+            ok: false,
+            error: NOT_FOUND_ERROR(call.name),
+            durationMs: Date.now() - start,
+        };
+        context?.onCallComplete?.(outcome);
+        return outcome;
+    }
+    try {
+        const ctx = { signal: context?.signal };
+        const result = await tool.run(call.args, ctx);
+        const durationMs = Date.now() - start;
+        const outcome = (0, error_1.isOk)(result)
+            ? { id: call.id, name: call.name, ok: true, result: result.value, durationMs }
+            : { id: call.id, name: call.name, ok: false, error: result.error, durationMs };
+        context?.onCallComplete?.(outcome);
+        return outcome;
+    }
+    catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        const outcome = {
+            id: call.id,
+            name: call.name,
+            ok: false,
+            error,
+            durationMs: Date.now() - start,
+        };
+        context?.onCallComplete?.(outcome);
+        return outcome;
+    }
+}
+/**
+ * Executes tool calls one at a time in input order.
+ *
+ * This is the default for {@link LlmBroker} for backward compatibility and
+ * for cases where you want predictable, stepwise debugging.
+ */
+class SerialToolRunner {
+    async runBatch(calls, tools, context) {
+        const outcomes = [];
+        for (const call of calls) {
+            if (context?.signal?.aborted) {
+                outcomes.push({
+                    id: call.id,
+                    name: call.name,
+                    ok: false,
+                    error: new Error('Tool batch aborted'),
+                    durationMs: 0,
+                });
+                continue;
+            }
+            outcomes.push(await executeOne(call, tools, context));
+        }
+        return outcomes;
+    }
+}
+exports.SerialToolRunner = SerialToolRunner;
+/**
+ * Executes tool calls concurrently with a bounded fan-out.
+ *
+ * `maxConcurrency` defaults to 4 — high enough to win on typical realtime
+ * turns (2–3 concurrent function calls) but low enough that unbounded fan-out
+ * into rate-limited APIs (web search, embeddings) doesn't punish users.
+ */
+class ParallelToolRunner {
+    maxConcurrency;
+    constructor(maxConcurrency = 4) {
+        this.maxConcurrency = maxConcurrency;
+        if (!Number.isFinite(maxConcurrency) || maxConcurrency < 1) {
+            throw new Error(`maxConcurrency must be a positive integer, got ${maxConcurrency}`);
+        }
+    }
+    async runBatch(calls, tools, context) {
+        if (calls.length === 0) {
+            return [];
+        }
+        const outcomes = new Array(calls.length);
+        let cursor = 0;
+        const workers = [];
+        const workerCount = Math.min(this.maxConcurrency, calls.length);
+        for (let w = 0; w < workerCount; w++) {
+            workers.push((async () => {
+                while (true) {
+                    const idx = cursor++;
+                    if (idx >= calls.length) {
+                        return;
+                    }
+                    // idx is bounded by calls.length above; safe array access.
+                    // eslint-disable-next-line security/detect-object-injection
+                    const call = calls[idx];
+                    if (context?.signal?.aborted) {
+                        // eslint-disable-next-line security/detect-object-injection
+                        outcomes[idx] = {
+                            id: call.id,
+                            name: call.name,
+                            ok: false,
+                            error: new Error('Tool batch aborted'),
+                            durationMs: 0,
+                        };
+                        continue;
+                    }
+                    // eslint-disable-next-line security/detect-object-injection
+                    outcomes[idx] = await executeOne(call, tools, context);
+                }
+            })());
+        }
+        await Promise.all(workers);
+        return outcomes;
+    }
+}
+exports.ParallelToolRunner = ParallelToolRunner;
+//# sourceMappingURL=runner.js.map

package/dist/llm/tools/runner.js.map

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

package/dist/llm/tools/tool.d.ts

@@ -37,14 +37,29 @@ export type ToolArgs = Record<string, unknown>;
  * Result of a tool execution
  */
 export type ToolResult = Record<string, unknown> | string | number | boolean | null;
+/**
+ * Optional context passed to {@link LlmTool.run} by runners and brokers.
+ *
+ * The `signal` field is honoured by long-running tools that opt in to
+ * cancellation. Tools that ignore the context continue to work unchanged.
+ */
+export interface ToolRunCtx {
+    /** AbortSignal that fires when the broker or runner cancels the batch. */
+    signal?: AbortSignal;
+}
 /**
  * Interface for LLM tools
  */
 export interface LlmTool {
     /**
-     * Execute the tool with the given arguments
+     * Execute the tool with the given arguments.
+     *
+     * The optional `ctx` parameter carries cancellation information. Tools may
+     * ignore it for back-compat; tools that perform long-running work should
+     * observe `ctx.signal` so that {@link ParallelToolRunner} or the
+     * realtime broker can hard-cancel them on interruption.
      */
-    run(args: ToolArgs): Promise<Result<ToolResult, Error>>;
+    run(args: ToolArgs, ctx?: ToolRunCtx): Promise<Result<ToolResult, Error>>;
     /**
      * Get the tool descriptor for LLM
      */
@@ -62,7 +77,7 @@ export interface LlmTool {
  * Abstract base class for tools
  */
 export declare abstract class BaseTool implements LlmTool {
-    abstract run(args: ToolArgs): Promise<Result<ToolResult, Error>>;
+    abstract run(args: ToolArgs, ctx?: ToolRunCtx): Promise<Result<ToolResult, Error>>;
     abstract descriptor(): ToolDescriptor;
     name(): string;
     matches(name: string): boolean;

package/dist/llm/tools/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/llm/tools/tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;IAExD;;OAEG;IACH,UAAU,IAAI,cAAc,CAAC;IAE7B;;OAEG;IACH,IAAI,IAAI,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,8BAAsB,QAAS,YAAW,OAAO;IAC/C,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAChE,QAAQ,CAAC,UAAU,IAAI,cAAc;IAErC,IAAI,IAAI,MAAM;IAId,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG/B"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/llm/tools/tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;;;;;;OAOG;IACH,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;IAE1E;;OAEG;IACH,UAAU,IAAI,cAAc,CAAC;IAE7B;;OAEG;IACH,IAAI,IAAI,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,8BAAsB,QAAS,YAAW,OAAO;IAC/C,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAClF,QAAQ,CAAC,UAAU,IAAI,cAAc;IAErC,IAAI,IAAI,MAAM;IAId,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG/B"}

package/dist/llm/tools/tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../src/llm/tools/tool.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAqEH;;GAEG;AACH,MAAsB,QAAQ;IAI5B,IAAI;QACF,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;IACzC,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC;IAC9B,CAAC;CACF;AAXD,4BAWC"}
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../src/llm/tools/tool.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAqFH;;GAEG;AACH,MAAsB,QAAQ;IAI5B,IAAI;QACF,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;IACzC,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC;IAC9B,CAAC;CACF;AAXD,4BAWC"}

package/dist/realtime/broker.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Realtime voice broker — sibling to {@link LlmBroker} for duplex
+ * voice + tool sessions.
+ */
+import { Result } from '../error';
+import { ToolRunner } from '../llm/tools';
+import { TracerSystem } from '../tracer';
+import { RealtimeVoiceConfig } from './config';
+import { RealtimeVoiceGateway } from './gateway';
+import { RealtimeSession } from './session';
+/**
+ * Connect-time overrides for a single session. Anything omitted falls back
+ * to the broker-level config supplied at construction.
+ */
+export type RealtimeSessionOverrides = Partial<RealtimeVoiceConfig>;
+/**
+ * Long-lived broker that opens duplex realtime sessions against a gateway.
+ *
+ * The broker itself holds no session state — it is reusable across many
+ * concurrent sessions. The {@link RealtimeSession} returned by
+ * {@link connect} owns the socket lifetime.
+ */
+export declare class RealtimeVoiceBroker {
+    private readonly model;
+    private readonly gateway;
+    private readonly config;
+    private readonly tracer?;
+    private readonly toolRunner;
+    constructor(model: string, gateway: RealtimeVoiceGateway, config?: RealtimeVoiceConfig, tracer?: TracerSystem | undefined, toolRunner?: ToolRunner);
+    /**
+     * Open a new realtime session.
+     *
+     * The session is fully initialised (initial `session.update` sent) before
+     * resolving so callers can immediately pipe audio or send text.
+     */
+    connect(overrides?: RealtimeSessionOverrides): Promise<Result<RealtimeSession, Error>>;
+    getModel(): string;
+    getGateway(): RealtimeVoiceGateway;
+}
+//# sourceMappingURL=broker.d.ts.map

package/dist/realtime/broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../src/realtime/broker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAW,MAAM,EAAQ,MAAM,UAAU,CAAC;AACjD,OAAO,EAAsB,UAAU,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAEpE;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAJV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,oBAAoB,EAC7B,MAAM,GAAE,mBAAwB,EAChC,MAAM,CAAC,EAAE,YAAY,YAAA,EACrB,UAAU,GAAE,UAAqC;IAGpE;;;;;OAKG;IACG,OAAO,CAAC,SAAS,GAAE,wBAA6B,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IAgChG,QAAQ,IAAI,MAAM;IAIlB,UAAU,IAAI,oBAAoB;CAGnC"}

package/dist/realtime/broker.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Realtime voice broker — sibling to {@link LlmBroker} for duplex
+ * voice + tool sessions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeVoiceBroker = void 0;
+const crypto_1 = require("crypto");
+const error_1 = require("../error");
+const tools_1 = require("../llm/tools");
+const session_1 = require("./session");
+/**
+ * Long-lived broker that opens duplex realtime sessions against a gateway.
+ *
+ * The broker itself holds no session state — it is reusable across many
+ * concurrent sessions. The {@link RealtimeSession} returned by
+ * {@link connect} owns the socket lifetime.
+ */
+class RealtimeVoiceBroker {
+    model;
+    gateway;
+    config;
+    tracer;
+    toolRunner;
+    constructor(model, gateway, config = {}, tracer, toolRunner = new tools_1.ParallelToolRunner()) {
+        this.model = model;
+        this.gateway = gateway;
+        this.config = config;
+        this.tracer = tracer;
+        this.toolRunner = toolRunner;
+    }
+    /**
+     * Open a new realtime session.
+     *
+     * The session is fully initialised (initial `session.update` sent) before
+     * resolving so callers can immediately pipe audio or send text.
+     */
+    async connect(overrides = {}) {
+        const merged = {
+            ...this.config,
+            ...overrides,
+            tools: overrides.tools ?? this.config.tools,
+            providerExtras: {
+                ...(this.config.providerExtras ?? {}),
+                ...(overrides.providerExtras ?? {}),
+            },
+        };
+        const correlationId = (0, crypto_1.randomUUID)();
+        const gatewayResult = await this.gateway.open(this.model, merged, correlationId);
+        if (!(0, error_1.isOk)(gatewayResult)) {
+            return (0, error_1.Err)(gatewayResult.error);
+        }
+        const session = new session_1.RealtimeSession(gatewayResult.value, {
+            config: merged,
+            toolRunner: this.toolRunner,
+            tracer: this.tracer,
+            correlationId,
+        });
+        const initResult = await session.initialise();
+        if (!(0, error_1.isOk)(initResult)) {
+            await session.close();
+            return (0, error_1.Err)(initResult.error);
+        }
+        return (0, error_1.Ok)(session);
+    }
+    getModel() {
+        return this.model;
+    }
+    getGateway() {
+        return this.gateway;
+    }
+}
+exports.RealtimeVoiceBroker = RealtimeVoiceBroker;
+//# sourceMappingURL=broker.js.map

package/dist/realtime/broker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.js","sourceRoot":"","sources":["../../src/realtime/broker.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,mCAAoC;AACpC,oCAAiD;AACjD,wCAA8D;AAI9D,uCAA4C;AAQ5C;;;;;;GAMG;AACH,MAAa,mBAAmB;IAEX;IACA;IACA;IACA;IACA;IALnB,YACmB,KAAa,EACb,OAA6B,EAC7B,SAA8B,EAAE,EAChC,MAAqB,EACrB,aAAyB,IAAI,0BAAkB,EAAE;QAJjD,UAAK,GAAL,KAAK,CAAQ;QACb,YAAO,GAAP,OAAO,CAAsB;QAC7B,WAAM,GAAN,MAAM,CAA0B;QAChC,WAAM,GAAN,MAAM,CAAe;QACrB,eAAU,GAAV,UAAU,CAAuC;IACjE,CAAC;IAEJ;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,YAAsC,EAAE;QACpD,MAAM,MAAM,GAAwB;YAClC,GAAG,IAAI,CAAC,MAAM;YACd,GAAG,SAAS;YACZ,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK;YAC3C,cAAc,EAAE;gBACd,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;gBACrC,GAAG,CAAC,SAAS,CAAC,cAAc,IAAI,EAAE,CAAC;aACpC;SACF,CAAC;QACF,MAAM,aAAa,GAAG,IAAA,mBAAU,GAAE,CAAC;QAEnC,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;QACjF,IAAI,CAAC,IAAA,YAAI,EAAC,aAAa,CAAC,EAAE,CAAC;YACzB,OAAO,IAAA,WAAG,EAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,yBAAe,CAAC,aAAa,CAAC,KAAK,EAAE;YACvD,MAAM,EAAE,MAAM;YACd,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,aAAa;SACd,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;QAC9C,IAAI,CAAC,IAAA,YAAI,EAAC,UAAU,CAAC,EAAE,CAAC;YACtB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,IAAA,WAAG,EAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAED,OAAO,IAAA,UAAE,EAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF;AAtDD,kDAsDC"}

package/dist/realtime/config.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Configuration for the realtime voice subsystem.
+ *
+ * Mirrors the slice of OpenAI's Realtime session config that ports cleanly
+ * to other Mojentic implementations. Provider-specific knobs live in
+ * `providerExtras`.
+ */
+import { LlmTool } from '../llm/tools';
+/**
+ * Built-in voice options OpenAI's Realtime API exposes.
+ *
+ * Accepts arbitrary strings to allow new voices without a library update.
+ */
+export type RealtimeVoice = 'alloy' | 'verse' | 'shimmer' | 'echo' | 'ballad' | 'sage' | string;
+/**
+ * Audio modality selector.
+ */
+export type RealtimeModality = 'audio' | 'text';
+/**
+ * Audio frame format OpenAI accepts on the wire.
+ *
+ * `pcm16` is the default — 16-bit signed little-endian PCM, mono, 24 kHz.
+ */
+export type RealtimeAudioFormat = 'pcm16' | 'g711_ulaw' | 'g711_alaw';
+/**
+ * Tunable parameters for server-side voice-activity detection.
+ *
+ * Bump `threshold` up (e.g. 0.7–0.9) to make the VAD less sensitive to
+ * background noise. Set `interruptResponse: false` to disable barge-in
+ * entirely so the assistant's reply can't be cancelled mid-sentence by a
+ * cough or keyboard click.
+ */
+export interface ServerVadConfig {
+    type?: 'server_vad';
+    /** Activation threshold (0.0–1.0). Lower fires on quieter speech. Default ≈ 0.5. */
+    threshold?: number;
+    /** Padding (ms) added to the start of a detected utterance. */
+    prefixPaddingMs?: number;
+    /** Silence (ms) before declaring the user is done speaking. */
+    silenceDurationMs?: number;
+    /** Whether VAD should auto-fire a `response.create` after the user stops. Default true. */
+    createResponse?: boolean;
+    /**
+     * Whether speech detected during an in-flight assistant response should
+     * cancel it (barge-in). Default true. Set false to mute false-positive
+     * interruptions from background noise.
+     */
+    interruptResponse?: boolean;
+    /** Max silence (ms) before the server idles the session. */
+    idleTimeoutMs?: number;
+}
+/**
+ * Semantic VAD mode — uses an LLM-side classifier to decide whether
+ * detected audio is intentional speech vs background noise. More robust
+ * than energy-threshold VAD in noisy environments.
+ */
+export interface SemanticVadConfig {
+    type: 'semantic_vad';
+    /** Sensitivity of the classifier. `low` = least likely to fire. */
+    eagerness?: 'low' | 'medium' | 'high' | 'auto';
+    createResponse?: boolean;
+    interruptResponse?: boolean;
+}
+/**
+ * Turn-detection strategy.
+ *
+ * - `server_vad` — server decides when the user stopped talking and auto-fires
+ *   a response. Natural phone-call mode. Energy-threshold-based.
+ * - `none` — client decides when to commit the buffer and request a response.
+ *   Useful for push-to-talk and tests.
+ * - `semantic_vad` — LLM-classifier-driven VAD. Best for noisy environments.
+ * - A {@link ServerVadConfig} or {@link SemanticVadConfig} object — tune
+ *   thresholds and behaviour.
+ */
+export type TurnDetectionMode = 'server_vad' | 'semantic_vad' | 'none' | ServerVadConfig | SemanticVadConfig;
+/**
+ * Policy for handling tool outputs from a cancelled response.
+ *
+ * - `drop` (default) — don't submit any outputs from the cancelled batch.
+ *   Stale answers don't pollute context.
+ * - `submit-completed-only` — submit outputs for tools that finished before
+ *   the abort signal landed; drop in-flight ones.
+ * - `submit` — submit all outputs that eventually arrive, even after the
+ *   model started a new response.
+ */
+export type InterruptOutputPolicy = 'drop' | 'submit' | 'submit-completed-only';
+/**
+ * Choice strategy for tools in the session.
+ */
+export type RealtimeToolChoice = 'auto' | 'none' | 'required' | {
+    name: string;
+};
+/**
+ * Vendor-neutral configuration for a realtime voice session.
+ *
+ * The library forwards a curated subset to the active gateway and translates
+ * vendor-specific shapes at the boundary.
+ */
+export interface RealtimeVoiceConfig {
+    /** System-level instructions injected into every assistant turn. */
+    instructions?: string;
+    /** Voice id to render assistant audio with. */
+    voice?: RealtimeVoice;
+    /** Active modalities. Default `['audio', 'text']`. */
+    modalities?: RealtimeModality[];
+    /** Encoding of audio frames the client sends. Default `pcm16`. */
+    inputAudioFormat?: RealtimeAudioFormat;
+    /** Encoding of audio frames the server returns. Default `pcm16`. */
+    outputAudioFormat?: RealtimeAudioFormat;
+    /** Turn-detection strategy. Default `server_vad`. */
+    turnDetection?: TurnDetectionMode;
+    /** Whisper transcription config for user audio. Pass `false` to disable. */
+    inputAudioTranscription?: {
+        model: 'whisper-1';
+    } | false;
+    /** Tools available to the model in this session. */
+    tools?: LlmTool[];
+    /** Tool-selection strategy. Default `auto`. */
+    toolChoice?: RealtimeToolChoice;
+    /** Sampling temperature. */
+    temperature?: number;
+    /** Cap on output tokens per response. */
+    maxResponseOutputTokens?: number;
+    /** How to treat tool outputs from interrupted/cancelled responses. */
+    onInterrupt?: InterruptOutputPolicy;
+    /** Provider-specific escape hatch — passed through verbatim to the gateway. */
+    providerExtras?: Record<string, unknown>;
+}
+/**
+ * Default config used when a field is omitted. Surfaced so consumers can
+ * read effective values without re-implementing the merge themselves.
+ */
+export declare const REALTIME_DEFAULTS: Required<Pick<RealtimeVoiceConfig, 'modalities' | 'inputAudioFormat' | 'outputAudioFormat' | 'turnDetection' | 'toolChoice' | 'onInterrupt'>>;
+//# sourceMappingURL=config.d.ts.map

package/dist/realtime/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/realtime/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhG;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEhD;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC;AAEtE;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2FAA2F;IAC3F,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,cAAc,CAAC;IACrB,mEAAmE;IACnE,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,cAAc,GACd,MAAM,GACN,eAAe,GACf,iBAAiB,CAAC;AAEtB;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,QAAQ,GAAG,uBAAuB,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,sDAAsD;IACtD,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;IACvC,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,mBAAmB,CAAC;IACxC,qDAAqD;IACrD,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,4EAA4E;IAC5E,uBAAuB,CAAC,EAAE;QAAE,KAAK,EAAE,WAAW,CAAA;KAAE,GAAG,KAAK,CAAC;IACzD,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,sEAAsE;IACtE,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CACtC,IAAI,CACF,mBAAmB,EACjB,YAAY,GACZ,kBAAkB,GAClB,mBAAmB,GACnB,eAAe,GACf,YAAY,GACZ,aAAa,CAChB,CAQF,CAAC"}

package/dist/realtime/config.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Configuration for the realtime voice subsystem.
+ *
+ * Mirrors the slice of OpenAI's Realtime session config that ports cleanly
+ * to other Mojentic implementations. Provider-specific knobs live in
+ * `providerExtras`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REALTIME_DEFAULTS = void 0;
+/**
+ * Default config used when a field is omitted. Surfaced so consumers can
+ * read effective values without re-implementing the merge themselves.
+ */
+exports.REALTIME_DEFAULTS = {
+    modalities: ['audio', 'text'],
+    inputAudioFormat: 'pcm16',
+    outputAudioFormat: 'pcm16',
+    turnDetection: 'server_vad',
+    toolChoice: 'auto',
+    onInterrupt: 'drop',
+};
+//# sourceMappingURL=config.js.map

package/dist/realtime/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/realtime/config.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAsIH;;;GAGG;AACU,QAAA,iBAAiB,GAU1B;IACF,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,OAAO;IACzB,iBAAiB,EAAE,OAAO;IAC1B,aAAa,EAAE,YAAY;IAC3B,UAAU,EAAE,MAAM;IAClB,WAAW,EAAE,MAAM;CACpB,CAAC"}

package/dist/realtime/events.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Vendor-neutral event union for the realtime subsystem.
+ *
+ * Consumers subscribe to this union rather than raw OpenAI events so the
+ * same observer code ports cleanly to other realtime providers and other
+ * Mojentic implementations (Python, Elixir, Rust).
+ */
+import { ToolArgs, ToolResult } from '../llm/tools';
+import { RealtimeVoiceConfig } from './config';
+/**
+ * Token usage reported when a response turn completes.
+ */
+export interface TokenUsage {
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+    /** Provider-specific breakdown (e.g. audio vs text tokens). */
+    extras?: Record<string, unknown>;
+}
+/**
+ * Conversation item in a realtime session.
+ *
+ * Realtime sessions don't map cleanly to chat-completion `LlmMessage`s
+ * because they carry audio, multi-modal content, and tool-call lifecycle
+ * separate from any single message. We carry a small dedicated shape so
+ * `LlmMessage` doesn't get bent out of shape.
+ */
+export interface RealtimeItem {
+    id: string;
+    /** Item kind — message, function-call, or function-call output. */
+    type: 'message' | 'function_call' | 'function_call_output';
+    /** Role for message items. */
+    role?: 'system' | 'user' | 'assistant';
+    /** Text content (assembled from streamed deltas). */
+    text?: string;
+    /** Transcript content (assembled from streamed audio deltas). */
+    transcript?: string;
+    /** Function name for function_call / function_call_output items. */
+    name?: string;
+    /** Parsed JSON arguments for function_call items. */
+    args?: ToolArgs;
+    /** Tool execution result for function_call_output items. */
+    output?: ToolResult;
+    /** Pair function_call → function_call_output. */
+    callId?: string;
+}
+/**
+ * Vendor-neutral event types emitted by {@link RealtimeSession}.
+ */
+export type RealtimeEvent = {
+    kind: 'session_opened';
+    sessionId: string;
+} | {
+    kind: 'session_updated';
+    config: Partial<RealtimeVoiceConfig>;
+} | {
+    kind: 'session_closed';
+    reason: 'client' | 'server' | 'error';
+} | {
+    kind: 'user_speech_started';
+    atMs: number;
+} | {
+    kind: 'user_speech_stopped';
+    atMs: number;
+} | {
+    kind: 'user_transcript_delta';
+    itemId: string;
+    delta: string;
+} | {
+    kind: 'user_transcript';
+    itemId: string;
+    text: string;
+} | {
+    kind: 'assistant_turn_started';
+    turnId: string;
+} | {
+    kind: 'assistant_text_delta';
+    turnId: string;
+    delta: string;
+} | {
+    kind: 'assistant_text';
+    turnId: string;
+    text: string;
+} | {
+    kind: 'assistant_transcript_delta';
+    turnId: string;
+    delta: string;
+} | {
+    kind: 'assistant_transcript';
+    turnId: string;
+    text: string;
+} | {
+    kind: 'assistant_audio_delta';
+    turnId: string;
+    pcm: Int16Array;
+} | {
+    kind: 'assistant_turn_completed';
+    turnId: string;
+    usage?: TokenUsage;
+} | {
+    kind: 'tool_call_started';
+    turnId: string;
+    callId: string;
+    name: string;
+} | {
+    kind: 'tool_call_args_delta';
+    callId: string;
+    delta: string;
+} | {
+    kind: 'tool_call_dispatched';
+    callId: string;
+    name: string;
+    args: ToolArgs;
+} | {
+    kind: 'tool_call_completed';
+    callId: string;
+    name: string;
+    result: ToolResult;
+} | {
+    kind: 'tool_call_failed';
+    callId: string;
+    name: string;
+    error: Error;
+} | {
+    kind: 'tool_batch_submitted';
+    turnId: string;
+    callIds: string[];
+} | {
+    kind: 'interrupted';
+    turnId: string;
+    reason: 'barge_in' | 'manual' | 'error';
+} | {
+    kind: 'rate_limited';
+    resetMs: number;
+    details: Record<string, unknown>;
+} | {
+    kind: 'error';
+    error: Error;
+    recoverable: boolean;
+};
+/**
+ * Narrow helper for discriminating events by `kind` in switch statements
+ * without losing exhaustiveness checking.
+ */
+export type RealtimeEventKind = RealtimeEvent['kind'];
+//# sourceMappingURL=events.d.ts.map

package/dist/realtime/events.d.ts.map

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

package/dist/realtime/events.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Vendor-neutral event union for the realtime subsystem.
+ *
+ * Consumers subscribe to this union rather than raw OpenAI events so the
+ * same observer code ports cleanly to other realtime providers and other
+ * Mojentic implementations (Python, Elixir, Rust).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=events.js.map

package/dist/realtime/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/realtime/events.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}