npm - agent-sh - Versions diffs - 0.15.0 → 0.15.2 - Mend

agent-sh 0.15.0 → 0.15.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (124) hide show

package/dist/agent/agent-loop.js +11 -8
package/dist/agent/events.d.ts +4 -0
package/docs/README.md +14 -0
package/docs/agent.md +398 -0
package/docs/architecture.md +196 -0
package/docs/context-management.md +200 -0
package/docs/extensions.md +951 -0
package/docs/library.md +84 -0
package/docs/troubleshooting.md +65 -0
package/docs/tui-composition.md +294 -0
package/docs/usage.md +306 -0
package/examples/extensions/ash-scheme/package.json +1 -1
package/examples/extensions/ashi/EXTENDING.md +2 -2
package/examples/extensions/ashi/README.md +2 -2
package/examples/extensions/ashi/docs/ui-surface-protocol.md +1 -1
package/examples/extensions/ashi/package.json +5 -3
package/examples/extensions/ashi/src/chat/tool-group.ts +3 -2
package/examples/extensions/ashi/src/cli.ts +9 -8
package/examples/extensions/ashi/src/dialogs.ts +16 -1
package/examples/extensions/ashi/src/events.ts +1 -0
package/examples/extensions/ashi/src/frontend.ts +26 -6
package/examples/extensions/ashi/src/renderer.ts +24 -4
package/examples/extensions/ashi/src/renderers/pi-tui/schema-mount.ts +4 -3
package/examples/extensions/ashi/src/renderers/pi-tui/tool-group.ts +5 -8
package/examples/extensions/ashi/src/ui.ts +11 -0
package/examples/extensions/ashi-ink/package.json +2 -2
package/examples/extensions/claude-code-bridge/package.json +1 -1
package/examples/extensions/opencode-bridge/package.json +1 -1
package/package.json +3 -1
package/src/agent/agent-loop.ts +1566 -0
package/src/agent/entry-format.ts +19 -0
package/src/agent/events.ts +153 -0
package/src/agent/extensions/rolling-history/constants.ts +1 -0
package/src/agent/extensions/rolling-history/index.ts +202 -0
package/src/agent/extensions/rolling-history/recall.ts +131 -0
package/src/agent/extensions/rolling-history/strategy.ts +404 -0
package/src/agent/host-types.ts +192 -0
package/src/agent/index.ts +591 -0
package/src/agent/live-view.ts +279 -0
package/src/agent/llm-client.ts +111 -0
package/src/agent/llm-facade.ts +43 -0
package/src/agent/normalize-args.ts +61 -0
package/src/agent/nuclear-form.ts +382 -0
package/src/agent/providers/deepseek.ts +39 -0
package/src/agent/providers/ollama.ts +92 -0
package/src/agent/providers/openai-compatible.ts +36 -0
package/src/agent/providers/openai.ts +52 -0
package/src/agent/providers/opencode.ts +142 -0
package/src/agent/providers/openrouter.ts +105 -0
package/src/agent/providers/zai-coding-plan.ts +33 -0
package/src/agent/session-store.ts +336 -0
package/src/agent/skills.ts +228 -0
package/src/agent/store.ts +310 -0
package/src/agent/subagent.ts +305 -0
package/src/agent/system-prompt.ts +151 -0
package/src/agent/token-budget.ts +12 -0
package/src/agent/tool-protocol.ts +722 -0
package/src/agent/tool-registry.ts +66 -0
package/src/agent/tools/bash.ts +95 -0
package/src/agent/tools/edit-file.ts +154 -0
package/src/agent/tools/expand-home.ts +7 -0
package/src/agent/tools/glob.ts +108 -0
package/src/agent/tools/grep.ts +228 -0
package/src/agent/tools/list-skills.ts +37 -0
package/src/agent/tools/ls.ts +81 -0
package/src/agent/tools/pwsh.ts +140 -0
package/src/agent/tools/read-file.ts +164 -0
package/src/agent/tools/write-file.ts +72 -0
package/src/agent/types.ts +149 -0
package/src/cli/args.ts +91 -0
package/src/cli/auth/cli.ts +244 -0
package/src/cli/auth/discover.ts +52 -0
package/src/cli/auth/keys.ts +143 -0
package/src/cli/index.ts +295 -0
package/src/cli/init.ts +74 -0
package/src/cli/install.ts +439 -0
package/src/cli/shell-env.ts +68 -0
package/src/cli/subcommands.ts +24 -0
package/src/core/event-bus.ts +252 -0
package/src/core/extension-loader.ts +347 -0
package/src/core/index.ts +152 -0
package/src/core/settings.ts +398 -0
package/src/core/types.ts +61 -0
package/src/extensions/file-autocomplete.ts +71 -0
package/src/extensions/index.ts +38 -0
package/src/extensions/slash-commands/events.ts +14 -0
package/src/extensions/slash-commands/index.ts +269 -0
package/src/shell/events.ts +73 -0
package/src/shell/host-types.ts +150 -0
package/src/shell/index.ts +159 -0
package/src/shell/input-handler.ts +505 -0
package/src/shell/output-parser.ts +156 -0
package/src/shell/shell-context.ts +193 -0
package/src/shell/shell.ts +414 -0
package/src/shell/strategies/bash.ts +83 -0
package/src/shell/strategies/fish.ts +77 -0
package/src/shell/strategies/index.ts +24 -0
package/src/shell/strategies/types.ts +64 -0
package/src/shell/strategies/zsh.ts +92 -0
package/src/shell/terminal.ts +124 -0
package/src/shell/tui-input-view.ts +222 -0
package/src/shell/tui-renderer.ts +1126 -0
package/src/utils/ansi.ts +140 -0
package/src/utils/box-frame.ts +138 -0
package/src/utils/compositor.ts +157 -0
package/src/utils/diff-renderer.ts +829 -0
package/src/utils/diff.ts +244 -0
package/src/utils/executor.ts +305 -0
package/src/utils/file-watcher.ts +110 -0
package/src/utils/floating-panel.ts +1160 -0
package/src/utils/handler-registry.ts +110 -0
package/src/utils/line-editor.ts +636 -0
package/src/utils/markdown.ts +437 -0
package/src/utils/message-utils.ts +113 -0
package/src/utils/package-version.ts +12 -0
package/src/utils/palette.ts +64 -0
package/src/utils/ref-counter.ts +9 -0
package/src/utils/ripgrep-path.ts +17 -0
package/src/utils/shell-output-spill.ts +76 -0
package/src/utils/stream-transform.ts +292 -0
package/src/utils/terminal-buffer.ts +213 -0
package/src/utils/tool-display.ts +315 -0
package/src/utils/tool-interactive.ts +71 -0
package/src/utils/tty.ts +14 -0

