@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/modes/interactive/prompt-image-attachments.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Submit-time scanning of prompt text for image file paths.
+ *
+ * Interactive mode attaches images referenced by path in the submitted prompt:
+ * clipboard paste inserts a temp-file path, the editor's autocomplete inserts
+ * `@`-mentions, and users hand-type paths. The path text stays in the message;
+ * matched images ride alongside as attachments. Callers gate on the current
+ * model's image support — for text-only models the paths stay plain text and
+ * the vision-capable `read` tool remains the fallback.
+ */
+import type { Api, ImageContent, Model } from "@hansjm10/volt-ai";
+export declare const MAX_PROMPT_IMAGE_ATTACHMENTS = 10;
+export interface PromptImageAttachments {
+    images: ImageContent[];
+    /** Absolute paths of attached images, in prompt order. */
+    attachedPaths: string[];
+    /** Image paths dropped because the attachment cap was reached. */
+    cappedPaths: string[];
+    /** Image paths that could not be loaded or resized under the size limit. */
+    failedPaths: string[];
+}
+/**
+ * Extract candidate path tokens from prompt text: double- or single-quoted
+ * segments (with optional `@` prefix, as inserted by autocomplete for paths
+ * containing spaces) and whitespace-separated bare tokens.
+ */
+export declare function extractPathTokens(text: string): string[];
+/**
+ * Scan prompt text for existing image files and load them as attachments,
+ * resized through the shared image pipeline. Returns null when the model does
+ * not accept images (leave the paths as plain text) or when nothing matched.
+ */
+export declare function collectPromptImageAttachments(text: string, cwd: string, model: Pick<Model<Api>, "input"> | undefined | null): Promise<PromptImageAttachments | null>;
+//# sourceMappingURL=prompt-image-attachments.d.ts.map

package/dist/modes/interactive/prompt-image-attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-image-attachments.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/prompt-image-attachments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAKlE,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAI/C,MAAM,WAAW,sBAAsB;IACtC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,kEAAkE;IAClE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAkCxD;AAiBD;;;;GAIG;AACH,wBAAsB,6BAA6B,CAClD,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GACjD,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAkDxC","sourcesContent":["/**\n * Submit-time scanning of prompt text for image file paths.\n *\n * Interactive mode attaches images referenced by path in the submitted prompt:\n * clipboard paste inserts a temp-file path, the editor's autocomplete inserts\n * `@`-mentions, and users hand-type paths. The path text stays in the message;\n * matched images ride alongside as attachments. Callers gate on the current\n * model's image support — for text-only models the paths stay plain text and\n * the vision-capable `read` tool remains the fallback.\n */\n\nimport { readFile, stat } from \"node:fs/promises\";\nimport type { Api, ImageContent, Model } from \"@hansjm10/volt-ai\";\nimport { resolveReadPathAsync } from \"../../core/tools/path-utils.ts\";\nimport { resizeImage } from \"../../utils/image-resize.ts\";\nimport { detectSupportedImageMimeTypeFromFile } from \"../../utils/mime.ts\";\n\nexport const MAX_PROMPT_IMAGE_ATTACHMENTS = 10;\n\nconst IMAGE_EXTENSION_PATTERN = /\\.(png|jpe?g|gif|webp)$/i;\n\nexport interface PromptImageAttachments {\n\timages: ImageContent[];\n\t/** Absolute paths of attached images, in prompt order. */\n\tattachedPaths: string[];\n\t/** Image paths dropped because the attachment cap was reached. */\n\tcappedPaths: string[];\n\t/** Image paths that could not be loaded or resized under the size limit. */\n\tfailedPaths: string[];\n}\n\n/**\n * Extract candidate path tokens from prompt text: double- or single-quoted\n * segments (with optional `@` prefix, as inserted by autocomplete for paths\n * containing spaces) and whitespace-separated bare tokens.\n */\nexport function extractPathTokens(text: string): string[] {\n\tconst tokens: string[] = [];\n\tlet i = 0;\n\twhile (i < text.length) {\n\t\tif (/\\s/.test(text[i])) {\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\t\tconst start = i;\n\t\tif (text[i] === \"@\") {\n\t\t\ti++;\n\t\t}\n\t\tconst quote = text[i] === '\"' || text[i] === \"'\" ? text[i] : undefined;\n\t\tif (quote) {\n\t\t\tconst end = text.indexOf(quote, i + 1);\n\t\t\tif (end !== -1) {\n\t\t\t\ttokens.push(text.slice(i + 1, end));\n\t\t\t\ti = end + 1;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\t\tlet j = i;\n\t\twhile (j < text.length && !/\\s/.test(text[j])) {\n\t\t\tj++;\n\t\t}\n\t\t// Strip the @ prefix from bare tokens; resolveToCwd also strips it, but\n\t\t// keeping tokens clean makes the path-likeness check below reliable.\n\t\tconst token = text.slice(start === i ? start : start + 1, j);\n\t\tif (token) {\n\t\t\ttokens.push(token);\n\t\t}\n\t\ti = j;\n\t}\n\treturn tokens;\n}\n\n/**\n * Whether a token is worth a filesystem check: path-shaped or carrying a\n * supported image extension. Keeps the scanner from stat'ing every word of\n * prose while still catching relative names like `screenshot.png`.\n */\nfunction isPathLikeToken(token: string): boolean {\n\treturn (\n\t\tIMAGE_EXTENSION_PATTERN.test(token) ||\n\t\ttoken.startsWith(\"/\") ||\n\t\ttoken.startsWith(\"~\") ||\n\t\ttoken.startsWith(\"./\") ||\n\t\ttoken.startsWith(\"../\")\n\t);\n}\n\n/**\n * Scan prompt text for existing image files and load them as attachments,\n * resized through the shared image pipeline. Returns null when the model does\n * not accept images (leave the paths as plain text) or when nothing matched.\n */\nexport async function collectPromptImageAttachments(\n\ttext: string,\n\tcwd: string,\n\tmodel: Pick<Model<Api>, \"input\"> | undefined | null,\n): Promise<PromptImageAttachments | null> {\n\tif (!model?.input.includes(\"image\")) {\n\t\treturn null;\n\t}\n\n\tconst seen = new Set<string>();\n\tconst result: PromptImageAttachments = { images: [], attachedPaths: [], cappedPaths: [], failedPaths: [] };\n\n\tfor (const token of extractPathTokens(text)) {\n\t\tif (!isPathLikeToken(token)) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst resolved = await resolveReadPathAsync(token, cwd);\n\t\tif (seen.has(resolved)) {\n\t\t\tcontinue;\n\t\t}\n\t\tseen.add(resolved);\n\n\t\tconst stats = await stat(resolved).catch(() => null);\n\t\tif (!stats?.isFile() || stats.size === 0) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst mimeType = await detectSupportedImageMimeTypeFromFile(resolved).catch(() => null);\n\t\tif (!mimeType) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (result.images.length >= MAX_PROMPT_IMAGE_ATTACHMENTS) {\n\t\t\tresult.cappedPaths.push(resolved);\n\t\t\tcontinue;\n\t\t}\n\n\t\ttry {\n\t\t\tconst content = await readFile(resolved);\n\t\t\tconst resized = await resizeImage(content, mimeType);\n\t\t\tif (!resized) {\n\t\t\t\tresult.failedPaths.push(resolved);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tresult.images.push({ type: \"image\", mimeType: resized.mimeType, data: resized.data });\n\t\t\tresult.attachedPaths.push(resolved);\n\t\t} catch {\n\t\t\tresult.failedPaths.push(resolved);\n\t\t}\n\t}\n\n\tif (result.images.length === 0 && result.failedPaths.length === 0) {\n\t\treturn null;\n\t}\n\treturn result;\n}\n"]}

package/dist/modes/interactive/prompt-image-attachments.js

