@zhachory1/mewrite-ai 0.65.3

package/dist/providers/simple-options.js

@@ -0,0 +1,35 @@
+export function buildBaseOptions(model, options, apiKey) {
+    return {
+        temperature: options?.temperature,
+        maxTokens: options?.maxTokens || Math.min(model.maxTokens, 32000),
+        signal: options?.signal,
+        apiKey: apiKey || options?.apiKey,
+        cacheRetention: options?.cacheRetention,
+        sessionId: options?.sessionId,
+        headers: options?.headers,
+        onPayload: options?.onPayload,
+        maxRetryDelayMs: options?.maxRetryDelayMs,
+        metadata: options?.metadata,
+    };
+}
+export function clampReasoning(effort) {
+    return effort === "xhigh" ? "high" : effort;
+}
+export function adjustMaxTokensForThinking(baseMaxTokens, modelMaxTokens, reasoningLevel, customBudgets) {
+    const defaultBudgets = {
+        minimal: 1024,
+        low: 2048,
+        medium: 8192,
+        high: 16384,
+    };
+    const budgets = { ...defaultBudgets, ...customBudgets };
+    const minOutputTokens = 1024;
+    const level = clampReasoning(reasoningLevel);
+    let thinkingBudget = budgets[level];
+    const maxTokens = Math.min(baseMaxTokens + thinkingBudget, modelMaxTokens);
+    if (maxTokens <= thinkingBudget) {
+        thinkingBudget = Math.max(0, maxTokens - minOutputTokens);
+    }
+    return { maxTokens, thinkingBudget };
+}
+//# sourceMappingURL=simple-options.js.map

package/dist/providers/simple-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-options.js","sourceRoot":"","sources":["../../src/providers/simple-options.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,KAAiB,EAAE,OAA6B,EAAE,MAAe,EAAiB;IAClH,OAAO;QACN,WAAW,EAAE,OAAO,EAAE,WAAW;QACjC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC;QACjE,MAAM,EAAE,OAAO,EAAE,MAAM;QACvB,MAAM,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM;QACjC,cAAc,EAAE,OAAO,EAAE,cAAc;QACvC,SAAS,EAAE,OAAO,EAAE,SAAS;QAC7B,OAAO,EAAE,OAAO,EAAE,OAAO;QACzB,SAAS,EAAE,OAAO,EAAE,SAAS;QAC7B,eAAe,EAAE,OAAO,EAAE,eAAe;QACzC,QAAQ,EAAE,OAAO,EAAE,QAAQ;KAC3B,CAAC;AAAA,CACF;AAED,MAAM,UAAU,cAAc,CAAC,MAAiC,EAA+C;IAC9G,OAAO,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AAAA,CAC5C;AAED,MAAM,UAAU,0BAA0B,CACzC,aAAqB,EACrB,cAAsB,EACtB,cAA6B,EAC7B,aAA+B,EACiB;IAChD,MAAM,cAAc,GAAoB;QACvC,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,IAAI;QACT,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,KAAK;KACX,CAAC;IACF,MAAM,OAAO,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,aAAa,EAAE,CAAC;IAExD,MAAM,eAAe,GAAG,IAAI,CAAC;IAC7B,MAAM,KAAK,GAAG,cAAc,CAAC,cAAc,CAAE,CAAC;IAC9C,IAAI,cAAc,GAAG,OAAO,CAAC,KAAK,CAAE,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,cAAc,EAAE,cAAc,CAAC,CAAC;IAE3E,IAAI,SAAS,IAAI,cAAc,EAAE,CAAC;QACjC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,eAAe,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;AAAA,CACrC","sourcesContent":["import type { Api, Model, SimpleStreamOptions, StreamOptions, ThinkingBudgets, ThinkingLevel } from \"../types.js\";\n\nexport function buildBaseOptions(model: Model<Api>, options?: SimpleStreamOptions, apiKey?: string): StreamOptions {\n\treturn {\n\t\ttemperature: options?.temperature,\n\t\tmaxTokens: options?.maxTokens || Math.min(model.maxTokens, 32000),\n\t\tsignal: options?.signal,\n\t\tapiKey: apiKey || options?.apiKey,\n\t\tcacheRetention: options?.cacheRetention,\n\t\tsessionId: options?.sessionId,\n\t\theaders: options?.headers,\n\t\tonPayload: options?.onPayload,\n\t\tmaxRetryDelayMs: options?.maxRetryDelayMs,\n\t\tmetadata: options?.metadata,\n\t};\n}\n\nexport function clampReasoning(effort: ThinkingLevel | undefined): Exclude<ThinkingLevel, \"xhigh\"> | undefined {\n\treturn effort === \"xhigh\" ? \"high\" : effort;\n}\n\nexport function adjustMaxTokensForThinking(\n\tbaseMaxTokens: number,\n\tmodelMaxTokens: number,\n\treasoningLevel: ThinkingLevel,\n\tcustomBudgets?: ThinkingBudgets,\n): { maxTokens: number; thinkingBudget: number } {\n\tconst defaultBudgets: ThinkingBudgets = {\n\t\tminimal: 1024,\n\t\tlow: 2048,\n\t\tmedium: 8192,\n\t\thigh: 16384,\n\t};\n\tconst budgets = { ...defaultBudgets, ...customBudgets };\n\n\tconst minOutputTokens = 1024;\n\tconst level = clampReasoning(reasoningLevel)!;\n\tlet thinkingBudget = budgets[level]!;\n\tconst maxTokens = Math.min(baseMaxTokens + thinkingBudget, modelMaxTokens);\n\n\tif (maxTokens <= thinkingBudget) {\n\t\tthinkingBudget = Math.max(0, maxTokens - minOutputTokens);\n\t}\n\n\treturn { maxTokens, thinkingBudget };\n}\n"]}

package/dist/providers/transform-messages.d.ts

@@ -0,0 +1,8 @@
+import type { Api, AssistantMessage, Message, Model } from "../types.js";
+/**
+ * Normalize tool call ID for cross-provider compatibility.
+ * OpenAI Responses API generates IDs that are 450+ chars with special characters like `|`.
+ * Anthropic APIs require IDs matching ^[a-zA-Z0-9_-]+$ (max 64 chars).
+ */
+export declare function transformMessages<TApi extends Api>(messages: Message[], model: Model<TApi>, normalizeToolCallId?: (id: string, model: Model<TApi>, source: AssistantMessage) => string): Message[];
+//# sourceMappingURL=transform-messages.d.ts.map

