@ashx-j/lunr 0.1.0

package/dist/core/messages.js

@@ -0,0 +1,123 @@
+/**
+ * Custom message types and transformers for the coding agent.
+ *
+ * Extends the base AgentMessage type with coding-agent specific message types,
+ * and provides a transformer to convert them to LLM-compatible messages.
+ */
+export const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:
+
+<summary>
+`;
+export const COMPACTION_SUMMARY_SUFFIX = `
+</summary>`;
+export const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:
+
+<summary>
+`;
+export const BRANCH_SUMMARY_SUFFIX = `</summary>`;
+/**
+ * Convert a BashExecutionMessage to user message text for LLM context.
+ */
+export function bashExecutionToText(msg) {
+    let text = `Ran \`${msg.command}\`\n`;
+    if (msg.output) {
+        text += `\`\`\`\n${msg.output}\n\`\`\``;
+    }
+    else {
+        text += "(no output)";
+    }
+    if (msg.cancelled) {
+        text += "\n\n(command cancelled)";
+    }
+    else if (msg.exitCode !== null && msg.exitCode !== undefined && msg.exitCode !== 0) {
+        text += `\n\nCommand exited with code ${msg.exitCode}`;
+    }
+    if (msg.truncated && msg.fullOutputPath) {
+        text += `\n\n[Output truncated. Full output: ${msg.fullOutputPath}]`;
+    }
+    return text;
+}
+export function createBranchSummaryMessage(summary, fromId, timestamp) {
+    return {
+        role: "branchSummary",
+        summary,
+        fromId,
+        timestamp: new Date(timestamp).getTime(),
+    };
+}
+export function createCompactionSummaryMessage(summary, tokensBefore, timestamp) {
+    return {
+        role: "compactionSummary",
+        summary: summary,
+        tokensBefore,
+        timestamp: new Date(timestamp).getTime(),
+    };
+}
+/** Convert CustomMessageEntry to AgentMessage format */
+export function createCustomMessage(customType, content, display, details, timestamp) {
+    return {
+        role: "custom",
+        customType,
+        content,
+        display,
+        details,
+        timestamp: new Date(timestamp).getTime(),
+    };
+}
+/**
+ * Transform AgentMessages (including custom types) to LLM-compatible Messages.
+ *
+ * This is used by:
+ * - Agent's transormToLlm option (for prompt calls and queued messages)
+ * - Compaction's generateSummary (for summarization)
+ * - Custom extensions and tools
+ */
+export function convertToLlm(messages) {
+    return messages
+        .map((m) => {
+        switch (m.role) {
+            case "bashExecution":
+                // Skip messages excluded from context (!! prefix)
+                if (m.excludeFromContext) {
+                    return undefined;
+                }
+                return {
+                    role: "user",
+                    content: [{ type: "text", text: bashExecutionToText(m) }],
+                    timestamp: m.timestamp,
+                };
+            case "custom": {
+                const content = typeof m.content === "string" ? [{ type: "text", text: m.content }] : m.content;
+                return {
+                    role: "user",
+                    content,
+                    timestamp: m.timestamp,
+                };
+            }
+            case "branchSummary":
+                return {
+                    role: "user",
+                    content: [{ type: "text", text: BRANCH_SUMMARY_PREFIX + m.summary + BRANCH_SUMMARY_SUFFIX }],
+                    timestamp: m.timestamp,
+                };
+            case "compactionSummary":
+                return {
+                    role: "user",
+                    content: [
+                        { type: "text", text: COMPACTION_SUMMARY_PREFIX + m.summary + COMPACTION_SUMMARY_SUFFIX },
+                    ],
+                    timestamp: m.timestamp,
+                };
+            case "user":
+            case "assistant":
+            case "toolResult":
+                return m;
+            default:
+                // biome-ignore lint/correctness/noSwitchDeclarations: fine
+                const _exhaustiveCheck = m;
+                return undefined;
+        }
+    })
+        .filter((m) => m !== undefined);
+}
+//# sourceMappingURL=messages.js.map

