pi-readseek 0.7.6 → 0.7.8

package/src/tool-prompt-metadata.ts

@@ -1,107 +0,0 @@
-import { readFileSync } from "node:fs";
-
-import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize } from "@earendil-works/pi-coding-agent";
-
-const REPLACEABLE_TOOL_GUIDELINES: Record<string, { readSeekName: string; builtInName: string; benefit: string }> = {
-  "read.md": {
-    readSeekName: "readSeek_read",
-    builtInName: "read",
-    benefit: "it provides LINE:HASH anchors for safe edits.",
-  },
-  "edit.md": {
-    readSeekName: "readSeek_edit",
-    builtInName: "edit",
-    benefit: "it verifies fresh LINE:HASH anchors.",
-  },
-  "grep.md": {
-    readSeekName: "readSeek_grep",
-    builtInName: "grep",
-    benefit: "it returns edit-ready anchors.",
-  },
-  "write.md": {
-    readSeekName: "readSeek_write",
-    builtInName: "write",
-    benefit: "it returns LINE:HASH anchors.",
-  },
-};
-
-const COMPACT_GUIDELINES: Record<string, string[]> = {
-  "read.md": [
-    "Use readSeek_read map or symbol mode to inspect large code files without reading them in full.",
-  ],
-  "edit.md": [
-    "With readSeek_edit, prefer set_line, replace_lines, and insert_after; use replace only when anchors are impractical.",
-  ],
-  "grep.md": [
-    "Use readSeek_grep summary mode for broad count/file discovery before narrowing.",
-  ],
-  "write.md": [
-    "Use anchored edits rather than readSeek_write for small changes or appends to existing files.",
-  ],
-  "search.md": [
-    "Use readSeek_search for syntax-aware code shapes; use readSeek_grep for plain text.",
-  ],
-  "refs.md": [
-    "Use readSeek_refs to find every usage of an identifier before renaming or deleting it.",
-    "Use readSeek_refs with scope plus line/column to follow a specific binding instead of every same-named identifier.",
-  ],
-};
-
-interface ToolPromptMetadata {
-  description: string;
-  promptSnippet: string;
-  promptGuidelines: string[];
-}
-
-function loadPrompt(promptUrl: URL): string {
-  return readFileSync(promptUrl, "utf-8")
-    .replaceAll("{{DEFAULT_MAX_LINES}}", String(DEFAULT_MAX_LINES))
-    .replaceAll("{{DEFAULT_MAX_BYTES}}", formatSize(DEFAULT_MAX_BYTES))
-    .trim();
-}
-
-function firstPromptParagraph(prompt: string): string {
-  return prompt.split(/\n\s*\n/, 1)[0]?.trim() ?? prompt;
-}
-
-function promptFileName(promptUrl: URL): string {
-  return promptUrl.pathname.split("/").pop() ?? "";
-}
-
-function rewriteToolAliases(value: string, toolAliases: Readonly<Record<string, string>> | undefined): string {
-  if (!toolAliases) return value;
-  return Object.entries(toolAliases).reduce(
-    (rewritten, [canonicalName, registeredName]) => rewritten.replaceAll(canonicalName, registeredName),
-    value,
-  );
-}
-
-export function defineToolPromptMetadata(options: {
-  promptUrl: URL;
-  promptSnippet: string;
-  registeredName?: string;
-  toolAliases?: Readonly<Record<string, string>>;
-}): ToolPromptMetadata {
-  const prompt = loadPrompt(options.promptUrl);
-  const fileName = promptFileName(options.promptUrl);
-  const replaceable = REPLACEABLE_TOOL_GUIDELINES[fileName];
-  const registeredName = options.registeredName ?? replaceable?.readSeekName;
-  const preferenceGuideline = replaceable && registeredName
-    ? registeredName === replaceable.readSeekName
-      ? `Prefer ${registeredName} over ${replaceable.builtInName} when both are available; ${replaceable.benefit}`
-      : `Use ${registeredName}; ${replaceable.benefit}`
-    : undefined;
-  return {
-    description: rewriteToolAliases(firstPromptParagraph(prompt), options.toolAliases),
-    promptSnippet: rewriteToolAliases(options.promptSnippet, options.toolAliases),
-    promptGuidelines: [
-      ...(preferenceGuideline ? [preferenceGuideline] : []),
-      ...(COMPACT_GUIDELINES[fileName] ?? []).map((guideline) =>
-        rewriteToolAliases(
-          registeredName && replaceable ? guideline.replaceAll(replaceable.readSeekName, registeredName) : guideline,
-          options.toolAliases,
-        ),
-      ),
-    ],
-  };
-}

