@code-yeongyu/senpi 2026.7.4 → 2026.7.9-2

package/dist/core/extensions/builtin/terminal/prompt.js

@@ -0,0 +1,23 @@
+/** System-prompt guidance for the persistent-terminal tool suite (CC-close, snake_case). */
+export const TERMINAL_PROMPT_SECTION = `
+## Persistent terminal sessions
+
+The \`bash\` tool is PTY-backed. For long-running or interactive work, do NOT use tmux or
+manual \`&\` backgrounding — use the built-in session tools:
+
+- \`bash({ command, run_in_background: true })\` starts a persistent session and returns a
+  \`bash_id\` immediately. Foreground calls still block and return output; their \`timeout\`
+  (seconds) is a kill deadline. Background sessions ignore \`timeout\` and live until they
+  exit or you call \`kill_bash\`.
+- \`bash_output({ bash_id, wait_for, filter, view })\` reads new output, or blocks until a
+  \`wait_for\` regex matches / the session exits / the timeout elapses. Use \`view: "screen"\`
+  for a rendered full-screen snapshot of TUIs.
+- \`bash_input({ bash_id, input, keys, submit })\` sends stdin or named keys (e.g.
+  \`["ctrl+c"]\`, \`["enter"]\`) to steer a REPL or interrupt a process.
+- \`bash_resize({ bash_id, cols, rows })\` resizes the PTY so full-screen programs reflow.
+- \`kill_bash({ bash_id })\` (or \`{ all: true }\`) tears the session tree down with no orphans.
+
+Typical flow: start with \`run_in_background: true\`, subscribe via \`bash_output\` with
+\`wait_for\`, steer with \`bash_input\`, then \`kill_bash\` when done.
+`;
+//# sourceMappingURL=prompt.js.map

package/dist/core/extensions/builtin/terminal/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/terminal/prompt.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBtC,CAAC","sourcesContent":["/** System-prompt guidance for the persistent-terminal tool suite (CC-close, snake_case). */\nexport const TERMINAL_PROMPT_SECTION = `\n## Persistent terminal sessions\n\nThe \\`bash\\` tool is PTY-backed. For long-running or interactive work, do NOT use tmux or\nmanual \\`&\\` backgrounding — use the built-in session tools:\n\n- \\`bash({ command, run_in_background: true })\\` starts a persistent session and returns a\n  \\`bash_id\\` immediately. Foreground calls still block and return output; their \\`timeout\\`\n  (seconds) is a kill deadline. Background sessions ignore \\`timeout\\` and live until they\n  exit or you call \\`kill_bash\\`.\n- \\`bash_output({ bash_id, wait_for, filter, view })\\` reads new output, or blocks until a\n  \\`wait_for\\` regex matches / the session exits / the timeout elapses. Use \\`view: \"screen\"\\`\n  for a rendered full-screen snapshot of TUIs.\n- \\`bash_input({ bash_id, input, keys, submit })\\` sends stdin or named keys (e.g.\n  \\`[\"ctrl+c\"]\\`, \\`[\"enter\"]\\`) to steer a REPL or interrupt a process.\n- \\`bash_resize({ bash_id, cols, rows })\\` resizes the PTY so full-screen programs reflow.\n- \\`kill_bash({ bash_id })\\` (or \\`{ all: true }\\`) tears the session tree down with no orphans.\n\nTypical flow: start with \\`run_in_background: true\\`, subscribe via \\`bash_output\\` with\n\\`wait_for\\`, steer with \\`bash_input\\`, then \\`kill_bash\\` when done.\n`;\n"]}

package/dist/core/extensions/builtin/terminal/runtime-session.d.ts

@@ -0,0 +1,45 @@
+import { type TerminalScreenSnapshot, type TerminalSession, type TerminalSessionExit, type TerminalSessionOptions } from "@earendil-works/pi-pty";
+export interface TerminalRuntimeOptions extends TerminalSessionOptions {
+    readonly scrollback?: number;
+}
+export interface DeltaRead {
+    readonly text: string;
+    readonly droppedChars: number;
+}
+/**
+ * A live terminal session: a pi-pty {@link TerminalSession} plus an xterm screen model,
+ * a bounded decoded-output buffer with a per-consumer read cursor, and `wait_for` waiters.
+ */
+export declare class TerminalRuntimeSession {
+    readonly session: TerminalSession;
+    readonly command: string;
+    private readonly screen;
+    private readonly decoder;
+    private buffer;
+    private droppedChars;
+    private consumed;
+    private readonly waiters;
+    private unsubscribeData;
+    constructor(command: string, options: TerminalRuntimeOptions);
+    get backend(): string | null;
+    get exited(): boolean;
+    get exitResult(): TerminalSessionExit | null;
+    /** Total decoded chars produced so far (including any dropped from the front). */
+    get totalChars(): number;
+    private ingest;
+    /** Return output produced since the last read and advance the read cursor. */
+    readDelta(): DeltaRead;
+    /** Full retained decoded output (`view:"log"`), without advancing the cursor. */
+    fullOutput(): string;
+    snapshot(): TerminalScreenSnapshot;
+    resizeScreen(cols: number, rows: number): void;
+    /**
+     * Wait until `pattern` matches newly produced output, the session exits, or the
+     * timeout elapses. Returns `"matched" | "exited" | "timeout" | "invalid_pattern"`.
+     */
+    waitFor(pattern: string, timeoutMs: number): Promise<"matched" | "exited" | "timeout" | "invalid_pattern">;
+    dispose(): void;
+    private settleWaiters;
+    private resolveWaiter;
+}
+//# sourceMappingURL=runtime-session.d.ts.map

package/dist/core/extensions/builtin/terminal/runtime-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-session.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/terminal/runtime-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,MAAM,wBAAwB,CAAC;AAGhC,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC9B;AAQD;;;GAGG;AACH,qBAAa,sBAAsB;IAClC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IACtE,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,eAAe,CAA6B;IAEpD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,EAU3D;IAED,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAE3B;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,UAAU,IAAI,mBAAmB,GAAG,IAAI,CAE3C;IAED,kFAAkF;IAClF,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,OAAO,CAAC,MAAM;IAgBd,8EAA8E;IAC9E,SAAS,IAAI,SAAS,CAMrB;IAED,iFAAiF;IACjF,UAAU,IAAI,MAAM,CAEnB;IAED,QAAQ,IAAI,sBAAsB,CAEjC;IAED,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7C;IAED;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,iBAAiB,CAAC,CAgBzG;IAED,OAAO,IAAI,IAAI,CAKd;IAED,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,aAAa;CAIrB"}

