@a1hvdy/cc-openclaw 0.10.4 → 0.12.0

package/dist/src/openai-compat/bridges/openclaw-api-shim.d.ts

@@ -0,0 +1,54 @@
+/**
+ * OpenClawApiShim — typed subset of the OpenClaw plugin API surface.
+ *
+ * Q2 resolution: the upstream OpenClaw plugin API has no semver contract.
+ * Rather than depend on it directly, all native-tool calls go through this
+ * shim which exposes only the methods cc-openclaw needs.
+ *
+ * `validateShape(api)` runs at boot phase 3 (`validate-upstream`) and is
+ * registered as a `PatchSpec.expectedShape` probe. Failure → `DriftError`
+ * and boot refuses (per PatchManifest atomic-install contract).
+ *
+ * Phase D: types + probe shipped; `dispatch` stubbed and throws
+ * `NotImplemented` until Phase E wires the live OpenClaw `api.tool.dispatch`.
+ */
+/**
+ * Inbound dispatch types for the v1.0.0 ToolBridge strategy. These are
+ * complementary to the existing `IToolBridge` at `src/types/tool-bridge.ts`
+ * (which handles outbound tools-to-CLI wiring). Phase E consolidates the
+ * two interfaces if a clean merge is possible.
+ */
+export interface ToolUseCall {
+    readonly id: string;
+    readonly name: string;
+    readonly input: unknown;
+}
+export interface ToolUseResult {
+    readonly toolUseId: string;
+    readonly content: string;
+    readonly isError?: boolean;
+}
+/** Minimum surface area the shim requires from `openclaw.PluginApi`. */
+export interface OpenClawApiSurface {
+    readonly tool: {
+        readonly dispatch: (name: string, input: unknown) => Promise<unknown>;
+        readonly list: () => ReadonlyArray<{
+            readonly name: string;
+        }>;
+    };
+}
+export declare class OpenClawApiShim {
+    private readonly api;
+    constructor(api: OpenClawApiSurface);
+    /**
+     * Phase 3 probe — returns true when `api.tool.dispatch` and `api.tool.list`
+     * exist as callable methods. Used as a `PatchSpec.expectedShape` probe.
+     */
+    static validateShape(api: unknown): boolean;
+    /**
+     * Dispatch a Claude `tool_use` event to OpenClaw's plugin API. Phase D stub.
+     */
+    dispatch(_call: ToolUseCall): Promise<ToolUseResult>;
+    /** Phase D helper — exposes the underlying surface for tests. */
+    getApi(): OpenClawApiSurface;
+}

package/dist/src/openai-compat/bridges/openclaw-api-shim.js

@@ -0,0 +1,45 @@
+/**
+ * OpenClawApiShim — typed subset of the OpenClaw plugin API surface.
+ *
+ * Q2 resolution: the upstream OpenClaw plugin API has no semver contract.
+ * Rather than depend on it directly, all native-tool calls go through this
+ * shim which exposes only the methods cc-openclaw needs.
+ *
+ * `validateShape(api)` runs at boot phase 3 (`validate-upstream`) and is
+ * registered as a `PatchSpec.expectedShape` probe. Failure → `DriftError`
+ * and boot refuses (per PatchManifest atomic-install contract).
+ *
+ * Phase D: types + probe shipped; `dispatch` stubbed and throws
+ * `NotImplemented` until Phase E wires the live OpenClaw `api.tool.dispatch`.
+ */
+import { NotImplemented } from '../../lib/domain-error.js';
+export class OpenClawApiShim {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    /**
+     * Phase 3 probe — returns true when `api.tool.dispatch` and `api.tool.list`
+     * exist as callable methods. Used as a `PatchSpec.expectedShape` probe.
+     */
+    static validateShape(api) {
+        if (typeof api !== 'object' || api === null)
+            return false;
+        const a = api;
+        if (typeof a.tool !== 'object' || a.tool === null)
+            return false;
+        const t = a.tool;
+        return typeof t.dispatch === 'function' && typeof t.list === 'function';
+    }
+    /**
+     * Dispatch a Claude `tool_use` event to OpenClaw's plugin API. Phase D stub.
+     */
+    async dispatch(_call) {
+        throw new NotImplemented('OpenClawApiShim.dispatch (Phase E wires api.tool.dispatch)');
+    }
+    /** Phase D helper — exposes the underlying surface for tests. */
+    getApi() {
+        return this.api;
+    }
+}
+//# sourceMappingURL=openclaw-api-shim.js.map