package/dist/providers/transform-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-messages.d.ts","sourceRoot":"","sources":["../../src/providers/transform-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,KAAK,EAA+B,MAAM,aAAa,CAAC;AAEtG;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,SAAS,GAAG,EACjD,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,mBAAmB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,gBAAgB,KAAK,MAAM,GACxF,OAAO,EAAE,CAgKX","sourcesContent":["import type { Api, AssistantMessage, Message, Model, ToolCall, ToolResultMessage } from \"../types.js\";\n\n/**\n * Normalize tool call ID for cross-provider compatibility.\n * OpenAI Responses API generates IDs that are 450+ chars with special characters like `|`.\n * Anthropic APIs require IDs matching ^[a-zA-Z0-9_-]+$ (max 64 chars).\n */\nexport function transformMessages<TApi extends Api>(\n\tmessages: Message[],\n\tmodel: Model<TApi>,\n\tnormalizeToolCallId?: (id: string, model: Model<TApi>, source: AssistantMessage) => string,\n): Message[] {\n\t// Build a map of original tool call IDs to normalized IDs\n\tconst toolCallIdMap = new Map<string, string>();\n\n\t// First pass: transform messages (thinking blocks, tool call ID normalization)\n\tconst transformed = messages.map((msg) => {\n\t\t// User messages pass through unchanged\n\t\tif (msg.role === \"user\") {\n\t\t\treturn msg;\n\t\t}\n\n\t\t// Handle toolResult messages - normalize toolCallId if we have a mapping\n\t\tif (msg.role === \"toolResult\") {\n\t\t\tconst normalizedId = toolCallIdMap.get(msg.toolCallId);\n\t\t\tif (normalizedId && normalizedId !== msg.toolCallId) {\n\t\t\t\treturn { ...msg, toolCallId: normalizedId };\n\t\t\t}\n\t\t\treturn msg;\n\t\t}\n\n\t\t// Assistant messages need transformation check\n\t\tif (msg.role === \"assistant\") {\n\t\t\tconst assistantMsg = msg as AssistantMessage;\n\t\t\tconst isSameModel =\n\t\t\t\tassistantMsg.provider === model.provider &&\n\t\t\t\tassistantMsg.api === model.api &&\n\t\t\t\tassistantMsg.model === model.id;\n\n\t\t\tconst transformedContent = assistantMsg.content.flatMap((block) => {\n\t\t\t\tif (block.type === \"thinking\") {\n\t\t\t\t\t// Redacted thinking is opaque encrypted content, only valid for the same model.\n\t\t\t\t\t// Drop it for cross-model to avoid API errors.\n\t\t\t\t\tif (block.redacted) {\n\t\t\t\t\t\treturn isSameModel ? block : [];\n\t\t\t\t\t}\n\t\t\t\t\t// For same model: keep thinking blocks with signatures (needed for replay)\n\t\t\t\t\t// even if the thinking text is empty (OpenAI encrypted reasoning)\n\t\t\t\t\tif (isSameModel && block.thinkingSignature) return block;\n\t\t\t\t\t// Skip empty thinking blocks, convert others to plain text\n\t\t\t\t\tif (!block.thinking || block.thinking.trim() === \"\") return [];\n\t\t\t\t\tif (isSameModel) return block;\n\t\t\t\t\treturn {\n\t\t\t\t\t\ttype: \"text\" as const,\n\t\t\t\t\t\ttext: block.thinking,\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tif (block.type === \"text\") {\n\t\t\t\t\tif (isSameModel) return block;\n\t\t\t\t\treturn {\n\t\t\t\t\t\ttype: \"text\" as const,\n\t\t\t\t\t\ttext: block.text,\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tif (block.type === \"toolCall\") {\n\t\t\t\t\tconst toolCall = block as ToolCall;\n\t\t\t\t\tlet normalizedToolCall: ToolCall = toolCall;\n\n\t\t\t\t\tif (!isSameModel && toolCall.thoughtSignature) {\n\t\t\t\t\t\tnormalizedToolCall = { ...toolCall };\n\t\t\t\t\t\tdelete (normalizedToolCall as { thoughtSignature?: string }).thoughtSignature;\n\t\t\t\t\t}\n\n\t\t\t\t\tif (!isSameModel && normalizeToolCallId) {\n\t\t\t\t\t\tconst normalizedId = normalizeToolCallId(toolCall.id, model, assistantMsg);\n\t\t\t\t\t\tif (normalizedId !== toolCall.id) {\n\t\t\t\t\t\t\ttoolCallIdMap.set(toolCall.id, normalizedId);\n\t\t\t\t\t\t\tnormalizedToolCall = { ...normalizedToolCall, id: normalizedId };\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\treturn normalizedToolCall;\n\t\t\t\t}\n\n\t\t\t\treturn block;\n\t\t\t});\n\n\t\t\treturn {\n\t\t\t\t...assistantMsg,\n\t\t\t\tcontent: transformedContent,\n\t\t\t};\n\t\t}\n\t\treturn msg;\n\t});\n\n\t// Second pass: insert synthetic empty tool results for orphaned tool calls\n\t// This preserves thinking signatures and satisfies API requirements\n\tconst result: Message[] = [];\n\tlet pendingToolCalls: ToolCall[] = [];\n\tlet existingToolResultIds = new Set<string>();\n\n\tfor (let i = 0; i < transformed.length; i++) {\n\t\tconst msg = transformed[i];\n\n\t\tif (msg.role === \"assistant\") {\n\t\t\t// If we have pending orphaned tool calls from a previous assistant, insert synthetic results now\n\t\t\tif (pendingToolCalls.length > 0) {\n\t\t\t\tfor (const tc of pendingToolCalls) {\n\t\t\t\t\tif (!existingToolResultIds.has(tc.id)) {\n\t\t\t\t\t\tresult.push({\n\t\t\t\t\t\t\trole: \"toolResult\",\n\t\t\t\t\t\t\ttoolCallId: tc.id,\n\t\t\t\t\t\t\ttoolName: tc.name,\n\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"No result provided\" }],\n\t\t\t\t\t\t\tisError: true,\n\t\t\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t\t\t} as ToolResultMessage);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tpendingToolCalls = [];\n\t\t\t\texistingToolResultIds = new Set();\n\t\t\t}\n\n\t\t\t// Skip errored/aborted assistant messages entirely.\n\t\t\t// These are incomplete turns that shouldn't be replayed:\n\t\t\t// - May have partial content (reasoning without message, incomplete tool calls)\n\t\t\t// - Replaying them can cause API errors (e.g., OpenAI \"reasoning without following item\")\n\t\t\t// - The model should retry from the last valid state\n\t\t\tconst assistantMsg = msg as AssistantMessage;\n\t\t\tif (assistantMsg.stopReason === \"error\" || assistantMsg.stopReason === \"aborted\") {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Track tool calls from this assistant message\n\t\t\tconst toolCalls = assistantMsg.content.filter((b) => b.type === \"toolCall\") as ToolCall[];\n\t\t\tif (toolCalls.length > 0) {\n\t\t\t\tpendingToolCalls = toolCalls;\n\t\t\t\texistingToolResultIds = new Set();\n\t\t\t}\n\n\t\t\tresult.push(msg);\n\t\t} else if (msg.role === \"toolResult\") {\n\t\t\texistingToolResultIds.add(msg.toolCallId);\n\t\t\tresult.push(msg);\n\t\t} else if (msg.role === \"user\") {\n\t\t\t// User message interrupts tool flow - insert synthetic results for orphaned calls\n\t\t\tif (pendingToolCalls.length > 0) {\n\t\t\t\tfor (const tc of pendingToolCalls) {\n\t\t\t\t\tif (!existingToolResultIds.has(tc.id)) {\n\t\t\t\t\t\tresult.push({\n\t\t\t\t\t\t\trole: \"toolResult\",\n\t\t\t\t\t\t\ttoolCallId: tc.id,\n\t\t\t\t\t\t\ttoolName: tc.name,\n\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"No result provided\" }],\n\t\t\t\t\t\t\tisError: true,\n\t\t\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t\t\t} as ToolResultMessage);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tpendingToolCalls = [];\n\t\t\t\texistingToolResultIds = new Set();\n\t\t\t}\n\t\t\tresult.push(msg);\n\t\t} else {\n\t\t\tresult.push(msg);\n\t\t}\n\t}\n\n\treturn result;\n}\n"]}

