@code-yeongyu/senpi-ai 2026.7.25-2

package/dist/utils/retry.js

@@ -0,0 +1,177 @@
+function buildProviderErrorPattern(patterns) {
+    return new RegExp(patterns.join("|"), "i");
+}
+const NON_RETRYABLE_PROVIDER_LIMIT_ERROR_PATTERN = buildProviderErrorPattern([
+    // OpenCode Go/free-tier limits returned as 429 JSON error types by OpenCode's
+    // Zen API. These are subscription/account limits, not transient throttles.
+    "GoUsageLimitError",
+    "FreeUsageLimitError",
+    // OpenCode Go subscription-limit text asks users to enable available-balance
+    // usage after rolling/weekly/monthly limits are reached.
+    "Monthly usage limit reached",
+    "available balance",
+    // Generic quota/budget/billing exhaustion. `insufficient_quota` is OpenAI's
+    // quota/billing error code; the other strings cover common gateway wording.
+    "insufficient_quota",
+    "out of budget",
+    "quota exceeded",
+    "billing",
+]);
+const RETRYABLE_PROVIDER_ERROR_PATTERN = buildProviderErrorPattern([
+    // Generic provider load, HTTP status, and server-side transient failures.
+    "overloaded",
+    "rate.?limit",
+    "too many requests",
+    "429",
+    "500",
+    "502",
+    "503",
+    "504",
+    "524",
+    "service.?unavailable",
+    "server.?error",
+    "internal.?error",
+    // Wrapper/provider text for transient upstream failures, including OpenRouter
+    // "Provider returned error" responses (#2264).
+    "provider.?returned.?error",
+    // Network, proxy, and fetch transport failures. This includes OpenAI Codex
+    // raw-fetch failures such as "upstream connect", "connection refused", and
+    // "reset before headers" (#733), plus OpenRouter connection drops (#3317).
+    "network.?error",
+    "connection.?error",
+    "connection.?refused",
+    "connection.?lost",
+    "other side closed",
+    "fetch failed",
+    "getaddrinfo",
+    "ENOTFOUND",
+    "EAI_AGAIN",
+    "upstream.?connect",
+    "reset before headers",
+    "socket hang up",
+    "socket connection was closed",
+    "timed? out",
+    "timeout",
+    "terminated",
+    // WebSocket transports can report close/error text instead of HTTP/fetch text.
+    "websocket.?closed",
+    "websocket.?error",
+    // Premature stream endings from SDKs and transports. Anthropic can throw
+    // "stream ended without ..." and "Anthropic stream ended before message_stop"
+    // (#4433); Bedrock/Smithy can throw an HTTP/2 no-response error (#3594).
+    "ended without",
+    "stream ended before message_stop",
+    "stream ended before a terminal response event",
+    "http2 request did not get a response",
+    // Provider-requested retry delay cap failures should flow through the outer
+    // retry policy so callers can surface/abort the backoff (#1123).
+    "retry delay",
+    // Explicit retry guidance emitted mid-stream by OpenAI Responses and Bedrock
+    // stream exceptions (#6019).
+    "you can retry your request",
+    "try your request again",
+    "please retry your request",
+    // gRPC based providers (e.g. NVIDIA NIM)
+    "ResourceExhausted",
+]);
+class RetrySleepAbortError extends Error {
+    constructor() {
+        super("Aborted");
+    }
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new RetrySleepAbortError());
+            return;
+        }
+        const timeout = setTimeout(resolve, ms);
+        signal?.addEventListener("abort", () => {
+            clearTimeout(timeout);
+            reject(new RetrySleepAbortError());
+        }, { once: true });
+    });
+}
+/**
+ * Run a single assistant-producing call with bounded retry on transient errors.
+ *
+ * Behavior:
+ * - A successful response is returned immediately. Aborts are terminal and never
+ *   retried, but reported as unsuccessful if they happen after a retry was scheduled.
+ *   Aborts during the backoff sleep are normalized to an aborted `AssistantMessage`
+ *   too, so callers do not need to care when cancellation happened.
+ * - A non-retryable error (per {@link isRetryableAssistantError}, including quota/
+ *   billing exhaustion) is returned immediately so deterministic errors fail fast.
+ * - Otherwise retries up to `maxRetries` times with exponential backoff, emitting
+ *   `onRetryScheduled` before each sleep, `onRetryAttemptStart` after each sleep before
+ *   the retried call starts, and `onRetryFinished` once at the end (whether the loop
+ *   ends in success, exhausted retries, or an aborted backoff).
+ *
+ * When `policy` is undefined or disabled, the first response is returned unchanged
+ * (equivalent to calling `produce()` directly).
+ */
+export async function retryAssistantCall(produce, policy, signal, callbacks) {
+    const maxAttempts = policy?.enabled ? policy.maxRetries : 0;
+    let attempt = 0;
+    let lastRetry;
+    for (;;) {
+        const response = await produce();
+        // Abort: terminal but not successful. Never retry an aborted message.
+        if (response.stopReason === "aborted") {
+            if (lastRetry)
+                await callbacks?.onRetryFinished?.(false, lastRetry.attempt);
+            return response;
+        }
+        // Success: non-error, non-abort responses return as-is.
+        if (response.stopReason !== "error") {
+            if (lastRetry)
+                await callbacks?.onRetryFinished?.(true, lastRetry.attempt);
+            return response;
+        }
+        // Non-retryable, or budget exhausted: return the final error message.
+        if (attempt >= maxAttempts || !isRetryableAssistantError(response)) {
+            if (lastRetry)
+                await callbacks?.onRetryFinished?.(false, lastRetry.attempt, response.errorMessage);
+            return response;
+        }
+        attempt++;
+        lastRetry = { attempt, errorMessage: response.errorMessage || "Unknown error" };
+        const delayMs = policy.baseDelayMs * 2 ** (attempt - 1);
+        await callbacks?.onRetryScheduled?.(attempt, maxAttempts, delayMs, lastRetry.errorMessage);
+        // Normalize aborts during retry backoff to the same AssistantMessage shape as
+        // provider stream aborts, so callers do not need to care when cancellation happened.
+        try {
+            await sleep(delayMs, signal);
+        }
+        catch (error) {
+            await callbacks?.onRetryFinished?.(false, attempt, lastRetry.errorMessage);
+            if (error instanceof RetrySleepAbortError) {
+                return { ...response, stopReason: "aborted", errorMessage: undefined };
+            }
+            throw error;
+        }
+        await callbacks?.onRetryAttemptStart?.();
+    }
+}
+/**
+ * Classifies whether a failed assistant message looks like a transient provider
+ * or transport error, so callers can decide if the last assistant turn should be
+ * restarted.
+ *
+ * This does not implement retry policy. Callers should first handle context
+ * overflow separately, then apply their own retry budget, backoff, and reporting
+ * before restarting the assistant turn.
+ */
+export function isRetryableAssistantError(message) {
+    if (message.stopReason !== "error" ||
+        message.stopDetails?.type === "refusal" ||
+        message.stopDetails?.type === "sensitive" ||
+        !message.errorMessage) {
+        return false;
+    }
+    const errorMessage = message.errorMessage;
+    if (NON_RETRYABLE_PROVIDER_LIMIT_ERROR_PATTERN.test(errorMessage))
+        return false;
+    return RETRYABLE_PROVIDER_ERROR_PATTERN.test(errorMessage);
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AssistantMessage } from \"../types.ts\";\n\nfunction buildProviderErrorPattern(patterns: readonly string[]): RegExp {\n\treturn new RegExp(patterns.join(\"|\"), \"i\");\n}\n\nconst NON_RETRYABLE_PROVIDER_LIMIT_ERROR_PATTERN = buildProviderErrorPattern([\n\t// OpenCode Go/free-tier limits returned as 429 JSON error types by OpenCode's\n\t// Zen API. These are subscription/account limits, not transient throttles.\n\t\"GoUsageLimitError\",\n\t\"FreeUsageLimitError\",\n\n\t// OpenCode Go subscription-limit text asks users to enable available-balance\n\t// usage after rolling/weekly/monthly limits are reached.\n\t\"Monthly usage limit reached\",\n\t\"available balance\",\n\n\t// Generic quota/budget/billing exhaustion. `insufficient_quota` is OpenAI's\n\t// quota/billing error code; the other strings cover common gateway wording.\n\t\"insufficient_quota\",\n\t\"out of budget\",\n\t\"quota exceeded\",\n\t\"billing\",\n]);\n\nconst RETRYABLE_PROVIDER_ERROR_PATTERN = buildProviderErrorPattern([\n\t// Generic provider load, HTTP status, and server-side transient failures.\n\t\"overloaded\",\n\t\"rate.?limit\",\n\t\"too many requests\",\n\t\"429\",\n\t\"500\",\n\t\"502\",\n\t\"503\",\n\t\"504\",\n\t\"524\",\n\t\"service.?unavailable\",\n\t\"server.?error\",\n\t\"internal.?error\",\n\n\t// Wrapper/provider text for transient upstream failures, including OpenRouter\n\t// \"Provider returned error\" responses (#2264).\n\t\"provider.?returned.?error\",\n\n\t// Network, proxy, and fetch transport failures. This includes OpenAI Codex\n\t// raw-fetch failures such as \"upstream connect\", \"connection refused\", and\n\t// \"reset before headers\" (#733), plus OpenRouter connection drops (#3317).\n\t\"network.?error\",\n\t\"connection.?error\",\n\t\"connection.?refused\",\n\t\"connection.?lost\",\n\t\"other side closed\",\n\t\"fetch failed\",\n\t\"getaddrinfo\",\n\t\"ENOTFOUND\",\n\t\"EAI_AGAIN\",\n\t\"upstream.?connect\",\n\t\"reset before headers\",\n\t\"socket hang up\",\n\t\"socket connection was closed\",\n\t\"timed? out\",\n\t\"timeout\",\n\t\"terminated\",\n\n\t// WebSocket transports can report close/error text instead of HTTP/fetch text.\n\t\"websocket.?closed\",\n\t\"websocket.?error\",\n\n\t// Premature stream endings from SDKs and transports. Anthropic can throw\n\t// \"stream ended without ...\" and \"Anthropic stream ended before message_stop\"\n\t// (#4433); Bedrock/Smithy can throw an HTTP/2 no-response error (#3594).\n\t\"ended without\",\n\t\"stream ended before message_stop\",\n\t\"stream ended before a terminal response event\",\n\t\"http2 request did not get a response\",\n\n\t// Provider-requested retry delay cap failures should flow through the outer\n\t// retry policy so callers can surface/abort the backoff (#1123).\n\t\"retry delay\",\n\n\t// Explicit retry guidance emitted mid-stream by OpenAI Responses and Bedrock\n\t// stream exceptions (#6019).\n\t\"you can retry your request\",\n\t\"try your request again\",\n\t\"please retry your request\",\n\n\t// gRPC based providers (e.g. NVIDIA NIM)\n\t\"ResourceExhausted\",\n]);\n\n/**\n * Retry policy: bounded attempts with exponential backoff (`baseDelayMs * 2^(attempt-1)`).\n * Matches `settings.retry` (`enabled`, `maxRetries`, `baseDelayMs`) in coding-agent; kept\n * here so the classifier and the policy-driven retry loop live together and stay reusable\n * by the SDK and other callers.\n */\nexport interface RetryPolicy {\n\tenabled: boolean;\n\t/** Max retry attempts (0 = no retries). The initial call never counts as a retry. */\n\tmaxRetries: number;\n\t/** Base delay in ms. Per-attempt delay is `baseDelayMs * 2^(attempt-1)` before jitter. */\n\tbaseDelayMs: number;\n}\n\n/** Optional callbacks emitted by {@link retryAssistantCall} around each retry. */\nexport interface RetryCallbacks {\n\t/** Emitted before the backoff sleep of each retry attempt (1-indexed). */\n\tonRetryScheduled?: (\n\t\tattempt: number,\n\t\tmaxAttempts: number,\n\t\tdelayMs: number,\n\t\terrorMessage: string,\n\t) => void | Promise<void>;\n\t/** Emitted after the backoff sleep, immediately before the retried call starts. */\n\tonRetryAttemptStart?: () => void | Promise<void>;\n\t/** Emitted once when the loop ends: success if a later call completed normally. */\n\tonRetryFinished?: (success: boolean, attempt: number, finalError?: string) => void | Promise<void>;\n}\n\nclass RetrySleepAbortError extends Error {\n\tconstructor() {\n\t\tsuper(\"Aborted\");\n\t}\n}\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n\treturn new Promise((resolve, reject) => {\n\t\tif (signal?.aborted) {\n\t\t\treject(new RetrySleepAbortError());\n\t\t\treturn;\n\t\t}\n\t\tconst timeout = setTimeout(resolve, ms);\n\t\tsignal?.addEventListener(\n\t\t\t\"abort\",\n\t\t\t() => {\n\t\t\t\tclearTimeout(timeout);\n\t\t\t\treject(new RetrySleepAbortError());\n\t\t\t},\n\t\t\t{ once: true },\n\t\t);\n\t});\n}\n\n/**\n * Run a single assistant-producing call with bounded retry on transient errors.\n *\n * Behavior:\n * - A successful response is returned immediately. Aborts are terminal and never\n *   retried, but reported as unsuccessful if they happen after a retry was scheduled.\n *   Aborts during the backoff sleep are normalized to an aborted `AssistantMessage`\n *   too, so callers do not need to care when cancellation happened.\n * - A non-retryable error (per {@link isRetryableAssistantError}, including quota/\n *   billing exhaustion) is returned immediately so deterministic errors fail fast.\n * - Otherwise retries up to `maxRetries` times with exponential backoff, emitting\n *   `onRetryScheduled` before each sleep, `onRetryAttemptStart` after each sleep before\n *   the retried call starts, and `onRetryFinished` once at the end (whether the loop\n *   ends in success, exhausted retries, or an aborted backoff).\n *\n * When `policy` is undefined or disabled, the first response is returned unchanged\n * (equivalent to calling `produce()` directly).\n */\nexport async function retryAssistantCall(\n\tproduce: () => Promise<AssistantMessage>,\n\tpolicy: RetryPolicy | undefined,\n\tsignal: AbortSignal | undefined,\n\tcallbacks?: RetryCallbacks,\n): Promise<AssistantMessage> {\n\tconst maxAttempts = policy?.enabled ? policy.maxRetries : 0;\n\n\tlet attempt = 0;\n\tlet lastRetry: { attempt: number; errorMessage: string } | undefined;\n\tfor (;;) {\n\t\tconst response = await produce();\n\n\t\t// Abort: terminal but not successful. Never retry an aborted message.\n\t\tif (response.stopReason === \"aborted\") {\n\t\t\tif (lastRetry) await callbacks?.onRetryFinished?.(false, lastRetry.attempt);\n\t\t\treturn response;\n\t\t}\n\n\t\t// Success: non-error, non-abort responses return as-is.\n\t\tif (response.stopReason !== \"error\") {\n\t\t\tif (lastRetry) await callbacks?.onRetryFinished?.(true, lastRetry.attempt);\n\t\t\treturn response;\n\t\t}\n\n\t\t// Non-retryable, or budget exhausted: return the final error message.\n\t\tif (attempt >= maxAttempts || !isRetryableAssistantError(response)) {\n\t\t\tif (lastRetry) await callbacks?.onRetryFinished?.(false, lastRetry.attempt, response.errorMessage);\n\t\t\treturn response;\n\t\t}\n\n\t\tattempt++;\n\t\tlastRetry = { attempt, errorMessage: response.errorMessage || \"Unknown error\" };\n\t\tconst delayMs = policy!.baseDelayMs * 2 ** (attempt - 1);\n\t\tawait callbacks?.onRetryScheduled?.(attempt, maxAttempts, delayMs, lastRetry.errorMessage);\n\n\t\t// Normalize aborts during retry backoff to the same AssistantMessage shape as\n\t\t// provider stream aborts, so callers do not need to care when cancellation happened.\n\t\ttry {\n\t\t\tawait sleep(delayMs, signal);\n\t\t} catch (error) {\n\t\t\tawait callbacks?.onRetryFinished?.(false, attempt, lastRetry.errorMessage);\n\t\t\tif (error instanceof RetrySleepAbortError) {\n\t\t\t\treturn { ...response, stopReason: \"aborted\", errorMessage: undefined };\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\t\tawait callbacks?.onRetryAttemptStart?.();\n\t}\n}\n\n/**\n * Classifies whether a failed assistant message looks like a transient provider\n * or transport error, so callers can decide if the last assistant turn should be\n * restarted.\n *\n * This does not implement retry policy. Callers should first handle context\n * overflow separately, then apply their own retry budget, backoff, and reporting\n * before restarting the assistant turn.\n */\nexport function isRetryableAssistantError(message: AssistantMessage): boolean {\n\tif (\n\t\tmessage.stopReason !== \"error\" ||\n\t\tmessage.stopDetails?.type === \"refusal\" ||\n\t\tmessage.stopDetails?.type === \"sensitive\" ||\n\t\t!message.errorMessage\n\t) {\n\t\treturn false;\n\t}\n\tconst errorMessage = message.errorMessage;\n\tif (NON_RETRYABLE_PROVIDER_LIMIT_ERROR_PATTERN.test(errorMessage)) return false;\n\treturn RETRYABLE_PROVIDER_ERROR_PATTERN.test(errorMessage);\n}\n"]}

