@srouterhq/server 0.0.0-stage → 0.9.0

package/dist/lib/tool-args.d.ts

@@ -0,0 +1,36 @@
+interface JsonSchemaish {
+    type?: string;
+    properties?: Record<string, JsonSchemaish>;
+    items?: JsonSchemaish;
+}
+/**
+ * Repair a tool call's `arguments` JSON string against the tool's parameter
+ * schema. Returns the original string untouched whenever anything doesn't
+ * parse or doesn't match — this must never corrupt a valid call.
+ */
+export declare function repairToolArguments(args: string, paramSchema?: JsonSchemaish): string;
+/**
+ * Recursively remove the given keys from a JSON-Schema-ish value. Used to drop
+ * fields a provider's tool-schema validator rejects with a 400 even though they
+ * carry no meaning for the call — Cohere's compat endpoint, for instance, 400s
+ * on `additionalProperties` (and `$schema`), which strict clients like opencode
+ * and continue.dev routinely emit. Returns a NEW value; never mutates the input
+ * (tools are shared across the fallback chain, so an in-place strip on one
+ * provider would corrupt the schema the next provider sees). Non-object values
+ * pass through unchanged. This is the provider-agnostic sibling of google.ts's
+ * `sanitizeForGemini`, which strips a much larger Gemini-specific key set.
+ */
+export declare function stripSchemaKeys<T>(schema: T, keys: Set<string>): T;
+/**
+ * Build a tool-name → parameter-schema map from an OpenAI-style tools array
+ * (chat-completions shape: {type:'function', function:{name, parameters}}).
+ */
+export declare function toolSchemaMap(tools?: Array<{
+    type?: string;
+    function?: {
+        name?: string;
+        parameters?: unknown;
+    };
+}>): Map<string, JsonSchemaish>;
+export {};
+//# sourceMappingURL=tool-args.d.ts.map

package/dist/lib/tool-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-args.d.ts","sourceRoot":"","sources":["../../src/lib/tool-args.ts"],"names":[],"mappings":"AAsBA,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAK3C,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,aAAa,GAAG,MAAM,CAiCrF;AA0FD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAalE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,CAAC,EAAE,KAAK,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,CAAC,GACnF,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAS5B"}

package/dist/lib/tool-args.js