package/dist/providers/transform-messages.js

@@ -0,0 +1,155 @@
+/**
+ * Normalize tool call ID for cross-provider compatibility.
+ * OpenAI Responses API generates IDs that are 450+ chars with special characters like `|`.
+ * Anthropic APIs require IDs matching ^[a-zA-Z0-9_-]+$ (max 64 chars).
+ */
+export function transformMessages(messages, model, normalizeToolCallId) {
+    // Build a map of original tool call IDs to normalized IDs
+    const toolCallIdMap = new Map();
+    // First pass: transform messages (thinking blocks, tool call ID normalization)
+    const transformed = messages.map((msg) => {
+        // User messages pass through unchanged
+        if (msg.role === "user") {
+            return msg;
+        }
+        // Handle toolResult messages - normalize toolCallId if we have a mapping
+        if (msg.role === "toolResult") {
+            const normalizedId = toolCallIdMap.get(msg.toolCallId);
+            if (normalizedId && normalizedId !== msg.toolCallId) {
+                return { ...msg, toolCallId: normalizedId };
+            }
+            return msg;
+        }
+        // Assistant messages need transformation check
+        if (msg.role === "assistant") {
+            const assistantMsg = msg;
+            const isSameModel = assistantMsg.provider === model.provider &&
+                assistantMsg.api === model.api &&
+                assistantMsg.model === model.id;
+            const transformedContent = assistantMsg.content.flatMap((block) => {
+                if (block.type === "thinking") {
+                    // Redacted thinking is opaque encrypted content, only valid for the same model.
+                    // Drop it for cross-model to avoid API errors.
+                    if (block.redacted) {
+                        return isSameModel ? block : [];
+                    }
+                    // For same model: keep thinking blocks with signatures (needed for replay)
+                    // even if the thinking text is empty (OpenAI encrypted reasoning)
+                    if (isSameModel && block.thinkingSignature)
+                        return block;
+                    // Skip empty thinking blocks, convert others to plain text
+                    if (!block.thinking || block.thinking.trim() === "")
+                        return [];
+                    if (isSameModel)
+                        return block;
+                    return {
+                        type: "text",
+                        text: block.thinking,
+                    };
+                }
+                if (block.type === "text") {
+                    if (isSameModel)
+                        return block;
+                    return {
+                        type: "text",
+                        text: block.text,
+                    };
+                }
+                if (block.type === "toolCall") {
+                    const toolCall = block;
+                    let normalizedToolCall = toolCall;
+                    if (!isSameModel && toolCall.thoughtSignature) {
+                        normalizedToolCall = { ...toolCall };
+                        delete normalizedToolCall.thoughtSignature;
+                    }
+                    if (!isSameModel && normalizeToolCallId) {
+                        const normalizedId = normalizeToolCallId(toolCall.id, model, assistantMsg);
+                        if (normalizedId !== toolCall.id) {
+                            toolCallIdMap.set(toolCall.id, normalizedId);
+                            normalizedToolCall = { ...normalizedToolCall, id: normalizedId };
+                        }
+                    }
+                    return normalizedToolCall;
+                }
+                return block;
+            });
+            return {
+                ...assistantMsg,
+                content: transformedContent,
+            };
+        }
+        return msg;
+    });
+    // Second pass: insert synthetic empty tool results for orphaned tool calls
+    // This preserves thinking signatures and satisfies API requirements
+    const result = [];
+    let pendingToolCalls = [];
+    let existingToolResultIds = new Set();
+    for (let i = 0; i < transformed.length; i++) {
+        const msg = transformed[i];
+        if (msg.role === "assistant") {
+            // If we have pending orphaned tool calls from a previous assistant, insert synthetic results now
+            if (pendingToolCalls.length > 0) {
+                for (const tc of pendingToolCalls) {
+                    if (!existingToolResultIds.has(tc.id)) {
+                        result.push({
+                            role: "toolResult",
+                            toolCallId: tc.id,
+                            toolName: tc.name,
+                            content: [{ type: "text", text: "No result provided" }],
+                            isError: true,
+                            timestamp: Date.now(),
+                        });
+                    }
+                }
+                pendingToolCalls = [];
+                existingToolResultIds = new Set();
+            }
+            // Skip errored/aborted assistant messages entirely.
+            // These are incomplete turns that shouldn't be replayed:
+            // - May have partial content (reasoning without message, incomplete tool calls)
+            // - Replaying them can cause API errors (e.g., OpenAI "reasoning without following item")
+            // - The model should retry from the last valid state
+            const assistantMsg = msg;
+            if (assistantMsg.stopReason === "error" || assistantMsg.stopReason === "aborted") {
+                continue;
+            }
+            // Track tool calls from this assistant message
+            const toolCalls = assistantMsg.content.filter((b) => b.type === "toolCall");
+            if (toolCalls.length > 0) {
+                pendingToolCalls = toolCalls;
+                existingToolResultIds = new Set();
+            }
+            result.push(msg);
+        }
+        else if (msg.role === "toolResult") {
+            existingToolResultIds.add(msg.toolCallId);
+            result.push(msg);
+        }
+        else if (msg.role === "user") {
+            // User message interrupts tool flow - insert synthetic results for orphaned calls
+            if (pendingToolCalls.length > 0) {
+                for (const tc of pendingToolCalls) {
+                    if (!existingToolResultIds.has(tc.id)) {
+                        result.push({
+                            role: "toolResult",
+                            toolCallId: tc.id,
+                            toolName: tc.name,
+                            content: [{ type: "text", text: "No result provided" }],
+                            isError: true,
+                            timestamp: Date.now(),
+                        });
+                    }
+                }
+                pendingToolCalls = [];
+                existingToolResultIds = new Set();
+            }
+            result.push(msg);
+        }
+        else {
+            result.push(msg);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=transform-messages.js.map

package/dist/providers/transform-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-messages.js","sourceRoot":"","sources":["../../src/providers/transform-messages.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Api, AssistantMessage, Message, Model, ToolCall, ToolResultMessage } from \"../types.js\";\n\n/**\n * Normalize tool call ID for cross-provider compatibility.\n * OpenAI Responses API generates IDs that are 450+ chars with special characters like `|`.\n * Anthropic APIs require IDs matching ^[a-zA-Z0-9_-]+$ (max 64 chars).\n */\nexport function transformMessages<TApi extends Api>(\n\tmessages: Message[],\n\tmodel: Model<TApi>,\n\tnormalizeToolCallId?: (id: string, model: Model<TApi>, source: AssistantMessage) => string,\n): Message[] {\n\t// Build a map of original tool call IDs to normalized IDs\n\tconst toolCallIdMap = new Map<string, string>();\n\n\t// First pass: transform messages (thinking blocks, tool call ID normalization)\n\tconst transformed = messages.map((msg) => {\n\t\t// User messages pass through unchanged\n\t\tif (msg.role === \"user\") {\n\t\t\treturn msg;\n\t\t}\n\n\t\t// Handle toolResult messages - normalize toolCallId if we have a mapping\n\t\tif (msg.role === \"toolResult\") {\n\t\t\tconst normalizedId = toolCallIdMap.get(msg.toolCallId);\n\t\t\tif (normalizedId && normalizedId !== msg.toolCallId) {\n\t\t\t\treturn { ...msg, toolCallId: normalizedId };\n\t\t\t}\n\t\t\treturn msg;\n\t\t}\n\n\t\t// Assistant messages need transformation check\n\t\tif (msg.role === \"assistant\") {\n\t\t\tconst assistantMsg = msg as AssistantMessage;\n\t\t\tconst isSameModel =\n\t\t\t\tassistantMsg.provider === model.provider &&\n\t\t\t\tassistantMsg.api === model.api &&\n\t\t\t\tassistantMsg.model === model.id;\n\n\t\t\tconst transformedContent = assistantMsg.content.flatMap((block) => {\n\t\t\t\tif (block.type === \"thinking\") {\n\t\t\t\t\t// Redacted thinking is opaque encrypted content, only valid for the same model.\n\t\t\t\t\t// Drop it for cross-model to avoid API errors.\n\t\t\t\t\tif (block.redacted) {\n\t\t\t\t\t\treturn isSameModel ? block : [];\n\t\t\t\t\t}\n\t\t\t\t\t// For same model: keep thinking blocks with signatures (needed for replay)\n\t\t\t\t\t// even if the thinking text is empty (OpenAI encrypted reasoning)\n\t\t\t\t\tif (isSameModel && block.thinkingSignature) return block;\n\t\t\t\t\t// Skip empty thinking blocks, convert others to plain text\n\t\t\t\t\tif (!block.thinking || block.thinking.trim() === \"\") return [];\n\t\t\t\t\tif (isSameModel) return block;\n\t\t\t\t\treturn {\n\t\t\t\t\t\ttype: \"text\" as const,\n\t\t\t\t\t\ttext: block.thinking,\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tif (block.type === \"text\") {\n\t\t\t\t\tif (isSameModel) return block;\n\t\t\t\t\treturn {\n\t\t\t\t\t\ttype: \"text\" as const,\n\t\t\t\t\t\ttext: block.text,\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tif (block.type === \"toolCall\") {\n\t\t\t\t\tconst toolCall = block as ToolCall;\n\t\t\t\t\tlet normalizedToolCall: ToolCall = toolCall;\n\n\t\t\t\t\tif (!isSameModel && toolCall.thoughtSignature) {\n\t\t\t\t\t\tnormalizedToolCall = { ...toolCall };\n\t\t\t\t\t\tdelete (normalizedToolCall as { thoughtSignature?: string }).thoughtSignature;\n\t\t\t\t\t}\n\n\t\t\t\t\tif (!isSameModel && normalizeToolCallId) {\n\t\t\t\t\t\tconst normalizedId = normalizeToolCallId(toolCall.id, model, assistantMsg);\n\t\t\t\t\t\tif (normalizedId !== toolCall.id) {\n\t\t\t\t\t\t\ttoolCallIdMap.set(toolCall.id, normalizedId);\n\t\t\t\t\t\t\tnormalizedToolCall = { ...normalizedToolCall, id: normalizedId };\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\treturn normalizedToolCall;\n\t\t\t\t}\n\n\t\t\t\treturn block;\n\t\t\t});\n\n\t\t\treturn {\n\t\t\t\t...assistantMsg,\n\t\t\t\tcontent: transformedContent,\n\t\t\t};\n\t\t}\n\t\treturn msg;\n\t});\n\n\t// Second pass: insert synthetic empty tool results for orphaned tool calls\n\t// This preserves thinking signatures and satisfies API requirements\n\tconst result: Message[] = [];\n\tlet pendingToolCalls: ToolCall[] = [];\n\tlet existingToolResultIds = new Set<string>();\n\n\tfor (let i = 0; i < transformed.length; i++) {\n\t\tconst msg = transformed[i];\n\n\t\tif (msg.role === \"assistant\") {\n\t\t\t// If we have pending orphaned tool calls from a previous assistant, insert synthetic results now\n\t\t\tif (pendingToolCalls.length > 0) {\n\t\t\t\tfor (const tc of pendingToolCalls) {\n\t\t\t\t\tif (!existingToolResultIds.has(tc.id)) {\n\t\t\t\t\t\tresult.push({\n\t\t\t\t\t\t\trole: \"toolResult\",\n\t\t\t\t\t\t\ttoolCallId: tc.id,\n\t\t\t\t\t\t\ttoolName: tc.name,\n\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"No result provided\" }],\n\t\t\t\t\t\t\tisError: true,\n\t\t\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t\t\t} as ToolResultMessage);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tpendingToolCalls = [];\n\t\t\t\texistingToolResultIds = new Set();\n\t\t\t}\n\n\t\t\t// Skip errored/aborted assistant messages entirely.\n\t\t\t// These are incomplete turns that shouldn't be replayed:\n\t\t\t// - May have partial content (reasoning without message, incomplete tool calls)\n\t\t\t// - Replaying them can cause API errors (e.g., OpenAI \"reasoning without following item\")\n\t\t\t// - The model should retry from the last valid state\n\t\t\tconst assistantMsg = msg as AssistantMessage;\n\t\t\tif (assistantMsg.stopReason === \"error\" || assistantMsg.stopReason === \"aborted\") {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Track tool calls from this assistant message\n\t\t\tconst toolCalls = assistantMsg.content.filter((b) => b.type === \"toolCall\") as ToolCall[];\n\t\t\tif (toolCalls.length > 0) {\n\t\t\t\tpendingToolCalls = toolCalls;\n\t\t\t\texistingToolResultIds = new Set();\n\t\t\t}\n\n\t\t\tresult.push(msg);\n\t\t} else if (msg.role === \"toolResult\") {\n\t\t\texistingToolResultIds.add(msg.toolCallId);\n\t\t\tresult.push(msg);\n\t\t} else if (msg.role === \"user\") {\n\t\t\t// User message interrupts tool flow - insert synthetic results for orphaned calls\n\t\t\tif (pendingToolCalls.length > 0) {\n\t\t\t\tfor (const tc of pendingToolCalls) {\n\t\t\t\t\tif (!existingToolResultIds.has(tc.id)) {\n\t\t\t\t\t\tresult.push({\n\t\t\t\t\t\t\trole: \"toolResult\",\n\t\t\t\t\t\t\ttoolCallId: tc.id,\n\t\t\t\t\t\t\ttoolName: tc.name,\n\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"No result provided\" }],\n\t\t\t\t\t\t\tisError: true,\n\t\t\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t\t\t} as ToolResultMessage);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tpendingToolCalls = [];\n\t\t\t\texistingToolResultIds = new Set();\n\t\t\t}\n\t\t\tresult.push(msg);\n\t\t} else {\n\t\t\tresult.push(msg);\n\t\t}\n\t}\n\n\treturn result;\n}\n"]}

