@gaunt-sloth/agent 2.0.0-alpha.4 → 2.0.0-alpha.40

package/dist/core/GthDeepAgent.js

@@ -1,604 +0,0 @@
-import { isShellToolEnabled } from '@gaunt-sloth/core/config.js';
-import { GthAbstractAgent } from '@gaunt-sloth/core/core/GthAbstractAgent.js';
-import { StatusLevel } from '@gaunt-sloth/core/core/types.js';
-import { debugLog, debugLogObject } from '@gaunt-sloth/core/utils/debugUtils.js';
-import { buildSystemMessages, formatToolCalls, readChatPrompt, readCodePrompt, readExecPrompt, } from '@gaunt-sloth/core/utils/llmUtils.js';
-import { getCurrentWorkDir } from '@gaunt-sloth/core/utils/systemUtils.js';
-import { AIMessage, ToolMessage } from '@langchain/core/messages';
-import { createMiddleware } from 'langchain';
-import { createDeepAgent, FilesystemBackend } from 'deepagents';
-import { buildPermissions, FILESYSTEM_TOOL_NAMES, } from '#src/core/deepAgentPermissions.js';
-import { ShellCommandFailedError } from '#src/tools/GthDevToolkit.js';
-/**
- * EXT-16: decide whether the deepagents filesystem backend must run in virtualMode.
- *
- * deepagents' permission layer (`validatePath`) requires POSIX `/`-rooted glob paths, and its
- * fs tools hand the SAME model-supplied path string to both the permission check and the native
- * `path.resolve`/`fs` backend. On Windows a real cwd is `D:\...`, which can satisfy neither side
- * as one string, so the EXT-13 real-path sandbox throws `Error: path must be absolute` on every
- * turn and the agent hangs. The precise trigger is "the real cwd is not POSIX-rooted", so we key
- * off that directly (not just `win32`): when true, run virtualMode (cwd→`/`) with virtual
- * permissions — the pre-EXT-13 known-good behavior. POSIX keeps the EXT-13 real-path namespace.
- */
-function shouldUseVirtualFs() {
-    return !getCurrentWorkDir().startsWith('/');
-}
-/**
- * Deep agent: builds a `createDeepAgent` graph (deepagents). All run/stream/event
- * plumbing lives in {@link GthAbstractAgent}; this class only knows how to construct
- * the graph in {@link init}.
- *
- * Differences from the lean {@link GthLangChainAgent}:
- * - deepagents provides the filesystem tools (`read_file`/`write_file`/`edit_file`/
- *   `ls`/`glob`/`grep`/`execute`) via its own middleware, backed by a
- *   {@link FilesystemBackend}. gsloth's `.aiignore` + `filesystem` config are mapped
- *   onto deepagents `permissions` (see {@link buildPermissions}). Any resolved tool
- *   that reuses a deepagents filesystem-tool name is therefore superseded and dropped
- *   (`createDeepAgent` would otherwise throw on the collision).
- * - todos / subagents / summarization come from deepagents' standard middleware.
- *
- * The transport-agnostic param assembly lives in {@link buildDeepAgentParams} so the ACP
- * entry (`deepagents-acp`) can reuse the exact same tool resolution, permission mapping and
- * middleware hardening without re-running `createDeepAgent` locally.
- */
-export class GthDeepAgent extends GthAbstractAgent {
-    /**
-     * Opt-in debug sink for the TUI `/debug` panel. Set AFTER {@link init} via
-     * `runner.getAgent()`; read lazily inside the `wrapModelCall` middleware so that when it
-     * is `undefined` (the normal path) the middleware is a transparent pass-through. Never
-     * touched by the lean agent or the AG-UI server, so those contracts are unchanged.
-     */
-    debugCapture;
-    async init(command, configIn, checkpointer) {
-        const params = await this.buildDeepAgentParams(command, configIn);
-        // Runner-path only: surface requested tool calls to the console. This is intentionally
-        // NOT part of buildDeepAgentParams — it writes via statusUpdate (stdout) and the ACP
-        // server renders tool calls itself over its own protocol channel.
-        const statusUpdate = this.statusUpdate;
-        const toolCallStatusMiddleware = createMiddleware({
-            name: 'GthMiddlewareToolCallStatusUpdate',
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            afterModel: (state) => {
-                debugLogObject('postModel state', state);
-                const lastMessage = state.messages[state.messages.length - 1];
-                if (AIMessage.isInstance(lastMessage) &&
-                    lastMessage.tool_calls &&
-                    lastMessage.tool_calls?.length > 0) {
-                    statusUpdate(StatusLevel.INFO, `\nRequested tools: ${formatToolCalls(lastMessage.tool_calls)}\n`);
-                }
-                return state;
-            },
-        });
-        // Debug-capture middleware (TUI `/debug` panel). Always installed but lazy: it reads
-        // `this.debugCapture` per call, so until the TUI attaches a sink it is a transparent
-        // pass-through (one extra await around the handler — the normal path pays nothing).
-        // `request.messages` is the real history at call time (post-summarization/middleware),
-        // and `handler(request)` resolves to the AIMessage response (decision (a): whole
-        // resolved message, not per-chunk — the streaming core stays untouched).
-        const getDebugCapture = () => this.debugCapture;
-        const debugCaptureMiddleware = createMiddleware({
-            name: 'GthMiddlewareDebugCapture',
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            wrapModelCall: async (request, handler) => {
-                const capture = getDebugCapture();
-                if (!capture)
-                    return handler(request);
-                try {
-                    capture.onRequest?.(request.messages, extractDebugRequestExtras(request));
-                }
-                catch {
-                    /* a debug sink must never break the run */
-                }
-                const response = await handler(request);
-                try {
-                    capture.onResponse?.(response);
-                }
-                catch {
-                    /* a debug sink must never break the run */
-                }
-                return response;
-            },
-        });
-        // EXT-16: whether the deepagents fs backend runs in virtualMode. deepagents' permission layer
-        // requires POSIX `/`-rooted paths, so a Windows real cwd (`D:\...`) can't be expressed as a
-        // permission glob and the EXT-13 real-path mode hangs there (`Error: path must be absolute`).
-        // When the real cwd isn't POSIX-rooted, fall back to virtualMode (cwd→`/`) with virtual
-        // permissions — the pre-EXT-13 known-good Windows behavior. Computed here because the EXT-22 S1
-        // middleware (below), the backend, and the systemPrompt gate (further down) all key off it.
-        const useVirtualFs = shouldUseVirtualFs();
-        // EXT-22 (S1): last-word path-namespace correction. Appends the shared guidance as a trailing
-        // system-message block ONLY in code + virtualMode (where the fs virtual `/` root and the
-        // shell's real-OS paths diverge); a transparent pass-through otherwise. Added LAST in the
-        // middleware array so, being the innermost wrapModelCall, its block lands AFTER deepagents'
-        // "All file paths must start with a /." line (see handoff/spike-systemmessage-ordering.md).
-        const pathNamespaceCorrectionMiddleware = createPathNamespaceCorrectionMiddleware(this.command === 'code' && useVirtualFs);
-        const middleware = [
-            ...params.middleware,
-            toolCallStatusMiddleware,
-            debugCaptureMiddleware,
-            pathNamespaceCorrectionMiddleware,
-        ];
-        this.statusUpdate(StatusLevel.INFO, `Loaded middleware: ${middleware.map((m) => m.name).join(', ')}`);
-        // EXT-13: the backend always runs in REAL-path mode (virtualMode off) so the deepagents fs
-        // tools and the EXT-9 run_shell_command tool share ONE path namespace — real absolute paths
-        // rooted at cwd. Containment is enforced entirely by the permission allow/deny globs built in
-        // buildDeepAgentParams (default: allow cwd/**, deny /**), which match what virtualMode used to
-        // give for free (see deepAgentPermissions + the EXT-13 symlink/`..` parity tests).
-        // `--allow-dir` (config.allowDirs) further widens those allow-rules to reach extra real dirs;
-        // it removes a guardrail, so it is announced loudly by the exec command and surfaced here.
-        const allowDirs = this.config?.allowDirs;
-        const widenFs = Array.isArray(allowDirs) && allowDirs.length > 0;
-        if (widenFs) {
-            this.statusUpdate(StatusLevel.WARNING, `Filesystem sandbox widened beyond cwd (--allow-dir): ${allowDirs.join(', ')}` +
-                (useVirtualFs
-                    ? ' — note: on this platform the sandbox runs in virtual mode, so widening beyond cwd is not applied.'
-                    : ''));
-        }
-        const backend = new FilesystemBackend({
-            rootDir: getCurrentWorkDir(),
-            virtualMode: useVirtualFs,
-        });
-        // EXT-13 (part b): on the local-runner code path the model used to be told nothing about
-        // where it is, so it assumed `/` was cwd and fed `/`-rooted paths to the real-fs shell. Now
-        // the backend uses real absolute paths (above), so inject the dynamic real cwd + path model
-        // into the prompt the model actually receives. Code mode only — the surface with full fs +
-        // shell access; the ACP transport keeps virtualMode and re-roots per session, so this
-        // real-path note must NOT leak there (which is why it lives in init(), not the
-        // transport-agnostic buildDeepAgentParams).
-        // In virtualMode (EXT-16, Windows) the real-cwd note must NOT be injected — it would mislabel
-        // the namespace (the fs tools' `/` is the virtual root, not the real cwd). Instead, EXT-22 (S2)
-        // injects the virtualMode path-namespace note so the model is told EARLY that the fs virtual
-        // `/` root and run_shell_command's real-OS paths differ (the S1 middleware repeats it as the
-        // authoritative last word after deepagents' `/`-rooted line). Non-code paths get neither.
-        const systemPrompt = this.command === 'code'
-            ? useVirtualFs
-                ? appendVirtualCwdNote(params.systemPrompt)
-                : appendCwdNote(params.systemPrompt, getCurrentWorkDir())
-            : params.systemPrompt;
-        this.agent = createDeepAgent({
-            model: params.model,
-            tools: params.tools,
-            // gsloth's composed prompt, combined ADDITIVELY by deepagents with its base + fs prompts
-            // into a single system message (avoids the two-system-message Anthropic rejection).
-            systemPrompt,
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            middleware: middleware,
-            backend,
-            permissions: params.permissions,
-            // Per-tool human-in-the-loop gating (e.g. run_shell_command confirmation). When set,
-            // deepagents installs humanInTheLoopMiddleware so a matching tool call suspends the graph
-            // for approval; `undefined` (the default, and under yolo) leaves every tool ungated.
-            interruptOn: params.interruptOn,
-            checkpointer,
-        });
-        debugLog('Deep agent created successfully');
-    }
-    /**
-     * Assemble the transport-agnostic {@link GthDeepAgentParams}: resolve tools (with the
-     * filesystem disabled so deepagents owns fs access), apply the allowedTools allow-list and
-     * the deepagents fs-name supersession safety-net, map `.aiignore` + filesystem mode onto
-     * deepagents permissions, and build the fs-denial-softening middleware. Shared by the local
-     * runner ({@link init}) and the `deepagents-acp` ACP entry.
-     */
-    async buildDeepAgentParams(command, configIn) {
-        this.command = command;
-        debugLog(`GthDeepAgent.buildDeepAgentParams called with command: ${command || 'default'}`);
-        // Merge command-specific filesystem config if provided
-        this.config = this.getEffectiveConfig(configIn, command);
-        debugLogObject('Effective Config', {
-            filesystem: this.config.filesystem,
-            builtInTools: this.config.builtInTools,
-            streamOutput: this.config.streamOutput,
-            debugLog: this.config.debugLog,
-        });
-        this.statusUpdate(StatusLevel.INFO, `Workdir: ${getCurrentWorkDir()}`);
-        if (this.config.modelDisplayName) {
-            this.statusUpdate(StatusLevel.INFO, `Model: ${this.config.modelDisplayName}`);
-        }
-        // An empty allowedTools allow-list disables every tool. Skip resolution entirely so we
-        // don't contact MCP servers (and trigger OAuth) just to discard the result.
-        const allowedTools = this.config.allowedTools;
-        const toolsDisabled = Array.isArray(allowedTools) && allowedTools.length === 0;
-        if (toolsDisabled) {
-            this.statusUpdate(StatusLevel.INFO, 'Tool loading disabled by allowedTools: []; MCP/A2A servers will not be contacted. Omit allowedTools for no filtering.');
-        }
-        // Resolve tools with filesystem access disabled. deepagents OWNS the filesystem
-        // (its fs middleware + the `permissions` built below); gsloth's filesystem toolkit
-        // must NOT be loaded here, because its non-colliding tools (read_multiple_files,
-        // delete_file, search_files, …) would otherwise bypass deepagents' permission
-        // enforcement entirely — a model could read an .aiignore-protected file through them.
-        debugLog('Resolving tools (filesystem disabled; deepagents provides fs)...');
-        const toolResolutionConfig = { ...this.config, filesystem: 'none' };
-        const resolvedTools = !toolsDisabled && this.resolvers?.resolveTools
-            ? await this.resolvers.resolveTools(toolResolutionConfig, command)
-            : [];
-        debugLog(`Resolved tools loaded: ${resolvedTools.length}`);
-        // Get user config tools (toolkit-flattened; client tools get interrupt() stubs)
-        const flattenedConfigTools = toolsDisabled
-            ? []
-            : this.extractAndFlattenTools(this.config.tools || []);
-        debugLog(`User config tools loaded: ${flattenedConfigTools.length}`);
-        // Combine all tools, then apply the allowedTools name allow-list when configured.
-        let tools = [...resolvedTools, ...flattenedConfigTools];
-        if (Array.isArray(allowedTools)) {
-            const allowed = new Set(allowedTools);
-            tools = tools.filter((tool) => !tool.name || allowed.has(tool.name));
-        }
-        // Safety net: a custom/dev/MCP tool may still reuse a deepagents filesystem-tool
-        // name (createDeepAgent throws on such a collision). Drop the colliding tool — the
-        // deep agent's built-in fs tool wins. With filesystem disabled above this is normally
-        // empty; it only fires for a genuine user/MCP name clash.
-        const reserved = new Set(FILESYSTEM_TOOL_NAMES);
-        const superseded = tools.filter((tool) => tool.name && reserved.has(tool.name));
-        const passThroughTools = tools.filter((tool) => !tool.name || !reserved.has(tool.name));
-        if (superseded.length > 0) {
-            const names = superseded.map((tool) => tool.name).join(', ');
-            this.statusUpdate(StatusLevel.WARNING, `Dropping tool(s) that collide with deepagents built-in filesystem tools: ${names}`);
-        }
-        if (passThroughTools.length > 0) {
-            const toolNames = passThroughTools
-                .map((tool) => tool.name)
-                .filter((name) => name)
-                .join(', ');
-            this.statusUpdate(StatusLevel.INFO, `Loaded tools: ${toolNames}`);
-            debugLog(`Total tools available: ${passThroughTools.length}`);
-            debugLogObject('All Tools', toolNames.split(', '));
-        }
-        debugLog('Creating deep agent...');
-        // Resolve middleware via resolver or fall back to empty. These are applied AFTER
-        // deepagents' standard middleware (todos, subagents, summarization, filesystem).
-        const resolvedMiddleware = this.resolvers?.resolveMiddleware
-            ? await this.resolvers.resolveMiddleware(
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            this.config.middleware, this.config)
-            : [];
-        // deepagents' standard middleware already summarizes long conversations; drop any
-        // gsloth-configured summarization middleware so the deep agent doesn't summarize twice.
-        const configuredMiddleware = resolvedMiddleware.filter((m) => {
-            const name = m.name ?? '';
-            if (/summar/i.test(name)) {
-                debugLog(`Dropping duplicate summarization middleware '${name}' (deepagents provides it)`);
-                return false;
-            }
-            return true;
-        });
-        // Soften deepagents' fail-hard filesystem tool throws. By default the permission layer
-        // THROWS on both a denied read/write AND on a malformed path the model supplied — a relative
-        // path, a `..`/`~` segment, or an empty string (deepagents' validatePath, run BEFORE the
-        // permission check in enforcePermission). Any of these aborts the WHOLE run. On the AG-UI
-        // transport that throw propagates out of streamWithEvents into the run handler's catch, which
-        // emits RUN_ERROR and ends the response WITHOUT a terminal RUN_FINISHED — and since AG-UI's
-        // protocol makes RUN_ERROR terminal ("no further events can be sent"), a consumer waiting for
-        // RUN_FINISHED hangs (EXT-24). Wrap tool calls so each of these becomes a recoverable error
-        // ToolMessage instead, letting the model observe the mistake, retry with a good path, and
-        // finish the run normally (reaching RUN_FINISHED). This preserves gsloth's recoverable-denial
-        // UX (the old GthFileSystemToolkit returned a message rather than throwing). Only these known
-        // fs path/permission messages are caught; every other throw (GraphInterrupt from a client-tool
-        // interrupt stub, AbortError on client disconnect, unexpected errors) is rethrown untouched so
-        // control-flow and genuine failures still surface.
-        const fsDenialSoftening = createMiddleware({
-            name: 'GthDeepFsDenialSoftening',
-            wrapToolCall: async (request, handler) => {
-                try {
-                    return await handler(request);
-                }
-                catch (e) {
-                    const message = e instanceof Error ? e.message : String(e);
-                    // deepagents fs enforcement throws (middleware/fs.ts enforcePermission +
-                    // permissions/enforce.ts validatePath): a permission denial, or a path that is
-                    // relative / contains ".." or "~" / is empty. All are recoverable model-input errors.
-                    if (/permission denied for (read|write)|path must (be absolute|not contain|be a non-empty string)/i.test(message)) {
-                        debugLog(`Softened fs tool throw into a ToolMessage: ${message}`);
-                        return new ToolMessage({
-                            content: message,
-                            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                            tool_call_id: request.toolCall?.id ?? '',
-                            status: 'error',
-                        });
-                    }
-                    throw e;
-                }
-            },
-        });
-        // EXT-20: sibling of fsDenialSoftening for the run_* (dev/shell) tools. GthDevToolkit's
-        // executeCommand now THROWS a ShellCommandFailedError on a non-zero exit or a timeout-kill
-        // (instead of resolving with the failure text), so the tool result no longer misreports
-        // status:'success' (✓). Catch it here and return an error ToolMessage that PRESERVES the full
-        // stdout/stderr body — the model's observation is unchanged except that status flips to
-        // 'error', which drives the ✗ (isError) glyph (GthAbstractAgent maps status==='error' →
-        // isError). Returning a ToolMessage (rather than rethrowing) also means the approved-then-failed
-        // command does NOT trigger a retry loop — it is a normal, observed tool result.
-        const shellExitSoftening = createMiddleware({
-            name: 'GthDeepShellExitSoftening',
-            wrapToolCall: async (request, handler) => {
-                try {
-                    return await handler(request);
-                }
-                catch (e) {
-                    if (e instanceof ShellCommandFailedError) {
-                        debugLog(`Softened shell/dev command failure (exit ${e.exitCode ?? 'timeout'}) into an ` +
-                            `error ToolMessage for '${e.command}'`);
-                        return new ToolMessage({
-                            content: e.output,
-                            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                            tool_call_id: request.toolCall?.id ?? '',
-                            status: 'error',
-                        });
-                    }
-                    throw e;
-                }
-            },
-        });
-        // fsDenialSoftening first so it is the outermost wrapToolCall — it must see the throw from
-        // deepagents' permission-enforcing fs tools. shellExitSoftening sits right after it (still
-        // outboard of any user-configured middleware, so it always sees the raw ShellCommandFailedError
-        // throw before a user wrapToolCall could transform it). Order between the two softeners is not
-        // load-bearing: they catch DISJOINT conditions (a permission-denied regex vs an
-        // `instanceof ShellCommandFailedError`) and each rethrows what it doesn't recognize, so neither
-        // can swallow the other. The console-bound tool-call-status middleware is NOT added here (see
-        // GthDeepAgentParams.middleware); the runner appends it.
-        const middleware = [fsDenialSoftening, shellExitSoftening, ...configuredMiddleware];
-        // Map gsloth's .aiignore + filesystem mode onto deepagents permission rules. When
-        // `--allow-dir` widens the sandbox, the backend runs without virtualMode, so paths are REAL
-        // absolute paths: constrain read+write to cwd + the allowed dirs (everything else denied),
-        // layered under the .aiignore deny rules.
-        const permissions = buildPermissions({
-            filesystem: this.config.filesystem,
-            aiignore: this.config.aiignore,
-            allowDirs: Array.isArray(this.config.allowDirs) && this.config.allowDirs.length > 0
-                ? this.config.allowDirs
-                : undefined,
-        }, 
-        // EXT-16: build virtual (`/`-rooted) permission rules when the backend will run in
-        // virtualMode (Windows), matching the FilesystemBackend created in init().
-        shouldUseVirtualFs());
-        debugLogObject('Filesystem permissions', permissions);
-        // Compose gsloth's system prompt (backstory + guidelines + per-command mode prompt +
-        // system prompt) so identity profiles (Gaunt Sloth, sorcerer, fisher-alt, …) and
-        // `.gsloth.*.md` are honored. This is passed to createDeepAgent as `systemPrompt` — combined
-        // additively with deepagents' base + fs prompts into ONE system message — rather than injected
-        // as a separate SystemMessage per turn (which produced a non-first system message that
-        // Anthropic rejects). 'code' uses the code-mode prompt; 'exec' uses the prompt-as-script
-        // exec-mode prompt; chat/api/others use the chat prompt.
-        const modePrompt = this.command === 'code'
-            ? readCodePrompt(this.config)
-            : this.command === 'exec'
-                ? readExecPrompt(this.config)
-                : readChatPrompt(this.config);
-        const systemMessages = buildSystemMessages(this.config, modePrompt);
-        const systemPrompt = typeof systemMessages[0]?.content === 'string' ? systemMessages[0].content : undefined;
-        // Gate the opt-in run_shell_command tool behind a per-command approval interrupt. The tool
-        // is only emitted (by GthDevToolkit, via builtInToolsConfig) when its devTools.shell flag is
-        // set; mirror the same per-command devTools resolution here so the interrupt is wired only
-        // when the tool actually exists. yolo (shellYolo) opts OUT of the confirmation: leave
-        // interruptOn undefined so the tool runs without suspending.
-        const devTools = this.getEffectiveDevToolsConfig();
-        // EXT-12 — pass the active command so the absent-config default (shell ON in `code`)
-        // is applied consistently with where the tool is actually emitted (GthDevToolkit).
-        const shellEnabled = isShellToolEnabled(devTools, this.command);
-        const interruptOn = shellEnabled && devTools?.shellYolo !== true
-            ? { run_shell_command: { allowedDecisions: ['approve', 'reject'] } }
-            : undefined;
-        if (interruptOn) {
-            this.statusUpdate(StatusLevel.INFO, 'Shell tool (run_shell_command) enabled with per-command approval (interruptOn).');
-        }
-        else if (shellEnabled) {
-            this.statusUpdate(StatusLevel.WARNING, 'Shell tool (run_shell_command) enabled in YOLO mode: commands run WITHOUT confirmation.');
-        }
-        return {
-            model: this.config.llm,
-            tools: passThroughTools,
-            permissions,
-            middleware,
-            systemPrompt,
-            interruptOn,
-        };
-    }
-    /**
-     * Resolve the {@link GthDevToolsConfig} that applies to the active command, mirroring the
-     * per-command selection in `builtInToolsConfig.getDefaultTools` (which is what actually emits
-     * the dev tools): `exec` → `commands.exec.devTools`, `ask --write` → `commands.ask.devTools`,
-     * otherwise (`code`) → `commands.code.devTools`. Returns `undefined` for any other command,
-     * matching the toolkit being inert there. Kept private and side-effect-free so the interrupt
-     * wiring above and the tool emission stay in lockstep.
-     */
-    getEffectiveDevToolsConfig() {
-        const config = this.config;
-        if (!config)
-            return undefined;
-        const command = this.command;
-        const askWrite = command === 'ask' && config.askWriteMode === true;
-        if (command === 'exec')
-            return config.commands?.exec?.devTools;
-        if (askWrite)
-            return config.commands?.ask?.devTools;
-        if (command === 'code')
-            return config.commands?.code?.devTools;
-        return undefined;
-    }
-}
-/**
- * EXT-22: shared virtualMode path-namespace guidance — ONE source of truth used by BOTH the S2
- * early-framing note ({@link appendVirtualCwdNote}, injected into gsloth's composed systemPrompt =
- * block 0) and the S1 last-word correction middleware
- * ({@link createPathNamespaceCorrectionMiddleware}, appended after deepagents' `/`-rooted line).
- *
- * In a virtualMode `code` session (EXT-16, e.g. Windows) the deepagents filesystem tools use a
- * VIRTUAL `/` root (= the working dir) while `run_shell_command` uses REAL native OS paths; the
- * model conflates the two forms. This text draws the distinction and steers toward cwd-relative
- * paths (the one form both tool families read alike).
- *
- * It deliberately does NOT equate the virtual root with a specific real path (no "`/` = D:\\work"):
- * virtualMode withholds the real cwd on purpose (see the systemPrompt gate in {@link
- * GthDeepAgent.init}), so the guidance is about the DISTINCTION between the two namespaces and the
- * safety of relative paths, not a mapping between them.
- */
-export const PATH_NAMESPACE_GUIDANCE = 'The filesystem tools (ls, read_file, write_file, edit_file, glob, grep) use a VIRTUAL root in ' +
-    'this session: a leading `/` means your working directory, and their paths are written ' +
-    '`/`-rooted relative to it (this is what "all file paths must start with a /" refers to). That ' +
-    '`/` is NOT the real operating-system filesystem root. run_shell_command is different: it runs ' +
-    'in the real operating system and uses real native paths (on Windows, e.g. ' +
-    '`C:\\Users\\...\\project`, with backslashes), never the virtual `/` root. A `/`-rooted path ' +
-    'from the filesystem tools is NOT a valid shell path and must never be passed to ' +
-    'run_shell_command. The one form that means the same thing to both tool families is a path ' +
-    'RELATIVE to the working directory (e.g. `src/index.ts`); prefer relative paths for both. When ' +
-    'you must be absolute, use `/`-rooted form ONLY for the filesystem tools and real native form ' +
-    'ONLY for run_shell_command.';
-/**
- * EXT-22 (S2): virtualMode variant of {@link appendCwdNote}. On the `code` path when the fs
- * backend runs in virtualMode (EXT-16), inject the shared path-namespace guidance EARLY in
- * gsloth's composed systemPrompt (block 0) so the model is framed before deepagents' own prompt.
- *
- * This is early framing only: deepagents' hardcoded `/`-rooted line lands in a LATER block and can
- * partially override block 0, so the authoritative last word is delivered by the S1 middleware
- * ({@link createPathNamespaceCorrectionMiddleware}); see handoff/spike-systemmessage-ordering.md.
- * Returns the note alone when there is no base prompt.
- */
-export function appendVirtualCwdNote(systemPrompt) {
-    const note = `Filesystem vs shell path namespaces: ${PATH_NAMESPACE_GUIDANCE}`;
-    return systemPrompt ? `${systemPrompt}\n\n${note}` : note;
-}
-/**
- * EXT-22 (S1): the load-bearing path-namespace correction. A gsloth `wrapModelCall` middleware
- * runs INNERMOST (inside deepagents' filesystem middleware), so appending a trailing block to
- * `request.systemMessage` lands AFTER deepagents' hardcoded "All file paths must start with a /."
- * line — giving gsloth the last word on path semantics (empirically verified; see
- * handoff/spike-systemmessage-ordering.md). It APPENDS via `request.systemMessage.concat(...)`
- * (mirroring how deepagents appends its own fs prompt), never string-splices, and returns a NEW
- * request so it never mutates persisted state (no compounding across turns).
- *
- * `appendCorrection` gates it to `code` + virtualMode: only there do the fs virtual `/` root and
- * the shell's real-OS paths diverge. On POSIX real-path mode deepagents' "start with /" is
- * literally true, so the middleware is a transparent pass-through (like the debug-capture
- * middleware when no sink is attached).
- */
-export function createPathNamespaceCorrectionMiddleware(appendCorrection) {
-    return createMiddleware({
-        name: 'GthDeepPathNamespaceCorrection',
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        wrapModelCall: async (request, handler) => {
-            if (!appendCorrection || !request?.systemMessage)
-                return handler(request);
-            const correction = 'IMPORTANT — path namespaces (authoritative; this overrides any earlier instruction that ' +
-                `implies every path is a simple \`/\`-rooted filesystem path): ${PATH_NAMESPACE_GUIDANCE}`;
-            return handler({ ...request, systemMessage: request.systemMessage.concat(correction) });
-        },
-    });
-}
-/**
- * EXT-13 (part b): append a real-cwd / path-model note to the composed code-mode system prompt.
- *
- * The default code-mode backend runs in REAL-path mode (no virtualMode), so the deepagents fs
- * tools and `run_shell_command` share one real-absolute-path namespace rooted at `cwd`. Neither
- * deepagents' base prompt nor `.gsloth.code.md` states the actual cwd, so without this the model
- * assumes `/` is cwd and hands `/`-rooted paths to the real-fs shell. The cwd is injected
- * dynamically (never baked into the .md). Returns the note alone when there is no base prompt.
- */
-export function appendCwdNote(systemPrompt, cwd) {
-    const cwdNote = `Working directory: ${cwd}\n` +
-        'Paths are real absolute filesystem paths (there is no virtual root). The working directory ' +
-        'above is where this session runs; relative paths resolve against it, and both the filesystem ' +
-        'tools (ls/glob/read_file/write_file/edit_file/grep) and run_shell_command operate on these ' +
-        'same real paths. Check the current directory before filesystem operations and prefer absolute ' +
-        'paths (or paths relative to the working directory); do not assume the current directory is "/".';
-    return systemPrompt ? `${systemPrompt}\n\n${cwdNote}` : cwdNote;
-}
-/**
- * Scalar model-param fields worth surfacing in the `/debug` panel. Deliberately an
- * allowlist (NOT a whole-object dump) so no credential field (`apiKey`, `accessToken`, …)
- * can ever leak into the rendered debug view.
- *
- * `streaming` is intentionally NOT here: it is the model instance's static flag, which is
- * usually `false` even when the turn streams — the GthAgentRunner decides streaming by calling
- * `.stream()` vs `.invoke()`, not by this property — so surfacing it just misleads.
- */
-const DEBUG_MODEL_PARAM_KEYS = [
-    'model',
-    'modelName',
-    'modelId',
-    'deploymentName',
-    'temperature',
-    'topP',
-    'topK',
-    'maxTokens',
-    'maxOutputTokens',
-    'maxReasoningTokens',
-    'reasoningEffort',
-    'thinkingBudget',
-    'stop',
-    'provider',
-];
-/** Pull the key-free scalar model params from the (provider-specific) model instance. */
-function extractModelParams(model) {
-    if (!model || typeof model !== 'object')
-        return undefined;
-    const src = model;
-    const out = {};
-    for (const key of DEBUG_MODEL_PARAM_KEYS) {
-        const value = src[key];
-        if (value === undefined || value === null)
-            continue;
-        // Only scalars / scalar arrays — never nested objects that could carry credentials.
-        if (typeof value === 'object' && !Array.isArray(value))
-            continue;
-        out[key] = value;
-    }
-    // `model` / `modelName` / `modelId` are langchain aliases for the same value; collapse the
-    // duplicates so the panel shows the model id once instead of two identical lines.
-    if (typeof out.model !== 'string' && typeof out.modelName === 'string') {
-        out.model = out.modelName;
-    }
-    if (out.modelName === out.model)
-        delete out.modelName;
-    if (out.modelId === out.model)
-        delete out.modelId;
-    return Object.keys(out).length > 0 ? out : undefined;
-}
-/** Best-effort tool definition (name + description + schema) for the debug view. */
-function extractToolDefs(tools) {
-    if (!Array.isArray(tools) || tools.length === 0)
-        return undefined;
-    const defs = [];
-    for (const tool of tools) {
-        if (!tool || typeof tool !== 'object')
-            continue;
-        const t = tool;
-        const name = typeof t.name === 'string' ? t.name : undefined;
-        if (!name)
-            continue;
-        const description = typeof t.description === 'string' ? t.description : undefined;
-        // LangChain StructuredTools expose a Zod/JSON `schema`; some carry it on `lc_kwargs`.
-        const schema = t.schema ?? undefined;
-        defs.push({ name, description, schema });
-    }
-    return defs.length > 0 ? defs : undefined;
-}
-/**
- * Assemble the non-message request parts ({@link DebugRequestExtras}) for the `/debug`
- * panel from a `wrapModelCall` request, defensively and key-free. Never throws (the caller
- * already guards, but a debug sink must never break a run) and never dumps the raw model.
- */
-export function extractDebugRequestExtras(request) {
-    if (!request || typeof request !== 'object')
-        return undefined;
-    const req = request;
-    const systemMessage = req.systemMessage;
-    const systemPrompt = typeof req.systemPrompt === 'string' && req.systemPrompt
-        ? req.systemPrompt
-        : typeof systemMessage?.content === 'string'
-            ? systemMessage.content
-            : undefined;
-    const extras = {
-        systemPrompt,
-        tools: extractToolDefs(req.tools),
-        modelParams: extractModelParams(req.model),
-        toolChoice: req.toolChoice,
-    };
-    // Return undefined when nothing useful was captured so the renderer can show a clear empty state.
-    const hasAny = extras.systemPrompt !== undefined ||
-        extras.tools !== undefined ||
-        extras.modelParams !== undefined ||
-        extras.toolChoice !== undefined;
-    return hasAny ? extras : undefined;
-}
-//# sourceMappingURL=GthDeepAgent.js.map

package/dist/core/GthDeepAgent.js.map

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