@@ -0,0 +1,120 @@
+/**
+ * Submit-time scanning of prompt text for image file paths.
+ *
+ * Interactive mode attaches images referenced by path in the submitted prompt:
+ * clipboard paste inserts a temp-file path, the editor's autocomplete inserts
+ * `@`-mentions, and users hand-type paths. The path text stays in the message;
+ * matched images ride alongside as attachments. Callers gate on the current
+ * model's image support — for text-only models the paths stay plain text and
+ * the vision-capable `read` tool remains the fallback.
+ */
+import { readFile, stat } from "node:fs/promises";
+import { resolveReadPathAsync } from "../../core/tools/path-utils.js";
+import { resizeImage } from "../../utils/image-resize.js";
+import { detectSupportedImageMimeTypeFromFile } from "../../utils/mime.js";
+export const MAX_PROMPT_IMAGE_ATTACHMENTS = 10;
+const IMAGE_EXTENSION_PATTERN = /\.(png|jpe?g|gif|webp)$/i;
+/**
+ * Extract candidate path tokens from prompt text: double- or single-quoted
+ * segments (with optional `@` prefix, as inserted by autocomplete for paths
+ * containing spaces) and whitespace-separated bare tokens.
+ */
+export function extractPathTokens(text) {
+    const tokens = [];
+    let i = 0;
+    while (i < text.length) {
+        if (/\s/.test(text[i])) {
+            i++;
+            continue;
+        }
+        const start = i;
+        if (text[i] === "@") {
+            i++;
+        }
+        const quote = text[i] === '"' || text[i] === "'" ? text[i] : undefined;
+        if (quote) {
+            const end = text.indexOf(quote, i + 1);
+            if (end !== -1) {
+                tokens.push(text.slice(i + 1, end));
+                i = end + 1;
+                continue;
+            }
+        }
+        let j = i;
+        while (j < text.length && !/\s/.test(text[j])) {
+            j++;
+        }
+        // Strip the @ prefix from bare tokens; resolveToCwd also strips it, but
+        // keeping tokens clean makes the path-likeness check below reliable.
+        const token = text.slice(start === i ? start : start + 1, j);
+        if (token) {
+            tokens.push(token);
+        }
+        i = j;
+    }
+    return tokens;
+}
+/**
+ * Whether a token is worth a filesystem check: path-shaped or carrying a
+ * supported image extension. Keeps the scanner from stat'ing every word of
+ * prose while still catching relative names like `screenshot.png`.
+ */
+function isPathLikeToken(token) {
+    return (IMAGE_EXTENSION_PATTERN.test(token) ||
+        token.startsWith("/") ||
+        token.startsWith("~") ||
+        token.startsWith("./") ||
+        token.startsWith("../"));
+}
+/**
+ * Scan prompt text for existing image files and load them as attachments,
+ * resized through the shared image pipeline. Returns null when the model does
+ * not accept images (leave the paths as plain text) or when nothing matched.
+ */
+export async function collectPromptImageAttachments(text, cwd, model) {
+    if (!model?.input.includes("image")) {
+        return null;
+    }
+    const seen = new Set();
+    const result = { images: [], attachedPaths: [], cappedPaths: [], failedPaths: [] };
+    for (const token of extractPathTokens(text)) {
+        if (!isPathLikeToken(token)) {
+            continue;
+        }
+        const resolved = await resolveReadPathAsync(token, cwd);
+        if (seen.has(resolved)) {
+            continue;
+        }
+        seen.add(resolved);
+        const stats = await stat(resolved).catch(() => null);
+        if (!stats?.isFile() || stats.size === 0) {
+            continue;
+        }
+        const mimeType = await detectSupportedImageMimeTypeFromFile(resolved).catch(() => null);
+        if (!mimeType) {
+            continue;
+        }
+        if (result.images.length >= MAX_PROMPT_IMAGE_ATTACHMENTS) {
+            result.cappedPaths.push(resolved);
+            continue;
+        }
+        try {
+            const content = await readFile(resolved);
+            const resized = await resizeImage(content, mimeType);
+            if (!resized) {
+                result.failedPaths.push(resolved);
+                continue;
+            }
+            result.images.push({ type: "image", mimeType: resized.mimeType, data: resized.data });
+            result.attachedPaths.push(resolved);
+        }
+        catch {
+            result.failedPaths.push(resolved);
+        }
+    }
+    if (result.images.length === 0 && result.failedPaths.length === 0) {
+        return null;
+    }
+    return result;
+}
+//# sourceMappingURL=prompt-image-attachments.js.map