package/dist/core/extensions/builtin/terminal/runtime-session.js

@@ -0,0 +1,112 @@
+import { createTerminalSession, TerminalScreen, } from "@earendil-works/pi-pty";
+import { DEFAULT_SCROLLBACK, MAX_SESSION_OUTPUT_CHARS, safeRegExp } from "./shared.js";
+/**
+ * A live terminal session: a pi-pty {@link TerminalSession} plus an xterm screen model,
+ * a bounded decoded-output buffer with a per-consumer read cursor, and `wait_for` waiters.
+ */
+export class TerminalRuntimeSession {
+    constructor(command, options) {
+        this.decoder = new TextDecoder("utf-8", { fatal: false });
+        this.buffer = "";
+        this.droppedChars = 0;
+        this.consumed = 0;
+        this.waiters = new Set();
+        this.unsubscribeData = null;
+        this.command = command;
+        this.screen = new TerminalScreen({
+            cols: options.cols,
+            rows: options.rows,
+            scrollback: options.scrollback ?? DEFAULT_SCROLLBACK,
+        });
+        this.session = createTerminalSession(options);
+        this.unsubscribeData = this.session.onData((chunk) => this.ingest(chunk));
+        this.session.onExit(() => this.settleWaiters());
+    }
+    get backend() {
+        return this.session.backend;
+    }
+    get exited() {
+        return this.session.exited;
+    }
+    get exitResult() {
+        return this.session.exitResult;
+    }
+    /** Total decoded chars produced so far (including any dropped from the front). */
+    get totalChars() {
+        return this.droppedChars + this.buffer.length;
+    }
+    ingest(chunk) {
+        const text = this.decoder.decode(chunk, { stream: true });
+        if (text.length === 0)
+            return;
+        void this.screen.feed(text);
+        this.buffer += text;
+        if (this.buffer.length > MAX_SESSION_OUTPUT_CHARS) {
+            const overflow = this.buffer.length - MAX_SESSION_OUTPUT_CHARS;
+            this.buffer = this.buffer.slice(overflow);
+            this.droppedChars += overflow;
+        }
+        for (const waiter of this.waiters) {
+            waiter.buffer += text;
+            if (waiter.regex.test(waiter.buffer))
+                this.resolveWaiter(waiter, true);
+        }
+    }
+    /** Return output produced since the last read and advance the read cursor. */
+    readDelta() {
+        const start = Math.max(this.consumed, this.droppedChars);
+        const dropped = Math.max(0, this.droppedChars - this.consumed);
+        const text = this.buffer.slice(start - this.droppedChars);
+        this.consumed = this.totalChars;
+        return { text, droppedChars: dropped };
+    }
+    /** Full retained decoded output (`view:"log"`), without advancing the cursor. */
+    fullOutput() {
+        return this.buffer;
+    }
+    snapshot() {
+        return this.screen.snapshot();
+    }
+    resizeScreen(cols, rows) {
+        void this.screen.resize(cols, rows);
+    }
+    /**
+     * Wait until `pattern` matches newly produced output, the session exits, or the
+     * timeout elapses. Returns `"matched" | "exited" | "timeout" | "invalid_pattern"`.
+     */
+    waitFor(pattern, timeoutMs) {
+        const regex = safeRegExp(pattern);
+        if (regex === null)
+            return Promise.resolve("invalid_pattern");
+        if (this.exited)
+            return Promise.resolve("exited");
+        return new Promise((resolve) => {
+            const waiter = {
+                regex,
+                buffer: "",
+                resolve: (matched) => {
+                    clearTimeout(timer);
+                    resolve(matched ? "matched" : this.exited ? "exited" : "timeout");
+                },
+            };
+            const timer = setTimeout(() => this.resolveWaiter(waiter, false), timeoutMs);
+            this.waiters.add(waiter);
+        });
+    }
+    dispose() {
+        this.unsubscribeData?.();
+        this.unsubscribeData = null;
+        this.settleWaiters();
+        this.screen.dispose();
+    }
+    settleWaiters() {
+        for (const waiter of [...this.waiters])
+            this.resolveWaiter(waiter, false);
+    }
+    resolveWaiter(waiter, matched) {
+        if (!this.waiters.delete(waiter))
+            return;
+        waiter.resolve(matched);
+    }
+}
+//# sourceMappingURL=runtime-session.js.map