package/dist/registry/fetcher.d.ts

@@ -0,0 +1,26 @@
+/**
+ * WS15: Registry fetcher — HTTP fetch + atomic cache write.
+ *
+ * Fetches the registry from the remote URL, validates it, and writes to
+ * ~/.cave/agent/registry-cache.json atomically (write-then-rename).
+ */
+import { type Registry } from "./schema.js";
+export type FetchChannel = "stable" | "beta";
+export type FetchRegistryResult = {
+    ok: true;
+    registry: Registry;
+    cached: boolean;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Fetch registry JSON from remote URL, validate, and atomically write to
+ * cachePath. Returns the validated Registry on success.
+ *
+ * @param cachePath  Absolute path to write the cache file.
+ * @param channel    "stable" (default) or "beta".
+ * @param fetchImpl  Injectable fetch (defaults to globalThis.fetch / Node 18+).
+ */
+export declare function fetchAndCacheRegistry(cachePath: string, channel?: FetchChannel, fetchImpl?: typeof fetch): Promise<FetchRegistryResult>;
+//# sourceMappingURL=fetcher.d.ts.map

package/dist/registry/fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../src/registry/fetcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,KAAK,QAAQ,EAAoB,MAAM,aAAa,CAAC;AAE9D,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AAU7C,MAAM,MAAM,mBAAmB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnH;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CAC1C,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,YAAuB,EAChC,SAAS,GAAE,OAAO,KAAwB,GACxC,OAAO,CAAC,mBAAmB,CAAC,CA+C9B","sourcesContent":["/**\n * WS15: Registry fetcher — HTTP fetch + atomic cache write.\n *\n * Fetches the registry from the remote URL, validates it, and writes to\n * ~/.cave/agent/registry-cache.json atomically (write-then-rename).\n */\n\nimport { mkdirSync, renameSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\nimport { type Registry, validateRegistry } from \"./schema.js\";\n\nexport type FetchChannel = \"stable\" | \"beta\";\n\nconst REGISTRY_URLS: Record<FetchChannel, string> = {\n\tstable: \"https://raw.githubusercontent.com/cave-cli/registry/main/registry.json\",\n\tbeta: \"https://raw.githubusercontent.com/cave-cli/registry/canary/registry.json\",\n};\n\n/** Default timeout for registry fetch (ms) */\nconst FETCH_TIMEOUT_MS = 10_000;\n\nexport type FetchRegistryResult = { ok: true; registry: Registry; cached: boolean } | { ok: false; error: string };\n\n/**\n * Fetch registry JSON from remote URL, validate, and atomically write to\n * cachePath. Returns the validated Registry on success.\n *\n * @param cachePath  Absolute path to write the cache file.\n * @param channel    \"stable\" (default) or \"beta\".\n * @param fetchImpl  Injectable fetch (defaults to globalThis.fetch / Node 18+).\n */\nexport async function fetchAndCacheRegistry(\n\tcachePath: string,\n\tchannel: FetchChannel = \"stable\",\n\tfetchImpl: typeof fetch = globalThis.fetch,\n): Promise<FetchRegistryResult> {\n\tconst url = REGISTRY_URLS[channel];\n\n\tlet raw: unknown;\n\ttry {\n\t\tconst controller = new AbortController();\n\t\tconst timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n\t\tconst response = await fetchImpl(url, { signal: controller.signal });\n\t\tclearTimeout(timer);\n\n\t\tif (!response.ok) {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\terror: `HTTP ${response.status} fetching registry from ${url}`,\n\t\t\t};\n\t\t}\n\n\t\traw = await response.json();\n\t} catch (err) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\terror: `Failed to fetch registry: ${err instanceof Error ? err.message : String(err)}`,\n\t\t};\n\t}\n\n\tconst result = validateRegistry(raw);\n\tif (!result.ok) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\terror: `Registry validation failed:\\n${result.errors.join(\"\\n\")}`,\n\t\t};\n\t}\n\n\t// Atomic write: write to tmp then rename\n\ttry {\n\t\tmkdirSync(dirname(cachePath), { recursive: true });\n\t\tconst tmpPath = join(tmpdir(), `cave-registry-${Date.now()}.json`);\n\t\twriteFileSync(tmpPath, JSON.stringify(result.registry, null, 2), \"utf-8\");\n\t\trenameSync(tmpPath, cachePath);\n\t} catch (err) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\terror: `Failed to write registry cache: ${err instanceof Error ? err.message : String(err)}`,\n\t\t};\n\t}\n\n\treturn { ok: true, registry: result.registry, cached: true };\n}\n"]}