package/dist/utils/sanitize-unicode.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Removes unpaired Unicode surrogate characters from a string.
+ *
+ * Unpaired surrogates (high surrogates 0xD800-0xDBFF without matching low surrogates 0xDC00-0xDFFF,
+ * or vice versa) cause JSON serialization errors in many API providers.
+ *
+ * Valid emoji and other characters outside the Basic Multilingual Plane use properly paired
+ * surrogates and will NOT be affected by this function.
+ *
+ * @param text - The text to sanitize
+ * @returns The sanitized text with unpaired surrogates removed
+ *
+ * @example
+ * // Valid emoji (properly paired surrogates) are preserved
+ * sanitizeSurrogates("Hello 🙈 World") // => "Hello 🙈 World"
+ *
+ * // Unpaired high surrogate is removed
+ * const unpaired = String.fromCharCode(0xD83D); // high surrogate without low
+ * sanitizeSurrogates(`Text ${unpaired} here`) // => "Text  here"
+ */
+export declare function sanitizeSurrogates(text: string): string;
+//# sourceMappingURL=sanitize-unicode.d.ts.map

package/dist/utils/sanitize-unicode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-unicode.d.ts","sourceRoot":"","sources":["../../src/utils/sanitize-unicode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIvD"}

package/dist/utils/sanitize-unicode.js