package/dist/modes/interactive/prompt-image-attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-image-attachments.js","sourceRoot":"","sources":["../../../src/modes/interactive/prompt-image-attachments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,oCAAoC,EAAE,MAAM,qBAAqB,CAAC;AAE3E,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAE/C,MAAM,uBAAuB,GAAG,0BAA0B,CAAC;AAY3D;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAY;IACzD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACxB,CAAC,EAAE,CAAC;YACJ,SAAS;QACV,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,CAAC;QAChB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACrB,CAAC,EAAE,CAAC;QACL,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACvE,IAAI,KAAK,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACvC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACpC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;gBACZ,SAAS;YACV,CAAC;QACF,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,CAAC,EAAE,CAAC;QACL,CAAC;QACD,wEAAwE;QACxE,qEAAqE;QACrE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7D,IAAI,KAAK,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;QACD,CAAC,GAAG,CAAC,CAAC;IACP,CAAC;IACD,OAAO,MAAM,CAAC;AAAA,CACd;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,KAAa,EAAW;IAChD,OAAO,CACN,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC;QACnC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QACrB,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QACrB,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QACtB,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CACvB,CAAC;AAAA,CACF;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAClD,IAAY,EACZ,GAAW,EACX,KAAmD,EACV;IACzC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAA2B,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAE3G,KAAK,MAAM,KAAK,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,SAAS;QACV,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACxD,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,SAAS;QACV,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEnB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC1C,SAAS;QACV,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,oCAAoC,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACxF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,SAAS;QACV,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,4BAA4B,EAAE,CAAC;YAC1D,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClC,SAAS;QACV,CAAC;QAED,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACzC,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACrD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACd,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAClC,SAAS;YACV,CAAC;YACD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACtF,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACR,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;IACF,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnE,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,MAAM,CAAC;AAAA,CACd","sourcesContent":["/**\n * Submit-time scanning of prompt text for image file paths.\n *\n * Interactive mode attaches images referenced by path in the submitted prompt:\n * clipboard paste inserts a temp-file path, the editor's autocomplete inserts\n * `@`-mentions, and users hand-type paths. The path text stays in the message;\n * matched images ride alongside as attachments. Callers gate on the current\n * model's image support — for text-only models the paths stay plain text and\n * the vision-capable `read` tool remains the fallback.\n */\n\nimport { readFile, stat } from \"node:fs/promises\";\nimport type { Api, ImageContent, Model } from \"@hansjm10/volt-ai\";\nimport { resolveReadPathAsync } from \"../../core/tools/path-utils.ts\";\nimport { resizeImage } from \"../../utils/image-resize.ts\";\nimport { detectSupportedImageMimeTypeFromFile } from \"../../utils/mime.ts\";\n\nexport const MAX_PROMPT_IMAGE_ATTACHMENTS = 10;\n\nconst IMAGE_EXTENSION_PATTERN = /\\.(png|jpe?g|gif|webp)$/i;\n\nexport interface PromptImageAttachments {\n\timages: ImageContent[];\n\t/** Absolute paths of attached images, in prompt order. */\n\tattachedPaths: string[];\n\t/** Image paths dropped because the attachment cap was reached. */\n\tcappedPaths: string[];\n\t/** Image paths that could not be loaded or resized under the size limit. */\n\tfailedPaths: string[];\n}\n\n/**\n * Extract candidate path tokens from prompt text: double- or single-quoted\n * segments (with optional `@` prefix, as inserted by autocomplete for paths\n * containing spaces) and whitespace-separated bare tokens.\n */\nexport function extractPathTokens(text: string): string[] {\n\tconst tokens: string[] = [];\n\tlet i = 0;\n\twhile (i < text.length) {\n\t\tif (/\\s/.test(text[i])) {\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\t\tconst start = i;\n\t\tif (text[i] === \"@\") {\n\t\t\ti++;\n\t\t}\n\t\tconst quote = text[i] === '\"' || text[i] === \"'\" ? text[i] : undefined;\n\t\tif (quote) {\n\t\t\tconst end = text.indexOf(quote, i + 1);\n\t\t\tif (end !== -1) {\n\t\t\t\ttokens.push(text.slice(i + 1, end));\n\t\t\t\ti = end + 1;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\t\tlet j = i;\n\t\twhile (j < text.length && !/\\s/.test(text[j])) {\n\t\t\tj++;\n\t\t}\n\t\t// Strip the @ prefix from bare tokens; resolveToCwd also strips it, but\n\t\t// keeping tokens clean makes the path-likeness check below reliable.\n\t\tconst token = text.slice(start === i ? start : start + 1, j);\n\t\tif (token) {\n\t\t\ttokens.push(token);\n\t\t}\n\t\ti = j;\n\t}\n\treturn tokens;\n}\n\n/**\n * Whether a token is worth a filesystem check: path-shaped or carrying a\n * supported image extension. Keeps the scanner from stat'ing every word of\n * prose while still catching relative names like `screenshot.png`.\n */\nfunction isPathLikeToken(token: string): boolean {\n\treturn (\n\t\tIMAGE_EXTENSION_PATTERN.test(token) ||\n\t\ttoken.startsWith(\"/\") ||\n\t\ttoken.startsWith(\"~\") ||\n\t\ttoken.startsWith(\"./\") ||\n\t\ttoken.startsWith(\"../\")\n\t);\n}\n\n/**\n * Scan prompt text for existing image files and load them as attachments,\n * resized through the shared image pipeline. Returns null when the model does\n * not accept images (leave the paths as plain text) or when nothing matched.\n */\nexport async function collectPromptImageAttachments(\n\ttext: string,\n\tcwd: string,\n\tmodel: Pick<Model<Api>, \"input\"> | undefined | null,\n): Promise<PromptImageAttachments | null> {\n\tif (!model?.input.includes(\"image\")) {\n\t\treturn null;\n\t}\n\n\tconst seen = new Set<string>();\n\tconst result: PromptImageAttachments = { images: [], attachedPaths: [], cappedPaths: [], failedPaths: [] };\n\n\tfor (const token of extractPathTokens(text)) {\n\t\tif (!isPathLikeToken(token)) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst resolved = await resolveReadPathAsync(token, cwd);\n\t\tif (seen.has(resolved)) {\n\t\t\tcontinue;\n\t\t}\n\t\tseen.add(resolved);\n\n\t\tconst stats = await stat(resolved).catch(() => null);\n\t\tif (!stats?.isFile() || stats.size === 0) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst mimeType = await detectSupportedImageMimeTypeFromFile(resolved).catch(() => null);\n\t\tif (!mimeType) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (result.images.length >= MAX_PROMPT_IMAGE_ATTACHMENTS) {\n\t\t\tresult.cappedPaths.push(resolved);\n\t\t\tcontinue;\n\t\t}\n\n\t\ttry {\n\t\t\tconst content = await readFile(resolved);\n\t\t\tconst resized = await resizeImage(content, mimeType);\n\t\t\tif (!resized) {\n\t\t\t\tresult.failedPaths.push(resolved);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tresult.images.push({ type: \"image\", mimeType: resized.mimeType, data: resized.data });\n\t\t\tresult.attachedPaths.push(resolved);\n\t\t} catch {\n\t\t\tresult.failedPaths.push(resolved);\n\t\t}\n\t}\n\n\tif (result.images.length === 0 && result.failedPaths.length === 0) {\n\t\treturn null;\n\t}\n\treturn result;\n}\n"]}

package/dist/modes/interactive/relay-stream-adapter.d.ts

@@ -0,0 +1,19 @@
+import type { Duplex } from "node:stream";
+import type { IrohBiStreamLike } from "../../core/rpc/iroh-transport.ts";
+export interface RelayedIrohStreamLike extends IrohBiStreamLike {
+    /** Close both directions; maps to socket.destroy(). */
+    close(reason?: string): void;
+    readonly closed: Promise<{
+        reason?: string;
+        error?: Error;
+    }>;
+}
+/**
+ * Wrap a relay unix-socket Duplex in the Iroh stream shape consumed by
+ * runIrohRemoteRpcMode. The adapter writes no close-reason trailer: the daemon
+ * owns close-reason signaling to the phone, so a TUI-initiated destroy
+ * surfaces as a generic closure (lease release/rekey closures are executed by
+ * the daemon with proper reasons).
+ */
+export declare function adaptRelaySocketToIrohStream(socket: Duplex): RelayedIrohStreamLike;
+//# sourceMappingURL=relay-stream-adapter.d.ts.map

package/dist/modes/interactive/relay-stream-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-stream-adapter.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/relay-stream-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,gBAAgB,EAAa,MAAM,kCAAkC,CAAC;AAEpF,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC9D,uDAAuD;IACvD,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;CAC7D;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAmGlF","sourcesContent":["import { Buffer } from \"node:buffer\";\nimport type { Duplex } from \"node:stream\";\nimport { DuplexWriteGate } from \"../../core/rpc/duplex-write-gate.ts\";\nimport type { IrohBiStreamLike, IrohBytes } from \"../../core/rpc/iroh-transport.ts\";\n\nexport interface RelayedIrohStreamLike extends IrohBiStreamLike {\n\t/** Close both directions; maps to socket.destroy(). */\n\tclose(reason?: string): void;\n\treadonly closed: Promise<{ reason?: string; error?: Error }>;\n}\n\n/**\n * Wrap a relay unix-socket Duplex in the Iroh stream shape consumed by\n * runIrohRemoteRpcMode. The adapter writes no close-reason trailer: the daemon\n * owns close-reason signaling to the phone, so a TUI-initiated destroy\n * surfaces as a generic closure (lease release/rekey closures are executed by\n * the daemon with proper reasons).\n */\nexport function adaptRelaySocketToIrohStream(socket: Duplex): RelayedIrohStreamLike {\n\tconst chunks: Buffer[] = [];\n\tconst readers: Array<{ resolve(value: IrohBytes | undefined): void; reject(error: Error): void }> = [];\n\tconst writeGate = new DuplexWriteGate(socket);\n\tlet ended = false;\n\tlet closeReason: string | undefined;\n\tlet socketError: Error | undefined;\n\tlet resolveClosed: (value: { reason?: string; error?: Error }) => void = () => {};\n\tconst closed = new Promise<{ reason?: string; error?: Error }>((resolve) => {\n\t\tresolveClosed = resolve;\n\t});\n\n\tconst flush = () => {\n\t\twhile (readers.length > 0 && (chunks.length > 0 || ended || socketError)) {\n\t\t\tconst reader = readers.shift();\n\t\t\tif (!reader) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst chunk = chunks.shift();\n\t\t\tif (chunk) {\n\t\t\t\treader.resolve(chunk);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (socketError) {\n\t\t\t\treader.reject(socketError);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\treader.resolve(undefined);\n\t\t}\n\t};\n\n\tsocket.on(\"data\", (chunk: Buffer) => {\n\t\tchunks.push(Buffer.from(chunk));\n\t\tflush();\n\t});\n\tsocket.on(\"end\", () => {\n\t\tended = true;\n\t\tflush();\n\t});\n\tsocket.on(\"error\", (error: Error) => {\n\t\tsocketError = error;\n\t\tended = true;\n\t\tflush();\n\t});\n\tsocket.on(\"close\", () => {\n\t\tended = true;\n\t\tflush();\n\t\twriteGate.dispose();\n\t\tresolveClosed({\n\t\t\t...(closeReason === undefined ? {} : { reason: closeReason }),\n\t\t\t...(socketError === undefined ? {} : { error: socketError }),\n\t\t});\n\t});\n\t// The relay client hands the socket over explicitly paused (with the\n\t// post-preamble remainder unshifted); a data listener alone does not\n\t// un-pause an explicitly paused stream.\n\tsocket.resume();\n\n\treturn {\n\t\trecv: {\n\t\t\tread(sizeLimit: number): Promise<IrohBytes | undefined> {\n\t\t\t\tconst queued = chunks.shift();\n\t\t\t\tif (queued) {\n\t\t\t\t\tif (queued.length > sizeLimit) {\n\t\t\t\t\t\tchunks.unshift(queued.subarray(sizeLimit));\n\t\t\t\t\t\treturn Promise.resolve(queued.subarray(0, sizeLimit));\n\t\t\t\t\t}\n\t\t\t\t\treturn Promise.resolve(queued);\n\t\t\t\t}\n\t\t\t\tif (socketError) {\n\t\t\t\t\treturn Promise.reject(socketError);\n\t\t\t\t}\n\t\t\t\tif (ended) {\n\t\t\t\t\treturn Promise.resolve(undefined);\n\t\t\t\t}\n\t\t\t\treturn new Promise((resolve, reject) => {\n\t\t\t\t\treaders.push({ resolve, reject });\n\t\t\t\t});\n\t\t\t},\n\t\t\tstop(_errorCode: bigint): void {\n\t\t\t\tended = true;\n\t\t\t\tflush();\n\t\t\t\tsocket.destroy();\n\t\t\t},\n\t\t},\n\t\tsend: {\n\t\t\tasync writeAll(bytes: number[]): Promise<void> {\n\t\t\t\tawait writeGate.write(Buffer.from(bytes));\n\t\t\t},\n\t\t\tasync finish(): Promise<void> {\n\t\t\t\tawait writeGate.end();\n\t\t\t},\n\t\t},\n\t\tclose(reason?: string): void {\n\t\t\tcloseReason = reason;\n\t\t\tsocket.destroy();\n\t\t},\n\t\tclosed,\n\t};\n}\n"]}