package/dist/src/openai-compat/bridges/openclaw-api-shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-api-shim.js","sourceRoot":"","sources":["../../../../src/openai-compat/bridges/openclaw-api-shim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AA4B3D,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,GAAuB;QAAvB,QAAG,GAAH,GAAG,CAAoB;IAAG,CAAC;IAExD;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,GAAY;QAC/B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC1D,MAAM,CAAC,GAAG,GAA8B,CAAC;QACzC,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAChE,MAAM,CAAC,GAAG,CAAC,CAAC,IAA+B,CAAC;QAC5C,OAAO,OAAO,CAAC,CAAC,QAAQ,KAAK,UAAU,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,KAAkB;QAC/B,MAAM,IAAI,cAAc,CAAC,4DAA4D,CAAC,CAAC;IACzF,CAAC;IAED,iEAAiE;IACjE,MAAM;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;CACF"}

package/dist/src/openai-compat/bridges/openclaw-native-tools.d.ts

@@ -0,0 +1,61 @@
+/**
+ * openclaw-native-tools.ts — IToolBridge impl for ToolMode.OpenClawNative.
+ *
+ * v0.11.0 investigation result: OpenClaw DOES expose `/tools/invoke` at
+ * `http://127.0.0.1:18790` with Bearer token auth (confirmed in
+ * extensions/cc-openclaw/openclaw-mcp-bridge.cjs). However, the gateway's
+ * `tools.allow` list in openclaw.json only includes `claude_session_*` and
+ * council/ultraplan commands — `message.voice` is NOT there. Invoking
+ * `/tools/invoke` for voice would 404/401 at runtime.
+ *
+ * Decision: Path B (internal marker translation) for v0.11.0. `executeNative`
+ * routes `message.voice` through TtsMediaBridge → `[[tts:text]]` markers.
+ * OpenClaw's existing `maybeApplyTtsToPayload` picks them up downstream.
+ * This is identical to the voice-recovery.ts rescue path — the difference is
+ * the call site: here the model emits a proper tool_call, not raw text XML.
+ *
+ * Path A (real HTTP POST to `/tools/invoke`) is fully wired in `executeHttp`
+ * and ready to activate in v0.12.0 when A1 adds `message.voice` to
+ * `gateway.tools.allow` in openclaw.json.
+ */
+import type { IToolBridge, ToolDefinition, TranslatedToolUseDelta } from '../../types/tool-bridge.js';
+import { ToolMode } from '../../types/tool-bridge.js';
+interface GatewayConfig {
+    url: string;
+    token: string;
+}
+export declare class OpenClawNativeToolsBridge implements IToolBridge {
+    readonly mode = ToolMode.OpenClawNative;
+    private readonly _gwConfig;
+    constructor(gwConfig?: GatewayConfig);
+    /**
+     * Build a minimal tool preamble listing only the tools the bridge can
+     * actually handle (allowlisted + registered). The full schema is omitted —
+     * the caller's system prompt already advertises it. This is a safety marker
+     * so Savvy knows the bridge is active.
+     */
+    buildToolPreamble(tools: ReadonlyArray<ToolDefinition> | undefined): string;
+    /**
+     * Translate a tool_use event from the Claude stream into an OpenAI delta.
+     * This bridge does NOT intercept mid-stream events — tool execution happens
+     * in `executeNative` after the full turn completes. Return null always.
+     */
+    translateToolUse(_event: unknown): TranslatedToolUseDelta;
+    /** Serialize a tool result back as XML for the next turn's user message. */
+    serializeToolResult(call: import('../../types/route.js').OpenAIToolCall, result: string): string;
+    /**
+     * Execute a `message.voice` (or other allowlisted) tool call.
+     *
+     * v0.11.0: routes through TtsMediaBridge (Path B — marker translation).
+     * Returns the TTS marker text to inject into the SSE stream.
+     *
+     * When `CC_OPENCLAW_NATIVE_TOOLS_HTTP=1` is set, falls through to Path A
+     * (real HTTP POST). Reserved for v0.12.0 activation.
+     */
+    executeNative(toolName: string, args: Record<string, unknown>): Promise<{
+        text: string;
+        delivered: boolean;
+        via: string;
+    }>;
+}
+export {};

