@trenchwork/erosolar 1.1.60 → 1.1.62

package/dist/contracts/v1/agent.d.ts

@@ -8,7 +8,7 @@ export declare const AGENT_CONTRACT_VERSION = "1.0.0";
 /**
  * Event types emitted during agent execution
  */
-export type AgentEventType = 'message.start' | 'message.delta' | 'message.complete' | 'tool.start' | 'tool.complete' | 'tool.error' | 'edit.explanation' | 'reasoning' | 'error' | 'usage' | 'provider.fallback' | 'context.compacted';
+export type AgentEventType = 'message.start' | 'message.delta' | 'message.complete' | 'tool.start' | 'tool.complete' | 'tool.error' | 'edit.explanation' | 'reasoning' | 'error' | 'usage' | 'provider.fallback' | 'context.compacted' | 'subagent.start' | 'subagent.complete';
 /**
  * Base event structure
  */
@@ -114,10 +114,27 @@ export interface ContextCompactedEvent extends AgentEvent {
     /** resulting context-usage percentage after compaction */
     percentage: number;
 }
+/**
+ * Emitted when a parallel sub-agent (Task) spawns / finishes — surfaced live
+ * like Claude Code's Task tool so the parallel fan-out is visible.
+ */
+export interface SubAgentStartEvent extends AgentEvent {
+    type: 'subagent.start';
+    id: string;
+    /** short label for the sub-task */
+    description: string;
+}
+export interface SubAgentCompleteEvent extends AgentEvent {
+    type: 'subagent.complete';
+    id: string;
+    description: string;
+    success: boolean;
+    elapsedMs: number;
+}
 /**
  * Union of all event types
  */
-export type AgentEventUnion = MessageStartEvent | MessageDeltaEvent | MessageCompleteEvent | ToolStartEvent | ToolCompleteEvent | ToolErrorEvent | EditExplanationEvent | ReasoningEvent | ErrorEvent | UsageEvent | ProviderFallbackEvent | ContextCompactedEvent;
+export type AgentEventUnion = MessageStartEvent | MessageDeltaEvent | MessageCompleteEvent | ToolStartEvent | ToolCompleteEvent | ToolErrorEvent | EditExplanationEvent | ReasoningEvent | ErrorEvent | UsageEvent | ProviderFallbackEvent | ContextCompactedEvent | SubAgentStartEvent | SubAgentCompleteEvent;
 /**
  * Model selection configuration
  */

package/dist/contracts/v1/agent.d.ts.map

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

