@greppleai/grip 0.0.0-stage → 0.1.3

package/dist/core/tools/bash.js

@@ -0,0 +1,321 @@
+import { Container, Text, truncateToWidth } from "@greppleai/grip-tui";
+import { Type } from "typebox";
+import { keyText } from "../../modes/interactive/components/keybinding-hints.js";
+import { truncateToVisualLines } from "../../modes/interactive/components/visual-truncate.js";
+import { theme } from "../../modes/interactive/theme/theme.js";
+import { getShellEnv } from "../../utils/shell.js";
+import { GRIP_SESSION_ENVIRONMENT_NAMES, LocalToolOperations, } from "./operations.js";
+import { OutputAccumulator } from "./output-accumulator.js";
+import { formatBackendIcon, getTextOutput, invalidArgText, str } from "./render-utils.js";
+import { wrapToolDefinition } from "./tool-definition-wrapper.js";
+import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize } from "./truncate.js";
+const bashSchema = Type.Object({
+    command: Type.String({ description: "Bash command to execute" }),
+    timeout: Type.Optional(Type.Number({ description: "Timeout in seconds (optional, no default timeout)" })),
+});
+export function createLocalBashOperations(options) {
+    return new LocalToolOperations(options?.cwd ?? process.cwd(), { shellPath: options?.shellPath });
+}
+export function getBashSessionEnvironment(ctx) {
+    if (!ctx?.session)
+        return {};
+    const environment = {
+        GRIP_SESSION_ID: ctx.session.getSessionId(),
+    };
+    if (ctx.thinkingLevel)
+        environment.GRIP_REASONING_LEVEL = ctx.thinkingLevel;
+    const sessionFile = ctx.session.getSessionReference();
+    if (sessionFile)
+        environment.GRIP_SESSION_FILE = sessionFile;
+    if (ctx.model) {
+        environment.GRIP_PROVIDER = ctx.model.provider;
+        environment.GRIP_MODEL = ctx.model.id;
+    }
+    return environment;
+}
+function resolveSpawnContext(command, cwd, spawnHook, exposeSessionEnvironment, ctx) {
+    const env = { ...getShellEnv() };
+    for (const name of GRIP_SESSION_ENVIRONMENT_NAMES)
+        delete env[name];
+    if (exposeSessionEnvironment)
+        Object.assign(env, getBashSessionEnvironment(ctx));
+    const baseContext = { command, cwd, env };
+    return spawnHook ? spawnHook(baseContext) : baseContext;
+}
+const BASH_PREVIEW_LINES = 5;
+const BASH_UPDATE_THROTTLE_MS = 100;
+class BashResultRenderComponent extends Container {
+    state = {
+        cachedWidth: undefined,
+        cachedLines: undefined,
+        cachedSkipped: undefined,
+    };
+}
+function formatDuration(ms) {
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+function formatBackendSuffix(backendInfo) {
+    if (!backendInfo)
+        return "";
+    if (backendInfo.type === "local")
+        return theme.fg("muted", ` [local ${backendInfo.cwd}]`);
+    return backendInfo.configured
+        ? theme.fg("muted", ` [remote ${backendInfo.url}:${backendInfo.cwd}]`)
+        : theme.fg("warning", ` [remote not configured ${backendInfo.cwd}]`);
+}
+function formatBashCall(args, backendInfo) {
+    const command = str(args?.command);
+    const timeout = args?.timeout;
+    const timeoutSuffix = timeout ? theme.fg("muted", ` (timeout ${timeout}s)`) : "";
+    const commandDisplay = command === null ? invalidArgText(theme) : command ? command : theme.fg("toolOutput", "...");
+    return (formatBackendIcon(backendInfo, theme) +
+        theme.fg("toolTitle", theme.bold("$ ")) +
+        theme.fg("accent", theme.bold(commandDisplay)) +
+        timeoutSuffix);
+}
+function getBashDisplayOutput(result, showImages, isPartial) {
+    const output = getTextOutput(result, showImages).trim();
+    const truncation = result.details?.truncation;
+    const fullOutputPath = result.details?.fullOutputPath;
+    if (isPartial || !truncation?.truncated || !fullOutputPath || !output.endsWith("]"))
+        return output;
+    const footerStart = output.lastIndexOf("\n\n[");
+    if (footerStart === -1 || !output.slice(footerStart).includes(fullOutputPath))
+        return output;
+    return output.slice(0, footerStart).trimEnd();
+}
+function addBashOutput(component, state, output, options) {
+    if (!output)
+        return;
+    const styledOutput = output
+        .split("\n")
+        .map((line) => theme.fg("toolOutput", line))
+        .join("\n");
+    if (options.expanded) {
+        component.addChild(new Text(`\n${styledOutput}`, 0, 0));
+        return;
+    }
+    component.addChild({
+        render: (width) => {
+            if (state.cachedLines === undefined || state.cachedWidth !== width) {
+                const preview = truncateToVisualLines(styledOutput, BASH_PREVIEW_LINES, width);
+                state.cachedLines = preview.visualLines;
+                state.cachedSkipped = preview.skippedCount;
+                state.cachedWidth = width;
+            }
+            return ["", ...(state.cachedLines ?? [])];
+        },
+        invalidate: () => {
+            state.cachedWidth = undefined;
+            state.cachedLines = undefined;
+            state.cachedSkipped = undefined;
+        },
+    });
+}
+function addBashOutputWarnings(component, truncation, fullOutputPath) {
+    if (!truncation?.truncated && !fullOutputPath)
+        return;
+    const warnings = [];
+    if (fullOutputPath)
+        warnings.push(`Full output: ${fullOutputPath}`);
+    if (truncation?.truncated) {
+        if (truncation.truncatedBy === "lines") {
+            warnings.push(`Truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines`);
+        }
+        else {
+            warnings.push(`Truncated: ${truncation.outputLines} lines shown (${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit)`);
+        }
+    }
+    component.addChild(new Text(`\n${theme.fg("warning", `[${warnings.join(". ")}]`)}`, 0, 0));
+}
+function rebuildBashResultRenderComponent(component, result, options, isError, showImages, startedAt, endedAt, backendInfo) {
+    const state = component.state;
+    component.clear();
+    const output = getBashDisplayOutput(result, showImages, options.isPartial);
+    addBashOutput(component, state, output, options);
+    addBashOutputWarnings(component, result.details?.truncation, result.details?.fullOutputPath);
+    if (startedAt !== undefined) {
+        const label = options.isPartial ? "Elapsed" : "Took";
+        const endTime = endedAt ?? Date.now();
+        component.addChild(new Text(`\n${theme.fg(options.isPartial ? "muted" : isError ? "error" : "success", `${label} ${formatDuration(endTime - startedAt)}`)}${formatBackendSuffix(backendInfo)}`, 0, 0));
+    }
+    if (!options.expanded && output) {
+        component.addChild({
+            render: (width) => {
+                if (!state.cachedSkipped || width < 1)
+                    return [];
+                const expandKey = keyText("app.tools.expand");
+                const hint = theme.fg("warning", `${state.cachedSkipped} lines hidden`) +
+                    (expandKey ? theme.fg("accent", ` · ${expandKey} to expand`) : "");
+                return ["", truncateToWidth(hint, width, "...")];
+            },
+            invalidate: () => { },
+        });
+    }
+}
+function appendBashStatus(text, status) {
+    return `${text ? `${text}\n\n` : ""}${status}`;
+}
+function throwBashExecutionError(error, outputText) {
+    if (error instanceof Error && error.message === "aborted") {
+        throw new Error(appendBashStatus(outputText, "Command aborted"));
+    }
+    if (error instanceof Error && error.message.startsWith("timeout:")) {
+        const timeoutSeconds = error.message.split(":")[1];
+        throw new Error(appendBashStatus(outputText, `Command timed out after ${timeoutSeconds} seconds`));
+    }
+    throw error;
+}
+export function createBashToolDefinition(operations, options) {
+    const ops = operations;
+    const commandPrefix = options?.commandPrefix;
+    const exposeSessionEnvironment = options?.exposeSessionEnvironment ?? true;
+    const spawnHook = options?.spawnHook;
+    return {
+        name: "bash",
+        label: "bash",
+        description: `Execute a bash command in the current working directory. Returns stdout and stderr. Output is truncated to last ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). If truncated, full output is saved to a temp file. Optionally provide a timeout in seconds.`,
+        promptSnippet: "Execute bash commands (ls, grep, find, etc.)",
+        promptGuidelines: exposeSessionEnvironment
+            ? ["Inspect GRIP_* environment variables for current model and session details."]
+            : undefined,
+        parameters: bashSchema,
+        async execute(_toolCallId, { command, timeout }, signal, onUpdate, ctx) {
+            const resolvedCommand = commandPrefix ? `${commandPrefix}\n${command}` : command;
+            const spawnContext = resolveSpawnContext(resolvedCommand, ops.cwd, spawnHook, exposeSessionEnvironment, ctx);
+            const output = new OutputAccumulator({ tempFilePrefix: "grip-bash" });
+            let updateTimer;
+            let updateDirty = false;
+            let lastUpdateAt = 0;
+            const emitOutputUpdate = () => {
+                if (!onUpdate || !updateDirty)
+                    return;
+                updateDirty = false;
+                lastUpdateAt = Date.now();
+                const snapshot = output.snapshot({ persistIfTruncated: true });
+                onUpdate({
+                    content: [{ type: "text", text: snapshot.content || "" }],
+                    details: {
+                        truncation: snapshot.truncation.truncated ? snapshot.truncation : undefined,
+                        fullOutputPath: snapshot.fullOutputPath,
+                    },
+                });
+            };
+            const clearUpdateTimer = () => {
+                if (updateTimer) {
+                    clearTimeout(updateTimer);
+                    updateTimer = undefined;
+                }
+            };
+            const scheduleOutputUpdate = () => {
+                if (!onUpdate)
+                    return;
+                updateDirty = true;
+                const delay = BASH_UPDATE_THROTTLE_MS - (Date.now() - lastUpdateAt);
+                if (delay <= 0) {
+                    clearUpdateTimer();
+                    emitOutputUpdate();
+                    return;
+                }
+                updateTimer ??= setTimeout(() => {
+                    updateTimer = undefined;
+                    emitOutputUpdate();
+                }, delay);
+            };
+            if (onUpdate) {
+                onUpdate({ content: [], details: undefined });
+            }
+            const handleData = (data) => {
+                output.append(data);
+                scheduleOutputUpdate();
+            };
+            const finishOutput = async () => {
+                output.finish();
+                clearUpdateTimer();
+                emitOutputUpdate();
+                const snapshot = output.snapshot({ persistIfTruncated: true });
+                await output.closeTempFile();
+                return snapshot;
+            };
+            const formatOutput = (snapshot, emptyText = "(no output)") => {
+                const truncation = snapshot.truncation;
+                let text = snapshot.content || emptyText;
+                let details;
+                if (truncation.truncated) {
+                    details = { truncation, fullOutputPath: snapshot.fullOutputPath };
+                    const startLine = truncation.totalLines - truncation.outputLines + 1;
+                    const endLine = truncation.totalLines;
+                    if (truncation.lastLinePartial) {
+                        const lastLineSize = formatSize(output.getLastLineBytes());
+                        text += `\n\n[Showing last ${formatSize(truncation.outputBytes)} of line ${endLine} (line is ${lastLineSize}). Full output: ${snapshot.fullOutputPath}]`;
+                    }
+                    else if (truncation.truncatedBy === "lines") {
+                        text += `\n\n[Showing lines ${startLine}-${endLine} of ${truncation.totalLines}. Full output: ${snapshot.fullOutputPath}]`;
+                    }
+                    else {
+                        text += `\n\n[Showing lines ${startLine}-${endLine} of ${truncation.totalLines} (${formatSize(DEFAULT_MAX_BYTES)} limit). Full output: ${snapshot.fullOutputPath}]`;
+                    }
+                }
+                return { text, details };
+            };
+            try {
+                let exitCode;
+                try {
+                    const result = await ops.exec(spawnContext.command, {
+                        cwd: spawnContext.cwd,
+                        onData: handleData,
+                        signal,
+                        timeout,
+                        env: spawnContext.env,
+                    });
+                    exitCode = result.exitCode;
+                }
+                catch (err) {
+                    const snapshot = await finishOutput();
+                    const { text } = formatOutput(snapshot, "");
+                    throwBashExecutionError(err, text);
+                }
+                const snapshot = await finishOutput();
+                const { text: outputText, details } = formatOutput(snapshot);
+                if (exitCode !== 0 && exitCode !== null) {
+                    throw new Error(appendBashStatus(outputText, `Command exited with code ${exitCode}`));
+                }
+                return { content: [{ type: "text", text: outputText }], details };
+            }
+            finally {
+                clearUpdateTimer();
+            }
+        },
+        renderCall(args, _theme, context) {
+            const state = context.state;
+            if (context.executionStarted && state.startedAt === undefined) {
+                state.startedAt = Date.now();
+                state.endedAt = undefined;
+            }
+            const text = context.lastComponent ?? new Text("", 0, 0);
+            text.setText(formatBashCall(args, ops.getBackendInfo?.()));
+            return text;
+        },
+        renderResult(result, options, _theme, context) {
+            const state = context.state;
+            if (state.startedAt !== undefined && options.isPartial && !state.interval) {
+                state.interval = setInterval(() => context.invalidate(), 1000);
+            }
+            if (!options.isPartial || context.isError) {
+                state.endedAt ??= Date.now();
+                if (state.interval) {
+                    clearInterval(state.interval);
+                    state.interval = undefined;
+                }
+            }
+            const component = context.lastComponent ?? new BashResultRenderComponent();
+            rebuildBashResultRenderComponent(component, result, options, context.isError, context.showImages, state.startedAt, state.endedAt, ops.getBackendInfo?.());
+            component.invalidate();
+            return component;
+        },
+    };
+}
+export function createBashTool(operations, options) {
+    return wrapToolDefinition(createBashToolDefinition(operations, options));
+}
+//# sourceMappingURL=bash.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bash.js","sourceRoot":"","sources":["../../../src/core/tools/bash.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool, AgentToolResult } from \"@greppleai/grip-agent-core\";\nimport { Container, Text, truncateToWidth } from \"@greppleai/grip-tui\";\nimport { type Static, Type } from \"typebox\";\nimport { keyText } from \"../../modes/interactive/components/keybinding-hints.ts\";\nimport { truncateToVisualLines } from \"../../modes/interactive/components/visual-truncate.ts\";\nimport { theme } from \"../../modes/interactive/theme/theme.ts\";\nimport { getShellEnv } from \"../../utils/shell.ts\";\nimport type { ExtensionContext, ToolDefinition, ToolRenderResultOptions } from \"../extensions/types.ts\";\nimport {\n\tGRIP_SESSION_ENVIRONMENT_NAMES,\n\ttype GripSessionEnvironment,\n\tLocalToolOperations,\n\ttype ToolBackendInfo,\n\ttype ToolOperations,\n} from \"./operations.ts\";\nimport { OutputAccumulator, type OutputSnapshot } from \"./output-accumulator.ts\";\nimport { formatBackendIcon, getTextOutput, invalidArgText, str } from \"./render-utils.ts\";\nimport { wrapToolDefinition } from \"./tool-definition-wrapper.ts\";\nimport { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, type TruncationResult } from \"./truncate.ts\";\n\nconst bashSchema = Type.Object({\n\tcommand: Type.String({ description: \"Bash command to execute\" }),\n\ttimeout: Type.Optional(Type.Number({ description: \"Timeout in seconds (optional, no default timeout)\" })),\n});\n\nexport type BashToolInput = Static<typeof bashSchema>;\n\nexport interface BashToolDetails {\n\ttruncation?: TruncationResult;\n\tfullOutputPath?: string;\n}\n\n/**\n * Create tool operations using grip's built-in local shell execution backend.\n *\n * This is useful for extensions that intercept user_bash and still want grip's\n * standard local shell behavior while wrapping or rewriting commands.\n */\nexport interface LocalBashOperationsOptions {\n\tcwd?: string;\n\tshellPath?: string;\n}\n\nexport function createLocalBashOperations(options?: LocalBashOperationsOptions): ToolOperations {\n\treturn new LocalToolOperations(options?.cwd ?? process.cwd(), { shellPath: options?.shellPath });\n}\n\nexport interface BashSpawnContext {\n\tcommand: string;\n\tcwd: string;\n\tenv: NodeJS.ProcessEnv;\n}\n\nexport type BashSpawnHook = (context: BashSpawnContext) => BashSpawnContext;\n\nexport type BashSessionEnvironment = GripSessionEnvironment;\n\nexport function getBashSessionEnvironment(ctx: ExtensionContext | undefined): BashSessionEnvironment {\n\tif (!ctx?.session) return {};\n\tconst environment: BashSessionEnvironment = {\n\t\tGRIP_SESSION_ID: ctx.session.getSessionId(),\n\t};\n\tif (ctx.thinkingLevel) environment.GRIP_REASONING_LEVEL = ctx.thinkingLevel;\n\tconst sessionFile = ctx.session.getSessionReference();\n\tif (sessionFile) environment.GRIP_SESSION_FILE = sessionFile;\n\tif (ctx.model) {\n\t\tenvironment.GRIP_PROVIDER = ctx.model.provider;\n\t\tenvironment.GRIP_MODEL = ctx.model.id;\n\t}\n\treturn environment;\n}\n\nfunction resolveSpawnContext(\n\tcommand: string,\n\tcwd: string,\n\tspawnHook: BashSpawnHook | undefined,\n\texposeSessionEnvironment: boolean,\n\tctx: ExtensionContext | undefined,\n): BashSpawnContext {\n\tconst env = { ...getShellEnv() };\n\tfor (const name of GRIP_SESSION_ENVIRONMENT_NAMES) delete env[name];\n\tif (exposeSessionEnvironment) Object.assign(env, getBashSessionEnvironment(ctx));\n\tconst baseContext: BashSpawnContext = { command, cwd, env };\n\treturn spawnHook ? spawnHook(baseContext) : baseContext;\n}\n\nexport interface BashToolOptions {\n\t/** Command prefix prepended to every command (for example shell setup commands) */\n\tcommandPrefix?: string;\n\t/** Expose current grip session metadata as GRIP_* environment variables. Default: true */\n\texposeSessionEnvironment?: boolean;\n\t/** Hook to adjust command, cwd, or env before execution */\n\tspawnHook?: BashSpawnHook;\n}\n\nconst BASH_PREVIEW_LINES = 5;\nconst BASH_UPDATE_THROTTLE_MS = 100;\n\ntype BashRenderState = {\n\tstartedAt: number | undefined;\n\tendedAt: number | undefined;\n\tinterval: NodeJS.Timeout | undefined;\n};\n\ntype BashResultRenderState = {\n\tcachedWidth: number | undefined;\n\tcachedLines: string[] | undefined;\n\tcachedSkipped: number | undefined;\n};\n\nclass BashResultRenderComponent extends Container {\n\tstate: BashResultRenderState = {\n\t\tcachedWidth: undefined,\n\t\tcachedLines: undefined,\n\t\tcachedSkipped: undefined,\n\t};\n}\n\nfunction formatDuration(ms: number): string {\n\treturn `${(ms / 1000).toFixed(1)}s`;\n}\n\nfunction formatBackendSuffix(backendInfo: ToolBackendInfo | undefined): string {\n\tif (!backendInfo) return \"\";\n\tif (backendInfo.type === \"local\") return theme.fg(\"muted\", ` [local ${backendInfo.cwd}]`);\n\treturn backendInfo.configured\n\t\t? theme.fg(\"muted\", ` [remote ${backendInfo.url}:${backendInfo.cwd}]`)\n\t\t: theme.fg(\"warning\", ` [remote not configured ${backendInfo.cwd}]`);\n}\n\nfunction formatBashCall(args: Partial<BashToolInput> | undefined, backendInfo?: ToolBackendInfo): string {\n\tconst command = str(args?.command);\n\tconst timeout = args?.timeout;\n\tconst timeoutSuffix = timeout ? theme.fg(\"muted\", ` (timeout ${timeout}s)`) : \"\";\n\tconst commandDisplay = command === null ? invalidArgText(theme) : command ? command : theme.fg(\"toolOutput\", \"...\");\n\treturn (\n\t\tformatBackendIcon(backendInfo, theme) +\n\t\ttheme.fg(\"toolTitle\", theme.bold(\"$ \")) +\n\t\ttheme.fg(\"accent\", theme.bold(commandDisplay)) +\n\t\ttimeoutSuffix\n\t);\n}\n\nfunction getBashDisplayOutput(\n\tresult: AgentToolResult<BashToolDetails | undefined>,\n\tshowImages: boolean,\n\tisPartial: boolean,\n): string {\n\tconst output = getTextOutput(result, showImages).trim();\n\tconst truncation = result.details?.truncation;\n\tconst fullOutputPath = result.details?.fullOutputPath;\n\tif (isPartial || !truncation?.truncated || !fullOutputPath || !output.endsWith(\"]\")) return output;\n\tconst footerStart = output.lastIndexOf(\"\\n\\n[\");\n\tif (footerStart === -1 || !output.slice(footerStart).includes(fullOutputPath)) return output;\n\treturn output.slice(0, footerStart).trimEnd();\n}\n\nfunction addBashOutput(\n\tcomponent: BashResultRenderComponent,\n\tstate: BashResultRenderState,\n\toutput: string,\n\toptions: ToolRenderResultOptions,\n): void {\n\tif (!output) return;\n\tconst styledOutput = output\n\t\t.split(\"\\n\")\n\t\t.map((line) => theme.fg(\"toolOutput\", line))\n\t\t.join(\"\\n\");\n\tif (options.expanded) {\n\t\tcomponent.addChild(new Text(`\\n${styledOutput}`, 0, 0));\n\t\treturn;\n\t}\n\tcomponent.addChild({\n\t\trender: (width: number) => {\n\t\t\tif (state.cachedLines === undefined || state.cachedWidth !== width) {\n\t\t\t\tconst preview = truncateToVisualLines(styledOutput, BASH_PREVIEW_LINES, width);\n\t\t\t\tstate.cachedLines = preview.visualLines;\n\t\t\t\tstate.cachedSkipped = preview.skippedCount;\n\t\t\t\tstate.cachedWidth = width;\n\t\t\t}\n\t\t\treturn [\"\", ...(state.cachedLines ?? [])];\n\t\t},\n\t\tinvalidate: () => {\n\t\t\tstate.cachedWidth = undefined;\n\t\t\tstate.cachedLines = undefined;\n\t\t\tstate.cachedSkipped = undefined;\n\t\t},\n\t});\n}\n\nfunction addBashOutputWarnings(\n\tcomponent: BashResultRenderComponent,\n\ttruncation: TruncationResult | undefined,\n\tfullOutputPath: string | undefined,\n): void {\n\tif (!truncation?.truncated && !fullOutputPath) return;\n\tconst warnings: string[] = [];\n\tif (fullOutputPath) warnings.push(`Full output: ${fullOutputPath}`);\n\tif (truncation?.truncated) {\n\t\tif (truncation.truncatedBy === \"lines\") {\n\t\t\twarnings.push(`Truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines`);\n\t\t} else {\n\t\t\twarnings.push(\n\t\t\t\t`Truncated: ${truncation.outputLines} lines shown (${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit)`,\n\t\t\t);\n\t\t}\n\t}\n\tcomponent.addChild(new Text(`\\n${theme.fg(\"warning\", `[${warnings.join(\". \")}]`)}`, 0, 0));\n}\n\nfunction rebuildBashResultRenderComponent(\n\tcomponent: BashResultRenderComponent,\n\tresult: AgentToolResult<BashToolDetails | undefined>,\n\toptions: ToolRenderResultOptions,\n\tisError: boolean,\n\tshowImages: boolean,\n\tstartedAt: number | undefined,\n\tendedAt: number | undefined,\n\tbackendInfo: ToolBackendInfo | undefined,\n): void {\n\tconst state = component.state;\n\tcomponent.clear();\n\tconst output = getBashDisplayOutput(result, showImages, options.isPartial);\n\taddBashOutput(component, state, output, options);\n\taddBashOutputWarnings(component, result.details?.truncation, result.details?.fullOutputPath);\n\tif (startedAt !== undefined) {\n\t\tconst label = options.isPartial ? \"Elapsed\" : \"Took\";\n\t\tconst endTime = endedAt ?? Date.now();\n\t\tcomponent.addChild(\n\t\t\tnew Text(\n\t\t\t\t`\\n${theme.fg(options.isPartial ? \"muted\" : isError ? \"error\" : \"success\", `${label} ${formatDuration(endTime - startedAt)}`)}${formatBackendSuffix(backendInfo)}`,\n\t\t\t\t0,\n\t\t\t\t0,\n\t\t\t),\n\t\t);\n\t}\n\tif (!options.expanded && output) {\n\t\tcomponent.addChild({\n\t\t\trender: (width) => {\n\t\t\t\tif (!state.cachedSkipped || width < 1) return [];\n\t\t\t\tconst expandKey = keyText(\"app.tools.expand\");\n\t\t\t\tconst hint =\n\t\t\t\t\ttheme.fg(\"warning\", `${state.cachedSkipped} lines hidden`) +\n\t\t\t\t\t(expandKey ? theme.fg(\"accent\", ` · ${expandKey} to expand`) : \"\");\n\t\t\t\treturn [\"\", truncateToWidth(hint, width, \"...\")];\n\t\t\t},\n\t\t\tinvalidate: () => {},\n\t\t});\n\t}\n}\n\nfunction appendBashStatus(text: string, status: string): string {\n\treturn `${text ? `${text}\\n\\n` : \"\"}${status}`;\n}\n\nfunction throwBashExecutionError(error: unknown, outputText: string): never {\n\tif (error instanceof Error && error.message === \"aborted\") {\n\t\tthrow new Error(appendBashStatus(outputText, \"Command aborted\"));\n\t}\n\tif (error instanceof Error && error.message.startsWith(\"timeout:\")) {\n\t\tconst timeoutSeconds = error.message.split(\":\")[1];\n\t\tthrow new Error(appendBashStatus(outputText, `Command timed out after ${timeoutSeconds} seconds`));\n\t}\n\tthrow error;\n}\n\nexport type BashToolDefinition = ToolDefinition<typeof bashSchema, BashToolDetails | undefined, BashRenderState>;\n\nexport function createBashToolDefinition(operations: ToolOperations, options?: BashToolOptions): BashToolDefinition {\n\tconst ops = operations;\n\tconst commandPrefix = options?.commandPrefix;\n\tconst exposeSessionEnvironment = options?.exposeSessionEnvironment ?? true;\n\tconst spawnHook = options?.spawnHook;\n\treturn {\n\t\tname: \"bash\",\n\t\tlabel: \"bash\",\n\t\tdescription: `Execute a bash command in the current working directory. Returns stdout and stderr. Output is truncated to last ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). If truncated, full output is saved to a temp file. Optionally provide a timeout in seconds.`,\n\t\tpromptSnippet: \"Execute bash commands (ls, grep, find, etc.)\",\n\t\tpromptGuidelines: exposeSessionEnvironment\n\t\t\t? [\"Inspect GRIP_* environment variables for current model and session details.\"]\n\t\t\t: undefined,\n\t\tparameters: bashSchema,\n\t\tasync execute(_toolCallId, { command, timeout }: BashToolInput, signal?: AbortSignal, onUpdate?, ctx?) {\n\t\t\tconst resolvedCommand = commandPrefix ? `${commandPrefix}\\n${command}` : command;\n\t\t\tconst spawnContext = resolveSpawnContext(resolvedCommand, ops.cwd, spawnHook, exposeSessionEnvironment, ctx);\n\t\t\tconst output = new OutputAccumulator({ tempFilePrefix: \"grip-bash\" });\n\t\t\tlet updateTimer: NodeJS.Timeout | undefined;\n\t\t\tlet updateDirty = false;\n\t\t\tlet lastUpdateAt = 0;\n\n\t\t\tconst emitOutputUpdate = () => {\n\t\t\t\tif (!onUpdate || !updateDirty) return;\n\t\t\t\tupdateDirty = false;\n\t\t\t\tlastUpdateAt = Date.now();\n\t\t\t\tconst snapshot = output.snapshot({ persistIfTruncated: true });\n\t\t\t\tonUpdate({\n\t\t\t\t\tcontent: [{ type: \"text\", text: snapshot.content || \"\" }],\n\t\t\t\t\tdetails: {\n\t\t\t\t\t\ttruncation: snapshot.truncation.truncated ? snapshot.truncation : undefined,\n\t\t\t\t\t\tfullOutputPath: snapshot.fullOutputPath,\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t};\n\n\t\t\tconst clearUpdateTimer = () => {\n\t\t\t\tif (updateTimer) {\n\t\t\t\t\tclearTimeout(updateTimer);\n\t\t\t\t\tupdateTimer = undefined;\n\t\t\t\t}\n\t\t\t};\n\n\t\t\tconst scheduleOutputUpdate = () => {\n\t\t\t\tif (!onUpdate) return;\n\t\t\t\tupdateDirty = true;\n\t\t\t\tconst delay = BASH_UPDATE_THROTTLE_MS - (Date.now() - lastUpdateAt);\n\t\t\t\tif (delay <= 0) {\n\t\t\t\t\tclearUpdateTimer();\n\t\t\t\t\temitOutputUpdate();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tupdateTimer ??= setTimeout(() => {\n\t\t\t\t\tupdateTimer = undefined;\n\t\t\t\t\temitOutputUpdate();\n\t\t\t\t}, delay);\n\t\t\t};\n\n\t\t\tif (onUpdate) {\n\t\t\t\tonUpdate({ content: [], details: undefined });\n\t\t\t}\n\n\t\t\tconst handleData = (data: Buffer) => {\n\t\t\t\toutput.append(data);\n\t\t\t\tscheduleOutputUpdate();\n\t\t\t};\n\n\t\t\tconst finishOutput = async () => {\n\t\t\t\toutput.finish();\n\t\t\t\tclearUpdateTimer();\n\t\t\t\temitOutputUpdate();\n\t\t\t\tconst snapshot = output.snapshot({ persistIfTruncated: true });\n\t\t\t\tawait output.closeTempFile();\n\t\t\t\treturn snapshot;\n\t\t\t};\n\n\t\t\tconst formatOutput = (snapshot: OutputSnapshot, emptyText = \"(no output)\") => {\n\t\t\t\tconst truncation = snapshot.truncation;\n\t\t\t\tlet text = snapshot.content || emptyText;\n\t\t\t\tlet details: BashToolDetails | undefined;\n\t\t\t\tif (truncation.truncated) {\n\t\t\t\t\tdetails = { truncation, fullOutputPath: snapshot.fullOutputPath };\n\t\t\t\t\tconst startLine = truncation.totalLines - truncation.outputLines + 1;\n\t\t\t\t\tconst endLine = truncation.totalLines;\n\t\t\t\t\tif (truncation.lastLinePartial) {\n\t\t\t\t\t\tconst lastLineSize = formatSize(output.getLastLineBytes());\n\t\t\t\t\t\ttext += `\\n\\n[Showing last ${formatSize(truncation.outputBytes)} of line ${endLine} (line is ${lastLineSize}). Full output: ${snapshot.fullOutputPath}]`;\n\t\t\t\t\t} else if (truncation.truncatedBy === \"lines\") {\n\t\t\t\t\t\ttext += `\\n\\n[Showing lines ${startLine}-${endLine} of ${truncation.totalLines}. Full output: ${snapshot.fullOutputPath}]`;\n\t\t\t\t\t} else {\n\t\t\t\t\t\ttext += `\\n\\n[Showing lines ${startLine}-${endLine} of ${truncation.totalLines} (${formatSize(DEFAULT_MAX_BYTES)} limit). Full output: ${snapshot.fullOutputPath}]`;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn { text, details };\n\t\t\t};\n\n\t\t\ttry {\n\t\t\t\tlet exitCode: number | null;\n\t\t\t\ttry {\n\t\t\t\t\tconst result = await ops.exec(spawnContext.command, {\n\t\t\t\t\t\tcwd: spawnContext.cwd,\n\t\t\t\t\t\tonData: handleData,\n\t\t\t\t\t\tsignal,\n\t\t\t\t\t\ttimeout,\n\t\t\t\t\t\tenv: spawnContext.env,\n\t\t\t\t\t});\n\t\t\t\t\texitCode = result.exitCode;\n\t\t\t\t} catch (err) {\n\t\t\t\t\tconst snapshot = await finishOutput();\n\t\t\t\t\tconst { text } = formatOutput(snapshot, \"\");\n\t\t\t\t\tthrowBashExecutionError(err, text);\n\t\t\t\t}\n\n\t\t\t\tconst snapshot = await finishOutput();\n\t\t\t\tconst { text: outputText, details } = formatOutput(snapshot);\n\t\t\t\tif (exitCode !== 0 && exitCode !== null) {\n\t\t\t\t\tthrow new Error(appendBashStatus(outputText, `Command exited with code ${exitCode}`));\n\t\t\t\t}\n\t\t\t\treturn { content: [{ type: \"text\", text: outputText }], details };\n\t\t\t} finally {\n\t\t\t\tclearUpdateTimer();\n\t\t\t}\n\t\t},\n\t\trenderCall(args, _theme, context) {\n\t\t\tconst state = context.state;\n\t\t\tif (context.executionStarted && state.startedAt === undefined) {\n\t\t\t\tstate.startedAt = Date.now();\n\t\t\t\tstate.endedAt = undefined;\n\t\t\t}\n\t\t\tconst text = (context.lastComponent as Text | undefined) ?? new Text(\"\", 0, 0);\n\t\t\ttext.setText(formatBashCall(args, ops.getBackendInfo?.()));\n\t\t\treturn text;\n\t\t},\n\t\trenderResult(result, options, _theme, context) {\n\t\t\tconst state = context.state;\n\t\t\tif (state.startedAt !== undefined && options.isPartial && !state.interval) {\n\t\t\t\tstate.interval = setInterval(() => context.invalidate(), 1000);\n\t\t\t}\n\t\t\tif (!options.isPartial || context.isError) {\n\t\t\t\tstate.endedAt ??= Date.now();\n\t\t\t\tif (state.interval) {\n\t\t\t\t\tclearInterval(state.interval);\n\t\t\t\t\tstate.interval = undefined;\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst component =\n\t\t\t\t(context.lastComponent as BashResultRenderComponent | undefined) ?? new BashResultRenderComponent();\n\t\t\trebuildBashResultRenderComponent(\n\t\t\t\tcomponent,\n\t\t\t\tresult as any,\n\t\t\t\toptions,\n\t\t\t\tcontext.isError,\n\t\t\t\tcontext.showImages,\n\t\t\t\tstate.startedAt,\n\t\t\t\tstate.endedAt,\n\t\t\t\tops.getBackendInfo?.(),\n\t\t\t);\n\t\t\tcomponent.invalidate();\n\t\t\treturn component;\n\t\t},\n\t};\n}\n\nexport function createBashTool(operations: ToolOperations, options?: BashToolOptions): AgentTool<typeof bashSchema> {\n\treturn wrapToolDefinition(createBashToolDefinition(operations, options));\n}\n"]}

package/dist/core/tools/compress-context.d.ts

@@ -0,0 +1,27 @@
+import type { Static } from "typebox";
+import { Type } from "typebox";
+import type { ToolDefinition } from "../extensions/types.ts";
+import type { ReadonlySession } from "../session/session.ts";
+import type { SessionEntry } from "../session/types.ts";
+declare const schema: Type.TObject<{
+    startEntryId: Type.TString;
+    endEntryId: Type.TOptional<Type.TString>;
+    summary: Type.TString;
+}>;
+export type CompressContextInput = Static<typeof schema>;
+export interface PendingContextCompression {
+    toolCallId: string;
+    startEntryId: string;
+    endEntryId?: string;
+    summary: string;
+    assistantEntryId: string;
+}
+/** Collect entries in model-context order, excluding the currently executing tool call. */
+export declare function getCompressibleEntries(session: ReadonlySession, toolCallId: string): SessionEntry[];
+/** Validate a detector suggestion against the live branch, returning a reason for a corrective retry. */
+export declare function getSuggestedCompressionRangeError(session: ReadonlySession, startEntryId: string, endEntryId: string): string | undefined;
+/** Validate an advisory against the current branch before showing it to the primary agent. */
+export declare function isValidSuggestedCompressionRange(session: ReadonlySession, startEntryId: string, endEntryId: string): boolean;
+export declare function createCompressContextToolDefinition(session: ReadonlySession, schedule: (request: PendingContextCompression) => void): ToolDefinition<typeof schema>;
+export {};
+//# sourceMappingURL=compress-context.d.ts.map

package/dist/core/tools/compress-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress-context.d.ts","sourceRoot":"","sources":["../../../src/core/tools/compress-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,QAAA,MAAM,MAAM;;;;EAYX,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,OAAO,MAAM,CAAC,CAAC;AACzD,MAAM,WAAW,yBAAyB;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;CACzB;AA0BD,2FAA2F;AAC3F,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAInG;AAqCD,yGAAyG;AACzG,wBAAgB,iCAAiC,CAChD,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAOpB;AAED,8FAA8F;AAC9F,wBAAgB,gCAAgC,CAC/C,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GAChB,OAAO,CAET;AAED,wBAAgB,mCAAmC,CAClD,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,IAAI,GACpD,cAAc,CAAC,OAAO,MAAM,CAAC,CAsD/B","sourcesContent":["import type { Static } from \"typebox\";\nimport { Type } from \"typebox\";\nimport type { ToolDefinition } from \"../extensions/types.ts\";\nimport { HOOK_EXECUTION_CUSTOM_TYPE } from \"../hooks/types.ts\";\nimport { STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE } from \"../messages.ts\";\nimport { getLatestCompactionEntry, projectSessionContextEntries } from \"../session/context.ts\";\nimport type { ReadonlySession } from \"../session/session.ts\";\nimport type { SessionEntry } from \"../session/types.ts\";\nimport { abortIf } from \"./runtime.ts\";\n\nconst schema = Type.Object(\n\t{\n\t\tstartEntryId: Type.String({ description: \"ID of the first message to replace\" }),\n\t\tendEntryId: Type.Optional(\n\t\t\tType.String({\n\t\t\t\tdescription:\n\t\t\t\t\t\"Inclusive last message to replace; must precede the current user request. Omit to compress through the last eligible entry.\",\n\t\t\t}),\n\t\t),\n\t\tsummary: Type.String({ description: \"Replacement context for the selected range\" }),\n\t},\n\t{ additionalProperties: false },\n);\n\nexport type CompressContextInput = Static<typeof schema>;\nexport interface PendingContextCompression {\n\ttoolCallId: string;\n\tstartEntryId: string;\n\tendEntryId?: string;\n\tsummary: string;\n\tassistantEntryId: string;\n}\n\nfunction isContextEntry(entry: SessionEntry, compactionId: string | undefined, toolCallId: string): boolean {\n\tif (entry.type === \"custom_message\") {\n\t\treturn (\n\t\t\tentry.customType !== STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE &&\n\t\t\tentry.customType !== HOOK_EXECUTION_CUSTOM_TYPE\n\t\t);\n\t}\n\tif (entry.type === \"compaction\") return entry.id === compactionId && entry.summary.length > 0;\n\tif (entry.type === \"branch_summary\") return true;\n\tif (entry.type !== \"message\") return false;\n\tconst message = entry.message;\n\tif (message.role === \"bashExecution\") return !message.excludeFromContext;\n\tif (message.role === \"custom\") {\n\t\treturn (\n\t\t\tmessage.customType !== STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE &&\n\t\t\tmessage.customType !== HOOK_EXECUTION_CUSTOM_TYPE\n\t\t);\n\t}\n\tif (message.role === \"assistant\") {\n\t\treturn !message.content.some((block) => block.type === \"toolCall\" && block.id === toolCallId);\n\t}\n\treturn true;\n}\n\n/** Collect entries in model-context order, excluding the currently executing tool call. */\nexport function getCompressibleEntries(session: ReadonlySession, toolCallId: string): SessionEntry[] {\n\tconst path = session.getBranch();\n\tconst compaction = getLatestCompactionEntry(path);\n\treturn projectSessionContextEntries(path).filter((entry) => isContextEntry(entry, compaction?.id, toolCallId));\n}\n\nfunction hasUnmatchedToolCall(entries: SessionEntry[]): boolean {\n\tconst pending = new Set<string>();\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"message\") continue;\n\t\tif (entry.message.role === \"assistant\") {\n\t\t\tfor (const block of entry.message.content) {\n\t\t\t\tif (block.type === \"toolCall\") pending.add(block.id);\n\t\t\t}\n\t\t} else if (entry.message.role === \"toolResult\") {\n\t\t\tpending.delete(entry.message.toolCallId);\n\t\t}\n\t}\n\treturn pending.size > 0;\n}\n\nfunction validateCompressionRange(entries: SessionEntry[], startEntryId: string, endEntryId?: string): void {\n\tconst startIndex = entries.findIndex((entry) => entry.id === startEntryId);\n\tif (startIndex < 0) throw new Error(\"startEntryId must be a message in the current model context.\");\n\tconst endIndex = endEntryId ? entries.findIndex((entry) => entry.id === endEntryId) : entries.length - 1;\n\tif (endIndex < 0) throw new Error(\"endEntryId must be a message in the current model context.\");\n\tif (endIndex < startIndex) throw new Error(\"endEntryId must not precede startEntryId.\");\n\tconst start = entries[startIndex];\n\tif (start.type === \"message\" && start.message.role === \"toolResult\") {\n\t\tthrow new Error(\"Cannot start compression at a tool result; start at its assistant tool call instead.\");\n\t}\n\tif (hasUnmatchedToolCall(entries.slice(0, startIndex))) {\n\t\tthrow new Error(\"Cannot leave an unmatched tool call in the preserved prefix; start at its assistant message.\");\n\t}\n\tif (endIndex - startIndex + 1 < 2)\n\t\tthrow new Error(\"compress_context requires at least two messages in the selected range.\");\n\tif (hasUnmatchedToolCall(entries.slice(startIndex, endIndex + 1))) {\n\t\tthrow new Error(\"Cannot split a tool call from its result; include all results in the selected range.\");\n\t}\n}\n\n/** Validate a detector suggestion against the live branch, returning a reason for a corrective retry. */\nexport function getSuggestedCompressionRangeError(\n\tsession: ReadonlySession,\n\tstartEntryId: string,\n\tendEntryId: string,\n): string | undefined {\n\ttry {\n\t\tvalidateCompressionRange(getCompressibleEntries(session, \"\"), startEntryId, endEntryId);\n\t\treturn undefined;\n\t} catch (error) {\n\t\treturn error instanceof Error ? error.message : \"Invalid range.\";\n\t}\n}\n\n/** Validate an advisory against the current branch before showing it to the primary agent. */\nexport function isValidSuggestedCompressionRange(\n\tsession: ReadonlySession,\n\tstartEntryId: string,\n\tendEntryId: string,\n): boolean {\n\treturn getSuggestedCompressionRangeError(session, startEntryId, endEntryId) === undefined;\n}\n\nexport function createCompressContextToolDefinition(\n\tsession: ReadonlySession,\n\tschedule: (request: PendingContextCompression) => void,\n): ToolDefinition<typeof schema> {\n\treturn {\n\t\tname: \"compress_context\",\n\t\tlabel: \"compress_context\",\n\t\tdescription:\n\t\t\t\"Replace at least two messages from startEntryId through optional inclusive endEntryId with your own summary. endEntryId must be before the current user request; do not use the current user's ID from context metadata as the end. Omit endEntryId to compress through the last entry before that request. The earlier prefix, current request, tool call, result, and any later messages remain in order. Use a user or assistant tool-call entry ID from model-only context metadata for the start, not a tool-result ID.\",\n\t\tpromptSnippet: \"Summarize a bounded range or the active session tail\",\n\t\tpromptGuidelines: [\n\t\t\t\"Pass startEntryId and a non-empty summary; add endEntryId to retain later messages. Keep tool calls paired with their results and preserve important decisions.\",\n\t\t],\n\t\tparameters: schema,\n\t\texecutionMode: \"sequential\",\n\t\tasync execute(toolCallId, { startEntryId, endEntryId, summary }: CompressContextInput, signal) {\n\t\t\tabortIf(signal);\n\t\t\tif (!startEntryId || !summary.trim()) {\n\t\t\t\tthrow new Error(\"Provide startEntryId and a non-empty summary to compress.\");\n\t\t\t}\n\t\t\tconst assistant = session.getLeafEntry();\n\t\t\tconst branch = session.getBranch();\n\t\t\tconst isCurrentCall =\n\t\t\t\tassistant?.type === \"message\" &&\n\t\t\t\tassistant.message.role === \"assistant\" &&\n\t\t\t\tassistant.message.content.some((block) => block.type === \"toolCall\" && block.id === toolCallId);\n\t\t\tconst triggerIndex = isCurrentCall\n\t\t\t\t? branch\n\t\t\t\t\t\t.slice(0, -1)\n\t\t\t\t\t\t.map((entry) => entry.type === \"message\" && entry.message.role === \"user\")\n\t\t\t\t\t\t.lastIndexOf(true)\n\t\t\t\t: -1;\n\t\t\tconst eligibleIds = new Set(branch.slice(0, triggerIndex).map((entry) => entry.id));\n\t\t\tif (endEntryId && triggerIndex >= 0 && endEntryId === branch[triggerIndex]?.id) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t\"endEntryId is the current user request; omit endEntryId to compress through the last entry before it.\",\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst entries = getCompressibleEntries(session, toolCallId).filter(\n\t\t\t\t(entry) => triggerIndex < 0 || eligibleIds.has(entry.id),\n\t\t\t);\n\t\t\tvalidateCompressionRange(entries, startEntryId, endEntryId);\n\t\t\tif (\n\t\t\t\tassistant?.type !== \"message\" ||\n\t\t\t\tassistant.message.role !== \"assistant\" ||\n\t\t\t\tassistant.message.content.filter((block) => block.type === \"toolCall\").length !== 1 ||\n\t\t\t\t!assistant.message.content.some((block) => block.type === \"toolCall\" && block.id === toolCallId)\n\t\t\t)\n\t\t\t\tthrow new Error(\"compress_context must be the only tool call in its assistant message.\");\n\t\t\tabortIf(signal);\n\t\t\tschedule({ toolCallId, startEntryId, endEntryId, summary: summary.trim(), assistantEntryId: assistant.id });\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: \"Compression complete. Continue with the current request.\" }],\n\t\t\t\tdetails: undefined,\n\t\t\t};\n\t\t},\n\t};\n}\n"]}

