@di-code/coding-agent 0.1.7 → 0.1.8

package/dist/core/tools/read.js

@@ -1,132 +1,2 @@
-import { readFile } from "node:fs/promises";
-import { Type } from "@di-code/ai";
-import { resolveAllowedFilePath } from "./path-boundary.js";
-export const DEFAULT_READ_MAX_LINES = 2_000;
-export const DEFAULT_READ_MAX_BYTES = 50 * 1024;
-export const readParameters = Type.Object({
-    path: Type.String({ minLength: 1 }),
-    offset: Type.Optional(Type.Integer({ minimum: 1 })),
-    limit: Type.Optional(Type.Integer({ minimum: 1 })),
-});
-function assertPositiveInteger(name, value) {
-    if (value !== undefined && (!Number.isInteger(value) || value < 1)) {
-        throw new Error(`${name} must be a positive integer`);
-    }
-}
-function splitLines(text) {
-    if (text.length === 0)
-        return [];
-    const lines = text.split("\n");
-    if (text.endsWith("\n"))
-        lines.pop();
-    return lines;
-}
-function selectUserWindow(lines, offset, limit) {
-    if (lines.length === 0) {
-        if (offset > 1)
-            throw new Error(`Offset ${offset} is beyond end of file (0 lines total)`);
-        return { content: "", startLine: 1, endLine: 0, totalLines: 0, truncatedBy: null };
-    }
-    const startIndex = offset - 1;
-    if (startIndex >= lines.length) {
-        throw new Error(`Offset ${offset} is beyond end of file (${lines.length} lines total)`);
-    }
-    const available = lines.slice(startIndex);
-    const selected = limit === undefined ? available : available.slice(0, limit);
-    const endLine = offset + selected.length - 1;
-    return {
-        content: selected.join("\n"),
-        startLine: offset,
-        endLine,
-        totalLines: lines.length,
-        truncatedBy: limit !== undefined && selected.length < available.length ? "limit" : null,
-    };
-}
-function applyOutputLimits(window, maxLines, maxBytes) {
-    if (window.content === "")
-        return window;
-    const lines = window.content.split("\n");
-    const selected = [];
-    let bytes = 0;
-    let truncatedBy = null;
-    for (const line of lines) {
-        if (selected.length >= maxLines) {
-            truncatedBy = "lines";
-            break;
-        }
-        const separatorBytes = selected.length === 0 ? 0 : 1;
-        const nextBytes = bytes + separatorBytes + Buffer.byteLength(line, "utf8");
-        if (nextBytes > maxBytes) {
-            if (selected.length === 0)
-                throw new Error("A single line exceeds the read byte limit");
-            truncatedBy = "bytes";
-            break;
-        }
-        selected.push(line);
-        bytes = nextBytes;
-    }
-    if (truncatedBy === null && selected.length < lines.length)
-        truncatedBy = "lines";
-    if (truncatedBy === null)
-        return window;
-    return {
-        ...window,
-        content: selected.join("\n"),
-        endLine: window.startLine + selected.length - 1,
-        truncatedBy,
-    };
-}
-function formatByteLimit(maxBytes) {
-    if (maxBytes % 1024 === 0)
-        return `${maxBytes / 1024} KiB`;
-    return `${maxBytes} bytes`;
-}
-function appendContinuation(window, maxBytes) {
-    if (window.truncatedBy === null)
-        return window.content;
-    const nextOffset = window.endLine + 1;
-    if (window.truncatedBy === "limit") {
-        const remaining = window.totalLines - window.endLine;
-        return `${window.content}\n\n[${remaining} more lines in file. Use offset=${nextOffset} to continue.]`;
-    }
-    const reason = window.truncatedBy === "bytes" ? ` (${formatByteLimit(maxBytes)} limit)` : "";
-    return `${window.content}\n\n[Showing lines ${window.startLine}-${window.endLine} of ${window.totalLines}${reason}. Use offset=${nextOffset} to continue.]`;
-}
-function containsNulByte(buffer) {
-    const sampleLength = Math.min(buffer.length, 8 * 1024);
-    for (let index = 0; index < sampleLength; index++) {
-        if (buffer[index] === 0)
-            return true;
-    }
-    return false;
-}
-export function createReadTool(allowedRoot, options = {}) {
-    const maxLines = options.maxLines ?? DEFAULT_READ_MAX_LINES;
-    const maxBytes = options.maxBytes ?? DEFAULT_READ_MAX_BYTES;
-    assertPositiveInteger("maxLines", maxLines);
-    assertPositiveInteger("maxBytes", maxBytes);
-    return {
-        name: "read",
-        description: "Read a UTF-8 text file inside the allowed root. Use offset and limit for large files.",
-        parameters: readParameters,
-        async execute(_toolCallId, parameters, signal) {
-            if (signal?.aborted)
-                throw new Error("Operation aborted");
-            if (parameters.path.length === 0)
-                throw new Error("path must not be empty");
-            assertPositiveInteger("offset", parameters.offset);
-            assertPositiveInteger("limit", parameters.limit);
-            const absolutePath = await resolveAllowedFilePath(parameters.path, allowedRoot);
-            if (signal?.aborted)
-                throw new Error("Operation aborted");
-            const buffer = await readFile(absolutePath);
-            if (containsNulByte(buffer)) {
-                throw new Error("Binary files are not supported by read");
-            }
-            const userWindow = selectUserWindow(splitLines(buffer.toString("utf8")), parameters.offset ?? 1, parameters.limit);
-            const boundedWindow = applyOutputLimits(userWindow, maxLines, maxBytes);
-            return [{ type: "text", text: appendContinuation(boundedWindow, maxBytes) }];
-        },
-    };
-}
+export * from "@di-code/builtins";
 //# sourceMappingURL=read.js.map

package/dist/core/tools/read.js.map

