@di-code/coding-agent 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,26 @@
+export type OutputMode = "print" | "json" | "interactive";
+export type CliCommand = {
+    kind: "help";
+} | {
+    kind: "version";
+} | {
+    kind: "run";
+    mode: OutputMode;
+    prompt: string;
+    sessionPath?: string;
+    continueSession?: true;
+};
+export declare class CliUsageError extends Error {
+    constructor(message: string);
+}
+export declare function parseCliArgs(args: readonly string[]): CliCommand;
+export interface CliDependencies {
+    stdout(text: string): void;
+    stderr(text: string): void;
+    run(command: Extract<CliCommand, {
+        kind: "run";
+    }>): Promise<number>;
+    readonly version: string;
+}
+export declare function runCli(args: readonly string[], dependencies: CliDependencies): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,aAAa,CAAC;AAE1D,MAAM,MAAM,UAAU,GACnB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnG,qBAAa,aAAc,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI3B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CA+EhE;AAcD,MAAM,WAAW,eAAe;IAC/B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE;QAAE,IAAI,EAAE,KAAK,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,YAAY,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBpG"}

package/dist/cli.js

@@ -0,0 +1,117 @@
+export class CliUsageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "CliUsageError";
+    }
+}
+export function parseCliArgs(args) {
+    const staticOption = args.find((argument) => ["-h", "--help", "-v", "--version"].includes(argument));
+    if (staticOption !== undefined) {
+        const kind = staticOption === "-h" || staticOption === "--help" ? "help" : "version";
+        if (args.length !== 1) {
+            throw new CliUsageError(`--${kind} must be used on its own.`);
+        }
+        return { kind };
+    }
+    let mode = "print";
+    let printAlias = false;
+    let sessionPath;
+    let continueSession = false;
+    const promptParts = [];
+    for (let index = 0; index < args.length; index++) {
+        const argument = args[index];
+        if (argument === "-p" || argument === "--print") {
+            printAlias = true;
+            continue;
+        }
+        if (argument === "--interactive") {
+            mode = "interactive";
+            continue;
+        }
+        if (argument === "-c" || argument === "--continue") {
+            continueSession = true;
+            continue;
+        }
+        if (argument === "--mode") {
+            const value = args[index + 1];
+            if (value === undefined) {
+                throw new CliUsageError("Option --mode requires a value.");
+            }
+            if (value !== "print" && value !== "json" && value !== "interactive") {
+                throw new CliUsageError(`Unsupported mode "${value}". Expected print, json, or interactive.`);
+            }
+            mode = value;
+            index++;
+            continue;
+        }
+        if (argument === "--session") {
+            const value = args[index + 1];
+            if (value === undefined) {
+                throw new CliUsageError("Option --session requires a value.");
+            }
+            if (value.trim().length === 0) {
+                throw new CliUsageError("Option --session requires a non-empty value.");
+            }
+            sessionPath = value;
+            index++;
+            continue;
+        }
+        if (argument?.startsWith("-")) {
+            throw new CliUsageError(`Unknown option "${argument}".`);
+        }
+        if (argument !== undefined) {
+            promptParts.push(argument);
+        }
+    }
+    if (printAlias && mode !== "print") {
+        throw new CliUsageError(`Cannot combine --print with --mode ${mode}.`);
+    }
+    if (continueSession && sessionPath !== undefined) {
+        throw new CliUsageError("Cannot combine --continue with --session.");
+    }
+    if (promptParts.length === 0 && mode !== "interactive") {
+        throw new CliUsageError("A prompt is required.");
+    }
+    return {
+        kind: "run",
+        mode,
+        prompt: promptParts.join(" "),
+        ...(sessionPath ? { sessionPath } : {}),
+        ...(continueSession ? { continueSession: true } : {}),
+    };
+}
+const HELP_TEXT = `Usage: di-code [options] <prompt>
+
+Options:
+  -p, --print        Print only the final assistant text (default)
+  --mode <mode>      Output mode: print, json, or interactive
+  --interactive      Start interactive terminal mode
+  --continue, -c     Continue the most recently modified session
+  --session <path>   Create or resume a JSONL session (relative to the work root)
+  -h, --help         Show help
+  -v, --version      Show version
+`;
+export async function runCli(args, dependencies) {
+    let command;
+    try {
+        command = parseCliArgs(args);
+    }
+    catch (cause) {
+        if (cause instanceof CliUsageError) {
+            dependencies.stderr(`${cause.message}\n`);
+            return 1;
+        }
+        throw cause;
+    }
+    switch (command.kind) {
+        case "help":
+            dependencies.stdout(HELP_TEXT);
+            return 0;
+        case "version":
+            dependencies.stdout(`${dependencies.version}\n`);
+            return 0;
+        case "run":
+            return dependencies.run(command);
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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","sourcesContent":["export type OutputMode = \"print\" | \"json\" | \"interactive\";\n\nexport type CliCommand =\n\t| { kind: \"help\" }\n\t| { kind: \"version\" }\n\t| { kind: \"run\"; mode: OutputMode; prompt: string; sessionPath?: string; continueSession?: true };\n\nexport class CliUsageError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"CliUsageError\";\n\t}\n}\n\nexport function parseCliArgs(args: readonly string[]): CliCommand {\n\tconst staticOption = args.find((argument) => [\"-h\", \"--help\", \"-v\", \"--version\"].includes(argument));\n\tif (staticOption !== undefined) {\n\t\tconst kind = staticOption === \"-h\" || staticOption === \"--help\" ? \"help\" : \"version\";\n\t\tif (args.length !== 1) {\n\t\t\tthrow new CliUsageError(`--${kind} must be used on its own.`);\n\t\t}\n\t\treturn { kind };\n\t}\n\n\tlet mode: OutputMode = \"print\";\n\tlet printAlias = false;\n\tlet sessionPath: string | undefined;\n\tlet continueSession = false;\n\tconst promptParts: string[] = [];\n\n\tfor (let index = 0; index < args.length; index++) {\n\t\tconst argument = args[index];\n\t\tif (argument === \"-p\" || argument === \"--print\") {\n\t\t\tprintAlias = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (argument === \"--interactive\") {\n\t\t\tmode = \"interactive\";\n\t\t\tcontinue;\n\t\t}\n\t\tif (argument === \"-c\" || argument === \"--continue\") {\n\t\t\tcontinueSession = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (argument === \"--mode\") {\n\t\t\tconst value = args[index + 1];\n\t\t\tif (value === undefined) {\n\t\t\t\tthrow new CliUsageError(\"Option --mode requires a value.\");\n\t\t\t}\n\t\t\tif (value !== \"print\" && value !== \"json\" && value !== \"interactive\") {\n\t\t\t\tthrow new CliUsageError(`Unsupported mode \"${value}\". Expected print, json, or interactive.`);\n\t\t\t}\n\t\t\tmode = value;\n\t\t\tindex++;\n\t\t\tcontinue;\n\t\t}\n\t\tif (argument === \"--session\") {\n\t\t\tconst value = args[index + 1];\n\t\t\tif (value === undefined) {\n\t\t\t\tthrow new CliUsageError(\"Option --session requires a value.\");\n\t\t\t}\n\t\t\tif (value.trim().length === 0) {\n\t\t\t\tthrow new CliUsageError(\"Option --session requires a non-empty value.\");\n\t\t\t}\n\t\t\tsessionPath = value;\n\t\t\tindex++;\n\t\t\tcontinue;\n\t\t}\n\t\tif (argument?.startsWith(\"-\")) {\n\t\t\tthrow new CliUsageError(`Unknown option \"${argument}\".`);\n\t\t}\n\t\tif (argument !== undefined) {\n\t\t\tpromptParts.push(argument);\n\t\t}\n\t}\n\n\tif (printAlias && mode !== \"print\") {\n\t\tthrow new CliUsageError(`Cannot combine --print with --mode ${mode}.`);\n\t}\n\tif (continueSession && sessionPath !== undefined) {\n\t\tthrow new CliUsageError(\"Cannot combine --continue with --session.\");\n\t}\n\tif (promptParts.length === 0 && mode !== \"interactive\") {\n\t\tthrow new CliUsageError(\"A prompt is required.\");\n\t}\n\n\treturn {\n\t\tkind: \"run\",\n\t\tmode,\n\t\tprompt: promptParts.join(\" \"),\n\t\t...(sessionPath ? { sessionPath } : {}),\n\t\t...(continueSession ? { continueSession: true as const } : {}),\n\t};\n}\n\nconst HELP_TEXT = `Usage: di-code [options] <prompt>\n\nOptions:\n  -p, --print        Print only the final assistant text (default)\n  --mode <mode>      Output mode: print, json, or interactive\n  --interactive      Start interactive terminal mode\n  --continue, -c     Continue the most recently modified session\n  --session <path>   Create or resume a JSONL session (relative to the work root)\n  -h, --help         Show help\n  -v, --version      Show version\n`;\n\nexport interface CliDependencies {\n\tstdout(text: string): void;\n\tstderr(text: string): void;\n\trun(command: Extract<CliCommand, { kind: \"run\" }>): Promise<number>;\n\treadonly version: string;\n}\n\nexport async function runCli(args: readonly string[], dependencies: CliDependencies): Promise<number> {\n\tlet command: CliCommand;\n\ttry {\n\t\tcommand = parseCliArgs(args);\n\t} catch (cause) {\n\t\tif (cause instanceof CliUsageError) {\n\t\t\tdependencies.stderr(`${cause.message}\\n`);\n\t\t\treturn 1;\n\t\t}\n\t\tthrow cause;\n\t}\n\n\tswitch (command.kind) {\n\t\tcase \"help\":\n\t\t\tdependencies.stdout(HELP_TEXT);\n\t\t\treturn 0;\n\t\tcase \"version\":\n\t\t\tdependencies.stdout(`${dependencies.version}\\n`);\n\t\t\treturn 0;\n\t\tcase \"run\":\n\t\t\treturn dependencies.run(command);\n\t}\n}\n"]}