package/dist/core/slashCommands.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Slash-command autocomplete — the `/` half of Claude Code's typed completion
+ * (the `@`-mention half lives in fileMentions.ts and the two share an identical
+ * menu UX in Prompt.tsx). Typing `/` at the start of the buffer opens a
+ * filterable palette of commands; ↑/↓ move, Tab/Enter accept, Esc dismisses.
+ *
+ * The catalog is the single source of truth for what the palette offers. It
+ * lists only the canonical command names (aliases like /c, /q, /changes are
+ * handled by interactiveShell but kept out of the palette to match Claude
+ * Code's one-row-per-command surface). A test asserts every entry here is
+ * actually handled by interactiveShell.handleSlashCommand so the two can't
+ * drift.
+ */
+export interface SlashCommand {
+    command: string;
+    description: string;
+}
+export declare const SLASH_COMMANDS: readonly SlashCommand[];
+/**
+ * The command partial being typed at the cursor, or null. A slash command only
+ * exists as the FIRST token of the buffer, so the partial is the run of
+ * non-whitespace right after a leading `/` with nothing before it. Returns ''
+ * for a bare `/`. Once a space is typed (entering args) this returns null and
+ * the palette closes.
+ */
+export declare function activeSlashPartial(text: string, cursor: number): string | null;
+/** Commands matching `partial` (name without the `/`), prefix-first then substring. */
+export declare function rankCommandMatches(partial: string, limit?: number): SlashCommand[];
+/**
+ * Replace the active `/<partial>` first token with `<command> ` (trailing space
+ * so an arg can follow, and so the partial no longer matches — closing the
+ * palette). Mirrors applyMentionCompletion.
+ */
+export declare function applySlashCompletion(text: string, cursor: number, command: string): {
+    text: string;
+    cursor: number;
+};
+//# sourceMappingURL=slashCommands.d.ts.map

package/dist/core/slashCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slashCommands.d.ts","sourceRoot":"","sources":["../../src/core/slashCommands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAYjD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG9E;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,YAAY,EAAE,CAa7E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAIpH"}

package/dist/core/slashCommands.js

@@ -0,0 +1,68 @@
+/**
+ * Slash-command autocomplete — the `/` half of Claude Code's typed completion
+ * (the `@`-mention half lives in fileMentions.ts and the two share an identical
+ * menu UX in Prompt.tsx). Typing `/` at the start of the buffer opens a
+ * filterable palette of commands; ↑/↓ move, Tab/Enter accept, Esc dismisses.
+ *
+ * The catalog is the single source of truth for what the palette offers. It
+ * lists only the canonical command names (aliases like /c, /q, /changes are
+ * handled by interactiveShell but kept out of the palette to match Claude
+ * Code's one-row-per-command surface). A test asserts every entry here is
+ * actually handled by interactiveShell.handleSlashCommand so the two can't
+ * drift.
+ */
+export const SLASH_COMMANDS = [
+    { command: '/key', description: 'Set your DeepSeek API key' },
+    { command: '/clear', description: 'Clear the screen and conversation' },
+    { command: '/resume', description: 'Restore a saved conversation' },
+    { command: '/context', description: 'Show context-window usage' },
+    { command: '/diff', description: 'Review files changed this run' },
+    { command: '/rewind', description: 'Restore files changed this run' },
+    { command: '/update', description: 'Update to the latest version' },
+    { command: '/keys', description: 'Show keyboard shortcuts' },
+    { command: '/bash', description: 'Run a shell command directly' },
+    { command: '/help', description: 'Show help' },
+    { command: '/exit', description: 'Exit the shell' },
+];
+/**
+ * The command partial being typed at the cursor, or null. A slash command only
+ * exists as the FIRST token of the buffer, so the partial is the run of
+ * non-whitespace right after a leading `/` with nothing before it. Returns ''
+ * for a bare `/`. Once a space is typed (entering args) this returns null and
+ * the palette closes.
+ */
+export function activeSlashPartial(text, cursor) {
+    const m = text.slice(0, Math.max(0, cursor)).match(/^\/(\S*)$/);
+    return m ? (m[1] ?? '') : null;
+}
+/** Commands matching `partial` (name without the `/`), prefix-first then substring. */
+export function rankCommandMatches(partial, limit = 8) {
+    const q = partial.toLowerCase();
+    if (!q)
+        return SLASH_COMMANDS.slice(0, limit);
+    const scored = [];
+    for (const c of SLASH_COMMANDS) {
+        const name = c.command.slice(1).toLowerCase();
+        let score = -1;
+        if (name.startsWith(q))
+            score = 0;
+        else if (name.includes(q))
+            score = 1;
+        if (score >= 0)
+            scored.push({ c, score });
+    }
+    scored.sort((a, b) => a.score - b.score || a.c.command.length - b.c.command.length);
+    return scored.slice(0, limit).map((s) => s.c);
+}
+/**
+ * Replace the active `/<partial>` first token with `<command> ` (trailing space
+ * so an arg can follow, and so the partial no longer matches — closing the
+ * palette). Mirrors applyMentionCompletion.
+ */
+export function applySlashCompletion(text, cursor, command) {
+    if (activeSlashPartial(text, cursor) === null)
+        return { text, cursor };
+    const insert = `${command} `;
+    return { text: insert + text.slice(cursor), cursor: insert.length };
+}
+//# sourceMappingURL=slashCommands.js.map

package/dist/core/slashCommands.js.map

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

package/dist/core/subAgentNote.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Transcript copy for parallel sub-agents (Claude Code's Task tool parity).
+ * Pure + emoji-free except the ✓/✗ status glyphs already used elsewhere in
+ * the shell (UX §9 bans chrome emoji, not status checkmarks).
+ */
+export interface SubAgentResult {
+    description: string;
+    success: boolean;
+    elapsedMs: number;
+}
+/** Start line, rendered with the ⏺ action bullet by the shell. */
+export declare function formatSubAgentStart(description: string): string;
+/** Dim completion line: "✓ Task(label) · 1.2s". */
+export declare function formatSubAgentComplete(r: SubAgentResult): string;
+//# sourceMappingURL=subAgentNote.d.ts.map

package/dist/core/subAgentNote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subAgentNote.d.ts","sourceRoot":"","sources":["../../src/core/subAgentNote.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,mDAAmD;AACnD,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAIhE"}

package/dist/core/subAgentNote.js

@@ -0,0 +1,16 @@
+/**
+ * Transcript copy for parallel sub-agents (Claude Code's Task tool parity).
+ * Pure + emoji-free except the ✓/✗ status glyphs already used elsewhere in
+ * the shell (UX §9 bans chrome emoji, not status checkmarks).
+ */
+/** Start line, rendered with the ⏺ action bullet by the shell. */
+export function formatSubAgentStart(description) {
+    return `Task(${description})`;
+}
+/** Dim completion line: "✓ Task(label) · 1.2s". */
+export function formatSubAgentComplete(r) {
+    const tag = r.success ? '✓' : '✗';
+    const secs = (Math.max(0, r.elapsedMs) / 1000).toFixed(1);
+    return `${tag} Task(${r.description}) · ${secs}s`;
+}
+//# sourceMappingURL=subAgentNote.js.map

package/dist/core/subAgentNote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subAgentNote.js","sourceRoot":"","sources":["../../src/core/subAgentNote.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,kEAAkE;AAClE,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,OAAO,QAAQ,WAAW,GAAG,CAAC;AAChC,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,sBAAsB,CAAC,CAAiB;IACtD,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAClC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1D,OAAO,GAAG,GAAG,SAAS,CAAC,CAAC,WAAW,OAAO,IAAI,GAAG,CAAC;AACpD,CAAC"}

package/dist/headless/interactiveShell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactiveShell.d.ts","sourceRoot":"","sources":["../../src/headless/interactiveShell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA4JH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA0CD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAErE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDzF"}
+{"version":3,"file":"interactiveShell.d.ts","sourceRoot":"","sources":["../../src/headless/interactiveShell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA6JH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA0CD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAErE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDzF"}

package/dist/headless/interactiveShell.js

@@ -41,6 +41,7 @@ import { getChangedFiles, revertAllChanges, hasChangesToRevert } from '../tools/
 import { renderChangePanel } from '../core/diffPanel.js';
 import { rewindPreviewLines, rewindResultLine } from '../core/rewind.js';
 import { formatCompactionNote } from '../core/compactionNote.js';
+import { formatSubAgentStart, formatSubAgentComplete } from '../core/subAgentNote.js';
 import { getConfiguredProviders, getProvidersStatus, quickCheckProviders, getCachedDiscoveredModels, sortModelsByPriority } from '../core/modelDiscovery.js';
 import { saveModelPreference } from '../core/preferences.js';
 import { setDebugMode, debugSnippet } from '../utils/debugLogger.js';
@@ -341,6 +342,9 @@ class InteractiveShell {
             onToggleHITL: () => this.handleHITLToggle(),
             onCyclePermissionMode: (mode) => this.handlePermissionModeChange(mode),
             onExpandToolResult: () => this.handleExpandToolResult(),
+            // Esc interrupts a running turn (handleInterrupt no-ops when idle), so
+            // the spinner's "esc to interrupt" is real. Ctrl+C still works too.
+            onEscape: () => this.handleInterrupt(),
         });
         // Register cleanup callback for graceful shutdown
         onShutdown(() => {
@@ -1543,8 +1547,9 @@ class InteractiveShell {
             `  ${kb('Shift+Tab')}  ${desc('Cycle permission mode (default · accept edits · plan)')}`,
             `  ${kb('Ctrl+O')}     ${desc('Expand the last truncated tool result')}`,
             '',
-            chalk.hex('#cbf24e')('Mentions'),
+            chalk.hex('#cbf24e')('Completion'),
             `  ${kb('@')}          ${desc('Autocomplete a file (↑/↓ · Tab/Enter); its content is inlined for the agent')}`,
+            `  ${kb('/')}          ${desc('Autocomplete a command (↑/↓ · Tab to complete; Enter runs it)')}`,
             '',
             chalk.hex('#cbf24e')('Control'),
             `  ${kb('Ctrl+C')}  ${desc('Clear input / interrupt')}`,
@@ -1596,6 +1601,14 @@ class InteractiveShell {
             setTimeout(() => this.promptController?.setStatusMessage(null), 2000);
             return;
         }
+        // `!cmd` — bash mode (Claude Code parity): run the rest as a shell command
+        // directly, no model round-trip. Same executor as /bash, via the leading
+        // bang. Runs immediately (like a slash command), not queued behind the agent.
+        if (trimmed.startsWith('!')) {
+            this.dismissInlinePanel();
+            void this.runLocalCommand(trimmed.slice(1).trim());
+            return;
+        }
         // Dismiss inline panel for regular user prompts
         this.dismissInlinePanel();
         // Live follow-up queue (Claude Code parity): a prompt typed while the agent
@@ -1794,7 +1807,10 @@ class InteractiveShell {
                         }
                         // Claude-Code action line: `⏺ ToolName(primaryArg)`. The dim
                         // present-tense label drives the working spinner above the prompt.
-                        if (renderer) {
+                        // parallel_agents is suppressed here — its per-sub-agent Task notes
+                        // (subagent.start/complete) are the visible surface instead of a
+                        // raw `parallel_agents({"tasks":…})` JSON dump.
+                        if (renderer && toolName !== 'parallel_agents') {
                             renderer.addEvent('tool', formatToolCall(toolName, args, this.workingDir));
                         }
                         this.promptController?.setStatusMessage(toolActivityLabel(toolName, args, this.workingDir));
@@ -1855,6 +1871,18 @@ class InteractiveShell {
                         });
                         break;
                     }
+                    case 'subagent.start':
+                        // A parallel sub-agent spawned — show it like Claude Code's Task.
+                        renderer?.addEvent('tool', formatSubAgentStart(event.description));
+                        this.promptController?.setStatusMessage(`Running sub-agent: ${event.description}`);
+                        break;
+                    case 'subagent.complete':
+                        renderer?.addEvent('system', chalk.dim(formatSubAgentComplete({
+                            description: event.description,
+                            success: event.success,
+                            elapsedMs: event.elapsedMs,
+                        })));
+                        break;
                     case 'context.compacted': {
                         // The conversation was auto-compacted to stay within the window —
                         // surface it as a dim note (Claude Code parity) instead of silently.