@gaunt-sloth/agent 2.0.0-alpha.22 → 2.0.0-alpha.24

package/dist/modules/slashCommands.js

@@ -0,0 +1,598 @@
+/**
+ * Pure, React-free slash-command layer shared by BOTH interactive surfaces (GS2-8): the Ink
+ * TUI (`packages/app/src/tui/`, which re-exports this module) and the readline `--no-tui`
+ * session (`interactiveSessionModule.ts` in this package). One registry, one source of truth —
+ * a command added here appears in `/help` on both surfaces automatically.
+ *
+ * Mirrors how the TUI's `viewModel.ts` keeps its fold logic out of the components: the registry
+ * and the parse/dispatch helpers here are unit-testable in isolation, and each surface is the
+ * only place that turns the resulting {@link SlashCommandResult} into its own state / side
+ * effects (the TUI's `<App>` clears the transcript / pushes notices / quits; the readline loop
+ * prints notices and degrades TUI-only effects with a clear "needs the TUI" message).
+ *
+ * The registry is a plain array so later layers (e.g. extension-registered commands, EXT-5)
+ * can append more entries via {@link createCommandRegistry} without this module changing.
+ */
+/**
+ * Build the compact, read-only `/config` summary (GS2-1): a handful of the most orienting
+ * resolved-config fields, one per line, with a pointer to `gth config print` for the full view.
+ * Pure and secret-free — it only reads non-sensitive scalar fields (never API keys / the live
+ * llm instance). Used by the App to fill {@link SlashCommandContext.configSummary}.
+ */
+export function formatConfigSummary(config) {
+    const fmt = (v) => typeof v === 'string' ? v : Array.isArray(v) ? JSON.stringify(v) : String(v);
+    const lines = [];
+    lines.push(`Model: ${config.modelDisplayName || 'unknown'}`);
+    lines.push(`Agent backend: ${config.agent?.backend ?? 'lean'}`);
+    if (config.filesystem !== undefined)
+        lines.push(`Filesystem: ${fmt(config.filesystem)}`);
+    if (config.streamOutput !== undefined)
+        lines.push(`Stream output: ${config.streamOutput}`);
+    if (config.useColour !== undefined)
+        lines.push(`Colour: ${config.useColour}`);
+    const commandNames = config.commands ? Object.keys(config.commands) : [];
+    if (commandNames.length > 0)
+        lines.push(`Commands configured: ${commandNames.join(', ')}`);
+    lines.push('Run `gth config print` for the full resolved config (secrets redacted).');
+    return lines;
+}
+/**
+ * The `/config` notice, from the pre-rendered summary lines (or an unavailable fallback).
+ *
+ * TUI-C19 — when config-validation `warnings` are present (unknown keys / deprecated names), they
+ * are rendered FIRST, as the details the standing "config has problems" advisory line points at,
+ * then a blank spacer, then the resolved summary. A clean config (no warnings) reads exactly as
+ * before. Tone flips to `warn` (yellow) while there are warnings so the block reads as caution.
+ */
+export function configNotice(summary, warnings) {
+    const summaryLines = summary && summary.length > 0
+        ? summary
+        : ['Configuration details are not available in this session.'];
+    const hasWarnings = !!warnings && warnings.length > 0;
+    const lines = hasWarnings
+        ? [
+            `${warnings.length === 1 ? 'Config warning' : `Config warnings (${warnings.length})`}:`,
+            ...warnings.map((w) => `  • ${w}`),
+            '',
+            ...summaryLines,
+        ]
+        : summaryLines;
+    return {
+        title: 'Resolved configuration',
+        lines,
+        ...(hasWarnings ? { tone: 'warn' } : {}),
+    };
+}
+/** Shared "history is unavailable" body (history off / DB missing), reused by all three commands. */
+const HISTORY_UNAVAILABLE_LINES = [
+    'No local session history is available in this session.',
+    'Enable it with `history.enabled: true` in your gsloth config (local only, opt-in).',
+];
+/** The `/history` notice (GS2-7): recent recorded sessions, or an "unavailable" fallback. */
+export function historyNotice(summary) {
+    return {
+        title: 'Recent sessions',
+        lines: summary && summary.length > 0 ? summary : HISTORY_UNAVAILABLE_LINES,
+    };
+}
+/** The `/insights` notice (GS2-7): local analytics summary, or an "unavailable" fallback. */
+export function insightsNotice(summary) {
+    return {
+        title: 'Session insights (local only)',
+        lines: summary && summary.length > 0 ? summary : HISTORY_UNAVAILABLE_LINES,
+    };
+}
+/**
+ * The `/search` notice (GS2-7). With no query it prints usage; otherwise it runs the injected
+ * fail-soft {@link SlashCommandContext.historySearch} provider and renders its result lines. When
+ * no provider is bound (no store), it reports history as unavailable.
+ */
+export function searchNotice(args, search) {
+    const query = args.join(' ').trim();
+    if (!query) {
+        return {
+            title: 'Search session history',
+            lines: ['Usage: /search <terms> — full-text search across your recorded sessions.'],
+        };
+    }
+    if (!search) {
+        return { title: `Search: "${query}"`, lines: HISTORY_UNAVAILABLE_LINES };
+    }
+    return { title: `Search: "${query}"`, lines: search(query) };
+}
+/**
+ * Parse a raw input line into a slash command, or `null` if it is not one. A line is a slash
+ * command iff its first non-whitespace character is `/` AND no further `/` appears after the
+ * leading one (GS2-8, Mari's dogfood addendum): a pasted filesystem path like
+ * `/usr/home/bob/test.md` contains later slashes, so it falls through as ordinary prompt text
+ * instead of being swallowed as an unknown command. The name is lower-cased; remaining
+ * whitespace-separated tokens are the args.
+ */
+export function parseSlashCommand(input) {
+    const trimmed = input.trim();
+    if (!trimmed.startsWith('/'))
+        return null;
+    // The `/`-vs-path heuristic: a real command has NO further `/` after the leading one.
+    if (trimmed.indexOf('/', 1) !== -1)
+        return null;
+    const tokens = trimmed.slice(1).split(/\s+/).filter(Boolean);
+    if (tokens.length === 0)
+        return null; // a bare "/" is not a command
+    const [name, ...args] = tokens;
+    return { name: name.toLowerCase(), args };
+}
+/**
+ * TUI-C10 — the discovery-menu trigger test. The Ink `<PromptInput>` shows the slash-command menu
+ * while the user is typing a bare command: the raw input is a menu query iff its first character is
+ * `/` and it contains no whitespace yet (once a space is typed the user is entering args, so the
+ * menu closes and normal dispatch takes over). Returns the lower-cased query AFTER the slash (so a
+ * bare `/` yields `''` = "show everything"), or `null` when the input is not a menu trigger.
+ *
+ * Kept pure and next to the registry (like {@link parseSlashCommand}) so the menu's show/hide and
+ * filter logic is unit-testable without React.
+ *
+ * GS2-8 — mirrors {@link parseSlashCommand}'s `/`-vs-path heuristic: input with a later `/`
+ * (a pasted path like `/usr/bin`) is not a command, so it never triggers the menu either.
+ */
+export function slashMenuQuery(input) {
+    if (!/^\/\S*$/.test(input))
+        return null;
+    if (input.indexOf('/', 1) !== -1)
+        return null; // later `/` ⇒ a path, not a command query
+    return input.slice(1).toLowerCase();
+}
+/**
+ * TUI-C10 — filter the registry down to the commands that match a menu query, most-relevant first.
+ * Prefix matches (the name starts with the query) rank above looser substring matches; within each
+ * bucket the registry's own order is preserved (so extension-registered commands — appended to the
+ * array — naturally sort after the built-ins). An empty query returns the whole registry, so a bare
+ * `/` lists every command including any the extensions added (never a hardcoded list).
+ *
+ * Pure: takes the registry the caller already built via {@link createCommandRegistry}, so the menu
+ * automatically reflects extension commands without this layer knowing they exist.
+ */
+export function filterSlashCommands(registry, query) {
+    const q = query.toLowerCase();
+    if (!q)
+        return [...registry];
+    const prefix = registry.filter((c) => c.name.startsWith(q));
+    const substring = registry.filter((c) => !c.name.startsWith(q) && c.name.includes(q));
+    return [...prefix, ...substring];
+}
+/**
+ * The notice for the tool-detail toggle, given the RESULTING (post-toggle) state. Shared by the
+ * `/verbose` command (GS2-8 rename of `/tools`) and the Ctrl+T key handler so the copy
+ * is single-sourced (TUI-C14).
+ */
+export function toolsToggleNotice(expanded) {
+    return expanded
+        ? {
+            title: 'Tool details: on',
+            lines: [
+                'Tool calls now show their full inputs and results in the chat history.',
+                'Applies to new turns — run /verbose again to collapse them to summaries.',
+            ],
+        }
+        : {
+            title: 'Tool details: off',
+            lines: [
+                'Tool calls now show as a single summary line in the chat history.',
+                'Applies to new turns — run /verbose again to show full inputs and results.',
+            ],
+        };
+}
+/**
+ * The notice for the debug-panel toggle, given the RESULTING (post-toggle) state. Shared so the
+ * command reports exactly the state the component will apply.
+ */
+export function debugToggleNotice(visible) {
+    return visible
+        ? {
+            title: 'Debug panel: shown',
+            lines: [
+                'Docked panel with the subagent tree and sent-to-model / raw-response views.',
+                'Run /debug again to hide it; Tab cycles its views.',
+            ],
+        }
+        : {
+            title: 'Debug panel: hidden',
+            lines: [
+                'The docked subagent + debug views are now closed.',
+                'Run /debug again to bring them back.',
+            ],
+        };
+}
+/**
+ * The notice for the `/auto-approve` toggle (EXT-12), given the RESULTING (post-apply) state.
+ * Shared so the command reports exactly the state the App applies. ON is rendered 'warn' (yellow)
+ * because it disables the approval gate for the session; OFF is 'info'.
+ */
+export function autoApproveNotice(on) {
+    return on
+        ? {
+            title: 'Auto-approve ON — shell commands run without asking',
+            lines: [
+                'run_shell_command will now execute WITHOUT the per-command approval prompt.',
+                'Session-scoped only (not saved); run /auto-approve off to require approvals.',
+                'The hardline safety floor still blocks catastrophic commands.',
+            ],
+            tone: 'warn',
+        }
+        : {
+            title: 'Auto-approve OFF — approvals required',
+            lines: [
+                'run_shell_command will prompt for approval again before each command.',
+                'Run /auto-approve (or /auto-approve on) to re-enable session-wide auto-approval.',
+            ],
+        };
+}
+/**
+ * EXT-12 — parse the `/auto-approve` argument: no arg (or `toggle`) flips; `on`/`off` (and the
+ * friendly synonyms `enable`/`disable`, `true`/`false`) set explicitly. Returns `null` for an
+ * unrecognized argument so the command can render a usage hint instead of guessing.
+ */
+export function parseAutoApproveArg(args) {
+    if (args.length === 0)
+        return 'toggle';
+    const arg = args[0].toLowerCase();
+    if (arg === 'toggle')
+        return 'toggle';
+    if (arg === 'on' || arg === 'enable' || arg === 'true')
+        return 'on';
+    if (arg === 'off' || arg === 'disable' || arg === 'false')
+        return 'off';
+    return null;
+}
+/**
+ * TUI-C18 — resolve a `/reasoning` invocation against the committed turns' reasoning (in transcript
+ * order, index 0 = turn 1). Pure, so the whole selection + friendly-notice logic is unit-testable
+ * without React:
+ *
+ * - **no arg** → the most recent turn that actually recorded thinking; if none exists, a friendly
+ *   info notice (nothing to show).
+ * - **`<n>`** → turn `n` (1-based). A non-positive / non-integer / out-of-range `n` → a warn notice;
+ *   a valid turn that recorded no thinking → an info notice. Otherwise a `reprintReasoning` request.
+ *
+ * The App renders a `reprintReasoning` result as a fresh reasoning block (reusing the TUI-C15
+ * styling) and a `notice` result via the shared `CommandNotice`.
+ */
+export function resolveReasoning(reasonings, args) {
+    const count = reasonings.length;
+    const has = (i) => (reasonings[i] ?? '').trim().length > 0;
+    if (args.length > 0) {
+        // `Number(...)` (not parseInt) so "2x"/"1.5"/"" don't silently coerce to a valid index.
+        const raw = args[0];
+        const n = Number(raw);
+        if (!Number.isInteger(n) || n < 1 || n > count) {
+            return {
+                notice: {
+                    title: `No turn ${raw}`,
+                    lines: count === 0
+                        ? [
+                            'This session has no committed turns yet.',
+                            'Ask something first, then run /reasoning.',
+                        ]
+                        : [
+                            `Pick a turn between 1 and ${count} (this session has ${count} so far).`,
+                            'Run /reasoning with no number for the most recent turn that recorded thinking.',
+                        ],
+                    tone: 'warn',
+                },
+            };
+        }
+        const idx = n - 1;
+        if (!has(idx)) {
+            return {
+                notice: {
+                    title: `Turn ${n} has no thinking`,
+                    lines: [
+                        `Turn ${n} didn't record a thinking layer (only some models stream one).`,
+                        'Run /reasoning (no number) to jump to the most recent turn that did.',
+                    ],
+                },
+            };
+        }
+        return { reprintReasoning: { reasoning: reasonings[idx], turnNumber: n } };
+    }
+    // No arg: walk back to the most recent turn that recorded thinking.
+    for (let i = count - 1; i >= 0; i--) {
+        if (has(i))
+            return { reprintReasoning: { reasoning: reasonings[i], turnNumber: i + 1 } };
+    }
+    return {
+        notice: {
+            title: 'No thinking to show',
+            lines: [
+                'No turn in this session has recorded a thinking layer yet.',
+                'Reasoning appears for models that stream a thinking / chain-of-thought layer.',
+            ],
+        },
+    };
+}
+/**
+ * `/debug-dump` when no `dumpDebugSession` writer is injected — the fixture agent, or the readline
+ * (`--no-tui`) session, which shares this registry (GS2-8) but has no session archive writer.
+ */
+const DEBUG_DUMP_UNAVAILABLE_LINES = [
+    'No debug-dump writer is available in this session.',
+    'This is only available in a real TUI session (not the fixture agent or the --no-tui fallback).',
+];
+/**
+ * GS2-47 — resolve whether the `/debug-dump` archive should be redacted. ON by default; opt out via
+ * the config (`debugDump.redact: false`) OR the `--unsafe-no-redact` command flag. Any uncertainty
+ * (no/non-object config) defaults to redacting — fail safe. `resolvedConfig` is opaque here, so this
+ * reads the flag structurally without depending on the `GthConfig` type.
+ */
+export function resolveDebugDumpRedact(resolvedConfig, args) {
+    if (args.some((a) => a === '--unsafe-no-redact' || a === '--no-redact'))
+        return false;
+    const debugDump = resolvedConfig?.debugDump;
+    if (debugDump &&
+        typeof debugDump === 'object' &&
+        debugDump.redact === false) {
+        return false;
+    }
+    return true;
+}
+/**
+ * The `/debug-dump` success notice (a standard 3-line CommandNotice — DL-1: no command reads as
+ * "does nothing"). GS2-47 flips the default to REDACTED: when redaction ran (the default) the note
+ * is softened ("secrets redacted; review before sharing") and points at the opt-out. When the user
+ * opted OUT (raw archive) it is the loud, impossible-to-miss UNSANITIZED warning. Colour follows
+ * DL-8 / the tone rule in maintenance/ux-guidelines.md: the safe, redacted default is normal
+ * feedback (no `tone` ⇒ info), while the raw opt-out is caution and so `tone: 'warn'` (yellow) —
+ * mirroring how `autoApproveNotice` reserves yellow for the dangerous (gate-off) state. Redaction is
+ * best-effort pattern-based, so even the softened note still says review-before-sharing.
+ */
+export function debugDumpNotice(archiveDir, redacted) {
+    if (redacted) {
+        return {
+            title: 'Debug dump written — secrets redacted',
+            lines: [
+                `Archive: ${archiveDir}`,
+                '',
+                'Secrets were redacted (API keys, tokens and auth headers replaced with <redacted>).',
+                'Redaction is best-effort and pattern-based — review before sharing.',
+                '',
+                'To write a raw, unredacted archive: set `debugDump.redact: false` in your gsloth config,',
+                'or run `/debug-dump --unsafe-no-redact`.',
+            ],
+        };
+    }
+    return {
+        title: '⚠️  Debug dump written — UNSANITIZED, review before sharing',
+        lines: [
+            `Archive: ${archiveDir}`,
+            '',
+            'This archive contains the full transcript, resolved config, env info, debug log and git',
+            'state AS-IS — it may include secrets: API keys, tokens, file contents, env vars.',
+            'Review it carefully before sending it anywhere.',
+        ],
+        tone: 'warn',
+    };
+}
+/**
+ * Build the default command registry. Returns a fresh array each call so callers may push
+ * extension commands onto it (EXT-5) without sharing mutable module state.
+ */
+export function createCommandRegistry() {
+    return [
+        {
+            name: 'help',
+            description: 'List available slash commands',
+            // The help body needs the whole registry, so dispatch special-cases `/help` and
+            // calls formatHelp; this stub keeps `/help` listed and self-described.
+            run: () => ({ message: 'Available commands (see /help).' }),
+        },
+        {
+            name: 'clear',
+            description: 'Clear the transcript',
+            // The visible feedback is the live-frame <ClearBanner> (rendered outside <Static> so it
+            // survives the transcript wipe), so no committed notice here.
+            run: () => ({ clearTranscript: true }),
+        },
+        {
+            name: 'debug',
+            description: 'Toggle the docked subagents + debug panel',
+            availableDuringRun: true,
+            // State-aware: report the notice for the state the toggle will land on (the inverse of now).
+            run: (ctx) => ({ toggleDebug: true, notice: debugToggleNotice(!ctx.debugVisible) }),
+        },
+        {
+            name: 'verbose',
+            description: 'Toggle tool-call detail (collapsed summary ⇄ expanded args/result)',
+            availableDuringRun: true,
+            // State-aware: report the notice for the state the toggle will land on (the inverse of now).
+            run: (ctx) => ({ toggleTools: true, notice: toolsToggleNotice(!ctx.toolsExpanded) }),
+        },
+        {
+            name: 'auto-approve',
+            description: 'Auto-approve shell commands this session (/auto-approve on|off; no arg toggles)',
+            // Available mid-turn so the user can stop being prompted for the run's remaining tool calls
+            // (EXT-12). The App owns the runner flag, so it applies the change and commits the notice for
+            // the landed state (the command can't read the flag here).
+            availableDuringRun: true,
+            run: (_ctx, args) => {
+                const action = parseAutoApproveArg(args);
+                if (action === null) {
+                    return {
+                        notice: {
+                            title: `Unknown option: ${args[0]}`,
+                            lines: [
+                                'Usage: /auto-approve [on|off] — with no argument it toggles.',
+                                'When ON, shell commands run this session without the per-command prompt.',
+                            ],
+                            tone: 'warn',
+                        },
+                    };
+                }
+                return { autoApprove: action };
+            },
+        },
+        {
+            name: 'yolo',
+            description: 'Alias for /auto-approve (toggles session-wide shell auto-approval)',
+            availableDuringRun: true,
+            // Back-compat alias: a bare toggle, routed through the same auto-approve apply path. EXT-12.
+            run: () => ({ autoApprove: 'toggle' }),
+        },
+        {
+            name: 'exit',
+            description: 'Quit the session',
+            run: () => ({ exit: true }),
+        },
+        {
+            name: 'quit',
+            description: 'Quit the session (alias of /exit)',
+            // GS2-8 — an equal-citizen alias, no deprecation: both names quit.
+            run: () => ({ exit: true }),
+        },
+        {
+            name: 'status',
+            description: 'Show session status (mode, model, turns)',
+            availableDuringRun: true,
+            // GS2-8 — absorbs the old `/mode` command: the mode line (and how to change it) now reads
+            // as part of one status block alongside the model and turn count already in context.
+            run: (ctx) => ({
+                notice: {
+                    title: 'Session status',
+                    lines: [
+                        `Mode: ${ctx.mode} — how the agent handles your messages this session.`,
+                        `Model: ${ctx.modelDisplayName || 'unknown'}`,
+                        `Turns so far: ${ctx.turnCount}`,
+                        'Restart with a different subcommand to change the mode (e.g. `gth chat`).',
+                    ],
+                },
+            }),
+        },
+        {
+            name: 'config',
+            description: 'Show the resolved configuration (read-only)',
+            availableDuringRun: true,
+            // Read-only discovery: surface the pre-rendered, secret-free summary the App computed from
+            // the resolved config, prefixed with any load-time validation warnings (TUI-C19 — the
+            // details the standing advisory line points at). Editing lives in `gth init` / the config
+            // file, not here (GS2-1).
+            run: (ctx) => ({ notice: configNotice(ctx.configSummary, ctx.configWarnings) }),
+        },
+        {
+            name: 'history',
+            description: 'Show recent recorded sessions (local, opt-in history)',
+            availableDuringRun: true,
+            // Read-only discovery, mirroring /config: render the App's fail-soft, pre-built summary.
+            run: (ctx) => ({ notice: historyNotice(ctx.historySummary) }),
+        },
+        {
+            name: 'search',
+            description: 'Search recorded session history (/search <terms>)',
+            availableDuringRun: true,
+            // Dynamic query, so it calls the App-injected fail-soft search provider (stubbable in tests).
+            run: (ctx, args) => ({ notice: searchNotice(args, ctx.historySearch) }),
+        },
+        {
+            name: 'insights',
+            description: 'Show local analytics over recorded sessions (tokens, cost, top tools)',
+            availableDuringRun: true,
+            run: (ctx) => ({ notice: insightsNotice(ctx.insightsSummary) }),
+        },
+        {
+            name: 'model',
+            description: 'Show the current model / provider',
+            availableDuringRun: true,
+            run: (ctx) => ({
+                notice: {
+                    title: `Model: ${ctx.modelDisplayName || 'unknown'}`,
+                    lines: [
+                        'This is the model answering your messages this session.',
+                        'Change the default via `gth init` or your gsloth config.',
+                    ],
+                },
+            }),
+        },
+        {
+            name: 'reasoning',
+            description: "Reprint a turn's thinking (/reasoning [n]; no number = latest with thinking)",
+            // Read-only recall of a past turn's thinking — safe to run mid-turn, like /history and /config.
+            availableDuringRun: true,
+            // Pure: resolve the target from the App-provided committed reasonings; the App renders the
+            // reprint (reusing TUI-C15 styling) or the friendly notice.
+            run: (ctx, args) => resolveReasoning(ctx.turnReasonings ?? [], args),
+        },
+        {
+            name: 'debug-dump',
+            description: 'Dump transcript + config + env + debug log to ~/.gsloth/debug-dumps (secrets redacted; --unsafe-no-redact keeps raw)',
+            // Read-only from the transcript/thread's perspective (it only writes a diagnostic archive,
+            // never mutates session state), so it's useful precisely when something is going wrong
+            // mid-turn — mirrors /history, /config, /debug being availableDuringRun.
+            availableDuringRun: true,
+            run: (ctx, args) => {
+                if (!ctx.dumpDebugSession) {
+                    return {
+                        notice: {
+                            title: 'Debug dump unavailable',
+                            lines: DEBUG_DUMP_UNAVAILABLE_LINES,
+                            tone: 'warn',
+                        },
+                    };
+                }
+                // GS2-47 — redact by default; opt out via config `debugDump.redact: false` or the
+                // `--unsafe-no-redact` flag. The resolved flag is threaded into the writer AND picks the
+                // notice (softened when redacted, loud "unsanitized" warning when raw).
+                const redact = resolveDebugDumpRedact(ctx.resolvedConfig, args);
+                const { archiveDir } = ctx.dumpDebugSession({
+                    transcript: ctx.transcript ?? [],
+                    config: ctx.resolvedConfig,
+                    modelDisplayName: ctx.modelDisplayName,
+                    redact,
+                });
+                return { notice: debugDumpNotice(archiveDir, redact) };
+            },
+        },
+    ];
+}
+/** Build the `/help` notice from a registry: one body line per command (`/name — description`). */
+export function formatHelp(registry) {
+    return {
+        title: 'Slash commands',
+        lines: registry.map((c) => `/${c.name} — ${c.description}`),
+    };
+}
+/**
+ * Dispatch a parsed command against a registry. Unknown commands return a friendly hint
+ * rather than throwing, so the component can render it as a system line and never forward
+ * the text to the model.
+ *
+ * EXT-12 — when `options.duringRun` is set (a turn is streaming), commands that are not marked
+ * {@link SlashCommand.availableDuringRun} are refused with a friendly notice rather than run,
+ * so mid-turn input can only reach the safe, non-mutating commands (`/auto-approve`, `/verbose`,
+ * `/debug`, …). `/help` is always allowed.
+ */
+export function dispatchSlashCommand(parsed, registry, ctx, options = {}) {
+    if (parsed.name === 'help') {
+        return { notice: formatHelp(registry) };
+    }
+    const command = registry.find((c) => c.name === parsed.name);
+    if (!command) {
+        return {
+            notice: {
+                title: `Unknown command: /${parsed.name}`,
+                lines: ["That isn't a recognized slash command.", 'Run /help to see everything available.'],
+                tone: 'warn',
+            },
+        };
+    }
+    if (options.duringRun && !command.availableDuringRun) {
+        return {
+            notice: {
+                title: `/${command.name} is not available while the agent is working`,
+                lines: [
+                    'Wait for the current turn to finish, then run it again.',
+                    'Commands like /auto-approve, /verbose and /debug do work mid-turn.',
+                ],
+                tone: 'warn',
+            },
+        };
+    }
+    return command.run(ctx, parsed.args);
+}
+//# sourceMappingURL=slashCommands.js.map

