@greppleai/grip 0.0.0-stage → 0.1.3

package/dist/core/lsp/transport.d.ts

@@ -0,0 +1,39 @@
+import { type MessageReader, type MessageWriter } from "vscode-languageserver-protocol/node.js";
+import type { LspTransport } from "./config.ts";
+export type LspConnectionDisposalMode = "terminate-process" | "disconnect";
+export interface LspConnectionEndpoint {
+    type: LspTransport["type"];
+    description: string;
+    disposalMode: LspConnectionDisposalMode;
+}
+export interface LspConnectionHandle {
+    reader: MessageReader;
+    writer: MessageWriter;
+    endpoint: LspConnectionEndpoint;
+    close(): Promise<void>;
+    onClose(listener: () => void): () => void;
+    onError(listener: (error: Error) => void): () => void;
+}
+export interface LspConnectionFactoryContext {
+    serverId: string;
+    workspaceRoot: string;
+    workspaceUri: string;
+    signal: AbortSignal;
+    connectTimeoutMs?: number;
+    onStderr?: (text: string) => void;
+}
+export type LspConnectionFactory = (context: LspConnectionFactoryContext) => Promise<LspConnectionHandle>;
+export interface ManagedStdioConnectionOptions {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    inheritEnvironment?: boolean;
+}
+export type LspConnectionFactoryRegistry = Readonly<Record<string, LspConnectionFactory>>;
+export declare function createManagedStdioConnectionFactory(options: ManagedStdioConnectionOptions): LspConnectionFactory;
+export declare function createTcpConnectionFactory(host: string, port: number): LspConnectionFactory;
+export declare function createUnixSocketConnectionFactory(path: string): LspConnectionFactory;
+export declare function createNamedPipeConnectionFactory(path: string): LspConnectionFactory;
+export declare function resolveLspConnectionFactory(transport: LspTransport, programmaticFactories?: LspConnectionFactoryRegistry): LspConnectionFactory;
+//# sourceMappingURL=transport.d.ts.map