package/src/tool-types.ts

@@ -1,12 +0,0 @@
-/**
- * Callback used when a tool returns fresh anchors for a file path.
- */
-export type FileAnchoredCallback = (absolutePath: string) => void;
-
-/**
- * Predicate used by mutating tools to check whether a file has session-fresh anchors.
- */
-export type FreshAnchorsPredicate = (absolutePath: string) => boolean;
-
-/** Callback used after a tool persists a file mutation. */
-export type FileMutatedCallback = (absolutePath: string) => void;

package/src/tui-diff-component.ts

@@ -1,108 +0,0 @@
-import type { Component } from "@earendil-works/pi-tui";
-import { Text, visibleWidth } from "@earendil-works/pi-tui";
-import type { DiffData } from "./diff-data.js";
-import { renderTuiDiff } from "./tui-diff-renderer.js";
-import { clampLineToWidth, normalizeWidth, type RendererTheme } from "./tui-render-utils.js";
-
-export interface DiffPreviewComponentOptions {
-	/**
-	 * Lines rendered before the diff body (e.g. tool summary, "pending edit"
-	 * header). Each entry is one logical line; the component is responsible
-	 * for clamping to the render-time width.
-	 */
-	prefixLines?: string[];
-	/**
-	 * Lines rendered after the diff body (e.g. trailing hints). Currently
-	 * unused but kept for symmetry.
-	 */
-	suffixLines?: string[];
-	/** Diff body data. */
-	diffData: DiffData;
-	/** Theme passed through to renderTuiDiff for color tinting. */
-	theme: RendererTheme;
-	/** Whether the diff body should render in expanded form. */
-	expanded: boolean;
-	/**
-	 * Optional fallback width used when render() receives an invalid width
-	 * (zero, negative, NaN). Defaults to 80.
-	 */
-	fallbackWidth?: number;
-}
-
-/**
- * Self-rendering component for a tool's diff preview that defers wrapping
- * decisions to the TUI render pass.
- *
- * `renderTuiDiff` (and the underlying `wrapWithHangingIndent` helper) need
- * the real viewport width to choose between split / unified / compact / summary
- * modes and to wrap long content rows with prefix-aligned continuation lines.
- * Pi's `ToolRenderContext` does NOT carry the render-time width, so any
- * pre-baked output is forced to assume a fallback (80 columns). This
- * component holds the source data instead, then renders at the width pi's TUI
- * actually passes in.
- */
-export class DiffPreviewComponent implements Component {
-	private options: DiffPreviewComponentOptions;
-	private cachedWidth: number | undefined;
-	private cachedLines: string[] | undefined;
-
-	constructor(options: DiffPreviewComponentOptions) {
-		this.options = options;
-	}
-
-	update(options: DiffPreviewComponentOptions): void {
-		this.options = options;
-		this.invalidate();
-	}
-
-	invalidate(): void {
-		this.cachedWidth = undefined;
-		this.cachedLines = undefined;
-	}
-
-	render(width: number): string[] {
-		const normalized = normalizeWidth(width, this.options.fallbackWidth ?? 80);
-		if (this.cachedLines && this.cachedWidth === normalized) return this.cachedLines;
-		const lines: string[] = [];
-		for (const prefix of this.options.prefixLines ?? []) {
-			for (const line of prefix.split("\n")) lines.push(clampLineToWidth(line, normalized));
-		}
-		const body = renderTuiDiff({
-			diffData: this.options.diffData,
-			width: normalized,
-			theme: this.options.theme,
-			expanded: this.options.expanded,
-		});
-		for (const line of body.lines) lines.push(line);
-		for (const suffix of this.options.suffixLines ?? []) {
-			for (const line of suffix.split("\n")) lines.push(clampLineToWidth(line, normalized));
-		}
-		// Final safety clamp: each rendered line must fit within the viewport.
-		const clamped = lines.map((line) => (visibleWidth(line) <= normalized ? line : clampLineToWidth(line, normalized)));
-		this.cachedLines = clamped;
-		this.cachedWidth = normalized;
-		return clamped;
-	}
-}
-
-/**
- * Reuse the prior render tick's {@link DiffPreviewComponent} when present, else
- * construct one, then apply {@link options}. Keeps a streaming diff preview
- * stable across ticks instead of remounting a fresh component each frame.
- */
-export function upsertDiffComponent(lastComponent: unknown, options: DiffPreviewComponentOptions): DiffPreviewComponent {
-	const component = lastComponent instanceof DiffPreviewComponent ? lastComponent : new DiffPreviewComponent(options);
-	component.update(options);
-	return component;
-}
-
-/**
- * Reuse the prior render tick's text component when it is not a
- * {@link DiffPreviewComponent}, else construct a fresh {@link Text}, then set
- * its content to {@link text}.
- */
-export function upsertTextComponent(lastComponent: any, text: string): Text {
-	const component = lastComponent && !(lastComponent instanceof DiffPreviewComponent) ? lastComponent : new Text("", 0, 0);
-	component.setText(text);
-	return component;
-}