package/dist/modes/interactive/relay-stream-adapter.js

@@ -0,0 +1,107 @@
+import { Buffer } from "node:buffer";
+import { DuplexWriteGate } from "../../core/rpc/duplex-write-gate.js";
+/**
+ * Wrap a relay unix-socket Duplex in the Iroh stream shape consumed by
+ * runIrohRemoteRpcMode. The adapter writes no close-reason trailer: the daemon
+ * owns close-reason signaling to the phone, so a TUI-initiated destroy
+ * surfaces as a generic closure (lease release/rekey closures are executed by
+ * the daemon with proper reasons).
+ */
+export function adaptRelaySocketToIrohStream(socket) {
+    const chunks = [];
+    const readers = [];
+    const writeGate = new DuplexWriteGate(socket);
+    let ended = false;
+    let closeReason;
+    let socketError;
+    let resolveClosed = () => { };
+    const closed = new Promise((resolve) => {
+        resolveClosed = resolve;
+    });
+    const flush = () => {
+        while (readers.length > 0 && (chunks.length > 0 || ended || socketError)) {
+            const reader = readers.shift();
+            if (!reader) {
+                return;
+            }
+            const chunk = chunks.shift();
+            if (chunk) {
+                reader.resolve(chunk);
+                continue;
+            }
+            if (socketError) {
+                reader.reject(socketError);
+                continue;
+            }
+            reader.resolve(undefined);
+        }
+    };
+    socket.on("data", (chunk) => {
+        chunks.push(Buffer.from(chunk));
+        flush();
+    });
+    socket.on("end", () => {
+        ended = true;
+        flush();
+    });
+    socket.on("error", (error) => {
+        socketError = error;
+        ended = true;
+        flush();
+    });
+    socket.on("close", () => {
+        ended = true;
+        flush();
+        writeGate.dispose();
+        resolveClosed({
+            ...(closeReason === undefined ? {} : { reason: closeReason }),
+            ...(socketError === undefined ? {} : { error: socketError }),
+        });
+    });
+    // The relay client hands the socket over explicitly paused (with the
+    // post-preamble remainder unshifted); a data listener alone does not
+    // un-pause an explicitly paused stream.
+    socket.resume();
+    return {
+        recv: {
+            read(sizeLimit) {
+                const queued = chunks.shift();
+                if (queued) {
+                    if (queued.length > sizeLimit) {
+                        chunks.unshift(queued.subarray(sizeLimit));
+                        return Promise.resolve(queued.subarray(0, sizeLimit));
+                    }
+                    return Promise.resolve(queued);
+                }
+                if (socketError) {
+                    return Promise.reject(socketError);
+                }
+                if (ended) {
+                    return Promise.resolve(undefined);
+                }
+                return new Promise((resolve, reject) => {
+                    readers.push({ resolve, reject });
+                });
+            },
+            stop(_errorCode) {
+                ended = true;
+                flush();
+                socket.destroy();
+            },
+        },
+        send: {
+            async writeAll(bytes) {
+                await writeGate.write(Buffer.from(bytes));
+            },
+            async finish() {
+                await writeGate.end();
+            },
+        },
+        close(reason) {
+            closeReason = reason;
+            socket.destroy();
+        },
+        closed,
+    };
+}
+//# sourceMappingURL=relay-stream-adapter.js.map