package/dist/core/lsp/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/core/lsp/transport.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,aAAa,EAKlB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,GAAG,YAAY,CAAC;AAG3E,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,yBAAyB,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC1C,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,2BAA2B,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAE1G,MAAM,WAAW,6BAA6B;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B;AACD,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;AA0I1F,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,6BAA6B,GAAG,oBAAoB,CAoDhH;AA+CD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAG3F;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAEpF;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAEnF;AAED,wBAAgB,2BAA2B,CAC1C,SAAS,EAAE,YAAY,EACvB,qBAAqB,GAAE,4BAAiC,GACtD,oBAAoB,CAkBtB","sourcesContent":["import { type ChildProcessWithoutNullStreams, spawn } from \"node:child_process\";\nimport { createConnection, type Socket } from \"node:net\";\nimport {\n\ttype MessageReader,\n\ttype MessageWriter,\n\tSocketMessageReader,\n\tSocketMessageWriter,\n\tStreamMessageReader,\n\tStreamMessageWriter,\n} from \"vscode-languageserver-protocol/node.js\";\nimport { killProcessTree } from \"../../utils/shell.ts\";\nimport type { LspTransport } from \"./config.ts\";\n\nexport type LspConnectionDisposalMode = \"terminate-process\" | \"disconnect\";\ntype LspSocketEndpointType = \"tcp\" | \"unix\" | \"pipe\";\n\nexport interface LspConnectionEndpoint {\n\ttype: LspTransport[\"type\"];\n\tdescription: string;\n\tdisposalMode: LspConnectionDisposalMode;\n}\n\nexport interface LspConnectionHandle {\n\treader: MessageReader;\n\twriter: MessageWriter;\n\tendpoint: LspConnectionEndpoint;\n\tclose(): Promise<void>;\n\tonClose(listener: () => void): () => void;\n\tonError(listener: (error: Error) => void): () => void;\n}\n\nexport interface LspConnectionFactoryContext {\n\tserverId: string;\n\tworkspaceRoot: string;\n\tworkspaceUri: string;\n\tsignal: AbortSignal;\n\tconnectTimeoutMs?: number;\n\tonStderr?: (text: string) => void;\n}\n\nexport type LspConnectionFactory = (context: LspConnectionFactoryContext) => Promise<LspConnectionHandle>;\n\nexport interface ManagedStdioConnectionOptions {\n\tcommand: string;\n\targs?: string[];\n\tenv?: Record<string, string>;\n\tcwd?: string;\n\tinheritEnvironment?: boolean;\n}\nexport type LspConnectionFactoryRegistry = Readonly<Record<string, LspConnectionFactory>>;\n\ninterface ConnectionEvents {\n\temitClose(): void;\n\temitError(error: Error): void;\n\tonClose(listener: () => void): () => void;\n\tonError(listener: (error: Error) => void): () => void;\n}\n\nfunction createConnectionEvents(): ConnectionEvents {\n\tconst closeListeners = new Set<() => void>();\n\tconst errorListeners = new Set<(error: Error) => void>();\n\treturn {\n\t\temitClose: () => {\n\t\t\tfor (const listener of closeListeners) listener();\n\t\t},\n\t\temitError: (error) => {\n\t\t\tfor (const listener of errorListeners) listener(error);\n\t\t},\n\t\tonClose: (listener) => {\n\t\t\tcloseListeners.add(listener);\n\t\t\treturn () => closeListeners.delete(listener);\n\t\t},\n\t\tonError: (listener) => {\n\t\t\terrorListeners.add(listener);\n\t\t\treturn () => errorListeners.delete(listener);\n\t\t},\n\t};\n}\n\nfunction abortError(description: string): Error {\n\treturn new Error(`Aborted while connecting to ${description}`);\n}\n\nasync function waitForConnection(\n\tdescription: string,\n\tsignal: AbortSignal,\n\ttimeoutMs: number | undefined,\n\tsubscribe: (resolve: () => void, reject: (error: Error) => void) => () => void,\n): Promise<void> {\n\tif (signal.aborted) throw abortError(description);\n\tawait new Promise<void>((resolve, reject) => {\n\t\tlet settled = false;\n\t\tlet timer: NodeJS.Timeout | undefined;\n\t\tlet actualUnsubscribe: (() => void) | undefined;\n\t\tlet unsubscribeRequested = false;\n\t\tconst unsubscribe = (): void => {\n\t\t\tif (actualUnsubscribe) actualUnsubscribe();\n\t\t\telse unsubscribeRequested = true;\n\t\t};\n\t\tconst cleanup = (): void => {\n\t\t\tif (timer) clearTimeout(timer);\n\t\t\tsignal.removeEventListener(\"abort\", onAbort);\n\t\t\tunsubscribe();\n\t\t};\n\t\tconst succeed = (): void => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tcleanup();\n\t\t\tresolve();\n\t\t};\n\t\tconst fail = (error: Error): void => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tcleanup();\n\t\t\treject(error);\n\t\t};\n\t\tconst onAbort = (): void => fail(abortError(description));\n\t\tactualUnsubscribe = subscribe(succeed, fail);\n\t\tif (unsubscribeRequested) actualUnsubscribe();\n\t\tif (settled) return;\n\t\tsignal.addEventListener(\"abort\", onAbort, { once: true });\n\t\tif (signal.aborted) {\n\t\t\tonAbort();\n\t\t\treturn;\n\t\t}\n\t\tif (timeoutMs !== undefined && timeoutMs > 0) {\n\t\t\ttimer = setTimeout(\n\t\t\t\t() => fail(new Error(`Timed out connecting to ${description} after ${timeoutMs}ms`)),\n\t\t\t\ttimeoutMs,\n\t\t\t);\n\t\t}\n\t});\n}\n\nfunction mergeEnvironment(extra: Record<string, string> | undefined, inheritEnvironment: boolean): NodeJS.ProcessEnv {\n\treturn inheritEnvironment ? (extra ? { ...process.env, ...extra } : process.env) : { ...extra };\n}\n\nfunction processGroupIsAlive(pid: number): boolean {\n\tif (process.platform === \"win32\") return false;\n\ttry {\n\t\tprocess.kill(-pid, 0);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nasync function waitForChildExit(exited: Promise<void>, timeoutMs: number): Promise<boolean> {\n\tlet timer: NodeJS.Timeout | undefined;\n\tconst didExit = await Promise.race([\n\t\texited.then(() => true),\n\t\tnew Promise<false>((resolve) => {\n\t\t\ttimer = setTimeout(() => resolve(false), timeoutMs);\n\t\t\ttimer.unref();\n\t\t}),\n\t]);\n\tif (timer) clearTimeout(timer);\n\treturn didExit;\n}\n\nasync function terminateChild(child: ChildProcessWithoutNullStreams): Promise<void> {\n\tif (child.pid === undefined) return;\n\tif (child.exitCode !== null || child.signalCode !== null) {\n\t\tif (processGroupIsAlive(child.pid)) killProcessTree(child.pid);\n\t\tawait new Promise<void>((resolve) => setImmediate(resolve));\n\t\treturn;\n\t}\n\tconst exited = new Promise<void>((resolve) => child.once(\"exit\", () => resolve()));\n\tif (child.pid !== undefined && process.platform !== \"win32\") {\n\t\ttry {\n\t\t\tprocess.kill(-child.pid, \"SIGTERM\");\n\t\t} catch {\n\t\t\tchild.kill(\"SIGTERM\");\n\t\t}\n\t} else {\n\t\tchild.kill(\"SIGTERM\");\n\t}\n\tconst exitedGracefully = await waitForChildExit(exited, 2000);\n\tif (exitedGracefully) {\n\t\tif (processGroupIsAlive(child.pid)) killProcessTree(child.pid);\n\t\treturn;\n\t}\n\tif (child.exitCode === null && child.signalCode === null && child.pid !== undefined) killProcessTree(child.pid);\n\tawait waitForChildExit(exited, 2000);\n}\n\nexport function createManagedStdioConnectionFactory(options: ManagedStdioConnectionOptions): LspConnectionFactory {\n\treturn async (context) => {\n\t\tconst cwd = options.cwd ?? context.workspaceRoot;\n\t\tconst description = `managed LSP process ${JSON.stringify(options.command)}`;\n\t\tconst child = spawn(options.command, options.args ?? [], {\n\t\t\tcwd,\n\t\t\tdetached: process.platform !== \"win32\",\n\t\t\tenv: mergeEnvironment(options.env, options.inheritEnvironment !== false),\n\t\t\tstdio: \"pipe\",\n\t\t});\n\t\ttry {\n\t\t\tawait waitForConnection(description, context.signal, context.connectTimeoutMs, (resolve, reject) => {\n\t\t\t\tconst onError = (error: Error): void =>\n\t\t\t\t\treject(new Error(`Failed to spawn ${description}: ${error.message}`, { cause: error }));\n\t\t\t\tchild.once(\"spawn\", resolve);\n\t\t\t\tchild.once(\"error\", onError);\n\t\t\t\treturn () => {\n\t\t\t\t\tchild.off(\"spawn\", resolve);\n\t\t\t\t\tchild.off(\"error\", onError);\n\t\t\t\t};\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tawait terminateChild(child);\n\t\t\tthrow error;\n\t\t}\n\n\t\tconst events = createConnectionEvents();\n\t\tlet closed = false;\n\t\tchild.stderr.setEncoding(\"utf8\");\n\t\tchild.stderr.on(\"data\", (chunk: string) => context.onStderr?.(chunk));\n\t\tchild.stdin.on(\"error\", (error: NodeJS.ErrnoException) => {\n\t\t\tif (error.code !== \"EPIPE\" && error.code !== \"ERR_STREAM_DESTROYED\") events.emitError(error);\n\t\t});\n\t\tchild.on(\"error\", (error) => events.emitError(error));\n\t\tchild.on(\"exit\", () => events.emitClose());\n\t\treturn {\n\t\t\treader: new StreamMessageReader(child.stdout),\n\t\t\twriter: new StreamMessageWriter(child.stdin),\n\t\t\tendpoint: {\n\t\t\t\ttype: \"spawn\",\n\t\t\t\tdescription: `${description} (pid ${child.pid ?? \"unknown\"})`,\n\t\t\t\tdisposalMode: \"terminate-process\",\n\t\t\t},\n\t\t\tclose: async () => {\n\t\t\t\tif (closed) return;\n\t\t\t\tclosed = true;\n\t\t\t\tawait terminateChild(child);\n\t\t\t},\n\t\t\tonClose: events.onClose,\n\t\t\tonError: events.onError,\n\t\t};\n\t};\n}\n\nasync function connectSocket(\n\tdescription: string,\n\tendpointType: LspSocketEndpointType,\n\tcontext: LspConnectionFactoryContext,\n\tcreateSocket: () => Socket,\n): Promise<LspConnectionHandle> {\n\tconst socket = createSocket();\n\ttry {\n\t\tawait waitForConnection(description, context.signal, context.connectTimeoutMs, (resolve, reject) => {\n\t\t\tconst onError = (error: Error): void =>\n\t\t\t\treject(new Error(`Failed to connect to ${description}: ${error.message}`, { cause: error }));\n\t\t\tsocket.once(\"connect\", resolve);\n\t\t\tsocket.once(\"error\", onError);\n\t\t\treturn () => {\n\t\t\t\tsocket.off(\"connect\", resolve);\n\t\t\t\tsocket.off(\"error\", onError);\n\t\t\t};\n\t\t});\n\t} catch (error) {\n\t\tsocket.destroy();\n\t\tthrow error;\n\t}\n\n\tconst events = createConnectionEvents();\n\tlet closed = false;\n\tsocket.on(\"error\", (error) => events.emitError(error));\n\tsocket.on(\"close\", () => events.emitClose());\n\treturn {\n\t\treader: new SocketMessageReader(socket),\n\t\twriter: new SocketMessageWriter(socket),\n\t\tendpoint: { type: endpointType, description, disposalMode: \"disconnect\" },\n\t\tclose: async () => {\n\t\t\tif (closed) return;\n\t\t\tclosed = true;\n\t\t\tif (socket.destroyed) return;\n\t\t\tawait new Promise<void>((resolve) => {\n\t\t\t\tsocket.once(\"close\", resolve);\n\t\t\t\tsocket.destroy();\n\t\t\t});\n\t\t},\n\t\tonClose: events.onClose,\n\t\tonError: events.onError,\n\t};\n}\n\nexport function createTcpConnectionFactory(host: string, port: number): LspConnectionFactory {\n\treturn (context) =>\n\t\tconnectSocket(`TCP LSP endpoint ${host}:${port}`, \"tcp\", context, () => createConnection({ host, port }));\n}\n\nexport function createUnixSocketConnectionFactory(path: string): LspConnectionFactory {\n\treturn (context) => connectSocket(`Unix LSP socket ${path}`, \"unix\", context, () => createConnection(path));\n}\n\nexport function createNamedPipeConnectionFactory(path: string): LspConnectionFactory {\n\treturn (context) => connectSocket(`LSP named pipe ${path}`, \"pipe\", context, () => createConnection(path));\n}\n\nexport function resolveLspConnectionFactory(\n\ttransport: LspTransport,\n\tprogrammaticFactories: LspConnectionFactoryRegistry = {},\n): LspConnectionFactory {\n\tswitch (transport.type) {\n\t\tcase \"spawn\":\n\t\t\treturn createManagedStdioConnectionFactory(transport);\n\t\tcase \"tcp\":\n\t\t\treturn createTcpConnectionFactory(transport.host, transport.port);\n\t\tcase \"unix\":\n\t\t\treturn createUnixSocketConnectionFactory(transport.path);\n\t\tcase \"pipe\":\n\t\t\treturn createNamedPipeConnectionFactory(transport.path);\n\t\tcase \"connection\": {\n\t\t\tconst factory = Object.hasOwn(programmaticFactories, transport.id)\n\t\t\t\t? programmaticFactories[transport.id]\n\t\t\t\t: undefined;\n\t\t\tif (!factory) throw new Error(`No LSP connection factory is registered for ${JSON.stringify(transport.id)}`);\n\t\t\treturn factory;\n\t\t}\n\t}\n}\n"]}