@@ -1 +1 @@
-{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/core/tools/read.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport type { AgentTool } from \"@di-code/agent\";\nimport { type Static, type ToolResultContent, Type } from \"@di-code/ai\";\nimport { resolveAllowedFilePath } from \"./path-boundary.ts\";\n\nexport const DEFAULT_READ_MAX_LINES = 2_000;\nexport const DEFAULT_READ_MAX_BYTES = 50 * 1024;\n\nexport const readParameters = Type.Object({\n\tpath: Type.String({ minLength: 1 }),\n\toffset: Type.Optional(Type.Integer({ minimum: 1 })),\n\tlimit: Type.Optional(Type.Integer({ minimum: 1 })),\n});\n\nexport type ReadParameters = Static<typeof readParameters>;\n\nexport interface ReadToolOptions {\n\treadonly maxLines?: number;\n\treadonly maxBytes?: number;\n}\n\nexport type ReadTool = AgentTool<typeof readParameters, ToolResultContent[]>;\n\ninterface TextWindow {\n\treadonly content: string;\n\treadonly startLine: number;\n\treadonly endLine: number;\n\treadonly totalLines: number;\n\treadonly truncatedBy: \"limit\" | \"lines\" | \"bytes\" | null;\n}\n\nfunction assertPositiveInteger(name: string, value: number | undefined): void {\n\tif (value !== undefined && (!Number.isInteger(value) || value < 1)) {\n\t\tthrow new Error(`${name} must be a positive integer`);\n\t}\n}\n\nfunction splitLines(text: string): string[] {\n\tif (text.length === 0) return [];\n\tconst lines = text.split(\"\\n\");\n\tif (text.endsWith(\"\\n\")) lines.pop();\n\treturn lines;\n}\n\nfunction selectUserWindow(lines: readonly string[], offset: number, limit: number | undefined): TextWindow {\n\tif (lines.length === 0) {\n\t\tif (offset > 1) throw new Error(`Offset ${offset} is beyond end of file (0 lines total)`);\n\t\treturn { content: \"\", startLine: 1, endLine: 0, totalLines: 0, truncatedBy: null };\n\t}\n\n\tconst startIndex = offset - 1;\n\tif (startIndex >= lines.length) {\n\t\tthrow new Error(`Offset ${offset} is beyond end of file (${lines.length} lines total)`);\n\t}\n\n\tconst available = lines.slice(startIndex);\n\tconst selected = limit === undefined ? available : available.slice(0, limit);\n\tconst endLine = offset + selected.length - 1;\n\treturn {\n\t\tcontent: selected.join(\"\\n\"),\n\t\tstartLine: offset,\n\t\tendLine,\n\t\ttotalLines: lines.length,\n\t\ttruncatedBy: limit !== undefined && selected.length < available.length ? \"limit\" : null,\n\t};\n}\n\nfunction applyOutputLimits(window: TextWindow, maxLines: number, maxBytes: number): TextWindow {\n\tif (window.content === \"\") return window;\n\tconst lines = window.content.split(\"\\n\");\n\tconst selected: string[] = [];\n\tlet bytes = 0;\n\tlet truncatedBy: \"lines\" | \"bytes\" | null = null;\n\n\tfor (const line of lines) {\n\t\tif (selected.length >= maxLines) {\n\t\t\ttruncatedBy = \"lines\";\n\t\t\tbreak;\n\t\t}\n\t\tconst separatorBytes = selected.length === 0 ? 0 : 1;\n\t\tconst nextBytes = bytes + separatorBytes + Buffer.byteLength(line, \"utf8\");\n\t\tif (nextBytes > maxBytes) {\n\t\t\tif (selected.length === 0) throw new Error(\"A single line exceeds the read byte limit\");\n\t\t\ttruncatedBy = \"bytes\";\n\t\t\tbreak;\n\t\t}\n\t\tselected.push(line);\n\t\tbytes = nextBytes;\n\t}\n\n\tif (truncatedBy === null && selected.length < lines.length) truncatedBy = \"lines\";\n\tif (truncatedBy === null) return window;\n\treturn {\n\t\t...window,\n\t\tcontent: selected.join(\"\\n\"),\n\t\tendLine: window.startLine + selected.length - 1,\n\t\ttruncatedBy,\n\t};\n}\n\nfunction formatByteLimit(maxBytes: number): string {\n\tif (maxBytes % 1024 === 0) return `${maxBytes / 1024} KiB`;\n\treturn `${maxBytes} bytes`;\n}\n\nfunction appendContinuation(window: TextWindow, maxBytes: number): string {\n\tif (window.truncatedBy === null) return window.content;\n\tconst nextOffset = window.endLine + 1;\n\tif (window.truncatedBy === \"limit\") {\n\t\tconst remaining = window.totalLines - window.endLine;\n\t\treturn `${window.content}\\n\\n[${remaining} more lines in file. Use offset=${nextOffset} to continue.]`;\n\t}\n\tconst reason = window.truncatedBy === \"bytes\" ? ` (${formatByteLimit(maxBytes)} limit)` : \"\";\n\treturn `${window.content}\\n\\n[Showing lines ${window.startLine}-${window.endLine} of ${window.totalLines}${reason}. Use offset=${nextOffset} to continue.]`;\n}\n\nfunction containsNulByte(buffer: Buffer): boolean {\n\tconst sampleLength = Math.min(buffer.length, 8 * 1024);\n\tfor (let index = 0; index < sampleLength; index++) {\n\t\tif (buffer[index] === 0) return true;\n\t}\n\treturn false;\n}\n\nexport function createReadTool(allowedRoot: string, options: ReadToolOptions = {}): ReadTool {\n\tconst maxLines = options.maxLines ?? DEFAULT_READ_MAX_LINES;\n\tconst maxBytes = options.maxBytes ?? DEFAULT_READ_MAX_BYTES;\n\tassertPositiveInteger(\"maxLines\", maxLines);\n\tassertPositiveInteger(\"maxBytes\", maxBytes);\n\n\treturn {\n\t\tname: \"read\",\n\t\tdescription: \"Read a UTF-8 text file inside the allowed root. Use offset and limit for large files.\",\n\t\tparameters: readParameters,\n\t\tasync execute(_toolCallId, parameters, signal): Promise<ToolResultContent[]> {\n\t\t\tif (signal?.aborted) throw new Error(\"Operation aborted\");\n\t\t\tif (parameters.path.length === 0) throw new Error(\"path must not be empty\");\n\t\t\tassertPositiveInteger(\"offset\", parameters.offset);\n\t\t\tassertPositiveInteger(\"limit\", parameters.limit);\n\t\t\tconst absolutePath = await resolveAllowedFilePath(parameters.path, allowedRoot);\n\t\t\tif (signal?.aborted) throw new Error(\"Operation aborted\");\n\t\t\tconst buffer = await readFile(absolutePath);\n\t\t\tif (containsNulByte(buffer)) {\n\t\t\t\tthrow new Error(\"Binary files are not supported by read\");\n\t\t\t}\n\t\t\tconst userWindow = selectUserWindow(\n\t\t\t\tsplitLines(buffer.toString(\"utf8\")),\n\t\t\t\tparameters.offset ?? 1,\n\t\t\t\tparameters.limit,\n\t\t\t);\n\t\t\tconst boundedWindow = applyOutputLimits(userWindow, maxLines, maxBytes);\n\t\t\treturn [{ type: \"text\", text: appendContinuation(boundedWindow, maxBytes) }];\n\t\t},\n\t};\n}\n"]}
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/core/tools/read.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC","sourcesContent":["export * from \"@di-code/builtins\";\n"]}