package/dist/modes/interactive/relay-stream-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-stream-adapter.js","sourceRoot":"","sources":["../../../src/modes/interactive/relay-stream-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAStE;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAc,EAAyB;IACnF,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAuF,EAAE,CAAC;IACvG,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,WAA+B,CAAC;IACpC,IAAI,WAA8B,CAAC;IACnC,IAAI,aAAa,GAAwD,GAAG,EAAE,CAAC,EAAC,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,IAAI,OAAO,CAAqC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3E,aAAa,GAAG,OAAO,CAAC;IAAA,CACxB,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC;QACnB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,IAAI,WAAW,CAAC,EAAE,CAAC;YAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACb,OAAO;YACR,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,KAAK,EAAE,CAAC;gBACX,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACtB,SAAS;YACV,CAAC;YACD,IAAI,WAAW,EAAE,CAAC;gBACjB,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBAC3B,SAAS;YACV,CAAC;YACD,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;IAAA,CACD,CAAC;IAEF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAChC,KAAK,EAAE,CAAC;IAAA,CACR,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;QACtB,KAAK,GAAG,IAAI,CAAC;QACb,KAAK,EAAE,CAAC;IAAA,CACR,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE,CAAC;QACpC,WAAW,GAAG,KAAK,CAAC;QACpB,KAAK,GAAG,IAAI,CAAC;QACb,KAAK,EAAE,CAAC;IAAA,CACR,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC;QACxB,KAAK,GAAG,IAAI,CAAC;QACb,KAAK,EAAE,CAAC;QACR,SAAS,CAAC,OAAO,EAAE,CAAC;QACpB,aAAa,CAAC;YACb,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YAC7D,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;SAC5D,CAAC,CAAC;IAAA,CACH,CAAC,CAAC;IACH,qEAAqE;IACrE,qEAAqE;IACrE,wCAAwC;IACxC,MAAM,CAAC,MAAM,EAAE,CAAC;IAEhB,OAAO;QACN,IAAI,EAAE;YACL,IAAI,CAAC,SAAiB,EAAkC;gBACvD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC9B,IAAI,MAAM,EAAE,CAAC;oBACZ,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;wBAC/B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;wBAC3C,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;oBACvD,CAAC;oBACD,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAChC,CAAC;gBACD,IAAI,WAAW,EAAE,CAAC;oBACjB,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBACpC,CAAC;gBACD,IAAI,KAAK,EAAE,CAAC;oBACX,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBACnC,CAAC;gBACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;oBACvC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;gBAAA,CAClC,CAAC,CAAC;YAAA,CACH;YACD,IAAI,CAAC,UAAkB,EAAQ;gBAC9B,KAAK,GAAG,IAAI,CAAC;gBACb,KAAK,EAAE,CAAC;gBACR,MAAM,CAAC,OAAO,EAAE,CAAC;YAAA,CACjB;SACD;QACD,IAAI,EAAE;YACL,KAAK,CAAC,QAAQ,CAAC,KAAe,EAAiB;gBAC9C,MAAM,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAAA,CAC1C;YACD,KAAK,CAAC,MAAM,GAAkB;gBAC7B,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC;YAAA,CACtB;SACD;QACD,KAAK,CAAC,MAAe,EAAQ;YAC5B,WAAW,GAAG,MAAM,CAAC;YACrB,MAAM,CAAC,OAAO,EAAE,CAAC;QAAA,CACjB;QACD,MAAM;KACN,CAAC;AAAA,CACF","sourcesContent":["import { Buffer } from \"node:buffer\";\nimport type { Duplex } from \"node:stream\";\nimport { DuplexWriteGate } from \"../../core/rpc/duplex-write-gate.ts\";\nimport type { IrohBiStreamLike, IrohBytes } from \"../../core/rpc/iroh-transport.ts\";\n\nexport interface RelayedIrohStreamLike extends IrohBiStreamLike {\n\t/** Close both directions; maps to socket.destroy(). */\n\tclose(reason?: string): void;\n\treadonly closed: Promise<{ reason?: string; error?: Error }>;\n}\n\n/**\n * Wrap a relay unix-socket Duplex in the Iroh stream shape consumed by\n * runIrohRemoteRpcMode. The adapter writes no close-reason trailer: the daemon\n * owns close-reason signaling to the phone, so a TUI-initiated destroy\n * surfaces as a generic closure (lease release/rekey closures are executed by\n * the daemon with proper reasons).\n */\nexport function adaptRelaySocketToIrohStream(socket: Duplex): RelayedIrohStreamLike {\n\tconst chunks: Buffer[] = [];\n\tconst readers: Array<{ resolve(value: IrohBytes | undefined): void; reject(error: Error): void }> = [];\n\tconst writeGate = new DuplexWriteGate(socket);\n\tlet ended = false;\n\tlet closeReason: string | undefined;\n\tlet socketError: Error | undefined;\n\tlet resolveClosed: (value: { reason?: string; error?: Error }) => void = () => {};\n\tconst closed = new Promise<{ reason?: string; error?: Error }>((resolve) => {\n\t\tresolveClosed = resolve;\n\t});\n\n\tconst flush = () => {\n\t\twhile (readers.length > 0 && (chunks.length > 0 || ended || socketError)) {\n\t\t\tconst reader = readers.shift();\n\t\t\tif (!reader) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst chunk = chunks.shift();\n\t\t\tif (chunk) {\n\t\t\t\treader.resolve(chunk);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (socketError) {\n\t\t\t\treader.reject(socketError);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\treader.resolve(undefined);\n\t\t}\n\t};\n\n\tsocket.on(\"data\", (chunk: Buffer) => {\n\t\tchunks.push(Buffer.from(chunk));\n\t\tflush();\n\t});\n\tsocket.on(\"end\", () => {\n\t\tended = true;\n\t\tflush();\n\t});\n\tsocket.on(\"error\", (error: Error) => {\n\t\tsocketError = error;\n\t\tended = true;\n\t\tflush();\n\t});\n\tsocket.on(\"close\", () => {\n\t\tended = true;\n\t\tflush();\n\t\twriteGate.dispose();\n\t\tresolveClosed({\n\t\t\t...(closeReason === undefined ? {} : { reason: closeReason }),\n\t\t\t...(socketError === undefined ? {} : { error: socketError }),\n\t\t});\n\t});\n\t// The relay client hands the socket over explicitly paused (with the\n\t// post-preamble remainder unshifted); a data listener alone does not\n\t// un-pause an explicitly paused stream.\n\tsocket.resume();\n\n\treturn {\n\t\trecv: {\n\t\t\tread(sizeLimit: number): Promise<IrohBytes | undefined> {\n\t\t\t\tconst queued = chunks.shift();\n\t\t\t\tif (queued) {\n\t\t\t\t\tif (queued.length > sizeLimit) {\n\t\t\t\t\t\tchunks.unshift(queued.subarray(sizeLimit));\n\t\t\t\t\t\treturn Promise.resolve(queued.subarray(0, sizeLimit));\n\t\t\t\t\t}\n\t\t\t\t\treturn Promise.resolve(queued);\n\t\t\t\t}\n\t\t\t\tif (socketError) {\n\t\t\t\t\treturn Promise.reject(socketError);\n\t\t\t\t}\n\t\t\t\tif (ended) {\n\t\t\t\t\treturn Promise.resolve(undefined);\n\t\t\t\t}\n\t\t\t\treturn new Promise((resolve, reject) => {\n\t\t\t\t\treaders.push({ resolve, reject });\n\t\t\t\t});\n\t\t\t},\n\t\t\tstop(_errorCode: bigint): void {\n\t\t\t\tended = true;\n\t\t\t\tflush();\n\t\t\t\tsocket.destroy();\n\t\t\t},\n\t\t},\n\t\tsend: {\n\t\t\tasync writeAll(bytes: number[]): Promise<void> {\n\t\t\t\tawait writeGate.write(Buffer.from(bytes));\n\t\t\t},\n\t\t\tasync finish(): Promise<void> {\n\t\t\t\tawait writeGate.end();\n\t\t\t},\n\t\t},\n\t\tclose(reason?: string): void {\n\t\t\tcloseReason = reason;\n\t\t\tsocket.destroy();\n\t\t},\n\t\tclosed,\n\t};\n}\n"]}

package/dist/modes/print-mode.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Print mode (single-shot): Send prompts, output result, exit.
+ *
+ * Used for:
+ * - `volt -p "prompt"` - text output
+ * - `volt --mode json "prompt"` - JSON event stream
+ */
+import type { ImageContent } from "@hansjm10/volt-ai";
+import type { AgentSessionRuntime } from "../core/agent-session-runtime.ts";
+/**
+ * Options for print mode.
+ */
+export interface PrintModeOptions {
+    /** Output mode: "text" for final response only, "json" for all events */
+    mode: "text" | "json";
+    /** Array of additional prompts to send after initialMessage */
+    messages?: string[];
+    /** First message to send (may contain @file content) */
+    initialMessage?: string;
+    /** Images to attach to the initial message */
+    initialImages?: ImageContent[];
+}
+/**
+ * Run in print (single-shot) mode.
+ * Sends prompts to the agent and outputs the result.
+ */
+export declare function runPrintMode(runtimeHost: AgentSessionRuntime, options: PrintModeOptions): Promise<number>;
+//# sourceMappingURL=print-mode.d.ts.map