package/dist/config/models-loader.d.ts

@@ -0,0 +1,4 @@
+import type { ModelsDocument } from "./models-types.ts";
+export declare function loadModelsDocument(path: string): Promise<ModelsDocument>;
+export declare function loadModelsDocuments(paths: readonly string[]): Promise<ModelsDocument>;
+//# sourceMappingURL=models-loader.d.ts.map

package/dist/config/models-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models-loader.d.ts","sourceRoot":"","sources":["../../src/config/models-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA8FxH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAsB9E;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAiB3F"}

package/dist/config/models-loader.js

@@ -0,0 +1,134 @@
+import { readFile } from "node:fs/promises";
+const APIS = new Set(["openai-responses", "anthropic-messages"]);
+const ENV_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function validateUrl(value, path) {
+    if (typeof value !== "string")
+        throw new Error(`${path} must be a URL`);
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch {
+        throw new Error(`${path} must be an absolute http or https URL`);
+    }
+    if (!["http:", "https:"].includes(parsed.protocol) ||
+        parsed.username ||
+        parsed.password ||
+        parsed.search ||
+        parsed.hash) {
+        throw new Error(`${path} must be a credential-free http or https URL`);
+    }
+    return value.replace(/\/+$/, "");
+}
+function validateApi(value, path) {
+    if (typeof value !== "string" || !APIS.has(value)) {
+        throw new Error(`${path} uses an unsupported API`);
+    }
+    return value;
+}
+function validateModel(providerId, value, index) {
+    if (!isRecord(value) || typeof value.id !== "string" || value.id.trim().length === 0) {
+        throw new Error(`providers.${providerId}.models[${index}].id is required`);
+    }
+    const model = {
+        id: value.id,
+        ...(typeof value.name === "string" ? { name: value.name } : {}),
+        ...(value.api === undefined ? {} : { api: validateApi(value.api, `providers.${providerId}.models[${index}].api`) }),
+        ...(typeof value.reasoning === "boolean" ? { reasoning: value.reasoning } : {}),
+    };
+    return model;
+}
+function validateOverride(providerId, modelId, value) {
+    if (!isRecord(value))
+        throw new Error(`providers.${providerId}.modelOverrides.${modelId} must be an object`);
+    return {
+        ...(typeof value.name === "string" ? { name: value.name } : {}),
+        ...(value.api === undefined
+            ? {}
+            : { api: validateApi(value.api, `providers.${providerId}.modelOverrides.${modelId}.api`) }),
+        ...(typeof value.reasoning === "boolean" ? { reasoning: value.reasoning } : {}),
+        ...(Array.isArray(value.input) && value.input.every((item) => item === "text" || item === "image")
+            ? { input: [...value.input] }
+            : {}),
+    };
+}
+function validateProvider(providerId, value) {
+    if (!isRecord(value))
+        throw new Error(`providers.${providerId} must be an object`);
+    if ("apiKey" in value)
+        throw new Error(`providers.${providerId}.apiKey is not allowed; use apiKeyEnv`);
+    const baseUrl = value.baseUrl === undefined ? undefined : validateUrl(value.baseUrl, `providers.${providerId}.baseUrl`);
+    const providerApi = value.api === undefined ? undefined : validateApi(value.api, `providers.${providerId}.api`);
+    if (value.apiKeyEnv !== undefined && (typeof value.apiKeyEnv !== "string" || !ENV_NAME.test(value.apiKeyEnv))) {
+        throw new Error(`providers.${providerId}.apiKeyEnv must be an environment variable name`);
+    }
+    if (value.models !== undefined && (!Array.isArray(value.models) || value.models.length === 0)) {
+        throw new Error(`providers.${providerId}.models must contain at least one model when present`);
+    }
+    const models = value.models?.map((entry, index) => validateModel(providerId, entry, index));
+    let modelOverrides;
+    if (value.modelOverrides !== undefined) {
+        if (!isRecord(value.modelOverrides))
+            throw new Error(`providers.${providerId}.modelOverrides must be an object`);
+        modelOverrides = {};
+        for (const [modelId, override] of Object.entries(value.modelOverrides)) {
+            modelOverrides[modelId] = validateOverride(providerId, modelId, override);
+        }
+    }
+    return {
+        ...(typeof value.name === "string" ? { name: value.name } : {}),
+        ...(baseUrl === undefined ? {} : { baseUrl }),
+        ...(providerApi === undefined ? {} : { api: providerApi }),
+        ...(value.apiKeyEnv === undefined ? {} : { apiKeyEnv: value.apiKeyEnv }),
+        ...(models === undefined ? {} : { models }),
+        ...(modelOverrides === undefined ? {} : { modelOverrides }),
+    };
+}
+export async function loadModelsDocument(path) {
+    let text;
+    try {
+        text = await readFile(path, "utf8");
+    }
+    catch (cause) {
+        if (cause.code === "ENOENT")
+            return { providers: {} };
+        throw new Error(`Unable to read models.json ${path}: ${cause instanceof Error ? cause.message : String(cause)}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        throw new Error(`Invalid models.json ${path}: malformed JSON`);
+    }
+    if (!isRecord(parsed) || !isRecord(parsed.providers)) {
+        throw new Error(`Invalid models.json ${path}: providers must be an object`);
+    }
+    const providers = {};
+    for (const [providerId, value] of Object.entries(parsed.providers)) {
+        providers[providerId] = validateProvider(providerId, value);
+    }
+    return { providers: structuredClone(providers) };
+}
+export async function loadModelsDocuments(paths) {
+    const merged = {};
+    for (const path of paths) {
+        const document = await loadModelsDocument(path);
+        for (const [providerId, definition] of Object.entries(document.providers)) {
+            const previous = merged[providerId];
+            merged[providerId] = previous
+                ? {
+                    ...previous,
+                    ...definition,
+                    models: definition.models ?? previous.models,
+                    modelOverrides: { ...previous.modelOverrides, ...definition.modelOverrides },
+                }
+                : definition;
+        }
+    }
+    return { providers: structuredClone(merged) };
+}
+//# sourceMappingURL=models-loader.js.map

package/dist/config/models-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models-loader.js","sourceRoot":"","sources":["../../src/config/models-loader.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport type { ConfiguredApi, CustomModelDefinition, CustomProviderDefinition, ModelsDocument } from \"./models-types.ts\";\n\nconst APIS = new Set<ConfiguredApi>([\"openai-responses\", \"anthropic-messages\"]);\nconst ENV_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction validateUrl(value: unknown, path: string): string {\n\tif (typeof value !== \"string\") throw new Error(`${path} must be a URL`);\n\tlet parsed: URL;\n\ttry {\n\t\tparsed = new URL(value);\n\t} catch {\n\t\tthrow new Error(`${path} must be an absolute http or https URL`);\n\t}\n\tif (\n\t\t![\"http:\", \"https:\"].includes(parsed.protocol) ||\n\t\tparsed.username ||\n\t\tparsed.password ||\n\t\tparsed.search ||\n\t\tparsed.hash\n\t) {\n\t\tthrow new Error(`${path} must be a credential-free http or https URL`);\n\t}\n\treturn value.replace(/\\/+$/, \"\");\n}\n\nfunction validateApi(value: unknown, path: string): ConfiguredApi {\n\tif (typeof value !== \"string\" || !APIS.has(value as ConfiguredApi)) {\n\t\tthrow new Error(`${path} uses an unsupported API`);\n\t}\n\treturn value as ConfiguredApi;\n}\n\nfunction validateModel(providerId: string, value: unknown, index: number): CustomModelDefinition {\n\tif (!isRecord(value) || typeof value.id !== \"string\" || value.id.trim().length === 0) {\n\t\tthrow new Error(`providers.${providerId}.models[${index}].id is required`);\n\t}\n\tconst model: CustomModelDefinition = {\n\t\tid: value.id,\n\t\t...(typeof value.name === \"string\" ? { name: value.name } : {}),\n\t\t...(value.api === undefined ? {} : { api: validateApi(value.api, `providers.${providerId}.models[${index}].api`) }),\n\t\t...(typeof value.reasoning === \"boolean\" ? { reasoning: value.reasoning } : {}),\n\t};\n\treturn model;\n}\n\nfunction validateOverride(providerId: string, modelId: string, value: unknown): Omit<CustomModelDefinition, \"id\"> {\n\tif (!isRecord(value)) throw new Error(`providers.${providerId}.modelOverrides.${modelId} must be an object`);\n\treturn {\n\t\t...(typeof value.name === \"string\" ? { name: value.name } : {}),\n\t\t...(value.api === undefined\n\t\t\t? {}\n\t\t\t: { api: validateApi(value.api, `providers.${providerId}.modelOverrides.${modelId}.api`) }),\n\t\t...(typeof value.reasoning === \"boolean\" ? { reasoning: value.reasoning } : {}),\n\t\t...(Array.isArray(value.input) && value.input.every((item) => item === \"text\" || item === \"image\")\n\t\t\t? { input: [...value.input] as (\"text\" | \"image\")[] }\n\t\t\t: {}),\n\t};\n}\n\nfunction validateProvider(providerId: string, value: unknown): CustomProviderDefinition {\n\tif (!isRecord(value)) throw new Error(`providers.${providerId} must be an object`);\n\tif (\"apiKey\" in value) throw new Error(`providers.${providerId}.apiKey is not allowed; use apiKeyEnv`);\n\tconst baseUrl =\n\t\tvalue.baseUrl === undefined ? undefined : validateUrl(value.baseUrl, `providers.${providerId}.baseUrl`);\n\tconst providerApi = value.api === undefined ? undefined : validateApi(value.api, `providers.${providerId}.api`);\n\tif (value.apiKeyEnv !== undefined && (typeof value.apiKeyEnv !== \"string\" || !ENV_NAME.test(value.apiKeyEnv))) {\n\t\tthrow new Error(`providers.${providerId}.apiKeyEnv must be an environment variable name`);\n\t}\n\tif (value.models !== undefined && (!Array.isArray(value.models) || value.models.length === 0)) {\n\t\tthrow new Error(`providers.${providerId}.models must contain at least one model when present`);\n\t}\n\tconst models = value.models?.map((entry, index) => validateModel(providerId, entry, index));\n\tlet modelOverrides: Record<string, Omit<CustomModelDefinition, \"id\">> | undefined;\n\tif (value.modelOverrides !== undefined) {\n\t\tif (!isRecord(value.modelOverrides)) throw new Error(`providers.${providerId}.modelOverrides must be an object`);\n\t\tmodelOverrides = {};\n\t\tfor (const [modelId, override] of Object.entries(value.modelOverrides)) {\n\t\t\tmodelOverrides[modelId] = validateOverride(providerId, modelId, override);\n\t\t}\n\t}\n\treturn {\n\t\t...(typeof value.name === \"string\" ? { name: value.name } : {}),\n\t\t...(baseUrl === undefined ? {} : { baseUrl }),\n\t\t...(providerApi === undefined ? {} : { api: providerApi }),\n\t\t...(value.apiKeyEnv === undefined ? {} : { apiKeyEnv: value.apiKeyEnv }),\n\t\t...(models === undefined ? {} : { models }),\n\t\t...(modelOverrides === undefined ? {} : { modelOverrides }),\n\t};\n}\n\nexport async function loadModelsDocument(path: string): Promise<ModelsDocument> {\n\tlet text: string;\n\ttry {\n\t\ttext = await readFile(path, \"utf8\");\n\t} catch (cause) {\n\t\tif ((cause as NodeJS.ErrnoException).code === \"ENOENT\") return { providers: {} };\n\t\tthrow new Error(`Unable to read models.json ${path}: ${cause instanceof Error ? cause.message : String(cause)}`);\n\t}\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(text) as unknown;\n\t} catch {\n\t\tthrow new Error(`Invalid models.json ${path}: malformed JSON`);\n\t}\n\tif (!isRecord(parsed) || !isRecord(parsed.providers)) {\n\t\tthrow new Error(`Invalid models.json ${path}: providers must be an object`);\n\t}\n\tconst providers: Record<string, CustomProviderDefinition> = {};\n\tfor (const [providerId, value] of Object.entries(parsed.providers)) {\n\t\tproviders[providerId] = validateProvider(providerId, value);\n\t}\n\treturn { providers: structuredClone(providers) };\n}\n\nexport async function loadModelsDocuments(paths: readonly string[]): Promise<ModelsDocument> {\n\tconst merged: Record<string, CustomProviderDefinition> = {};\n\tfor (const path of paths) {\n\t\tconst document = await loadModelsDocument(path);\n\t\tfor (const [providerId, definition] of Object.entries(document.providers)) {\n\t\t\tconst previous = merged[providerId];\n\t\t\tmerged[providerId] = previous\n\t\t\t\t? {\n\t\t\t\t\t\t...previous,\n\t\t\t\t\t\t...definition,\n\t\t\t\t\t\tmodels: definition.models ?? previous.models,\n\t\t\t\t\t\tmodelOverrides: { ...previous.modelOverrides, ...definition.modelOverrides },\n\t\t\t\t\t}\n\t\t\t\t: definition;\n\t\t}\n\t}\n\treturn { providers: structuredClone(merged) };\n}\n"]}

package/dist/config/models-types.d.ts

@@ -0,0 +1,23 @@
+export type ConfiguredApi = "openai-responses" | "anthropic-messages";
+export interface CustomModelDefinition {
+    readonly id: string;
+    readonly name?: string;
+    readonly api?: ConfiguredApi;
+    readonly reasoning?: boolean;
+    readonly input?: readonly ("text" | "image")[];
+    readonly contextWindow?: number;
+    readonly maxOutputTokens?: number;
+    readonly cost?: Partial<Record<"input" | "output" | "cacheRead" | "cacheWrite", number>>;
+}
+export interface CustomProviderDefinition {
+    readonly name?: string;
+    readonly baseUrl?: string;
+    readonly api?: ConfiguredApi;
+    readonly apiKeyEnv?: string;
+    readonly models?: readonly CustomModelDefinition[];
+    readonly modelOverrides?: Readonly<Record<string, Omit<CustomModelDefinition, "id">>>;
+}
+export interface ModelsDocument {
+    readonly providers: Readonly<Record<string, CustomProviderDefinition>>;
+}
+//# sourceMappingURL=models-types.d.ts.map

package/dist/config/models-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models-types.d.ts","sourceRoot":"","sources":["../../src/config/models-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,oBAAoB,CAAC;AAEtE,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;CACzF;AAED,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;CACtF;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAAC;CACvE"}

package/dist/config/models-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=models-types.js.map

package/dist/config/models-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models-types.js","sourceRoot":"","sources":["../../src/config/models-types.ts"],"names":[],"mappings":"","sourcesContent":["export type ConfiguredApi = \"openai-responses\" | \"anthropic-messages\";\n\nexport interface CustomModelDefinition {\n\treadonly id: string;\n\treadonly name?: string;\n\treadonly api?: ConfiguredApi;\n\treadonly reasoning?: boolean;\n\treadonly input?: readonly (\"text\" | \"image\")[];\n\treadonly contextWindow?: number;\n\treadonly maxOutputTokens?: number;\n\treadonly cost?: Partial<Record<\"input\" | \"output\" | \"cacheRead\" | \"cacheWrite\", number>>;\n}\n\nexport interface CustomProviderDefinition {\n\treadonly name?: string;\n\treadonly baseUrl?: string;\n\treadonly api?: ConfiguredApi;\n\treadonly apiKeyEnv?: string;\n\treadonly models?: readonly CustomModelDefinition[];\n\treadonly modelOverrides?: Readonly<Record<string, Omit<CustomModelDefinition, \"id\">>>;\n}\n\nexport interface ModelsDocument {\n\treadonly providers: Readonly<Record<string, CustomProviderDefinition>>;\n}\n"]}

package/dist/config/settings-loader.d.ts

@@ -0,0 +1,3 @@
+import type { LoadedSettings, SettingsLoadOptions } from "./settings-types.ts";
+export declare function loadSettings(options?: SettingsLoadOptions): Promise<LoadedSettings>;
+//# sourceMappingURL=settings-loader.d.ts.map

package/dist/config/settings-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-loader.d.ts","sourceRoot":"","sources":["../../src/config/settings-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,cAAc,EAId,mBAAmB,EACnB,MAAM,qBAAqB,CAAC;AA0H7B,wBAAsB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,cAAc,CAAC,CAY7F"}

package/dist/config/settings-loader.js

@@ -0,0 +1,130 @@
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const ENV_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function validateProviderSettings(value, source, provider) {
+    if (!isRecord(value))
+        throw new Error(`Invalid settings file ${source}: providers.${provider} must be an object.`);
+    if ("apiKey" in value)
+        throw new Error(`Invalid settings file ${source}: raw apiKey is not allowed; use apiKeyEnv.`);
+    const result = {};
+    if (value.apiKeyEnv !== undefined) {
+        if (typeof value.apiKeyEnv !== "string" || !ENV_NAME.test(value.apiKeyEnv)) {
+            throw new Error(`Invalid settings file ${source}: providers.${provider}.apiKeyEnv must be an environment variable name.`);
+        }
+        result.apiKeyEnv = value.apiKeyEnv;
+    }
+    if (value.baseUrl !== undefined) {
+        if (typeof value.baseUrl !== "string") {
+            throw new Error(`Invalid settings file ${source}: providers.${provider}.baseUrl must be a URL.`);
+        }
+        let url;
+        try {
+            url = new URL(value.baseUrl);
+        }
+        catch {
+            throw new Error(`Invalid settings file ${source}: providers.${provider}.baseUrl must be an absolute http or https URL.`);
+        }
+        if ((url.protocol !== "http:" && url.protocol !== "https:") ||
+            url.username ||
+            url.password ||
+            url.search ||
+            url.hash) {
+            throw new Error(`Invalid settings file ${source}: providers.${provider}.baseUrl must be a credential-free http(s) URL.`);
+        }
+        result.baseUrl = value.baseUrl.replace(/\/+$/, "");
+    }
+    return result;
+}
+function validateDocument(value, source) {
+    if (!isRecord(value))
+        throw new Error(`Invalid settings file ${source}: root must be a JSON object.`);
+    if ("apiKey" in value)
+        throw new Error(`Invalid settings file ${source}: raw apiKey is not allowed; use apiKeyEnv.`);
+    const result = {};
+    if (value.provider !== undefined) {
+        if (typeof value.provider !== "string" || value.provider.trim().length === 0) {
+            throw new Error(`Invalid settings file ${source}: provider must be a non-empty string.`);
+        }
+        result.provider = value.provider;
+    }
+    if (value.model !== undefined) {
+        if (typeof value.model !== "string" || value.model.trim().length === 0) {
+            throw new Error(`Invalid settings file ${source}: model must be a non-empty string.`);
+        }
+        result.model = value.model;
+    }
+    if (value.providers !== undefined) {
+        if (!isRecord(value.providers))
+            throw new Error(`Invalid settings file ${source}: providers must be an object.`);
+        const providers = {};
+        for (const [name, settings] of Object.entries(value.providers)) {
+            if (name.trim().length === 0)
+                throw new Error(`Invalid settings file ${source}: provider name must not be empty.`);
+            providers[name] = validateProviderSettings(settings, source, name);
+        }
+        result.providers = providers;
+    }
+    return result;
+}
+function mergeSettings(base, override) {
+    const providers = {};
+    const providerNames = new Set([...Object.keys(base.providers ?? {}), ...Object.keys(override.providers ?? {})]);
+    for (const provider of providerNames) {
+        const merged = { ...base.providers?.[provider], ...override.providers?.[provider] };
+        if (Object.keys(merged).length > 0)
+            providers[provider] = merged;
+    }
+    return {
+        ...base,
+        ...override,
+        providers: Object.keys(providers).length > 0 ? providers : undefined,
+    };
+}
+function globalSettingsPath(options) {
+    const env = options.env ?? process.env;
+    if (process.platform === "win32") {
+        const appData = options.appData ?? env.APPDATA;
+        if (appData)
+            return join(appData, "di-code", "settings.json");
+    }
+    const configHome = env.XDG_CONFIG_HOME;
+    return join(configHome || join(options.homeDir ?? homedir(), ".config"), "di-code", "settings.json");
+}
+async function readOptional(path) {
+    let text;
+    try {
+        text = await readFile(path, "utf8");
+    }
+    catch (cause) {
+        if (cause.code === "ENOENT")
+            return undefined;
+        throw new Error(`Unable to read settings file ${path}: ${cause instanceof Error ? cause.message : String(cause)}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        throw new Error(`Invalid settings file ${path}: malformed JSON.`);
+    }
+    return validateDocument(parsed, path);
+}
+export async function loadSettings(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const paths = [globalSettingsPath(options), join(cwd, ".di-code", "settings.json")];
+    let settings = {};
+    const sources = [];
+    for (const path of paths) {
+        const document = await readOptional(path);
+        if (document === undefined)
+            continue;
+        settings = mergeSettings(settings, document);
+        sources.push(path);
+    }
+    return { settings, sources };
+}
+//# sourceMappingURL=settings-loader.js.map

package/dist/config/settings-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-loader.js","sourceRoot":"","sources":["../../src/config/settings-loader.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type {\n\tLoadedSettings,\n\tProviderName,\n\tProviderSettings,\n\tSettingsDocument,\n\tSettingsLoadOptions,\n} from \"./settings-types.ts\";\n\nconst ENV_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction validateProviderSettings(value: unknown, source: string, provider: ProviderName): ProviderSettings {\n\tif (!isRecord(value)) throw new Error(`Invalid settings file ${source}: providers.${provider} must be an object.`);\n\tif (\"apiKey\" in value) throw new Error(`Invalid settings file ${source}: raw apiKey is not allowed; use apiKeyEnv.`);\n\tconst result: { apiKeyEnv?: string; baseUrl?: string } = {};\n\tif (value.apiKeyEnv !== undefined) {\n\t\tif (typeof value.apiKeyEnv !== \"string\" || !ENV_NAME.test(value.apiKeyEnv)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Invalid settings file ${source}: providers.${provider}.apiKeyEnv must be an environment variable name.`,\n\t\t\t);\n\t\t}\n\t\tresult.apiKeyEnv = value.apiKeyEnv;\n\t}\n\tif (value.baseUrl !== undefined) {\n\t\tif (typeof value.baseUrl !== \"string\") {\n\t\t\tthrow new Error(`Invalid settings file ${source}: providers.${provider}.baseUrl must be a URL.`);\n\t\t}\n\t\tlet url: URL;\n\t\ttry {\n\t\t\turl = new URL(value.baseUrl);\n\t\t} catch {\n\t\t\tthrow new Error(\n\t\t\t\t`Invalid settings file ${source}: providers.${provider}.baseUrl must be an absolute http or https URL.`,\n\t\t\t);\n\t\t}\n\t\tif (\n\t\t\t(url.protocol !== \"http:\" && url.protocol !== \"https:\") ||\n\t\t\turl.username ||\n\t\t\turl.password ||\n\t\t\turl.search ||\n\t\t\turl.hash\n\t\t) {\n\t\t\tthrow new Error(\n\t\t\t\t`Invalid settings file ${source}: providers.${provider}.baseUrl must be a credential-free http(s) URL.`,\n\t\t\t);\n\t\t}\n\t\tresult.baseUrl = value.baseUrl.replace(/\\/+$/, \"\");\n\t}\n\treturn result;\n}\n\nfunction validateDocument(value: unknown, source: string): SettingsDocument {\n\tif (!isRecord(value)) throw new Error(`Invalid settings file ${source}: root must be a JSON object.`);\n\tif (\"apiKey\" in value) throw new Error(`Invalid settings file ${source}: raw apiKey is not allowed; use apiKeyEnv.`);\n\tconst result: {\n\t\tprovider?: ProviderName;\n\t\tmodel?: string;\n\t\tproviders?: Partial<Record<ProviderName, ProviderSettings>>;\n\t} = {};\n\tif (value.provider !== undefined) {\n\t\tif (typeof value.provider !== \"string\" || value.provider.trim().length === 0) {\n\t\t\tthrow new Error(`Invalid settings file ${source}: provider must be a non-empty string.`);\n\t\t}\n\t\tresult.provider = value.provider;\n\t}\n\tif (value.model !== undefined) {\n\t\tif (typeof value.model !== \"string\" || value.model.trim().length === 0) {\n\t\t\tthrow new Error(`Invalid settings file ${source}: model must be a non-empty string.`);\n\t\t}\n\t\tresult.model = value.model;\n\t}\n\tif (value.providers !== undefined) {\n\t\tif (!isRecord(value.providers)) throw new Error(`Invalid settings file ${source}: providers must be an object.`);\n\t\tconst providers: Partial<Record<ProviderName, ProviderSettings>> = {};\n\t\tfor (const [name, settings] of Object.entries(value.providers)) {\n\t\t\tif (name.trim().length === 0)\n\t\t\t\tthrow new Error(`Invalid settings file ${source}: provider name must not be empty.`);\n\t\t\tproviders[name] = validateProviderSettings(settings, source, name);\n\t\t}\n\t\tresult.providers = providers;\n\t}\n\treturn result;\n}\n\nfunction mergeSettings(base: SettingsDocument, override: SettingsDocument): SettingsDocument {\n\tconst providers: Partial<Record<ProviderName, ProviderSettings>> = {};\n\tconst providerNames = new Set([...Object.keys(base.providers ?? {}), ...Object.keys(override.providers ?? {})]);\n\tfor (const provider of providerNames) {\n\t\tconst merged = { ...base.providers?.[provider], ...override.providers?.[provider] };\n\t\tif (Object.keys(merged).length > 0) providers[provider] = merged;\n\t}\n\treturn {\n\t\t...base,\n\t\t...override,\n\t\tproviders: Object.keys(providers).length > 0 ? providers : undefined,\n\t};\n}\n\nfunction globalSettingsPath(options: SettingsLoadOptions): string {\n\tconst env = options.env ?? process.env;\n\tif (process.platform === \"win32\") {\n\t\tconst appData = options.appData ?? env.APPDATA;\n\t\tif (appData) return join(appData, \"di-code\", \"settings.json\");\n\t}\n\tconst configHome = env.XDG_CONFIG_HOME;\n\treturn join(configHome || join(options.homeDir ?? homedir(), \".config\"), \"di-code\", \"settings.json\");\n}\n\nasync function readOptional(path: string): Promise<SettingsDocument | undefined> {\n\tlet text: string;\n\ttry {\n\t\ttext = await readFile(path, \"utf8\");\n\t} catch (cause) {\n\t\tif ((cause as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n\t\tthrow new Error(`Unable to read settings file ${path}: ${cause instanceof Error ? cause.message : String(cause)}`);\n\t}\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(text) as unknown;\n\t} catch {\n\t\tthrow new Error(`Invalid settings file ${path}: malformed JSON.`);\n\t}\n\treturn validateDocument(parsed, path);\n}\n\nexport async function loadSettings(options: SettingsLoadOptions = {}): Promise<LoadedSettings> {\n\tconst cwd = options.cwd ?? process.cwd();\n\tconst paths = [globalSettingsPath(options), join(cwd, \".di-code\", \"settings.json\")];\n\tlet settings: SettingsDocument = {};\n\tconst sources: string[] = [];\n\tfor (const path of paths) {\n\t\tconst document = await readOptional(path);\n\t\tif (document === undefined) continue;\n\t\tsettings = mergeSettings(settings, document);\n\t\tsources.push(path);\n\t}\n\treturn { settings, sources };\n}\n"]}