package/src/tui-diff-renderer.ts

@@ -1,92 +0,0 @@
-import { visibleWidth } from "@earendil-works/pi-tui";
-import type { DiffData, DiffEntry, DiffSpan } from "./diff-data.js";
-import { clampLineToWidth, clampLinesToWidth, normalizeWidth, wrapWithHangingIndent, type RendererTheme } from "./tui-render-utils.js";
-
-export type TuiDiffMode = "split" | "unified" | "compact" | "summary";
-export type RenderTuiDiffInput = { diffData: DiffData; width: number; theme: RendererTheme; expanded: boolean };
-export type RenderTuiDiffOutput = { mode: TuiDiffMode; width: number; lines: string[] };
-
-function hasOldSide(data: DiffData): boolean { return data.entries.some((e) => e.kind === "remove" || e.kind === "context"); }
-function chooseMode(width: number, data: DiffData): TuiDiffMode {
-  if (width < 24) return "summary";
-  if (width < 50) return "compact";
-  // Split mode wastes half the pane on pure-add diffs (pending creates,
-  // write to a new file) so fall back to unified when there is no old side.
-  if (width >= 100 && hasOldSide(data)) return "split";
-  return "unified";
-}
-function hunkCount(data: DiffData): number { return Math.max(1, data.blockRanges?.length ?? (data.entries.some((e) => e.kind === "add" || e.kind === "remove") ? 1 : 0)); }
-function compactHeader(data: DiffData): string { return `↳ diff +${data.stats.added} -${data.stats.removed}`; }
-function header(data: DiffData, mode: TuiDiffMode, width: number): string {
-  if (mode === "summary" && width <= 10) return `↳ diff +${data.stats.added}`;
-  const full = `${compactHeader(data)} • ${hunkCount(data)} hunk • 1 file • ${mode === "split" ? "split" : "unified"}`;
-  return visibleWidth(full) <= width ? full : clampLineToWidth(compactHeader(data), width);
-}
-function lineNo(entry: DiffEntry): string { return String(entry.kind === "add" ? entry.newLine : entry.kind === "remove" ? entry.oldLine : entry.kind === "context" ? entry.newLine : ""); }
-function gutterMarker(entry: DiffEntry): string { return entry.kind === "add" ? "+" : entry.kind === "remove" ? "-" : " "; }
-function textOf(entry: DiffEntry): string { return "text" in entry ? entry.text : ""; }
-function padRightVisual(line: string, width: number): string { const visible = visibleWidth(line); return visible >= width ? line : line + " ".repeat(width - visible); }
-function tint(theme: RendererTheme, entry: DiffEntry, text: string): string { return entry.kind === "add" ? theme.fg("success", text) : entry.kind === "remove" ? theme.fg("error", text) : theme.fg("toolOutput", text); }
-function spans(theme: RendererTheme, spans: DiffSpan[] | undefined, fallback: string): string { return spans?.map((s) => s.kind === "add" ? theme.fg("success", s.text) : s.kind === "remove" ? theme.fg("error", s.text) : s.text).join("") ?? fallback; }
-function inlineText(input: RenderTuiDiffInput, index: number, entry: DiffEntry): string {
-  const pair = input.diffData.inlineDiffs?.find((d) => entry.kind === "remove" ? d.removeLineIndex === index : entry.kind === "add" ? d.addLineIndex === index : false);
-  if (!pair) return textOf(entry);
-  return entry.kind === "remove" ? spans(input.theme, pair.removeSpans, textOf(entry)) : entry.kind === "add" ? spans(input.theme, pair.addSpans, textOf(entry)) : textOf(entry);
-}
-function unifiedRows(input: RenderTuiDiffInput, width: number): string[] {
-  const rows: string[] = [];
-  for (const [i, e] of input.diffData.entries.entries()) {
-    if (e.kind === "meta") continue;
-    const prefix = `▌${gutterMarker(e)} ${lineNo(e)} │ `;
-    const tinted = wrapWithHangingIndent(prefix, inlineText(input, i, e), width, { tint: (text) => tint(input.theme, e, text) });
-    rows.push(...tinted);
-  }
-  return rows;
-}
-function compactRows(input: RenderTuiDiffInput, width: number): string[] {
-  const rows: string[] = [];
-  for (const [i, e] of input.diffData.entries.entries()) {
-    if (e.kind !== "add" && e.kind !== "remove") continue;
-    const prefix = `▌${gutterMarker(e)} ${lineNo(e)} `;
-    const tinted = wrapWithHangingIndent(prefix, inlineText(input, i, e), width, { tint: (text) => tint(input.theme, e, text) });
-    rows.push(...tinted);
-  }
-  return rows;
-}
-function splitRows(input: RenderTuiDiffInput, width: number): string[] {
-  const pane = Math.max(10, Math.floor((width - 3) / 2));
-  const rows = [`${padRightVisual("old", pane)} │ new`];
-  const blankPane = " ".repeat(pane);
-  for (const [i, e] of input.diffData.entries.entries()) {
-    if (e.kind === "remove") {
-      const left = wrapWithHangingIndent(`▌- ${e.oldLine} │ `, inlineText(input, i, e), pane, { tint: (text) => tint(input.theme, e, text) });
-      for (const line of left) rows.push(`${padRightVisual(line, pane)} │ ${blankPane}`);
-    } else if (e.kind === "add") {
-      const right = wrapWithHangingIndent(`▌+ ${e.newLine} │ `, inlineText(input, i, e), pane, { tint: (text) => tint(input.theme, e, text) });
-      for (const line of right) rows.push(`${blankPane} │ ${line}`);
-    } else if (e.kind === "context") {
-      const left = wrapWithHangingIndent(`▌  ${e.oldLine} │ `, e.text, pane, { tint: (text) => tint(input.theme, e, text) });
-      const right = wrapWithHangingIndent(`▌  ${e.newLine} │ `, e.text, pane, { tint: (text) => tint(input.theme, e, text) });
-      const maxLen = Math.max(left.length, right.length);
-      for (let k = 0; k < maxLen; k++) {
-        const l = left[k] ?? blankPane;
-        const r = right[k] ?? blankPane;
-        rows.push(`${padRightVisual(l, pane)} │ ${r}`);
-      }
-    }
-  }
-  return rows;
-}
-function hiddenHint(hiddenLines: number, hiddenHunks: number, width: number): string {
-  const forms = [`… (${hiddenLines} more diff lines • ${hiddenHunks} more hunk${hiddenHunks === 1 ? "" : "s"} • Ctrl+O to expand)`, `… (${hiddenLines} more lines • ${hiddenHunks} hunks)`, `… (+${hiddenLines} • +${hiddenHunks}h)`, "…"];
-  return forms.find((f) => visibleWidth(f) <= width) ?? "…";
-}
-export function renderTuiDiff(input: RenderTuiDiffInput): RenderTuiDiffOutput {
-  const width = normalizeWidth(input.width);
-  const mode = chooseMode(width, input.diffData);
-  const lines = [header(input.diffData, mode, width)];
-  if (!input.expanded) return { mode, width, lines: clampLinesToWidth([...lines, hiddenHint(input.diffData.entries.length, hunkCount(input.diffData), width)], width) };
-  if (mode === "summary") return { mode, width, lines: clampLinesToWidth(lines, width) };
-  const rows = mode === "split" ? splitRows(input, width) : mode === "compact" ? compactRows(input, width) : unifiedRows(input, width);
-  return { mode, width, lines: [...lines, ...rows] };
-}