package/dist/modules/slashCommands.js.map

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

package/dist/resolvers.js

@@ -11,6 +11,7 @@
 import { debugLog } from '@gaunt-sloth/core/utils/debugUtils.js';
 import { displayInfo, displayWarning } from '@gaunt-sloth/core/utils/consoleUtils.js';
 import { createA2AAgentTool } from '#src/tools/A2AAgentTool.js';
+import { createMcpResourceTools } from '#src/tools/McpResourceTool.js';
 import { prepareMcpTools } from '#src/utils/mcpUtils.js';
 import { formatMcpConnectFailureMessage } from '#src/utils/mcpAuthError.js';
 import { createAuthProviderAndAuthenticate } from '#src/mcp/OAuthClientProviderImpl.js';
@@ -98,6 +99,9 @@ export function createResolvers() {
         // 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) {
+            // Narrow the mutable `| null` field once so the synthesized resource tools can close over a
+            // non-null client (like A2A tools close over their wrapper).
+            const activeClient = mcpClientInstance;
             const serverNames = Object.keys(config.mcpServers || {});
             for (const serverName of serverNames) {
                 try {
@@ -106,6 +110,17 @@ export function createResolvers() {
                     if (instructions) {
                         mcpServerInstructions.push({ server: serverName, instructions });
                     }
+                    // EXT-48: if this server advertises the `resources` capability, synthesize two
+                    // agent-callable tools (mcp__<server>__list_resources / __read_resource) bound to the
+                    // live client + server name, and push them into the SAME tools array both backends
+                    // consume — no agent-backend edit. On-by-default when advertised; opt-out is the
+                    // existing allowedTools glob (mcp__<server>__*). Concrete-URI list/read only —
+                    // resource TEMPLATES are deferred. Reuses this loop's per-server try/catch: a server
+                    // that lacks resources or throws on capability/synthesis contributes no resource tools
+                    // and does not abort the rest.
+                    if (client?.getServerCapabilities()?.resources) {
+                        tools.push(...createMcpResourceTools(activeClient, serverName));
+                    }
                 }
                 catch (error) {
                     debugLog(`MCP instructions capture error for '${serverName}': ${error}`);