package/dist/src/openai-compat/bridges/openclaw-native-tools.js

@@ -0,0 +1,171 @@
+/**
+ * openclaw-native-tools.ts — IToolBridge impl for ToolMode.OpenClawNative.
+ *
+ * v0.11.0 investigation result: OpenClaw DOES expose `/tools/invoke` at
+ * `http://127.0.0.1:18790` with Bearer token auth (confirmed in
+ * extensions/cc-openclaw/openclaw-mcp-bridge.cjs). However, the gateway's
+ * `tools.allow` list in openclaw.json only includes `claude_session_*` and
+ * council/ultraplan commands — `message.voice` is NOT there. Invoking
+ * `/tools/invoke` for voice would 404/401 at runtime.
+ *
+ * Decision: Path B (internal marker translation) for v0.11.0. `executeNative`
+ * routes `message.voice` through TtsMediaBridge → `[[tts:text]]` markers.
+ * OpenClaw's existing `maybeApplyTtsToPayload` picks them up downstream.
+ * This is identical to the voice-recovery.ts rescue path — the difference is
+ * the call site: here the model emits a proper tool_call, not raw text XML.
+ *
+ * Path A (real HTTP POST to `/tools/invoke`) is fully wired in `executeHttp`
+ * and ready to activate in v0.12.0 when A1 adds `message.voice` to
+ * `gateway.tools.allow` in openclaw.json.
+ */
+import * as http from 'node:http';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { ToolMode } from '../../types/tool-bridge.js';
+import { resolveToolBridge, registeredToolNames } from './openclaw-tool-registry.js';
+import { MediaBridgeError } from './media-bridge.js';
+// ── Gateway config ─────────────────────────────────────────────────────────
+const DEFAULT_GATEWAY_URL = 'http://127.0.0.1:18790';
+const REQUEST_TIMEOUT_MS = 15_000;
+function readGatewayConfig() {
+    // Env overrides first (matches session-manager.ts priority)
+    const envUrl = process.env.GATEWAY_URL;
+    const envKey = process.env.GATEWAY_KEY;
+    if (envUrl && envKey)
+        return { url: envUrl, token: envKey };
+    try {
+        const configPath = path.join(os.homedir(), '.openclaw', 'openclaw.json');
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        const gw = parsed.gateway;
+        if (!gw)
+            return { url: DEFAULT_GATEWAY_URL, token: '' };
+        const port = gw.port || 18790;
+        const auth = gw.auth;
+        const token = auth?.token || auth?.password || '';
+        return { url: `http://127.0.0.1:${port}`, token };
+    }
+    catch {
+        return { url: DEFAULT_GATEWAY_URL, token: '' };
+    }
+}
+// ── Path A: real HTTP invoke (ready for v0.12.0) ───────────────────────────
+async function executeHttp(toolName, args, config) {
+    return new Promise((resolve) => {
+        const body = JSON.stringify({ tool: toolName, args });
+        const url = new URL('/tools/invoke', config.url);
+        const req = http.request(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${config.token}`,
+                'Content-Length': Buffer.byteLength(body),
+            },
+        }, (res) => {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk.toString(); });
+            res.on('end', () => {
+                try {
+                    const parsed = JSON.parse(data);
+                    if (parsed.ok === false) {
+                        const err = parsed.error;
+                        resolve({ ok: false, error: String(err?.message ?? data.slice(0, 200)) });
+                    }
+                    else {
+                        const result = typeof parsed.result === 'string'
+                            ? parsed.result
+                            : JSON.stringify(parsed.result ?? parsed);
+                        resolve({ ok: true, result });
+                    }
+                }
+                catch {
+                    resolve({ ok: false, error: data.slice(0, 200) });
+                }
+            });
+        });
+        req.on('error', (err) => resolve({ ok: false, error: err.message }));
+        req.setTimeout(REQUEST_TIMEOUT_MS, () => {
+            req.destroy();
+            resolve({ ok: false, error: `Timeout (${REQUEST_TIMEOUT_MS}ms)` });
+        });
+        req.write(body);
+        req.end();
+    });
+}
+// ── IToolBridge impl ───────────────────────────────────────────────────────
+export class OpenClawNativeToolsBridge {
+    mode = ToolMode.OpenClawNative;
+    _gwConfig;
+    constructor(gwConfig) {
+        this._gwConfig = gwConfig ?? readGatewayConfig();
+    }
+    /**
+     * Build a minimal tool preamble listing only the tools the bridge can
+     * actually handle (allowlisted + registered). The full schema is omitted —
+     * the caller's system prompt already advertises it. This is a safety marker
+     * so Savvy knows the bridge is active.
+     */
+    buildToolPreamble(tools) {
+        if (!tools?.length)
+            return '';
+        const bridgeable = tools
+            .map((t) => t.function.name)
+            .filter((n) => registeredToolNames().has(n));
+        if (!bridgeable.length)
+            return '';
+        return [
+            '=== NATIVE TOOL BRIDGE (cc-openclaw v0.11.0) ===',
+            `Bridged tools (emit tool_call, NOT XML): ${bridgeable.join(', ')}`,
+            '=== END NATIVE TOOL BRIDGE ===',
+        ].join('\n');
+    }
+    /**
+     * Translate a tool_use event from the Claude stream into an OpenAI delta.
+     * This bridge does NOT intercept mid-stream events — tool execution happens
+     * in `executeNative` after the full turn completes. Return null always.
+     */
+    translateToolUse(_event) {
+        return null;
+    }
+    /** Serialize a tool result back as XML for the next turn's user message. */
+    serializeToolResult(call, result) {
+        return `<tool_result tool_use_id="${call.id}" name="${call.function.name}">${result}</tool_result>`;
+    }
+    /**
+     * Execute a `message.voice` (or other allowlisted) tool call.
+     *
+     * v0.11.0: routes through TtsMediaBridge (Path B — marker translation).
+     * Returns the TTS marker text to inject into the SSE stream.
+     *
+     * When `CC_OPENCLAW_NATIVE_TOOLS_HTTP=1` is set, falls through to Path A
+     * (real HTTP POST). Reserved for v0.12.0 activation.
+     */
+    async executeNative(toolName, args) {
+        const resolved = resolveToolBridge(toolName);
+        // Tool not in allowlist → fallback empty string (caller decides what to do)
+        if (!resolved) {
+            return { text: '', delivered: false, via: 'not-allowed' };
+        }
+        // Path A: real HTTP (future v0.12.0, opt-in via env flag)
+        if (process.env.CC_OPENCLAW_NATIVE_TOOLS_HTTP === '1') {
+            const httpResult = await executeHttp(toolName, args, this._gwConfig);
+            if (httpResult.ok && httpResult.result !== undefined) {
+                return { text: httpResult.result, delivered: true, via: 'http-invoke' };
+            }
+            // HTTP failed → fall through to Path B
+        }
+        // Path B: internal marker translation
+        try {
+            return await resolved.bridge.execute(args);
+        }
+        catch (err) {
+            if (err instanceof MediaBridgeError) {
+                // Return empty text — upstream voice-recovery fallback will handle it
+                return { text: '', delivered: false, via: `error:${err.message}` };
+            }
+            return { text: '', delivered: false, via: 'error:unknown' };
+        }
+    }
+}
+//# sourceMappingURL=openclaw-native-tools.js.map

package/dist/src/openai-compat/bridges/openclaw-native-tools.js.map

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

package/dist/src/openai-compat/bridges/openclaw-tool-registry.d.ts

@@ -0,0 +1,26 @@
+/**
+ * openclaw-tool-registry.ts — Registry that maps allowed tool names to their
+ * MediaBridge implementations.
+ *
+ * v0.11.0 only registers `message.voice` → TtsMediaBridge. The registry is
+ * lazy-constructed per-request (stateless) so future parallel agents can add
+ * bridges without contention.
+ */
+import type { MediaBridge } from './media-bridge.js';
+/** Resolved bridge for a given tool name, or null when not in allowlist. */
+export interface ResolvedBridge {
+    readonly bridge: MediaBridge;
+    readonly toolName: string;
+}
+/**
+ * Look up the MediaBridge for `toolName`.
+ * Returns null when the tool is not in the v0.11.0 allowlist OR has no
+ * registered implementation.
+ */
+export declare function resolveToolBridge(toolName: string): ResolvedBridge | null;
+/**
+ * Return every tool name currently in the registry (i.e. allowed + implemented).
+ * Used by `OpenClawNativeToolsBridge.buildToolPreamble` to filter the caller's
+ * tool list down to what the bridge can actually handle.
+ */
+export declare function registeredToolNames(): ReadonlySet<string>;

package/dist/src/openai-compat/bridges/openclaw-tool-registry.js

@@ -0,0 +1,38 @@
+/**
+ * openclaw-tool-registry.ts — Registry that maps allowed tool names to their
+ * MediaBridge implementations.
+ *
+ * v0.11.0 only registers `message.voice` → TtsMediaBridge. The registry is
+ * lazy-constructed per-request (stateless) so future parallel agents can add
+ * bridges without contention.
+ */
+import { TtsMediaBridge, TTS_TOOL_NAME } from './tts-media-bridge.js';
+import { isAllowedTool } from './allowlist.js';
+/**
+ * Look up the MediaBridge for `toolName`.
+ * Returns null when the tool is not in the v0.11.0 allowlist OR has no
+ * registered implementation.
+ */
+export function resolveToolBridge(toolName) {
+    if (!isAllowedTool(toolName))
+        return null;
+    const bridge = BRIDGE_MAP.get(toolName);
+    if (!bridge)
+        return null;
+    return { bridge, toolName };
+}
+/**
+ * Return every tool name currently in the registry (i.e. allowed + implemented).
+ * Used by `OpenClawNativeToolsBridge.buildToolPreamble` to filter the caller's
+ * tool list down to what the bridge can actually handle.
+ */
+export function registeredToolNames() {
+    return REGISTERED_NAMES;
+}
+// ── Internal registry ──────────────────────────────────────────────────────
+/** Singleton instances — bridges are stateless so one per process is fine. */
+const BRIDGE_MAP = new Map([
+    [TTS_TOOL_NAME, new TtsMediaBridge()],
+]);
+const REGISTERED_NAMES = new Set(BRIDGE_MAP.keys());
+//# sourceMappingURL=openclaw-tool-registry.js.map

package/dist/src/openai-compat/bridges/openclaw-tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-tool-registry.js","sourceRoot":"","sources":["../../../../src/openai-compat/bridges/openclaw-tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAQ/C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,8EAA8E;AAE9E,8EAA8E;AAC9E,MAAM,UAAU,GAAG,IAAI,GAAG,CAAsB;IAC9C,CAAC,aAAa,EAAE,IAAI,cAAc,EAAE,CAAC;CACtC,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC"}

package/dist/src/openai-compat/bridges/tts-media-bridge.d.ts

@@ -0,0 +1,19 @@
+/**
+ * tts-media-bridge.ts — MediaBridge impl for `message.voice`.
+ *
+ * v0.11.0 Path B strategy: instead of POSTing to a TTS HTTP endpoint, this
+ * bridge converts `message.voice` tool args into `[[tts:text]]` markers that
+ * OpenClaw's existing `maybeApplyTtsToPayload` downstream picks up — the same
+ * channel voice-recovery.ts uses. This gives the tool-boundary UX (Savvy sees
+ * a proper tool interface; callers see tool_call deltas) without requiring a
+ * new OpenClaw endpoint.
+ *
+ * The bridge imports from voice-recovery.ts and reuses its marker constants
+ * and truncation logic. No logic is duplicated.
+ */
+import type { MediaBridge, MediaBridgeResult } from './media-bridge.js';
+export declare const TTS_TOOL_NAME = "message.voice";
+export declare class TtsMediaBridge implements MediaBridge {
+    readonly toolName = "message.voice";
+    execute(args: Record<string, unknown>): Promise<MediaBridgeResult>;
+}

package/dist/src/openai-compat/bridges/tts-media-bridge.js

@@ -0,0 +1,59 @@
+/**
+ * tts-media-bridge.ts — MediaBridge impl for `message.voice`.
+ *
+ * v0.11.0 Path B strategy: instead of POSTing to a TTS HTTP endpoint, this
+ * bridge converts `message.voice` tool args into `[[tts:text]]` markers that
+ * OpenClaw's existing `maybeApplyTtsToPayload` downstream picks up — the same
+ * channel voice-recovery.ts uses. This gives the tool-boundary UX (Savvy sees
+ * a proper tool interface; callers see tool_call deltas) without requiring a
+ * new OpenClaw endpoint.
+ *
+ * The bridge imports from voice-recovery.ts and reuses its marker constants
+ * and truncation logic. No logic is duplicated.
+ */
+import { DEFAULT_MAX_SPOKEN_CHARS } from '../voice-recovery.js';
+import { MediaBridgeError } from './media-bridge.js';
+export const TTS_TOOL_NAME = 'message.voice';
+/** Max spoken chars for the injected TTS block — mirrors voice-recovery default. */
+const MAX_SPOKEN = DEFAULT_MAX_SPOKEN_CHARS;
+/** Marker constants — identical to voice-recovery.ts to stay in-sync. */
+const TTS_OPEN = '[[tts:text]]';
+const TTS_CLOSE = '[[/tts:text]]';
+/**
+ * Extract the spoken text from tool call args.
+ * Tries `text`, `content`, `speech`, `input` in that order.
+ */
+function extractText(args) {
+    for (const key of ['text', 'content', 'speech', 'input']) {
+        const v = args[key];
+        if (typeof v === 'string' && v.trim())
+            return v.trim();
+    }
+    return null;
+}
+/** Truncate to `max` chars at a sentence boundary when possible. */
+function truncate(text, max) {
+    if (text.length <= max)
+        return text;
+    const slice = text.slice(0, max);
+    const lastSentence = Math.max(slice.lastIndexOf('. '), slice.lastIndexOf('! '), slice.lastIndexOf('? '));
+    if (lastSentence > max * 0.5)
+        return slice.slice(0, lastSentence + 1);
+    const lastSpace = slice.lastIndexOf(' ');
+    if (lastSpace > max * 0.5)
+        return `${slice.slice(0, lastSpace)}…`;
+    return `${slice}…`;
+}
+export class TtsMediaBridge {
+    toolName = TTS_TOOL_NAME;
+    async execute(args) {
+        const raw = extractText(args);
+        if (!raw) {
+            throw new MediaBridgeError('message.voice args missing text/content/speech/input field', this.toolName, args);
+        }
+        const spoken = truncate(raw, MAX_SPOKEN);
+        const text = `${TTS_OPEN}${spoken}${TTS_CLOSE}`;
+        return { text, delivered: true, via: 'tts-markers' };
+    }
+}
+//# sourceMappingURL=tts-media-bridge.js.map

package/dist/src/openai-compat/bridges/tts-media-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts-media-bridge.js","sourceRoot":"","sources":["../../../../src/openai-compat/bridges/tts-media-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAE7C,oFAAoF;AACpF,MAAM,UAAU,GAAG,wBAAwB,CAAC;AAE5C,yEAAyE;AACzE,MAAM,QAAQ,GAAG,cAAc,CAAC;AAChC,MAAM,SAAS,GAAG,eAAe,CAAC;AAElC;;;GAGG;AACH,SAAS,WAAW,CAAC,IAA6B;IAChD,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;QACzD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE;YAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oEAAoE;AACpE,SAAS,QAAQ,CAAC,IAAY,EAAE,GAAW;IACzC,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAC3B,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EACvB,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EACvB,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CACxB,CAAC;IACF,IAAI,YAAY,GAAG,GAAG,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,SAAS,GAAG,GAAG,GAAG,GAAG;QAAE,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC;IAClE,OAAO,GAAG,KAAK,GAAG,CAAC;AACrB,CAAC;AAED,MAAM,OAAO,cAAc;IAChB,QAAQ,GAAG,aAAa,CAAC;IAElC,KAAK,CAAC,OAAO,CAAC,IAA6B;QACzC,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,gBAAgB,CACxB,4DAA4D,EAC5D,IAAI,CAAC,QAAQ,EACb,IAAI,CACL,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,EAAE,CAAC;QAChD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC;IACvD,CAAC;CACF"}

package/dist/src/openai-compat/openai-chunk-types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * OpenAI streaming chunk types.
+ *
+ * Extracted from `openai-compat.ts` 2026-05-13 to push that file under the
+ * 500-LOC ceiling. Single source of truth for the SSE chunk shape; also
+ * imported by `response-formatter.ts`, `types/route.ts`, `types/sse.ts`.
+ */
+export interface OpenAIChatCompletionChunk {
+    id: string;
+    object: 'chat.completion.chunk';
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        delta: {
+            role?: string;
+            content?: string | null;
+            tool_calls?: Array<{
+                index: number;
+                id?: string;
+                type?: 'function';
+                function?: {
+                    name?: string;
+                    arguments?: string;
+                };
+            }>;
+        };
+        finish_reason: string | null;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}

package/dist/src/openai-compat/openai-chunk-types.js

@@ -0,0 +1,9 @@
+/**
+ * OpenAI streaming chunk types.
+ *
+ * Extracted from `openai-compat.ts` 2026-05-13 to push that file under the
+ * 500-LOC ceiling. Single source of truth for the SSE chunk shape; also
+ * imported by `response-formatter.ts`, `types/route.ts`, `types/sse.ts`.
+ */
+export {};
+//# sourceMappingURL=openai-chunk-types.js.map

package/dist/src/openai-compat/openai-chunk-types.js.map

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

package/dist/src/openai-compat/openai-compat.d.ts

@@ -17,96 +17,8 @@ export { formatCompletionResponse, formatCompletionChunk } from './response-form
 export { reportStatus, getToolDescription } from './status-reporter.js';
 export { handleNonStreaming } from './non-streaming-handler.js';
 export { handleStreaming } from './streaming-handler.js';
-export interface OpenAIChatMessage {
-    role: 'system' | 'user' | 'assistant' | 'tool';
-    content: string | Array<{
-        type?: string;
-        text?: string;
-    }> | null;
-    tool_calls?: Array<{
-        id: string;
-        type: 'function';
-        function: {
-            name: string;
-            arguments: string;
-        };
-    }>;
-    tool_call_id?: string;
-}
-export interface OpenAIChatCompletionRequest {
-    model?: string;
-    messages: OpenAIChatMessage[];
-    stream?: boolean;
-    temperature?: number;
-    max_tokens?: number;
-    max_completion_tokens?: number;
-    user?: string;
-    tools?: Array<{
-        type: 'function';
-        function: {
-            name: string;
-            description: string;
-            parameters: unknown;
-        };
-    }>;
-}
-export interface OpenAIToolCall {
-    id: string;
-    type: 'function';
-    function: {
-        name: string;
-        arguments: string;
-    };
-}
-export interface OpenAIChatCompletionResponse {
-    id: string;
-    object: 'chat.completion';
-    created: number;
-    model: string;
-    choices: Array<{
-        index: number;
-        message: {
-            role: 'assistant';
-            content: string | null;
-            tool_calls?: OpenAIToolCall[];
-            reasoning?: string;
-        };
-        finish_reason: 'stop' | 'length' | 'tool_calls';
-    }>;
-    usage: {
-        prompt_tokens: number;
-        completion_tokens: number;
-        total_tokens: number;
-    };
-}
-export interface OpenAIChatCompletionChunk {
-    id: string;
-    object: 'chat.completion.chunk';
-    created: number;
-    model: string;
-    choices: Array<{
-        index: number;
-        delta: {
-            role?: string;
-            content?: string | null;
-            tool_calls?: Array<{
-                index: number;
-                id?: string;
-                type?: 'function';
-                function?: {
-                    name?: string;
-                    arguments?: string;
-                };
-            }>;
-        };
-        finish_reason: string | null;
-    }>;
-    usage?: {
-        prompt_tokens: number;
-        completion_tokens: number;
-        total_tokens: number;
-    };
-}
+export type { OpenAIChatMessage, OpenAIChatCompletionRequest, OpenAIToolCall, OpenAIChatCompletionResponse, } from './openai-types.js';
+export type { OpenAIChatCompletionChunk } from './openai-chunk-types.js';
 /** SessionManager-like interface to avoid circular imports. Exported so
  * the extracted handlers (non-streaming-handler.ts, streaming-handler.ts)
  * can type their `manager` parameter from a single canonical definition. */