package/dist/core/tools/write.d.ts

@@ -1,17 +1,2 @@
-import type { AgentTool } from "@di-code/agent";
-import { type Static, type ToolResultContent, Type } from "@di-code/ai";
-export declare const writeParameters: Type.TObject<{
-    path: Type.TString;
-    content: Type.TString;
-}>;
-export type WriteParameters = Static<typeof writeParameters>;
-export interface WriteOperations {
-    mkdir(directory: string): Promise<void>;
-    writeFile(filePath: string, content: string): Promise<void>;
-}
-export interface WriteToolOptions {
-    readonly operations?: WriteOperations;
-}
-export type WriteTool = AgentTool<typeof writeParameters, ToolResultContent[]>;
-export declare function createWriteTool(allowedRoot: string, options?: WriteToolOptions): WriteTool;
+export * from "@di-code/builtins";
 //# sourceMappingURL=write.d.ts.map

package/dist/core/tools/write.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/core/tools/write.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,iBAAiB,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAIxE,eAAO,MAAM,eAAe;;;EAG1B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC/B,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;CACtC;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,eAAe,EAAE,iBAAiB,EAAE,CAAC,CAAC;AAe/E,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAwB9F"}
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/core/tools/write.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/core/tools/write.js

@@ -1,45 +1,2 @@
-import { mkdir as fsMkdir, writeFile as fsWriteFile } from "node:fs/promises";
-import { dirname } from "node:path";
-import { Type } from "@di-code/ai";
-import { withFileMutationQueue } from "./file-mutation-queue.js";
-import { resolveAllowedMutationPath } from "./path-boundary.js";
-export const writeParameters = Type.Object({
-    path: Type.String({ minLength: 1 }),
-    content: Type.String(),
-});
-const defaultWriteOperations = {
-    async mkdir(directory) {
-        await fsMkdir(directory, { recursive: true });
-    },
-    async writeFile(filePath, content) {
-        await fsWriteFile(filePath, content, "utf8");
-    },
-};
-function throwIfAborted(signal) {
-    if (signal?.aborted)
-        throw new Error("Operation aborted");
-}
-export function createWriteTool(allowedRoot, options = {}) {
-    const operations = options.operations ?? defaultWriteOperations;
-    return {
-        name: "write",
-        description: "Create or completely overwrite a UTF-8 text file inside the allowed root.",
-        parameters: writeParameters,
-        async execute(_toolCallId, parameters, signal) {
-            throwIfAborted(signal);
-            if (parameters.path.length === 0)
-                throw new Error("path must not be empty");
-            const absolutePath = await resolveAllowedMutationPath(parameters.path, allowedRoot);
-            return withFileMutationQueue(absolutePath, async () => {
-                throwIfAborted(signal);
-                await operations.mkdir(dirname(absolutePath));
-                throwIfAborted(signal);
-                await operations.writeFile(absolutePath, parameters.content);
-                throwIfAborted(signal);
-                const bytes = Buffer.byteLength(parameters.content, "utf8");
-                return [{ type: "text", text: `Successfully wrote ${bytes} bytes to ${parameters.path}` }];
-            });
-        },
-    };
-}
+export * from "@di-code/builtins";
 //# sourceMappingURL=write.js.map

package/dist/core/tools/write.js.map