package/dist/core/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/core/messages.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Custom message types and transformers for the coding agent.\n *\n * Extends the base AgentMessage type with coding-agent specific message types,\n * and provides a transformer to convert them to LLM-compatible messages.\n */\n\nimport type { AgentMessage } from \"@earendil-works/pi-agent-core\";\nimport type { ImageContent, Message, TextContent } from \"@earendil-works/pi-ai\";\n\nexport const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:\n\n<summary>\n`;\n\nexport const COMPACTION_SUMMARY_SUFFIX = `\n</summary>`;\n\nexport const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:\n\n<summary>\n`;\n\nexport const BRANCH_SUMMARY_SUFFIX = `</summary>`;\n\n/**\n * Message type for bash executions via the ! command.\n */\nexport interface BashExecutionMessage {\n\trole: \"bashExecution\";\n\tcommand: string;\n\toutput: string;\n\texitCode: number | undefined;\n\tcancelled: boolean;\n\ttruncated: boolean;\n\tfullOutputPath?: string;\n\ttimestamp: number;\n\t/** If true, this message is excluded from LLM context (!! prefix) */\n\texcludeFromContext?: boolean;\n}\n\n/**\n * Message type for extension-injected messages via sendMessage().\n * These are custom messages that extensions can inject into the conversation.\n */\nexport interface CustomMessage<T = unknown> {\n\trole: \"custom\";\n\tcustomType: string;\n\tcontent: string | (TextContent | ImageContent)[];\n\tdisplay: boolean;\n\tdetails?: T;\n\ttimestamp: number;\n}\n\nexport interface BranchSummaryMessage {\n\trole: \"branchSummary\";\n\tsummary: string;\n\tfromId: string;\n\ttimestamp: number;\n}\n\nexport interface CompactionSummaryMessage {\n\trole: \"compactionSummary\";\n\tsummary: string;\n\ttokensBefore: number;\n\ttimestamp: number;\n}\n\n// Extend CustomAgentMessages via declaration merging\ndeclare module \"@earendil-works/pi-agent-core\" {\n\tinterface CustomAgentMessages {\n\t\tbashExecution: BashExecutionMessage;\n\t\tcustom: CustomMessage;\n\t\tbranchSummary: BranchSummaryMessage;\n\t\tcompactionSummary: CompactionSummaryMessage;\n\t}\n}\n\n/**\n * Convert a BashExecutionMessage to user message text for LLM context.\n */\nexport function bashExecutionToText(msg: BashExecutionMessage): string {\n\tlet text = `Ran \\`${msg.command}\\`\\n`;\n\tif (msg.output) {\n\t\ttext += `\\`\\`\\`\\n${msg.output}\\n\\`\\`\\``;\n\t} else {\n\t\ttext += \"(no output)\";\n\t}\n\tif (msg.cancelled) {\n\t\ttext += \"\\n\\n(command cancelled)\";\n\t} else if (msg.exitCode !== null && msg.exitCode !== undefined && msg.exitCode !== 0) {\n\t\ttext += `\\n\\nCommand exited with code ${msg.exitCode}`;\n\t}\n\tif (msg.truncated && msg.fullOutputPath) {\n\t\ttext += `\\n\\n[Output truncated. Full output: ${msg.fullOutputPath}]`;\n\t}\n\treturn text;\n}\n\nexport function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage {\n\treturn {\n\t\trole: \"branchSummary\",\n\t\tsummary,\n\t\tfromId,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\nexport function createCompactionSummaryMessage(\n\tsummary: string,\n\ttokensBefore: number,\n\ttimestamp: string,\n): CompactionSummaryMessage {\n\treturn {\n\t\trole: \"compactionSummary\",\n\t\tsummary: summary,\n\t\ttokensBefore,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/** Convert CustomMessageEntry to AgentMessage format */\nexport function createCustomMessage(\n\tcustomType: string,\n\tcontent: string | (TextContent | ImageContent)[],\n\tdisplay: boolean,\n\tdetails: unknown | undefined,\n\ttimestamp: string,\n): CustomMessage {\n\treturn {\n\t\trole: \"custom\",\n\t\tcustomType,\n\t\tcontent,\n\t\tdisplay,\n\t\tdetails,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/**\n * Transform AgentMessages (including custom types) to LLM-compatible Messages.\n *\n * This is used by:\n * - Agent's transormToLlm option (for prompt calls and queued messages)\n * - Compaction's generateSummary (for summarization)\n * - Custom extensions and tools\n */\nexport function convertToLlm(messages: AgentMessage[]): Message[] {\n\treturn messages\n\t\t.map((m): Message | undefined => {\n\t\t\tswitch (m.role) {\n\t\t\t\tcase \"bashExecution\":\n\t\t\t\t\t// Skip messages excluded from context (!! prefix)\n\t\t\t\t\tif (m.excludeFromContext) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: bashExecutionToText(m) }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"custom\": {\n\t\t\t\t\tconst content = typeof m.content === \"string\" ? [{ type: \"text\" as const, text: m.content }] : m.content;\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent,\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tcase \"branchSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\" as const, text: BRANCH_SUMMARY_PREFIX + m.summary + BRANCH_SUMMARY_SUFFIX }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"compactionSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{ type: \"text\" as const, text: COMPACTION_SUMMARY_PREFIX + m.summary + COMPACTION_SUMMARY_SUFFIX },\n\t\t\t\t\t\t],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"user\":\n\t\t\t\tcase \"assistant\":\n\t\t\t\tcase \"toolResult\":\n\t\t\t\t\treturn m;\n\t\t\t\tdefault:\n\t\t\t\t\t// biome-ignore lint/correctness/noSwitchDeclarations: fine\n\t\t\t\t\tconst _exhaustiveCheck: never = m;\n\t\t\t\t\treturn undefined;\n\t\t\t}\n\t\t})\n\t\t.filter((m) => m !== undefined);\n}\n"]}