@@ -0,0 +1,26 @@
+/**
+ * Removes unpaired Unicode surrogate characters from a string.
+ *
+ * Unpaired surrogates (high surrogates 0xD800-0xDBFF without matching low surrogates 0xDC00-0xDFFF,
+ * or vice versa) cause JSON serialization errors in many API providers.
+ *
+ * Valid emoji and other characters outside the Basic Multilingual Plane use properly paired
+ * surrogates and will NOT be affected by this function.
+ *
+ * @param text - The text to sanitize
+ * @returns The sanitized text with unpaired surrogates removed
+ *
+ * @example
+ * // Valid emoji (properly paired surrogates) are preserved
+ * sanitizeSurrogates("Hello 🙈 World") // => "Hello 🙈 World"
+ *
+ * // Unpaired high surrogate is removed
+ * const unpaired = String.fromCharCode(0xD83D); // high surrogate without low
+ * sanitizeSurrogates(`Text ${unpaired} here`) // => "Text  here"
+ */
+export function sanitizeSurrogates(text) {
+    // Replace unpaired high surrogates (0xD800-0xDBFF not followed by low surrogate)
+    // Replace unpaired low surrogates (0xDC00-0xDFFF not preceded by high surrogate)
+    return text.replace(/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/g, "");
+}
+//# sourceMappingURL=sanitize-unicode.js.map