@@ -1 +1 @@
-{"version":3,"file":"write.js","sourceRoot":"","sources":["../../../src/core/tools/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAuC,IAAI,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEhE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACnC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAeH,MAAM,sBAAsB,GAAoB;IAC/C,KAAK,CAAC,KAAK,CAAC,SAAS;QACpB,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO;QAChC,MAAM,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;CACD,CAAC;AAEF,SAAS,cAAc,CAAC,MAA+B;IACtD,IAAI,MAAM,EAAE,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,UAA4B,EAAE;IAClF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,sBAAsB,CAAC;IAEhE,OAAO;QACN,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,2EAA2E;QACxF,UAAU,EAAE,eAAe;QAC3B,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM;YAC5C,cAAc,CAAC,MAAM,CAAC,CAAC;YACvB,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC5E,MAAM,YAAY,GAAG,MAAM,0BAA0B,CAAC,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAEpF,OAAO,qBAAqB,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE;gBACrD,cAAc,CAAC,MAAM,CAAC,CAAC;gBACvB,MAAM,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;gBAC9C,cAAc,CAAC,MAAM,CAAC,CAAC;gBACvB,MAAM,UAAU,CAAC,SAAS,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;gBAC7D,cAAc,CAAC,MAAM,CAAC,CAAC;gBAEvB,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC5D,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,KAAK,aAAa,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC5F,CAAC,CAAC,CAAC;QACJ,CAAC;KACD,CAAC;AACH,CAAC","sourcesContent":["import { mkdir as fsMkdir, writeFile as fsWriteFile } from \"node:fs/promises\";\nimport { dirname } from \"node:path\";\nimport type { AgentTool } from \"@di-code/agent\";\nimport { type Static, type ToolResultContent, Type } from \"@di-code/ai\";\nimport { withFileMutationQueue } from \"./file-mutation-queue.ts\";\nimport { resolveAllowedMutationPath } from \"./path-boundary.ts\";\n\nexport const writeParameters = Type.Object({\n\tpath: Type.String({ minLength: 1 }),\n\tcontent: Type.String(),\n});\n\nexport type WriteParameters = Static<typeof writeParameters>;\n\nexport interface WriteOperations {\n\tmkdir(directory: string): Promise<void>;\n\twriteFile(filePath: string, content: string): Promise<void>;\n}\n\nexport interface WriteToolOptions {\n\treadonly operations?: WriteOperations;\n}\n\nexport type WriteTool = AgentTool<typeof writeParameters, ToolResultContent[]>;\n\nconst defaultWriteOperations: WriteOperations = {\n\tasync mkdir(directory) {\n\t\tawait fsMkdir(directory, { recursive: true });\n\t},\n\tasync writeFile(filePath, content) {\n\t\tawait fsWriteFile(filePath, content, \"utf8\");\n\t},\n};\n\nfunction throwIfAborted(signal: AbortSignal | undefined): void {\n\tif (signal?.aborted) throw new Error(\"Operation aborted\");\n}\n\nexport function createWriteTool(allowedRoot: string, options: WriteToolOptions = {}): WriteTool {\n\tconst operations = options.operations ?? defaultWriteOperations;\n\n\treturn {\n\t\tname: \"write\",\n\t\tdescription: \"Create or completely overwrite a UTF-8 text file inside the allowed root.\",\n\t\tparameters: writeParameters,\n\t\tasync execute(_toolCallId, parameters, signal): Promise<ToolResultContent[]> {\n\t\t\tthrowIfAborted(signal);\n\t\t\tif (parameters.path.length === 0) throw new Error(\"path must not be empty\");\n\t\t\tconst absolutePath = await resolveAllowedMutationPath(parameters.path, allowedRoot);\n\n\t\t\treturn withFileMutationQueue(absolutePath, async () => {\n\t\t\t\tthrowIfAborted(signal);\n\t\t\t\tawait operations.mkdir(dirname(absolutePath));\n\t\t\t\tthrowIfAborted(signal);\n\t\t\t\tawait operations.writeFile(absolutePath, parameters.content);\n\t\t\t\tthrowIfAborted(signal);\n\n\t\t\t\tconst bytes = Buffer.byteLength(parameters.content, \"utf8\");\n\t\t\t\treturn [{ type: \"text\", text: `Successfully wrote ${bytes} bytes to ${parameters.path}` }];\n\t\t\t});\n\t\t},\n\t};\n}\n"]}
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../../src/core/tools/write.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC","sourcesContent":["export * from \"@di-code/builtins\";\n"]}

package/dist/entry.js

@@ -1,16 +1,15 @@
 #!/usr/bin/env node
-import { homedir } from "node:os";
-import { join } from "node:path";
 import { createInterface } from "node:readline/promises";
-import { ProcessTerminal } from "@di-code/tui";
+import { redactSensitiveText } from "@di-code/plugin-runtime";
 import packageMetadata from "../package.json" with { type: "json" };
