@glbgpt/cli 0.1.4 → 0.2.1

package/README.md

@@ -25,14 +25,15 @@ Run `glbgpt <command> --help` for the full flags of any command.
 
 ### Chat
 
-| Command | What it does |
-|---|---|
-| `glbgpt` | Start the interactive chat TUI. |
-| `glbgpt "<prompt>"` | Start the TUI with a first message. |
-| `glbgpt resume last` · `glbgpt resume <id>` | Resume a previous conversation. |
+| Command                                     | What it does                        |
+| ------------------------------------------- | ----------------------------------- |
+| `glbgpt`                                    | Start the interactive chat TUI.     |
+| `glbgpt "<prompt>"`                         | Start the TUI with a first message. |
+| `glbgpt resume last` · `glbgpt resume <id>` | Resume a previous conversation.     |
 
 Inside the TUI, type `/` for commands: `/model` `/models` `/image` `/video` `/tasks` `/status`
-`/account` `/transactions` `/cost` `/login` `/logout` `/new` `/resume` `/help` `/exit`.
+`/permissions` `/compact` `/account` `/transactions` `/cost` `/login` `/logout` `/new` `/resume`
+`/help` `/exit`.
 Attach images with `@image` (last generation), `Ctrl+V` or `@clipboard`, or `@./photo.png`.
 Multi-line: end a line with `\` then Enter (or Ctrl+J); plain Enter sends; Esc interrupts.
 On tool-capable models the assistant can also read files under the directory you started
@@ -40,22 +41,49 @@ On tool-capable models the assistant can also read files under the directory you
 web when current information matters (a small per-search credit charge applies, at most a
 few searches per message), and fetch public web pages by URL (free).
 
+#### Coding tools
+
+On tool-capable models the assistant can also **run shell commands, create files, and edit
+files** in your workspace — every command and file change asks for your approval first
+(`[y]` allow once, `[a]` allow similar actions for this session, `[p]` always allow for this
+project, `[n]` deny). Diffs are shown before an edit runs. Project instructions in
+`AGENTS.md` or `CLAUDE.md` (from the repository root down to the current directory) are
+picked up automatically (`--no-project-context` to skip). Long-running commands (dev
+servers, watchers) can run in the background — the assistant starts them detached, polls
+their output, and they are stopped when the CLI exits.
+
+Long conversations compact automatically: when the history approaches the model's context
+limit the older part is summarized (one model call) and the conversation continues
+seamlessly — `/compact` triggers it manually. The full history always stays on disk.
+
+Permission modes — switch with `/permissions <mode>` or start with `--permission-mode <mode>`:
+
+| Mode           | Behavior                                                                       |
+| -------------- | ------------------------------------------------------------------------------ |
+| `default`      | Ask before every command and file write.                                       |
+| `accept-edits` | File writes run without asking; commands still ask.                            |
+| `yolo`         | Nothing asks (also `--yolo`). Dangerous — use only in disposable environments. |
+
+Dangerous commands (`sudo`, forced/recursive `rm`, ...) always ask individually and can never
+be remembered for the session; writes inside `.git/` always ask.
+
 ### Account
 
-| Command | What it does |
-|---|---|
+| Command                                | What it does                                                                            |
+| -------------------------------------- | --------------------------------------------------------------------------------------- |
 | `glbgpt login [--no-browser] [--code]` | Sign in. `--no-browser` prints the URL; `--code` pastes a one-time code (headless/SSH). |
-| `glbgpt logout` | Sign out and remove stored credentials. |
-| `glbgpt whoami` | Show the signed-in account. |
-| `glbgpt account` | Membership and credit balance. |
-| `glbgpt account transactions` | Recent spend (authoritative billing). |
+| `glbgpt logout`                        | Sign out and remove stored credentials.                                                 |
+| `glbgpt whoami`                        | Show the signed-in account.                                                             |
+| `glbgpt account`                       | Membership and credit balance.                                                          |
+| `glbgpt account transactions`          | Recent spend (authoritative billing).                                                   |
+| `glbgpt update`                        | Update the CLI to the latest version (runs `npm i -g` for you).                         |
 
 ### Images and video
 
-| Command | What it does |
-|---|---|
+| Command                   | What it does                              |
+| ------------------------- | ----------------------------------------- |
 | `glbgpt image "<prompt>"` | Generate an image (asks before spending). |
-| `glbgpt video "<prompt>"` | Generate a video (asks before spending). |
+| `glbgpt video "<prompt>"` | Generate a video (asks before spending).  |
 
 Common flags: `-m/--model`, `--ar 16:9`, `--res 2K`, `--seed N`, `--negative-prompt "..."`,
 `-i ./ref.png` (reference image), `--duration N` and `--audio/--no-audio` (video),
@@ -64,14 +92,14 @@ task id without waiting).
 
 ### Models and tasks
 
-| Command | What it does |
-|---|---|
-| `glbgpt model list [chat\|image\|video]` | List available models. |
-| `glbgpt model show <model>` | Parameters and limits for one model. |
-| `glbgpt task list` | Recent generation tasks. |
-| `glbgpt task show last` · `glbgpt task show <id>` | A task's status. |
-| `glbgpt task wait last` | Block until a task finishes. |
-| `glbgpt task download last` | Download a finished result. |
+| Command                                           | What it does                         |
+| ------------------------------------------------- | ------------------------------------ |
+| `glbgpt model list [chat\|image\|video]`          | List available models.               |
+| `glbgpt model show <model>`                       | Parameters and limits for one model. |
+| `glbgpt task list`                                | Recent generation tasks.             |
+| `glbgpt task show last` · `glbgpt task show <id>` | A task's status.                     |
+| `glbgpt task wait last`                           | Block until a task finishes.         |
+| `glbgpt task download last`                       | Download a finished result.          |
 
 ### exec — non-interactive
 
@@ -94,19 +122,27 @@ On tool-capable models the assistant can also read files under the current direc
 search the web / fetch pages, and generate images/videos: exec waits for in-flight generations
 before exiting and reports each as a `media_result` event (`--jsonl`) or a stderr line.
 
+Coding tools are **off by default in exec** (no one is present to approve): the model sees the
+tools but every command/write is refused with a message naming the enable flag. Opt in with
+`--allow-write` (create/edit files), `--allow-bash` (shell commands), or `--yolo` (both):
+
+```bash
+glbgpt exec "fix the failing test in src/utils.test.ts and run the tests" --allow-write --allow-bash
+```
+
 ### mcp — use from other agents
 
 `glbgpt mcp` runs a [Model Context Protocol](https://modelcontextprotocol.io) server over stdio,
 so agents like Claude Code, Codex, or Cursor can chat and generate media through your GlobalGPT
 account. Sign in once with `glbgpt login` first.
 
-| Tool | What it does |
-|---|---|
-| `glbgpt_chat` | One chat turn: question in, answer out (system prompt, vision, JSON schema, and — on tool-capable models — live web search/fetch supported). |
-| `glbgpt_generate_image` | Generate an image; usually returns the finished result (URL + local file) in one call. |
-| `glbgpt_generate_video` | Generate a video; returns a `task_id` to check. |
-| `glbgpt_check_task` | Check a generation task. Waits server-side — the agent can just call it again immediately until done. |
-| `glbgpt_list_models` | List available chat/image/video models and what parameters each supports. |
+| Tool                    | What it does                                                                                                                                 |
+| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| `glbgpt_chat`           | One chat turn: question in, answer out (system prompt, vision, JSON schema, and — on tool-capable models — live web search/fetch supported). |
+| `glbgpt_generate_image` | Generate an image; usually returns the finished result (URL + local file) in one call.                                                       |
+| `glbgpt_generate_video` | Generate a video; returns a `task_id` to check.                                                                                              |
+| `glbgpt_check_task`     | Check a generation task. Waits server-side — the agent can just call it again immediately until done.                                        |
+| `glbgpt_list_models`    | List available chat/image/video models and what parameters each supports.                                                                    |
 
 Register it:
 
@@ -182,27 +218,33 @@ re-points the link and leaves nothing to lose.
 
 **Which surface should you use?**
 
-| | Use it when |
-|---|---|
-| **Skill** | Your agent runs shell commands (Claude Code, Cursor, Codex). Zero config — install once and ask for an image. |
-| **MCP** | Your agent speaks MCP but cannot run shell commands, or you want the session credit budget enforced (`--max-credits`). |
-| **CLI / exec** | You are scripting it yourself, in CI, or piping output between tools. |
+|                | Use it when                                                                                                            |
+| -------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| **Skill**      | Your agent runs shell commands (Claude Code, Cursor, Codex). Zero config — install once and ask for an image.          |
+| **MCP**        | Your agent speaks MCP but cannot run shell commands, or you want the session credit budget enforced (`--max-credits`). |
+| **CLI / exec** | You are scripting it yourself, in CI, or piping output between tools.                                                  |
 
 ### config
 
-| Command | What it does |
-|---|---|
-| `glbgpt config list` | Show persisted settings. |
-| `glbgpt config get <key>` · `set <key> <value>` · `unset <key>` | Manage settings. |
+| Command                                                         | What it does             |
+| --------------------------------------------------------------- | ------------------------ |
+| `glbgpt config list`                                            | Show persisted settings. |
+| `glbgpt config get <key>` · `set <key> <value>` · `unset <key>` | Manage settings.         |
 
 Keys: `lang`, `max-credits` (unattended media budget), `context-pruning` (set `false` to
 keep old tool results in long chats), `update-check` (set `false` to disable the startup
-notice about newer versions). One-shot overrides via env vars (`GLBGPT_LANG`,
+update prompt and notices about newer versions). One-shot overrides via env vars (`GLBGPT_LANG`,
 `GLBGPT_TOKEN`, `GLBGPT_MAX_CREDITS`, `GLBGPT_CONTEXT_PRUNING`, `GLBGPT_UPDATE_CHECK`)
 always win.
 
 ## Notes
 
+**Updates.** When a newer version exists, an interactive start shows a chooser (Enter
+updates on the spot; "Skip until next version" mutes the chooser for that release), and
+`exec`/MCP print a one-line notice on stderr so agent hosts can relay it. The check reads
+a local cache refreshed in the background — it never blocks startup or touches the network
+on the hot path. `glbgpt update` upgrades any time; `update-check false` disables it all.
+
 **Usage telemetry.** The CLI reports anonymous usage events (session starts, turn latency,
 tool-call counts, error categories) to the GlobalGPT backend to help us improve the product.
 It never collects prompt text, file contents, or file paths. Set `GLBGPT_DISABLE_TELEMETRY=1`

package/dist/src/coding/backgroundTasks.d.ts

@@ -0,0 +1,34 @@
+export declare class BackgroundBashTasks {
+    private readonly spillDir;
+    private readonly tasks;
+    private seq;
+    constructor(spillDir?: string);
+    /** Ids of tasks still running (for surfaces that want to report before exit). */
+    running(): Array<{
+        id: string;
+        command: string;
+    }>;
+    start(command: string, cwd: string): {
+        taskId: string;
+        outputPath: string;
+    } | {
+        error: string;
+    };
+    /** New output since the last read (tail-capped), plus liveness/exit status. */
+    readNew(taskId: string): Promise<{
+        output: string;
+        truncatedBytes: number;
+        status: 'running' | 'exited' | 'killed';
+        exitCode: number | null;
+    } | {
+        error: string;
+    }>;
+    kill(taskId: string): {
+        ok: true;
+        status: string;
+    } | {
+        error: string;
+    };
+    /** Kill every still-running task (CLI exit path). Synchronous — safe in an exit handler. */
+    killAll(): void;
+}

package/dist/src/coding/backgroundTasks.js

@@ -0,0 +1,154 @@
+import { spawn } from 'node:child_process';
+import { createWriteStream, promises as fs, existsSync } from 'node:fs';
+import { randomBytes } from 'node:crypto';
+import os from 'node:os';
+import path from 'node:path';
+import { cutToBytesFromEnd } from './truncate.js';
+/**
+ * Registry for background bash tasks (`bash` with run_in_background, P1 2026-08-21).
+ *
+ * Every task's stdout+stderr streams to a spill file from byte 0 (background tasks
+ * are long-lived by definition — memory holds nothing). `readNew` returns the bytes
+ * appended since the caller's last read (tail-capped per read), so the model polls
+ * incrementally like `tail -f`. Tasks die with the CLI (process-group kill on exit).
+ */
+const MAX_CONCURRENT_TASKS = 5;
+const MAX_READ_BYTES = 50 * 1024;
+export class BackgroundBashTasks {
+    spillDir;
+    tasks = new Map();
+    seq = 0;
+    constructor(spillDir = os.tmpdir()) {
+        this.spillDir = spillDir;
+        // Belt and suspenders: kill everything if the process exits without cleanup.
+        process.once('exit', () => this.killAll());
+    }
+    /** Ids of tasks still running (for surfaces that want to report before exit). */
+    running() {
+        return [...this.tasks.values()].filter((t) => !t.exited).map((t) => ({ id: t.id, command: t.command }));
+    }
+    start(command, cwd) {
+        const live = [...this.tasks.values()].filter((t) => !t.exited).length;
+        if (live >= MAX_CONCURRENT_TASKS) {
+            return {
+                error: `Too many background tasks (${live} running, max ${MAX_CONCURRENT_TASKS}). Kill one with bash_kill first.`,
+            };
+        }
+        const shell = process.platform === 'win32' ? (process.env.ComSpec ?? 'cmd.exe') : pickShell();
+        const id = `bg-${++this.seq}`;
+        const outputPath = path.join(this.spillDir, `glbgpt-bgtask-${randomBytes(6).toString('hex')}.log`);
+        const out = createWriteStream(outputPath, { flags: 'w' });
+        const child = spawn(shell, ['-c', command], {
+            cwd,
+            detached: process.platform !== 'win32',
+            env: process.env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            windowsHide: true,
+        });
+        child.stdout?.pipe(out, { end: false });
+        child.stderr?.pipe(out, { end: false });
+        const task = {
+            id,
+            command,
+            pid: child.pid,
+            outputPath,
+            cursor: 0,
+            startedAt: Date.now(),
+            exitCode: null,
+            exited: false,
+            killed: false,
+        };
+        child.on('error', () => {
+            task.exited = true;
+            out.end();
+        });
+        child.on('close', (code) => {
+            task.exited = true;
+            task.exitCode = code;
+            out.end();
+        });
+        this.tasks.set(id, task);
+        return { taskId: id, outputPath };
+    }
+    /** New output since the last read (tail-capped), plus liveness/exit status. */
+    async readNew(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            return { error: `Unknown background task: ${taskId}` };
+        let data = '';
+        let truncatedBytes = 0;
+        try {
+            const stat = await fs.stat(task.outputPath);
+            if (stat.size > task.cursor) {
+                const newBytes = stat.size - task.cursor;
+                const fh = await fs.open(task.outputPath, 'r');
+                try {
+                    const readFrom = newBytes > MAX_READ_BYTES ? stat.size - MAX_READ_BYTES : task.cursor;
+                    truncatedBytes = readFrom - task.cursor;
+                    const buf = Buffer.alloc(stat.size - readFrom);
+                    await fh.read(buf, 0, buf.length, readFrom);
+                    data =
+                        truncatedBytes > 0
+                            ? cutToBytesFromEnd(buf.toString('utf8'), MAX_READ_BYTES)
+                            : buf.toString('utf8');
+                }
+                finally {
+                    await fh.close();
+                }
+                task.cursor = stat.size;
+            }
+        }
+        catch {
+            // Spill unreadable (already cleaned?) — report status only.
+        }
+        return {
+            output: data,
+            truncatedBytes,
+            status: task.killed ? 'killed' : task.exited ? 'exited' : 'running',
+            exitCode: task.exitCode,
+        };
+    }
+    kill(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            return { error: `Unknown background task: ${taskId}` };
+        if (task.exited)
+            return { ok: true, status: `already exited with code ${task.exitCode}` };
+        task.killed = true;
+        killTree(task.pid);
+        return { ok: true, status: 'killed' };
+    }
+    /** Kill every still-running task (CLI exit path). Synchronous — safe in an exit handler. */
+    killAll() {
+        for (const task of this.tasks.values()) {
+            if (!task.exited) {
+                task.killed = true;
+                killTree(task.pid);
+            }
+        }
+    }
+}
+function pickShell() {
+    return existsSync('/bin/bash') ? '/bin/bash' : 'sh';
+}
+function killTree(pid) {
+    if (!pid)
+        return;
+    try {
+        if (process.platform === 'win32') {
+            spawn('taskkill', ['/F', '/T', '/PID', String(pid)], { windowsHide: true });
+        }
+        else {
+            process.kill(-pid, 'SIGKILL');
+        }
+    }
+    catch {
+        try {
+            process.kill(pid, 'SIGKILL');
+        }
+        catch {
+            // Already gone.
+        }
+    }
+}
+//# sourceMappingURL=backgroundTasks.js.map

package/dist/src/coding/backgroundTasks.js.map

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

package/dist/src/coding/backgroundTools.d.ts

@@ -0,0 +1,9 @@
+import type { ClientTool } from '../core/types.js';
+import type { BackgroundBashTasks } from './backgroundTasks.js';
+/**
+ * Companion tools for background bash tasks: poll new output, stop a task.
+ * Neither is gated by the permission gate — the task itself was approved when
+ * it was started, and observing/stopping your own task needs no new authority.
+ */
+export declare function createBashOutputTool(tasks: BackgroundBashTasks): ClientTool;
+export declare function createBashKillTool(tasks: BackgroundBashTasks): ClientTool;

package/dist/src/coding/backgroundTools.js

@@ -0,0 +1,63 @@
+/**
+ * Companion tools for background bash tasks: poll new output, stop a task.
+ * Neither is gated by the permission gate — the task itself was approved when
+ * it was started, and observing/stopping your own task needs no new authority.
+ */
+export function createBashOutputTool(tasks) {
+    return {
+        name: 'bash_output',
+        readOnly: true,
+        description: 'Read NEW output from a background bash task since the last bash_output call (like tail -f), ' +
+            'plus its status (running/exited/killed and exit code). Poll this after starting a command ' +
+            'with run_in_background.',
+        parameters: {
+            type: 'object',
+            properties: {
+                task_id: { type: 'string', description: 'Background task id from the bash tool result.' },
+            },
+            required: ['task_id'],
+        },
+        async execute(args) {
+            if (typeof args.task_id !== 'string' || !args.task_id.trim()) {
+                return { error: 'Missing required "task_id" argument.' };
+            }
+            const r = await tasks.readNew(args.task_id.trim());
+            if ('error' in r)
+                return { error: r.error };
+            const parts = [];
+            if (r.truncatedBytes > 0)
+                parts.push(`[${r.truncatedBytes} bytes of new output skipped — showing the tail]`);
+            parts.push(r.output.length > 0 ? r.output : '(no new output)');
+            parts.push(r.status === 'running'
+                ? 'Status: running'
+                : r.status === 'killed'
+                    ? 'Status: killed'
+                    : `Status: exited with code ${r.exitCode}`);
+            return { output: parts.join('\n') };
+        },
+    };
+}
+export function createBashKillTool(tasks) {
+    return {
+        name: 'bash_kill',
+        readOnly: false,
+        description: 'Stop a background bash task (kills its whole process group).',
+        parameters: {
+            type: 'object',
+            properties: {
+                task_id: { type: 'string', description: 'Background task id from the bash tool result.' },
+            },
+            required: ['task_id'],
+        },
+        async execute(args) {
+            if (typeof args.task_id !== 'string' || !args.task_id.trim()) {
+                return { error: 'Missing required "task_id" argument.' };
+            }
+            const r = tasks.kill(args.task_id.trim());
+            if ('error' in r)
+                return { error: r.error };
+            return { output: `Task ${args.task_id}: ${r.status}.` };
+        },
+    };
+}
+//# sourceMappingURL=backgroundTools.js.map

package/dist/src/coding/backgroundTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundTools.js","sourceRoot":"","sources":["../../../src/coding/backgroundTools.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,MAAM,UAAU,oBAAoB,CAAC,KAA0B;IAC7D,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,8FAA8F;YAC9F,4FAA4F;YAC5F,yBAAyB;QAC3B,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;aAC1F;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;QACD,KAAK,CAAC,OAAO,CAAC,IAAI;YAChB,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC7D,OAAO,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;YAC3D,CAAC;YACD,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACnD,IAAI,OAAO,IAAI,CAAC;gBAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,CAAC,CAAC,cAAc,GAAG,CAAC;gBACtB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,cAAc,kDAAkD,CAAC,CAAC;YACrF,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;YAC/D,KAAK,CAAC,IAAI,CACR,CAAC,CAAC,MAAM,KAAK,SAAS;gBACpB,CAAC,CAAC,iBAAiB;gBACnB,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ;oBACrB,CAAC,CAAC,gBAAgB;oBAClB,CAAC,CAAC,4BAA4B,CAAC,CAAC,QAAQ,EAAE,CAC/C,CAAC;YACF,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAA0B;IAC3D,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,8DAA8D;QAC3E,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;aAC1F;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;QACD,KAAK,CAAC,OAAO,CAAC,IAAI;YAChB,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC7D,OAAO,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;YAC3D,CAAC;YACD,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1C,IAAI,OAAO,IAAI,CAAC;gBAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YAC5C,OAAO,EAAE,MAAM,EAAE,QAAQ,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC;QAC1D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/coding/bashTool.d.ts

@@ -0,0 +1,27 @@
+import type { ClientTool } from '../core/types.js';
+import type { PermissionGate } from './permissions.js';
+import type { BackgroundBashTasks } from './backgroundTasks.js';
+export declare const BASH_DEFAULT_TIMEOUT_S = 120;
+export declare const BASH_MAX_TIMEOUT_S = 600;
+/**
+ * The `bash` tool: run a shell command in the workspace directory.
+ *
+ * Execution contract (2026-08-21 design, pi lineage):
+ * - New process per call; no shell state persists. Commands run in the session cwd —
+ *   there is NO cwd parameter and `cd` does not carry over (prompt guidance says to use
+ *   absolute paths or `cd` within a single command).
+ * - stdout+stderr merged in arrival order; tail-truncated at 2000 lines / 50KB with the
+ *   full output spilled to a temp file (footnote names the path).
+ * - Non-zero exit is an error result but the collected output is still attached — the
+ *   model needs the output to react.
+ * - Timeout (default 120s, cap 600s) kills the whole process GROUP (detached spawn), so
+ *   children die with the shell.
+ */
+export declare function createBashTool(opts: {
+    cwd: string;
+    gate: PermissionGate;
+    /** Background task registry; absent = run_in_background rejected. */
+    background?: BackgroundBashTasks;
+    /** Test hook: where spill files go. */
+    spillDir?: string;
+}): ClientTool;

package/dist/src/coding/bashTool.js

@@ -0,0 +1,144 @@
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { OutputAccumulator } from './outputAccumulator.js';
+export const BASH_DEFAULT_TIMEOUT_S = 120;
+export const BASH_MAX_TIMEOUT_S = 600;
+/**
+ * The `bash` tool: run a shell command in the workspace directory.
+ *
+ * Execution contract (2026-08-21 design, pi lineage):
+ * - New process per call; no shell state persists. Commands run in the session cwd —
+ *   there is NO cwd parameter and `cd` does not carry over (prompt guidance says to use
+ *   absolute paths or `cd` within a single command).
+ * - stdout+stderr merged in arrival order; tail-truncated at 2000 lines / 50KB with the
+ *   full output spilled to a temp file (footnote names the path).
+ * - Non-zero exit is an error result but the collected output is still attached — the
+ *   model needs the output to react.
+ * - Timeout (default 120s, cap 600s) kills the whole process GROUP (detached spawn), so
+ *   children die with the shell.
+ */
+export function createBashTool(opts) {
+    return {
+        name: 'bash',
+        description: 'Execute a bash command in the workspace directory. Returns stdout and stderr combined. ' +
+            'Output is truncated to the last 2000 lines or 50KB (whichever is hit first); when truncated, ' +
+            'the full output is saved to a temp file whose path is included in the result. ' +
+            `Optional timeout in seconds (default ${BASH_DEFAULT_TIMEOUT_S}, max ${BASH_MAX_TIMEOUT_S}). ` +
+            'Shell state does not persist between calls; the working directory is always the workspace root. ' +
+            'For long-running commands (dev servers, watchers) set run_in_background: true — the result gives ' +
+            'a task id to poll with bash_output and stop with bash_kill.',
+        parameters: {
+            type: 'object',
+            properties: {
+                command: { type: 'string', description: 'Bash command to execute' },
+                timeout_seconds: {
+                    type: 'number',
+                    description: `Timeout in seconds (default ${BASH_DEFAULT_TIMEOUT_S}, max ${BASH_MAX_TIMEOUT_S})`,
+                },
+                run_in_background: {
+                    type: 'boolean',
+                    description: 'Run detached and return a task id immediately (for dev servers / long jobs). ' +
+                        'Poll with bash_output; stop with bash_kill. No timeout applies.',
+                },
+            },
+            required: ['command'],
+        },
+        readOnly: false,
+        async execute(args) {
+            const command = typeof args.command === 'string' ? args.command.trim() : '';
+            if (!command)
+                return { error: 'command is required' };
+            const rawTimeout = args.timeout_seconds;
+            let timeoutS = BASH_DEFAULT_TIMEOUT_S;
+            if (rawTimeout !== undefined && rawTimeout !== null) {
+                const n = Number(rawTimeout);
+                if (!Number.isFinite(n) || n <= 0) {
+                    return { error: 'Invalid timeout_seconds: must be a positive number of seconds' };
+                }
+                timeoutS = Math.min(n, BASH_MAX_TIMEOUT_S);
+            }
+            const verdict = await opts.gate.check({ kind: 'bash', command });
+            if (!verdict.ok)
+                return { error: verdict.message };
+            if (args.run_in_background === true) {
+                if (!opts.background)
+                    return { error: 'Background tasks are not available here.' };
+                const started = opts.background.start(command, opts.cwd);
+                if ('error' in started)
+                    return { error: started.error };
+                return {
+                    output: `Started background task ${started.taskId}. ` +
+                        'Poll new output with bash_output; stop it with bash_kill. It dies when the CLI exits.',
+                    task_id: started.taskId,
+                };
+            }
+            return runBash(command, opts.cwd, timeoutS, opts.spillDir);
+        },
+    };
+}
+function pickShell() {
+    if (process.platform === 'win32')
+        return process.env.ComSpec ?? 'cmd.exe';
+    if (existsSync('/bin/bash'))
+        return '/bin/bash';
+    return 'sh';
+}
+async function runBash(command, cwd, timeoutS, spillDir) {
+    if (!existsSync(cwd)) {
+        return { error: `Working directory does not exist: ${cwd}` };
+    }
+    const shell = pickShell();
+    const detached = process.platform !== 'win32';
+    const child = spawn(shell, ['-c', command], {
+        cwd,
+        detached,
+        env: process.env,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        windowsHide: true,
+    });
+    const acc = new OutputAccumulator(undefined, undefined, spillDir);
+    child.stdout?.on('data', (b) => acc.append(b));
+    child.stderr?.on('data', (b) => acc.append(b));
+    let timedOut = false;
+    const timer = setTimeout(() => {
+        timedOut = true;
+        killTree(child.pid);
+    }, timeoutS * 1000);
+    const exitCode = await new Promise((resolve) => {
+        child.on('error', () => resolve(null));
+        // 'close' (not 'exit') so stdio has fully flushed before we snapshot the output.
+        child.on('close', (code) => resolve(code));
+    });
+    clearTimeout(timer);
+    const { text } = await acc.finalize();
+    const output = text.length > 0 ? text : '(no output)';
+    if (timedOut) {
+        return { error: `${output}\n\nCommand timed out after ${timeoutS} seconds` };
+    }
+    if (exitCode !== 0 && exitCode !== null) {
+        return { error: `${output}\n\nCommand exited with code ${exitCode}` };
+    }
+    return { output };
+}
+/** Kill the whole process group (detached spawn) so children die with the shell. */
+function killTree(pid) {
+    if (!pid)
+        return;
+    try {
+        if (process.platform === 'win32') {
+            spawn('taskkill', ['/F', '/T', '/PID', String(pid)], { windowsHide: true });
+        }
+        else {
+            process.kill(-pid, 'SIGKILL');
+        }
+    }
+    catch {
+        try {
+            process.kill(pid, 'SIGKILL');
+        }
+        catch {
+            // Already gone.
+        }
+    }
+}
+//# sourceMappingURL=bashTool.js.map

package/dist/src/coding/bashTool.js.map

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