@@ -0,0 +1,190 @@
+// Schema-aware repair of double-encoded tool-call arguments.
+//
+// Several free-tier models (GLM family prominently) emit NESTED JSON inside
+// tool arguments as a string: `{"plan": "[{\"step\":...}]"}` instead of
+// `{"plan": [{"step":...}]}`. Strict clients reject the call — observed in
+// production as Codex `failed to parse function arguments: invalid type:
+// string ..., expected a sequence`, which killed the agent turn right at its
+// status-update call. The gateway has the request's tool schemas, so it can
+// repair this principled-ly: only when the schema says a parameter is an
+// array/object AND the string value parses to exactly that JSON type. A
+// parameter whose schema says "string" is never touched, even if it looks
+// like JSON.
+//
+// The walk is recursive. A model that stringifies a top-level array
+// stringifies a nested one too, and a repair that stopped at the top level
+// left `{"config": {"tags": "[\"a\"]"}}` broken for the client. Each level
+// re-applies the identical gate, so depth adds reach without adding latitude:
+// still never a guess, still never a coercion, still nothing invented.
+//
+// Also handles whole-arguments double encoding (the arguments field itself
+// being a JSON-encoded string of a JSON object), which needs no schema.
+/**
+ * Repair a tool call's `arguments` JSON string against the tool's parameter
+ * schema. Returns the original string untouched whenever anything doesn't
+ * parse or doesn't match — this must never corrupt a valid call.
+ */
+export function repairToolArguments(args, paramSchema) {
+    let parsed;
+    try {
+        parsed = JSON.parse(args);
+    }
+    catch {
+        return args;
+    }
+    let changed = false;
+    // Whole-arguments double encoding: `"{\"a\":1}"` parses to a string that is
+    // itself JSON of an object. Unwrap one level.
+    if (typeof parsed === 'string') {
+        try {
+            const inner = JSON.parse(parsed);
+            if (inner !== null && typeof inner === 'object' && !Array.isArray(inner)) {
+                parsed = inner;
+                changed = true;
+            }
+            else {
+                return args;
+            }
+        }
+        catch {
+            return args;
+        }
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return changed ? JSON.stringify(parsed) : args;
+    }
+    if (repairInPlace(parsed, paramSchema))
+        changed = true;
+    return changed ? JSON.stringify(parsed) : args;
+}
+/**
+ * Decode `value` against the schema node that describes it, or return
+ * `undefined` to mean "leave it alone".
+ *
+ * The gate is the whole design: the schema must say `array` or `object`, and
+ * the string must parse to exactly that. A parameter whose schema says
+ * `string` is never touched even when it looks like JSON, an absent or
+ * type-less schema node is never guessed at, and a mismatch is left as-is
+ * rather than coerced.
+ */
+function decodeIfSchemaSays(value, schema) {
+    const want = schema?.type;
+    if (want !== 'array' && want !== 'object')
+        return undefined;
+    const trimmed = value.trim();
+    if (!(trimmed.startsWith('[') || trimmed.startsWith('{')))
+        return undefined;
+    try {
+        const inner = JSON.parse(trimmed);
+        const isMatch = want === 'array'
+            ? Array.isArray(inner)
+            : inner !== null && typeof inner === 'object' && !Array.isArray(inner);
+        return isMatch ? inner : undefined;
+    }
+    catch {
+        // Not actually JSON — leave the string alone.
+        return undefined;
+    }
+}
+/**
+ * Walk a decoded value alongside its schema, decoding double-encoded strings
+ * wherever the schema is unambiguous. Mutates `node` in place (it is always a
+ * fresh JSON.parse result, never a caller's object) and reports whether
+ * anything changed.
+ *
+ * Recursion is the point: the same model that stringifies a top-level array
+ * stringifies a nested one, and until now only the top level was repaired, so
+ * `{"config": {"tags": "[\"a\"]"}}` reached the client still broken. Each
+ * level re-applies the identical gate, so depth adds reach without loosening
+ * the rule — a newly decoded value is itself walked, since a doubly-wrapped
+ * payload is exactly what the models that do this produce.
+ */
+function repairInPlace(node, schema) {
+    if (node === null || typeof node !== 'object')
+        return false;
+    let changed = false;
+    if (Array.isArray(node)) {
+        // One `items` schema describes every element; a tuple schema is skipped
+        // by the type on JsonSchemaish.
+        const itemSchema = schema?.items;
+        if (!itemSchema)
+            return false;
+        for (let i = 0; i < node.length; i++) {
+            const value = node[i];
+            if (typeof value === 'string') {
+                const decoded = decodeIfSchemaSays(value, itemSchema);
+                if (decoded !== undefined) {
+                    node[i] = decoded;
+                    changed = true;
+                    repairInPlace(decoded, itemSchema);
+                }
+            }
+            else if (repairInPlace(value, itemSchema)) {
+                changed = true;
+            }
+        }
+        return changed;
+    }
+    const props = schema?.properties;
+    if (!props)
+        return false;
+    const obj = node;
+    for (const [key, value] of Object.entries(obj)) {
+        const child = props[key];
+        if (!child)
+            continue; // Unknown key — no schema to justify a change.
+        if (typeof value === 'string') {
+            const decoded = decodeIfSchemaSays(value, child);
+            if (decoded !== undefined) {
+                obj[key] = decoded;
+                changed = true;
+                repairInPlace(decoded, child);
+            }
+        }
+        else if (repairInPlace(value, child)) {
+            changed = true;
+        }
+    }
+    return changed;
+}
+/**
+ * Recursively remove the given keys from a JSON-Schema-ish value. Used to drop
+ * fields a provider's tool-schema validator rejects with a 400 even though they
+ * carry no meaning for the call — Cohere's compat endpoint, for instance, 400s
+ * on `additionalProperties` (and `$schema`), which strict clients like opencode
+ * and continue.dev routinely emit. Returns a NEW value; never mutates the input
+ * (tools are shared across the fallback chain, so an in-place strip on one
+ * provider would corrupt the schema the next provider sees). Non-object values
+ * pass through unchanged. This is the provider-agnostic sibling of google.ts's
+ * `sanitizeForGemini`, which strips a much larger Gemini-specific key set.
+ */
+export function stripSchemaKeys(schema, keys) {
+    if (Array.isArray(schema)) {
+        return schema.map((s) => stripSchemaKeys(s, keys));
+    }
+    if (schema && typeof schema === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(schema)) {
+            if (keys.has(k))
+                continue;
+            out[k] = stripSchemaKeys(v, keys);
+        }
+        return out;
+    }
+    return schema;
+}
+/**
+ * Build a tool-name → parameter-schema map from an OpenAI-style tools array
+ * (chat-completions shape: {type:'function', function:{name, parameters}}).
+ */
+export function toolSchemaMap(tools) {
+    const map = new Map();
+    for (const t of tools ?? []) {
+        const name = t.function?.name;
+        if (t.type === 'function' && name && t.function?.parameters && typeof t.function.parameters === 'object') {
+            map.set(name, t.function.parameters);
+        }
+    }
+    return map;
+}
+//# sourceMappingURL=tool-args.js.map