-import { runMain } from "./main.js";
-import { runProviderOnboarding, shouldStartProviderOnboarding } from "./provider-onboarding.js";
-import { loadStartupConfiguration, resolveStartupArgs, resolveStartupRuntime } from "./startup.js";
+import { parseCliArgs } from "./cli.js";
+import { runMinimalProfile } from "./main.js";
+import { resolveStartupArgs } from "./startup.js";
+import { runWebCommand } from "./web-command.js";
 async function promptProjectTrust(cwd) {
     const readline = createInterface({ input: process.stdin, output: process.stdout });
     try {
-        const answer = await readline.question(`Trust project-local Skills, plugins, and extensions in ${cwd}? [y/N] `);
+        const answer = await readline.question(`Trust project-local Skills and MCP configuration in ${cwd}? [y/N] `);
         return /^(?:y|yes)$/i.test(answer.trim());
     }
     finally {
@@ -18,29 +17,32 @@ async function promptProjectTrust(cwd) {
     }
 }
 try {
-    const configuration = await loadStartupConfiguration(process.cwd());
-    process.exitCode = await runMain(resolveStartupArgs(process.argv.slice(2)), {
-        version: packageMetadata.version,
-        createRuntime: (command) => {
-            const isInteractiveTerminal = Boolean(process.stdin.isTTY && process.stdout.isTTY);
-            if (shouldStartProviderOnboarding(command, isInteractiveTerminal, configuration)) {
-                return runProviderOnboarding({
-                    configuration,
-                    terminal: new ProcessTerminal(),
-                    agentDir: join(homedir(), ".di-code"),
-                });
-            }
-            return resolveStartupRuntime(configuration.environment, configuration.providers, configuration.defaults);
-        },
-        startupConfiguration: configuration,
-        isInteractiveTerminal: Boolean(process.stdin.isTTY && process.stdout.isTTY),
-        promptProjectTrust,
-        stdout: (text) => process.stdout.write(text),
-        stderr: (text) => process.stderr.write(text),
-    });
+    const rawArgs = process.argv.slice(2);
+    const args = resolveStartupArgs(rawArgs);
+    const command = parseCliArgs(args);
+    if (command.kind === "web") {
+        process.exitCode = await runWebCommand(command);
+    }
+    else {
+        const isInteractiveTerminal = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+        process.exitCode = await runMinimalProfile(args, {
+            version: packageMetadata.version,
+            stdout: (text) => process.stdout.write(text),
+            stderr: (text) => process.stderr.write(text),
+            interactive: { isInteractiveTerminal, promptProjectTrust },
+            onRuntimeEvent: (event) => {
+                if (process.env.DI_CODE_TRACE_PLUGINS === "1")
+                    process.stderr.write(`${JSON.stringify(event)}\n`);
+            },
+            onSessionDisposed: () => {
+                if (process.env.DI_CODE_TRACE_PLUGINS === "1")
+                    process.stderr.write('{"type":"session_dispose"}\n');
+            },
+        });
+    }
 }
 catch (cause) {
-    const message = cause instanceof Error ? cause.message : "Unknown startup error";
+    const message = redactSensitiveText(cause instanceof Error ? cause.message : "Unknown startup error");
     process.stderr.write(`${message}\n`);
     process.exitCode = 1;
 }

package/dist/entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,eAAe,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAChG,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAEnG,KAAK,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,0DAA0D,GAAG,UAAU,CAAC,CAAC;QAChH,OAAO,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;YAAS,CAAC;QACV,QAAQ,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;AACF,CAAC;AAED,IAAI,CAAC;IACJ,MAAM,aAAa,GAAG,MAAM,wBAAwB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACpE,OAAO,CAAC,QAAQ,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;QAC3E,OAAO,EAAE,eAAe,CAAC,OAAO;QAChC,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE;YAC1B,MAAM,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnF,IAAI,6BAA6B,CAAC,OAAO,EAAE,qBAAqB,EAAE,aAAa,CAAC,EAAE,CAAC;gBAClF,OAAO,qBAAqB,CAAC;oBAC5B,aAAa;oBACb,QAAQ,EAAE,IAAI,eAAe,EAAE;oBAC/B,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC;iBACrC,CAAC,CAAC;YACJ,CAAC;YACD,OAAO,qBAAqB,CAAC,aAAa,CAAC,WAAW,EAAE,aAAa,CAAC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC1G,CAAC;QACD,oBAAoB,EAAE,aAAa;QACnC,qBAAqB,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3E,kBAAkB;QAClB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAC5C,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;KAC5C,CAAC,CAAC;AACJ,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IAChB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC;IACjF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACrC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACtB,CAAC","sourcesContent":["#!/usr/bin/env node\n\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { createInterface } from \"node:readline/promises\";\nimport { ProcessTerminal } from \"@di-code/tui\";\nimport packageMetadata from \"../package.json\" with { type: \"json\" };\nimport { runMain } from \"./main.ts\";\nimport { runProviderOnboarding, shouldStartProviderOnboarding } from \"./provider-onboarding.ts\";\nimport { loadStartupConfiguration, resolveStartupArgs, resolveStartupRuntime } from \"./startup.ts\";\n\nasync function promptProjectTrust(cwd: string): Promise<boolean> {\n\tconst readline = createInterface({ input: process.stdin, output: process.stdout });\n\ttry {\n\t\tconst answer = await readline.question(`Trust project-local Skills, plugins, and extensions in ${cwd}? [y/N] `);\n\t\treturn /^(?:y|yes)$/i.test(answer.trim());\n\t} finally {\n\t\treadline.close();\n\t}\n}\n\ntry {\n\tconst configuration = await loadStartupConfiguration(process.cwd());\n\tprocess.exitCode = await runMain(resolveStartupArgs(process.argv.slice(2)), {\n\t\tversion: packageMetadata.version,\n\t\tcreateRuntime: (command) => {\n\t\t\tconst isInteractiveTerminal = Boolean(process.stdin.isTTY && process.stdout.isTTY);\n\t\t\tif (shouldStartProviderOnboarding(command, isInteractiveTerminal, configuration)) {\n\t\t\t\treturn runProviderOnboarding({\n\t\t\t\t\tconfiguration,\n\t\t\t\t\tterminal: new ProcessTerminal(),\n\t\t\t\t\tagentDir: join(homedir(), \".di-code\"),\n\t\t\t\t});\n\t\t\t}\n\t\t\treturn resolveStartupRuntime(configuration.environment, configuration.providers, configuration.defaults);\n\t\t},\n\t\tstartupConfiguration: configuration,\n\t\tisInteractiveTerminal: Boolean(process.stdin.isTTY && process.stdout.isTTY),\n\t\tpromptProjectTrust,\n\t\tstdout: (text) => process.stdout.write(text),\n\t\tstderr: (text) => process.stderr.write(text),\n\t});\n} catch (cause) {\n\tconst message = cause instanceof Error ? cause.message : \"Unknown startup error\";\n\tprocess.stderr.write(`${message}\\n`);\n\tprocess.exitCode = 1;\n}\n"]}
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,eAAe,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,KAAK,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,uDAAuD,GAAG,UAAU,CAAC,CAAC;QAC7G,OAAO,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;YAAS,CAAC;QACV,QAAQ,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;AACF,CAAC;AAED,IAAI,CAAC;IACJ,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC5B,OAAO,CAAC,QAAQ,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;SAAM,CAAC;QACP,MAAM,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnF,OAAO,CAAC,QAAQ,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE;YAChD,OAAO,EAAE,eAAe,CAAC,OAAO;YAChC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YAC5C,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YAC5C,WAAW,EAAE,EAAE,qBAAqB,EAAE,kBAAkB,EAAE;YAC1D,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE;gBACzB,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,GAAG;oBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnG,CAAC;YACD,iBAAiB,EAAE,GAAG,EAAE;gBACvB,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,GAAG;oBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;YACrG,CAAC;SACD,CAAC,CAAC;IACJ,CAAC;AACF,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IAChB,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC;IACtG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACrC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACtB,CAAC","sourcesContent":["#!/usr/bin/env node\n\nimport { createInterface } from \"node:readline/promises\";\nimport { redactSensitiveText } from \"@di-code/plugin-runtime\";\nimport packageMetadata from \"../package.json\" with { type: \"json\" };\nimport { parseCliArgs } from \"./cli.ts\";\nimport { runMinimalProfile } from \"./main.ts\";\nimport { resolveStartupArgs } from \"./startup.ts\";\nimport { runWebCommand } from \"./web-command.ts\";\n\nasync function promptProjectTrust(cwd: string): Promise<boolean> {\n\tconst readline = createInterface({ input: process.stdin, output: process.stdout });\n\ttry {\n\t\tconst answer = await readline.question(`Trust project-local Skills and MCP configuration in ${cwd}? [y/N] `);\n\t\treturn /^(?:y|yes)$/i.test(answer.trim());\n\t} finally {\n\t\treadline.close();\n\t}\n}\n\ntry {\n\tconst rawArgs = process.argv.slice(2);\n\tconst args = resolveStartupArgs(rawArgs);\n\tconst command = parseCliArgs(args);\n\tif (command.kind === \"web\") {\n\t\tprocess.exitCode = await runWebCommand(command);\n\t} else {\n\t\tconst isInteractiveTerminal = Boolean(process.stdin.isTTY && process.stdout.isTTY);\n\t\tprocess.exitCode = await runMinimalProfile(args, {\n\t\t\tversion: packageMetadata.version,\n\t\t\tstdout: (text) => process.stdout.write(text),\n\t\t\tstderr: (text) => process.stderr.write(text),\n\t\t\tinteractive: { isInteractiveTerminal, promptProjectTrust },\n\t\t\tonRuntimeEvent: (event) => {\n\t\t\t\tif (process.env.DI_CODE_TRACE_PLUGINS === \"1\") process.stderr.write(`${JSON.stringify(event)}\\n`);\n\t\t\t},\n\t\t\tonSessionDisposed: () => {\n\t\t\t\tif (process.env.DI_CODE_TRACE_PLUGINS === \"1\") process.stderr.write('{\"type\":\"session_dispose\"}\\n');\n\t\t\t},\n\t\t});\n\t}\n} catch (cause) {\n\tconst message = redactSensitiveText(cause instanceof Error ? cause.message : \"Unknown startup error\");\n\tprocess.stderr.write(`${message}\\n`);\n\tprocess.exitCode = 1;\n}\n"]}

package/dist/index.d.ts

@@ -6,9 +6,12 @@ export * from "./core/session/session-storage.ts";
 export * from "./core/session/types.ts";
 export * from "./core/session.ts";
 export * from "./core/system-prompt.ts";
-export * from "./extensions/index.ts";
 export * from "./mcp/config.ts";
-export * from "./mcp/loader.ts";
+export * from "./mcp/entries.ts";
 export * from "./mcp/tool-adapter.ts";
-export * from "./plugins/index.ts";
+export { apiVersion as rpcClientSdkApiVersion, apply as rpcClientSdkApply, name as rpcClientSdkName, type RpcClientSdk, rpcClientSdkKey, version as rpcClientSdkVersion, } from "./rpc-client-sdk-entry.ts";
+export { pluginInventory } from "./runtime/plugin-inventory-entry.ts";
+export { type PluginInventoryService, pluginInventoryKey } from "./runtime/plugin-inventory-service.ts";
+export { type PluginManagementAction, type PluginManagementCommand, type PluginManagerEntryConfig, type PluginManagerService, pluginManager, pluginManagerKey, } from "./runtime/plugin-manager-entry.ts";
+export { type PluginObservationService, pluginDumpComposition, pluginDumpCompositionKey, pluginTrace, pluginTraceKey, } from "./runtime/plugin-observability-entry.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EACN,UAAU,IAAI,sBAAsB,EACpC,KAAK,IAAI,iBAAiB,EAC1B,IAAI,IAAI,gBAAgB,EACxB,KAAK,YAAY,EACjB,eAAe,EACf,OAAO,IAAI,mBAAmB,GAC9B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,KAAK,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AACxG,OAAO,EACN,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,aAAa,EACb,gBAAgB,GAChB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACN,KAAK,wBAAwB,EAC7B,qBAAqB,EACrB,wBAAwB,EACxB,WAAW,EACX,cAAc,GACd,MAAM,yCAAyC,CAAC"}