package/dist/utils/sanitize-unicode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-unicode.js","sourceRoot":"","sources":["../../src/utils/sanitize-unicode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC9C,iFAAiF;IACjF,iFAAiF;IACjF,OAAO,IAAI,CAAC,OAAO,CAAC,yEAAyE,EAAE,EAAE,CAAC,CAAC;AACpG,CAAC","sourcesContent":["/**\n * Removes unpaired Unicode surrogate characters from a string.\n *\n * Unpaired surrogates (high surrogates 0xD800-0xDBFF without matching low surrogates 0xDC00-0xDFFF,\n * or vice versa) cause JSON serialization errors in many API providers.\n *\n * Valid emoji and other characters outside the Basic Multilingual Plane use properly paired\n * surrogates and will NOT be affected by this function.\n *\n * @param text - The text to sanitize\n * @returns The sanitized text with unpaired surrogates removed\n *\n * @example\n * // Valid emoji (properly paired surrogates) are preserved\n * sanitizeSurrogates(\"Hello 🙈 World\") // => \"Hello 🙈 World\"\n *\n * // Unpaired high surrogate is removed\n * const unpaired = String.fromCharCode(0xD83D); // high surrogate without low\n * sanitizeSurrogates(`Text ${unpaired} here`) // => \"Text  here\"\n */\nexport function sanitizeSurrogates(text: string): string {\n\t// Replace unpaired high surrogates (0xD800-0xDBFF not followed by low surrogate)\n\t// Replace unpaired low surrogates (0xDC00-0xDFFF not preceded by high surrogate)\n\treturn text.replace(/[\\uD800-\\uDBFF](?![\\uDC00-\\uDFFF])|(?<![\\uD800-\\uDBFF])[\\uDC00-\\uDFFF]/g, \"\");\n}\n"]}

package/dist/utils/server-fallback-receipt.d.ts

@@ -0,0 +1,30 @@
+import type { AssistantMessage } from "../types.ts";
+export declare const SERVER_FALLBACK_ABORTED_DIAGNOSTIC = "server_fallback_aborted";
+export declare const BILLING_INCOMPLETE_DIAGNOSTIC = "billing_incomplete_after_client_abort";
+export interface ServerFallbackReceipt {
+    readonly from: string;
+    readonly to: string;
+}
+/**
+ * Anthropic marks a classifier handoff with `{type:"fallback", from:{model}, to:{model}}`
+ * (`server-side-fallback-*` betas). Returns undefined for anything else, so an
+ * unrelated or malformed provider-native block falls through to normal handling.
+ */
+export declare function parseServerFallbackReceipt(block: unknown): ServerFallbackReceipt | undefined;
+/**
+ * Sticky routing serves later turns of a fallen-back conversation from the
+ * substitute model with no `fallback` block at all; a `fallback_message` entry
+ * in `usage.iterations` is the documented signal. A served-model string
+ * comparison is deliberately NOT used: gateways and Bedrock-style endpoints
+ * rewrite model ids, so a mismatch is not evidence of a fallback.
+ */
+export declare function parseStickyFallbackReceipt(usage: unknown, requestedModel: string, servedModel?: string): ServerFallbackReceipt | undefined;
+export declare function serverFallbackRefusalExplanation(receipt: ServerFallbackReceipt): string;
+/**
+ * Rewrites an aborted turn into the same shape a pre-output classifier refusal
+ * has, so `isClassifierRefusal()` routes it through the caller's fallback chain.
+ * Content is dropped: the substitute model's partial output was never requested,
+ * and replaying a half-turn containing a fallback marker breaks Anthropic replay.
+ */
+export declare function applyServerFallbackAbort(message: AssistantMessage, receipt: ServerFallbackReceipt): void;
+//# sourceMappingURL=server-fallback-receipt.d.ts.map

package/dist/utils/server-fallback-receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-fallback-receipt.d.ts","sourceRoot":"","sources":["../../src/utils/server-fallback-receipt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,eAAO,MAAM,kCAAkC,4BAA4B,CAAC;AAC5E,eAAO,MAAM,6BAA6B,0CAA0C,CAAC;AAErF,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACpB;AAWD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,GAAG,SAAS,CAK5F;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACzC,KAAK,EAAE,OAAO,EACd,cAAc,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,MAAM,GAClB,qBAAqB,GAAG,SAAS,CAUnC;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAEvF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAgBxG"}

package/dist/utils/server-fallback-receipt.js

@@ -0,0 +1,70 @@
+import { appendAssistantMessageDiagnostic } from "./diagnostics.js";
+export const SERVER_FALLBACK_ABORTED_DIAGNOSTIC = "server_fallback_aborted";
+export const BILLING_INCOMPLETE_DIAGNOSTIC = "billing_incomplete_after_client_abort";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readModel(value) {
+    if (!isRecord(value))
+        return undefined;
+    return typeof value.model === "string" && value.model.length > 0 ? value.model : undefined;
+}
+/**
+ * Anthropic marks a classifier handoff with `{type:"fallback", from:{model}, to:{model}}`
+ * (`server-side-fallback-*` betas). Returns undefined for anything else, so an
+ * unrelated or malformed provider-native block falls through to normal handling.
+ */
+export function parseServerFallbackReceipt(block) {
+    if (!isRecord(block) || block.type !== "fallback")
+        return undefined;
+    const from = readModel(block.from);
+    const to = readModel(block.to);
+    return from !== undefined && to !== undefined ? { from, to } : undefined;
+}
+/**
+ * Sticky routing serves later turns of a fallen-back conversation from the
+ * substitute model with no `fallback` block at all; a `fallback_message` entry
+ * in `usage.iterations` is the documented signal. A served-model string
+ * comparison is deliberately NOT used: gateways and Bedrock-style endpoints
+ * rewrite model ids, so a mismatch is not evidence of a fallback.
+ */
+export function parseStickyFallbackReceipt(usage, requestedModel, servedModel) {
+    if (!isRecord(usage) || !Array.isArray(usage.iterations))
+        return undefined;
+    for (let index = usage.iterations.length - 1; index >= 0; index--) {
+        const entry = usage.iterations[index];
+        if (!isRecord(entry) || entry.type !== "fallback_message")
+            continue;
+        const entryModel = typeof entry.model === "string" && entry.model.length > 0 ? entry.model : undefined;
+        const to = entryModel ?? servedModel;
+        return to !== undefined ? { from: requestedModel, to } : undefined;
+    }
+    return undefined;
+}
+export function serverFallbackRefusalExplanation(receipt) {
+    return `Server-side fallback (${receipt.from} -> ${receipt.to}) aborted by client policy`;
+}
+/**
+ * Rewrites an aborted turn into the same shape a pre-output classifier refusal
+ * has, so `isClassifierRefusal()` routes it through the caller's fallback chain.
+ * Content is dropped: the substitute model's partial output was never requested,
+ * and replaying a half-turn containing a fallback marker breaks Anthropic replay.
+ */
+export function applyServerFallbackAbort(message, receipt) {
+    const explanation = serverFallbackRefusalExplanation(receipt);
+    message.content = [];
+    message.stopReason = "error";
+    message.stopDetails = { type: "refusal", explanation };
+    message.errorMessage = explanation;
+    appendAssistantMessageDiagnostic(message, {
+        type: SERVER_FALLBACK_ABORTED_DIAGNOSTIC,
+        timestamp: Date.now(),
+        details: { from: receipt.from, to: receipt.to },
+    });
+    appendAssistantMessageDiagnostic(message, {
+        type: BILLING_INCOMPLETE_DIAGNOSTIC,
+        timestamp: Date.now(),
+        details: { reason: "per-attempt usage does not arrive after a client abort" },
+    });
+}
+//# sourceMappingURL=server-fallback-receipt.js.map

package/dist/utils/server-fallback-receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-fallback-receipt.js","sourceRoot":"","sources":["../../src/utils/server-fallback-receipt.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AssistantMessage } from \"../types.ts\";\nimport { appendAssistantMessageDiagnostic } from \"./diagnostics.ts\";\n\nexport const SERVER_FALLBACK_ABORTED_DIAGNOSTIC = \"server_fallback_aborted\";\nexport const BILLING_INCOMPLETE_DIAGNOSTIC = \"billing_incomplete_after_client_abort\";\n\nexport interface ServerFallbackReceipt {\n\treadonly from: string;\n\treadonly to: string;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction readModel(value: unknown): string | undefined {\n\tif (!isRecord(value)) return undefined;\n\treturn typeof value.model === \"string\" && value.model.length > 0 ? value.model : undefined;\n}\n\n/**\n * Anthropic marks a classifier handoff with `{type:\"fallback\", from:{model}, to:{model}}`\n * (`server-side-fallback-*` betas). Returns undefined for anything else, so an\n * unrelated or malformed provider-native block falls through to normal handling.\n */\nexport function parseServerFallbackReceipt(block: unknown): ServerFallbackReceipt | undefined {\n\tif (!isRecord(block) || block.type !== \"fallback\") return undefined;\n\tconst from = readModel(block.from);\n\tconst to = readModel(block.to);\n\treturn from !== undefined && to !== undefined ? { from, to } : undefined;\n}\n\n/**\n * Sticky routing serves later turns of a fallen-back conversation from the\n * substitute model with no `fallback` block at all; a `fallback_message` entry\n * in `usage.iterations` is the documented signal. A served-model string\n * comparison is deliberately NOT used: gateways and Bedrock-style endpoints\n * rewrite model ids, so a mismatch is not evidence of a fallback.\n */\nexport function parseStickyFallbackReceipt(\n\tusage: unknown,\n\trequestedModel: string,\n\tservedModel?: string,\n): ServerFallbackReceipt | undefined {\n\tif (!isRecord(usage) || !Array.isArray(usage.iterations)) return undefined;\n\tfor (let index = usage.iterations.length - 1; index >= 0; index--) {\n\t\tconst entry: unknown = usage.iterations[index];\n\t\tif (!isRecord(entry) || entry.type !== \"fallback_message\") continue;\n\t\tconst entryModel = typeof entry.model === \"string\" && entry.model.length > 0 ? entry.model : undefined;\n\t\tconst to = entryModel ?? servedModel;\n\t\treturn to !== undefined ? { from: requestedModel, to } : undefined;\n\t}\n\treturn undefined;\n}\n\nexport function serverFallbackRefusalExplanation(receipt: ServerFallbackReceipt): string {\n\treturn `Server-side fallback (${receipt.from} -> ${receipt.to}) aborted by client policy`;\n}\n\n/**\n * Rewrites an aborted turn into the same shape a pre-output classifier refusal\n * has, so `isClassifierRefusal()` routes it through the caller's fallback chain.\n * Content is dropped: the substitute model's partial output was never requested,\n * and replaying a half-turn containing a fallback marker breaks Anthropic replay.\n */\nexport function applyServerFallbackAbort(message: AssistantMessage, receipt: ServerFallbackReceipt): void {\n\tconst explanation = serverFallbackRefusalExplanation(receipt);\n\tmessage.content = [];\n\tmessage.stopReason = \"error\";\n\tmessage.stopDetails = { type: \"refusal\", explanation };\n\tmessage.errorMessage = explanation;\n\tappendAssistantMessageDiagnostic(message, {\n\t\ttype: SERVER_FALLBACK_ABORTED_DIAGNOSTIC,\n\t\ttimestamp: Date.now(),\n\t\tdetails: { from: receipt.from, to: receipt.to },\n\t});\n\tappendAssistantMessageDiagnostic(message, {\n\t\ttype: BILLING_INCOMPLETE_DIAGNOSTIC,\n\t\ttimestamp: Date.now(),\n\t\tdetails: { reason: \"per-attempt usage does not arrive after a client abort\" },\n\t});\n}\n"]}

