@gaunt-sloth/agent 2.0.0-alpha.3 → 2.0.0-alpha.30

package/dist/tools/GthDevToolkit.js

@@ -5,12 +5,22 @@ import { BaseToolkit, tool } from '@langchain/core/tools';
 import { z } from 'zod';
 import { spawn, spawnSync } from 'child_process';
 import path from 'node:path';
-import { displayInfo, displayError, displayWarning } from '@gaunt-sloth/core/utils/consoleUtils.js';
+// TUI-C31 (a): failure-path warnings/errors travel the tool-output channel (see emitToolOutput
+// below) so they reach the managed frame under the Ink TUI instead of raw stdout; the channel's
+// default sink still renders them via displayWarning/displayError for every headless surface.
 import { getShellMaxOutputBytes, getShellTimeoutMs, isShellToolEnabled, } from '@gaunt-sloth/core/config.js';
-import { stdout } from '@gaunt-sloth/core/utils/systemUtils.js';
-import { checkHardline } from '#src/tools/shell/hardline.js';
+import { emitToolOutput } from '@gaunt-sloth/core/core/toolOutputChannel.js';
+import { ShellCommandFailedError } from '@gaunt-sloth/core/core/shell/ShellCommandFailedError.js';
+import { buildHardlineRefusal, checkHardline } from '@gaunt-sloth/core/core/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;
@@ -74,7 +84,9 @@ export function killProcessGroup(child, signal) {
         // Already exited — nothing to do.
     }
 }