package/dist/index.js

@@ -6,9 +6,12 @@ export * from "./core/session/session-storage.js";
 export * from "./core/session/types.js";
 export * from "./core/session.js";
 export * from "./core/system-prompt.js";
-export * from "./extensions/index.js";
 export * from "./mcp/config.js";
-export * from "./mcp/loader.js";
+export * from "./mcp/entries.js";
 export * from "./mcp/tool-adapter.js";
-export * from "./plugins/index.js";
+export { apiVersion as rpcClientSdkApiVersion, apply as rpcClientSdkApply, name as rpcClientSdkName, rpcClientSdkKey, version as rpcClientSdkVersion, } from "./rpc-client-sdk-entry.js";
+export { pluginInventory } from "./runtime/plugin-inventory-entry.js";
+export { pluginInventoryKey } from "./runtime/plugin-inventory-service.js";
+export { pluginManager, pluginManagerKey, } from "./runtime/plugin-manager-entry.js";
+export { pluginDumpComposition, pluginDumpCompositionKey, pluginTrace, pluginTraceKey, } from "./runtime/plugin-observability-entry.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC","sourcesContent":["export * from \"./cli.ts\";\nexport * from \"./core/context-builder.ts\";\nexport * from \"./core/resources/index.ts\";\nexport * from \"./core/session/session-manager.ts\";\nexport * from \"./core/session/session-storage.ts\";\nexport * from \"./core/session/types.ts\";\nexport * from \"./core/session.ts\";\nexport * from \"./core/system-prompt.ts\";\nexport * from \"./extensions/index.ts\";\nexport * from \"./mcp/config.ts\";\nexport * from \"./mcp/loader.ts\";\nexport * from \"./mcp/tool-adapter.ts\";\nexport * from \"./plugins/index.ts\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EACN,UAAU,IAAI,sBAAsB,EACpC,KAAK,IAAI,iBAAiB,EAC1B,IAAI,IAAI,gBAAgB,EAExB,eAAe,EACf,OAAO,IAAI,mBAAmB,GAC9B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAA+B,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AACxG,OAAO,EAKN,aAAa,EACb,gBAAgB,GAChB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAEN,qBAAqB,EACrB,wBAAwB,EACxB,WAAW,EACX,cAAc,GACd,MAAM,yCAAyC,CAAC","sourcesContent":["export * from \"./cli.ts\";\nexport * from \"./core/context-builder.ts\";\nexport * from \"./core/resources/index.ts\";\nexport * from \"./core/session/session-manager.ts\";\nexport * from \"./core/session/session-storage.ts\";\nexport * from \"./core/session/types.ts\";\nexport * from \"./core/session.ts\";\nexport * from \"./core/system-prompt.ts\";\nexport * from \"./mcp/config.ts\";\nexport * from \"./mcp/entries.ts\";\nexport * from \"./mcp/tool-adapter.ts\";\nexport {\n\tapiVersion as rpcClientSdkApiVersion,\n\tapply as rpcClientSdkApply,\n\tname as rpcClientSdkName,\n\ttype RpcClientSdk,\n\trpcClientSdkKey,\n\tversion as rpcClientSdkVersion,\n} from \"./rpc-client-sdk-entry.ts\";\nexport { pluginInventory } from \"./runtime/plugin-inventory-entry.ts\";\nexport { type PluginInventoryService, pluginInventoryKey } from \"./runtime/plugin-inventory-service.ts\";\nexport {\n\ttype PluginManagementAction,\n\ttype PluginManagementCommand,\n\ttype PluginManagerEntryConfig,\n\ttype PluginManagerService,\n\tpluginManager,\n\tpluginManagerKey,\n} from \"./runtime/plugin-manager-entry.ts\";\nexport {\n\ttype PluginObservationService,\n\tpluginDumpComposition,\n\tpluginDumpCompositionKey,\n\tpluginTrace,\n\tpluginTraceKey,\n} from \"./runtime/plugin-observability-entry.ts\";\n"]}