package/dist/utils/stop-details.d.ts

@@ -0,0 +1,4 @@
+import type { AssistantMessage } from "../types.ts";
+/** Returns true when an assistant error was classified as a refusal or sensitive stop. */
+export declare function isClassifierRefusal(message: AssistantMessage): boolean;
+//# sourceMappingURL=stop-details.d.ts.map

package/dist/utils/stop-details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-details.d.ts","sourceRoot":"","sources":["../../src/utils/stop-details.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,0FAA0F;AAC1F,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAKtE"}

package/dist/utils/stop-details.js

@@ -0,0 +1,6 @@
+/** Returns true when an assistant error was classified as a refusal or sensitive stop. */
+export function isClassifierRefusal(message) {
+    return (message.stopReason === "error" &&
+        (message.stopDetails?.type === "refusal" || message.stopDetails?.type === "sensitive"));
+}
+//# sourceMappingURL=stop-details.js.map

package/dist/utils/stop-details.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-details.js","sourceRoot":"","sources":["../../src/utils/stop-details.ts"],"names":[],"mappings":"AAEA,0FAA0F;AAC1F,MAAM,UAAU,mBAAmB,CAAC,OAAyB;IAC5D,OAAO,CACN,OAAO,CAAC,UAAU,KAAK,OAAO;QAC9B,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,IAAI,KAAK,WAAW,CAAC,CACtF,CAAC;AACH,CAAC","sourcesContent":["import type { AssistantMessage } from \"../types.ts\";\n\n/** Returns true when an assistant error was classified as a refusal or sensitive stop. */\nexport function isClassifierRefusal(message: AssistantMessage): boolean {\n\treturn (\n\t\tmessage.stopReason === \"error\" &&\n\t\t(message.stopDetails?.type === \"refusal\" || message.stopDetails?.type === \"sensitive\")\n\t);\n}\n"]}

