@gaunt-sloth/agent 2.0.0-alpha.1 → 2.0.0-alpha.11

package/dist/resolvers.js

@@ -9,11 +9,13 @@
  * agent middleware registry.
  */
 import { debugLog } from '@gaunt-sloth/core/utils/debugUtils.js';
-import { displayInfo } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { displayInfo, displayWarning } from '@gaunt-sloth/core/utils/consoleUtils.js';
 import { createA2AAgentTool } from '#src/tools/A2AAgentTool.js';
 import { prepareMcpTools } from '#src/utils/mcpUtils.js';
+import { formatMcpConnectFailureMessage } from '#src/utils/mcpAuthError.js';
 import { createAuthProviderAndAuthenticate } from '#src/mcp/OAuthClientProviderImpl.js';
 import { MultiServerMCPClient } from '@langchain/mcp-adapters';
+import { MCP_TOOL_NAME_PREFIX } from '@gaunt-sloth/core/constants.js';
 /**
  * Create a full set of resolvers for the GthLangChainAgent.
  *
@@ -22,8 +24,14 @@ import { MultiServerMCPClient } from '@langchain/mcp-adapters';
  */
 export function createResolvers() {
     let mcpClientInstance = null;
+    // EXT-32: per-server MCP discovery `instructions` captured during the most recent resolveTools.
+    // Kept on the resolver so the composed system prompt (via getMcpServerInstructions) AND a future
+    // MCP debug tab ([[TUI-C20]]) can read the SAME captured text without re-querying the servers.
+    let mcpServerInstructions = [];
     const resolveTools = async (config, command) => {
         const tools = [];
+        // Fresh capture per resolution; a stale value must never leak across re-inits.
+        mcpServerInstructions = [];
         // 1. Get built-in tools (filesystem, devTools, customTools, etc.)
         try {
             const { getDefaultTools } = await import('#src/builtInToolsConfig.js');
@@ -50,6 +58,37 @@ export function createResolvers() {
         }
         catch (error) {
             debugLog(`MCP tools error: ${error}`);
+            // EXT-31: both connection-level failures (incl. expired/invalid auth) AND per-tool schema-load
+            // errors under throwOnLoadError are caught inside the adapter's _initializeConnection and
+            // routed to the function-form onConnectionError callback in getMcpClient (surface + skip, no
+            // re-throw), so they do NOT reach here. This backstop therefore only catches a wholesale
+            // getTools() throw (belt-and-braces) — surface it neutrally so MCP tool loading can never fail
+            // silently, while the session degrades gracefully (built-in and A2A tools below still load).
+            displayWarning(`MCP integration tools could not be fully loaded; continuing without them. ` +
+                `Underlying error: ${error}`);
+        }
+        // 2b. EXT-32: capture each connected MCP server's discovery `instructions` string (from its MCP
+        // `initialize` handshake, exposed by the SDK Client via getInstructions()). This is ISOLATED
+        // from the getTools() block above so a getClient/getInstructions failure can never discard
+        // successfully-loaded MCP tools nor log a misleading "MCP tools error". Per-server try/catch so
+        // one unreachable/instruction-less server does not abort the rest. Absent/empty/whitespace-only
+        // instructions contribute nothing (trimmed, then omitted). The captured value is injected —
+        // fenced + per-server-labelled — into the composed system prompt on BOTH backends.
+        if (mcpClientInstance) {
+            const serverNames = Object.keys(config.mcpServers || {});
+            for (const serverName of serverNames) {
+                try {
+                    const client = await mcpClientInstance.getClient(serverName);
+                    const instructions = client?.getInstructions()?.trim();
+                    if (instructions) {
+                        mcpServerInstructions.push({ server: serverName, instructions });
+                    }
+                }
+                catch (error) {
+                    debugLog(`MCP instructions capture error for '${serverName}': ${error}`);
+                }
+            }
+            debugLog(`MCP servers with instructions: ${mcpServerInstructions.length}`);
         }
         // 3. Get A2A tools
         const a2aTools = getA2ATools(config);
@@ -85,11 +124,16 @@ export function createResolvers() {
     const cleanupMiddleware = async () => {
         // No cleanup needed for middleware currently
     };
+    // EXT-32: expose the captured per-server MCP instructions for the shared prompt composition (and,
+    // later, the [[TUI-C20]] MCP debug tab). Returns a defensive copy so callers can't mutate the
+    // captured state. Empty until resolveTools has run (or when no server supplied instructions).
+    const getMcpServerInstructions = () => [...mcpServerInstructions];
     return {
         resolveTools,
         cleanupTools,
         resolveMiddleware,
         cleanupMiddleware,
+        getMcpServerInstructions,
     };
 }
 // --- Private helpers ---
@@ -103,11 +147,19 @@ async function getMcpClient(config) {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         if (server.url && server && server.authProvider === 'OAuth') {
             displayInfo(`Starting OAuth for ${server.url}`);
-            const authProvider = await createAuthProviderAndAuthenticate(server);
-            mcpServers[serverName] = {
-                ...server,
-                authProvider,
-            };
+            try {
+                const authProvider = await createAuthProviderAndAuthenticate(server);
+                mcpServers[serverName] = {
+                    ...server,
+                    authProvider,
+                };
+            }
+            catch (error) {
+                // EXT-31: an OAuth handshake/refresh failure happens BEFORE the MCP client exists, so it
+                // can't reach the connect-time onConnectionError callback below. Surface it here (named +
+                // actionable) and skip only THIS server so the others still load — never a silent drop.
+                displayWarning(formatMcpConnectFailureMessage(serverName, error, { oauth: true }));
+            }
         }
         else {
             mcpServers[serverName] = server;
@@ -118,8 +170,19 @@ async function getMcpClient(config) {
         return new MultiServerMCPClient({
             throwOnLoadError: true,
             prefixToolNameWithServerName: true,
-            additionalToolNamePrefix: 'mcp',
+            // TUI-C20: single-sourced so the MCP debug tab can regroup tools back by server prefix.
+            additionalToolNamePrefix: MCP_TOOL_NAME_PREFIX,
             mcpServers: mcpServers,
+            // EXT-31: per-server surfacing. The function form of onConnectionError lets a failed server be
+            // classified + surfaced and then SKIPPED (added to the client's failedServers set) rather than
+            // aborting getTools() — so one integration's expired auth no longer swallows every other
+            // server's tools. Auth failures (401/403/expired token/refused handshake) get a named re-auth
+            // message; other failures are surfaced plainly as non-auth. Degradation stays graceful.
+            onConnectionError: ({ serverName, error }) => {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const oauth = rawMcpServers[serverName]?.authProvider === 'OAuth';
+                displayWarning(formatMcpConnectFailureMessage(serverName, error, { oauth }));
+            },
         });
     }
     else {

package/dist/resolvers.js.map

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

package/dist/tools/GthDevToolkit.d.ts

@@ -3,10 +3,38 @@
  */
 import { BaseToolkit, StructuredToolInterface } from '@langchain/core/tools';
 import { GthDevToolsConfig } from '@gaunt-sloth/core/config.js';
+import type { GthCommand } from '@gaunt-sloth/core/core/types.js';
+export { ShellCommandFailedError } from '@gaunt-sloth/core/core/shell/ShellCommandFailedError.js';
+/**
+ * Kill the child AND its descendants on timeout.
+ *
+ * POSIX: the child is spawned `detached`, so it leads its own process group;
+ * signalling the NEGATIVE pid (`-pid`) delivers to the whole group — otherwise a
+ * shell's children (e.g. a spawned server) would be orphaned and keep running.
+ *
+ * Windows (EXT-15): there are no POSIX process groups — `process.kill(-pid)`
+ * throws `EINVAL`, and `child.kill()` only terminates the `cmd.exe` wrapper while
+ * grandchildren keep the piped stdio handles open, so `'close'` never fires and
+ * the tool Promise hangs forever (silently cancelling Windows CI). Use `taskkill
+ * /T` to kill the whole tree by pid; `/F` (force) mirrors POSIX SIGKILL, while a
+ * graceful taskkill mirrors SIGTERM. Swallows the races where it has already exited.
+ *
+ * Exported for unit testing the platform branch without a Windows host.
+ */
+export declare function killProcessGroup(child: {
+    pid?: number;
+    kill: (signal?: NodeJS.Signals) => boolean;
+}, signal: NodeJS.Signals): void;
 export default class GthDevToolkit extends BaseToolkit {
     tools: StructuredToolInterface[];
     private commands;
-    constructor(commands?: GthDevToolsConfig);
+    /**
+     * The active command, threaded through so the EXT-12 absent-config default for the shell
+     * tool (ON in `code`, OFF elsewhere) is resolved consistently with the deep agent's
+     * interrupt wiring. Omitted → historical OFF-by-default behaviour.
+     */
+    private readonly command;
+    constructor(commands?: GthDevToolsConfig, command?: GthCommand | undefined);
     /**
      * Get tools filtered by operation type
      */
@@ -19,6 +47,22 @@ export default class GthDevToolkit extends BaseToolkit {
      * Build the command for running a single test file
      */
     private buildSingleTestCommand;
+    /**
+     * Execute a shell command with the EXT-9 Tier-1 hardening applied:
+     *  1. stdin closed + timeout + process-group kill (no hang on interactive
+     *     commands; runaway commands are killed group-wide on timeout),
+     *  2. output capped with a head/tail window + temp-file spillover,
+     *  3. provider/LLM credentials scrubbed from the child env,
+     *  4. an unbypassable hardline blocklist (refuses catastrophic commands BEFORE
+     *     spawn — fires even when confirmation is bypassed by yolo).
+     *
+     * Resolves with a model-facing string on a CLEAN exit (`code === 0`). EXT-20: a non-zero exit
+     * and a timeout-kill instead REJECT with a {@link ShellCommandFailedError} that carries the FULL
+     * model-facing body — the deep-agent {@link GthDeepShellExitSoftening} middleware converts that
+     * throw into an error `ToolMessage` (status:'error' → ✗) while preserving the output, so the
+     * model still sees the killed-after-N / exit-code message and can continue. Spawn-level failures
+     * (`child.on('error')`) still reject with a plain `Error`.
+     */
     private executeCommand;
     private createTools;
 }

package/dist/tools/GthDevToolkit.js

@@ -3,10 +3,85 @@
  */
 import { BaseToolkit, tool } from '@langchain/core/tools';
 import { z } from 'zod';
-import { spawn } from 'child_process';
+import { spawn, spawnSync } from 'child_process';
 import path from 'node:path';
-import { displayInfo, displayError } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { displayInfo, displayError, displayWarning } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { getShellMaxOutputBytes, getShellTimeoutMs, isShellToolEnabled, } from '@gaunt-sloth/core/config.js';
 import { stdout } from '@gaunt-sloth/core/utils/systemUtils.js';
+import { ShellCommandFailedError } from '@gaunt-sloth/core/core/shell/ShellCommandFailedError.js';
+import { checkHardline } from '#src/tools/shell/hardline.js';
+import { buildScrubbedEnv } from '#src/tools/shell/env.js';
+import { OutputBuffer } from '#src/tools/shell/outputBuffer.js';
+import { getShellWorkDir } from '#src/tools/shell/workDir.js';
+// EXT-21: `ShellCommandFailedError` moved to core so BOTH agents can recognise a shell failure
+// without breaking the agent→core dependency direction (the lean `GthLangChainAgent` lives in core
+// and cannot import from agent). Re-exported here so the historical import site
+// (`#src/tools/GthDevToolkit.js`) — GthDeepAgent + the existing GthDevToolkit specs — keeps working
+// and every throw below is one and the same core type both agents' softeners catch.
+export { ShellCommandFailedError } from '@gaunt-sloth/core/core/shell/ShellCommandFailedError.js';
+// Grace period (ms) between SIGTERM and the escalation to SIGKILL when a command
+// exceeds its timeout. Mirrors opencode's `forceKillAfter` (3s).
+const KILL_GRACE_MS = 3_000;
+/**
+ * Kill the child AND its descendants on timeout.
+ *
+ * POSIX: the child is spawned `detached`, so it leads its own process group;
+ * signalling the NEGATIVE pid (`-pid`) delivers to the whole group — otherwise a
+ * shell's children (e.g. a spawned server) would be orphaned and keep running.
+ *
+ * Windows (EXT-15): there are no POSIX process groups — `process.kill(-pid)`
+ * throws `EINVAL`, and `child.kill()` only terminates the `cmd.exe` wrapper while
+ * grandchildren keep the piped stdio handles open, so `'close'` never fires and
+ * the tool Promise hangs forever (silently cancelling Windows CI). Use `taskkill
+ * /T` to kill the whole tree by pid; `/F` (force) mirrors POSIX SIGKILL, while a
+ * graceful taskkill mirrors SIGTERM. Swallows the races where it has already exited.
+ *
+ * Exported for unit testing the platform branch without a Windows host.
+ */
+export function killProcessGroup(child, signal) {
+    if (typeof child.pid !== 'number')
+        return;
+    if (process.platform === 'win32') {
+        // No process groups on Windows; taskkill /T walks the whole tree by pid.
+        const args = ['/PID', String(child.pid), '/T'];
+        if (signal === 'SIGKILL')
+            args.push('/F');
+        // IMPORTANT: spawnSync does NOT throw when it fails to spawn (e.g. ENOENT if taskkill is
+        // missing from PATH) — unlike execSync, it returns an object with an `error` property. So a
+        // try/catch would never reach the fallback. Inspect `res.error` explicitly and fall back to
+        // the direct child kill (best effort). A non-zero exit (process already gone) is NOT a spawn
+        // failure, so it correctly does not trigger the fallback. (`res?.` tolerates test mocks.)
+        const res = spawnSync('taskkill', args, { stdio: 'ignore', windowsHide: true });
+        if (res?.error) {
+            try {
+                child.kill(signal);
+            }
+            catch {
+                // Already exited — nothing to do.
+            }
+        }
+        return;
+    }
+    try {
+        // Negative pid → signal the entire process group.
+        process.kill(-child.pid, signal);
+        return;
+    }
+    catch (e) {
+        const code = e?.code;
+        // ESRCH: already gone. EPERM: group-kill not permitted — fall through to the
+        // direct child kill below. Anything else: also fall back rather than throw.
+        if (code === 'ESRCH')
+            return;
+    }
+    // Fallback: kill just the child (best effort).
+    try {
+        child.kill(signal);
+    }
+    catch {
+        // Already exited — nothing to do.
+    }
+}
 // Helper function to create a tool with dev type
 function createGthTool(fn, config, gthDevType) {
     const toolInstance = tool(fn, config);
@@ -21,13 +96,23 @@ const RunBuildArgsSchema = z.object({});
 const RunSingleTestArgsSchema = z.object({
     testPath: z.string().describe('Relative path to the test file to run'),
 });
+const RunShellCommandArgsSchema = z.object({
+    command: z.string().describe('The shell command to run'),
+});
 const TEST_PATH_PLACEHOLDER = '${testPath}';
 export default class GthDevToolkit extends BaseToolkit {
     tools;
     commands;
-    constructor(commands = {}) {
+    /**
+     * The active command, threaded through so the EXT-12 absent-config default for the shell
+     * tool (ON in `code`, OFF elsewhere) is resolved consistently with the deep agent's
+     * interrupt wiring. Omitted → historical OFF-by-default behaviour.
+     */
+    command;
+    constructor(commands = {}, command) {
         super();
         this.commands = commands;
+        this.command = command;
         this.tools = this.createTools();
     }
     /**
@@ -93,45 +178,131 @@ export default class GthDevToolkit extends BaseToolkit {
             throw new Error('No test command configured');
         }
     }
+    /**
+     * Execute a shell command with the EXT-9 Tier-1 hardening applied:
+     *  1. stdin closed + timeout + process-group kill (no hang on interactive
+     *     commands; runaway commands are killed group-wide on timeout),
+     *  2. output capped with a head/tail window + temp-file spillover,
+     *  3. provider/LLM credentials scrubbed from the child env,
+     *  4. an unbypassable hardline blocklist (refuses catastrophic commands BEFORE
+     *     spawn — fires even when confirmation is bypassed by yolo).
+     *
+     * Resolves with a model-facing string on a CLEAN exit (`code === 0`). EXT-20: a non-zero exit
+     * and a timeout-kill instead REJECT with a {@link ShellCommandFailedError} that carries the FULL
+     * model-facing body — the deep-agent {@link GthDeepShellExitSoftening} middleware converts that
+     * throw into an error `ToolMessage` (status:'error' → ✗) while preserving the output, so the
+     * model still sees the killed-after-N / exit-code message and can continue. Spawn-level failures
+     * (`child.on('error')`) still reject with a plain `Error`.
+     */
     async executeCommand(command, toolName) {
         displayInfo(`\n🔧 Executing ${toolName}: ${command}`);
+        // (4) Hardline blocklist — checked here so it fires regardless of yolo,
+        // allow-lists, or any confirmation path. Refuse WITHOUT executing.
+        const hardline = checkHardline(command);
+        if (hardline) {
+            const refusal = `Refusing to execute '${command}': blocked by hardline safety policy ` +
+                `(${hardline.description}). This is a catastrophic, non-recoverable command ` +
+                `and is blocked even when command confirmation is disabled.`;
+            displayWarning(`\n⛔ ${refusal}`);
+            return refusal;
+        }
+        const timeoutMs = getShellTimeoutMs(this.commands);
+        const maxOutputBytes = getShellMaxOutputBytes(this.commands);
         return new Promise((resolve, reject) => {
             const child = spawn(command, {
                 shell: true,
+                // EXT-22 (S4) / EXT-23: spawn in the SAME directory the deepagents FilesystemBackend is
+                // rooted at, so the shell tool and the fs tools (ls/read_file/write_file/edit_file/glob/grep)
+                // operate on one path namespace instead of diverging. `getShellWorkDir()` returns
+                // `getCurrentWorkDir()` on the local code/chat runner + AG-UI (where init() roots the backend
+                // at `rootDir: getCurrentWorkDir()`), and the ACP session override on the ACP transport (where
+                // `gthAcpServer` re-roots the per-session backend to `session/new.cwd` and updates the
+                // override to match — see tools/shell/workDir.ts). Evaluated at call time.
+                cwd: getShellWorkDir(),
+                // (1) Never let the child block on stdin (e.g. git commit opening $EDITOR).
+                stdio: ['ignore', 'pipe', 'pipe'],
+                // (1) POSIX: own process group so we can kill the whole tree on timeout
+                // (see killProcessGroup). No-op/harmful on Windows, which uses taskkill /T.
+                detached: process.platform !== 'win32',
+                // (3) Child env with provider/LLM credentials removed.
+                env: buildScrubbedEnv(),
             });
-            let output = '';
-            // Capture output if available (when stdio is not 'inherit')
+            // (2) Bounded capture for the returned message; live streaming is uncapped.
+            const buffer = new OutputBuffer(maxOutputBytes);
+            let timedOut = false;
+            let settled = false;
+            let killTimer;
+            const timeoutTimer = setTimeout(() => {
+                timedOut = true;
+                killProcessGroup(child, 'SIGTERM');
+                // Escalate to SIGKILL after a short grace if it didn't die.
+                killTimer = setTimeout(() => killProcessGroup(child, 'SIGKILL'), KILL_GRACE_MS);
+                // killTimer must not keep the event loop alive on its own.
+                killTimer.unref?.();
+            }, timeoutMs);
+            timeoutTimer.unref?.();
+            const clearTimers = () => {
+                clearTimeout(timeoutTimer);
+                if (killTimer)
+                    clearTimeout(killTimer);
+            };
             if (child.stdout) {
                 child.stdout.on('data', (data) => {
                     const chunk = data.toString();
                     stdout.write(chunk);
-                    output += chunk;
+                    buffer.append(chunk);
                 });
             }
             if (child.stderr) {
                 child.stderr.on('data', (data) => {
                     const chunk = data.toString();
                     stdout.write(chunk);
-                    output += chunk;
+                    buffer.append(chunk);
                 });
             }
             child.on('close', (code) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimers();
+                const captured = buffer.finalize();
+                const body = `Executing '${command}'...\n\n` +
+                    `<COMMAND_OUTPUT>\n` +
+                    captured.text +
+                    `</COMMAND_OUTPUT>\n`;
+                if (timedOut) {
+                    // EXT-20: a timeout-kill is a failure — reject so the deep-agent middleware flips the
+                    // tool result to status:'error' (✗). The FULL body is preserved on the error so the
+                    // model's observation is unchanged except for the status.
+                    reject(new ShellCommandFailedError({
+                        output: body +
+                            `\n\nCommand '${command}' was killed after exceeding the ${Math.round(timeoutMs / 1000)}s timeout. ` +
+                            `If it legitimately needs longer, increase the shell timeout in config.`,
+                        exitCode: null,
+                        command,
+                        toolName,
+                    }));
+                    return;
+                }
                 if (code === 0) {
-                    resolve(`Executing '${command}'...\n\n` +
-                        `<COMMAND_OUTPUT>\n` +
-                        output +
-                        `</COMMAND_OUTPUT>\n` +
-                        `\n\nCommand '${command}' completed successfully`);
+                    resolve(body + `\n\nCommand '${command}' completed successfully`);
                 }
                 else {
-                    resolve(`Executing '${command}'...\n\n` +
-                        `<COMMAND_OUTPUT>\n` +
-                        output +
-                        `</COMMAND_OUTPUT>\n` +
-                        `\n\nCommand '${command}' exited with code ${code}`);
+                    // EXT-20: a non-zero exit is a failure — reject (was resolve) so the softening
+                    // middleware surfaces the ✗ (isError) signal while preserving the full output body.
+                    reject(new ShellCommandFailedError({
+                        output: body + `\n\nCommand '${command}' exited with code ${code}`,
+                        exitCode: code,
+                        command,
+                        toolName,
+                    }));
                 }
             });
             child.on('error', (error) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimers();
                 const errorMsg = `Failed to execute command '${command}': ${error.message}`;
                 displayError(errorMsg);
                 reject(new Error(errorMsg));
@@ -183,6 +354,22 @@ export default class GthDevToolkit extends BaseToolkit {
                 schema: RunBuildArgsSchema,
             }, 'execute'));
         }
+        // Opt-in general-purpose shell tool. Unlike the fixed run_* commands, the model supplies
+        // the command, so the guardrail is the per-command confirmation dialog wired by the deep
+        // agent (createDeepAgent `interruptOn`), not a parameter sanitizer — a real shell command
+        // legitimately contains pipes / `$` / `;`, so validateParameterValue must NOT be applied.
+        if (isShellToolEnabled(this.commands, this.command)) {
+            tools.push(createGthTool(async (args) => {
+                return await this.executeCommand(args.command, 'run_shell_command');
+            }, {
+                name: 'run_shell_command',
+                description: 'Run an arbitrary shell command in the project working directory and return its ' +
+                    'combined stdout/stderr and exit status. Use for any task the fixed run_* tools do ' +
+                    'not cover (e.g. git, package managers, file inspection). Each call is subject to ' +
+                    'human approval before it runs unless approval has been disabled.',
+                schema: RunShellCommandArgsSchema,
+            }, 'execute'));
+        }
         return tools;
     }
 }

package/dist/tools/GthDevToolkit.js.map

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

package/dist/tools/gthChecklistTool.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { GthConfig } from '@gaunt-sloth/core/config.js';
+export declare const CHECKLIST_TOOL_NAME = "gth_checklist";
+export type ChecklistStatus = 'pending' | 'in_progress' | 'completed';
+export interface ChecklistItem {
+    content: string;
+    status: ChecklistStatus;
+}
+/** Render a checklist as a markdown observation the model (and a plain terminal) can read back. */
+export declare function formatChecklist(items: ChecklistItem[]): string;
+export declare function get(_config: GthConfig): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        content: z.ZodString;
+        status: z.ZodEnum<{
+            completed: "completed";
+            pending: "pending";
+            in_progress: "in_progress";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, {
+    items: {
+        content: string;
+        status: "completed" | "pending" | "in_progress";
+    }[];
+}, {
+    items: {
+        content: string;
+        status: "completed" | "pending" | "in_progress";
+    }[];
+}, string, unknown, "gth_checklist">;

package/dist/tools/gthChecklistTool.js

@@ -0,0 +1,81 @@
+/**
+ * @module gthChecklistTool
+ * The `gth_checklist` planning tool — the lean agent's first-party equivalent of the deepagents
+ * `write_todos` capability. Gives the model a durable, structured task list for multi-step work so
+ * it can plan, track progress, and stay oriented across a long run.
+ *
+ * Design (mirrors Claude Code's `TodoWrite` / opencode's todo tools): the model sends the WHOLE
+ * list every call and it REPLACES the previous one (no incremental add/remove verbs to keep in
+ * sync). State is a closure private to each `get()` result, i.e. one list per agent init / session,
+ * so concurrent sessions (e.g. the AG-UI server) never share a checklist. The tool returns a
+ * rendered markdown checklist as its observation; the TUI additionally folds it into a live
+ * checkbox panel (see {@link file://../../../app/src/tui/viewModel.ts} `CHECKLIST_TOOL_NAME`).
+ *
+ * The name is deliberately NOT `write_todos` (nor `task`/`read_file`/`write_file`/`edit_file`/`ls`):
+ * on the experimental deep backend `createDeepAgent` throws on a name collision with its built-ins,
+ * and both backends share the same resolved toolset.
+ */
+import { tool } from '@langchain/core/tools';
+import { z } from 'zod';
+export const CHECKLIST_TOOL_NAME = 'gth_checklist';
+const itemSchema = z.object({
+    content: z
+        .string()
+        .min(1)
+        .describe('Short, imperative description of the task, e.g. "Add tests"'),
+    status: z
+        .enum(['pending', 'in_progress', 'completed'])
+        .describe('pending = not started, in_progress = being worked on now, completed = finished'),
+});
+const schema = z.object({
+    items: z
+        .array(itemSchema)
+        .describe('The FULL checklist. This replaces any previous checklist entirely.'),
+});
+const description = [
+    'Record and update a checklist (todo list) for the current task. Use it to plan multi-step',
+    'work and to show the user your progress. Send the ENTIRE list every time — it replaces the',
+    'previous checklist, so include already-completed items too.',
+    '',
+    'When to use: any task with 3+ distinct steps, or when the user gives several requirements.',
+    'Skip it for a single trivial step.',
+    '',
+    'Rules:',
+    '- Keep at most ONE item "in_progress" at a time.',
+    '- Mark an item "completed" as soon as it is done — do not batch completions.',
+    '- Keep item text short and outcome-focused.',
+].join('\n');
+const STATUS_GLYPH = {
+    completed: '[x]',
+    in_progress: '[~]',
+    pending: '[ ]',
+};
+/** Render a checklist as a markdown observation the model (and a plain terminal) can read back. */
+export function formatChecklist(items) {
+    if (items.length === 0) {
+        return 'Checklist cleared (no items).';
+    }
+    const completed = items.filter((i) => i.status === 'completed').length;
+    const header = `Checklist (${completed}/${items.length} completed):`;
+    const lines = items.map((i) => `${STATUS_GLYPH[i.status]} ${i.content}`);
+    return [header, ...lines].join('\n');
+}
+export function get(_config) {
+    // Session-scoped state: one list per tool instance (== per agent init). Whole-list-replace
+    // semantics mean each call overwrites this; it is kept so the tool can render the current
+    // state back as its observation.
+    let items = [];
+    const impl = async ({ items: next }) => {
+        const inProgress = next.filter((i) => i.status === 'in_progress').length;
+        if (inProgress > 1) {
+            // Do NOT mutate state on a malformed update — return guidance so the model can retry.
+            return (`Rejected: ${inProgress} items are "in_progress" but only one may be in progress at a ` +
+                'time. Set all but the current task to "pending" or "completed" and call gth_checklist ' +
+                'again.');
+        }
+        items = next;
+        return formatChecklist(items);
+    };
+    return tool(impl, { name: CHECKLIST_TOOL_NAME, description, schema });
+}
+//# sourceMappingURL=gthChecklistTool.js.map