package/dist/modes/print-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-mode.d.ts","sourceRoot":"","sources":["../../src/modes/print-mode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAoB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAI5E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,yEAAyE;IACzE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,mBAAmB,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+H/G","sourcesContent":["/**\n * Print mode (single-shot): Send prompts, output result, exit.\n *\n * Used for:\n * - `volt -p \"prompt\"` - text output\n * - `volt --mode json \"prompt\"` - JSON event stream\n */\n\nimport type { AssistantMessage, ImageContent } from \"@hansjm10/volt-ai\";\nimport type { AgentSessionRuntime } from \"../core/agent-session-runtime.ts\";\nimport { flushRawStdout, writeRawStdout } from \"../core/output-guard.ts\";\nimport { killTrackedDetachedChildren } from \"../utils/shell.ts\";\n\n/**\n * Options for print mode.\n */\nexport interface PrintModeOptions {\n\t/** Output mode: \"text\" for final response only, \"json\" for all events */\n\tmode: \"text\" | \"json\";\n\t/** Array of additional prompts to send after initialMessage */\n\tmessages?: string[];\n\t/** First message to send (may contain @file content) */\n\tinitialMessage?: string;\n\t/** Images to attach to the initial message */\n\tinitialImages?: ImageContent[];\n}\n\n/**\n * Run in print (single-shot) mode.\n * Sends prompts to the agent and outputs the result.\n */\nexport async function runPrintMode(runtimeHost: AgentSessionRuntime, options: PrintModeOptions): Promise<number> {\n\tconst { mode, messages = [], initialMessage, initialImages } = options;\n\tlet exitCode = 0;\n\tlet session = runtimeHost.session;\n\tlet unsubscribe: (() => void) | undefined;\n\tlet disposed = false;\n\tconst signalCleanupHandlers: Array<() => void> = [];\n\n\tconst disposeRuntime = async (): Promise<void> => {\n\t\tif (disposed) return;\n\t\tdisposed = true;\n\t\tunsubscribe?.();\n\t\tawait runtimeHost.dispose();\n\t};\n\n\tconst registerSignalHandlers = (): void => {\n\t\tconst signals: NodeJS.Signals[] = [\"SIGTERM\"];\n\t\tif (process.platform !== \"win32\") {\n\t\t\tsignals.push(\"SIGHUP\");\n\t\t}\n\n\t\tfor (const signal of signals) {\n\t\t\tconst handler = () => {\n\t\t\t\tkillTrackedDetachedChildren();\n\t\t\t\tvoid disposeRuntime().finally(() => {\n\t\t\t\t\tprocess.exit(signal === \"SIGHUP\" ? 129 : 143);\n\t\t\t\t});\n\t\t\t};\n\t\t\tprocess.on(signal, handler);\n\t\t\tsignalCleanupHandlers.push(() => process.off(signal, handler));\n\t\t}\n\t};\n\n\tregisterSignalHandlers();\n\n\truntimeHost.setRebindSession(async () => {\n\t\tawait rebindSession();\n\t});\n\n\tconst rebindSession = async (): Promise<void> => {\n\t\tsession = runtimeHost.session;\n\t\tawait session.bindExtensions({\n\t\t\tmode: mode === \"json\" ? \"json\" : \"print\",\n\t\t\tcommandContextActions: {\n\t\t\t\twaitForIdle: () => session.waitForIdle(),\n\t\t\t\tnewSession: async (newSessionOptions) => runtimeHost.newSession(newSessionOptions),\n\t\t\t\tfork: async (entryId, forkOptions) => {\n\t\t\t\t\tconst result = await runtimeHost.fork(entryId, forkOptions);\n\t\t\t\t\treturn { cancelled: result.cancelled };\n\t\t\t\t},\n\t\t\t\tnavigateTree: async (targetId, navigateOptions) => {\n\t\t\t\t\tconst result = await session.navigateTree(targetId, {\n\t\t\t\t\t\tsummarize: navigateOptions?.summarize,\n\t\t\t\t\t\tcustomInstructions: navigateOptions?.customInstructions,\n\t\t\t\t\t\treplaceInstructions: navigateOptions?.replaceInstructions,\n\t\t\t\t\t\tlabel: navigateOptions?.label,\n\t\t\t\t\t});\n\t\t\t\t\treturn { cancelled: result.cancelled };\n\t\t\t\t},\n\t\t\t\tswitchSession: async (sessionPath, switchOptions) => {\n\t\t\t\t\treturn runtimeHost.switchSession(sessionPath, switchOptions);\n\t\t\t\t},\n\t\t\t\treload: async () => {\n\t\t\t\t\tawait session.reload();\n\t\t\t\t},\n\t\t\t},\n\t\t\tonError: (err) => {\n\t\t\t\tconsole.error(`Extension error (${err.extensionPath}): ${err.error}`);\n\t\t\t},\n\t\t});\n\n\t\tunsubscribe?.();\n\t\tunsubscribe = session.subscribe((event) => {\n\t\t\tif (mode === \"json\") {\n\t\t\t\twriteRawStdout(`${JSON.stringify(event)}\\n`);\n\t\t\t}\n\t\t});\n\t};\n\n\ttry {\n\t\tif (mode === \"json\") {\n\t\t\tconst header = session.sessionManager.getHeader();\n\t\t\tif (header) {\n\t\t\t\twriteRawStdout(`${JSON.stringify(header)}\\n`);\n\t\t\t}\n\t\t}\n\n\t\tawait rebindSession();\n\n\t\tif (initialMessage) {\n\t\t\tawait session.prompt(initialMessage, { images: initialImages });\n\t\t}\n\n\t\tfor (const message of messages) {\n\t\t\tawait session.prompt(message);\n\t\t}\n\n\t\tif (mode === \"text\") {\n\t\t\tconst state = session.state;\n\t\t\tconst lastMessage = state.messages[state.messages.length - 1];\n\n\t\t\tif (lastMessage?.role === \"assistant\") {\n\t\t\t\tconst assistantMsg = lastMessage as AssistantMessage;\n\t\t\t\tif (assistantMsg.stopReason === \"error\" || assistantMsg.stopReason === \"aborted\") {\n\t\t\t\t\tconsole.error(assistantMsg.errorMessage || `Request ${assistantMsg.stopReason}`);\n\t\t\t\t\texitCode = 1;\n\t\t\t\t} else {\n\t\t\t\t\tfor (const content of assistantMsg.content) {\n\t\t\t\t\t\tif (content.type === \"text\") {\n\t\t\t\t\t\t\twriteRawStdout(`${content.text}\\n`);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn exitCode;\n\t} catch (error: unknown) {\n\t\tconsole.error(error instanceof Error ? error.message : String(error));\n\t\treturn 1;\n\t} finally {\n\t\tfor (const cleanup of signalCleanupHandlers) {\n\t\t\tcleanup();\n\t\t}\n\t\tawait disposeRuntime();\n\t\tawait flushRawStdout();\n\t}\n}\n"]}

package/dist/modes/print-mode.js