package/dist/config/settings-types.d.ts

@@ -0,0 +1,21 @@
+export type ProviderName = string;
+export interface ProviderSettings {
+    readonly apiKeyEnv?: string;
+    readonly baseUrl?: string;
+}
+export interface SettingsDocument {
+    readonly provider?: ProviderName;
+    readonly model?: string;
+    readonly providers?: Partial<Record<ProviderName, ProviderSettings>>;
+}
+export interface SettingsLoadOptions {
+    readonly cwd?: string;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly homeDir?: string;
+    readonly appData?: string;
+}
+export interface LoadedSettings {
+    readonly settings: SettingsDocument;
+    readonly sources: readonly string[];
+}
+//# sourceMappingURL=settings-types.d.ts.map

package/dist/config/settings-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-types.d.ts","sourceRoot":"","sources":["../../src/config/settings-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC"}

package/dist/config/settings-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=settings-types.js.map

package/dist/config/settings-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-types.js","sourceRoot":"","sources":["../../src/config/settings-types.ts"],"names":[],"mappings":"","sourcesContent":["export type ProviderName = string;\n\nexport interface ProviderSettings {\n\treadonly apiKeyEnv?: string;\n\treadonly baseUrl?: string;\n}\n\nexport interface SettingsDocument {\n\treadonly provider?: ProviderName;\n\treadonly model?: string;\n\treadonly providers?: Partial<Record<ProviderName, ProviderSettings>>;\n}\n\nexport interface SettingsLoadOptions {\n\treadonly cwd?: string;\n\treadonly env?: Readonly<Record<string, string | undefined>>;\n\treadonly homeDir?: string;\n\treadonly appData?: string;\n}\n\nexport interface LoadedSettings {\n\treadonly settings: SettingsDocument;\n\treadonly sources: readonly string[];\n}\n"]}