package/src/shell/output-parser.ts ADDED Viewed

@@ -0,0 +1,156 @@
+import type { EventBus } from "../core/event-bus.js";
+import { stripAnsi } from "../utils/ansi.js";
+// Self-emitted form: \e]<num>;id=<own>;<body>\a — only this is honored.
+// Anything else (mismatched tag, untagged) is ignored as opaque foreground output.
+const PROMPT_RE = /\x1b\]9999;(?:id=([a-f0-9]+);)?PROMPT\x07/;
+const PREEXEC_RE = /\x1b\]9997;(?:id=([a-f0-9]+);)?([^\x07]*)\x07/;
+const READY_RE = /\x1b\]9998;(?:id=([a-f0-9]+);)?READY\x07/;
+export interface OutputParserOpts {
+  /** Optional shell-specific cleanup applied to raw output before stripAnsi. */
+  cleanOutput?(raw: string): string;
+}
+export class OutputParser {
+  private bus: EventBus;
+  private cwd: string;
+  private ownTag: string;
+  private cleanOutput: (raw: string) => string;
+  private currentOutputCapture = "";
+  private lastCommand = "";
+  private foregroundBusy = false;
+  private promptReady = false;
+  constructor(bus: EventBus, initialCwd: string, ownTag: string, opts: OutputParserOpts = {}) {
+    this.bus = bus;
+    this.cwd = initialCwd;
+    this.ownTag = ownTag.startsWith("id=") ? ownTag.slice(3) : ownTag;
+    this.cleanOutput = opts.cleanOutput ?? ((raw) => raw);
+  }
+  processData(data: string): void {
+    this.parseOSC7(data);
+    data = this.handlePreexec(data);
+    this.parsePromptMarker(data);
+    this.parsePromptEnd(data);
+  }
+  onCommandEntered(command: string, cwd: string): void {
+    this.lastCommand = command;
+    this.currentOutputCapture = "";
+    this.bus.emit("shell:command-start", { command, cwd });
+    if (!this.foregroundBusy) {
+      this.foregroundBusy = true;
+      this.bus.emit("shell:foreground-busy", { busy: true });
+    }
+  }
+  isPromptReady(): boolean {
+    return this.promptReady;
+  }
+  isForegroundBusy(): boolean {
+    return this.foregroundBusy;
+  }
+  getCwd(): string {
+    return this.cwd;
+  }
+  /** Pulls the actual command from the shell's OSC 9997 preexec marker —
+   *  more reliable than the InputHandler's lineBuffer, which can't track
+   *  history recall or tab completion. Returns data with the OSC stripped. */
+  private handlePreexec(data: string): string {
+    const match = PREEXEC_RE.exec(data);
+    if (!match) return data;
+    if (match[1] !== this.ownTag) {
+      // Nested instance or untagged foreign emission — strip and ignore.
+      return data.slice(0, match.index) + data.slice(match.index + match[0].length);
+    }
+    const command = match[2]!;
+    this.lastCommand = command;
+    // Discard echo accumulated before preexec.
+    this.currentOutputCapture = "";
+    if (!this.foregroundBusy) {
+      this.foregroundBusy = true;
+      this.bus.emit("shell:foreground-busy", { busy: true });
+    }
+    this.bus.emit("shell:command-start", { command, cwd: this.cwd });
+    return data.slice(match.index + match[0].length);
+  }
+  private parseOSC7(data: string): void {
+    const match = data.match(/\x1b\]7;file:\/\/[^/]*(\/[^\x07\x1b]*)/);
+    if (match?.[1]) {
+      const newCwd = decodeURIComponent(match[1]);
+      if (newCwd !== this.cwd) {
+        this.cwd = newCwd;
+        this.bus.emit("shell:cwd-change", { cwd: this.cwd });
+      }
+    }
+  }
+  /** OSC 9999 marker — each occurrence finalizes the previous command's output. */
+  private parsePromptMarker(data: string): void {
+    const match = PROMPT_RE.exec(data);
+    if (match) {
+      if (match[1] !== this.ownTag) {
+        // Nested or untagged emission: keep as opaque foreground output.
+        this.currentOutputCapture += data;
+        return;
+      }
+      const markerIdx = match.index;
+      if (markerIdx > 0) {
+        this.currentOutputCapture += data.slice(0, markerIdx);
+      }
+      this.promptReady = false;
+      if (this.foregroundBusy) {
+        this.foregroundBusy = false;
+        this.bus.emit("shell:foreground-busy", { busy: false });
+      }
+      if (this.lastCommand) {
+        const raw = this.cleanOutput(this.currentOutputCapture);
+        const output = this.removeEchoedCommand(stripAnsi(raw).trim(), this.lastCommand);
+        const outputRaw = this.removeEchoedCommand(raw.trim(), this.lastCommand);
+        this.bus.emit("shell:command-done", {
+          command: this.lastCommand,
+          output,
+          outputRaw,
+          cwd: this.cwd,
+          exitCode: null,
+        });
+      }
+      this.lastCommand = "";
+      this.currentOutputCapture = "";
+    } else {
+      // Cap to the tail so a long-running foreground program (tmux, vim)
+      // emitting output without prompt markers can't grow this unboundedly.
+      const MAX_CAPTURE = 128 * 1024;
+      this.currentOutputCapture += data;
+      if (this.currentOutputCapture.length > MAX_CAPTURE) {
+        this.currentOutputCapture = this.currentOutputCapture.slice(-MAX_CAPTURE);
+      }
+    }
+  }
+  /** OSC 9998 — prompt is fully rendered and the shell is ready for input. */
+  private parsePromptEnd(data: string): void {
+    const match = READY_RE.exec(data);
+    if (!match) return;
+    if (match[1] !== this.ownTag) return;
+    this.promptReady = true;
+  }
+  private removeEchoedCommand(output: string, command: string): string {
+    const lines = output.split("\n");
+    if (lines.length > 0 && stripAnsi(lines[0]!).includes(command.slice(0, 20))) {
+      return lines.slice(1).join("\n").trim();
+    }
+    return output;
+  }
+}