@@ -0,0 +1,132 @@
+/**
+ * Print mode (single-shot): Send prompts, output result, exit.
+ *
+ * Used for:
+ * - `volt -p "prompt"` - text output
+ * - `volt --mode json "prompt"` - JSON event stream
+ */
+import { flushRawStdout, writeRawStdout } from "../core/output-guard.js";
+import { killTrackedDetachedChildren } from "../utils/shell.js";
+/**
+ * Run in print (single-shot) mode.
+ * Sends prompts to the agent and outputs the result.
+ */
+export async function runPrintMode(runtimeHost, options) {
+    const { mode, messages = [], initialMessage, initialImages } = options;
+    let exitCode = 0;
+    let session = runtimeHost.session;
+    let unsubscribe;
+    let disposed = false;
+    const signalCleanupHandlers = [];
+    const disposeRuntime = async () => {
+        if (disposed)
+            return;
+        disposed = true;
+        unsubscribe?.();
+        await runtimeHost.dispose();
+    };
+    const registerSignalHandlers = () => {
+        const signals = ["SIGTERM"];
+        if (process.platform !== "win32") {
+            signals.push("SIGHUP");
+        }
+        for (const signal of signals) {
+            const handler = () => {
+                killTrackedDetachedChildren();
+                void disposeRuntime().finally(() => {
+                    process.exit(signal === "SIGHUP" ? 129 : 143);
+                });
+            };
+            process.on(signal, handler);
+            signalCleanupHandlers.push(() => process.off(signal, handler));
+        }
+    };
+    registerSignalHandlers();
+    runtimeHost.setRebindSession(async () => {
+        await rebindSession();
+    });
+    const rebindSession = async () => {
+        session = runtimeHost.session;
+        await session.bindExtensions({
+            mode: mode === "json" ? "json" : "print",
+            commandContextActions: {
+                waitForIdle: () => session.waitForIdle(),
+                newSession: async (newSessionOptions) => runtimeHost.newSession(newSessionOptions),
+                fork: async (entryId, forkOptions) => {
+                    const result = await runtimeHost.fork(entryId, forkOptions);
+                    return { cancelled: result.cancelled };
+                },
+                navigateTree: async (targetId, navigateOptions) => {
+                    const result = await session.navigateTree(targetId, {
+                        summarize: navigateOptions?.summarize,
+                        customInstructions: navigateOptions?.customInstructions,
+                        replaceInstructions: navigateOptions?.replaceInstructions,
+                        label: navigateOptions?.label,
+                    });
+                    return { cancelled: result.cancelled };
+                },
+                switchSession: async (sessionPath, switchOptions) => {
+                    return runtimeHost.switchSession(sessionPath, switchOptions);
+                },
+                reload: async () => {
+                    await session.reload();
+                },
+            },
+            onError: (err) => {
+                console.error(`Extension error (${err.extensionPath}): ${err.error}`);
+            },
+        });
+        unsubscribe?.();
+        unsubscribe = session.subscribe((event) => {
+            if (mode === "json") {
+                writeRawStdout(`${JSON.stringify(event)}\n`);
+            }
+        });
+    };
+    try {
+        if (mode === "json") {
+            const header = session.sessionManager.getHeader();
+            if (header) {
+                writeRawStdout(`${JSON.stringify(header)}\n`);
+            }
+        }
+        await rebindSession();
+        if (initialMessage) {
+            await session.prompt(initialMessage, { images: initialImages });
+        }
+        for (const message of messages) {
+            await session.prompt(message);
+        }
+        if (mode === "text") {
+            const state = session.state;
+            const lastMessage = state.messages[state.messages.length - 1];
+            if (lastMessage?.role === "assistant") {
+                const assistantMsg = lastMessage;
+                if (assistantMsg.stopReason === "error" || assistantMsg.stopReason === "aborted") {
+                    console.error(assistantMsg.errorMessage || `Request ${assistantMsg.stopReason}`);
+                    exitCode = 1;
+                }
+                else {
+                    for (const content of assistantMsg.content) {
+                        if (content.type === "text") {
+                            writeRawStdout(`${content.text}\n`);
+                        }
+                    }
+                }
+            }
+        }
+        return exitCode;
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        return 1;
+    }
+    finally {
+        for (const cleanup of signalCleanupHandlers) {
+            cleanup();
+        }
+        await disposeRuntime();
+        await flushRawStdout();
+    }
+}
+//# sourceMappingURL=print-mode.js.map

package/dist/modes/print-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-mode.js","sourceRoot":"","sources":["../../src/modes/print-mode.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Print mode (single-shot): Send prompts, output result, exit.\n *\n * Used for:\n * - `volt -p \"prompt\"` - text output\n * - `volt --mode json \"prompt\"` - JSON event stream\n */\n\nimport type { AssistantMessage, ImageContent } from \"@hansjm10/volt-ai\";\nimport type { AgentSessionRuntime } from \"../core/agent-session-runtime.ts\";\nimport { flushRawStdout, writeRawStdout } from \"../core/output-guard.ts\";\nimport { killTrackedDetachedChildren } from \"../utils/shell.ts\";\n\n/**\n * Options for print mode.\n */\nexport interface PrintModeOptions {\n\t/** Output mode: \"text\" for final response only, \"json\" for all events */\n\tmode: \"text\" | \"json\";\n\t/** Array of additional prompts to send after initialMessage */\n\tmessages?: string[];\n\t/** First message to send (may contain @file content) */\n\tinitialMessage?: string;\n\t/** Images to attach to the initial message */\n\tinitialImages?: ImageContent[];\n}\n\n/**\n * Run in print (single-shot) mode.\n * Sends prompts to the agent and outputs the result.\n */\nexport async function runPrintMode(runtimeHost: AgentSessionRuntime, options: PrintModeOptions): Promise<number> {\n\tconst { mode, messages = [], initialMessage, initialImages } = options;\n\tlet exitCode = 0;\n\tlet session = runtimeHost.session;\n\tlet unsubscribe: (() => void) | undefined;\n\tlet disposed = false;\n\tconst signalCleanupHandlers: Array<() => void> = [];\n\n\tconst disposeRuntime = async (): Promise<void> => {\n\t\tif (disposed) return;\n\t\tdisposed = true;\n\t\tunsubscribe?.();\n\t\tawait runtimeHost.dispose();\n\t};\n\n\tconst registerSignalHandlers = (): void => {\n\t\tconst signals: NodeJS.Signals[] = [\"SIGTERM\"];\n\t\tif (process.platform !== \"win32\") {\n\t\t\tsignals.push(\"SIGHUP\");\n\t\t}\n\n\t\tfor (const signal of signals) {\n\t\t\tconst handler = () => {\n\t\t\t\tkillTrackedDetachedChildren();\n\t\t\t\tvoid disposeRuntime().finally(() => {\n\t\t\t\t\tprocess.exit(signal === \"SIGHUP\" ? 129 : 143);\n\t\t\t\t});\n\t\t\t};\n\t\t\tprocess.on(signal, handler);\n\t\t\tsignalCleanupHandlers.push(() => process.off(signal, handler));\n\t\t}\n\t};\n\n\tregisterSignalHandlers();\n\n\truntimeHost.setRebindSession(async () => {\n\t\tawait rebindSession();\n\t});\n\n\tconst rebindSession = async (): Promise<void> => {\n\t\tsession = runtimeHost.session;\n\t\tawait session.bindExtensions({\n\t\t\tmode: mode === \"json\" ? \"json\" : \"print\",\n\t\t\tcommandContextActions: {\n\t\t\t\twaitForIdle: () => session.waitForIdle(),\n\t\t\t\tnewSession: async (newSessionOptions) => runtimeHost.newSession(newSessionOptions),\n\t\t\t\tfork: async (entryId, forkOptions) => {\n\t\t\t\t\tconst result = await runtimeHost.fork(entryId, forkOptions);\n\t\t\t\t\treturn { cancelled: result.cancelled };\n\t\t\t\t},\n\t\t\t\tnavigateTree: async (targetId, navigateOptions) => {\n\t\t\t\t\tconst result = await session.navigateTree(targetId, {\n\t\t\t\t\t\tsummarize: navigateOptions?.summarize,\n\t\t\t\t\t\tcustomInstructions: navigateOptions?.customInstructions,\n\t\t\t\t\t\treplaceInstructions: navigateOptions?.replaceInstructions,\n\t\t\t\t\t\tlabel: navigateOptions?.label,\n\t\t\t\t\t});\n\t\t\t\t\treturn { cancelled: result.cancelled };\n\t\t\t\t},\n\t\t\t\tswitchSession: async (sessionPath, switchOptions) => {\n\t\t\t\t\treturn runtimeHost.switchSession(sessionPath, switchOptions);\n\t\t\t\t},\n\t\t\t\treload: async () => {\n\t\t\t\t\tawait session.reload();\n\t\t\t\t},\n\t\t\t},\n\t\t\tonError: (err) => {\n\t\t\t\tconsole.error(`Extension error (${err.extensionPath}): ${err.error}`);\n\t\t\t},\n\t\t});\n\n\t\tunsubscribe?.();\n\t\tunsubscribe = session.subscribe((event) => {\n\t\t\tif (mode === \"json\") {\n\t\t\t\twriteRawStdout(`${JSON.stringify(event)}\\n`);\n\t\t\t}\n\t\t});\n\t};\n\n\ttry {\n\t\tif (mode === \"json\") {\n\t\t\tconst header = session.sessionManager.getHeader();\n\t\t\tif (header) {\n\t\t\t\twriteRawStdout(`${JSON.stringify(header)}\\n`);\n\t\t\t}\n\t\t}\n\n\t\tawait rebindSession();\n\n\t\tif (initialMessage) {\n\t\t\tawait session.prompt(initialMessage, { images: initialImages });\n\t\t}\n\n\t\tfor (const message of messages) {\n\t\t\tawait session.prompt(message);\n\t\t}\n\n\t\tif (mode === \"text\") {\n\t\t\tconst state = session.state;\n\t\t\tconst lastMessage = state.messages[state.messages.length - 1];\n\n\t\t\tif (lastMessage?.role === \"assistant\") {\n\t\t\t\tconst assistantMsg = lastMessage as AssistantMessage;\n\t\t\t\tif (assistantMsg.stopReason === \"error\" || assistantMsg.stopReason === \"aborted\") {\n\t\t\t\t\tconsole.error(assistantMsg.errorMessage || `Request ${assistantMsg.stopReason}`);\n\t\t\t\t\texitCode = 1;\n\t\t\t\t} else {\n\t\t\t\t\tfor (const content of assistantMsg.content) {\n\t\t\t\t\t\tif (content.type === \"text\") {\n\t\t\t\t\t\t\twriteRawStdout(`${content.text}\\n`);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn exitCode;\n\t} catch (error: unknown) {\n\t\tconsole.error(error instanceof Error ? error.message : String(error));\n\t\treturn 1;\n\t} finally {\n\t\tfor (const cleanup of signalCleanupHandlers) {\n\t\t\tcleanup();\n\t\t}\n\t\tawait disposeRuntime();\n\t\tawait flushRawStdout();\n\t}\n}\n"]}