package/dist/interactive/builtin.d.ts

@@ -0,0 +1,17 @@
+import type { PluginFrontendController, PluginTerminalFrontendHost } from "@di-code/plugin-runtime";
+import { type InteractiveModeOptions } from "../modes/interactive.ts";
+export interface BuiltinInteractiveFrontendOptions extends Omit<InteractiveModeOptions, "tui"> {
+    readonly initialPrompt?: string;
+}
+/** The default ANSI frontend. It owns only the terminal facade supplied by the host. */
+export declare class BuiltinInteractiveFrontend {
+    readonly id: "builtin";
+    private readonly options;
+    private mode?;
+    private resolveStart?;
+    constructor(options: BuiltinInteractiveFrontendOptions);
+    start(_controller: PluginFrontendController, terminal: PluginTerminalFrontendHost): Promise<void>;
+    dispose(): Promise<void>;
+}
+export declare function createBuiltinInteractiveFrontend(options: BuiltinInteractiveFrontendOptions): BuiltinInteractiveFrontend;
+//# sourceMappingURL=builtin.d.ts.map

package/dist/interactive/builtin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin.d.ts","sourceRoot":"","sources":["../../src/interactive/builtin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAEpG,OAAO,EAAmB,KAAK,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEvF,MAAM,WAAW,iCAAkC,SAAQ,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC;IAC7F,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,wFAAwF;AACxF,qBAAa,0BAA0B;IACtC,QAAQ,CAAC,EAAE,EAAG,SAAS,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,IAAI,CAAC,CAAkB;IAC/B,OAAO,CAAC,YAAY,CAAC,CAAa;gBAEtB,OAAO,EAAE,iCAAiC;IAIhD,KAAK,CAAC,WAAW,EAAE,wBAAwB,EAAE,QAAQ,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBjG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAM9B;AAED,wBAAgB,gCAAgC,CAC/C,OAAO,EAAE,iCAAiC,GACxC,0BAA0B,CAE5B"}

package/dist/interactive/builtin.js

@@ -0,0 +1,47 @@
+import { TUI } from "@di-code/tui";
+import { InteractiveMode } from "../modes/interactive.js";
+/** The default ANSI frontend. It owns only the terminal facade supplied by the host. */
+export class BuiltinInteractiveFrontend {
+    id = "builtin";
+    options;
+    mode;
+    resolveStart;
+    constructor(options) {
+        this.options = options;
+    }
+    async start(_controller, terminal) {
+        if (this.mode)
+            throw new Error("Builtin interactive frontend is already started.");
+        await new Promise((resolve, reject) => {
+            this.resolveStart = resolve;
+            const onExit = this.options.onExit;
+            this.mode = new InteractiveMode({
+                ...this.options,
+                tui: new TUI(terminal),
+                onExit: () => {
+                    onExit?.();
+                    this.resolveStart = undefined;
+                    resolve();
+                },
+            });
+            try {
+                this.mode.start(this.options.initialPrompt);
+            }
+            catch (cause) {
+                this.mode = undefined;
+                this.resolveStart = undefined;
+                reject(cause);
+            }
+        });
+    }
+    async dispose() {
+        this.mode?.stop();
+        this.mode = undefined;
+        this.resolveStart?.();
+        this.resolveStart = undefined;
+    }
+}
+export function createBuiltinInteractiveFrontend(options) {
+    return new BuiltinInteractiveFrontend(options);
+}
+//# sourceMappingURL=builtin.js.map