package/dist/core/extensions/builtin/terminal/runtime-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-session.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/terminal/runtime-session.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tcreateTerminalSession,\n\tTerminalScreen,\n\ttype TerminalScreenSnapshot,\n\ttype TerminalSession,\n\ttype TerminalSessionExit,\n\ttype TerminalSessionOptions,\n} from \"@earendil-works/pi-pty\";\nimport { DEFAULT_SCROLLBACK, MAX_SESSION_OUTPUT_CHARS, safeRegExp } from \"./shared.ts\";\n\nexport interface TerminalRuntimeOptions extends TerminalSessionOptions {\n\treadonly scrollback?: number;\n}\n\nexport interface DeltaRead {\n\treadonly text: string;\n\treadonly droppedChars: number;\n}\n\ninterface OutputWaiter {\n\treadonly regex: RegExp;\n\tbuffer: string;\n\tresolve: (matched: boolean) => void;\n}\n\n/**\n * A live terminal session: a pi-pty {@link TerminalSession} plus an xterm screen model,\n * a bounded decoded-output buffer with a per-consumer read cursor, and `wait_for` waiters.\n */\nexport class TerminalRuntimeSession {\n\treadonly session: TerminalSession;\n\treadonly command: string;\n\tprivate readonly screen: TerminalScreen;\n\tprivate readonly decoder = new TextDecoder(\"utf-8\", { fatal: false });\n\tprivate buffer = \"\";\n\tprivate droppedChars = 0;\n\tprivate consumed = 0;\n\tprivate readonly waiters = new Set<OutputWaiter>();\n\tprivate unsubscribeData: (() => void) | null = null;\n\n\tconstructor(command: string, options: TerminalRuntimeOptions) {\n\t\tthis.command = command;\n\t\tthis.screen = new TerminalScreen({\n\t\t\tcols: options.cols,\n\t\t\trows: options.rows,\n\t\t\tscrollback: options.scrollback ?? DEFAULT_SCROLLBACK,\n\t\t});\n\t\tthis.session = createTerminalSession(options);\n\t\tthis.unsubscribeData = this.session.onData((chunk) => this.ingest(chunk));\n\t\tthis.session.onExit(() => this.settleWaiters());\n\t}\n\n\tget backend(): string | null {\n\t\treturn this.session.backend;\n\t}\n\n\tget exited(): boolean {\n\t\treturn this.session.exited;\n\t}\n\n\tget exitResult(): TerminalSessionExit | null {\n\t\treturn this.session.exitResult;\n\t}\n\n\t/** Total decoded chars produced so far (including any dropped from the front). */\n\tget totalChars(): number {\n\t\treturn this.droppedChars + this.buffer.length;\n\t}\n\n\tprivate ingest(chunk: Uint8Array): void {\n\t\tconst text = this.decoder.decode(chunk, { stream: true });\n\t\tif (text.length === 0) return;\n\t\tvoid this.screen.feed(text);\n\t\tthis.buffer += text;\n\t\tif (this.buffer.length > MAX_SESSION_OUTPUT_CHARS) {\n\t\t\tconst overflow = this.buffer.length - MAX_SESSION_OUTPUT_CHARS;\n\t\t\tthis.buffer = this.buffer.slice(overflow);\n\t\t\tthis.droppedChars += overflow;\n\t\t}\n\t\tfor (const waiter of this.waiters) {\n\t\t\twaiter.buffer += text;\n\t\t\tif (waiter.regex.test(waiter.buffer)) this.resolveWaiter(waiter, true);\n\t\t}\n\t}\n\n\t/** Return output produced since the last read and advance the read cursor. */\n\treadDelta(): DeltaRead {\n\t\tconst start = Math.max(this.consumed, this.droppedChars);\n\t\tconst dropped = Math.max(0, this.droppedChars - this.consumed);\n\t\tconst text = this.buffer.slice(start - this.droppedChars);\n\t\tthis.consumed = this.totalChars;\n\t\treturn { text, droppedChars: dropped };\n\t}\n\n\t/** Full retained decoded output (`view:\"log\"`), without advancing the cursor. */\n\tfullOutput(): string {\n\t\treturn this.buffer;\n\t}\n\n\tsnapshot(): TerminalScreenSnapshot {\n\t\treturn this.screen.snapshot();\n\t}\n\n\tresizeScreen(cols: number, rows: number): void {\n\t\tvoid this.screen.resize(cols, rows);\n\t}\n\n\t/**\n\t * Wait until `pattern` matches newly produced output, the session exits, or the\n\t * timeout elapses. Returns `\"matched\" | \"exited\" | \"timeout\" | \"invalid_pattern\"`.\n\t */\n\twaitFor(pattern: string, timeoutMs: number): Promise<\"matched\" | \"exited\" | \"timeout\" | \"invalid_pattern\"> {\n\t\tconst regex = safeRegExp(pattern);\n\t\tif (regex === null) return Promise.resolve(\"invalid_pattern\");\n\t\tif (this.exited) return Promise.resolve(\"exited\");\n\t\treturn new Promise((resolve) => {\n\t\t\tconst waiter: OutputWaiter = {\n\t\t\t\tregex,\n\t\t\t\tbuffer: \"\",\n\t\t\t\tresolve: (matched) => {\n\t\t\t\t\tclearTimeout(timer);\n\t\t\t\t\tresolve(matched ? \"matched\" : this.exited ? \"exited\" : \"timeout\");\n\t\t\t\t},\n\t\t\t};\n\t\t\tconst timer = setTimeout(() => this.resolveWaiter(waiter, false), timeoutMs);\n\t\t\tthis.waiters.add(waiter);\n\t\t});\n\t}\n\n\tdispose(): void {\n\t\tthis.unsubscribeData?.();\n\t\tthis.unsubscribeData = null;\n\t\tthis.settleWaiters();\n\t\tthis.screen.dispose();\n\t}\n\n\tprivate settleWaiters(): void {\n\t\tfor (const waiter of [...this.waiters]) this.resolveWaiter(waiter, false);\n\t}\n\n\tprivate resolveWaiter(waiter: OutputWaiter, matched: boolean): void {\n\t\tif (!this.waiters.delete(waiter)) return;\n\t\twaiter.resolve(matched);\n\t}\n}\n"]}

package/dist/core/extensions/builtin/terminal/settings.d.ts

@@ -0,0 +1,17 @@
+import type { SettingsManager, TerminalSettings } from "../../../settings-manager.ts";
+export type TimeoutAction = "background" | "kill";
+export type NotifyMode = "wake" | "next-turn" | "off";
+export interface ResolvedTerminalSettings {
+    readonly defaultCols: number;
+    readonly defaultRows: number;
+    readonly scrollback: number;
+    readonly maxSessions: number;
+    readonly timeoutAction: TimeoutAction;
+    readonly notify: NotifyMode;
+}
+export declare const TERMINAL_SETTINGS_DEFAULTS: ResolvedTerminalSettings;
+/** Resolve terminal-tool config from a raw `terminal` settings block, filling defaults. */
+export declare function resolveTerminalSettings(raw: TerminalSettings | undefined): ResolvedTerminalSettings;
+/** Load and merge terminal-tool settings from global + project settings.json. */
+export declare function loadTerminalSettings(settingsManager: SettingsManager): ResolvedTerminalSettings;
+//# sourceMappingURL=settings.d.ts.map

package/dist/core/extensions/builtin/terminal/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/terminal/settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGtF,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,MAAM,CAAC;AAClD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,KAAK,CAAC;AAEtD,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC5B;AAED,eAAO,MAAM,0BAA0B,EAAE,wBAOxC,CAAC;AAgBF,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,GAAG,wBAAwB,CAUnG;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,eAAe,GAAG,wBAAwB,CAK/F"}

package/dist/core/extensions/builtin/terminal/settings.js