package/src/tui-render-utils.ts

@@ -1,286 +0,0 @@
-import { relative } from "node:path";
-import { pathToFileURL } from "node:url";
-
-import { getCapabilities, hyperlink, Text, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
-
-import { resolveToCwd } from "./path-utils.js";
-
-export const SUMMARY_PREFIX = "↳";
-export const EXPAND_HINT = " • Ctrl+O to expand";
-
-export type RendererTheme = {
-  fg(style: string, text: string): string;
-  bold(text: string): string;
-};
-
-export function renderToolLabel(theme: RendererTheme, label: string): string {
-  const boldFn = typeof theme.bold === "function" ? theme.bold.bind(theme) : (text: string) => text;
-  return theme.fg("toolTitle", boldFn(label));
-}
-
-export function linkToolPath(styledText: string, rawPath: string, cwd: string): string {
-  try {
-    if (!getCapabilities().hyperlinks) return styledText;
-    const absolutePath = resolveToCwd(rawPath, cwd);
-    return hyperlink(styledText, pathToFileURL(absolutePath).href);
-  } catch {
-    return styledText;
-  }
-}
-
-export function linkedPathLine(
-  theme: RendererTheme,
-  rawPath: string,
-  displayPath: string,
-  cwd: string,
-  suffix: string,
-  width: number | undefined,
-): string {
-  const pathWidth = width === undefined ? undefined : Math.max(1, width - 2 - visibleWidth(suffix));
-  const visiblePath = pathWidth === undefined ? displayPath : truncateToWidth(displayPath, pathWidth);
-  const linkedPath = linkToolPath(theme.fg("dim", visiblePath), rawPath, cwd);
-  return `  ${linkedPath}${theme.fg("dim", suffix)}`;
-}
-
-export function appendExpandHint(text: string, hidden: boolean): string {
-  return hidden ? `${text}${EXPAND_HINT}` : text;
-}
-
-export function summaryLine(
-  summary: string,
-  options: { hidden?: boolean; theme?: RendererTheme; style?: string } = {},
-): string {
-  const prefix = options.theme ? options.theme.fg(options.style ?? "dim", SUMMARY_PREFIX) : SUMMARY_PREFIX;
-  return appendExpandHint(`${prefix} ${summary}`, !!options.hidden);
-}
-
-export function isRendererExpanded(options?: { expanded?: boolean }, context?: { expanded?: boolean }): boolean {
-  return context?.expanded ?? options?.expanded ?? false;
-}
-
-export interface RenderResultContext {
-  isPartial: boolean;
-  isError: boolean;
-  expanded: boolean;
-  width: number | undefined;
-  cwd: string;
-  context: Record<string, any>;
-}
-
-/**
- * Resolve the shared render context for a tool's `renderResult`, which may
- * receive its context either as a trailing `rest[0]` argument or folded into
- * `options`. Returns the common flags plus the raw context object for callers
- * that need fields beyond the common set (e.g. `lastComponent`).
- */
-export function resolveRenderResultContext(options: any, rest: any[]): RenderResultContext {
-  const context = rest[0] ?? options ?? {};
-  return {
-    isPartial: context.isPartial ?? options?.isPartial ?? false,
-    isError: context.isError ?? false,
-    expanded: isRendererExpanded(options, context),
-    width: context.width ?? options?.width,
-    cwd: context.cwd ?? process.cwd(),
-    context,
-  };
-}
-
-export function normalizeWidth(width: unknown, fallback = 80): number {
-  return typeof width === "number" && Number.isFinite(width) && width > 0 ? Math.floor(width) : fallback;
-}
-
-export function clampLineToWidth(line: string, width: number | undefined): string {
-  if (width === undefined || width === null) return line;
-  const normalized = normalizeWidth(width);
-  return visibleWidth(line) <= normalized ? line : truncateToWidth(line, normalized);
-}
-
-export function clampLinesToWidth(lines: string[], width: number | undefined): string[] {
-  if (width === undefined || width === null) return lines;
-  return lines.map((line) => clampLineToWidth(line, width));
-}
-
-export interface WrapWithHangingIndentOptions {
-  /** Optional transform applied to each produced line (e.g. theme tinting). */
-  tint?: (text: string) => string;
-}
-
-/**
- * Wrap a single visual row that has a leading prefix (gutter, line number,
- * separator) such that continuation lines are indented to align with the
- * content column. Each produced line is clamped to `width`. If `tint` is
- * provided, it is applied to each output line so theme styling extends across
- * wrapped rows without leaking the prefix into the colored span.
- */
-export function wrapWithHangingIndent(
-  prefix: string,
-  content: string,
-  width: number | undefined,
-  options: WrapWithHangingIndentOptions = {},
-): string[] {
-  const tint = options.tint ?? ((text: string) => text);
-  if (width === undefined || width === null) return [tint(prefix + content)];
-  const normalized = normalizeWidth(width);
-  const combined = prefix + content;
-  if (visibleWidth(combined) <= normalized) return [tint(combined)];
-  const prefixWidth = visibleWidth(prefix);
-  const contentWidth = Math.max(1, normalized - prefixWidth);
-  const wrapped = wrapTextWithAnsi(content, contentWidth);
-  if (wrapped.length === 0) return [tint(clampLineToWidth(prefix, normalized))];
-  const indent = " ".repeat(prefixWidth);
-  return wrapped.map((line, index) =>
-    tint(clampLineToWidth(index === 0 ? prefix + line : indent + line, normalized)),
-  );
-}
-const HASHLINE_CONTENT_RE = /^(\d+:[0-9a-fA-F]+\|)(.*)$/;
-
-export function wrapReadHashlinesForWidth(text: string, width: number | undefined): string {
-  if (width === undefined || width === null) return text;
-  const normalized = normalizeWidth(width);
-  const output: string[] = [];
-  for (const line of text.split("\n")) {
-    const match = line.match(HASHLINE_CONTENT_RE);
-    if (!match) {
-      output.push(line);
-      continue;
-    }
-    if (visibleWidth(line) <= normalized) {
-      output.push(line);
-      continue;
-    }
-
-    const prefix = match[1]!;
-    const content = match[2] ?? "";
-    const prefixWidth = visibleWidth(prefix);
-    const contentWidth = Math.max(1, normalized - prefixWidth);
-    const wrappedContent = wrapTextWithAnsi(content, contentWidth).map((wrapped) => clampLineToWidth(wrapped, contentWidth));
-    if (wrappedContent.length === 0) {
-      output.push(clampLineToWidth(prefix, normalized));
-      continue;
-    }
-    output.push(clampLineToWidth(prefix + wrappedContent[0], normalized));
-    const indent = " ".repeat(prefixWidth);
-    for (const continuation of wrappedContent.slice(1)) {
-      output.push(clampLineToWidth(indent + continuation, normalized));
-    }
-  }
-  return output.join("\n");
-}
-
-const wrappedHashlinesCache = new WeakMap<object, { text: string; width: number | undefined; wrapped: string }>();
-
-/**
- * Memoized {@link wrapReadHashlinesForWidth} for render paths that re-run on
- * every TUI frame: the wrapped output is cached per result content object so
- * an expanded read result is only re-wrapped when its text or the terminal
- * width changes.
- */
-export function wrapReadHashlinesForWidthCached(
-  cacheKey: object,
-  text: string,
-  width: number | undefined,
-): string {
-  const cached = wrappedHashlinesCache.get(cacheKey);
-  if (cached && cached.text === text && cached.width === width) return cached.wrapped;
-  const wrapped = wrapReadHashlinesForWidth(text, width);
-  wrappedHashlinesCache.set(cacheKey, { text, width, wrapped });
-  return wrapped;
-}
-
-/**
- * Render the `isPartial` placeholder line shared by every tool's `renderResult`.
- */
-export function renderPendingResult(pendingLabel: string, width: number | undefined, theme?: RendererTheme): Text {
-  return new Text(clampLinesToWidth([summaryLine(pendingLabel, { theme, style: "muted" })], width).join("\n"), 0, 0);
-}
-
-/**
- * Render a tool result error: the first line of `textContent`, or its full body
- * when expanded, prefixed and clamped to width. Tools pass their own `fallback`
- * for the empty-content case.
- */
-export function renderErrorResult(
-  textContent: string,
-  options: { expanded: boolean; width: number | undefined; fallback?: string; theme?: RendererTheme },
-): Text {
-  const firstLine = textContent.split("\n")[0] || (options.fallback ?? "Error");
-  const body = options.expanded && textContent ? textContent : firstLine;
-  return new Text(
-    clampLinesToWidth(summaryLine(body, { theme: options.theme, style: "error" }).split("\n"), options.width).join("\n"),
-    0,
-    0,
-  );
-}
-
-export interface AnchoredFilesLabels {
-  pendingLabel: string;
-  emptyLabel: string;
-  unitSingular: string;
-  unitPlural: string;
-}
-
-/**
- * Render the call line shared by the readseek search tools (search, refs): a
- * tool label, an accent term, the search path, an optional language hint, and
- * the active boolean flags. Falsy {@link opts.flags} entries are dropped.
- */
-export function renderReadSeekSearchCall(
-  args: { path?: string; lang?: string },
-  theme: RendererTheme,
-  rest: any[],
-  opts: { label: string; accent: string; flags: Array<string | false | undefined> },
-): Text {
-  const context = rest[0] ?? {};
-  let text = `${renderToolLabel(theme, opts.label)} ${theme.fg("accent", opts.accent)}`;
-  text += theme.fg("dim", ` in ${args.path ?? "."}`);
-  if (args.lang) text += theme.fg("dim", ` (${args.lang})`);
-  const flags = opts.flags.filter(Boolean);
-  if (flags.length > 0) text += theme.fg("dim", ` [${flags.join(",")}]`);
-  return new Text(clampLineToWidth(text, context.width), 0, 0);
-}
-
-/**
- * Render the result summary shared by the anchored-files search tools (search,
- * refs): a pending line, an error first-line/expanded body, an empty-result
- * line, or a `<count> <unit> in <n> files` summary with an expandable per-file
- * list. The four call-site differences are supplied via {@link labels}.
- */
-export function renderAnchoredFilesResult(
-  result: any,
-  options: any,
-  theme: RendererTheme,
-  rest: any[],
-  labels: AnchoredFilesLabels,
-): Text {
-  const { isPartial, isError, expanded, cwd, width } = resolveRenderResultContext(options, rest);
-
-  if (isPartial) return renderPendingResult(labels.pendingLabel, width, theme);
-
-  const content = result.content?.[0];
-  const textContent = content?.type === "text" ? content.text : "";
-  if (isError || result.isError) return renderErrorResult(textContent, { expanded, width, theme });
-
-  const readSeekValue = (result.details as any)?.readSeekValue as
-    | { files: Array<{ path: string; lines: any[] }> }
-    | undefined;
-  const files = readSeekValue?.files ?? [];
-  if (files.length === 0) return new Text(summaryLine(labels.emptyLabel, { theme, style: "dim" }), 0, 0);
-
-  const fileCount = files.length;
-  const total = files.reduce((sum: number, f: any) => sum + f.lines.length, 0);
-  const unitWord = total === 1 ? labels.unitSingular : labels.unitPlural;
-  const fileWord = fileCount === 1 ? "file" : "files";
-  let text = summaryLine(`${total} ${unitWord} in ${fileCount} ${fileWord}`, {
-    hidden: !expanded,
-    theme,
-    style: "success",
-  });
-  if (expanded) {
-    for (const file of files.slice(0, 20)) {
-      const display = relative(cwd, file.path) || file.path;
-      text += `\n${linkedPathLine(theme, file.path, display, cwd, ` (${file.lines.length})`, width)}`;
-    }
-    if (files.length > 20) text += "\n" + theme.fg("muted", `  … and ${files.length - 20} more files`);
-  }
-  return new Text(clampLinesToWidth(text.split("\n"), width).join("\n"), 0, 0);
-}