package/dist/core/model-config-writer.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Mutable writer for models.json. ModelConfig (model-config.ts) is an immutable,
+ * credential-blind snapshot; this module is the only write path and never silently
+ * drops an existing file it cannot parse.
+ */
+import type { ModelsJsonProvider } from "./model-config.ts";
+/**
+ * Derive a provider id from a display name: lowercase, non-alphanumeric runs
+ * collapse to "-", trimmed. Falls back to "custom" when nothing alphanumeric
+ * remains, and dedups against existing ids with "-2", "-3", …
+ */
+export declare function slugifyProviderId(name: string, existingIds: readonly string[]): string;
+/** Custom endpoints must be absolute http(s) URLs. */
+export declare function isValidProviderBaseUrl(value: string): boolean;
+/** Parse a comma-separated model id list: trims entries, drops empties, dedups. */
+export declare function parseModelIds(input: string): string[];
+/**
+ * Insert or replace one provider in models.json, preserving every other provider
+ * (and object key order). A missing file starts from `{ providers: {} }`; a file
+ * that exists but does not parse or has the wrong shape throws — the user's
+ * existing configuration is never overwritten on a read failure.
+ */
+export declare function upsertCustomProvider(modelsJsonPath: string, providerId: string, providerConfig: ModelsJsonProvider): Promise<void>;
+//# sourceMappingURL=model-config-writer.d.ts.map

package/dist/core/model-config-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-config-writer.d.ts","sourceRoot":"","sources":["../../src/core/model-config-writer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAI5D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAWtF;AAED,sDAAsD;AACtD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAOrD;AAMD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACzC,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,kBAAkB,GAChC,OAAO,CAAC,IAAI,CAAC,CAqCf","sourcesContent":["/**\n * Mutable writer for models.json. ModelConfig (model-config.ts) is an immutable,\n * credential-blind snapshot; this module is the only write path and never silently\n * drops an existing file it cannot parse.\n */\n\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { dirname } from \"node:path\";\nimport { stripJsonComments } from \"../utils/json.ts\";\nimport { normalizePath } from \"../utils/paths.ts\";\nimport type { ModelsJsonProvider } from \"./model-config.ts\";\n\ntype ModelsJsonDocument = { providers: Record<string, ModelsJsonProvider> };\n\n/**\n * Derive a provider id from a display name: lowercase, non-alphanumeric runs\n * collapse to \"-\", trimmed. Falls back to \"custom\" when nothing alphanumeric\n * remains, and dedups against existing ids with \"-2\", \"-3\", …\n */\nexport function slugifyProviderId(name: string, existingIds: readonly string[]): string {\n\tconst base = name\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"-\")\n\t\t.replace(/^-+|-+$/g, \"\");\n\tconst stem = base || \"custom\";\n\tif (!existingIds.includes(stem)) return stem;\n\tfor (let suffix = 2; ; suffix++) {\n\t\tconst candidate = `${stem}-${suffix}`;\n\t\tif (!existingIds.includes(candidate)) return candidate;\n\t}\n}\n\n/** Custom endpoints must be absolute http(s) URLs. */\nexport function isValidProviderBaseUrl(value: string): boolean {\n\treturn /^https?:\\/\\/\\S+$/u.test(value.trim());\n}\n\n/** Parse a comma-separated model id list: trims entries, drops empties, dedups. */\nexport function parseModelIds(input: string): string[] {\n\tconst seen = new Set<string>();\n\tfor (const entry of input.split(\",\")) {\n\t\tconst id = entry.trim();\n\t\tif (id) seen.add(id);\n\t}\n\treturn [...seen];\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Insert or replace one provider in models.json, preserving every other provider\n * (and object key order). A missing file starts from `{ providers: {} }`; a file\n * that exists but does not parse or has the wrong shape throws — the user's\n * existing configuration is never overwritten on a read failure.\n */\nexport async function upsertCustomProvider(\n\tmodelsJsonPath: string,\n\tproviderId: string,\n\tproviderConfig: ModelsJsonProvider,\n): Promise<void> {\n\tconst path = normalizePath(modelsJsonPath);\n\tlet document: ModelsJsonDocument;\n\n\tlet content: string | undefined;\n\ttry {\n\t\tcontent = await readFile(path, \"utf-8\");\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code !== \"ENOENT\") {\n\t\t\tthrow new Error(\n\t\t\t\t`Cannot update models.json: ${error instanceof Error ? error.message : error}\\n\\nFile: ${path}`,\n\t\t\t);\n\t\t}\n\t}\n\n\tif (content === undefined) {\n\t\tdocument = { providers: {} };\n\t} else {\n\t\tlet parsed: unknown;\n\t\ttry {\n\t\t\tparsed = JSON.parse(stripJsonComments(content));\n\t\t} catch (error) {\n\t\t\tthrow new Error(\n\t\t\t\t`Cannot update models.json: the existing file is not valid JSON (${error instanceof Error ? error.message : error}). Fix or remove it and try again.\\n\\nFile: ${path}`,\n\t\t\t);\n\t\t}\n\t\tif (!isRecord(parsed) || !isRecord(parsed.providers)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Cannot update models.json: the existing file must be an object with a \"providers\" record. Fix or remove it and try again.\\n\\nFile: ${path}`,\n\t\t\t);\n\t\t}\n\t\tdocument = parsed as ModelsJsonDocument;\n\t}\n\n\tdocument.providers[providerId] = providerConfig;\n\tawait mkdir(dirname(path), { recursive: true });\n\tawait writeFile(path, `${JSON.stringify(document, null, 2)}\\n`, \"utf-8\");\n}\n"]}