@@ -0,0 +1,43 @@
+import { DEFAULT_COLS, DEFAULT_MAX_SESSIONS, DEFAULT_ROWS, DEFAULT_SCROLLBACK } from "./shared.js";
+export const TERMINAL_SETTINGS_DEFAULTS = {
+    defaultCols: DEFAULT_COLS,
+    defaultRows: DEFAULT_ROWS,
+    scrollback: DEFAULT_SCROLLBACK,
+    maxSessions: DEFAULT_MAX_SESSIONS,
+    timeoutAction: "background",
+    notify: "wake",
+};
+function positiveInt(value, fallback) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 1)
+        return fallback;
+    return Math.trunc(value);
+}
+function nonNegativeInt(value, fallback) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0)
+        return fallback;
+    return Math.trunc(value);
+}
+function oneOf(value, allowed, fallback) {
+    return typeof value === "string" && allowed.includes(value) ? value : fallback;
+}
+/** Resolve terminal-tool config from a raw `terminal` settings block, filling defaults. */
+export function resolveTerminalSettings(raw) {
+    if (!raw)
+        return TERMINAL_SETTINGS_DEFAULTS;
+    return {
+        defaultCols: positiveInt(raw.defaultCols, TERMINAL_SETTINGS_DEFAULTS.defaultCols),
+        defaultRows: positiveInt(raw.defaultRows, TERMINAL_SETTINGS_DEFAULTS.defaultRows),
+        scrollback: nonNegativeInt(raw.scrollback, TERMINAL_SETTINGS_DEFAULTS.scrollback),
+        maxSessions: positiveInt(raw.maxSessions, TERMINAL_SETTINGS_DEFAULTS.maxSessions),
+        timeoutAction: oneOf(raw.timeoutAction, ["background", "kill"], TERMINAL_SETTINGS_DEFAULTS.timeoutAction),
+        notify: oneOf(raw.notify, ["wake", "next-turn", "off"], TERMINAL_SETTINGS_DEFAULTS.notify),
+    };
+}
+/** Load and merge terminal-tool settings from global + project settings.json. */
+export function loadTerminalSettings(settingsManager) {
+    const global = settingsManager.getGlobalSettings().terminal;
+    const project = settingsManager.getProjectSettings().terminal;
+    const merged = { ...global, ...project };
+    return resolveTerminalSettings(merged);
+}
+//# sourceMappingURL=settings.js.map

package/dist/core/extensions/builtin/terminal/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/terminal/settings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAcnG,MAAM,CAAC,MAAM,0BAA0B,GAA6B;IACnE,WAAW,EAAE,YAAY;IACzB,WAAW,EAAE,YAAY;IACzB,UAAU,EAAE,kBAAkB;IAC9B,WAAW,EAAE,oBAAoB;IACjC,aAAa,EAAE,YAAY;IAC3B,MAAM,EAAE,MAAM;CACd,CAAC;AAEF,SAAS,WAAW,CAAC,KAAc,EAAE,QAAgB;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IACvF,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,cAAc,CAAC,KAAc,EAAE,QAAgB;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IACvF,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,KAAK,CAAmB,KAAc,EAAE,OAAqB,EAAE,QAAW;IAClF,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,OAA6B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC9G,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,uBAAuB,CAAC,GAAiC;IACxE,IAAI,CAAC,GAAG;QAAE,OAAO,0BAA0B,CAAC;IAC5C,OAAO;QACN,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,0BAA0B,CAAC,WAAW,CAAC;QACjF,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,0BAA0B,CAAC,WAAW,CAAC;QACjF,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,0BAA0B,CAAC,UAAU,CAAC;QACjF,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,0BAA0B,CAAC,WAAW,CAAC;QACjF,aAAa,EAAE,KAAK,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,0BAA0B,CAAC,aAAa,CAAC;QACzG,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,0BAA0B,CAAC,MAAM,CAAC;KAC1F,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,oBAAoB,CAAC,eAAgC;IACpE,MAAM,MAAM,GAAG,eAAe,CAAC,iBAAiB,EAAE,CAAC,QAAQ,CAAC;IAC5D,MAAM,OAAO,GAAG,eAAe,CAAC,kBAAkB,EAAE,CAAC,QAAQ,CAAC;IAC9D,MAAM,MAAM,GAAqB,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;IAC3D,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC","sourcesContent":["import type { SettingsManager, TerminalSettings } from \"../../../settings-manager.ts\";\nimport { DEFAULT_COLS, DEFAULT_MAX_SESSIONS, DEFAULT_ROWS, DEFAULT_SCROLLBACK } from \"./shared.ts\";\n\nexport type TimeoutAction = \"background\" | \"kill\";\nexport type NotifyMode = \"wake\" | \"next-turn\" | \"off\";\n\nexport interface ResolvedTerminalSettings {\n\treadonly defaultCols: number;\n\treadonly defaultRows: number;\n\treadonly scrollback: number;\n\treadonly maxSessions: number;\n\treadonly timeoutAction: TimeoutAction;\n\treadonly notify: NotifyMode;\n}\n\nexport const TERMINAL_SETTINGS_DEFAULTS: ResolvedTerminalSettings = {\n\tdefaultCols: DEFAULT_COLS,\n\tdefaultRows: DEFAULT_ROWS,\n\tscrollback: DEFAULT_SCROLLBACK,\n\tmaxSessions: DEFAULT_MAX_SESSIONS,\n\ttimeoutAction: \"background\",\n\tnotify: \"wake\",\n};\n\nfunction positiveInt(value: unknown, fallback: number): number {\n\tif (typeof value !== \"number\" || !Number.isFinite(value) || value < 1) return fallback;\n\treturn Math.trunc(value);\n}\n\nfunction nonNegativeInt(value: unknown, fallback: number): number {\n\tif (typeof value !== \"number\" || !Number.isFinite(value) || value < 0) return fallback;\n\treturn Math.trunc(value);\n}\n\nfunction oneOf<T extends string>(value: unknown, allowed: readonly T[], fallback: T): T {\n\treturn typeof value === \"string\" && (allowed as readonly string[]).includes(value) ? (value as T) : fallback;\n}\n\n/** Resolve terminal-tool config from a raw `terminal` settings block, filling defaults. */\nexport function resolveTerminalSettings(raw: TerminalSettings | undefined): ResolvedTerminalSettings {\n\tif (!raw) return TERMINAL_SETTINGS_DEFAULTS;\n\treturn {\n\t\tdefaultCols: positiveInt(raw.defaultCols, TERMINAL_SETTINGS_DEFAULTS.defaultCols),\n\t\tdefaultRows: positiveInt(raw.defaultRows, TERMINAL_SETTINGS_DEFAULTS.defaultRows),\n\t\tscrollback: nonNegativeInt(raw.scrollback, TERMINAL_SETTINGS_DEFAULTS.scrollback),\n\t\tmaxSessions: positiveInt(raw.maxSessions, TERMINAL_SETTINGS_DEFAULTS.maxSessions),\n\t\ttimeoutAction: oneOf(raw.timeoutAction, [\"background\", \"kill\"], TERMINAL_SETTINGS_DEFAULTS.timeoutAction),\n\t\tnotify: oneOf(raw.notify, [\"wake\", \"next-turn\", \"off\"], TERMINAL_SETTINGS_DEFAULTS.notify),\n\t};\n}\n\n/** Load and merge terminal-tool settings from global + project settings.json. */\nexport function loadTerminalSettings(settingsManager: SettingsManager): ResolvedTerminalSettings {\n\tconst global = settingsManager.getGlobalSettings().terminal;\n\tconst project = settingsManager.getProjectSettings().terminal;\n\tconst merged: TerminalSettings = { ...global, ...project };\n\treturn resolveTerminalSettings(merged);\n}\n"]}