package/dist/utils/text.d.ts

@@ -0,0 +1,6 @@
+import type { ImageContent, ProviderNativeContent, TextContent, ThinkingContent, ToolCall } from "../types.ts";
+type Content = TextContent | ImageContent | ThinkingContent | ToolCall | ProviderNativeContent;
+/** Extract and join text from message content. */
+export declare function contentText(content: string | readonly Content[], separator?: string): string;
+export {};
+//# sourceMappingURL=text.d.ts.map

package/dist/utils/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/utils/text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE/G,KAAK,OAAO,GAAG,WAAW,GAAG,YAAY,GAAG,eAAe,GAAG,QAAQ,GAAG,qBAAqB,CAAC;AAE/F,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,OAAO,EAAE,EAAE,SAAS,SAAO,GAAG,MAAM,CAM1F"}

package/dist/utils/text.js

@@ -0,0 +1,10 @@
+/** Extract and join text from message content. */
+export function contentText(content, separator = "\n") {
+    if (typeof content === "string")
+        return content;
+    return content
+        .filter((block) => block.type === "text")
+        .map((block) => block.text)
+        .join(separator);
+}
+//# sourceMappingURL=text.js.map

package/dist/utils/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/utils/text.ts"],"names":[],"mappings":"AAIA,kDAAkD;AAClD,MAAM,UAAU,WAAW,CAAC,OAAoC,EAAE,SAAS,GAAG,IAAI;IACjF,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,OAAO,OAAO;SACZ,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;SACxC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;SAC1B,IAAI,CAAC,SAAS,CAAC,CAAC;AACnB,CAAC","sourcesContent":["import type { ImageContent, ProviderNativeContent, TextContent, ThinkingContent, ToolCall } from \"../types.ts\";\n\ntype Content = TextContent | ImageContent | ThinkingContent | ToolCall | ProviderNativeContent;\n\n/** Extract and join text from message content. */\nexport function contentText(content: string | readonly Content[], separator = \"\\n\"): string {\n\tif (typeof content === \"string\") return content;\n\treturn content\n\t\t.filter((block) => block.type === \"text\")\n\t\t.map((block) => block.text)\n\t\t.join(separator);\n}\n"]}

package/dist/utils/tool-choice-fallback.d.ts

@@ -0,0 +1,5 @@
+export declare function isForcedToolChoiceUnsupportedError(error: unknown, sentForcedToolChoice: boolean): boolean;
+export declare function omitToolChoiceParam<TParams extends {
+    tool_choice?: unknown;
+}>(params: TParams): TParams;
+//# sourceMappingURL=tool-choice-fallback.d.ts.map

package/dist/utils/tool-choice-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-choice-fallback.d.ts","sourceRoot":"","sources":["../../src/utils/tool-choice-fallback.ts"],"names":[],"mappings":"AAgCA,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,OAAO,GAAG,OAAO,CAWzG;AAED,wBAAgB,mBAAmB,CAAC,OAAO,SAAS;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAIvG"}

package/dist/utils/tool-choice-fallback.js