package/src/shell/shell-context.ts ADDED Viewed

@@ -0,0 +1,193 @@
+/** Tracks PTY commands and cwd, spills long outputs, contributes per-query
+ *  `<shell_events>` (fresh user exchanges) and — under the shell frontend —
+ *  `<cwd>`. Frontends without a PTY skip this. */
+import type { ExtensionContext } from "./host-types.js";
+import { getSettings } from "../core/settings.js";
+import { spillOutput } from "../utils/shell-output-spill.js";
+// The cwd-drift note applies only under the shell frontend (where the agent shares
+// the user's cwd); other frontends own a fixed cwd.
+const SHELL_EVENTS_NOTE = `When the user runs shell commands, they appear as \`<shell_events>\` inside \`<query_context>\` on your next turn — use them to ground "fix this" / "what just happened" requests.`;
+const CWD_DRIFT_NOTE = `\`<cwd>\` is the working directory your own tool calls run in: relative paths resolve against it, and it follows the user's shell \`cd\`, so it can change from one turn to the next. Always act on the latest \`<cwd>\`, not one from earlier in the conversation.`;
+const PREFERENCES_NOTE = `Treat the user's commands as standing preferences: check them for recurring patterns and apply them proactively, without waiting to be asked.`;
+interface ShellExchange {
+  id: number;
+  timestamp: number;
+  cwd: string;
+  command: string;
+  /** In-context representation: full text if short, head+tail+path stub if spilled. */
+  output: string;
+  exitCode: number | null;
+  outputLines: number;
+  outputBytes: number;
+  source: "user" | "agent" | "user-excluded";
+  spillPath?: string;
+}
+export default function activate(ctx: ExtensionContext): void {
+  const { bus } = ctx;
+  // The agent shares the user's cwd only under the shell frontend (which installs
+  // ctx.shell); other frontends — e.g. ashi — keep their own fixed cwd.
+  const ownsAgentCwd = !!(ctx as { shell?: unknown }).shell;
+  const exchanges: ShellExchange[] = [];
+  let nextId = 1;
+  let currentCwd = process.cwd();
+  let agentShellActive = false;
+  let nextUserExcluded = false;
+  let lastSeq = 0;
+  bus.on("shell:command-done", (e) => {
+    const lines = e.output.split("\n");
+    const s = getSettings();
+    // Long outputs spill to a tempfile the agent can `read_file` instead of
+    // carrying the full text in LLM context.
+    let output = e.output;
+    let spillPath: string | undefined;
+    if (lines.length > s.shellTruncateThreshold) {
+      const id = nextId;
+      try {
+        spillPath = spillOutput(id, e.output);
+        output = buildSpillStub(lines, s.shellHeadLines, s.shellTailLines, spillPath);
+      } catch {
+        output = e.output;
+        spillPath = undefined;
+      }
+    }
+    const source: ShellExchange["source"] = agentShellActive
+      ? "agent"
+      : nextUserExcluded
+        ? "user-excluded"
+        : "user";
+    if (nextUserExcluded) nextUserExcluded = false;
+    exchanges.push({
+      id: nextId++,
+      timestamp: Date.now(),
+      cwd: e.cwd,
+      command: e.command,
+      output,
+      exitCode: e.exitCode,
+      outputLines: lines.length,
+      outputBytes: e.output.length,
+      source,
+      spillPath,
+    });
+  });
+  bus.on("shell:cwd-change", (e) => { currentCwd = e.cwd; });
+  bus.on("shell:agent-exec-start", () => { agentShellActive = true; });
+  bus.on("shell:agent-exec-done", () => { agentShellActive = false; });
+  bus.on("shell:user-exec-exclude-next", () => { nextUserExcluded = true; });
+  if (ownsAgentCwd) ctx.advise("cwd", () => currentCwd);
+  // Advise the core handler directly: this loads before the agent host
+  // attaches `ctx.agent`, so the sugar isn't available yet.
+  ctx.advise("query-context:build", (next) => {
+    const base = next() as string;
+    const fresh = exchanges.filter((ex) => ex.id > lastSeq && ex.source === "user");
+    let shellEvents = "";
+    if (fresh.length > 0) {
+      lastSeq = exchanges[exchanges.length - 1]!.id;
+      const text = fresh.map(formatExchangeTruncated).filter(Boolean).join("\n");
+      if (text) shellEvents = `<shell_events>\n${text}\n</shell_events>`;
+    }
+    const part = ownsAgentCwd
+      ? [`<cwd>${currentCwd}</cwd>`, shellEvents].filter(Boolean).join("\n")
+      : shellEvents;
+    return [base, part].filter(Boolean).join("\n\n");
+  });
+  bus.onPipe("agent:instructions", (acc) => {
+    const text = [SHELL_EVENTS_NOTE, ownsAgentCwd ? CWD_DRIFT_NOTE : "", PREFERENCES_NOTE]
+      .filter(Boolean).join("\n\n");
+    acc.instructions.push({ name: "shell-events", text });
+    return acc;
+  });
+  ctx.define("shell:context-recent", (n: number = 25) => {
+    const recent = exchanges.slice(-n);
+    if (recent.length === 0) return "No exchanges yet.";
+    return recent.map(exchangeOneLiner).join("\n");
+  });
+  ctx.define("shell:context-search", (query: string) => {
+    if (!query.trim()) return "No query provided.";
+    let regex: RegExp;
+    try {
+      regex = new RegExp(query, "i");
+    } catch {
+      const words = query.split(/\s+/).filter((w) => w.length > 0);
+      regex = new RegExp(words.map(escapeRegex).join("|"), "i");
+    }
+    const matches: { exchange: ShellExchange; excerpts: string[] }[] = [];
+    for (const ex of exchanges) {
+      const text = `${ex.command}\n${ex.output}`;
+      const lines = text.split("\n");
+      const matchingIndices: number[] = [];
+      for (let i = 0; i < lines.length; i++) {
+        if (regex.test(lines[i]!)) matchingIndices.push(i);
+      }
+      if (matchingIndices.length > 0) {
+        const excerpts = matchingIndices.slice(0, 5).map((idx) => {
+          const start = Math.max(0, idx - 2);
+          const end = Math.min(lines.length, idx + 3);
+          return lines.slice(start, end).join("\n");
+        });
+        matches.push({ exchange: ex, excerpts });
+      }
+    }
+    if (matches.length === 0) return `No results found for "${query}".`;
+    const parts: string[] = [`Search results for "${query}" (${matches.length} exchanges):\n`];
+    for (const m of matches.slice(0, 20)) {
+      parts.push(`#${m.exchange.id} [shell_command]`);
+      for (const excerpt of m.excerpts) parts.push(indent(excerpt, "  "));
+      parts.push("");
+    }
+    return parts.join("\n");
+  });
+}
+function formatExchangeTruncated(ex: ShellExchange): string {
+  const label = ex.source === "agent" ? "agent → shell" : "shell";
+  let s = `#${ex.id} [${label} cwd:${ex.cwd}] $ ${ex.command}\n`;
+  if (ex.output) s += indent(ex.output, "  ") + "\n";
+  if (ex.exitCode !== null) s += `  exit ${ex.exitCode}\n`;
+  return s;
+}
+function exchangeOneLiner(ex: ShellExchange): string {
+  const label = ex.source === "agent" ? "agent → shell" : "shell";
+  return `#${ex.id} ${label} [cwd:${ex.cwd}]: ${ex.command} (${ex.outputLines} total lines, exit ${ex.exitCode ?? "?"})`;
+}
+function buildSpillStub(
+  lines: string[],
+  headLines: number,
+  tailLines: number,
+  spillPath: string,
+): string {
+  const omitted = lines.length - headLines - tailLines;
+  return [
+    ...lines.slice(0, headLines),
+    `[... ${omitted} lines truncated — full output at ${spillPath}; use read_file to expand ...]`,
+    ...lines.slice(-tailLines),
+  ].join("\n");
+}
+function indent(text: string, prefix: string): string {
+  return text.split("\n").map((line) => prefix + line).join("\n");
+}
+function escapeRegex(str: string): string {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}