package/dist/core/extensions/builtin/terminal/shared.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared constants and helpers for the persistent-terminal builtin extension.
+ */
+export declare const TERMINAL_BASH_TOOL = "bash";
+export declare const TERMINAL_OUTPUT_TOOL = "bash_output";
+export declare const TERMINAL_KILL_TOOL = "kill_bash";
+export declare const TERMINAL_INPUT_TOOL = "bash_input";
+export declare const TERMINAL_RESIZE_TOOL = "bash_resize";
+/** Companion tools that must never dangle without a live PTY `bash`. */
+export declare const TERMINAL_COMPANION_TOOLS: readonly ["bash_output", "kill_bash", "bash_input", "bash_resize"];
+export declare const DEFAULT_COLS = 120;
+export declare const DEFAULT_ROWS = 40;
+export declare const DEFAULT_SCROLLBACK = 10000;
+export declare const DEFAULT_MAX_SESSIONS = 32;
+/** Upper bound on decoded output retained per session for delta reads and `view:"log"`. */
+export declare const MAX_SESSION_OUTPUT_CHARS = 1000000;
+/** Grace window used to capture a background command's early output before returning its id. */
+export declare const BACKGROUND_START_GRACE_MS = 250;
+export declare const DEFAULT_OUTPUT_WAIT_TIMEOUT_SECONDS = 30;
+/** Resolve a single named key to its PTY byte sequence, or null when unknown. */
+export declare function resolveKeySequence(key: string): string | null;
+/** Build a PTY-ready payload from a list of named keys, returning the unknown keys too. */
+export declare function encodeKeys(keys: readonly string[]): {
+    data: string;
+    unknown: string[];
+};
+/** Compile a user-supplied regex, tolerating invalid patterns by returning null. */
+export declare function safeRegExp(pattern: string): RegExp | null;
+//# sourceMappingURL=shared.d.ts.map

package/dist/core/extensions/builtin/terminal/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/terminal/shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,kBAAkB,SAAS,CAAC;AACzC,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAClD,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAC9C,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAChD,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAElD,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,oEAK3B,CAAC;AAEX,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,2FAA2F;AAC3F,eAAO,MAAM,wBAAwB,UAAY,CAAC;AAClD,gGAAgG;AAChG,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,mCAAmC,KAAK,CAAC;AAiCtD,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ7D;AAED,2FAA2F;AAC3F,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CASvF;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMzD"}

package/dist/core/extensions/builtin/terminal/shared.js