@@ -0,0 +1,41 @@
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function extractHttpStatus(error) {
+    if (!isRecord(error)) {
+        return undefined;
+    }
+    const status = error.status;
+    if (typeof status === "number") {
+        return status;
+    }
+    const response = error.response;
+    if (isRecord(response) && typeof response.status === "number") {
+        return response.status;
+    }
+    return undefined;
+}
+function errorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === "string") {
+        return error;
+    }
+    return String(error);
+}
+export function isForcedToolChoiceUnsupportedError(error, sentForcedToolChoice) {
+    if (!sentForcedToolChoice || extractHttpStatus(error) !== 400) {
+        return false;
+    }
+    const message = errorMessage(error);
+    return (/tool[_\s-]?choices?\b.*?(not\s+compatible|incompatible|not\s+supported|unsupported)/is.test(message) ||
+        /forces?\s+tool\s+use.*?(not\s+compatible|incompatible|not\s+supported|unsupported)/is.test(message) ||
+        /does\s+not\s+support\s+forced\s+tool[_\s-]?choices?/is.test(message));
+}
+export function omitToolChoiceParam(params) {
+    const nextParams = { ...params };
+    delete nextParams.tool_choice;
+    return nextParams;
+}
+//# sourceMappingURL=tool-choice-fallback.js.map

package/dist/utils/tool-choice-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-choice-fallback.js","sourceRoot":"","sources":["../../src/utils/tool-choice-fallback.ts"],"names":[],"mappings":"AAAA,SAAS,QAAQ,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACpD,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACxC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAChC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/D,OAAO,QAAQ,CAAC,MAAM,CAAC;IACxB,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IACnC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,OAAO,CAAC;IACtB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,KAAc,EAAE,oBAA6B;IAC/F,IAAI,CAAC,oBAAoB,IAAI,iBAAiB,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC;QAC/D,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,CACN,uFAAuF,CAAC,IAAI,CAAC,OAAO,CAAC;QACrG,sFAAsF,CAAC,IAAI,CAAC,OAAO,CAAC;QACpG,uDAAuD,CAAC,IAAI,CAAC,OAAO,CAAC,CACrE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAA4C,MAAe;IAC7F,MAAM,UAAU,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IACjC,OAAO,UAAU,CAAC,WAAW,CAAC;IAC9B,OAAO,UAAU,CAAC;AACnB,CAAC","sourcesContent":["function isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null;\n}\n\nfunction extractHttpStatus(error: unknown): number | undefined {\n\tif (!isRecord(error)) {\n\t\treturn undefined;\n\t}\n\n\tconst status = error.status;\n\tif (typeof status === \"number\") {\n\t\treturn status;\n\t}\n\n\tconst response = error.response;\n\tif (isRecord(response) && typeof response.status === \"number\") {\n\t\treturn response.status;\n\t}\n\n\treturn undefined;\n}\n\nfunction errorMessage(error: unknown): string {\n\tif (error instanceof Error) {\n\t\treturn error.message;\n\t}\n\tif (typeof error === \"string\") {\n\t\treturn error;\n\t}\n\treturn String(error);\n}\n\nexport function isForcedToolChoiceUnsupportedError(error: unknown, sentForcedToolChoice: boolean): boolean {\n\tif (!sentForcedToolChoice || extractHttpStatus(error) !== 400) {\n\t\treturn false;\n\t}\n\n\tconst message = errorMessage(error);\n\treturn (\n\t\t/tool[_\\s-]?choices?\\b.*?(not\\s+compatible|incompatible|not\\s+supported|unsupported)/is.test(message) ||\n\t\t/forces?\\s+tool\\s+use.*?(not\\s+compatible|incompatible|not\\s+supported|unsupported)/is.test(message) ||\n\t\t/does\\s+not\\s+support\\s+forced\\s+tool[_\\s-]?choices?/is.test(message)\n\t);\n}\n\nexport function omitToolChoiceParam<TParams extends { tool_choice?: unknown }>(params: TParams): TParams {\n\tconst nextParams = { ...params };\n\tdelete nextParams.tool_choice;\n\treturn nextParams;\n}\n"]}

package/dist/utils/tool-pair-repair.d.ts

@@ -0,0 +1,5 @@
+import type { Message } from "../types.ts";
+export declare const TOOL_RESULT_PLACEHOLDER = "Tool output unavailable (context compacted)";
+/** Repairs orphaned tool results and dangling tool calls. */
+export declare function repairOrphanedToolResults(messages: Message[]): Message[];
+//# sourceMappingURL=tool-pair-repair.d.ts.map

package/dist/utils/tool-pair-repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-pair-repair.d.ts","sourceRoot":"","sources":["../../src/utils/tool-pair-repair.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,aAAa,CAAC;AAExD,eAAO,MAAM,uBAAuB,gDAAgD,CAAC;AAgBrF,6DAA6D;AAC7D,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAqDxE"}

package/dist/utils/tool-pair-repair.js

@@ -0,0 +1,70 @@
+export const TOOL_RESULT_PLACEHOLDER = "Tool output unavailable (context compacted)";
+/**
+ * Retry diagnostic for a dangling tool call flagged `incomplete` by the text
+ * tool-call middleware (truncated and unrecoverable at stream end). Tells the
+ * model the call never ran and should be re-issued with complete arguments.
+ * Duplicated verbatim in the sibling pair-repair copy — the two packages
+ * intentionally do not share this constant (no new cross-package dependency).
+ */
+function incompleteToolCallRetryText(name, errorMessage) {
+    if (errorMessage !== undefined) {
+        return `${errorMessage}${errorMessage.endsWith(".") ? "" : "."} Re-issue the tool call with complete arguments.`;
+    }
+    return `Tool call "${name}" was not executed: the response ended before the tool call was complete. Re-issue the tool call with complete arguments.`;
+}
+/** Repairs orphaned tool results and dangling tool calls. */
+export function repairOrphanedToolResults(messages) {
+    const toolCallIds = new Set();
+    const toolResultIds = new Set();
+    for (const message of messages) {
+        if (message.role === "assistant") {
+            for (const block of message.content) {
+                if (block.type === "toolCall")
+                    toolCallIds.add(block.id);
+            }
+        }
+        if (message.role === "toolResult")
+            toolResultIds.add(message.toolCallId);
+    }
+    const output = [];
+    const dangling = new Set([...toolCallIds].filter((id) => !toolResultIds.has(id)));
+    for (const message of messages) {
+        if (message.role === "toolResult") {
+            if (!toolCallIds.has(message.toolCallId)) {
+                output.push({
+                    ...message,
+                    content: [{ type: "text", text: TOOL_RESULT_PLACEHOLDER }],
+                });
+                continue;
+            }
+            output.push(message);
+            continue;
+        }
+        output.push(message);
+        if (message.role === "assistant") {
+            // Errored/aborted assistants are dropped downstream by transformMessages;
+            // synthesizing results for their calls would only create orphans there.
+            if (message.stopReason === "error" || message.stopReason === "aborted")
+                continue;
+            for (const block of message.content) {
+                if (block.type !== "toolCall" || !dangling.has(block.id))
+                    continue;
+                const incomplete = block.incomplete === true;
+                const text = incomplete
+                    ? incompleteToolCallRetryText(block.name, block.errorMessage)
+                    : TOOL_RESULT_PLACEHOLDER;
+                output.push({
+                    role: "toolResult",
+                    toolCallId: block.id,
+                    toolName: block.name,
+                    content: [{ type: "text", text }],
+                    isError: incomplete,
+                    timestamp: message.timestamp ? message.timestamp + 1 : Date.now(),
+                });
+                dangling.delete(block.id);
+            }
+        }
+    }
+    return output;
+}
+//# sourceMappingURL=tool-pair-repair.js.map

