march-cli 0.1.10 → 0.1.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "march-cli",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "March CLI — terminal-native coding agent with context reconstruction",
   "type": "module",
   "main": "./src/main.mjs",

package/src/agent/tool-names.mjs

@@ -1 +1 @@
-export const MARCH_BASE_TOOL_NAMES = ["grep", "ls"];
+export const MARCH_BASE_TOOL_NAMES = ["grep", "find", "ls"];

package/src/agent/tools.mjs

@@ -3,7 +3,6 @@ import { Type } from "typebox";
 import { createCommandExecTool } from "./command-exec-tool.mjs";
 import { createContextStatsTool } from "./context-stats-tool.mjs";
 import { createEditFileTool } from "./file-edit-tool.mjs";
-import { createFindTool } from "./find-tool.mjs";
 import { createReadFileTool } from "./read-file-tool.mjs";
 import { toolText } from "./tool-result.mjs";
 import { createShellTools } from "../shell/tools.mjs";
@@ -14,7 +13,6 @@ export function createMarchCustomTools({ cwd, engine, ui, memoryTools = [], shel
   const commandExecTool = createCommandExecTool({ cwd });
   const contextStatsTool = createContextStatsTool({ engine });
   const editFileTool = createEditFileTool({ engine, ui, lspService });
-  const findTool = createFindTool({ cwd });
   const readFileTool = createReadFileTool({ engine });
 
   const tools = [
@@ -22,7 +20,6 @@ export function createMarchCustomTools({ cwd, engine, ui, memoryTools = [], shel
     contextStatsTool,
     commandExecTool,
     editFileTool,
-    findTool,
     ...createShellTools(shellRuntime),
     ...memoryTools,
     ...mcpTools,

package/src/cli/commands/status-command.mjs

@@ -1,6 +1,6 @@
 import { spawnSync } from "node:child_process";
 import { MODES, formatModeLabel } from "../input/mode-state.mjs";
-import { accent, text, PREFIX, R } from "../tui/ui-theme.mjs";
+import { PREFIX, R } from "../tui/ui-theme.mjs";
 
 export function statusCommand({
   runner,
@@ -23,11 +23,6 @@ export function statusCommand({
 
 export function statusBarLine({
   runner,
-  sessionState,
-  sessionSource = "pi",
-  extensionDiagnostics = [],
-  lifecycleState = null,
-  gitBranch = getGitBranch(runner.engine.cwd),
   mode = MODES.DO,
   contextTokens = null,
   activity = null,
@@ -35,12 +30,6 @@ export function statusBarLine({
 }) {
   return formatStatusBarLine({
     engine: runner.engine,
-    sessionState,
-    sessionStats: runner.getSessionStats?.() ?? null,
-    sessionSource,
-    extensionDiagnostics,
-    lifecycleState,
-    gitBranch,
     mode,
     contextTokens,
     activity,

package/src/cli/shell/shell-drawer.mjs

@@ -137,7 +137,7 @@ export class ShellDrawer {
 
   getOutputLines(shellId = this.getSelectedShell()?.id) {
     if (!shellId || !this.shellRuntime) return [];
-    const snapshot = this.shellRuntime.snapshotShell(shellId);
+    const snapshot = this.shellRuntime.snapshotShellScreen?.(shellId) ?? this.shellRuntime.snapshotShell(shellId);
     return formatAnsiLines(snapshot);
   }
 

package/src/cli/tui/output/visible-lines.mjs

@@ -0,0 +1,8 @@
+export function sliceLinesWithTail(baseLines, tailLine, range) {
+  if (!range) return tailLine == null ? baseLines : [...baseLines, tailLine];
+
+  const { start, end } = range;
+  const visible = baseLines.slice(start, Math.min(end, baseLines.length));
+  if (tailLine != null && end > baseLines.length) visible.push(tailLine);
+  return visible;
+}

package/src/cli/tui/output-buffer.mjs

@@ -4,6 +4,7 @@ import { renderMarkdown, renderStreamingMarkdown } from "./markdown-renderer.mjs
 import { renderEditDiffBlock } from "./tui-diff-rendering.mjs";
 import { OutputScrollState } from "./output/scroll-state.mjs";
 import { appendTextLines, wrapLine } from "./output/text-line-renderer.mjs";
+import { sliceLinesWithTail } from "./output/visible-lines.mjs";
 
 const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 
@@ -72,6 +73,7 @@ export class OutputBuffer {
     this.overlayStatus = null;
     this.scrollState = new OutputScrollState();
     this._segmentLinesCache = new Map();
+    this._baseLinesCache = new Map();
   }
 
   get scrollOffset() {
@@ -89,6 +91,7 @@ export class OutputBuffer {
     this.overlayStatus = null;
     this.scrollState.clear();
     this._segmentLinesCache = new Map();
+    this._baseLinesCache = new Map();
   }
 
   write(text) {
@@ -101,6 +104,7 @@ export class OutputBuffer {
 
   _writeText(text, markdown) {
     this.overlayStatus = null;
+    this._invalidateBaseLines();
     const current = this.currentText.at(-1);
     if (current.markdown !== markdown && current.text !== "") {
       this.currentText.push({ text: "", markdown });
@@ -114,6 +118,7 @@ export class OutputBuffer {
 
   writeln(text) {
     this.overlayStatus = null;
+    this._invalidateBaseLines();
     this.currentText[this.currentText.length - 1].text += text;
     this.currentText.push({ text: "", markdown: false });
   }
@@ -122,6 +127,7 @@ export class OutputBuffer {
     const current = this.currentText.at(-1);
     if (!current || current.text === "") return false;
     this.currentText.push({ text: "", markdown: false });
+    this._invalidateBaseLines();
     return true;
   }
 
@@ -141,12 +147,14 @@ export class OutputBuffer {
     if (lastIdx >= 0) this._activeThinking.content[lastIdx] += parts[0];
     else this._activeThinking.content.push(parts[0]);
     for (let i = 1; i < parts.length; i++) this._activeThinking.content.push(parts[i]);
+    this._invalidateBaseLines();
   }
 
   endThinking(tokens) {
     if (this._activeThinking) {
       this._activeThinking.tokens = tokens;
       this._activeThinking = null;
+      this._invalidateSegmentLines();
     }
   }
 
@@ -166,10 +174,12 @@ export class OutputBuffer {
 
   setOverlayStatus(lines) {
     this.overlayStatus = Array.isArray(lines) ? { type: "status", lines } : null;
+    this._invalidateBaseLines();
   }
 
   clearOverlayStatus() {
     this.overlayStatus = null;
+    this._invalidateBaseLines();
   }
 
   sealCurrentText() {
@@ -232,34 +242,33 @@ export class OutputBuffer {
 
   _invalidateSegmentLines() {
     this._segmentLinesCache.clear();
+    this._invalidateBaseLines();
+  }
+
+  _invalidateBaseLines() {
+    this._baseLinesCache.clear();
   }
 
   render(width) {
-    const allLines = this._computeLines(width);
-    this._cachedTotalLines = allLines.length;
-    this.scrollState.setTotalLines(allLines.length);
-    const range = this.scrollState.sliceRange();
-    if (!range) return allLines;
-    const { start, end } = range;
-    return allLines.slice(start, end);
+    const baseLines = this._renderBaseLines(width);
+    const tailLine = this.spinning ? this._spinnerLine() : null;
+    this.scrollState.setTotalLines(baseLines.length + (tailLine == null ? 0 : 1));
+    return sliceLinesWithTail(baseLines, tailLine, this.scrollState.sliceRange());
+  }
+
+  _spinnerLine() {
+    return brightBlack(`${SPINNER_FRAMES[this.spinnerIdx]} ${this.spinnerText}`);
   }
 
-  _computeLines(width) {
+  _renderBaseLines(width) {
+    const cached = this._baseLinesCache.get(width);
+    if (cached) return cached;
     const lines = [...this._renderCachedSegmentLines(width)];
     const dynamicStart = this._cachedSegmentPrefixCount();
-    for (const seg of this.segments.slice(dynamicStart)) {
-      for (const line of renderBlock(seg, width)) lines.push(line);
-    }
-    for (const block of currentTextToBlocks(this.currentText, false, this.currentTextCache)) {
-      for (const line of renderBlock(block, width)) lines.push(line);
-    }
-    if (this.overlayStatus) {
-      for (const line of renderBlock(this.overlayStatus, width)) lines.push(line);
-    }
-    if (this.spinning) {
-      const frame = SPINNER_FRAMES[this.spinnerIdx];
-      lines.push(brightBlack(`${frame} ${this.spinnerText}`));
-    }
+    for (const seg of this.segments.slice(dynamicStart)) for (const line of renderBlock(seg, width)) lines.push(line);
+    for (const block of currentTextToBlocks(this.currentText, false, this.currentTextCache)) for (const line of renderBlock(block, width)) lines.push(line);
+    if (this.overlayStatus) for (const line of renderBlock(this.overlayStatus, width)) lines.push(line);
+    this._baseLinesCache.set(width, lines);
     return lines;
   }
 

package/src/cli/tui/render/stream-delta-buffer.mjs

@@ -0,0 +1,46 @@
+export function createStreamDeltaBuffer({
+  writeText,
+  writeThinking,
+  renderSoon,
+  delayMs = 16,
+  setTimeoutImpl = setTimeout,
+  clearTimeoutImpl = clearTimeout,
+} = {}) {
+  const queued = [];
+  let timer = null;
+
+  function append(kind, delta) {
+    if (!delta) return;
+    const last = queued.at(-1);
+    if (last?.kind === kind) last.text += delta;
+    else queued.push({ kind, text: delta });
+    schedule();
+  }
+
+  function schedule() {
+    if (timer) return;
+    timer = setTimeoutImpl(() => flush(), delayMs);
+    timer.unref?.();
+  }
+
+  function flush({ notify = true } = {}) {
+    if (timer) {
+      clearTimeoutImpl(timer);
+      timer = null;
+    }
+    if (!queued.length) return false;
+    const batch = queued.splice(0);
+    for (const item of batch) {
+      if (item.kind === "thinking") writeThinking(item.text);
+      else writeText(item.text);
+    }
+    if (notify) renderSoon();
+    return true;
+  }
+
+  return {
+    text: (delta) => append("text", delta),
+    thinking: (delta) => append("thinking", delta),
+    flush,
+  };
+}

package/src/cli/tui/selection-screen.mjs

@@ -10,16 +10,19 @@ export class ScreenSelection {
     this.anchor = null;
     this.focus = null;
     this.lines = [];
+    this._plainLines = [];
     this.viewport = { topRow: 0, leftCol: 0, width: Infinity, height: 0 };
   }
 
   setLines(lines) {
-    this.lines = lines.map((line) => stripAnsi(line));
+    this.lines = [...lines];
+    this._plainLines = [];
     this.viewport = { topRow: 0, leftCol: 0, width: Infinity, height: this.lines.length };
   }
 
   setViewport({ topRow = 0, leftCol = 0, width = Infinity, lines = [] } = {}) {
-    this.lines = lines.map((line) => stripAnsi(line));
+    this.lines = lines;
+    this._plainLines = [];
     this.viewport = {
       topRow: Math.max(0, Math.trunc(topRow)),
       leftCol: Math.max(0, Math.trunc(leftCol)),
@@ -68,7 +71,7 @@ export class ScreenSelection {
     if (!range) return "";
     const selected = [];
     for (let row = range.start.row; row <= range.end.row; row += 1) {
-      const line = this.lines[row] ?? "";
+      const line = this._plainLine(row);
       const startCol = row === range.start.row ? range.start.col : 0;
       const endCol = row === range.end.row ? range.end.col : visibleWidth(line);
       selected.push(sliceColumns(line, startCol, endCol));
@@ -81,7 +84,7 @@ export class ScreenSelection {
     if (!range) return lines;
     return lines.map((line, row) => {
       if (row < range.start.row || row > range.end.row) return line;
-      const plain = stripAnsi(line);
+      const plain = this._plainLine(row);
       const startCol = row === range.start.row ? range.start.col : 0;
       const endCol = row === range.end.row ? range.end.col : visibleWidth(plain);
       if (endCol <= startCol) return line;
@@ -89,6 +92,11 @@ export class ScreenSelection {
     });
   }
 
+  _plainLine(row) {
+    if (this._plainLines[row] == null) this._plainLines[row] = stripAnsi(this.lines[row] ?? "");
+    return this._plainLines[row];
+  }
+
   range() {
     if (!this.anchor || !this.focus) return null;
     const [start, end] = comparePoints(this.anchor, this.focus) <= 0

package/src/cli/tui/syntax/highlighting.mjs

@@ -19,7 +19,6 @@ import {
 } from "./languages.mjs";
 
 const RESOURCE_DIR = join(dirname(fileURLToPath(import.meta.url)), "tree-sitter");
-const ENCODER = new TextEncoder();
 
 let initPromise;
 let initialized = false;
@@ -87,11 +86,10 @@ function treeSitterRuns(text, lang) {
   if (!initialized || !parser || !text) return null;
   try {
     const tree = parser.parse(text);
-    const byteToIndex = buildByteToIndex(text);
     const scopes = Array.from({ length: text.length }, () => ({ scope: "default", priority: 0 }));
     const query = queries.get(lang);
-    if (query) applyQueryScopes(query, tree.rootNode, byteToIndex, scopes);
-    collectNodeScopes(tree.rootNode, byteToIndex, scopes);
+    if (query) applyQueryScopes(query, tree.rootNode, scopes);
+    collectNodeScopes(tree.rootNode, scopes);
     return scopesToRuns(text, scopes);
   } catch {
     return null;
@@ -109,11 +107,11 @@ function loadHighlightQuery(language, queryFile) {
   }
 }
 
-function applyQueryScopes(query, rootNode, byteToIndex, scopes) {
+function applyQueryScopes(query, rootNode, scopes) {
   for (const capture of query.captures(rootNode)) {
     const scope = captureScope(capture.name);
     if (!scope) continue;
-    applyScope(scopes, byteToIndex[capture.node.startIndex] ?? 0, byteToIndex[capture.node.endIndex] ?? scopes.length, scope);
+    applyScope(scopes, capture.node.startIndex, capture.node.endIndex, scope);
   }
 }
 
@@ -135,10 +133,10 @@ function captureScope(name) {
   return null;
 }
 
-function collectNodeScopes(node, byteToIndex, scopes) {
+function collectNodeScopes(node, scopes) {
   const scope = classifyNode(node);
-  if (scope) applyScope(scopes, byteToIndex[node.startIndex] ?? 0, byteToIndex[node.endIndex] ?? scopes.length, scope);
-  for (const child of node.children ?? []) collectNodeScopes(child, byteToIndex, scopes);
+  if (scope) applyScope(scopes, node.startIndex, node.endIndex, scope);
+  for (const child of node.children ?? []) collectNodeScopes(child, scopes);
 }
 
 function classifyNode(node) {
@@ -259,19 +257,4 @@ export function styleSyntax(text, scope = "default", bg = "") {
   return `\x1b[${codes.join(";")}m${text}${R}`;
 }
 
-function buildByteToIndex(text) {
-  const map = [];
-  let byte = 0;
-  for (let index = 0; index < text.length;) {
-    const codePoint = text.codePointAt(index);
-    const char = String.fromCodePoint(codePoint);
-    const bytes = ENCODER.encode(char).length;
-    for (let i = 0; i < bytes; i++) map[byte + i] = index;
-    byte += bytes;
-    index += char.length;
-  }
-  map[byte] = text.length;
-  return map;
-}
-
 void initializeTreeSitterHighlighting();

package/src/cli/tui/syntax/languages.mjs

@@ -25,7 +25,7 @@ export const LANG_ALIASES = new Map([
   ["cs", "csharp"], ["css", "css"], ["cts", "typescript"], ["csharp", "csharp"], ["cxx", "cpp"],
   ["diff", "diff"], ["go", "go"], ["h", "c"], ["hh", "cpp"], ["htm", "html"], ["html", "html"],
   ["hpp", "cpp"], ["hxx", "cpp"], ["java", "java"], ["javascript", "javascript"], ["js", "javascript"],
-  ["json", "json"], ["jsonc", "json"], ["jsx", "jsx"], ["mjs", "javascript"], ["mts", "typescript"],
+  ["json", "json"], ["jsonc", "json"], ["jsx", "tsx"], ["mjs", "javascript"], ["mts", "typescript"],
   ["patch", "diff"], ["php", "php"], ["py", "python"], ["python", "python"], ["rb", "ruby"],
   ["rs", "rust"], ["ruby", "ruby"], ["rust", "rust"], ["sh", "bash"], ["toml", "toml"],
   ["ts", "typescript"], ["tsx", "tsx"], ["typescript", "typescript"], ["yaml", "yaml"], ["yml", "yaml"],

package/src/cli/ui.mjs

@@ -24,6 +24,7 @@ import { writeMemoryHint } from "./tui/recall-rendering.mjs";
 import { writeToolEnd, writeToolStart } from "./tui/tool-rendering.mjs";
 import { EDITOR_THEME, brightBlack } from "./tui/ui-theme.mjs";
 import { createRenderScheduler } from "./tui/render/render-scheduler.mjs";
+import { createStreamDeltaBuffer } from "./tui/render/stream-delta-buffer.mjs";
 import { writeTranscriptToOutput } from "../session/transcript.mjs";
 
 export { buildMarchCommands, MarchAutocompleteProvider } from "./input/autocomplete.mjs";
@@ -61,8 +62,9 @@ export function createTuiUI({
   let toolsExpanded = false;
   const activeToolBlocks = [];
   const renderScheduler = createRenderScheduler({ requestRender: () => tui.requestRender() });
-  const requestRender = renderScheduler.renderNow;
-
+  const streamDeltas = createStreamDeltaBuffer({ writeText: (delta) => output.writeMarkdown(delta), writeThinking: (delta) => output.appendThinking(delta), renderSoon: renderScheduler.renderSoon });
+  const flushStreamDeltas = () => streamDeltas.flush({ notify: false });
+  const requestRender = () => { flushStreamDeltas(); renderScheduler.renderNow(); };
   const spinnerStatus = createSpinnerStatusController({ output, requestRender });
   const retryStatus = createRetryStatusController({ output, requestRender, stopSpinner: spinnerStatus.stop });
   const shellDrawerControls = createShellDrawerControls({ shellDrawer, output, requestRender });
@@ -169,12 +171,10 @@ export function createTuiUI({
       retryStatus.stop(); output.startThinking(); requestRender();
     },
 
-    thinkingDelta: (delta) => {
-      output.appendThinking(delta);
-      renderScheduler.renderSoon();
-    },
+    thinkingDelta: (delta) => streamDeltas.thinking(delta),
 
     thinkingEnd: (tokens) => {
+      flushStreamDeltas();
       output.endThinking(tokens);
       requestRender();
     },
@@ -186,7 +186,7 @@ export function createTuiUI({
     toggleLastThinking: () => false,
 
     toolStart: (name, args) => {
-      ensureStarted(); retryStatus.stop(); spinnerStatus.stop(); activeToolBlocks.push(writeToolStart({ output, name, args })); requestRender();
+      ensureStarted(); flushStreamDeltas(); retryStatus.stop(); spinnerStatus.stop(); activeToolBlocks.push(writeToolStart({ output, name, args })); requestRender();
     },
 
     toolEnd: (name, isError, result) => {
@@ -194,30 +194,26 @@ export function createTuiUI({
     },
 
     textDelta: (delta) => {
-      ensureStarted(); retryStatus.stop(); spinnerStatus.stop();
-      output.writeMarkdown(delta);
-      renderScheduler.renderSoon();
+      ensureStarted(); retryStatus.stop(); spinnerStatus.stop(); streamDeltas.text(delta);
     },
     assistantReplyEnd: () => {
       ensureStarted();
+      flushStreamDeltas();
       const changed = output.ensureNewline();
       if (output.sealCurrentText() || changed) requestRender();
     },
     status: (text) => {
-      ensureStarted(); retryStatus.stop(); spinnerStatus.stop(); output.setOverlayStatus([brightBlack(`● ${text}`)]); requestRender();
+      ensureStarted(); flushStreamDeltas(); retryStatus.stop(); spinnerStatus.stop(); output.setOverlayStatus([brightBlack(`● ${text}`)]); requestRender();
     },
     memoryHint: ({ hints }) => {
-      ensureStarted(); retryStatus.stop(); spinnerStatus.stop(); output.ensureNewline(); writeMemoryHint({ output, hints }); requestRender();
+      ensureStarted(); flushStreamDeltas(); retryStatus.stop(); spinnerStatus.stop(); output.ensureNewline(); writeMemoryHint({ output, hints }); requestRender();
     },
 
     clearOutput: () => {
-      ensureStarted(); spinnerStatus.stop(); retryStatus.stop(); output.clear(); requestRender();
+      ensureStarted(); flushStreamDeltas(); spinnerStatus.stop(); retryStatus.stop(); output.clear(); requestRender();
     },
-
     restoreTranscript: (turns) => {
-      ensureStarted(); spinnerStatus.stop(); retryStatus.stop(); output.clear();
-      writeTranscriptToOutput(output, turns);
-      requestRender();
+      ensureStarted(); flushStreamDeltas(); spinnerStatus.stop(); retryStatus.stop(); output.clear(); writeTranscriptToOutput(output, turns); requestRender();
     },
 
     setStatusBar: (text) => {
@@ -229,6 +225,7 @@ export function createTuiUI({
     },
 
     turnEnd: () => {
+      flushStreamDeltas();
       const changed = output.ensureNewline();
       if (output.sealCurrentText() || changed) requestRender();
     },
@@ -238,6 +235,7 @@ export function createTuiUI({
 
     editDiff: (path, diffLines) => {
       ensureStarted();
+      flushStreamDeltas();
       spinnerStatus.stop();
       writeEditDiff({ output, path, diffLines });
       requestRender();
@@ -278,6 +276,7 @@ export function createTuiUI({
     toggleShellDrawer: () => shellDrawerControls.toggle(),
     requestExit: () => inputController.requestExit(),
     close: async () => {
+      flushStreamDeltas();
       renderScheduler.clearPending();
       spinnerStatus.stop();
       retryStatus.stop();

package/src/context/system-core/base.md

@@ -58,7 +58,7 @@ The user primarily asks for software engineering work: fixing bugs, adding behav
 - To edit an existing memory, use memory_open(id) to get its path, then edit_file with mode="patch" for targeted edits.
 - Use memory_save() to create memories or update whole fields. Before creating a new memory, first search/open related memories and merge updates into an existing memory when they share the same topic, project, or decision thread; prefer modifying the existing memory file over creating a scattered new one. Tags are the primary retrieval key for future recall. Prefer lowercase kebab-case tags like 'march-cli', 'tooling', 'permissions'.
 - When learning multiple related external workflows or skills, maintain memory as an evolving domain library: start with the specific source name when only one item exists, then rename and rewrite the memory title/description as the scope grows; merge new related learnings into the same memory, preserving each source's unique traits while distilling reusable principles.
-- Distinguish "migrating a Skill to memory" from "learning a Skill": migration preserves the complete Skill folder under memory_root/skills/ and creates a memory index with purpose, source, entry files, and local path; learning only reads and internalizes the Skill's methods, scenarios, and principles into ordinary memory without copying source files. Infer the action from the user's wording, and ask when ambiguous.
+- Distinguish "migrating a Skill to memory" from "learning a Skill": migration preserves the complete Skill folder under memory_root/skills/ and creates a memory entry as its index; that memory should describe what the Skill is for and reference the copied Skill folder path so future recall knows how to use it. Learning only reads and internalizes the Skill's methods, scenarios, and principles into ordinary memory without copying source files. Infer the action from the user's wording, and ask when ambiguous.
 - Unlike memory hints, this system-core center is always visible in every model call. Only update the center for instructions that must always be followed; use memory for contextual, project-specific, or recall-dependent knowledge.
 - If execution takes a meaningful detour, create or update a memory after the task. A detour means the initial plan or assumption failed, multiple approaches were tried, and the final successful path contains reusable project knowledge. Record the failed assumption, what was tried, and the successful approach. Prefer updating an existing related memory over creating a new one.
 </memory_system>

package/src/shell/runtime.mjs

@@ -10,7 +10,6 @@ import {
   normalizeSize,
   publicShell,
   requireShell,
-  stripAnsi,
   touch,
   uniqueName,
 } from "./runtime-state.mjs";
@@ -194,6 +193,14 @@ export function createShellRuntime({
     };
   }
 
+  function snapshotShellScreen(id) {
+    const shell = requireShell(shells, id);
+    return {
+      shell: publicShell(shell),
+      screen: shell.screen?.snapshot?.() ?? null,
+    };
+  }
+
   function clearShell(id) {
     const shell = requireShell(shells, id);
     shell.rawChunks = [];
@@ -238,6 +245,7 @@ export function createShellRuntime({
     getShell,
     searchShell,
     snapshotShell,
+    snapshotShellScreen,
     clearShell,
     dispose,
   };

package/src/agent/find-tool.mjs

@@ -1,112 +0,0 @@
-import { readdirSync, statSync } from "node:fs";
-import { isAbsolute, relative, resolve } from "node:path";
-import { defineTool } from "@earendil-works/pi-coding-agent";
-import { Type } from "typebox";
-import { toolText } from "./tool-result.mjs";
-
-const DEFAULT_LIMIT = 1000;
-const DEFAULT_IGNORES = new Set([".git", "node_modules"]);
-
-export function createFindTool({ cwd }) {
-  return defineTool({
-    name: "find",
-    label: "Find Files",
-    description: "Find files by glob pattern. Pattern is matched relative to the search directory. Basename-only patterns like '*.mjs' search recursively, so find('*.mjs', path:'src') and find('src/**/*.mjs') both work.",
-    parameters: Type.Object({
-      pattern: Type.String({ description: "Glob pattern to match files, e.g. '*.mjs', '**/*.json', or 'src/**/*.test.mjs'" }),
-      path: Type.Optional(Type.String({ description: "Directory to search in (default: current directory)" })),
-      limit: Type.Optional(Type.Number({ description: "Maximum number of results (default 1000)" })),
-    }),
-    execute: async (_toolCallId, params) => executeFind({ cwd, ...params }),
-  });
-}
-
-export function executeFind({ cwd, pattern, path = ".", limit = DEFAULT_LIMIT }) {
-  const searchRoot = resolveSearchRoot(cwd, path);
-  const trimmedPattern = String(pattern ?? "").trim().replaceAll("\\", "/");
-  if (!trimmedPattern) return toolText("Error: pattern is required", { error: true });
-  const effectivePattern = normalizePattern(trimmedPattern);
-
-  const max = Math.max(1, Number(limit) || DEFAULT_LIMIT);
-  let files;
-  try {
-    files = listFiles(searchRoot);
-  } catch (err) {
-    return toolText(`Error: ${err.message}`, { error: true });
-  }
-
-  const matches = [];
-  for (const file of files) {
-    const rel = toPosix(relative(searchRoot, file));
-    if (!matchesGlob(effectivePattern, rel)) continue;
-    matches.push(rel);
-    if (matches.length >= max) break;
-  }
-
-  if (matches.length === 0) return toolText("No files found matching pattern", { pattern: trimmedPattern, effectivePattern, path: searchRoot, count: 0 });
-  const limitHint = matches.length >= max ? `\n\n[Results truncated to ${max}. Increase limit or refine pattern.]` : "";
-  return toolText(`${matches.join("\n")}${limitHint}`, {
-    pattern: trimmedPattern,
-    effectivePattern: effectivePattern === trimmedPattern ? undefined : effectivePattern,
-    path: searchRoot,
-    count: matches.length,
-    resultLimitReached: matches.length >= max ? max : undefined,
-  });
-}
-
-function normalizePattern(pattern) {
-  if (pattern.includes("/") || pattern.includes("**")) return pattern;
-  return `**/${pattern}`;
-}
-
-function resolveSearchRoot(cwd, path) {
-  const raw = String(path || ".");
-  return isAbsolute(raw) ? raw : resolve(cwd, raw);
-}
-
-function listFiles(root) {
-  const out = [];
-  walk(root, out);
-  return out.sort((a, b) => toPosix(a).localeCompare(toPosix(b)));
-}
-
-function walk(dir, out) {
-  for (const entry of readdirSync(dir, { withFileTypes: true })) {
-    if (entry.isDirectory() && DEFAULT_IGNORES.has(entry.name)) continue;
-    const path = resolve(dir, entry.name);
-    if (entry.isDirectory()) walk(path, out);
-    else if (entry.isFile()) out.push(path);
-  }
-}
-
-function matchesGlob(pattern, candidate) {
-  return matchSegments(splitGlob(pattern), splitGlob(candidate));
-}
-
-function matchSegments(patternSegments, candidateSegments) {
-  if (patternSegments.length === 0) return candidateSegments.length === 0;
-  const [head, ...tail] = patternSegments;
-  if (head === "**") {
-    if (matchSegments(tail, candidateSegments)) return true;
-    return candidateSegments.length > 0 && matchSegments(patternSegments, candidateSegments.slice(1));
-  }
-  if (candidateSegments.length === 0) return false;
-  return matchSegment(head, candidateSegments[0]) && matchSegments(tail, candidateSegments.slice(1));
-}
-
-function matchSegment(pattern, candidate) {
-  const regex = new RegExp(`^${escapeRegex(pattern).replaceAll("\\*", "[^/]*").replaceAll("\\?", "[^/]")}$`);
-  return regex.test(candidate);
-}
-
-function splitGlob(value) {
-  return String(value).split("/").filter(Boolean);
-}
-
-function toPosix(value) {
-  return String(value).replaceAll("\\", "/");
-}
-
-function escapeRegex(value) {
-  return String(value).replace(/[|\\{}()[\]^$+*?.]/g, "\\$&");
-}