@@ -0,0 +1,90 @@
+/**
+ * Shared constants and helpers for the persistent-terminal builtin extension.
+ */
+export const TERMINAL_BASH_TOOL = "bash";
+export const TERMINAL_OUTPUT_TOOL = "bash_output";
+export const TERMINAL_KILL_TOOL = "kill_bash";
+export const TERMINAL_INPUT_TOOL = "bash_input";
+export const TERMINAL_RESIZE_TOOL = "bash_resize";
+/** Companion tools that must never dangle without a live PTY `bash`. */
+export const TERMINAL_COMPANION_TOOLS = [
+    TERMINAL_OUTPUT_TOOL,
+    TERMINAL_KILL_TOOL,
+    TERMINAL_INPUT_TOOL,
+    TERMINAL_RESIZE_TOOL,
+];
+export const DEFAULT_COLS = 120;
+export const DEFAULT_ROWS = 40;
+export const DEFAULT_SCROLLBACK = 10_000;
+export const DEFAULT_MAX_SESSIONS = 32;
+/** Upper bound on decoded output retained per session for delta reads and `view:"log"`. */
+export const MAX_SESSION_OUTPUT_CHARS = 1_000_000;
+/** Grace window used to capture a background command's early output before returning its id. */
+export const BACKGROUND_START_GRACE_MS = 250;
+export const DEFAULT_OUTPUT_WAIT_TIMEOUT_SECONDS = 30;
+/**
+ * Named-key aliases the model can send via `bash_input {keys:[...]}`. Values are the
+ * raw byte sequences a PTY expects (control chars + xterm cursor/function escapes).
+ */
+const KEY_SEQUENCES = {
+    enter: "\r",
+    return: "\r",
+    tab: "\t",
+    escape: "\x1b",
+    esc: "\x1b",
+    space: " ",
+    backspace: "\x7f",
+    delete: "\x1b[3~",
+    up: "\x1b[A",
+    down: "\x1b[B",
+    right: "\x1b[C",
+    left: "\x1b[D",
+    home: "\x1b[H",
+    end: "\x1b[F",
+    pageup: "\x1b[5~",
+    pagedown: "\x1b[6~",
+    "ctrl+c": "\x03",
+    "ctrl+d": "\x04",
+    "ctrl+z": "\x1a",
+    "ctrl+l": "\x0c",
+    "ctrl+u": "\x15",
+    "ctrl+a": "\x01",
+    "ctrl+e": "\x05",
+    "ctrl+\\": "\x1c",
+};
+/** Resolve a single named key to its PTY byte sequence, or null when unknown. */
+export function resolveKeySequence(key) {
+    const normalized = key.trim().toLowerCase();
+    if (normalized.length === 0)
+        return null;
+    const mapped = KEY_SEQUENCES[normalized];
+    if (mapped !== undefined)
+        return mapped;
+    // Single printable character passes through verbatim.
+    if ([...normalized].length === 1)
+        return key;
+    return null;
+}
+/** Build a PTY-ready payload from a list of named keys, returning the unknown keys too. */
+export function encodeKeys(keys) {
+    let data = "";
+    const unknown = [];
+    for (const key of keys) {
+        const sequence = resolveKeySequence(key);
+        if (sequence === null)
+            unknown.push(key);
+        else
+            data += sequence;
+    }
+    return { data, unknown };
+}
+/** Compile a user-supplied regex, tolerating invalid patterns by returning null. */
+export function safeRegExp(pattern) {
+    try {
+        return new RegExp(pattern);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/core/extensions/builtin/terminal/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/terminal/shared.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared constants and helpers for the persistent-terminal builtin extension.\n */\n\nexport const TERMINAL_BASH_TOOL = \"bash\";\nexport const TERMINAL_OUTPUT_TOOL = \"bash_output\";\nexport const TERMINAL_KILL_TOOL = \"kill_bash\";\nexport const TERMINAL_INPUT_TOOL = \"bash_input\";\nexport const TERMINAL_RESIZE_TOOL = \"bash_resize\";\n\n/** Companion tools that must never dangle without a live PTY `bash`. */\nexport const TERMINAL_COMPANION_TOOLS = [\n\tTERMINAL_OUTPUT_TOOL,\n\tTERMINAL_KILL_TOOL,\n\tTERMINAL_INPUT_TOOL,\n\tTERMINAL_RESIZE_TOOL,\n] as const;\n\nexport const DEFAULT_COLS = 120;\nexport const DEFAULT_ROWS = 40;\nexport const DEFAULT_SCROLLBACK = 10_000;\nexport const DEFAULT_MAX_SESSIONS = 32;\n/** Upper bound on decoded output retained per session for delta reads and `view:\"log\"`. */\nexport const MAX_SESSION_OUTPUT_CHARS = 1_000_000;\n/** Grace window used to capture a background command's early output before returning its id. */\nexport const BACKGROUND_START_GRACE_MS = 250;\nexport const DEFAULT_OUTPUT_WAIT_TIMEOUT_SECONDS = 30;\n\n/**\n * Named-key aliases the model can send via `bash_input {keys:[...]}`. Values are the\n * raw byte sequences a PTY expects (control chars + xterm cursor/function escapes).\n */\nconst KEY_SEQUENCES: Record<string, string> = {\n\tenter: \"\\r\",\n\treturn: \"\\r\",\n\ttab: \"\\t\",\n\tescape: \"\\x1b\",\n\tesc: \"\\x1b\",\n\tspace: \" \",\n\tbackspace: \"\\x7f\",\n\tdelete: \"\\x1b[3~\",\n\tup: \"\\x1b[A\",\n\tdown: \"\\x1b[B\",\n\tright: \"\\x1b[C\",\n\tleft: \"\\x1b[D\",\n\thome: \"\\x1b[H\",\n\tend: \"\\x1b[F\",\n\tpageup: \"\\x1b[5~\",\n\tpagedown: \"\\x1b[6~\",\n\t\"ctrl+c\": \"\\x03\",\n\t\"ctrl+d\": \"\\x04\",\n\t\"ctrl+z\": \"\\x1a\",\n\t\"ctrl+l\": \"\\x0c\",\n\t\"ctrl+u\": \"\\x15\",\n\t\"ctrl+a\": \"\\x01\",\n\t\"ctrl+e\": \"\\x05\",\n\t\"ctrl+\\\\\": \"\\x1c\",\n};\n\n/** Resolve a single named key to its PTY byte sequence, or null when unknown. */\nexport function resolveKeySequence(key: string): string | null {\n\tconst normalized = key.trim().toLowerCase();\n\tif (normalized.length === 0) return null;\n\tconst mapped = KEY_SEQUENCES[normalized];\n\tif (mapped !== undefined) return mapped;\n\t// Single printable character passes through verbatim.\n\tif ([...normalized].length === 1) return key;\n\treturn null;\n}\n\n/** Build a PTY-ready payload from a list of named keys, returning the unknown keys too. */\nexport function encodeKeys(keys: readonly string[]): { data: string; unknown: string[] } {\n\tlet data = \"\";\n\tconst unknown: string[] = [];\n\tfor (const key of keys) {\n\t\tconst sequence = resolveKeySequence(key);\n\t\tif (sequence === null) unknown.push(key);\n\t\telse data += sequence;\n\t}\n\treturn { data, unknown };\n}\n\n/** Compile a user-supplied regex, tolerating invalid patterns by returning null. */\nexport function safeRegExp(pattern: string): RegExp | null {\n\ttry {\n\t\treturn new RegExp(pattern);\n\t} catch {\n\t\treturn null;\n\t}\n}\n"]}

package/dist/core/extensions/builtin/terminal/tools/bash-input.d.ts

@@ -0,0 +1,23 @@
+import { type Static, Type } from "typebox";
+import { type TerminalToolContext, type TerminalToolResult } from "./context.ts";
+export declare const bashInputSchema: Type.TObject<{
+    bash_id: Type.TString;
+    input: Type.TOptional<Type.TString>;
+    keys: Type.TOptional<Type.TArray<Type.TString>>;
+    submit: Type.TOptional<Type.TBoolean>;
+}>;
+export type BashInputInput = Static<typeof bashInputSchema>;
+export declare function createBashInputTool(ctx: TerminalToolContext): {
+    name: string;
+    label: string;
+    description: string;
+    promptSnippet: string;
+    parameters: Type.TObject<{
+        bash_id: Type.TString;
+        input: Type.TOptional<Type.TString>;
+        keys: Type.TOptional<Type.TArray<Type.TString>>;
+        submit: Type.TOptional<Type.TBoolean>;
+    }>;
+    execute(_toolCallId: string, input: BashInputInput, _signal?: AbortSignal): Promise<TerminalToolResult>;
+};
+//# sourceMappingURL=bash-input.d.ts.map