package/dist/utils/tool-pair-repair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-pair-repair.js","sourceRoot":"","sources":["../../src/utils/tool-pair-repair.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Message, TextContent } from \"../types.ts\";\n\nexport const TOOL_RESULT_PLACEHOLDER = \"Tool output unavailable (context compacted)\";\n\n/**\n * Retry diagnostic for a dangling tool call flagged `incomplete` by the text\n * tool-call middleware (truncated and unrecoverable at stream end). Tells the\n * model the call never ran and should be re-issued with complete arguments.\n * Duplicated verbatim in the sibling pair-repair copy — the two packages\n * intentionally do not share this constant (no new cross-package dependency).\n */\nfunction incompleteToolCallRetryText(name: string, errorMessage?: string): string {\n\tif (errorMessage !== undefined) {\n\t\treturn `${errorMessage}${errorMessage.endsWith(\".\") ? \"\" : \".\"} Re-issue the tool call with complete arguments.`;\n\t}\n\treturn `Tool call \"${name}\" was not executed: the response ended before the tool call was complete. Re-issue the tool call with complete arguments.`;\n}\n\n/** Repairs orphaned tool results and dangling tool calls. */\nexport function repairOrphanedToolResults(messages: Message[]): Message[] {\n\tconst toolCallIds = new Set<string>();\n\tconst toolResultIds = new Set<string>();\n\tfor (const message of messages) {\n\t\tif (message.role === \"assistant\") {\n\t\t\tfor (const block of message.content) {\n\t\t\t\tif (block.type === \"toolCall\") toolCallIds.add(block.id);\n\t\t\t}\n\t\t}\n\t\tif (message.role === \"toolResult\") toolResultIds.add(message.toolCallId);\n\t}\n\n\tconst output: Message[] = [];\n\tconst dangling = new Set([...toolCallIds].filter((id) => !toolResultIds.has(id)));\n\n\tfor (const message of messages) {\n\t\tif (message.role === \"toolResult\") {\n\t\t\tif (!toolCallIds.has(message.toolCallId)) {\n\t\t\t\toutput.push({\n\t\t\t\t\t...message,\n\t\t\t\t\tcontent: [{ type: \"text\", text: TOOL_RESULT_PLACEHOLDER }] satisfies TextContent[],\n\t\t\t\t});\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\toutput.push(message);\n\t\t\tcontinue;\n\t\t}\n\n\t\toutput.push(message);\n\t\tif (message.role === \"assistant\") {\n\t\t\t// Errored/aborted assistants are dropped downstream by transformMessages;\n\t\t\t// synthesizing results for their calls would only create orphans there.\n\t\t\tif (message.stopReason === \"error\" || message.stopReason === \"aborted\") continue;\n\t\t\tfor (const block of message.content) {\n\t\t\t\tif (block.type !== \"toolCall\" || !dangling.has(block.id)) continue;\n\t\t\t\tconst incomplete = block.incomplete === true;\n\t\t\t\tconst text = incomplete\n\t\t\t\t\t? incompleteToolCallRetryText(block.name, block.errorMessage)\n\t\t\t\t\t: TOOL_RESULT_PLACEHOLDER;\n\t\t\t\toutput.push({\n\t\t\t\t\trole: \"toolResult\",\n\t\t\t\t\ttoolCallId: block.id,\n\t\t\t\t\ttoolName: block.name,\n\t\t\t\t\tcontent: [{ type: \"text\", text }],\n\t\t\t\t\tisError: incomplete,\n\t\t\t\t\ttimestamp: message.timestamp ? message.timestamp + 1 : Date.now(),\n\t\t\t\t});\n\t\t\t\tdangling.delete(block.id);\n\t\t\t}\n\t\t}\n\t}\n\n\treturn output;\n}\n"]}

package/dist/utils/tool-schema-compat.d.ts

@@ -0,0 +1,19 @@
+/**
+ * JSON Schema normalization for tool parameters sent to OpenAI-compatible
+ * backends. Some gateways (e.g. Apitopia → Kimi / Moonshot) enforce a stricter
+ * subset that rejects a sibling `type` keyword on schemas that also declare
+ * `anyOf` / `oneOf` / `allOf`. This helper removes that redundancy while
+ * preserving the schema's semantics.
+ */
+export type ToolSchemaFlavor = "moonshot-mfjs";
+/**
+ * Return a deep-normalized copy of a tool's JSON Schema parameters, suitable
+ * for OpenAI-compatible Chat Completions backends.
+ */
+export declare function normalizeToolParametersForOpenAICompat(schema: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Moonshot-flavored JSON Schema subset: in addition to the OpenAI-compatible
+ * normalization, drop non-structural annotation keywords that Moonshot rejects.
+ */
+export declare function normalizeToolParametersForMoonshot(schema: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=tool-schema-compat.d.ts.map

package/dist/utils/tool-schema-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema-compat.d.ts","sourceRoot":"","sources":["../../src/utils/tool-schema-compat.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,gBAAgB,GAAG,eAAe,CAAC;AA4K/C;;;GAGG;AACH,wBAAgB,sCAAsC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE/G;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG3G"}