package/dist/modes/rpc/in-process-rpc-client.d.ts

@@ -0,0 +1,31 @@
+import type { AgentSessionRuntime } from "../../core/agent-session-runtime.ts";
+import type { RpcClientEvent } from "./rpc-client-base.ts";
+import { RpcTransportClient } from "./rpc-transport-client.ts";
+export type InProcessRpcClientEventListener = (event: RpcClientEvent, client: InProcessRpcClient) => void;
+export interface InProcessRpcClientOptions {
+    /** Milliseconds to wait for a command response. Defaults to 30 seconds. */
+    requestTimeoutMs?: number;
+    /** Defaults to true. Set false when another owner retains the runtime after this loopback client stops. */
+    disposeRuntimeOnClose?: boolean;
+    /** Initial event listener registered before startup completes. */
+    onEvent?: InProcessRpcClientEventListener;
+}
+interface InProcessRpcClientConstructorOptions extends InProcessRpcClientOptions {
+    runtimeHost: AgentSessionRuntime;
+}
+/**
+ * RPC client backed by runRpcMode in the same Node.js process.
+ *
+ * stop() closes the client transport and waits for RPC mode shutdown. By default
+ * shutdown also disposes the supplied AgentSessionRuntime.
+ */
+export declare class InProcessRpcClient extends RpcTransportClient {
+    private readonly modeClosed;
+    private readonly modeReady;
+    constructor(options: InProcessRpcClientConstructorOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+export declare function createInProcessRpcClient(runtimeHost: AgentSessionRuntime, options?: InProcessRpcClientOptions): Promise<InProcessRpcClient>;
+export {};
+//# sourceMappingURL=in-process-rpc-client.d.ts.map

package/dist/modes/rpc/in-process-rpc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process-rpc-client.d.ts","sourceRoot":"","sources":["../../../src/modes/rpc/in-process-rpc-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,MAAM,+BAA+B,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAE1G,MAAM,WAAW,yBAAyB;IACzC,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2GAA2G;IAC3G,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,kEAAkE;IAClE,OAAO,CAAC,EAAE,+BAA+B,CAAC;CAC1C;AAED,UAAU,oCAAqC,SAAQ,yBAAyB;IAC/E,WAAW,EAAE,mBAAmB,CAAC;CACjC;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,kBAAkB;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAE1C,YAAY,OAAO,EAAE,oCAAoC,EAsCxD;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1B;CACD;AAED,wBAAsB,wBAAwB,CAC7C,WAAW,EAAE,mBAAmB,EAChC,OAAO,GAAE,yBAA8B,GACrC,OAAO,CAAC,kBAAkB,CAAC,CAI7B","sourcesContent":["import type { AgentSessionRuntime } from \"../../core/agent-session-runtime.ts\";\nimport { createLoopbackRpcTransportPair } from \"../../core/rpc/index.ts\";\nimport type { RpcClientEvent } from \"./rpc-client-base.ts\";\nimport { runRpcMode } from \"./rpc-mode.ts\";\nimport { RpcTransportClient } from \"./rpc-transport-client.ts\";\n\nexport type InProcessRpcClientEventListener = (event: RpcClientEvent, client: InProcessRpcClient) => void;\n\nexport interface InProcessRpcClientOptions {\n\t/** Milliseconds to wait for a command response. Defaults to 30 seconds. */\n\trequestTimeoutMs?: number;\n\t/** Defaults to true. Set false when another owner retains the runtime after this loopback client stops. */\n\tdisposeRuntimeOnClose?: boolean;\n\t/** Initial event listener registered before startup completes. */\n\tonEvent?: InProcessRpcClientEventListener;\n}\n\ninterface InProcessRpcClientConstructorOptions extends InProcessRpcClientOptions {\n\truntimeHost: AgentSessionRuntime;\n}\n\n/**\n * RPC client backed by runRpcMode in the same Node.js process.\n *\n * stop() closes the client transport and waits for RPC mode shutdown. By default\n * shutdown also disposes the supplied AgentSessionRuntime.\n */\nexport class InProcessRpcClient extends RpcTransportClient {\n\tprivate readonly modeClosed: Promise<void>;\n\tprivate readonly modeReady: Promise<void>;\n\n\tconstructor(options: InProcessRpcClientConstructorOptions) {\n\t\tconst pair = createLoopbackRpcTransportPair();\n\t\tsuper({ transport: pair.client, requestTimeoutMs: options.requestTimeoutMs });\n\n\t\tconst initialEventListener = options.onEvent;\n\t\tif (initialEventListener) {\n\t\t\tthis.onEvent((event) => {\n\t\t\t\tinitialEventListener(event, this);\n\t\t\t});\n\t\t}\n\n\t\tlet readySettled = false;\n\t\tlet resolveReady: () => void = () => {};\n\t\tlet rejectReady: (error: unknown) => void = () => {};\n\t\tthis.modeReady = new Promise<void>((resolve, reject) => {\n\t\t\tresolveReady = () => {\n\t\t\t\treadySettled = true;\n\t\t\t\tresolve();\n\t\t\t};\n\t\t\trejectReady = (error) => {\n\t\t\t\treadySettled = true;\n\t\t\t\treject(error);\n\t\t\t};\n\t\t});\n\t\tvoid this.modeReady.catch(() => {});\n\n\t\tthis.modeClosed = runRpcMode(options.runtimeHost, {\n\t\t\ttransport: pair.server,\n\t\t\tdisposeRuntimeOnClose: options.disposeRuntimeOnClose,\n\t\t\texitProcess: false,\n\t\t\tonReady: resolveReady,\n\t\t});\n\t\tvoid this.modeClosed.catch((error: unknown) => {\n\t\t\tif (!readySettled) {\n\t\t\t\trejectReady(error);\n\t\t\t}\n\t\t\tvoid pair.server.close();\n\t\t});\n\t}\n\n\tasync start(): Promise<void> {\n\t\tawait super.start();\n\t\tawait this.modeReady;\n\t}\n\n\tasync stop(): Promise<void> {\n\t\tawait super.stop();\n\t\tawait this.modeClosed;\n\t}\n}\n\nexport async function createInProcessRpcClient(\n\truntimeHost: AgentSessionRuntime,\n\toptions: InProcessRpcClientOptions = {},\n): Promise<InProcessRpcClient> {\n\tconst client = new InProcessRpcClient({ runtimeHost, ...options });\n\tawait client.start();\n\treturn client;\n}\n"]}