package/dist/interactive/builtin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin.js","sourceRoot":"","sources":["../../src/interactive/builtin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,eAAe,EAA+B,MAAM,yBAAyB,CAAC;AAMvF,wFAAwF;AACxF,MAAM,OAAO,0BAA0B;IAC7B,EAAE,GAAG,SAAkB,CAAC;IAChB,OAAO,CAAoC;IACpD,IAAI,CAAmB;IACvB,YAAY,CAAc;IAElC,YAAY,OAA0C;QACrD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,WAAqC,EAAE,QAAoC;QACtF,IAAI,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACnF,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YACnC,IAAI,CAAC,IAAI,GAAG,IAAI,eAAe,CAAC;gBAC/B,GAAG,IAAI,CAAC,OAAO;gBACf,GAAG,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAC;gBACtB,MAAM,EAAE,GAAG,EAAE;oBACZ,MAAM,EAAE,EAAE,CAAC;oBACX,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;oBAC9B,OAAO,EAAE,CAAC;gBACX,CAAC;aACD,CAAC,CAAC;YACH,IAAI,CAAC;gBACJ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;gBACtB,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;gBAC9B,MAAM,CAAC,KAAK,CAAC,CAAC;YACf,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;QACtB,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;IAC/B,CAAC;CACD;AAED,MAAM,UAAU,gCAAgC,CAC/C,OAA0C;IAE1C,OAAO,IAAI,0BAA0B,CAAC,OAAO,CAAC,CAAC;AAChD,CAAC","sourcesContent":["import type { PluginFrontendController, PluginTerminalFrontendHost } from \"@di-code/plugin-runtime\";\nimport { TUI } from \"@di-code/tui\";\nimport { InteractiveMode, type InteractiveModeOptions } from \"../modes/interactive.ts\";\n\nexport interface BuiltinInteractiveFrontendOptions extends Omit<InteractiveModeOptions, \"tui\"> {\n\treadonly initialPrompt?: string;\n}\n\n/** The default ANSI frontend. It owns only the terminal facade supplied by the host. */\nexport class BuiltinInteractiveFrontend {\n\treadonly id = \"builtin\" as const;\n\tprivate readonly options: BuiltinInteractiveFrontendOptions;\n\tprivate mode?: InteractiveMode;\n\tprivate resolveStart?: () => void;\n\n\tconstructor(options: BuiltinInteractiveFrontendOptions) {\n\t\tthis.options = options;\n\t}\n\n\tasync start(_controller: PluginFrontendController, terminal: PluginTerminalFrontendHost): Promise<void> {\n\t\tif (this.mode) throw new Error(\"Builtin interactive frontend is already started.\");\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tthis.resolveStart = resolve;\n\t\t\tconst onExit = this.options.onExit;\n\t\t\tthis.mode = new InteractiveMode({\n\t\t\t\t...this.options,\n\t\t\t\ttui: new TUI(terminal),\n\t\t\t\tonExit: () => {\n\t\t\t\t\tonExit?.();\n\t\t\t\t\tthis.resolveStart = undefined;\n\t\t\t\t\tresolve();\n\t\t\t\t},\n\t\t\t});\n\t\t\ttry {\n\t\t\t\tthis.mode.start(this.options.initialPrompt);\n\t\t\t} catch (cause) {\n\t\t\t\tthis.mode = undefined;\n\t\t\t\tthis.resolveStart = undefined;\n\t\t\t\treject(cause);\n\t\t\t}\n\t\t});\n\t}\n\n\tasync dispose(): Promise<void> {\n\t\tthis.mode?.stop();\n\t\tthis.mode = undefined;\n\t\tthis.resolveStart?.();\n\t\tthis.resolveStart = undefined;\n\t}\n}\n\nexport function createBuiltinInteractiveFrontend(\n\toptions: BuiltinInteractiveFrontendOptions,\n): BuiltinInteractiveFrontend {\n\treturn new BuiltinInteractiveFrontend(options);\n}\n"]}

package/dist/interactive/controller.d.ts

@@ -0,0 +1,85 @@
+import type { ImageContent } from "@di-code/ai";
+import type { PluginUiContributions } from "@di-code/plugin-runtime";
+import type { AgentSession, AgentSessionEvent } from "../core/session.ts";
+import { type InteractiveState } from "../modes/interactive-state.ts";
+import type { CodingAgentPluginHost } from "../plugins/runtime-host.ts";
+export type InteractiveInput = string | {
+    readonly text: string;
+    readonly images?: readonly ImageContent[];
+};
+export interface InteractiveSessionChoice {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+    open(): AgentSession | Promise<AgentSession>;
+}
+export interface InteractiveControllerState extends InteractiveState {
+    readonly model: string;
+    readonly provider: string;
+    readonly sessionId: string;
+    readonly streaming: boolean;
+    /** Child runs are host-owned and expose no Agent or Session internals to a frontend. */
+    readonly subagents: readonly {
+        readonly id: string;
+        readonly status: import("@di-code/plugin-runtime").SubagentStatus;
+    }[];
+}
+export type InteractiveViewEvent = {
+    readonly type: "state";
+    readonly state: InteractiveControllerState;
+} | {
+    readonly type: "session_event";
+    readonly event: AgentSessionEvent;
+} | {
+    readonly type: "diagnostic";
+    readonly message: string;
+} | {
+    readonly type: "exit";
+    readonly reason: "user" | "error";
+};
+export type InteractiveControllerListener = (event: InteractiveViewEvent) => void;
+export interface InteractiveControllerOptions {
+    readonly session: AgentSession;
+    readonly sessions?: readonly InteractiveSessionChoice[];
+    readonly runtimePluginHost?: CodingAgentPluginHost;
+}
+/** Product-layer controller shared by the builtin TUI and future frontends. */
+export declare class InteractiveController {
+    private session;
+    private readonly sessionChoices;
+    private readonly runtimePluginHost?;
+    private readonly projection;
+    private readonly listeners;
+    private unsubscribeSession?;
+    private activeAbort?;
+    private promptActive;
+    private switching;
+    private compactionActive;
+    private queue;
+    private lastRetryInput?;
+    private disposed;
+    constructor(options: InteractiveControllerOptions);
+    get state(): InteractiveControllerState;
+    /** Restricted panel data and result formatters supplied by active plugin scopes. */
+    get ui(): PluginUiContributions;
+    subscribe(listener: InteractiveControllerListener): {
+        dispose(): void;
+    };
+    submit(input: InteractiveInput): Promise<void>;
+    steer(input: InteractiveInput): void;
+    cancel(): void;
+    retry(): Promise<void>;
+    runCommand(name: string, args: string): Promise<void>;
+    selectModel(modelId: string): void;
+    openSession(sessionId: string): Promise<void>;
+    createSession(): Promise<void>;
+    requestCompaction(): Promise<void>;
+    dispose(): void;
+    disposeSubagents(): Promise<void>;
+    private steerAsync;
+    private subscribeSession;
+    private emitState;
+    private emit;
+    private reportError;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/interactive/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/interactive/controller.ts"],"names":[],"mappings":"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"}