-// Helper function to create a tool with dev type
+// Helper function to create a tool with dev type. The fn's second parameter is LangChain's
+// ToolRunnableConfig — when the framework invokes the tool with a ToolCall, `config.toolCall.id`
+// identifies the call, which TUI-C17 threads into the live-output channel for attribution.
 function createGthTool(fn, config, gthDevType) {
     const toolInstance = tool(fn, config);
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -90,6 +102,25 @@ const RunSingleTestArgsSchema = z.object({
 });
 const RunShellCommandArgsSchema = z.object({
     command: z.string().describe('The shell command to run'),
+    /**
+     * [[EXT-29]] (spec §5.1, §7) — **the move §7 already promises the model and it could not make.**
+     * The rejection message names *"call the same command with a justification"* among the moves
+     * available after a refusal; without an argument to carry one, the only way to act on that was to
+     * re-send the identical call, which is what makes an agent repeat itself and burn §5.3's cap
+     * without producing information.
+     *
+     * It reaches the rater as fenced, untrusted data, weighed asymmetrically (§5.1): a justification
+     * may only ever make an outcome LESS severe, and a stated intent that does not match what the
+     * command does is grounds for rejection rather than for a discount. Never sent for its own sake —
+     * an unprompted one is noise the rater still has to read.
+     */
+    justification: z
+        .string()
+        .optional()
+        .describe('Optional. Why this command is the right one, in a sentence or two — supply it when ' +
+        'RE-CALLING a command that was rejected, so the reviewer can weigh what you are trying ' +
+        'to do. Address the objection you were given rather than restating the request; a ' +
+        'justification that does not match what the command actually does is rejected outright.'),
 });
 const TEST_PATH_PLACEHOLDER = '${testPath}';
 export default class GthDevToolkit extends BaseToolkit {
@@ -177,21 +208,39 @@ export default class GthDevToolkit extends BaseToolkit {
      *  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).
+     *     spawn — fires even when confirmation is bypassed by approvals.mode: bypass).
      *
-     * Resolves with a model-facing string. Timeouts resolve (not reject) so the
-     * model sees the killed-after-N message and can continue.
+     * 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. GS2-36: spawn-level
+     * failures (`child.on('error')` — missing shell binary, a non-existent cwd, EMFILE, …) ALSO reject
+     * with a {@link ShellCommandFailedError} (exitCode null) so the same softeners convert them into a
+     * recoverable error `ToolMessage`; previously they rejected a plain `Error` that neither softener
+     * recognised, so a spawn failure aborted the whole run.
      */
-    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.
+    async executeCommand(command, toolName, toolCallId) {
+        // TUI-C17: the "Executing" notice + live child output go through the tool-output channel.
+        // With no subscriber (every non-TUI surface) the channel's default sink reproduces the
+        // historical behaviour exactly (displayInfo notice, raw stdout chunks); under the Ink TUI
+        // the session subscribes and folds them into the managed frame instead.
+        emitToolOutput({
+            toolCallId,
+            toolName,
+            kind: 'notice',
+            text: `🔧 Executing ${toolName}: ${command}`,
+        });
+        // (4) Hardline blocklist — checked here so it fires regardless of the approval mode,
+        // allow-lists, or any confirmation path. Refuse WITHOUT executing. The approvals gate consults
+        // the SAME floor before it rates or prompts ([[EXT-29]] §4.2), so a matching command normally
+        // never reaches this line; this call is the guarantee that holds when nothing gated it at all.
         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}`);
+            const refusal = buildHardlineRefusal(command, hardline);
+            // TUI-C31 (a): route through the tool-output channel so the refusal lands in the managed
+            // frame under the TUI (headless still gets displayWarning via the default sink, verbatim).
+            emitToolOutput({ toolCallId, toolName, kind: 'warning', text: `\n⛔ ${refusal}` });
             return refusal;
         }
         const timeoutMs = getShellTimeoutMs(this.commands);
@@ -199,6 +248,14 @@ export default class GthDevToolkit extends BaseToolkit {
         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
@@ -229,14 +286,14 @@ export default class GthDevToolkit extends BaseToolkit {
             if (child.stdout) {
                 child.stdout.on('data', (data) => {
                     const chunk = data.toString();
-                    stdout.write(chunk);
+                    emitToolOutput({ toolCallId, toolName, kind: 'output', text: chunk });
                     buffer.append(chunk);
                 });
             }
             if (child.stderr) {
                 child.stderr.on('data', (data) => {
                     const chunk = data.toString();
-                    stdout.write(chunk);
+                    emitToolOutput({ toolCallId, toolName, kind: 'output', text: chunk });
                     buffer.append(chunk);
                 });
             }
@@ -251,16 +308,31 @@ export default class GthDevToolkit extends BaseToolkit {
                     captured.text +
                     `</COMMAND_OUTPUT>\n`;
                 if (timedOut) {
-                    resolve(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.`);
+                    // 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(body + `\n\nCommand '${command}' completed successfully`);
                 }
                 else {
-                    resolve(body + `\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) => {
@@ -268,17 +340,31 @@ export default class GthDevToolkit extends BaseToolkit {
                     return;
                 settled = true;
                 clearTimers();
-                const errorMsg = `Failed to execute command '${command}': ${error.message}`;
-                displayError(errorMsg);
-                reject(new Error(errorMsg));
+                // GS2-36: a spawn-level failure used to reject a plain Error, which neither the lean
+                // (GthLeanShellExitSoftening) nor the deep (GthDeepShellExitSoftening) softener recognises —
+                // so it propagated to GthAgentRunner as a fatal `Stream processing failed` and crashed the
+                // run. Reject a ShellCommandFailedError (exitCode null, like a timeout-kill) so BOTH softeners
+                // convert it into a recoverable status:'error' ToolMessage and the model can route around it.
+                // The message is phrased as an action-oriented recovery hint (EXT-34 hermes style).
+                const errorMsg = `Failed to start command '${command}': ${error.message}. ` +
+                    'Check that the command/executable exists and the working directory is valid, then retry.';
+                // TUI-C31 (a): route through the tool-output channel so the spawn-error advisory lands in
+                // the managed frame under the TUI (headless still gets displayError via the default sink).
+                emitToolOutput({ toolCallId, toolName, kind: 'error', text: errorMsg });
+                reject(new ShellCommandFailedError({
+                    output: errorMsg,
+                    exitCode: null,
+                    command,
+                    toolName,
+                }));
             });
         });
     }
     createTools() {
         const tools = [];
         if (this.commands.run_tests) {
-            tools.push(createGthTool(async (_args) => {
-                return await this.executeCommand(this.commands.run_tests, 'run_tests');
+            tools.push(createGthTool(async (_args, config) => {
+                return await this.executeCommand(this.commands.run_tests, 'run_tests', config?.toolCall?.id);
             }, {
                 name: 'run_tests',
                 description: 'Execute the test suite for this project. Runs the configured test command and returns the output.' +
@@ -287,10 +373,10 @@ export default class GthDevToolkit extends BaseToolkit {
             }, 'execute'));
         }
         if (this.commands.run_single_test) {
-            tools.push(createGthTool(async (args) => {
+            tools.push(createGthTool(async (args, config) => {
                 const validatedPath = this.validateParameterValue(args.testPath, 'testPath');
                 const command = this.buildSingleTestCommand(validatedPath);
-                return await this.executeCommand(command, 'run_single_test');
+                return await this.executeCommand(command, 'run_single_test', config?.toolCall?.id);
             }, {
                 name: 'run_single_test',
                 description: 'Execute a single test file. Runs the configured test command with the specified test file path. ' +
@@ -300,8 +386,8 @@ export default class GthDevToolkit extends BaseToolkit {
             }, 'execute'));
         }
         if (this.commands.run_lint) {
-            tools.push(createGthTool(async (_args) => {
-                return await this.executeCommand(this.commands.run_lint, 'run_lint');
+            tools.push(createGthTool(async (_args, config) => {
+                return await this.executeCommand(this.commands.run_lint, 'run_lint', config?.toolCall?.id);
             }, {
                 name: 'run_lint',
                 description: 'Run the linter on the project code. Executes the configured lint command and returns any linting errors or warnings.' +
@@ -310,8 +396,8 @@ export default class GthDevToolkit extends BaseToolkit {
             }, 'execute'));
         }
         if (this.commands.run_build) {
-            tools.push(createGthTool(async (_args) => {
-                return await this.executeCommand(this.commands.run_build, 'run_build');
+            tools.push(createGthTool(async (_args, config) => {
+                return await this.executeCommand(this.commands.run_build, 'run_build', config?.toolCall?.id);
             }, {
                 name: 'run_build',
                 description: 'Build the project. Executes the configured build command and returns the build output.' +
@@ -324,8 +410,8 @@ export default class GthDevToolkit extends BaseToolkit {
         // 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');
+            tools.push(createGthTool(async (args, config) => {
+                return await this.executeCommand(args.command, 'run_shell_command', config?.toolCall?.id);
             }, {
                 name: 'run_shell_command',
                 description: 'Run an arbitrary shell command in the project working directory and return its ' +

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/GthFileSystemToolkit.d.ts

@@ -27,10 +27,73 @@ export default class GthFileSystemToolkit extends BaseToolkit {
     private searchFiles;
     private normalizeLineEndings;
     private createUnifiedDiff;
+    /**
+     * Count non-overlapping exact occurrences of `search` in `content`.
+     * Uses an indexOf scan (no regex) so arbitrary text is matched literally.
+     */
+    private countOccurrences;
     private applyFileEdits;
     private formatSize;
     private tailFile;
     private headFile;
+    /**
+     * Returns the first `head` lines and the last `tail` lines of a file, separated by a
+     * `... [N lines skipped] ...` marker. When the two windows cover or overlap the whole
+     * file (`head + tail >= total`) the entire file is returned unchanged (no marker, no
+     * duplicated lines).
+     */
+    private headAndTailFile;
+    /**
+     * Return the file's lines from the 1-based `offset` to EOF (GS2-39 paging). Deliberately does
+     * NOT apply `limit` here — the caller hands the result to capReadContent with maxLines = limit so
+     * that a limit-bounded read is *observable* to the envelope (it can then tell "more file remains
+     * past this window" from "reached EOF" and emit the correct resume notice). Pre-slicing to
+     * exactly `limit` lines here would hide that signal and silently drop the continuation.
+     *
+     * Mirrors headAndTailFile's trailing-newline handling so line numbering matches head/tail/full
+     * reads: a terminating newline yields a phantom trailing empty element that must not be counted
+     * as a real line. Clamps rather than throwing: an offset past EOF returns a short recoverable note
+     * (not an empty string, which is indistinguishable from an empty file).
+     */
+    private windowFile;
+    /**
+     * Apply the read safety envelope (GS2-39) to already-selected file content:
+     *  - any single line longer than MAX_LINE_LENGTH is truncated with LINE_TRUNCATED_SUFFIX;
+     *  - emission stops once `maxLines` lines OR MAX_READ_BYTES bytes have been produced.
+     *
+     * When nothing exceeds the caps the content is returned verbatim (byte-identical), so normal
+     * files behave exactly as before — the change only bites on pathological / huge files.
+     *
+     * Three truncation signals are kept deliberately separate:
+     *  - a per-line cut is marked only by the inline LINE_TRUNCATED_SUFFIX (no global notice);
+     *  - the BYTE cap always appends the global "output truncated" notice, because it is the hard
+     *    safety envelope regardless of who asked for the read;
+     *  - the LINE cap appends the global notice only when `lineCapIsHard` is true — i.e. `maxLines`
+     *    is the hard MAX_READ_LINES envelope (a defaulted or clamped-down window, or the whole-file
+     *    read), NOT a deliberate small explicit `limit`. This distinguishes a *capped continuation*
+     *    (notify so the model can page) from a *satisfied explicit window* (stay quiet).
+     *
+     * `startLine` is the 1-based file line of the first line in `content`; it is used only to put a
+     * concrete resume `offset` in the global notice. Pass `undefined` (head/tail paths, where the
+     * first emitted line is not line `startLine` of the file) to emit a generic notice instead.
+     */
+    private capReadContent;
+    /**
+     * GS2-36 — turn a fatal tool throw into a recoverable, action-oriented errored result.
+     *
+     * A filesystem tool that throws (a denied/symlinked-out path from validatePath, a missing file,
+     * EISDIR, permission-denied, a directory-not-empty refusal, …) otherwise propagates to
+     * GthAgentRunner as a fatal `Stream processing failed` and crashes the whole turn. The house
+     * convention (AGENTS.md: a tool result must never abort a run; the write_file precedent in
+     * `5892801a`) is to return the failure to the model as a plain string it can act on. This wraps
+     * that string in a uniform `Error <action>: <message>` shape — the underlying fs/validation
+     * message (ENOENT / EISDIR / EACCES / "Access denied - …") is itself the actionable detail, and
+     * the deliberately-thrown logical messages (edit_file no-match/ambiguous, "Directory not empty",
+     * "Cannot delete protected directory") are already phrased as recovery hints. EXT-14 containment
+     * is preserved everywhere: validatePath runs first and throws on a symlink-out BEFORE any fs
+     * mutation, so the mutation never happens — the denial is merely surfaced as a result here.
+     */
+    private recoverableError;
     private createReadBinaryTool;
     private createTools;
 }