package/dist/registry/fetcher.js

@@ -0,0 +1,69 @@
+/**
+ * WS15: Registry fetcher — HTTP fetch + atomic cache write.
+ *
+ * Fetches the registry from the remote URL, validates it, and writes to
+ * ~/.cave/agent/registry-cache.json atomically (write-then-rename).
+ */
+import { mkdirSync, renameSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { validateRegistry } from "./schema.js";
+const REGISTRY_URLS = {
+    stable: "https://raw.githubusercontent.com/cave-cli/registry/main/registry.json",
+    beta: "https://raw.githubusercontent.com/cave-cli/registry/canary/registry.json",
+};
+/** Default timeout for registry fetch (ms) */
+const FETCH_TIMEOUT_MS = 10_000;
+/**
+ * Fetch registry JSON from remote URL, validate, and atomically write to
+ * cachePath. Returns the validated Registry on success.
+ *
+ * @param cachePath  Absolute path to write the cache file.
+ * @param channel    "stable" (default) or "beta".
+ * @param fetchImpl  Injectable fetch (defaults to globalThis.fetch / Node 18+).
+ */
+export async function fetchAndCacheRegistry(cachePath, channel = "stable", fetchImpl = globalThis.fetch) {
+    const url = REGISTRY_URLS[channel];
+    let raw;
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        const response = await fetchImpl(url, { signal: controller.signal });
+        clearTimeout(timer);
+        if (!response.ok) {
+            return {
+                ok: false,
+                error: `HTTP ${response.status} fetching registry from ${url}`,
+            };
+        }
+        raw = await response.json();
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: `Failed to fetch registry: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    const result = validateRegistry(raw);
+    if (!result.ok) {
+        return {
+            ok: false,
+            error: `Registry validation failed:\n${result.errors.join("\n")}`,
+        };
+    }
+    // Atomic write: write to tmp then rename
+    try {
+        mkdirSync(dirname(cachePath), { recursive: true });
+        const tmpPath = join(tmpdir(), `cave-registry-${Date.now()}.json`);
+        writeFileSync(tmpPath, JSON.stringify(result.registry, null, 2), "utf-8");
+        renameSync(tmpPath, cachePath);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: `Failed to write registry cache: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    return { ok: true, registry: result.registry, cached: true };
+}
+//# sourceMappingURL=fetcher.js.map

package/dist/registry/fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.js","sourceRoot":"","sources":["../../src/registry/fetcher.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * WS15: Registry fetcher — HTTP fetch + atomic cache write.\n *\n * Fetches the registry from the remote URL, validates it, and writes to\n * ~/.cave/agent/registry-cache.json atomically (write-then-rename).\n */\n\nimport { mkdirSync, renameSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\nimport { type Registry, validateRegistry } from \"./schema.js\";\n\nexport type FetchChannel = \"stable\" | \"beta\";\n\nconst REGISTRY_URLS: Record<FetchChannel, string> = {\n\tstable: \"https://raw.githubusercontent.com/cave-cli/registry/main/registry.json\",\n\tbeta: \"https://raw.githubusercontent.com/cave-cli/registry/canary/registry.json\",\n};\n\n/** Default timeout for registry fetch (ms) */\nconst FETCH_TIMEOUT_MS = 10_000;\n\nexport type FetchRegistryResult = { ok: true; registry: Registry; cached: boolean } | { ok: false; error: string };\n\n/**\n * Fetch registry JSON from remote URL, validate, and atomically write to\n * cachePath. Returns the validated Registry on success.\n *\n * @param cachePath  Absolute path to write the cache file.\n * @param channel    \"stable\" (default) or \"beta\".\n * @param fetchImpl  Injectable fetch (defaults to globalThis.fetch / Node 18+).\n */\nexport async function fetchAndCacheRegistry(\n\tcachePath: string,\n\tchannel: FetchChannel = \"stable\",\n\tfetchImpl: typeof fetch = globalThis.fetch,\n): Promise<FetchRegistryResult> {\n\tconst url = REGISTRY_URLS[channel];\n\n\tlet raw: unknown;\n\ttry {\n\t\tconst controller = new AbortController();\n\t\tconst timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n\t\tconst response = await fetchImpl(url, { signal: controller.signal });\n\t\tclearTimeout(timer);\n\n\t\tif (!response.ok) {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\terror: `HTTP ${response.status} fetching registry from ${url}`,\n\t\t\t};\n\t\t}\n\n\t\traw = await response.json();\n\t} catch (err) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\terror: `Failed to fetch registry: ${err instanceof Error ? err.message : String(err)}`,\n\t\t};\n\t}\n\n\tconst result = validateRegistry(raw);\n\tif (!result.ok) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\terror: `Registry validation failed:\\n${result.errors.join(\"\\n\")}`,\n\t\t};\n\t}\n\n\t// Atomic write: write to tmp then rename\n\ttry {\n\t\tmkdirSync(dirname(cachePath), { recursive: true });\n\t\tconst tmpPath = join(tmpdir(), `cave-registry-${Date.now()}.json`);\n\t\twriteFileSync(tmpPath, JSON.stringify(result.registry, null, 2), \"utf-8\");\n\t\trenameSync(tmpPath, cachePath);\n\t} catch (err) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\terror: `Failed to write registry cache: ${err instanceof Error ? err.message : String(err)}`,\n\t\t};\n\t}\n\n\treturn { ok: true, registry: result.registry, cached: true };\n}\n"]}