package/dist/core/lsp/transport.js

@@ -0,0 +1,261 @@
+import { spawn } from "node:child_process";
+import { createConnection } from "node:net";
+import { SocketMessageReader, SocketMessageWriter, StreamMessageReader, StreamMessageWriter, } from "vscode-languageserver-protocol/node.js";
+import { killProcessTree } from "../../utils/shell.js";
+function createConnectionEvents() {
+    const closeListeners = new Set();
+    const errorListeners = new Set();
+    return {
+        emitClose: () => {
+            for (const listener of closeListeners)
+                listener();
+        },
+        emitError: (error) => {
+            for (const listener of errorListeners)
+                listener(error);
+        },
+        onClose: (listener) => {
+            closeListeners.add(listener);
+            return () => closeListeners.delete(listener);
+        },
+        onError: (listener) => {
+            errorListeners.add(listener);
+            return () => errorListeners.delete(listener);
+        },
+    };
+}
+function abortError(description) {
+    return new Error(`Aborted while connecting to ${description}`);
+}
+async function waitForConnection(description, signal, timeoutMs, subscribe) {
+    if (signal.aborted)
+        throw abortError(description);
+    await new Promise((resolve, reject) => {
+        let settled = false;
+        let timer;
+        let actualUnsubscribe;
+        let unsubscribeRequested = false;
+        const unsubscribe = () => {
+            if (actualUnsubscribe)
+                actualUnsubscribe();
+            else
+                unsubscribeRequested = true;
+        };
+        const cleanup = () => {
+            if (timer)
+                clearTimeout(timer);
+            signal.removeEventListener("abort", onAbort);
+            unsubscribe();
+        };
+        const succeed = () => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            resolve();
+        };
+        const fail = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(error);
+        };
+        const onAbort = () => fail(abortError(description));
+        actualUnsubscribe = subscribe(succeed, fail);
+        if (unsubscribeRequested)
+            actualUnsubscribe();
+        if (settled)
+            return;
+        signal.addEventListener("abort", onAbort, { once: true });
+        if (signal.aborted) {
+            onAbort();
+            return;
+        }
+        if (timeoutMs !== undefined && timeoutMs > 0) {
+            timer = setTimeout(() => fail(new Error(`Timed out connecting to ${description} after ${timeoutMs}ms`)), timeoutMs);
+        }
+    });
+}
+function mergeEnvironment(extra, inheritEnvironment) {
+    return inheritEnvironment ? (extra ? { ...process.env, ...extra } : process.env) : { ...extra };
+}
+function processGroupIsAlive(pid) {
+    if (process.platform === "win32")
+        return false;
+    try {
+        process.kill(-pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function waitForChildExit(exited, timeoutMs) {
+    let timer;
+    const didExit = await Promise.race([
+        exited.then(() => true),
+        new Promise((resolve) => {
+            timer = setTimeout(() => resolve(false), timeoutMs);
+            timer.unref();
+        }),
+    ]);
+    if (timer)
+        clearTimeout(timer);
+    return didExit;
+}
+async function terminateChild(child) {
+    if (child.pid === undefined)
+        return;
+    if (child.exitCode !== null || child.signalCode !== null) {
+        if (processGroupIsAlive(child.pid))
+            killProcessTree(child.pid);
+        await new Promise((resolve) => setImmediate(resolve));
+        return;
+    }
+    const exited = new Promise((resolve) => child.once("exit", () => resolve()));
+    if (child.pid !== undefined && process.platform !== "win32") {
+        try {
+            process.kill(-child.pid, "SIGTERM");
+        }
+        catch {
+            child.kill("SIGTERM");
+        }
+    }
+    else {
+        child.kill("SIGTERM");
+    }
+    const exitedGracefully = await waitForChildExit(exited, 2000);
+    if (exitedGracefully) {
+        if (processGroupIsAlive(child.pid))
+            killProcessTree(child.pid);
+        return;
+    }
+    if (child.exitCode === null && child.signalCode === null && child.pid !== undefined)
+        killProcessTree(child.pid);
+    await waitForChildExit(exited, 2000);
+}
+export function createManagedStdioConnectionFactory(options) {
+    return async (context) => {
+        const cwd = options.cwd ?? context.workspaceRoot;
+        const description = `managed LSP process ${JSON.stringify(options.command)}`;
+        const child = spawn(options.command, options.args ?? [], {
+            cwd,
+            detached: process.platform !== "win32",
+            env: mergeEnvironment(options.env, options.inheritEnvironment !== false),
+            stdio: "pipe",
+        });
+        try {
+            await waitForConnection(description, context.signal, context.connectTimeoutMs, (resolve, reject) => {
+                const onError = (error) => reject(new Error(`Failed to spawn ${description}: ${error.message}`, { cause: error }));
+                child.once("spawn", resolve);
+                child.once("error", onError);
+                return () => {
+                    child.off("spawn", resolve);
+                    child.off("error", onError);
+                };
+            });
+        }
+        catch (error) {
+            await terminateChild(child);
+            throw error;
+        }
+        const events = createConnectionEvents();
+        let closed = false;
+        child.stderr.setEncoding("utf8");
+        child.stderr.on("data", (chunk) => context.onStderr?.(chunk));
+        child.stdin.on("error", (error) => {
+            if (error.code !== "EPIPE" && error.code !== "ERR_STREAM_DESTROYED")
+                events.emitError(error);
+        });
+        child.on("error", (error) => events.emitError(error));
+        child.on("exit", () => events.emitClose());
+        return {
+            reader: new StreamMessageReader(child.stdout),
+            writer: new StreamMessageWriter(child.stdin),
+            endpoint: {
+                type: "spawn",
+                description: `${description} (pid ${child.pid ?? "unknown"})`,
+                disposalMode: "terminate-process",
+            },
+            close: async () => {
+                if (closed)
+                    return;
+                closed = true;
+                await terminateChild(child);
+            },
+            onClose: events.onClose,
+            onError: events.onError,
+        };
+    };
+}
+async function connectSocket(description, endpointType, context, createSocket) {
+    const socket = createSocket();
+    try {
+        await waitForConnection(description, context.signal, context.connectTimeoutMs, (resolve, reject) => {
+            const onError = (error) => reject(new Error(`Failed to connect to ${description}: ${error.message}`, { cause: error }));
+            socket.once("connect", resolve);
+            socket.once("error", onError);
+            return () => {
+                socket.off("connect", resolve);
+                socket.off("error", onError);
+            };
+        });
+    }
+    catch (error) {
+        socket.destroy();
+        throw error;
+    }
+    const events = createConnectionEvents();
+    let closed = false;
+    socket.on("error", (error) => events.emitError(error));
+    socket.on("close", () => events.emitClose());
+    return {
+        reader: new SocketMessageReader(socket),
+        writer: new SocketMessageWriter(socket),
+        endpoint: { type: endpointType, description, disposalMode: "disconnect" },
+        close: async () => {
+            if (closed)
+                return;
+            closed = true;
+            if (socket.destroyed)
+                return;
+            await new Promise((resolve) => {
+                socket.once("close", resolve);
+                socket.destroy();
+            });
+        },
+        onClose: events.onClose,
+        onError: events.onError,
+    };
+}
+export function createTcpConnectionFactory(host, port) {
+    return (context) => connectSocket(`TCP LSP endpoint ${host}:${port}`, "tcp", context, () => createConnection({ host, port }));
+}
+export function createUnixSocketConnectionFactory(path) {
+    return (context) => connectSocket(`Unix LSP socket ${path}`, "unix", context, () => createConnection(path));
+}
+export function createNamedPipeConnectionFactory(path) {
+    return (context) => connectSocket(`LSP named pipe ${path}`, "pipe", context, () => createConnection(path));
+}
+export function resolveLspConnectionFactory(transport, programmaticFactories = {}) {
+    switch (transport.type) {
+        case "spawn":
+            return createManagedStdioConnectionFactory(transport);
+        case "tcp":
+            return createTcpConnectionFactory(transport.host, transport.port);
+        case "unix":
+            return createUnixSocketConnectionFactory(transport.path);
+        case "pipe":
+            return createNamedPipeConnectionFactory(transport.path);
+        case "connection": {
+            const factory = Object.hasOwn(programmaticFactories, transport.id)
+                ? programmaticFactories[transport.id]
+                : undefined;
+            if (!factory)
+                throw new Error(`No LSP connection factory is registered for ${JSON.stringify(transport.id)}`);
+            return factory;
+        }
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/core/lsp/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/core/lsp/transport.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ChildProcessWithoutNullStreams, spawn } from \"node:child_process\";\nimport { createConnection, type Socket } from \"node:net\";\nimport {\n\ttype MessageReader,\n\ttype MessageWriter,\n\tSocketMessageReader,\n\tSocketMessageWriter,\n\tStreamMessageReader,\n\tStreamMessageWriter,\n} from \"vscode-languageserver-protocol/node.js\";\nimport { killProcessTree } from \"../../utils/shell.ts\";\nimport type { LspTransport } from \"./config.ts\";\n\nexport type LspConnectionDisposalMode = \"terminate-process\" | \"disconnect\";\ntype LspSocketEndpointType = \"tcp\" | \"unix\" | \"pipe\";\n\nexport interface LspConnectionEndpoint {\n\ttype: LspTransport[\"type\"];\n\tdescription: string;\n\tdisposalMode: LspConnectionDisposalMode;\n}\n\nexport interface LspConnectionHandle {\n\treader: MessageReader;\n\twriter: MessageWriter;\n\tendpoint: LspConnectionEndpoint;\n\tclose(): Promise<void>;\n\tonClose(listener: () => void): () => void;\n\tonError(listener: (error: Error) => void): () => void;\n}\n\nexport interface LspConnectionFactoryContext {\n\tserverId: string;\n\tworkspaceRoot: string;\n\tworkspaceUri: string;\n\tsignal: AbortSignal;\n\tconnectTimeoutMs?: number;\n\tonStderr?: (text: string) => void;\n}\n\nexport type LspConnectionFactory = (context: LspConnectionFactoryContext) => Promise<LspConnectionHandle>;\n\nexport interface ManagedStdioConnectionOptions {\n\tcommand: string;\n\targs?: string[];\n\tenv?: Record<string, string>;\n\tcwd?: string;\n\tinheritEnvironment?: boolean;\n}\nexport type LspConnectionFactoryRegistry = Readonly<Record<string, LspConnectionFactory>>;\n\ninterface ConnectionEvents {\n\temitClose(): void;\n\temitError(error: Error): void;\n\tonClose(listener: () => void): () => void;\n\tonError(listener: (error: Error) => void): () => void;\n}\n\nfunction createConnectionEvents(): ConnectionEvents {\n\tconst closeListeners = new Set<() => void>();\n\tconst errorListeners = new Set<(error: Error) => void>();\n\treturn {\n\t\temitClose: () => {\n\t\t\tfor (const listener of closeListeners) listener();\n\t\t},\n\t\temitError: (error) => {\n\t\t\tfor (const listener of errorListeners) listener(error);\n\t\t},\n\t\tonClose: (listener) => {\n\t\t\tcloseListeners.add(listener);\n\t\t\treturn () => closeListeners.delete(listener);\n\t\t},\n\t\tonError: (listener) => {\n\t\t\terrorListeners.add(listener);\n\t\t\treturn () => errorListeners.delete(listener);\n\t\t},\n\t};\n}\n\nfunction abortError(description: string): Error {\n\treturn new Error(`Aborted while connecting to ${description}`);\n}\n\nasync function waitForConnection(\n\tdescription: string,\n\tsignal: AbortSignal,\n\ttimeoutMs: number | undefined,\n\tsubscribe: (resolve: () => void, reject: (error: Error) => void) => () => void,\n): Promise<void> {\n\tif (signal.aborted) throw abortError(description);\n\tawait new Promise<void>((resolve, reject) => {\n\t\tlet settled = false;\n\t\tlet timer: NodeJS.Timeout | undefined;\n\t\tlet actualUnsubscribe: (() => void) | undefined;\n\t\tlet unsubscribeRequested = false;\n\t\tconst unsubscribe = (): void => {\n\t\t\tif (actualUnsubscribe) actualUnsubscribe();\n\t\t\telse unsubscribeRequested = true;\n\t\t};\n\t\tconst cleanup = (): void => {\n\t\t\tif (timer) clearTimeout(timer);\n\t\t\tsignal.removeEventListener(\"abort\", onAbort);\n\t\t\tunsubscribe();\n\t\t};\n\t\tconst succeed = (): void => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tcleanup();\n\t\t\tresolve();\n\t\t};\n\t\tconst fail = (error: Error): void => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tcleanup();\n\t\t\treject(error);\n\t\t};\n\t\tconst onAbort = (): void => fail(abortError(description));\n\t\tactualUnsubscribe = subscribe(succeed, fail);\n\t\tif (unsubscribeRequested) actualUnsubscribe();\n\t\tif (settled) return;\n\t\tsignal.addEventListener(\"abort\", onAbort, { once: true });\n\t\tif (signal.aborted) {\n\t\t\tonAbort();\n\t\t\treturn;\n\t\t}\n\t\tif (timeoutMs !== undefined && timeoutMs > 0) {\n\t\t\ttimer = setTimeout(\n\t\t\t\t() => fail(new Error(`Timed out connecting to ${description} after ${timeoutMs}ms`)),\n\t\t\t\ttimeoutMs,\n\t\t\t);\n\t\t}\n\t});\n}\n\nfunction mergeEnvironment(extra: Record<string, string> | undefined, inheritEnvironment: boolean): NodeJS.ProcessEnv {\n\treturn inheritEnvironment ? (extra ? { ...process.env, ...extra } : process.env) : { ...extra };\n}\n\nfunction processGroupIsAlive(pid: number): boolean {\n\tif (process.platform === \"win32\") return false;\n\ttry {\n\t\tprocess.kill(-pid, 0);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nasync function waitForChildExit(exited: Promise<void>, timeoutMs: number): Promise<boolean> {\n\tlet timer: NodeJS.Timeout | undefined;\n\tconst didExit = await Promise.race([\n\t\texited.then(() => true),\n\t\tnew Promise<false>((resolve) => {\n\t\t\ttimer = setTimeout(() => resolve(false), timeoutMs);\n\t\t\ttimer.unref();\n\t\t}),\n\t]);\n\tif (timer) clearTimeout(timer);\n\treturn didExit;\n}\n\nasync function terminateChild(child: ChildProcessWithoutNullStreams): Promise<void> {\n\tif (child.pid === undefined) return;\n\tif (child.exitCode !== null || child.signalCode !== null) {\n\t\tif (processGroupIsAlive(child.pid)) killProcessTree(child.pid);\n\t\tawait new Promise<void>((resolve) => setImmediate(resolve));\n\t\treturn;\n\t}\n\tconst exited = new Promise<void>((resolve) => child.once(\"exit\", () => resolve()));\n\tif (child.pid !== undefined && process.platform !== \"win32\") {\n\t\ttry {\n\t\t\tprocess.kill(-child.pid, \"SIGTERM\");\n\t\t} catch {\n\t\t\tchild.kill(\"SIGTERM\");\n\t\t}\n\t} else {\n\t\tchild.kill(\"SIGTERM\");\n\t}\n\tconst exitedGracefully = await waitForChildExit(exited, 2000);\n\tif (exitedGracefully) {\n\t\tif (processGroupIsAlive(child.pid)) killProcessTree(child.pid);\n\t\treturn;\n\t}\n\tif (child.exitCode === null && child.signalCode === null && child.pid !== undefined) killProcessTree(child.pid);\n\tawait waitForChildExit(exited, 2000);\n}\n\nexport function createManagedStdioConnectionFactory(options: ManagedStdioConnectionOptions): LspConnectionFactory {\n\treturn async (context) => {\n\t\tconst cwd = options.cwd ?? context.workspaceRoot;\n\t\tconst description = `managed LSP process ${JSON.stringify(options.command)}`;\n\t\tconst child = spawn(options.command, options.args ?? [], {\n\t\t\tcwd,\n\t\t\tdetached: process.platform !== \"win32\",\n\t\t\tenv: mergeEnvironment(options.env, options.inheritEnvironment !== false),\n\t\t\tstdio: \"pipe\",\n\t\t});\n\t\ttry {\n\t\t\tawait waitForConnection(description, context.signal, context.connectTimeoutMs, (resolve, reject) => {\n\t\t\t\tconst onError = (error: Error): void =>\n\t\t\t\t\treject(new Error(`Failed to spawn ${description}: ${error.message}`, { cause: error }));\n\t\t\t\tchild.once(\"spawn\", resolve);\n\t\t\t\tchild.once(\"error\", onError);\n\t\t\t\treturn () => {\n\t\t\t\t\tchild.off(\"spawn\", resolve);\n\t\t\t\t\tchild.off(\"error\", onError);\n\t\t\t\t};\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tawait terminateChild(child);\n\t\t\tthrow error;\n\t\t}\n\n\t\tconst events = createConnectionEvents();\n\t\tlet closed = false;\n\t\tchild.stderr.setEncoding(\"utf8\");\n\t\tchild.stderr.on(\"data\", (chunk: string) => context.onStderr?.(chunk));\n\t\tchild.stdin.on(\"error\", (error: NodeJS.ErrnoException) => {\n\t\t\tif (error.code !== \"EPIPE\" && error.code !== \"ERR_STREAM_DESTROYED\") events.emitError(error);\n\t\t});\n\t\tchild.on(\"error\", (error) => events.emitError(error));\n\t\tchild.on(\"exit\", () => events.emitClose());\n\t\treturn {\n\t\t\treader: new StreamMessageReader(child.stdout),\n\t\t\twriter: new StreamMessageWriter(child.stdin),\n\t\t\tendpoint: {\n\t\t\t\ttype: \"spawn\",\n\t\t\t\tdescription: `${description} (pid ${child.pid ?? \"unknown\"})`,\n\t\t\t\tdisposalMode: \"terminate-process\",\n\t\t\t},\n\t\t\tclose: async () => {\n\t\t\t\tif (closed) return;\n\t\t\t\tclosed = true;\n\t\t\t\tawait terminateChild(child);\n\t\t\t},\n\t\t\tonClose: events.onClose,\n\t\t\tonError: events.onError,\n\t\t};\n\t};\n}\n\nasync function connectSocket(\n\tdescription: string,\n\tendpointType: LspSocketEndpointType,\n\tcontext: LspConnectionFactoryContext,\n\tcreateSocket: () => Socket,\n): Promise<LspConnectionHandle> {\n\tconst socket = createSocket();\n\ttry {\n\t\tawait waitForConnection(description, context.signal, context.connectTimeoutMs, (resolve, reject) => {\n\t\t\tconst onError = (error: Error): void =>\n\t\t\t\treject(new Error(`Failed to connect to ${description}: ${error.message}`, { cause: error }));\n\t\t\tsocket.once(\"connect\", resolve);\n\t\t\tsocket.once(\"error\", onError);\n\t\t\treturn () => {\n\t\t\t\tsocket.off(\"connect\", resolve);\n\t\t\t\tsocket.off(\"error\", onError);\n\t\t\t};\n\t\t});\n\t} catch (error) {\n\t\tsocket.destroy();\n\t\tthrow error;\n\t}\n\n\tconst events = createConnectionEvents();\n\tlet closed = false;\n\tsocket.on(\"error\", (error) => events.emitError(error));\n\tsocket.on(\"close\", () => events.emitClose());\n\treturn {\n\t\treader: new SocketMessageReader(socket),\n\t\twriter: new SocketMessageWriter(socket),\n\t\tendpoint: { type: endpointType, description, disposalMode: \"disconnect\" },\n\t\tclose: async () => {\n\t\t\tif (closed) return;\n\t\t\tclosed = true;\n\t\t\tif (socket.destroyed) return;\n\t\t\tawait new Promise<void>((resolve) => {\n\t\t\t\tsocket.once(\"close\", resolve);\n\t\t\t\tsocket.destroy();\n\t\t\t});\n\t\t},\n\t\tonClose: events.onClose,\n\t\tonError: events.onError,\n\t};\n}\n\nexport function createTcpConnectionFactory(host: string, port: number): LspConnectionFactory {\n\treturn (context) =>\n\t\tconnectSocket(`TCP LSP endpoint ${host}:${port}`, \"tcp\", context, () => createConnection({ host, port }));\n}\n\nexport function createUnixSocketConnectionFactory(path: string): LspConnectionFactory {\n\treturn (context) => connectSocket(`Unix LSP socket ${path}`, \"unix\", context, () => createConnection(path));\n}\n\nexport function createNamedPipeConnectionFactory(path: string): LspConnectionFactory {\n\treturn (context) => connectSocket(`LSP named pipe ${path}`, \"pipe\", context, () => createConnection(path));\n}\n\nexport function resolveLspConnectionFactory(\n\ttransport: LspTransport,\n\tprogrammaticFactories: LspConnectionFactoryRegistry = {},\n): LspConnectionFactory {\n\tswitch (transport.type) {\n\t\tcase \"spawn\":\n\t\t\treturn createManagedStdioConnectionFactory(transport);\n\t\tcase \"tcp\":\n\t\t\treturn createTcpConnectionFactory(transport.host, transport.port);\n\t\tcase \"unix\":\n\t\t\treturn createUnixSocketConnectionFactory(transport.path);\n\t\tcase \"pipe\":\n\t\t\treturn createNamedPipeConnectionFactory(transport.path);\n\t\tcase \"connection\": {\n\t\t\tconst factory = Object.hasOwn(programmaticFactories, transport.id)\n\t\t\t\t? programmaticFactories[transport.id]\n\t\t\t\t: undefined;\n\t\t\tif (!factory) throw new Error(`No LSP connection factory is registered for ${JSON.stringify(transport.id)}`);\n\t\t\treturn factory;\n\t\t}\n\t}\n}\n"]}

package/dist/core/messages.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Custom message types and transformers for the coding agent.
+ *
+ * Extends the base AgentMessage type with coding-agent specific message types,
+ * and provides a transformer to convert them to LLM-compatible messages.
+ */
+import type { AgentMessage, BashExecutionMessage, BranchSummaryMessage, CompactionSummaryMessage, CustomMessage } from "@greppleai/grip-agent-core";
+export type { BashExecutionMessage, BranchSummaryMessage, CompactionSummaryMessage, CustomMessage, } from "@greppleai/grip-agent-core";
+import type { ImageContent, Message, TextContent } from "@greppleai/grip-ai";
+export declare const COMPACTION_SUMMARY_PREFIX = "The conversation history before this point was compacted into the following summary:\n\n<summary>\n";
+export declare const COMPACTION_SUMMARY_SUFFIX = "\n</summary>";
+export declare const BRANCH_SUMMARY_PREFIX = "The following is a summary of a branch that this conversation came back from:\n\n<summary>\n";
+export declare const BRANCH_SUMMARY_SUFFIX = "</summary>";
+export declare const STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE = "structured_response_internal";
+/**
+ * Convert a BashExecutionMessage to user message text for LLM context.
+ */
+export declare function bashExecutionToText(msg: BashExecutionMessage): string;
+export declare function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage;
+export declare function createCompactionSummaryMessage(summary: string, tokensBefore: number, timestamp: string): CompactionSummaryMessage;
+/** Normalize content-bearing messages received from untyped extension and session boundaries. */
+export declare function normalizeMessageContent(message: AgentMessage): AgentMessage;
+/** Convert CustomMessageEntry to AgentMessage format */
+export declare function createCustomMessage(customType: string, content: string | (TextContent | ImageContent)[], display: boolean, details: unknown | undefined, timestamp: string): CustomMessage;
+/**
+ * Transform AgentMessages (including custom types) to LLM-compatible Messages.
+ *
+ * This is used by:
+ * - Agent's transormToLlm option (for prompt calls and queued messages)
+ * - Compaction's generateSummary (for summarization)
+ * - Custom extensions and tools
+ */
+export declare function convertToLlm(messages: AgentMessage[]): Message[];
+//# sourceMappingURL=messages.d.ts.map

package/dist/core/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/core/messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,aAAa,EACb,MAAM,4BAA4B,CAAC;AAIpC,YAAY,EACX,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,aAAa,GACb,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE7E,eAAO,MAAM,yBAAyB,wGAGrC,CAAC;AAEF,eAAO,MAAM,yBAAyB,iBAC3B,CAAC;AAEZ,eAAO,MAAM,qBAAqB,iGAGjC,CAAC;AAEF,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAElD,eAAO,MAAM,wCAAwC,iCAAiC,CAAC;AAEvF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,CAgBrE;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,oBAAoB,CAOnH;AAED,wBAAgB,8BAA8B,CAC7C,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GACf,wBAAwB,CAO1B;AAED,iGAAiG;AACjG,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAW3E;AAED,wDAAwD;AACxD,wBAAgB,mBAAmB,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,EAChD,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,SAAS,EAAE,MAAM,GACf,aAAa,CASf;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,CAqDhE","sourcesContent":["/**\n * Custom message types and transformers for the coding agent.\n *\n * Extends the base AgentMessage type with coding-agent specific message types,\n * and provides a transformer to convert them to LLM-compatible messages.\n */\n\nimport type {\n\tAgentMessage,\n\tBashExecutionMessage,\n\tBranchSummaryMessage,\n\tCompactionSummaryMessage,\n\tCustomMessage,\n} from \"@greppleai/grip-agent-core\";\n\nimport { HOOK_EXECUTION_CUSTOM_TYPE } from \"./hooks/types.ts\";\n\nexport type {\n\tBashExecutionMessage,\n\tBranchSummaryMessage,\n\tCompactionSummaryMessage,\n\tCustomMessage,\n} from \"@greppleai/grip-agent-core\";\n\nimport type { ImageContent, Message, TextContent } from \"@greppleai/grip-ai\";\n\nexport const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:\n\n<summary>\n`;\n\nexport const COMPACTION_SUMMARY_SUFFIX = `\n</summary>`;\n\nexport const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:\n\n<summary>\n`;\n\nexport const BRANCH_SUMMARY_SUFFIX = `</summary>`;\n\nexport const STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE = \"structured_response_internal\";\n\n/**\n * Convert a BashExecutionMessage to user message text for LLM context.\n */\nexport function bashExecutionToText(msg: BashExecutionMessage): string {\n\tlet text = `Ran \\`${msg.command}\\`\\n`;\n\tif (msg.output) {\n\t\ttext += `\\`\\`\\`\\n${msg.output}\\n\\`\\`\\``;\n\t} else {\n\t\ttext += \"(no output)\";\n\t}\n\tif (msg.cancelled) {\n\t\ttext += \"\\n\\n(command cancelled)\";\n\t} else if (msg.exitCode !== null && msg.exitCode !== undefined && msg.exitCode !== 0) {\n\t\ttext += `\\n\\nCommand exited with code ${msg.exitCode}`;\n\t}\n\tif (msg.truncated && msg.fullOutputPath) {\n\t\ttext += `\\n\\n[Output truncated. Full output: ${msg.fullOutputPath}]`;\n\t}\n\treturn text;\n}\n\nexport function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage {\n\treturn {\n\t\trole: \"branchSummary\",\n\t\tsummary,\n\t\tfromId,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\nexport function createCompactionSummaryMessage(\n\tsummary: string,\n\ttokensBefore: number,\n\ttimestamp: string,\n): CompactionSummaryMessage {\n\treturn {\n\t\trole: \"compactionSummary\",\n\t\tsummary: summary,\n\t\ttokensBefore,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/** Normalize content-bearing messages received from untyped extension and session boundaries. */\nexport function normalizeMessageContent(message: AgentMessage): AgentMessage {\n\tif (\n\t\t(message.role === \"user\" ||\n\t\t\tmessage.role === \"assistant\" ||\n\t\t\tmessage.role === \"toolResult\" ||\n\t\t\tmessage.role === \"custom\") &&\n\t\tmessage.content == null\n\t) {\n\t\treturn { ...message, content: [] } as AgentMessage;\n\t}\n\treturn message;\n}\n\n/** Convert CustomMessageEntry to AgentMessage format */\nexport function createCustomMessage(\n\tcustomType: string,\n\tcontent: string | (TextContent | ImageContent)[],\n\tdisplay: boolean,\n\tdetails: unknown | undefined,\n\ttimestamp: string,\n): CustomMessage {\n\treturn {\n\t\trole: \"custom\",\n\t\tcustomType,\n\t\tcontent: content ?? [],\n\t\tdisplay,\n\t\tdetails,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/**\n * Transform AgentMessages (including custom types) to LLM-compatible Messages.\n *\n * This is used by:\n * - Agent's transormToLlm option (for prompt calls and queued messages)\n * - Compaction's generateSummary (for summarization)\n * - Custom extensions and tools\n */\nexport function convertToLlm(messages: AgentMessage[]): Message[] {\n\treturn messages\n\t\t.map((m): Message | undefined => {\n\t\t\tswitch (m.role) {\n\t\t\t\tcase \"bashExecution\":\n\t\t\t\t\t// Skip messages excluded from context (!! prefix)\n\t\t\t\t\tif (m.excludeFromContext) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: bashExecutionToText(m) }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"custom\": {\n\t\t\t\t\tif (\n\t\t\t\t\t\tm.customType === STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE ||\n\t\t\t\t\t\tm.customType === HOOK_EXECUTION_CUSTOM_TYPE\n\t\t\t\t\t) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\tconst content = typeof m.content === \"string\" ? [{ type: \"text\" as const, text: m.content }] : m.content;\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent,\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tcase \"branchSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\" as const, text: BRANCH_SUMMARY_PREFIX + m.summary + BRANCH_SUMMARY_SUFFIX }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"compactionSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{ type: \"text\" as const, text: COMPACTION_SUMMARY_PREFIX + m.summary + COMPACTION_SUMMARY_SUFFIX },\n\t\t\t\t\t\t],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"user\":\n\t\t\t\tcase \"assistant\":\n\t\t\t\tcase \"toolResult\":\n\t\t\t\t\treturn m;\n\t\t\t\tdefault:\n\t\t\t\t\t// biome-ignore lint/correctness/noSwitchDeclarations: fine\n\t\t\t\t\tconst _exhaustiveCheck: never = m;\n\t\t\t\t\treturn undefined;\n\t\t\t}\n\t\t})\n\t\t.filter((m) => m !== undefined);\n}\n"]}

package/dist/core/messages.js

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

package/dist/core/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/core/messages.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Custom message types and transformers for the coding agent.\n *\n * Extends the base AgentMessage type with coding-agent specific message types,\n * and provides a transformer to convert them to LLM-compatible messages.\n */\n\nimport type {\n\tAgentMessage,\n\tBashExecutionMessage,\n\tBranchSummaryMessage,\n\tCompactionSummaryMessage,\n\tCustomMessage,\n} from \"@greppleai/grip-agent-core\";\n\nimport { HOOK_EXECUTION_CUSTOM_TYPE } from \"./hooks/types.ts\";\n\nexport type {\n\tBashExecutionMessage,\n\tBranchSummaryMessage,\n\tCompactionSummaryMessage,\n\tCustomMessage,\n} from \"@greppleai/grip-agent-core\";\n\nimport type { ImageContent, Message, TextContent } from \"@greppleai/grip-ai\";\n\nexport const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:\n\n<summary>\n`;\n\nexport const COMPACTION_SUMMARY_SUFFIX = `\n</summary>`;\n\nexport const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:\n\n<summary>\n`;\n\nexport const BRANCH_SUMMARY_SUFFIX = `</summary>`;\n\nexport const STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE = \"structured_response_internal\";\n\n/**\n * Convert a BashExecutionMessage to user message text for LLM context.\n */\nexport function bashExecutionToText(msg: BashExecutionMessage): string {\n\tlet text = `Ran \\`${msg.command}\\`\\n`;\n\tif (msg.output) {\n\t\ttext += `\\`\\`\\`\\n${msg.output}\\n\\`\\`\\``;\n\t} else {\n\t\ttext += \"(no output)\";\n\t}\n\tif (msg.cancelled) {\n\t\ttext += \"\\n\\n(command cancelled)\";\n\t} else if (msg.exitCode !== null && msg.exitCode !== undefined && msg.exitCode !== 0) {\n\t\ttext += `\\n\\nCommand exited with code ${msg.exitCode}`;\n\t}\n\tif (msg.truncated && msg.fullOutputPath) {\n\t\ttext += `\\n\\n[Output truncated. Full output: ${msg.fullOutputPath}]`;\n\t}\n\treturn text;\n}\n\nexport function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage {\n\treturn {\n\t\trole: \"branchSummary\",\n\t\tsummary,\n\t\tfromId,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\nexport function createCompactionSummaryMessage(\n\tsummary: string,\n\ttokensBefore: number,\n\ttimestamp: string,\n): CompactionSummaryMessage {\n\treturn {\n\t\trole: \"compactionSummary\",\n\t\tsummary: summary,\n\t\ttokensBefore,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/** Normalize content-bearing messages received from untyped extension and session boundaries. */\nexport function normalizeMessageContent(message: AgentMessage): AgentMessage {\n\tif (\n\t\t(message.role === \"user\" ||\n\t\t\tmessage.role === \"assistant\" ||\n\t\t\tmessage.role === \"toolResult\" ||\n\t\t\tmessage.role === \"custom\") &&\n\t\tmessage.content == null\n\t) {\n\t\treturn { ...message, content: [] } as AgentMessage;\n\t}\n\treturn message;\n}\n\n/** Convert CustomMessageEntry to AgentMessage format */\nexport function createCustomMessage(\n\tcustomType: string,\n\tcontent: string | (TextContent | ImageContent)[],\n\tdisplay: boolean,\n\tdetails: unknown | undefined,\n\ttimestamp: string,\n): CustomMessage {\n\treturn {\n\t\trole: \"custom\",\n\t\tcustomType,\n\t\tcontent: content ?? [],\n\t\tdisplay,\n\t\tdetails,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/**\n * Transform AgentMessages (including custom types) to LLM-compatible Messages.\n *\n * This is used by:\n * - Agent's transormToLlm option (for prompt calls and queued messages)\n * - Compaction's generateSummary (for summarization)\n * - Custom extensions and tools\n */\nexport function convertToLlm(messages: AgentMessage[]): Message[] {\n\treturn messages\n\t\t.map((m): Message | undefined => {\n\t\t\tswitch (m.role) {\n\t\t\t\tcase \"bashExecution\":\n\t\t\t\t\t// Skip messages excluded from context (!! prefix)\n\t\t\t\t\tif (m.excludeFromContext) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: bashExecutionToText(m) }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"custom\": {\n\t\t\t\t\tif (\n\t\t\t\t\t\tm.customType === STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE ||\n\t\t\t\t\t\tm.customType === HOOK_EXECUTION_CUSTOM_TYPE\n\t\t\t\t\t) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\tconst content = typeof m.content === \"string\" ? [{ type: \"text\" as const, text: m.content }] : m.content;\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent,\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tcase \"branchSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\" as const, text: BRANCH_SUMMARY_PREFIX + m.summary + BRANCH_SUMMARY_SUFFIX }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"compactionSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{ type: \"text\" as const, text: COMPACTION_SUMMARY_PREFIX + m.summary + COMPACTION_SUMMARY_SUFFIX },\n\t\t\t\t\t\t],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"user\":\n\t\t\t\tcase \"assistant\":\n\t\t\t\tcase \"toolResult\":\n\t\t\t\t\treturn m;\n\t\t\t\tdefault:\n\t\t\t\t\t// biome-ignore lint/correctness/noSwitchDeclarations: fine\n\t\t\t\t\tconst _exhaustiveCheck: never = m;\n\t\t\t\t\treturn undefined;\n\t\t\t}\n\t\t})\n\t\t.filter((m) => m !== undefined);\n}\n"]}