package/dist/core/tools/compress-context.js

@@ -0,0 +1,142 @@
+import { Type } from "typebox";
+import { HOOK_EXECUTION_CUSTOM_TYPE } from "../hooks/types.js";
+import { STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE } from "../messages.js";
+import { getLatestCompactionEntry, projectSessionContextEntries } from "../session/context.js";
+import { abortIf } from "./runtime.js";
+const schema = Type.Object({
+    startEntryId: Type.String({ description: "ID of the first message to replace" }),
+    endEntryId: Type.Optional(Type.String({
+        description: "Inclusive last message to replace; must precede the current user request. Omit to compress through the last eligible entry.",
+    })),
+    summary: Type.String({ description: "Replacement context for the selected range" }),
+}, { additionalProperties: false });
+function isContextEntry(entry, compactionId, toolCallId) {
+    if (entry.type === "custom_message") {
+        return (entry.customType !== STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE &&
+            entry.customType !== HOOK_EXECUTION_CUSTOM_TYPE);
+    }
+    if (entry.type === "compaction")
+        return entry.id === compactionId && entry.summary.length > 0;
+    if (entry.type === "branch_summary")
+        return true;
+    if (entry.type !== "message")
+        return false;
+    const message = entry.message;
+    if (message.role === "bashExecution")
+        return !message.excludeFromContext;
+    if (message.role === "custom") {
+        return (message.customType !== STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE &&
+            message.customType !== HOOK_EXECUTION_CUSTOM_TYPE);
+    }
+    if (message.role === "assistant") {
+        return !message.content.some((block) => block.type === "toolCall" && block.id === toolCallId);
+    }
+    return true;
+}
+/** Collect entries in model-context order, excluding the currently executing tool call. */
+export function getCompressibleEntries(session, toolCallId) {
+    const path = session.getBranch();
+    const compaction = getLatestCompactionEntry(path);
+    return projectSessionContextEntries(path).filter((entry) => isContextEntry(entry, compaction?.id, toolCallId));
+}
+function hasUnmatchedToolCall(entries) {
+    const pending = new Set();
+    for (const entry of entries) {
+        if (entry.type !== "message")
+            continue;
+        if (entry.message.role === "assistant") {
+            for (const block of entry.message.content) {
+                if (block.type === "toolCall")
+                    pending.add(block.id);
+            }
+        }
+        else if (entry.message.role === "toolResult") {
+            pending.delete(entry.message.toolCallId);
+        }
+    }
+    return pending.size > 0;
+}
+function validateCompressionRange(entries, startEntryId, endEntryId) {
+    const startIndex = entries.findIndex((entry) => entry.id === startEntryId);
+    if (startIndex < 0)
+        throw new Error("startEntryId must be a message in the current model context.");
+    const endIndex = endEntryId ? entries.findIndex((entry) => entry.id === endEntryId) : entries.length - 1;
+    if (endIndex < 0)
+        throw new Error("endEntryId must be a message in the current model context.");
+    if (endIndex < startIndex)
+        throw new Error("endEntryId must not precede startEntryId.");
+    const start = entries[startIndex];
+    if (start.type === "message" && start.message.role === "toolResult") {
+        throw new Error("Cannot start compression at a tool result; start at its assistant tool call instead.");
+    }
+    if (hasUnmatchedToolCall(entries.slice(0, startIndex))) {
+        throw new Error("Cannot leave an unmatched tool call in the preserved prefix; start at its assistant message.");
+    }
+    if (endIndex - startIndex + 1 < 2)
+        throw new Error("compress_context requires at least two messages in the selected range.");
+    if (hasUnmatchedToolCall(entries.slice(startIndex, endIndex + 1))) {
+        throw new Error("Cannot split a tool call from its result; include all results in the selected range.");
+    }
+}
+/** Validate a detector suggestion against the live branch, returning a reason for a corrective retry. */
+export function getSuggestedCompressionRangeError(session, startEntryId, endEntryId) {
+    try {
+        validateCompressionRange(getCompressibleEntries(session, ""), startEntryId, endEntryId);
+        return undefined;
+    }
+    catch (error) {
+        return error instanceof Error ? error.message : "Invalid range.";
+    }
+}
+/** Validate an advisory against the current branch before showing it to the primary agent. */
+export function isValidSuggestedCompressionRange(session, startEntryId, endEntryId) {
+    return getSuggestedCompressionRangeError(session, startEntryId, endEntryId) === undefined;
+}
+export function createCompressContextToolDefinition(session, schedule) {
+    return {
+        name: "compress_context",
+        label: "compress_context",
+        description: "Replace at least two messages from startEntryId through optional inclusive endEntryId with your own summary. endEntryId must be before the current user request; do not use the current user's ID from context metadata as the end. Omit endEntryId to compress through the last entry before that request. The earlier prefix, current request, tool call, result, and any later messages remain in order. Use a user or assistant tool-call entry ID from model-only context metadata for the start, not a tool-result ID.",
+        promptSnippet: "Summarize a bounded range or the active session tail",
+        promptGuidelines: [
+            "Pass startEntryId and a non-empty summary; add endEntryId to retain later messages. Keep tool calls paired with their results and preserve important decisions.",
+        ],
+        parameters: schema,
+        executionMode: "sequential",
+        async execute(toolCallId, { startEntryId, endEntryId, summary }, signal) {
+            abortIf(signal);
+            if (!startEntryId || !summary.trim()) {
+                throw new Error("Provide startEntryId and a non-empty summary to compress.");
+            }
+            const assistant = session.getLeafEntry();
+            const branch = session.getBranch();
+            const isCurrentCall = assistant?.type === "message" &&
+                assistant.message.role === "assistant" &&
+                assistant.message.content.some((block) => block.type === "toolCall" && block.id === toolCallId);
+            const triggerIndex = isCurrentCall
+                ? branch
+                    .slice(0, -1)
+                    .map((entry) => entry.type === "message" && entry.message.role === "user")
+                    .lastIndexOf(true)
+                : -1;
+            const eligibleIds = new Set(branch.slice(0, triggerIndex).map((entry) => entry.id));
+            if (endEntryId && triggerIndex >= 0 && endEntryId === branch[triggerIndex]?.id) {
+                throw new Error("endEntryId is the current user request; omit endEntryId to compress through the last entry before it.");
+            }
+            const entries = getCompressibleEntries(session, toolCallId).filter((entry) => triggerIndex < 0 || eligibleIds.has(entry.id));
+            validateCompressionRange(entries, startEntryId, endEntryId);
+            if (assistant?.type !== "message" ||
+                assistant.message.role !== "assistant" ||
+                assistant.message.content.filter((block) => block.type === "toolCall").length !== 1 ||
+                !assistant.message.content.some((block) => block.type === "toolCall" && block.id === toolCallId))
+                throw new Error("compress_context must be the only tool call in its assistant message.");
+            abortIf(signal);
+            schedule({ toolCallId, startEntryId, endEntryId, summary: summary.trim(), assistantEntryId: assistant.id });
+            return {
+                content: [{ type: "text", text: "Compression complete. Continue with the current request." }],
+                details: undefined,
+            };
+        },
+    };
+}
+//# sourceMappingURL=compress-context.js.map