package/dist/registry/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * WS15: Catwalk-style provider/model registry — public API.
+ */
+export * from "./fetcher.js";
+export * from "./loader.js";
+export * from "./merger.js";
+export * from "./schema.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC","sourcesContent":["/**\n * WS15: Catwalk-style provider/model registry — public API.\n */\n\nexport * from \"./fetcher.js\";\nexport * from \"./loader.js\";\nexport * from \"./merger.js\";\nexport * from \"./schema.js\";\n"]}

package/dist/registry/index.js

@@ -0,0 +1,8 @@
+/**
+ * WS15: Catwalk-style provider/model registry — public API.
+ */
+export * from "./fetcher.js";
+export * from "./loader.js";
+export * from "./merger.js";
+export * from "./schema.js";
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC","sourcesContent":["/**\n * WS15: Catwalk-style provider/model registry — public API.\n */\n\nexport * from \"./fetcher.js\";\nexport * from \"./loader.js\";\nexport * from \"./merger.js\";\nexport * from \"./schema.js\";\n"]}

package/dist/registry/loader.d.ts

@@ -0,0 +1,38 @@
+/**
+ * WS15: Registry loader — three-tier fallback chain.
+ *
+ * Resolution order (first readable + valid wins):
+ *   1. ~/.cave/agent/registry.json      (user override)
+ *   2. ~/.cave/agent/registry-cache.json (fetched cache)
+ *   3. <package>/registry/registry.json  (bundled fallback)
+ */
+import { type Registry } from "./schema.js";
+/** User override path: ~/.cave/agent/registry.json */
+export declare function getUserOverridePath(configDir?: string): string;
+/** Fetched cache path: ~/.cave/agent/registry-cache.json */
+export declare function getCachePath(configDir?: string): string;
+/**
+ * Bundled fallback path: <package-root>/registry/registry.json
+ *
+ * Works from both src/ (ts-node / tsx) and dist/ (compiled) since the
+ * registry/ dir lives at the package root, one or two levels up from
+ * src/registry/ or dist/registry/.
+ */
+export declare function getBundledRegistryPath(): string;
+export type LoadRegistrySource = "user-override" | "cache" | "bundled";
+export type LoadRegistryResult = {
+    ok: true;
+    registry: Registry;
+    source: LoadRegistrySource;
+} | {
+    ok: false;
+    error: string;
+    tried: string[];
+};
+/**
+ * Load the active registry following the three-tier fallback chain.
+ *
+ * @param configDir  Override ~/.cave/agent base dir (useful in tests).
+ */
+export declare function loadRegistry(configDir?: string): LoadRegistryResult;
+//# sourceMappingURL=loader.d.ts.map

package/dist/registry/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/registry/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAAE,KAAK,QAAQ,EAAoB,MAAM,aAAa,CAAC;AAS9D,sDAAsD;AACtD,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAY/C;AAMD,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvE,MAAM,MAAM,kBAAkB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAC5D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAMjD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAqCnE","sourcesContent":["/**\n * WS15: Registry loader — three-tier fallback chain.\n *\n * Resolution order (first readable + valid wins):\n *   1. ~/.cave/agent/registry.json      (user override)\n *   2. ~/.cave/agent/registry-cache.json (fetched cache)\n *   3. <package>/registry/registry.json  (bundled fallback)\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { type Registry, validateRegistry } from \"./schema.js\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n// ---------------------------------------------------------------------------\n// Path helpers\n// ---------------------------------------------------------------------------\n\n/** User override path: ~/.cave/agent/registry.json */\nexport function getUserOverridePath(configDir?: string): string {\n\tconst base = configDir ?? join(homedir(), \".cave\", \"agent\");\n\treturn join(base, \"registry.json\");\n}\n\n/** Fetched cache path: ~/.cave/agent/registry-cache.json */\nexport function getCachePath(configDir?: string): string {\n\tconst base = configDir ?? join(homedir(), \".cave\", \"agent\");\n\treturn join(base, \"registry-cache.json\");\n}\n\n/**\n * Bundled fallback path: <package-root>/registry/registry.json\n *\n * Works from both src/ (ts-node / tsx) and dist/ (compiled) since the\n * registry/ dir lives at the package root, one or two levels up from\n * src/registry/ or dist/registry/.\n */\nexport function getBundledRegistryPath(): string {\n\t// __dirname is:\n\t//   src:  packages/ai/src/registry    (4 levels up = repo root)\n\t//   dist: packages/ai/dist/registry   (4 levels up = repo root)\n\t// Structure: .../registry -> .../src|dist -> packages/ai -> packages -> repo-root\n\tconst repoRoot = join(__dirname, \"..\", \"..\", \"..\", \"..\");\n\tconst repoPath = join(repoRoot, \"registry\", \"registry.json\");\n\tif (existsSync(repoPath)) return repoPath;\n\n\t// Secondary fallback: probe 3 levels up (edge case for flattened dist)\n\tconst altRoot = join(__dirname, \"..\", \"..\", \"..\");\n\treturn join(altRoot, \"..\", \"registry\", \"registry.json\");\n}\n\n// ---------------------------------------------------------------------------\n// Load result type\n// ---------------------------------------------------------------------------\n\nexport type LoadRegistrySource = \"user-override\" | \"cache\" | \"bundled\";\n\nexport type LoadRegistryResult =\n\t| { ok: true; registry: Registry; source: LoadRegistrySource }\n\t| { ok: false; error: string; tried: string[] };\n\n// ---------------------------------------------------------------------------\n// Core loader\n// ---------------------------------------------------------------------------\n\n/**\n * Load the active registry following the three-tier fallback chain.\n *\n * @param configDir  Override ~/.cave/agent base dir (useful in tests).\n */\nexport function loadRegistry(configDir?: string): LoadRegistryResult {\n\tconst candidates: Array<{ source: LoadRegistrySource; path: string }> = [\n\t\t{ source: \"user-override\", path: getUserOverridePath(configDir) },\n\t\t{ source: \"cache\", path: getCachePath(configDir) },\n\t\t{ source: \"bundled\", path: getBundledRegistryPath() },\n\t];\n\n\tconst tried: string[] = [];\n\n\tfor (const { source, path } of candidates) {\n\t\tif (!existsSync(path)) {\n\t\t\ttried.push(`${source}: ${path} (not found)`);\n\t\t\tcontinue;\n\t\t}\n\n\t\tlet raw: unknown;\n\t\ttry {\n\t\t\traw = JSON.parse(readFileSync(path, \"utf-8\"));\n\t\t} catch (err) {\n\t\t\ttried.push(`${source}: ${path} (parse error: ${err instanceof Error ? err.message : String(err)})`);\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst result = validateRegistry(raw);\n\t\tif (!result.ok) {\n\t\t\ttried.push(`${source}: ${path} (invalid: ${result.errors.join(\"; \")})`);\n\t\t\tcontinue;\n\t\t}\n\n\t\treturn { ok: true, registry: result.registry, source };\n\t}\n\n\treturn {\n\t\tok: false,\n\t\terror: \"No valid registry found in any location\",\n\t\ttried,\n\t};\n}\n"]}