package/dist/core/model-config-writer.js

@@ -0,0 +1,84 @@
+/**
+ * Mutable writer for models.json. ModelConfig (model-config.ts) is an immutable,
+ * credential-blind snapshot; this module is the only write path and never silently
+ * drops an existing file it cannot parse.
+ */
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { stripJsonComments } from "../utils/json.js";
+import { normalizePath } from "../utils/paths.js";
+/**
+ * Derive a provider id from a display name: lowercase, non-alphanumeric runs
+ * collapse to "-", trimmed. Falls back to "custom" when nothing alphanumeric
+ * remains, and dedups against existing ids with "-2", "-3", …
+ */
+export function slugifyProviderId(name, existingIds) {
+    const base = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    const stem = base || "custom";
+    if (!existingIds.includes(stem))
+        return stem;
+    for (let suffix = 2;; suffix++) {
+        const candidate = `${stem}-${suffix}`;
+        if (!existingIds.includes(candidate))
+            return candidate;
+    }
+}
+/** Custom endpoints must be absolute http(s) URLs. */
+export function isValidProviderBaseUrl(value) {
+    return /^https?:\/\/\S+$/u.test(value.trim());
+}
+/** Parse a comma-separated model id list: trims entries, drops empties, dedups. */
+export function parseModelIds(input) {
+    const seen = new Set();
+    for (const entry of input.split(",")) {
+        const id = entry.trim();
+        if (id)
+            seen.add(id);
+    }
+    return [...seen];
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Insert or replace one provider in models.json, preserving every other provider
+ * (and object key order). A missing file starts from `{ providers: {} }`; a file
+ * that exists but does not parse or has the wrong shape throws — the user's
+ * existing configuration is never overwritten on a read failure.
+ */
+export async function upsertCustomProvider(modelsJsonPath, providerId, providerConfig) {
+    const path = normalizePath(modelsJsonPath);
+    let document;
+    let content;
+    try {
+        content = await readFile(path, "utf-8");
+    }
+    catch (error) {
+        if (error.code !== "ENOENT") {
+            throw new Error(`Cannot update models.json: ${error instanceof Error ? error.message : error}\n\nFile: ${path}`);
+        }
+    }
+    if (content === undefined) {
+        document = { providers: {} };
+    }
+    else {
+        let parsed;
+        try {
+            parsed = JSON.parse(stripJsonComments(content));
+        }
+        catch (error) {
+            throw new Error(`Cannot update models.json: the existing file is not valid JSON (${error instanceof Error ? error.message : error}). Fix or remove it and try again.\n\nFile: ${path}`);
+        }
+        if (!isRecord(parsed) || !isRecord(parsed.providers)) {
+            throw new Error(`Cannot update models.json: the existing file must be an object with a "providers" record. Fix or remove it and try again.\n\nFile: ${path}`);
+        }
+        document = parsed;
+    }
+    document.providers[providerId] = providerConfig;
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, `${JSON.stringify(document, null, 2)}\n`, "utf-8");
+}
+//# sourceMappingURL=model-config-writer.js.map