package/dist/core/extensions/builtin/terminal/tools/bash-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-input.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/terminal/tools/bash-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,EAAe,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAc,MAAM,cAAc,CAAC;AAE1G,eAAO,MAAM,eAAe;;;;;EAa1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;AAE5D,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,mBAAmB;;;;;;;;;;;yBAQ/B,MAAM,SAAS,cAAc,YAAY,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC;EA2B9G"}

package/dist/core/extensions/builtin/terminal/tools/bash-input.js

@@ -0,0 +1,52 @@
+import { Type } from "typebox";
+import { encodeKeys, TERMINAL_INPUT_TOOL } from "../shared.js";
+import { errorResult, textResult } from "./context.js";
+export const bashInputSchema = Type.Object({
+    bash_id: Type.String({ description: "Session id returned by a run_in_background bash call." }),
+    input: Type.Optional(Type.String({ description: "Literal text to write to the session's stdin." })),
+    keys: Type.Optional(Type.Array(Type.String(), {
+        description: "Named keys to send, e.g. ['ctrl+c'], ['enter'], ['up']. Sent after `input` when both are given.",
+    })),
+    submit: Type.Optional(Type.Boolean({
+        description: "Append Enter (\\r) after `input`. Default true when `input` is a non-empty string.",
+    })),
+});
+export function createBashInputTool(ctx) {
+    return {
+        name: TERMINAL_INPUT_TOOL,
+        label: "bash_input",
+        description: "Write stdin or named keys (ctrl+c, enter, up, ...) to a live background bash session — e.g. drive a REPL or send SIGINT. This executes arbitrary shell input and is permission-gated like bash.",
+        promptSnippet: "Send stdin/keys to a live background bash session (REPL steering, ctrl+c, etc.)",
+        parameters: bashInputSchema,
+        async execute(_toolCallId, input, _signal) {
+            const runtime = ctx.manager.get(input.bash_id);
+            if (!runtime)
+                return errorResult(`No terminal session found with id: ${input.bash_id}`);
+            if (runtime.exited)
+                return errorResult(`Session ${input.bash_id} is not running; cannot send input.`);
+            const notes = [];
+            if (typeof input.input === "string") {
+                const submit = input.submit ?? input.input.length > 0;
+                const result = runtime.session.write(submit ? `${input.input}\r` : input.input);
+                if (!result.ok)
+                    return errorResult(`Failed to write input: ${result.note}`);
+                notes.push(submit ? "wrote input + Enter" : "wrote input");
+            }
+            if (input.keys && input.keys.length > 0) {
+                const { data, unknown } = encodeKeys(input.keys);
+                if (data.length > 0) {
+                    const result = runtime.session.write(data);
+                    if (!result.ok)
+                        return errorResult(`Failed to send keys: ${result.note}`);
+                    notes.push(`sent ${input.keys.length - unknown.length} key(s)`);
+                }
+                if (unknown.length > 0)
+                    notes.push(`ignored unknown keys: ${unknown.join(", ")}`);
+            }
+            if (notes.length === 0)
+                return errorResult("Nothing to send: provide `input` and/or `keys`.");
+            return textResult(`Sent to ${input.bash_id}: ${notes.join("; ")}.`);
+        },
+    };
+}
+//# sourceMappingURL=bash-input.js.map

package/dist/core/extensions/builtin/terminal/tools/bash-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-input.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/terminal/tools/bash-input.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Static, Type } from \"typebox\";\nimport { encodeKeys, TERMINAL_INPUT_TOOL } from \"../shared.ts\";\nimport { errorResult, type TerminalToolContext, type TerminalToolResult, textResult } from \"./context.ts\";\n\nexport const bashInputSchema = Type.Object({\n\tbash_id: Type.String({ description: \"Session id returned by a run_in_background bash call.\" }),\n\tinput: Type.Optional(Type.String({ description: \"Literal text to write to the session's stdin.\" })),\n\tkeys: Type.Optional(\n\t\tType.Array(Type.String(), {\n\t\t\tdescription: \"Named keys to send, e.g. ['ctrl+c'], ['enter'], ['up']. Sent after `input` when both are given.\",\n\t\t}),\n\t),\n\tsubmit: Type.Optional(\n\t\tType.Boolean({\n\t\t\tdescription: \"Append Enter (\\\\r) after `input`. Default true when `input` is a non-empty string.\",\n\t\t}),\n\t),\n});\n\nexport type BashInputInput = Static<typeof bashInputSchema>;\n\nexport function createBashInputTool(ctx: TerminalToolContext) {\n\treturn {\n\t\tname: TERMINAL_INPUT_TOOL,\n\t\tlabel: \"bash_input\",\n\t\tdescription:\n\t\t\t\"Write stdin or named keys (ctrl+c, enter, up, ...) to a live background bash session — e.g. drive a REPL or send SIGINT. This executes arbitrary shell input and is permission-gated like bash.\",\n\t\tpromptSnippet: \"Send stdin/keys to a live background bash session (REPL steering, ctrl+c, etc.)\",\n\t\tparameters: bashInputSchema,\n\t\tasync execute(_toolCallId: string, input: BashInputInput, _signal?: AbortSignal): Promise<TerminalToolResult> {\n\t\t\tconst runtime = ctx.manager.get(input.bash_id);\n\t\t\tif (!runtime) return errorResult(`No terminal session found with id: ${input.bash_id}`);\n\t\t\tif (runtime.exited) return errorResult(`Session ${input.bash_id} is not running; cannot send input.`);\n\n\t\t\tconst notes: string[] = [];\n\t\t\tif (typeof input.input === \"string\") {\n\t\t\t\tconst submit = input.submit ?? input.input.length > 0;\n\t\t\t\tconst result = runtime.session.write(submit ? `${input.input}\\r` : input.input);\n\t\t\t\tif (!result.ok) return errorResult(`Failed to write input: ${result.note}`);\n\t\t\t\tnotes.push(submit ? \"wrote input + Enter\" : \"wrote input\");\n\t\t\t}\n\n\t\t\tif (input.keys && input.keys.length > 0) {\n\t\t\t\tconst { data, unknown } = encodeKeys(input.keys);\n\t\t\t\tif (data.length > 0) {\n\t\t\t\t\tconst result = runtime.session.write(data);\n\t\t\t\t\tif (!result.ok) return errorResult(`Failed to send keys: ${result.note}`);\n\t\t\t\t\tnotes.push(`sent ${input.keys.length - unknown.length} key(s)`);\n\t\t\t\t}\n\t\t\t\tif (unknown.length > 0) notes.push(`ignored unknown keys: ${unknown.join(\", \")}`);\n\t\t\t}\n\n\t\t\tif (notes.length === 0) return errorResult(\"Nothing to send: provide `input` and/or `keys`.\");\n\t\t\treturn textResult(`Sent to ${input.bash_id}: ${notes.join(\"; \")}.`);\n\t\t},\n\t};\n}\n"]}