package/dist/registry/loader.js

@@ -0,0 +1,90 @@
+/**
+ * WS15: Registry loader — three-tier fallback chain.
+ *
+ * Resolution order (first readable + valid wins):
+ *   1. ~/.cave/agent/registry.json      (user override)
+ *   2. ~/.cave/agent/registry-cache.json (fetched cache)
+ *   3. <package>/registry/registry.json  (bundled fallback)
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { validateRegistry } from "./schema.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+/** User override path: ~/.cave/agent/registry.json */
+export function getUserOverridePath(configDir) {
+    const base = configDir ?? join(homedir(), ".cave", "agent");
+    return join(base, "registry.json");
+}
+/** Fetched cache path: ~/.cave/agent/registry-cache.json */
+export function getCachePath(configDir) {
+    const base = configDir ?? join(homedir(), ".cave", "agent");
+    return join(base, "registry-cache.json");
+}
+/**
+ * Bundled fallback path: <package-root>/registry/registry.json
+ *
+ * Works from both src/ (ts-node / tsx) and dist/ (compiled) since the
+ * registry/ dir lives at the package root, one or two levels up from
+ * src/registry/ or dist/registry/.
+ */
+export function getBundledRegistryPath() {
+    // __dirname is:
+    //   src:  packages/ai/src/registry    (4 levels up = repo root)
+    //   dist: packages/ai/dist/registry   (4 levels up = repo root)
+    // Structure: .../registry -> .../src|dist -> packages/ai -> packages -> repo-root
+    const repoRoot = join(__dirname, "..", "..", "..", "..");
+    const repoPath = join(repoRoot, "registry", "registry.json");
+    if (existsSync(repoPath))
+        return repoPath;
+    // Secondary fallback: probe 3 levels up (edge case for flattened dist)
+    const altRoot = join(__dirname, "..", "..", "..");
+    return join(altRoot, "..", "registry", "registry.json");
+}
+// ---------------------------------------------------------------------------
+// Core loader
+// ---------------------------------------------------------------------------
+/**
+ * Load the active registry following the three-tier fallback chain.
+ *
+ * @param configDir  Override ~/.cave/agent base dir (useful in tests).
+ */
+export function loadRegistry(configDir) {
+    const candidates = [
+        { source: "user-override", path: getUserOverridePath(configDir) },
+        { source: "cache", path: getCachePath(configDir) },
+        { source: "bundled", path: getBundledRegistryPath() },
+    ];
+    const tried = [];
+    for (const { source, path } of candidates) {
+        if (!existsSync(path)) {
+            tried.push(`${source}: ${path} (not found)`);
+            continue;
+        }
+        let raw;
+        try {
+            raw = JSON.parse(readFileSync(path, "utf-8"));
+        }
+        catch (err) {
+            tried.push(`${source}: ${path} (parse error: ${err instanceof Error ? err.message : String(err)})`);
+            continue;
+        }
+        const result = validateRegistry(raw);
+        if (!result.ok) {
+            tried.push(`${source}: ${path} (invalid: ${result.errors.join("; ")})`);
+            continue;
+        }
+        return { ok: true, registry: result.registry, source };
+    }
+    return {
+        ok: false,
+        error: "No valid registry found in any location",
+        tried,
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/registry/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/registry/loader.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * WS15: Registry loader — three-tier fallback chain.\n *\n * Resolution order (first readable + valid wins):\n *   1. ~/.cave/agent/registry.json      (user override)\n *   2. ~/.cave/agent/registry-cache.json (fetched cache)\n *   3. <package>/registry/registry.json  (bundled fallback)\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { type Registry, validateRegistry } from \"./schema.js\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n// ---------------------------------------------------------------------------\n// Path helpers\n// ---------------------------------------------------------------------------\n\n/** User override path: ~/.cave/agent/registry.json */\nexport function getUserOverridePath(configDir?: string): string {\n\tconst base = configDir ?? join(homedir(), \".cave\", \"agent\");\n\treturn join(base, \"registry.json\");\n}\n\n/** Fetched cache path: ~/.cave/agent/registry-cache.json */\nexport function getCachePath(configDir?: string): string {\n\tconst base = configDir ?? join(homedir(), \".cave\", \"agent\");\n\treturn join(base, \"registry-cache.json\");\n}\n\n/**\n * Bundled fallback path: <package-root>/registry/registry.json\n *\n * Works from both src/ (ts-node / tsx) and dist/ (compiled) since the\n * registry/ dir lives at the package root, one or two levels up from\n * src/registry/ or dist/registry/.\n */\nexport function getBundledRegistryPath(): string {\n\t// __dirname is:\n\t//   src:  packages/ai/src/registry    (4 levels up = repo root)\n\t//   dist: packages/ai/dist/registry   (4 levels up = repo root)\n\t// Structure: .../registry -> .../src|dist -> packages/ai -> packages -> repo-root\n\tconst repoRoot = join(__dirname, \"..\", \"..\", \"..\", \"..\");\n\tconst repoPath = join(repoRoot, \"registry\", \"registry.json\");\n\tif (existsSync(repoPath)) return repoPath;\n\n\t// Secondary fallback: probe 3 levels up (edge case for flattened dist)\n\tconst altRoot = join(__dirname, \"..\", \"..\", \"..\");\n\treturn join(altRoot, \"..\", \"registry\", \"registry.json\");\n}\n\n// ---------------------------------------------------------------------------\n// Load result type\n// ---------------------------------------------------------------------------\n\nexport type LoadRegistrySource = \"user-override\" | \"cache\" | \"bundled\";\n\nexport type LoadRegistryResult =\n\t| { ok: true; registry: Registry; source: LoadRegistrySource }\n\t| { ok: false; error: string; tried: string[] };\n\n// ---------------------------------------------------------------------------\n// Core loader\n// ---------------------------------------------------------------------------\n\n/**\n * Load the active registry following the three-tier fallback chain.\n *\n * @param configDir  Override ~/.cave/agent base dir (useful in tests).\n */\nexport function loadRegistry(configDir?: string): LoadRegistryResult {\n\tconst candidates: Array<{ source: LoadRegistrySource; path: string }> = [\n\t\t{ source: \"user-override\", path: getUserOverridePath(configDir) },\n\t\t{ source: \"cache\", path: getCachePath(configDir) },\n\t\t{ source: \"bundled\", path: getBundledRegistryPath() },\n\t];\n\n\tconst tried: string[] = [];\n\n\tfor (const { source, path } of candidates) {\n\t\tif (!existsSync(path)) {\n\t\t\ttried.push(`${source}: ${path} (not found)`);\n\t\t\tcontinue;\n\t\t}\n\n\t\tlet raw: unknown;\n\t\ttry {\n\t\t\traw = JSON.parse(readFileSync(path, \"utf-8\"));\n\t\t} catch (err) {\n\t\t\ttried.push(`${source}: ${path} (parse error: ${err instanceof Error ? err.message : String(err)})`);\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst result = validateRegistry(raw);\n\t\tif (!result.ok) {\n\t\t\ttried.push(`${source}: ${path} (invalid: ${result.errors.join(\"; \")})`);\n\t\t\tcontinue;\n\t\t}\n\n\t\treturn { ok: true, registry: result.registry, source };\n\t}\n\n\treturn {\n\t\tok: false,\n\t\terror: \"No valid registry found in any location\",\n\t\ttried,\n\t};\n}\n"]}