package/dist/core/tools/compress-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress-context.js","sourceRoot":"","sources":["../../../src/core/tools/compress-context.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Static } from \"typebox\";\nimport { Type } from \"typebox\";\nimport type { ToolDefinition } from \"../extensions/types.ts\";\nimport { HOOK_EXECUTION_CUSTOM_TYPE } from \"../hooks/types.ts\";\nimport { STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE } from \"../messages.ts\";\nimport { getLatestCompactionEntry, projectSessionContextEntries } from \"../session/context.ts\";\nimport type { ReadonlySession } from \"../session/session.ts\";\nimport type { SessionEntry } from \"../session/types.ts\";\nimport { abortIf } from \"./runtime.ts\";\n\nconst schema = Type.Object(\n\t{\n\t\tstartEntryId: Type.String({ description: \"ID of the first message to replace\" }),\n\t\tendEntryId: Type.Optional(\n\t\t\tType.String({\n\t\t\t\tdescription:\n\t\t\t\t\t\"Inclusive last message to replace; must precede the current user request. Omit to compress through the last eligible entry.\",\n\t\t\t}),\n\t\t),\n\t\tsummary: Type.String({ description: \"Replacement context for the selected range\" }),\n\t},\n\t{ additionalProperties: false },\n);\n\nexport type CompressContextInput = Static<typeof schema>;\nexport interface PendingContextCompression {\n\ttoolCallId: string;\n\tstartEntryId: string;\n\tendEntryId?: string;\n\tsummary: string;\n\tassistantEntryId: string;\n}\n\nfunction isContextEntry(entry: SessionEntry, compactionId: string | undefined, toolCallId: string): boolean {\n\tif (entry.type === \"custom_message\") {\n\t\treturn (\n\t\t\tentry.customType !== STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE &&\n\t\t\tentry.customType !== HOOK_EXECUTION_CUSTOM_TYPE\n\t\t);\n\t}\n\tif (entry.type === \"compaction\") return entry.id === compactionId && entry.summary.length > 0;\n\tif (entry.type === \"branch_summary\") return true;\n\tif (entry.type !== \"message\") return false;\n\tconst message = entry.message;\n\tif (message.role === \"bashExecution\") return !message.excludeFromContext;\n\tif (message.role === \"custom\") {\n\t\treturn (\n\t\t\tmessage.customType !== STRUCTURED_RESPONSE_INTERNAL_CUSTOM_TYPE &&\n\t\t\tmessage.customType !== HOOK_EXECUTION_CUSTOM_TYPE\n\t\t);\n\t}\n\tif (message.role === \"assistant\") {\n\t\treturn !message.content.some((block) => block.type === \"toolCall\" && block.id === toolCallId);\n\t}\n\treturn true;\n}\n\n/** Collect entries in model-context order, excluding the currently executing tool call. */\nexport function getCompressibleEntries(session: ReadonlySession, toolCallId: string): SessionEntry[] {\n\tconst path = session.getBranch();\n\tconst compaction = getLatestCompactionEntry(path);\n\treturn projectSessionContextEntries(path).filter((entry) => isContextEntry(entry, compaction?.id, toolCallId));\n}\n\nfunction hasUnmatchedToolCall(entries: SessionEntry[]): boolean {\n\tconst pending = new Set<string>();\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"message\") continue;\n\t\tif (entry.message.role === \"assistant\") {\n\t\t\tfor (const block of entry.message.content) {\n\t\t\t\tif (block.type === \"toolCall\") pending.add(block.id);\n\t\t\t}\n\t\t} else if (entry.message.role === \"toolResult\") {\n\t\t\tpending.delete(entry.message.toolCallId);\n\t\t}\n\t}\n\treturn pending.size > 0;\n}\n\nfunction validateCompressionRange(entries: SessionEntry[], startEntryId: string, endEntryId?: string): void {\n\tconst startIndex = entries.findIndex((entry) => entry.id === startEntryId);\n\tif (startIndex < 0) throw new Error(\"startEntryId must be a message in the current model context.\");\n\tconst endIndex = endEntryId ? entries.findIndex((entry) => entry.id === endEntryId) : entries.length - 1;\n\tif (endIndex < 0) throw new Error(\"endEntryId must be a message in the current model context.\");\n\tif (endIndex < startIndex) throw new Error(\"endEntryId must not precede startEntryId.\");\n\tconst start = entries[startIndex];\n\tif (start.type === \"message\" && start.message.role === \"toolResult\") {\n\t\tthrow new Error(\"Cannot start compression at a tool result; start at its assistant tool call instead.\");\n\t}\n\tif (hasUnmatchedToolCall(entries.slice(0, startIndex))) {\n\t\tthrow new Error(\"Cannot leave an unmatched tool call in the preserved prefix; start at its assistant message.\");\n\t}\n\tif (endIndex - startIndex + 1 < 2)\n\t\tthrow new Error(\"compress_context requires at least two messages in the selected range.\");\n\tif (hasUnmatchedToolCall(entries.slice(startIndex, endIndex + 1))) {\n\t\tthrow new Error(\"Cannot split a tool call from its result; include all results in the selected range.\");\n\t}\n}\n\n/** Validate a detector suggestion against the live branch, returning a reason for a corrective retry. */\nexport function getSuggestedCompressionRangeError(\n\tsession: ReadonlySession,\n\tstartEntryId: string,\n\tendEntryId: string,\n): string | undefined {\n\ttry {\n\t\tvalidateCompressionRange(getCompressibleEntries(session, \"\"), startEntryId, endEntryId);\n\t\treturn undefined;\n\t} catch (error) {\n\t\treturn error instanceof Error ? error.message : \"Invalid range.\";\n\t}\n}\n\n/** Validate an advisory against the current branch before showing it to the primary agent. */\nexport function isValidSuggestedCompressionRange(\n\tsession: ReadonlySession,\n\tstartEntryId: string,\n\tendEntryId: string,\n): boolean {\n\treturn getSuggestedCompressionRangeError(session, startEntryId, endEntryId) === undefined;\n}\n\nexport function createCompressContextToolDefinition(\n\tsession: ReadonlySession,\n\tschedule: (request: PendingContextCompression) => void,\n): ToolDefinition<typeof schema> {\n\treturn {\n\t\tname: \"compress_context\",\n\t\tlabel: \"compress_context\",\n\t\tdescription:\n\t\t\t\"Replace at least two messages from startEntryId through optional inclusive endEntryId with your own summary. endEntryId must be before the current user request; do not use the current user's ID from context metadata as the end. Omit endEntryId to compress through the last entry before that request. The earlier prefix, current request, tool call, result, and any later messages remain in order. Use a user or assistant tool-call entry ID from model-only context metadata for the start, not a tool-result ID.\",\n\t\tpromptSnippet: \"Summarize a bounded range or the active session tail\",\n\t\tpromptGuidelines: [\n\t\t\t\"Pass startEntryId and a non-empty summary; add endEntryId to retain later messages. Keep tool calls paired with their results and preserve important decisions.\",\n\t\t],\n\t\tparameters: schema,\n\t\texecutionMode: \"sequential\",\n\t\tasync execute(toolCallId, { startEntryId, endEntryId, summary }: CompressContextInput, signal) {\n\t\t\tabortIf(signal);\n\t\t\tif (!startEntryId || !summary.trim()) {\n\t\t\t\tthrow new Error(\"Provide startEntryId and a non-empty summary to compress.\");\n\t\t\t}\n\t\t\tconst assistant = session.getLeafEntry();\n\t\t\tconst branch = session.getBranch();\n\t\t\tconst isCurrentCall =\n\t\t\t\tassistant?.type === \"message\" &&\n\t\t\t\tassistant.message.role === \"assistant\" &&\n\t\t\t\tassistant.message.content.some((block) => block.type === \"toolCall\" && block.id === toolCallId);\n\t\t\tconst triggerIndex = isCurrentCall\n\t\t\t\t? branch\n\t\t\t\t\t\t.slice(0, -1)\n\t\t\t\t\t\t.map((entry) => entry.type === \"message\" && entry.message.role === \"user\")\n\t\t\t\t\t\t.lastIndexOf(true)\n\t\t\t\t: -1;\n\t\t\tconst eligibleIds = new Set(branch.slice(0, triggerIndex).map((entry) => entry.id));\n\t\t\tif (endEntryId && triggerIndex >= 0 && endEntryId === branch[triggerIndex]?.id) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t\"endEntryId is the current user request; omit endEntryId to compress through the last entry before it.\",\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst entries = getCompressibleEntries(session, toolCallId).filter(\n\t\t\t\t(entry) => triggerIndex < 0 || eligibleIds.has(entry.id),\n\t\t\t);\n\t\t\tvalidateCompressionRange(entries, startEntryId, endEntryId);\n\t\t\tif (\n\t\t\t\tassistant?.type !== \"message\" ||\n\t\t\t\tassistant.message.role !== \"assistant\" ||\n\t\t\t\tassistant.message.content.filter((block) => block.type === \"toolCall\").length !== 1 ||\n\t\t\t\t!assistant.message.content.some((block) => block.type === \"toolCall\" && block.id === toolCallId)\n\t\t\t)\n\t\t\t\tthrow new Error(\"compress_context must be the only tool call in its assistant message.\");\n\t\t\tabortIf(signal);\n\t\t\tschedule({ toolCallId, startEntryId, endEntryId, summary: summary.trim(), assistantEntryId: assistant.id });\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: \"Compression complete. Continue with the current request.\" }],\n\t\t\t\tdetails: undefined,\n\t\t\t};\n\t\t},\n\t};\n}\n"]}