package/dist/core/extensions/builtin/terminal/tools/bash-output.d.ts

@@ -0,0 +1,27 @@
+import { type Static, Type } from "typebox";
+import { type TerminalToolContext, type TerminalToolResult } from "./context.ts";
+export declare const bashOutputSchema: Type.TObject<{
+    bash_id: Type.TString;
+    filter: Type.TOptional<Type.TString>;
+    wait_for: Type.TOptional<Type.TString>;
+    block: Type.TOptional<Type.TBoolean>;
+    timeout: Type.TOptional<Type.TNumber>;
+    view: Type.TOptional<Type.TUnion<[Type.TLiteral<"log">, Type.TLiteral<"screen">]>>;
+}>;
+export type BashOutputInput = Static<typeof bashOutputSchema>;
+export declare function createBashOutputTool(ctx: TerminalToolContext): {
+    name: string;
+    label: string;
+    description: string;
+    promptSnippet: string;
+    parameters: Type.TObject<{
+        bash_id: Type.TString;
+        filter: Type.TOptional<Type.TString>;
+        wait_for: Type.TOptional<Type.TString>;
+        block: Type.TOptional<Type.TBoolean>;
+        timeout: Type.TOptional<Type.TNumber>;
+        view: Type.TOptional<Type.TUnion<[Type.TLiteral<"log">, Type.TLiteral<"screen">]>>;
+    }>;
+    execute(_toolCallId: string, input: BashOutputInput, _signal?: AbortSignal): Promise<TerminalToolResult>;
+};
+//# sourceMappingURL=bash-output.d.ts.map

package/dist/core/extensions/builtin/terminal/tools/bash-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-output.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/terminal/tools/bash-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG5C,OAAO,EAAe,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAc,MAAM,cAAc,CAAC;AAG1G,eAAO,MAAM,gBAAgB;;;;;;;EAa3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAwB9D,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,mBAAmB;;;;;;;;;;;;;yBAQhC,MAAM,SAAS,eAAe,YAAY,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC;EAoB/G"}

package/dist/core/extensions/builtin/terminal/tools/bash-output.js

@@ -0,0 +1,64 @@
+import { Type } from "typebox";
+import { DEFAULT_OUTPUT_WAIT_TIMEOUT_SECONDS, safeRegExp, TERMINAL_OUTPUT_TOOL } from "../shared.js";
+import { errorResult, textResult } from "./context.js";
+import { describeExit } from "./spawn.js";
+export const bashOutputSchema = Type.Object({
+    bash_id: Type.String({ description: "Session id returned by a run_in_background bash call." }),
+    filter: Type.Optional(Type.String({ description: "Only return output lines matching this regex." })),
+    wait_for: Type.Optional(Type.String({ description: "Block until output matches this regex, the session exits, or timeout." })),
+    block: Type.Optional(Type.Boolean({ description: "When wait_for is set, block (default true)." })),
+    timeout: Type.Optional(Type.Number({ description: "wait_for timeout in seconds (default 30)." })),
+    view: Type.Optional(Type.Union([Type.Literal("log"), Type.Literal("screen")], {
+        description: "'log' returns new raw output (default); 'screen' returns the rendered xterm grid.",
+    })),
+});
+function statusLine(runtime) {
+    if (!runtime.exited)
+        return "status: running";
+    const status = describeExit(runtime) ?? "exited";
+    const code = runtime.exitResult?.exitCode;
+    return code === null || code === undefined ? `status: ${status}` : `status: ${status} exit_code: ${code}`;
+}
+function applyFilter(text, filter) {
+    if (!filter)
+        return text;
+    const regex = safeRegExp(filter);
+    if (regex === null)
+        return text;
+    return text
+        .split("\n")
+        .filter((line) => regex.test(line))
+        .join("\n");
+}
+function screenView(runtime) {
+    const snapshot = runtime.snapshot();
+    return snapshot.visibleGrid.join("\n").replace(/\s+$/, "");
+}
+export function createBashOutputTool(ctx) {
+    return {
+        name: TERMINAL_OUTPUT_TOOL,
+        label: "bash_output",
+        description: "Read new output from a background bash session, or block until wait_for matches / the session exits / timeout. Use view:'screen' for a rendered full-screen snapshot.",
+        promptSnippet: "Read/subscribe to background bash session output (wait_for, filter, screen view)",
+        parameters: bashOutputSchema,
+        async execute(_toolCallId, input, _signal) {
+            const runtime = ctx.manager.get(input.bash_id);
+            if (!runtime)
+                return errorResult(`No terminal session found with id: ${input.bash_id}`);
+            if (input.wait_for && input.block !== false) {
+                const timeoutMs = Math.trunc((input.timeout ?? DEFAULT_OUTPUT_WAIT_TIMEOUT_SECONDS) * 1000);
+                const outcome = await runtime.waitFor(input.wait_for, timeoutMs);
+                if (outcome === "invalid_pattern")
+                    return errorResult(`Invalid wait_for regex: ${input.wait_for}`);
+            }
+            if (input.view === "screen") {
+                return textResult(`${statusLine(runtime)}\n${screenView(runtime)}`);
+            }
+            const delta = runtime.readDelta();
+            const filtered = applyFilter(delta.text, input.filter).trimEnd();
+            const dropped = delta.droppedChars > 0 ? `[${delta.droppedChars} earlier chars dropped]\n` : "";
+            return textResult(`${statusLine(runtime)}\n${dropped}${filtered || "(no new output)"}`);
+        },
+    };
+}
+//# sourceMappingURL=bash-output.js.map