package/dist/registry/merger.d.ts

@@ -0,0 +1,21 @@
+/**
+ * WS15: Registry merger — convert RegistryProvider entries into the
+ * @zhachory1/mewrite-ai Model<Api> shape so they can be injected into ModelRegistry.
+ *
+ * Compatibility constraint: existing model-registry.ts consumers keep
+ * working. The merger produces models in the same shape as getModels()
+ * outputs — existing code paths are unchanged.
+ */
+import type { Api, Model } from "../types.js";
+import type { Registry, RegistryModel, RegistryProvider } from "./schema.js";
+/**
+ * Convert a single RegistryModel + its parent RegistryProvider into
+ * the Model<Api> shape used by @zhachory1/mewrite-ai's internal registry.
+ */
+export declare function registryModelToModel(provider: RegistryProvider, model: RegistryModel): Model<Api> | undefined;
+/**
+ * Convert all models from a Registry into Model<Api>[] entries.
+ * Unknown provider kinds are silently skipped.
+ */
+export declare function registryToModels(registry: Registry): Model<Api>[];
+//# sourceMappingURL=merger.d.ts.map

package/dist/registry/merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merger.d.ts","sourceRoot":"","sources":["../../src/registry/merger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AA0C7E;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAyB7G;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CASjE","sourcesContent":["/**\n * WS15: Registry merger — convert RegistryProvider entries into the\n * @zhachory1/mewrite-ai Model<Api> shape so they can be injected into ModelRegistry.\n *\n * Compatibility constraint: existing model-registry.ts consumers keep\n * working. The merger produces models in the same shape as getModels()\n * outputs — existing code paths are unchanged.\n */\n\nimport type { Api, Model } from \"../types.js\";\nimport type { Registry, RegistryModel, RegistryProvider } from \"./schema.js\";\n\n// ---------------------------------------------------------------------------\n// Kind → Api mapping\n// ---------------------------------------------------------------------------\n\n/** Map registry provider kinds to the @zhachory1/mewrite-ai Api string */\nfunction kindToApi(kind: RegistryProvider[\"kind\"]): Api | undefined {\n\tswitch (kind) {\n\t\tcase \"anthropic\":\n\t\t\treturn \"anthropic\";\n\t\tcase \"openai\":\n\t\t\treturn \"openai-responses\";\n\t\tcase \"google\":\n\t\t\treturn \"google\";\n\t\tcase \"openrouter\":\n\t\t\treturn \"openai-completions\";\n\t\tcase \"mistral\":\n\t\t\treturn \"openai-completions\";\n\t\tcase \"bedrock\":\n\t\t\treturn \"bedrock-converse-stream\";\n\t\tcase \"gemini-cli\":\n\t\t\treturn \"google\";\n\t\tcase \"vertex\":\n\t\t\treturn \"google-vertex\";\n\t\tcase \"xai\":\n\t\t\treturn \"openai-completions\";\n\t\tcase \"groq\":\n\t\t\treturn \"openai-completions\";\n\t\tcase \"cerebras\":\n\t\t\treturn \"openai-completions\";\n\t\tcase \"other\":\n\t\t\treturn \"openai-completions\";\n\t\tdefault:\n\t\t\treturn undefined;\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Converter\n// ---------------------------------------------------------------------------\n\n/**\n * Convert a single RegistryModel + its parent RegistryProvider into\n * the Model<Api> shape used by @zhachory1/mewrite-ai's internal registry.\n */\nexport function registryModelToModel(provider: RegistryProvider, model: RegistryModel): Model<Api> | undefined {\n\tconst api = kindToApi(provider.kind);\n\tif (!api) return undefined;\n\n\tconst caps = model.capabilities ?? [];\n\n\treturn {\n\t\tid: model.id,\n\t\tname: model.displayName,\n\t\tapi,\n\t\tprovider: provider.id,\n\t\tbaseUrl: provider.baseUrl ?? \"\",\n\t\treasoning: caps.includes(\"reasoning\"),\n\t\tinput: caps.includes(\"vision\") ? [\"text\", \"image\"] : [\"text\"],\n\t\tcost: {\n\t\t\tinput: model.inputCostPerMtok ?? 0,\n\t\t\toutput: model.outputCostPerMtok ?? 0,\n\t\t\tcacheRead: 0,\n\t\t\tcacheWrite: 0,\n\t\t},\n\t\tcontextWindow: model.contextWindow,\n\t\tmaxTokens: model.maxOutputTokens ?? 16384,\n\t\theaders: undefined,\n\t\tcompat: undefined,\n\t} as Model<Api>;\n}\n\n/**\n * Convert all models from a Registry into Model<Api>[] entries.\n * Unknown provider kinds are silently skipped.\n */\nexport function registryToModels(registry: Registry): Model<Api>[] {\n\tconst result: Model<Api>[] = [];\n\tfor (const provider of registry.providers) {\n\t\tfor (const model of provider.models) {\n\t\t\tconst m = registryModelToModel(provider, model);\n\t\t\tif (m) result.push(m);\n\t\t}\n\t}\n\treturn result;\n}\n"]}