package/dist/lib/tool-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-args.js","sourceRoot":"","sources":["../../src/lib/tool-args.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,EAAE;AACF,4EAA4E;AAC5E,wEAAwE;AACxE,2EAA2E;AAC3E,yEAAyE;AACzE,6EAA6E;AAC7E,4EAA4E;AAC5E,yEAAyE;AACzE,wEAAwE;AACxE,0EAA0E;AAC1E,aAAa;AACb,EAAE;AACF,oEAAoE;AACpE,2EAA2E;AAC3E,2EAA2E;AAC3E,8EAA8E;AAC9E,uEAAuE;AACvE,EAAE;AACF,2EAA2E;AAC3E,wEAAwE;AAYxE;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,WAA2B;IAC3E,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,4EAA4E;IAC5E,8CAA8C;IAC9C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACjC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzE,MAAM,GAAG,KAAK,CAAC;gBACf,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjD,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC;QAAE,OAAO,GAAG,IAAI,CAAC;IAEvD,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,kBAAkB,CAAC,KAAa,EAAE,MAAiC;IAC1E,MAAM,IAAI,GAAG,MAAM,EAAE,IAAI,CAAC;IAC1B,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC5D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5E,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,KAAK,OAAO;YAC9B,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACtB,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACzE,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;QAC9C,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,aAAa,CAAC,IAAa,EAAE,MAAiC;IACrE,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5D,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,wEAAwE;QACxE,gCAAgC;QAChC,MAAM,UAAU,GAAG,MAAM,EAAE,KAAK,CAAC;QACjC,IAAI,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;gBACtD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC1B,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;oBAClB,OAAO,GAAG,IAAI,CAAC;oBACf,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;iBAAM,IAAI,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC;gBAC5C,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,EAAE,UAAU,CAAC;IACjC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,MAAM,GAAG,GAAG,IAA+B,CAAC;IAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK;YAAE,SAAS,CAAC,+CAA+C;QACrE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACjD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;gBACnB,OAAO,GAAG,IAAI,CAAC;gBACf,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;aAAM,IAAI,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAI,MAAS,EAAE,IAAiB;IAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,CAAiB,CAAC;IACrE,CAAC;IACD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAiC,CAAC,EAAE,CAAC;YACvE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,SAAS;YAC1B,GAAG,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,GAAmB,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAoF;IAEpF,MAAM,GAAG,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC;QAC9B,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,IAAI,OAAO,CAAC,CAAC,QAAQ,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YACzG,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,UAA2B,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/lib/tool-call-rescue.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Inline tool-call dialect rescue (#231 audit).
+ *
+ * When a conversation switches models mid-task (failover, sticky miss), the
+ * new model often continues the previous model's tool-call style and emits
+ * the call as TEXT in its private training dialect instead of a structured
+ * `tool_calls` array. The client's agent loop sees prose, treats the turn as
+ * a final answer, and dies mid-task — observed live with the OpenAI Agents
+ * SDK when Kimi-K2.6 continued a DeepSeek history:
+ *
+ *   <|tool_calls_section_begin|> <|tool_call_begin|> chatcmpl-tool-bde5...
+ *
+ * This module detects the known dialects and re-parses them into standard
+ * OpenAI tool_calls, schema-gated against the request's tool list. A turn
+ * that is detected as a dialect but cannot be parsed into a known tool is a
+ * DEAD turn — the caller fails over instead of delivering gibberish.
+ *
+ * Supported dialects:
+ *  1. Kimi / DeepSeek token style:
+ *     <|tool_calls_section_begin|><|tool_call_begin|>functions.NAME:0
+ *     <|tool_call_argument_begin|>{...}<|tool_call_end|>...
+ *  2. Llama / Groq function tags: <function=NAME{...}</function> and
+ *     <function=NAME>{...}</function>
+ *  3. Qwen / Hermes XML: <tool_call>{"name": ..., "arguments": ...}</tool_call>
+ *  4. Bare or ```json-fenced single JSON object: {"name": KNOWN, "arguments": {...}}
+ *     (only rescued when "name" matches a requested tool — bare JSON is a
+ *     legitimate answer shape, so this one is strictly schema-gated)
+ */
+export interface RescuedToolCall {
+    name: string;
+    /** JSON string, exactly like OpenAI's function.arguments */
+    arguments: string;
+}
+export interface RescueResult {
+    /** True when the text contains inline tool-call dialect markers. */
+    detected: boolean;
+    /** Parsed calls; null when detected but unparseable (dead turn). */
+    calls: RescuedToolCall[] | null;
+    /** Text with the dialect blocks removed (may be ''). */
+    cleanText: string;
+}
+/** Does the (trimmed) text start with a known dialect marker? */
+export declare function startsWithDialectMarker(text: string): boolean;
+/**
+ * Streaming hold-window helper: could `text` still grow into a dialect
+ * marker? True while text is a strict prefix of some marker (e.g. "<|too"),
+ * so the stream loop keeps holding; once this and startsWithDialectMarker
+ * are both false the text is ordinary prose and can be flushed.
+ */
+export declare function couldBecomeDialectMarker(text: string): boolean;
+/** Anywhere-in-text detection for the non-streaming path. */
+export declare function containsDialectMarker(text: string): boolean;
+/**
+ * Rescue inline tool-call dialects out of an assistant text answer.
+ *
+ * @param text       the assistant message content
+ * @param toolNames  the names of the tools the REQUEST declared; rescued
+ *                   calls must match one (empty set = accept any name,
+ *                   used by tests only)
+ */
+export declare function rescueInlineToolCalls(text: string, toolNames: Set<string>): RescueResult;
+//# sourceMappingURL=tool-call-rescue.d.ts.map

package/dist/lib/tool-call-rescue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-rescue.d.ts","sourceRoot":"","sources":["../../src/lib/tool-call-rescue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,KAAK,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IAChC,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;CACnB;AAWD,iEAAiE;AACjE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG7D;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAI9D;AAED,6DAA6D;AAC7D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D;AAsID;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,YAAY,CA6BxF"}

package/dist/lib/tool-call-rescue.js

@@ -0,0 +1,258 @@
+/**
+ * Inline tool-call dialect rescue (#231 audit).
+ *
+ * When a conversation switches models mid-task (failover, sticky miss), the
+ * new model often continues the previous model's tool-call style and emits
+ * the call as TEXT in its private training dialect instead of a structured
+ * `tool_calls` array. The client's agent loop sees prose, treats the turn as
+ * a final answer, and dies mid-task — observed live with the OpenAI Agents
+ * SDK when Kimi-K2.6 continued a DeepSeek history:
+ *
+ *   <|tool_calls_section_begin|> <|tool_call_begin|> chatcmpl-tool-bde5...
+ *
+ * This module detects the known dialects and re-parses them into standard
+ * OpenAI tool_calls, schema-gated against the request's tool list. A turn
+ * that is detected as a dialect but cannot be parsed into a known tool is a
+ * DEAD turn — the caller fails over instead of delivering gibberish.
+ *
+ * Supported dialects:
+ *  1. Kimi / DeepSeek token style:
+ *     <|tool_calls_section_begin|><|tool_call_begin|>functions.NAME:0
+ *     <|tool_call_argument_begin|>{...}<|tool_call_end|>...
+ *  2. Llama / Groq function tags: <function=NAME{...}</function> and
+ *     <function=NAME>{...}</function>
+ *  3. Qwen / Hermes XML: <tool_call>{"name": ..., "arguments": ...}</tool_call>
+ *  4. Bare or ```json-fenced single JSON object: {"name": KNOWN, "arguments": {...}}
+ *     (only rescued when "name" matches a requested tool — bare JSON is a
+ *     legitimate answer shape, so this one is strictly schema-gated)
+ */
+// Markers that begin an inline dialect block. Used both for full-text
+// detection and for the streaming hold-window decision in proxy.ts.
+const DIALECT_MARKERS = [
+    '<|tool_calls_section_begin|>',
+    '<|tool_call_begin|>',
+    '<tool_call>',
+    '<function=',
+];
+/** Does the (trimmed) text start with a known dialect marker? */
+export function startsWithDialectMarker(text) {
+    const t = text.trimStart();
+    return DIALECT_MARKERS.some(m => t.startsWith(m));
+}
+/**
+ * Streaming hold-window helper: could `text` still grow into a dialect
+ * marker? True while text is a strict prefix of some marker (e.g. "<|too"),
+ * so the stream loop keeps holding; once this and startsWithDialectMarker
+ * are both false the text is ordinary prose and can be flushed.
+ */
+export function couldBecomeDialectMarker(text) {
+    const t = text.trimStart();
+    if (t.length === 0)
+        return true;
+    return DIALECT_MARKERS.some(m => m.startsWith(t) && t.length < m.length);
+}
+/** Anywhere-in-text detection for the non-streaming path. */
+export function containsDialectMarker(text) {
+    return DIALECT_MARKERS.some(m => text.includes(m));
+}
+/**
+ * Extract one balanced JSON object or array starting at text[from] (which
+ * must be '{' or '['). Returns the slice and the index after it, or null.
+ * String-aware so braces inside JSON strings don't break the balance.
+ */
+function extractBalancedJson(text, from) {
+    const open = text[from];
+    if (open !== '{' && open !== '[')
+        return null;
+    const close = open === '{' ? '}' : ']';
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let i = from; i < text.length; i++) {
+        const ch = text[i];
+        if (inString) {
+            if (escaped)
+                escaped = false;
+            else if (ch === '\\')
+                escaped = true;
+            else if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"')
+            inString = true;
+        else if (ch === open)
+            depth++;
+        else if (ch === close) {
+            depth--;
+            if (depth === 0)
+                return { json: text.slice(from, i + 1), end: i + 1 };
+        }
+    }
+    return null;
+}
+// An empty set means the request declared no tools, so NOTHING is callable.
+// This used to read `toolNames.size === 0 || …`, which inverted that: a turn
+// with no tools opened the gate for every name the dialect parsers found.
+const isKnownTool = (name, toolNames) => toolNames.has(name);
+/** Parse `{"name": ..., "arguments"|"parameters": ...}` into a call. */
+function callFromNamedJson(json, toolNames) {
+    let obj;
+    try {
+        obj = JSON.parse(json);
+    }
+    catch {
+        return null;
+    }
+    if (typeof obj !== 'object' || obj === null)
+        return null;
+    const o = obj;
+    const name = typeof o.name === 'string' ? o.name : undefined;
+    if (!name || !isKnownTool(name, toolNames))
+        return null;
+    const rawArgs = o.arguments ?? o.parameters ?? {};
+    const args = typeof rawArgs === 'string' ? rawArgs : JSON.stringify(rawArgs);
+    try {
+        JSON.parse(args);
+    }
+    catch {
+        return null;
+    }
+    return { name, arguments: args };
+}
+/** Dialect 1: Kimi/DeepSeek <|tool_call_begin|> token blocks. */
+function parseTokenDialect(text, toolNames) {
+    const calls = [];
+    let clean = text;
+    // Strip section wrappers first; they carry no information.
+    clean = clean.replaceAll('<|tool_calls_section_begin|>', '').replaceAll('<|tool_calls_section_end|>', '');
+    const callRe = /<\|tool_call_begin\|>\s*([\s\S]*?)\s*<\|tool_call_argument_begin\|>\s*/g;
+    let m;
+    let parsedAll = true;
+    const spans = [];
+    while ((m = callRe.exec(clean)) !== null) {
+        const idToken = m[1].trim();
+        const argStart = m.index + m[0].length;
+        const jsonStart = clean.indexOf('{', argStart);
+        const extracted = jsonStart === -1 ? null : extractBalancedJson(clean, jsonStart);
+        // Function name rides in the id token as `functions.NAME:IDX`. Some
+        // models degrade it to an opaque id (observed: `chatcmpl-tool-<hex>`),
+        // which leaves no way to know WHICH tool was meant — unparseable.
+        const nameMatch = /^functions\.([A-Za-z0-9_.-]+):\d+$/.exec(idToken);
+        const name = nameMatch?.[1];
+        let argsOk = false;
+        if (extracted && name && isKnownTool(name, toolNames)) {
+            try {
+                JSON.parse(extracted.json);
+                argsOk = true;
+            }
+            catch { /* fall through */ }
+            if (argsOk)
+                calls.push({ name, arguments: extracted.json });
+        }
+        if (!argsOk)
+            parsedAll = false;
+        const endTag = clean.indexOf('<|tool_call_end|>', extracted?.end ?? argStart);
+        spans.push({ from: m.index, to: endTag === -1 ? (extracted?.end ?? argStart) : endTag + '<|tool_call_end|>'.length });
+    }
+    for (const s of [...spans].reverse())
+        clean = clean.slice(0, s.from) + clean.slice(s.to);
+    return { calls: parsedAll && calls.length > 0 ? calls : null, cleanText: clean.trim() };
+}
+/** Dialect 2: <function=NAME{...}</function> (with or without a '>' after the name). */
+function parseFunctionTagDialect(text, toolNames) {
+    const calls = [];
+    let clean = text;
+    let parsedAll = true;
+    const headRe = /<function=([A-Za-z0-9_.-]+)\s*>?\s*/g;
+    let m;
+    const spans = [];
+    while ((m = headRe.exec(text)) !== null) {
+        const name = m[1];
+        const afterHead = m.index + m[0].length;
+        const jsonStart = text[afterHead] === '{' || text[afterHead] === '['
+            ? afterHead
+            : text.indexOf('{', afterHead);
+        const extracted = jsonStart === -1 ? null : extractBalancedJson(text, jsonStart);
+        let ok = false;
+        if (extracted && isKnownTool(name, toolNames) && extracted.json.startsWith('{')) {
+            try {
+                JSON.parse(extracted.json);
+                ok = true;
+            }
+            catch { /* fall through */ }
+            if (ok)
+                calls.push({ name, arguments: extracted.json });
+        }
+        if (!ok)
+            parsedAll = false; // array-shaped or invalid args: not a callable shape
+        const closeTag = text.indexOf('</function>', extracted?.end ?? m.index + m[0].length);
+        spans.push({ from: m.index, to: closeTag === -1 ? (extracted?.end ?? m.index + m[0].length) : closeTag + '</function>'.length });
+    }
+    for (const s of [...spans].reverse())
+        clean = clean.slice(0, s.from) + clean.slice(s.to);
+    return { calls: parsedAll && calls.length > 0 ? calls : null, cleanText: clean.trim() };
+}
+/** Dialect 3: <tool_call>{...}</tool_call> XML-JSON blocks. */
+function parseXmlDialect(text, toolNames) {
+    const calls = [];
+    let parsedAll = true;
+    const re = /<tool_call>\s*([\s\S]*?)\s*<\/tool_call>/g;
+    let m;
+    let clean = text;
+    const matches = [];
+    while ((m = re.exec(text)) !== null)
+        matches.push(m[1]);
+    for (const inner of matches) {
+        const call = callFromNamedJson(inner, toolNames);
+        if (call)
+            calls.push(call);
+        else
+            parsedAll = false;
+    }
+    clean = clean.replace(re, '');
+    // An opening tag with no close (truncated stream) is detected-but-broken.
+    if (/<tool_call>/.test(clean)) {
+        parsedAll = false;
+        clean = clean.replace(/<tool_call>[\s\S]*$/, '');
+    }
+    return { calls: parsedAll && calls.length > 0 ? calls : null, cleanText: clean.trim() };
+}
+/**
+ * Rescue inline tool-call dialects out of an assistant text answer.
+ *
+ * @param text       the assistant message content
+ * @param toolNames  the names of the tools the REQUEST declared; rescued
+ *                   calls must match one (empty set = accept any name,
+ *                   used by tests only)
+ */
+export function rescueInlineToolCalls(text, toolNames) {
+    if (!text)
+        return { detected: false, calls: null, cleanText: text };
+    if (text.includes('<|tool_call_begin|>') || text.includes('<|tool_calls_section_begin|>')) {
+        const { calls, cleanText } = parseTokenDialect(text, toolNames);
+        return { detected: true, calls, cleanText };
+    }
+    if (text.includes('<function=')) {
+        const { calls, cleanText } = parseFunctionTagDialect(text, toolNames);
+        return { detected: true, calls, cleanText };
+    }
+    if (text.includes('<tool_call>')) {
+        const { calls, cleanText } = parseXmlDialect(text, toolNames);
+        return { detected: true, calls, cleanText };
+    }
+    // Dialect 4: the entire answer is one JSON object naming a known tool —
+    // either bare or inside a ```json fence. Strictly schema-gated.
+    const trimmed = text.trim();
+    const fenced = /^```(?:json)?\s*([\s\S]*?)\s*```$/.exec(trimmed);
+    const candidate = (fenced ? fenced[1] : trimmed).trim();
+    if (candidate.startsWith('{') && candidate.endsWith('}')) {
+        const call = callFromNamedJson(candidate, toolNames);
+        // Only treat as dialect when it actually names a requested tool;
+        // arbitrary JSON answers must pass through untouched.
+        if (call)
+            return { detected: true, calls: [call], cleanText: '' };
+    }
+    return { detected: false, calls: null, cleanText: text };
+}
+//# sourceMappingURL=tool-call-rescue.js.map

package/dist/lib/tool-call-rescue.js.map

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

package/dist/lib/tool-capability.d.ts

@@ -0,0 +1,13 @@
+export declare const TOOL_REJECTION_LIMIT = 3;
+export declare const TOOL_REJECTION_WINDOW_MS: number;
+export declare const TOOL_BENCH_MS: number;
+export declare function toolCapabilityKey(platform: string, modelId: string, endpointScope: string | null | undefined): string;
+/** Defer this model for tool requests right now (evidence is already conclusive). */
+export declare function benchForTools(key: string, now?: number): void;
+/** One tool-carrying request was rejected as a bad request by this model. */
+export declare function noteToolRejection(key: string, now?: number): void;
+/** The model just served a tool-carrying request: it supports tools after all. */
+export declare function clearToolRejections(key: string): void;
+export declare function isToolBenched(platform: string, modelId: string, endpointScope: string | null | undefined, now?: number): boolean;
+export declare function resetToolCapability(): void;
+//# sourceMappingURL=tool-capability.d.ts.map

package/dist/lib/tool-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-capability.d.ts","sourceRoot":"","sources":["../../src/lib/tool-capability.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,wBAAwB,QAAiB,CAAC;AAGvD,eAAO,MAAM,aAAa,QAAqB,CAAC;AAKhD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAErH;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI,CAOzE;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI,CAK7E;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGrD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,GAAE,MAAmB,GAAG,OAAO,CAO5I;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C"}