package/dist/core/context-builder.d.ts

@@ -0,0 +1,8 @@
+import type { Message } from "@di-code/ai";
+import type { SessionEntry } from "./session/types.ts";
+export interface BuiltSessionContext {
+    readonly messages: readonly Message[];
+    readonly sourceEntryIds: readonly (string | null)[];
+}
+export declare function buildSessionContext(entries: readonly SessionEntry[]): BuiltSessionContext;
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/core/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../src/core/context-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAA4C,MAAM,oBAAoB,CAAC;AAEjG,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;CACpD;AAmBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,mBAAmB,CAkCzF"}

package/dist/core/context-builder.js

@@ -0,0 +1,46 @@
+function createSummaryMessage(entry) {
+    return {
+        role: "user",
+        content: [
+            {
+                type: "text",
+                text: `<conversation-summary>\n${entry.summary}\n</conversation-summary>`,
+            },
+        ],
+        timestamp: Date.parse(entry.timestamp),
+    };
+}
+function messageEntries(entries) {
+    return entries.filter((entry) => entry.type === "message");
+}
+export function buildSessionContext(entries) {
+    const snapshot = structuredClone([...entries]);
+    let summaryIndex = -1;
+    for (let index = snapshot.length - 1; index >= 0; index--) {
+        if (snapshot[index]?.type === "summary") {
+            summaryIndex = index;
+            break;
+        }
+    }
+    if (summaryIndex < 0) {
+        const messages = messageEntries(snapshot);
+        return {
+            messages: messages.map((entry) => entry.message),
+            sourceEntryIds: messages.map((entry) => entry.id),
+        };
+    }
+    const summary = snapshot[summaryIndex];
+    if (summary?.type !== "summary") {
+        throw new Error("Latest summary entry could not be resolved.");
+    }
+    const firstKeptIndex = snapshot.findIndex((entry, index) => index < summaryIndex && entry.type === "message" && entry.id === summary.firstKeptEntryId);
+    if (firstKeptIndex < 0) {
+        throw new Error("Summary firstKeptEntryId must reference an earlier message entry.");
+    }
+    const keptEntries = messageEntries(snapshot.slice(firstKeptIndex));
+    return {
+        messages: [createSummaryMessage(summary), ...keptEntries.map((entry) => entry.message)],
+        sourceEntryIds: [null, ...keptEntries.map((entry) => entry.id)],
+    };
+}
+//# sourceMappingURL=context-builder.js.map