package/dist/core/model-config-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-config-writer.js","sourceRoot":"","sources":["../../src/core/model-config-writer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Mutable writer for models.json. ModelConfig (model-config.ts) is an immutable,\n * credential-blind snapshot; this module is the only write path and never silently\n * drops an existing file it cannot parse.\n */\n\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { dirname } from \"node:path\";\nimport { stripJsonComments } from \"../utils/json.ts\";\nimport { normalizePath } from \"../utils/paths.ts\";\nimport type { ModelsJsonProvider } from \"./model-config.ts\";\n\ntype ModelsJsonDocument = { providers: Record<string, ModelsJsonProvider> };\n\n/**\n * Derive a provider id from a display name: lowercase, non-alphanumeric runs\n * collapse to \"-\", trimmed. Falls back to \"custom\" when nothing alphanumeric\n * remains, and dedups against existing ids with \"-2\", \"-3\", …\n */\nexport function slugifyProviderId(name: string, existingIds: readonly string[]): string {\n\tconst base = name\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"-\")\n\t\t.replace(/^-+|-+$/g, \"\");\n\tconst stem = base || \"custom\";\n\tif (!existingIds.includes(stem)) return stem;\n\tfor (let suffix = 2; ; suffix++) {\n\t\tconst candidate = `${stem}-${suffix}`;\n\t\tif (!existingIds.includes(candidate)) return candidate;\n\t}\n}\n\n/** Custom endpoints must be absolute http(s) URLs. */\nexport function isValidProviderBaseUrl(value: string): boolean {\n\treturn /^https?:\\/\\/\\S+$/u.test(value.trim());\n}\n\n/** Parse a comma-separated model id list: trims entries, drops empties, dedups. */\nexport function parseModelIds(input: string): string[] {\n\tconst seen = new Set<string>();\n\tfor (const entry of input.split(\",\")) {\n\t\tconst id = entry.trim();\n\t\tif (id) seen.add(id);\n\t}\n\treturn [...seen];\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Insert or replace one provider in models.json, preserving every other provider\n * (and object key order). A missing file starts from `{ providers: {} }`; a file\n * that exists but does not parse or has the wrong shape throws — the user's\n * existing configuration is never overwritten on a read failure.\n */\nexport async function upsertCustomProvider(\n\tmodelsJsonPath: string,\n\tproviderId: string,\n\tproviderConfig: ModelsJsonProvider,\n): Promise<void> {\n\tconst path = normalizePath(modelsJsonPath);\n\tlet document: ModelsJsonDocument;\n\n\tlet content: string | undefined;\n\ttry {\n\t\tcontent = await readFile(path, \"utf-8\");\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code !== \"ENOENT\") {\n\t\t\tthrow new Error(\n\t\t\t\t`Cannot update models.json: ${error instanceof Error ? error.message : error}\\n\\nFile: ${path}`,\n\t\t\t);\n\t\t}\n\t}\n\n\tif (content === undefined) {\n\t\tdocument = { providers: {} };\n\t} else {\n\t\tlet parsed: unknown;\n\t\ttry {\n\t\t\tparsed = JSON.parse(stripJsonComments(content));\n\t\t} catch (error) {\n\t\t\tthrow new Error(\n\t\t\t\t`Cannot update models.json: the existing file is not valid JSON (${error instanceof Error ? error.message : error}). Fix or remove it and try again.\\n\\nFile: ${path}`,\n\t\t\t);\n\t\t}\n\t\tif (!isRecord(parsed) || !isRecord(parsed.providers)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Cannot update models.json: the existing file must be an object with a \"providers\" record. Fix or remove it and try again.\\n\\nFile: ${path}`,\n\t\t\t);\n\t\t}\n\t\tdocument = parsed as ModelsJsonDocument;\n\t}\n\n\tdocument.providers[providerId] = providerConfig;\n\tawait mkdir(dirname(path), { recursive: true });\n\tawait writeFile(path, `${JSON.stringify(document, null, 2)}\\n`, \"utf-8\");\n}\n"]}