@greppleai/grip 0.0.0-stage → 0.0.1

package/dist/core/tools/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/core/tools/read.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,4BAA4B,CAAC;AAI7E,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAM5C,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,wBAAwB,CAAC;AAItF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAItD,OAAO,EAAoD,KAAK,gBAAgB,EAAgB,MAAM,eAAe,CAAC;AAEtH,QAAA,MAAM,UAAU;;;;EAId,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC/B,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAWD,MAAM,WAAW,2BAA2B;IAC3C,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,cAAc,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,2BAA2B,CAAC;AAE9E,KAAK,0BAA0B,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,kBAAkB,GAAG,SAAS,CAAC;AAE3F,MAAM,WAAW,eAAe;IAC/B,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qHAAqH;IACrH,iBAAiB,CAAC,EAAE,0BAA0B,CAAC;CAC/C;AAoUD,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,OAAO,UAAU,EAAE,eAAe,GAAG,SAAS,CAAC,CAAC;AAEhG,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,kBAAkB,CAgDlH;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,OAAO,UAAU,CAAC,CAElH","sourcesContent":["import { basename, dirname, isAbsolute, relative, resolve as resolvePath, sep } from \"node:path\";\nimport type { AgentTool, AgentToolResult } from \"@greppleai/grip-agent-core\";\nimport type { Api, Model } from \"@greppleai/grip-ai\";\nimport { Text } from \"@greppleai/grip-tui\";\n\nimport { type Static, Type } from \"typebox\";\nimport { getReadmePath } from \"../../config.ts\";\nimport { keyHint, keyText } from \"../../modes/interactive/components/keybinding-hints.ts\";\nimport { getLanguageFromPath, highlightCode, type Theme } from \"../../modes/interactive/theme/theme.ts\";\nimport { processImage } from \"../../utils/image-process.ts\";\nimport { formatPathRelativeToCwdOrAbsolute } from \"../../utils/paths.ts\";\nimport type { ToolDefinition, ToolRenderResultOptions } from \"../extensions/types.ts\";\nimport { fmtRegion } from \"./hashline/apply.ts\";\nimport { HASH_SEP, initHasher, lineHashes } from \"./hashline/hash.ts\";\nimport { visLines as hashlineVisLines } from \"./hashline-utils.ts\";\nimport type { ToolOperations } from \"./operations.ts\";\nimport { resolveReadPathAsync, resolveToCwd } from \"./path-utils.ts\";\nimport { formatBackendIcon, getTextOutput, invalidArgText, replaceTabs, shortenPath, str } from \"./render-utils.ts\";\nimport { wrapToolDefinition } from \"./tool-definition-wrapper.ts\";\nimport { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, type TruncationResult, truncateHead } from \"./truncate.ts\";\n\nconst readSchema = Type.Object({\n\tpath: Type.String({ description: \"Path to the file to read (relative or absolute)\" }),\n\toffset: Type.Optional(Type.Number({ description: \"Line number to start reading from (1-indexed)\" })),\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of lines to read\" })),\n});\n\nexport type ReadToolInput = Static<typeof readSchema>;\n\nexport interface ReadToolDetails {\n\ttruncation?: TruncationResult;\n}\n\ntype CompactReadClassificationKind = \"docs\" | \"resource\" | \"skill\" | \"rule\";\n\ninterface CompactReadClassification {\n\tkind: CompactReadClassificationKind;\n\tlabel: string;\n}\n\nconst COMPACT_RESOURCE_FILE_NAMES = new Set([\"AGENTS.override.md\", \"AGENTS.md\", \"AGENTS.MD\", \"CLAUDE.md\", \"CLAUDE.MD\"]);\n\nexport interface ReadToolOperationsSelection {\n\tkind: \"selection\";\n\toperations: ToolOperations;\n\tpath: string;\n}\n\nexport type ReadToolOperations = ToolOperations | ReadToolOperationsSelection;\n\ntype ReadToolOperationsSelector = (absolutePath: string) => ReadToolOperations | undefined;\n\nexport interface ReadToolOptions {\n\t/** Whether to auto-resize images to 2000x2000 max. Default: true */\n\tautoResizeImages?: boolean;\n\t/** Select a backend, and optionally a canonical path, for a resolved absolute path. Defaults to the tool backend. */\n\toperationsForPath?: ReadToolOperationsSelector;\n}\n\nfunction isReadToolOperationsSelection(value: ReadToolOperations): value is ReadToolOperationsSelection {\n\treturn \"kind\" in value && value.kind === \"selection\";\n}\n\nfunction getReadToolOperations(value: ReadToolOperations | undefined): ToolOperations | undefined {\n\treturn value && isReadToolOperationsSelection(value) ? value.operations : value;\n}\n\ntype ReadRenderArgs = { path?: string; file_path?: string; offset?: number; limit?: number };\n\nfunction formatReadLineRange(args: ReadRenderArgs | undefined, theme: Theme): string {\n\tif (args?.offset === undefined && args?.limit === undefined) return \"\";\n\tconst startLine = args.offset ?? 1;\n\tconst endLine = args.limit !== undefined ? startLine + args.limit - 1 : \"\";\n\treturn theme.fg(\"warning\", `:${startLine}${endLine ? `-${endLine}` : \"\"}`);\n}\n\nfunction formatReadCall(args: ReadRenderArgs | undefined, theme: Theme): string {\n\tconst rawPath = str(args?.file_path ?? args?.path);\n\tconst path = rawPath !== null ? shortenPath(rawPath) : null;\n\tconst invalidArg = invalidArgText(theme);\n\tconst pathDisplay = path === null ? invalidArg : path ? theme.fg(\"accent\", path) : theme.fg(\"toolOutput\", \"...\");\n\treturn `${theme.fg(\"toolTitle\", theme.bold(\"read\"))} ${pathDisplay}${formatReadLineRange(args, theme)}`;\n}\n\nfunction trimTrailingEmptyLines(lines: string[]): string[] {\n\tlet end = lines.length;\n\twhile (end > 0 && lines[end - 1] === \"\") {\n\t\tend--;\n\t}\n\treturn lines.slice(0, end);\n}\n\nfunction getNonVisionImageNote(model: Model<Api> | undefined): string | undefined {\n\tif (!model || model.input.includes(\"image\")) {\n\t\treturn undefined;\n\t}\n\treturn \"[Current model does not support images. The image will be omitted from this request.]\";\n}\n\nfunction toPosixPath(filePath: string): string {\n\treturn filePath.split(sep).join(\"/\");\n}\n\nfunction getGripDocsClassification(absolutePath: string): CompactReadClassification | undefined {\n\tconst packageRoot = dirname(getReadmePath());\n\tconst relativePath = relative(resolvePath(packageRoot), resolvePath(absolutePath));\n\tif (\n\t\trelativePath === \"\" ||\n\t\trelativePath === \"..\" ||\n\t\trelativePath.startsWith(`..${sep}`) ||\n\t\tisAbsolute(relativePath)\n\t) {\n\t\treturn undefined;\n\t}\n\n\tconst label = toPosixPath(relativePath);\n\tif (label === \"README.md\" || label.startsWith(\"docs/\") || label.startsWith(\"examples/\")) {\n\t\treturn { kind: \"docs\", label };\n\t}\n\treturn undefined;\n}\n\nfunction getCompactReadClassification(\n\targs: ReadRenderArgs | undefined,\n\tcwd: string,\n): CompactReadClassification | undefined {\n\tconst rawPath = str(args?.file_path ?? args?.path);\n\tif (!rawPath) return undefined;\n\n\tconst absolutePath = resolveToCwd(rawPath, cwd);\n\tconst fileName = basename(absolutePath);\n\tif (fileName === \"SKILL.md\") {\n\t\treturn { kind: \"skill\", label: basename(dirname(absolutePath)) || fileName };\n\t}\n\tif (fileName === \"RULES.md\") {\n\t\treturn { kind: \"rule\", label: basename(dirname(absolutePath)) || fileName };\n\t}\n\n\tconst docsClassification = getGripDocsClassification(absolutePath);\n\tif (docsClassification) return docsClassification;\n\n\tif (COMPACT_RESOURCE_FILE_NAMES.has(fileName)) {\n\t\treturn { kind: \"resource\", label: formatPathRelativeToCwdOrAbsolute(absolutePath, cwd) };\n\t}\n\n\treturn undefined;\n}\n\nfunction formatCompactReadCall(\n\tclassification: CompactReadClassification,\n\targs: ReadRenderArgs | undefined,\n\ttheme: Theme,\n): string {\n\tconst expandHint = theme.fg(\"dim\", ` (${keyText(\"app.tools.expand\")} to expand)`);\n\tif (classification.kind === \"skill\" || classification.kind === \"rule\") {\n\t\tconst label = classification.kind === \"skill\" ? \"skill\" : \"rule\";\n\t\treturn (\n\t\t\ttheme.fg(\"customMessageLabel\", `\\x1b[1m[${label}]\\x1b[22m `) +\n\t\t\ttheme.fg(\"customMessageText\", classification.label) +\n\t\t\tformatReadLineRange(args, theme) +\n\t\t\texpandHint\n\t\t);\n\t}\n\n\treturn (\n\t\ttheme.fg(\"toolTitle\", theme.bold(`read ${classification.kind}`)) +\n\t\t\" \" +\n\t\ttheme.fg(\"accent\", classification.label) +\n\t\tformatReadLineRange(args, theme) +\n\t\texpandHint\n\t);\n}\n\nfunction formatReadTruncationWarning(truncation: TruncationResult | undefined, theme: Theme): string {\n\tif (!truncation?.truncated) return \"\";\n\tif (truncation.firstLineExceedsLimit) {\n\t\treturn `\\n${theme.fg(\"warning\", `[First line exceeds ${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit]`)}`;\n\t}\n\tif (truncation.truncatedBy === \"lines\") {\n\t\treturn `\\n${theme.fg(\"warning\", `[Truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines (${truncation.maxLines ?? DEFAULT_MAX_LINES} line limit)]`)}`;\n\t}\n\treturn `\\n${theme.fg(\"warning\", `[Truncated: ${truncation.outputLines} lines shown (${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit)]`)}`;\n}\n\nfunction formatReadResult(\n\targs: ReadRenderArgs | undefined,\n\tresult: AgentToolResult<ReadToolDetails | undefined>,\n\toptions: ToolRenderResultOptions,\n\ttheme: Theme,\n\tshowImages: boolean,\n\tcwd: string,\n\tisError: boolean,\n): string {\n\tif (!options.expanded && !isError && getCompactReadClassification(args, cwd)) {\n\t\treturn \"\";\n\t}\n\n\tconst rawPath = str(args?.file_path ?? args?.path);\n\tconst output = getTextOutput(result, showImages);\n\tconst lang = rawPath ? getLanguageFromPath(rawPath) : undefined;\n\tconst renderedLines = lang ? highlightCode(replaceTabs(output), lang) : output.split(\"\\n\");\n\tconst lines = trimTrailingEmptyLines(renderedLines);\n\tconst maxLines = options.expanded ? lines.length : 10;\n\tconst displayLines = lines.slice(0, maxLines);\n\tconst remaining = lines.length - maxLines;\n\tlet text = `\\n${displayLines.map((line) => (lang ? replaceTabs(line) : theme.fg(\"toolOutput\", replaceTabs(line)))).join(\"\\n\")}`;\n\tif (remaining > 0) {\n\t\ttext += `${theme.fg(\"muted\", `\\n... (${remaining} more lines,`)} ${keyHint(\"app.tools.expand\", \"to expand\")})`;\n\t}\n\n\ttext += formatReadTruncationWarning(result.details?.truncation, theme);\n\treturn text;\n}\n\ninterface ResolvedReadTarget {\n\toperations: ToolOperations;\n\tpath: string;\n}\n\ninterface ReadExecutionOptions {\n\tinput: ReadToolInput;\n\tdefaultOperations: ToolOperations;\n\tcwd: string;\n\toperationsForPath: ReadToolOperationsSelector | undefined;\n\tautoResizeImages: boolean;\n\tmodel: Model<Api> | undefined;\n\tsignal: AbortSignal | undefined;\n}\n\ninterface TextReadOutputOptions {\n\ttruncation: TruncationResult;\n\tallLines: string[];\n\tstartLine: number;\n\tstartLineDisplay: number;\n\tendLine: number;\n\ttotalFileLines: number;\n}\n\nasync function resolveReadTarget(options: ReadExecutionOptions): Promise<ResolvedReadTarget> {\n\tconst absolutePath = await resolveReadPathAsync(options.input.path, options.cwd);\n\tconst selection = options.operationsForPath?.(absolutePath);\n\treturn {\n\t\toperations: getReadToolOperations(selection) ?? options.defaultOperations,\n\t\tpath: selection && isReadToolOperationsSelection(selection) ? selection.path : absolutePath,\n\t};\n}\n\nasync function readImageFile(\n\toperations: ToolOperations,\n\tpath: string,\n\tmimeType: string,\n\tautoResizeImages: boolean,\n\tnonVisionImageNote: string | undefined,\n): Promise<AgentToolResult<ReadToolDetails | undefined>> {\n\tconst buffer = await operations.readFile(path);\n\tconst processed = await processImage(buffer, mimeType, { autoResizeImages });\n\tif (!processed.ok) {\n\t\tlet text = `Read image file [${mimeType}]\\n${processed.message}`;\n\t\tif (nonVisionImageNote) text += `\\n${nonVisionImageNote}`;\n\t\treturn { content: [{ type: \"text\", text }], details: undefined };\n\t}\n\tlet text = `Read image file [${processed.mimeType}]`;\n\tif (processed.hints.length > 0) text += `\\n${processed.hints.join(\"\\n\")}`;\n\tif (nonVisionImageNote) text += `\\n${nonVisionImageNote}`;\n\treturn {\n\t\tcontent: [\n\t\t\t{ type: \"text\", text },\n\t\t\t{ type: \"image\", data: processed.data, mimeType: processed.mimeType },\n\t\t],\n\t\tdetails: undefined,\n\t};\n}\n\nfunction formatTextReadOutput(options: TextReadOutputOptions): AgentToolResult<ReadToolDetails | undefined> {\n\tconst { truncation } = options;\n\tlet text: string;\n\tlet details: ReadToolDetails | undefined;\n\tif (truncation.firstLineExceedsLimit) {\n\t\tconst firstLineSize = formatSize(Buffer.byteLength(options.allLines[options.startLine] ?? \"\", \"utf-8\"));\n\t\ttext = `[Line ${options.startLineDisplay} is ${firstLineSize}, exceeds ${formatSize(DEFAULT_MAX_BYTES)} limit. Hashline output requires full lines; use bash for this line.]`;\n\t\tdetails = { truncation };\n\t} else if (truncation.truncated) {\n\t\tconst endLineDisplay = options.startLineDisplay + truncation.outputLines - 1;\n\t\tconst nextOffset = endLineDisplay + 1;\n\t\ttext = truncation.content;\n\t\tif (truncation.truncatedBy === \"lines\") {\n\t\t\ttext += `\\n\\n[Showing lines ${options.startLineDisplay}-${endLineDisplay} of ${options.totalFileLines}. Use offset=${nextOffset} to continue.]`;\n\t\t} else {\n\t\t\ttext += `\\n\\n[Showing lines ${options.startLineDisplay}-${endLineDisplay} of ${options.totalFileLines} (${formatSize(DEFAULT_MAX_BYTES)} limit). Use offset=${nextOffset} to continue.]`;\n\t\t}\n\t\tdetails = { truncation };\n\t} else if (options.endLine < options.totalFileLines) {\n\t\tconst remaining = options.totalFileLines - options.endLine;\n\t\ttext = `${truncation.content}\\n\\n[${remaining} more lines in file. Use offset=${options.endLine + 1} to continue.]`;\n\t} else {\n\t\ttext = truncation.content;\n\t}\n\treturn { content: [{ type: \"text\", text }], details };\n}\n\nasync function readTextFile(\n\toperations: ToolOperations,\n\tpath: string,\n\toffset: number | undefined,\n\tlimit: number | undefined,\n): Promise<AgentToolResult<ReadToolDetails | undefined>> {\n\tawait initHasher();\n\tconst buffer = await operations.readFile(path);\n\tconst textContent = buffer.toString(\"utf-8\").replace(/\\r\\n/g, \"\\n\").replace(/\\r/g, \"\\n\");\n\tconst allLines = hashlineVisLines(textContent);\n\tconst totalFileLines = allLines.length;\n\tconst startLine = offset ? Math.max(0, offset - 1) : 0;\n\tconst startLineDisplay = startLine + 1;\n\tif (totalFileLines === 0) {\n\t\tif (startLineDisplay !== 1) throw new Error(`Offset ${offset} is beyond end of file (0 lines total)`);\n\t\tconst emptyHash = (await lineHashes(textContent, path))[0] ?? \"\";\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: `${emptyHash}${HASH_SEP}\\n[File is empty. Use edit to insert content.]` }],\n\t\t\tdetails: undefined,\n\t\t};\n\t}\n\tif (startLine >= totalFileLines) {\n\t\tthrow new Error(`Offset ${offset} is beyond end of file (${totalFileLines} lines total)`);\n\t}\n\tconst endLine = limit !== undefined ? Math.min(startLine + limit, totalFileLines) : totalFileLines;\n\tconst allHashes = await lineHashes(textContent, path);\n\tconst selectedContent = fmtRegion(allHashes.slice(startLine, endLine), allLines.slice(startLine, endLine));\n\treturn formatTextReadOutput({\n\t\ttruncation: truncateHead(selectedContent),\n\t\tallLines,\n\t\tstartLine,\n\t\tstartLineDisplay,\n\t\tendLine,\n\t\ttotalFileLines,\n\t});\n}\n\nasync function executeReadRequest(\n\toptions: ReadExecutionOptions,\n\tisAborted: () => boolean,\n): Promise<AgentToolResult<ReadToolDetails | undefined> | undefined> {\n\tconst target = await resolveReadTarget(options);\n\tif (isAborted()) return undefined;\n\tawait target.operations.access(target.path, \"read\");\n\tif (isAborted()) return undefined;\n\tconst mimeType = target.operations.detectImageMimeType\n\t\t? await target.operations.detectImageMimeType(target.path)\n\t\t: undefined;\n\tconst nonVisionImageNote = getNonVisionImageNote(options.model);\n\tconst result = mimeType\n\t\t? await readImageFile(target.operations, target.path, mimeType, options.autoResizeImages, nonVisionImageNote)\n\t\t: await readTextFile(target.operations, target.path, options.input.offset, options.input.limit);\n\treturn isAborted() ? undefined : result;\n}\n\nfunction executeAbortableRead(options: ReadExecutionOptions): Promise<AgentToolResult<ReadToolDetails | undefined>> {\n\treturn new Promise((resolve, reject) => {\n\t\tif (options.signal?.aborted) {\n\t\t\treject(new Error(\"Operation aborted\"));\n\t\t\treturn;\n\t\t}\n\t\tlet aborted = false;\n\t\tconst onAbort = () => {\n\t\t\taborted = true;\n\t\t\treject(new Error(\"Operation aborted\"));\n\t\t};\n\t\toptions.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\t\tvoid executeReadRequest(options, () => aborted).then(\n\t\t\t(result) => {\n\t\t\t\tif (result === undefined) return;\n\t\t\t\toptions.signal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\tresolve(result);\n\t\t\t},\n\t\t\t(error) => {\n\t\t\t\toptions.signal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\tif (!aborted) reject(error);\n\t\t\t},\n\t\t);\n\t});\n}\n\nexport type ReadToolDefinition = ToolDefinition<typeof readSchema, ReadToolDetails | undefined>;\n\nexport function createReadToolDefinition(operations: ToolOperations, options?: ReadToolOptions): ReadToolDefinition {\n\tconst autoResizeImages = options?.autoResizeImages ?? true;\n\tconst ops = operations;\n\tconst cwd = operations.cwd;\n\tconst operationsForPath = options?.operationsForPath;\n\treturn {\n\t\tname: \"read\",\n\t\tlabel: \"read\",\n\t\tdescription: `Read the contents of a file. Supports text files and images (jpg, png, gif, webp). Images are sent as attachments. Text files are returned as HASH│content rows for hash-anchored editing. Output is truncated to ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). Use offset/limit for large files. When you need the full file, continue with offset until complete.`,\n\t\tpromptSnippet: \"Read file contents with hashline anchors\",\n\t\tpromptGuidelines: [\n\t\t\t\"Use read to examine files instead of cat or sed.\",\n\t\t\t\"For edits, copy only the 3-character HASH values into edit hash_range_inclusive; do not include HASH│ prefixes in content_lines.\",\n\t\t],\n\t\tparameters: readSchema,\n\t\tasync execute(_toolCallId, input: ReadToolInput, signal?: AbortSignal, _onUpdate?, ctx?) {\n\t\t\treturn executeAbortableRead({\n\t\t\t\tinput,\n\t\t\t\tdefaultOperations: ops,\n\t\t\t\tcwd,\n\t\t\t\toperationsForPath,\n\t\t\t\tautoResizeImages,\n\t\t\t\tmodel: ctx?.model,\n\t\t\t\tsignal,\n\t\t\t});\n\t\t},\n\t\trenderCall(args, theme, context) {\n\t\t\tconst text = (context.lastComponent as Text | undefined) ?? new Text(\"\", 0, 0);\n\t\t\tconst classification = !context.expanded ? getCompactReadClassification(args, context.cwd) : undefined;\n\t\t\tconst renderArgs = args as ReadRenderArgs | undefined;\n\t\t\tconst rawPath = str(renderArgs?.file_path ?? renderArgs?.path);\n\t\t\tconst displayOps = rawPath\n\t\t\t\t? (getReadToolOperations(operationsForPath?.(resolveToCwd(rawPath, cwd))) ?? ops)\n\t\t\t\t: ops;\n\t\t\ttext.setText(\n\t\t\t\tformatBackendIcon(displayOps.getBackendInfo?.(), theme) +\n\t\t\t\t\t(classification ? formatCompactReadCall(classification, args, theme) : formatReadCall(args, theme)),\n\t\t\t);\n\t\t\treturn text;\n\t\t},\n\t\trenderResult(result, options, theme, context) {\n\t\t\tconst text = (context.lastComponent as Text | undefined) ?? new Text(\"\", 0, 0);\n\t\t\ttext.setText(\n\t\t\t\tformatReadResult(context.args, result, options, theme, context.showImages, context.cwd, context.isError),\n\t\t\t);\n\t\t\treturn text;\n\t\t},\n\t};\n}\n\nexport function createReadTool(operations: ToolOperations, options?: ReadToolOptions): AgentTool<typeof readSchema> {\n\treturn wrapToolDefinition(createReadToolDefinition(operations, options));\n}\n"]}

package/dist/core/tools/read.js

@@ -0,0 +1,318 @@
+import { basename, dirname, isAbsolute, relative, resolve as resolvePath, sep } from "node:path";
+import { Text } from "@greppleai/grip-tui";
+import { Type } from "typebox";
+import { getReadmePath } from "../../config.js";
+import { keyHint, keyText } from "../../modes/interactive/components/keybinding-hints.js";
+import { getLanguageFromPath, highlightCode } from "../../modes/interactive/theme/theme.js";
+import { processImage } from "../../utils/image-process.js";
+import { formatPathRelativeToCwdOrAbsolute } from "../../utils/paths.js";
+import { fmtRegion } from "./hashline/apply.js";
+import { HASH_SEP, initHasher, lineHashes } from "./hashline/hash.js";
+import { visLines as hashlineVisLines } from "./hashline-utils.js";
+import { resolveReadPathAsync, resolveToCwd } from "./path-utils.js";
+import { formatBackendIcon, getTextOutput, invalidArgText, replaceTabs, shortenPath, str } from "./render-utils.js";
+import { wrapToolDefinition } from "./tool-definition-wrapper.js";
+import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, truncateHead } from "./truncate.js";
+const readSchema = Type.Object({
+    path: Type.String({ description: "Path to the file to read (relative or absolute)" }),
+    offset: Type.Optional(Type.Number({ description: "Line number to start reading from (1-indexed)" })),
+    limit: Type.Optional(Type.Number({ description: "Maximum number of lines to read" })),
+});
+const COMPACT_RESOURCE_FILE_NAMES = new Set(["AGENTS.override.md", "AGENTS.md", "AGENTS.MD", "CLAUDE.md", "CLAUDE.MD"]);
+function isReadToolOperationsSelection(value) {
+    return "kind" in value && value.kind === "selection";
+}
+function getReadToolOperations(value) {
+    return value && isReadToolOperationsSelection(value) ? value.operations : value;
+}
+function formatReadLineRange(args, theme) {
+    if (args?.offset === undefined && args?.limit === undefined)
+        return "";
+    const startLine = args.offset ?? 1;
+    const endLine = args.limit !== undefined ? startLine + args.limit - 1 : "";
+    return theme.fg("warning", `:${startLine}${endLine ? `-${endLine}` : ""}`);
+}
+function formatReadCall(args, theme) {
+    const rawPath = str(args?.file_path ?? args?.path);
+    const path = rawPath !== null ? shortenPath(rawPath) : null;
+    const invalidArg = invalidArgText(theme);
+    const pathDisplay = path === null ? invalidArg : path ? theme.fg("accent", path) : theme.fg("toolOutput", "...");
+    return `${theme.fg("toolTitle", theme.bold("read"))} ${pathDisplay}${formatReadLineRange(args, theme)}`;
+}
+function trimTrailingEmptyLines(lines) {
+    let end = lines.length;
+    while (end > 0 && lines[end - 1] === "") {
+        end--;
+    }
+    return lines.slice(0, end);
+}
+function getNonVisionImageNote(model) {
+    if (!model || model.input.includes("image")) {
+        return undefined;
+    }
+    return "[Current model does not support images. The image will be omitted from this request.]";
+}
+function toPosixPath(filePath) {
+    return filePath.split(sep).join("/");
+}
+function getGripDocsClassification(absolutePath) {
+    const packageRoot = dirname(getReadmePath());
+    const relativePath = relative(resolvePath(packageRoot), resolvePath(absolutePath));
+    if (relativePath === "" ||
+        relativePath === ".." ||
+        relativePath.startsWith(`..${sep}`) ||
+        isAbsolute(relativePath)) {
+        return undefined;
+    }
+    const label = toPosixPath(relativePath);
+    if (label === "README.md" || label.startsWith("docs/") || label.startsWith("examples/")) {
+        return { kind: "docs", label };
+    }
+    return undefined;
+}
+function getCompactReadClassification(args, cwd) {
+    const rawPath = str(args?.file_path ?? args?.path);
+    if (!rawPath)
+        return undefined;
+    const absolutePath = resolveToCwd(rawPath, cwd);
+    const fileName = basename(absolutePath);
+    if (fileName === "SKILL.md") {
+        return { kind: "skill", label: basename(dirname(absolutePath)) || fileName };
+    }
+    if (fileName === "RULES.md") {
+        return { kind: "rule", label: basename(dirname(absolutePath)) || fileName };
+    }
+    const docsClassification = getGripDocsClassification(absolutePath);
+    if (docsClassification)
+        return docsClassification;
+    if (COMPACT_RESOURCE_FILE_NAMES.has(fileName)) {
+        return { kind: "resource", label: formatPathRelativeToCwdOrAbsolute(absolutePath, cwd) };
+    }
+    return undefined;
+}
+function formatCompactReadCall(classification, args, theme) {
+    const expandHint = theme.fg("dim", ` (${keyText("app.tools.expand")} to expand)`);
+    if (classification.kind === "skill" || classification.kind === "rule") {
+        const label = classification.kind === "skill" ? "skill" : "rule";
+        return (theme.fg("customMessageLabel", `\x1b[1m[${label}]\x1b[22m `) +
+            theme.fg("customMessageText", classification.label) +
+            formatReadLineRange(args, theme) +
+            expandHint);
+    }
+    return (theme.fg("toolTitle", theme.bold(`read ${classification.kind}`)) +
+        " " +
+        theme.fg("accent", classification.label) +
+        formatReadLineRange(args, theme) +
+        expandHint);
+}
+function formatReadTruncationWarning(truncation, theme) {
+    if (!truncation?.truncated)
+        return "";
+    if (truncation.firstLineExceedsLimit) {
+        return `\n${theme.fg("warning", `[First line exceeds ${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit]`)}`;
+    }
+    if (truncation.truncatedBy === "lines") {
+        return `\n${theme.fg("warning", `[Truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines (${truncation.maxLines ?? DEFAULT_MAX_LINES} line limit)]`)}`;
+    }
+    return `\n${theme.fg("warning", `[Truncated: ${truncation.outputLines} lines shown (${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit)]`)}`;
+}
+function formatReadResult(args, result, options, theme, showImages, cwd, isError) {
+    if (!options.expanded && !isError && getCompactReadClassification(args, cwd)) {
+        return "";
+    }
+    const rawPath = str(args?.file_path ?? args?.path);
+    const output = getTextOutput(result, showImages);
+    const lang = rawPath ? getLanguageFromPath(rawPath) : undefined;
+    const renderedLines = lang ? highlightCode(replaceTabs(output), lang) : output.split("\n");
+    const lines = trimTrailingEmptyLines(renderedLines);
+    const maxLines = options.expanded ? lines.length : 10;
+    const displayLines = lines.slice(0, maxLines);
+    const remaining = lines.length - maxLines;
+    let text = `\n${displayLines.map((line) => (lang ? replaceTabs(line) : theme.fg("toolOutput", replaceTabs(line)))).join("\n")}`;
+    if (remaining > 0) {
+        text += `${theme.fg("muted", `\n... (${remaining} more lines,`)} ${keyHint("app.tools.expand", "to expand")})`;
+    }
+    text += formatReadTruncationWarning(result.details?.truncation, theme);
+    return text;
+}
+async function resolveReadTarget(options) {
+    const absolutePath = await resolveReadPathAsync(options.input.path, options.cwd);
+    const selection = options.operationsForPath?.(absolutePath);
+    return {
+        operations: getReadToolOperations(selection) ?? options.defaultOperations,
+        path: selection && isReadToolOperationsSelection(selection) ? selection.path : absolutePath,
+    };
+}
+async function readImageFile(operations, path, mimeType, autoResizeImages, nonVisionImageNote) {
+    const buffer = await operations.readFile(path);
+    const processed = await processImage(buffer, mimeType, { autoResizeImages });
+    if (!processed.ok) {
+        let text = `Read image file [${mimeType}]\n${processed.message}`;
+        if (nonVisionImageNote)
+            text += `\n${nonVisionImageNote}`;
+        return { content: [{ type: "text", text }], details: undefined };
+    }
+    let text = `Read image file [${processed.mimeType}]`;
+    if (processed.hints.length > 0)
+        text += `\n${processed.hints.join("\n")}`;
+    if (nonVisionImageNote)
+        text += `\n${nonVisionImageNote}`;
+    return {
+        content: [
+            { type: "text", text },
+            { type: "image", data: processed.data, mimeType: processed.mimeType },
+        ],
+        details: undefined,
+    };
+}
+function formatTextReadOutput(options) {
+    const { truncation } = options;
+    let text;
+    let details;
+    if (truncation.firstLineExceedsLimit) {
+        const firstLineSize = formatSize(Buffer.byteLength(options.allLines[options.startLine] ?? "", "utf-8"));
+        text = `[Line ${options.startLineDisplay} is ${firstLineSize}, exceeds ${formatSize(DEFAULT_MAX_BYTES)} limit. Hashline output requires full lines; use bash for this line.]`;
+        details = { truncation };
+    }
+    else if (truncation.truncated) {
+        const endLineDisplay = options.startLineDisplay + truncation.outputLines - 1;
+        const nextOffset = endLineDisplay + 1;
+        text = truncation.content;
+        if (truncation.truncatedBy === "lines") {
+            text += `\n\n[Showing lines ${options.startLineDisplay}-${endLineDisplay} of ${options.totalFileLines}. Use offset=${nextOffset} to continue.]`;
+        }
+        else {
+            text += `\n\n[Showing lines ${options.startLineDisplay}-${endLineDisplay} of ${options.totalFileLines} (${formatSize(DEFAULT_MAX_BYTES)} limit). Use offset=${nextOffset} to continue.]`;
+        }
+        details = { truncation };
+    }
+    else if (options.endLine < options.totalFileLines) {
+        const remaining = options.totalFileLines - options.endLine;
+        text = `${truncation.content}\n\n[${remaining} more lines in file. Use offset=${options.endLine + 1} to continue.]`;
+    }
+    else {
+        text = truncation.content;
+    }
+    return { content: [{ type: "text", text }], details };
+}
+async function readTextFile(operations, path, offset, limit) {
+    await initHasher();
+    const buffer = await operations.readFile(path);
+    const textContent = buffer.toString("utf-8").replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+    const allLines = hashlineVisLines(textContent);
+    const totalFileLines = allLines.length;
+    const startLine = offset ? Math.max(0, offset - 1) : 0;
+    const startLineDisplay = startLine + 1;
+    if (totalFileLines === 0) {
+        if (startLineDisplay !== 1)
+            throw new Error(`Offset ${offset} is beyond end of file (0 lines total)`);
+        const emptyHash = (await lineHashes(textContent, path))[0] ?? "";
+        return {
+            content: [{ type: "text", text: `${emptyHash}${HASH_SEP}\n[File is empty. Use edit to insert content.]` }],
+            details: undefined,
+        };
+    }
+    if (startLine >= totalFileLines) {
+        throw new Error(`Offset ${offset} is beyond end of file (${totalFileLines} lines total)`);
+    }
+    const endLine = limit !== undefined ? Math.min(startLine + limit, totalFileLines) : totalFileLines;
+    const allHashes = await lineHashes(textContent, path);
+    const selectedContent = fmtRegion(allHashes.slice(startLine, endLine), allLines.slice(startLine, endLine));
+    return formatTextReadOutput({
+        truncation: truncateHead(selectedContent),
+        allLines,
+        startLine,
+        startLineDisplay,
+        endLine,
+        totalFileLines,
+    });
+}
+async function executeReadRequest(options, isAborted) {
+    const target = await resolveReadTarget(options);
+    if (isAborted())
+        return undefined;
+    await target.operations.access(target.path, "read");
+    if (isAborted())
+        return undefined;
+    const mimeType = target.operations.detectImageMimeType
+        ? await target.operations.detectImageMimeType(target.path)
+        : undefined;
+    const nonVisionImageNote = getNonVisionImageNote(options.model);
+    const result = mimeType
+        ? await readImageFile(target.operations, target.path, mimeType, options.autoResizeImages, nonVisionImageNote)
+        : await readTextFile(target.operations, target.path, options.input.offset, options.input.limit);
+    return isAborted() ? undefined : result;
+}
+function executeAbortableRead(options) {
+    return new Promise((resolve, reject) => {
+        if (options.signal?.aborted) {
+            reject(new Error("Operation aborted"));
+            return;
+        }
+        let aborted = false;
+        const onAbort = () => {
+            aborted = true;
+            reject(new Error("Operation aborted"));
+        };
+        options.signal?.addEventListener("abort", onAbort, { once: true });
+        void executeReadRequest(options, () => aborted).then((result) => {
+            if (result === undefined)
+                return;
+            options.signal?.removeEventListener("abort", onAbort);
+            resolve(result);
+        }, (error) => {
+            options.signal?.removeEventListener("abort", onAbort);
+            if (!aborted)
+                reject(error);
+        });
+    });
+}
+export function createReadToolDefinition(operations, options) {
+    const autoResizeImages = options?.autoResizeImages ?? true;
+    const ops = operations;
+    const cwd = operations.cwd;
+    const operationsForPath = options?.operationsForPath;
+    return {
+        name: "read",
+        label: "read",
+        description: `Read the contents of a file. Supports text files and images (jpg, png, gif, webp). Images are sent as attachments. Text files are returned as HASH│content rows for hash-anchored editing. Output is truncated to ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). Use offset/limit for large files. When you need the full file, continue with offset until complete.`,
+        promptSnippet: "Read file contents with hashline anchors",
+        promptGuidelines: [
+            "Use read to examine files instead of cat or sed.",
+            "For edits, copy only the 3-character HASH values into edit hash_range_inclusive; do not include HASH│ prefixes in content_lines.",
+        ],
+        parameters: readSchema,
+        async execute(_toolCallId, input, signal, _onUpdate, ctx) {
+            return executeAbortableRead({
+                input,
+                defaultOperations: ops,
+                cwd,
+                operationsForPath,
+                autoResizeImages,
+                model: ctx?.model,
+                signal,
+            });
+        },
+        renderCall(args, theme, context) {
+            const text = context.lastComponent ?? new Text("", 0, 0);
+            const classification = !context.expanded ? getCompactReadClassification(args, context.cwd) : undefined;
+            const renderArgs = args;
+            const rawPath = str(renderArgs?.file_path ?? renderArgs?.path);
+            const displayOps = rawPath
+                ? (getReadToolOperations(operationsForPath?.(resolveToCwd(rawPath, cwd))) ?? ops)
+                : ops;
+            text.setText(formatBackendIcon(displayOps.getBackendInfo?.(), theme) +
+                (classification ? formatCompactReadCall(classification, args, theme) : formatReadCall(args, theme)));
+            return text;
+        },
+        renderResult(result, options, theme, context) {
+            const text = context.lastComponent ?? new Text("", 0, 0);
+            text.setText(formatReadResult(context.args, result, options, theme, context.showImages, context.cwd, context.isError));
+            return text;
+        },
+    };
+}
+export function createReadTool(operations, options) {
+    return wrapToolDefinition(createReadToolDefinition(operations, options));
+}
+//# sourceMappingURL=read.js.map

package/dist/core/tools/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/core/tools/read.ts"],"names":[],"mappings":"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","sourcesContent":["import { basename, dirname, isAbsolute, relative, resolve as resolvePath, sep } from \"node:path\";\nimport type { AgentTool, AgentToolResult } from \"@greppleai/grip-agent-core\";\nimport type { Api, Model } from \"@greppleai/grip-ai\";\nimport { Text } from \"@greppleai/grip-tui\";\n\nimport { type Static, Type } from \"typebox\";\nimport { getReadmePath } from \"../../config.ts\";\nimport { keyHint, keyText } from \"../../modes/interactive/components/keybinding-hints.ts\";\nimport { getLanguageFromPath, highlightCode, type Theme } from \"../../modes/interactive/theme/theme.ts\";\nimport { processImage } from \"../../utils/image-process.ts\";\nimport { formatPathRelativeToCwdOrAbsolute } from \"../../utils/paths.ts\";\nimport type { ToolDefinition, ToolRenderResultOptions } from \"../extensions/types.ts\";\nimport { fmtRegion } from \"./hashline/apply.ts\";\nimport { HASH_SEP, initHasher, lineHashes } from \"./hashline/hash.ts\";\nimport { visLines as hashlineVisLines } from \"./hashline-utils.ts\";\nimport type { ToolOperations } from \"./operations.ts\";\nimport { resolveReadPathAsync, resolveToCwd } from \"./path-utils.ts\";\nimport { formatBackendIcon, getTextOutput, invalidArgText, replaceTabs, shortenPath, str } from \"./render-utils.ts\";\nimport { wrapToolDefinition } from \"./tool-definition-wrapper.ts\";\nimport { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, type TruncationResult, truncateHead } from \"./truncate.ts\";\n\nconst readSchema = Type.Object({\n\tpath: Type.String({ description: \"Path to the file to read (relative or absolute)\" }),\n\toffset: Type.Optional(Type.Number({ description: \"Line number to start reading from (1-indexed)\" })),\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of lines to read\" })),\n});\n\nexport type ReadToolInput = Static<typeof readSchema>;\n\nexport interface ReadToolDetails {\n\ttruncation?: TruncationResult;\n}\n\ntype CompactReadClassificationKind = \"docs\" | \"resource\" | \"skill\" | \"rule\";\n\ninterface CompactReadClassification {\n\tkind: CompactReadClassificationKind;\n\tlabel: string;\n}\n\nconst COMPACT_RESOURCE_FILE_NAMES = new Set([\"AGENTS.override.md\", \"AGENTS.md\", \"AGENTS.MD\", \"CLAUDE.md\", \"CLAUDE.MD\"]);\n\nexport interface ReadToolOperationsSelection {\n\tkind: \"selection\";\n\toperations: ToolOperations;\n\tpath: string;\n}\n\nexport type ReadToolOperations = ToolOperations | ReadToolOperationsSelection;\n\ntype ReadToolOperationsSelector = (absolutePath: string) => ReadToolOperations | undefined;\n\nexport interface ReadToolOptions {\n\t/** Whether to auto-resize images to 2000x2000 max. Default: true */\n\tautoResizeImages?: boolean;\n\t/** Select a backend, and optionally a canonical path, for a resolved absolute path. Defaults to the tool backend. */\n\toperationsForPath?: ReadToolOperationsSelector;\n}\n\nfunction isReadToolOperationsSelection(value: ReadToolOperations): value is ReadToolOperationsSelection {\n\treturn \"kind\" in value && value.kind === \"selection\";\n}\n\nfunction getReadToolOperations(value: ReadToolOperations | undefined): ToolOperations | undefined {\n\treturn value && isReadToolOperationsSelection(value) ? value.operations : value;\n}\n\ntype ReadRenderArgs = { path?: string; file_path?: string; offset?: number; limit?: number };\n\nfunction formatReadLineRange(args: ReadRenderArgs | undefined, theme: Theme): string {\n\tif (args?.offset === undefined && args?.limit === undefined) return \"\";\n\tconst startLine = args.offset ?? 1;\n\tconst endLine = args.limit !== undefined ? startLine + args.limit - 1 : \"\";\n\treturn theme.fg(\"warning\", `:${startLine}${endLine ? `-${endLine}` : \"\"}`);\n}\n\nfunction formatReadCall(args: ReadRenderArgs | undefined, theme: Theme): string {\n\tconst rawPath = str(args?.file_path ?? args?.path);\n\tconst path = rawPath !== null ? shortenPath(rawPath) : null;\n\tconst invalidArg = invalidArgText(theme);\n\tconst pathDisplay = path === null ? invalidArg : path ? theme.fg(\"accent\", path) : theme.fg(\"toolOutput\", \"...\");\n\treturn `${theme.fg(\"toolTitle\", theme.bold(\"read\"))} ${pathDisplay}${formatReadLineRange(args, theme)}`;\n}\n\nfunction trimTrailingEmptyLines(lines: string[]): string[] {\n\tlet end = lines.length;\n\twhile (end > 0 && lines[end - 1] === \"\") {\n\t\tend--;\n\t}\n\treturn lines.slice(0, end);\n}\n\nfunction getNonVisionImageNote(model: Model<Api> | undefined): string | undefined {\n\tif (!model || model.input.includes(\"image\")) {\n\t\treturn undefined;\n\t}\n\treturn \"[Current model does not support images. The image will be omitted from this request.]\";\n}\n\nfunction toPosixPath(filePath: string): string {\n\treturn filePath.split(sep).join(\"/\");\n}\n\nfunction getGripDocsClassification(absolutePath: string): CompactReadClassification | undefined {\n\tconst packageRoot = dirname(getReadmePath());\n\tconst relativePath = relative(resolvePath(packageRoot), resolvePath(absolutePath));\n\tif (\n\t\trelativePath === \"\" ||\n\t\trelativePath === \"..\" ||\n\t\trelativePath.startsWith(`..${sep}`) ||\n\t\tisAbsolute(relativePath)\n\t) {\n\t\treturn undefined;\n\t}\n\n\tconst label = toPosixPath(relativePath);\n\tif (label === \"README.md\" || label.startsWith(\"docs/\") || label.startsWith(\"examples/\")) {\n\t\treturn { kind: \"docs\", label };\n\t}\n\treturn undefined;\n}\n\nfunction getCompactReadClassification(\n\targs: ReadRenderArgs | undefined,\n\tcwd: string,\n): CompactReadClassification | undefined {\n\tconst rawPath = str(args?.file_path ?? args?.path);\n\tif (!rawPath) return undefined;\n\n\tconst absolutePath = resolveToCwd(rawPath, cwd);\n\tconst fileName = basename(absolutePath);\n\tif (fileName === \"SKILL.md\") {\n\t\treturn { kind: \"skill\", label: basename(dirname(absolutePath)) || fileName };\n\t}\n\tif (fileName === \"RULES.md\") {\n\t\treturn { kind: \"rule\", label: basename(dirname(absolutePath)) || fileName };\n\t}\n\n\tconst docsClassification = getGripDocsClassification(absolutePath);\n\tif (docsClassification) return docsClassification;\n\n\tif (COMPACT_RESOURCE_FILE_NAMES.has(fileName)) {\n\t\treturn { kind: \"resource\", label: formatPathRelativeToCwdOrAbsolute(absolutePath, cwd) };\n\t}\n\n\treturn undefined;\n}\n\nfunction formatCompactReadCall(\n\tclassification: CompactReadClassification,\n\targs: ReadRenderArgs | undefined,\n\ttheme: Theme,\n): string {\n\tconst expandHint = theme.fg(\"dim\", ` (${keyText(\"app.tools.expand\")} to expand)`);\n\tif (classification.kind === \"skill\" || classification.kind === \"rule\") {\n\t\tconst label = classification.kind === \"skill\" ? \"skill\" : \"rule\";\n\t\treturn (\n\t\t\ttheme.fg(\"customMessageLabel\", `\\x1b[1m[${label}]\\x1b[22m `) +\n\t\t\ttheme.fg(\"customMessageText\", classification.label) +\n\t\t\tformatReadLineRange(args, theme) +\n\t\t\texpandHint\n\t\t);\n\t}\n\n\treturn (\n\t\ttheme.fg(\"toolTitle\", theme.bold(`read ${classification.kind}`)) +\n\t\t\" \" +\n\t\ttheme.fg(\"accent\", classification.label) +\n\t\tformatReadLineRange(args, theme) +\n\t\texpandHint\n\t);\n}\n\nfunction formatReadTruncationWarning(truncation: TruncationResult | undefined, theme: Theme): string {\n\tif (!truncation?.truncated) return \"\";\n\tif (truncation.firstLineExceedsLimit) {\n\t\treturn `\\n${theme.fg(\"warning\", `[First line exceeds ${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit]`)}`;\n\t}\n\tif (truncation.truncatedBy === \"lines\") {\n\t\treturn `\\n${theme.fg(\"warning\", `[Truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines (${truncation.maxLines ?? DEFAULT_MAX_LINES} line limit)]`)}`;\n\t}\n\treturn `\\n${theme.fg(\"warning\", `[Truncated: ${truncation.outputLines} lines shown (${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit)]`)}`;\n}\n\nfunction formatReadResult(\n\targs: ReadRenderArgs | undefined,\n\tresult: AgentToolResult<ReadToolDetails | undefined>,\n\toptions: ToolRenderResultOptions,\n\ttheme: Theme,\n\tshowImages: boolean,\n\tcwd: string,\n\tisError: boolean,\n): string {\n\tif (!options.expanded && !isError && getCompactReadClassification(args, cwd)) {\n\t\treturn \"\";\n\t}\n\n\tconst rawPath = str(args?.file_path ?? args?.path);\n\tconst output = getTextOutput(result, showImages);\n\tconst lang = rawPath ? getLanguageFromPath(rawPath) : undefined;\n\tconst renderedLines = lang ? highlightCode(replaceTabs(output), lang) : output.split(\"\\n\");\n\tconst lines = trimTrailingEmptyLines(renderedLines);\n\tconst maxLines = options.expanded ? lines.length : 10;\n\tconst displayLines = lines.slice(0, maxLines);\n\tconst remaining = lines.length - maxLines;\n\tlet text = `\\n${displayLines.map((line) => (lang ? replaceTabs(line) : theme.fg(\"toolOutput\", replaceTabs(line)))).join(\"\\n\")}`;\n\tif (remaining > 0) {\n\t\ttext += `${theme.fg(\"muted\", `\\n... (${remaining} more lines,`)} ${keyHint(\"app.tools.expand\", \"to expand\")})`;\n\t}\n\n\ttext += formatReadTruncationWarning(result.details?.truncation, theme);\n\treturn text;\n}\n\ninterface ResolvedReadTarget {\n\toperations: ToolOperations;\n\tpath: string;\n}\n\ninterface ReadExecutionOptions {\n\tinput: ReadToolInput;\n\tdefaultOperations: ToolOperations;\n\tcwd: string;\n\toperationsForPath: ReadToolOperationsSelector | undefined;\n\tautoResizeImages: boolean;\n\tmodel: Model<Api> | undefined;\n\tsignal: AbortSignal | undefined;\n}\n\ninterface TextReadOutputOptions {\n\ttruncation: TruncationResult;\n\tallLines: string[];\n\tstartLine: number;\n\tstartLineDisplay: number;\n\tendLine: number;\n\ttotalFileLines: number;\n}\n\nasync function resolveReadTarget(options: ReadExecutionOptions): Promise<ResolvedReadTarget> {\n\tconst absolutePath = await resolveReadPathAsync(options.input.path, options.cwd);\n\tconst selection = options.operationsForPath?.(absolutePath);\n\treturn {\n\t\toperations: getReadToolOperations(selection) ?? options.defaultOperations,\n\t\tpath: selection && isReadToolOperationsSelection(selection) ? selection.path : absolutePath,\n\t};\n}\n\nasync function readImageFile(\n\toperations: ToolOperations,\n\tpath: string,\n\tmimeType: string,\n\tautoResizeImages: boolean,\n\tnonVisionImageNote: string | undefined,\n): Promise<AgentToolResult<ReadToolDetails | undefined>> {\n\tconst buffer = await operations.readFile(path);\n\tconst processed = await processImage(buffer, mimeType, { autoResizeImages });\n\tif (!processed.ok) {\n\t\tlet text = `Read image file [${mimeType}]\\n${processed.message}`;\n\t\tif (nonVisionImageNote) text += `\\n${nonVisionImageNote}`;\n\t\treturn { content: [{ type: \"text\", text }], details: undefined };\n\t}\n\tlet text = `Read image file [${processed.mimeType}]`;\n\tif (processed.hints.length > 0) text += `\\n${processed.hints.join(\"\\n\")}`;\n\tif (nonVisionImageNote) text += `\\n${nonVisionImageNote}`;\n\treturn {\n\t\tcontent: [\n\t\t\t{ type: \"text\", text },\n\t\t\t{ type: \"image\", data: processed.data, mimeType: processed.mimeType },\n\t\t],\n\t\tdetails: undefined,\n\t};\n}\n\nfunction formatTextReadOutput(options: TextReadOutputOptions): AgentToolResult<ReadToolDetails | undefined> {\n\tconst { truncation } = options;\n\tlet text: string;\n\tlet details: ReadToolDetails | undefined;\n\tif (truncation.firstLineExceedsLimit) {\n\t\tconst firstLineSize = formatSize(Buffer.byteLength(options.allLines[options.startLine] ?? \"\", \"utf-8\"));\n\t\ttext = `[Line ${options.startLineDisplay} is ${firstLineSize}, exceeds ${formatSize(DEFAULT_MAX_BYTES)} limit. Hashline output requires full lines; use bash for this line.]`;\n\t\tdetails = { truncation };\n\t} else if (truncation.truncated) {\n\t\tconst endLineDisplay = options.startLineDisplay + truncation.outputLines - 1;\n\t\tconst nextOffset = endLineDisplay + 1;\n\t\ttext = truncation.content;\n\t\tif (truncation.truncatedBy === \"lines\") {\n\t\t\ttext += `\\n\\n[Showing lines ${options.startLineDisplay}-${endLineDisplay} of ${options.totalFileLines}. Use offset=${nextOffset} to continue.]`;\n\t\t} else {\n\t\t\ttext += `\\n\\n[Showing lines ${options.startLineDisplay}-${endLineDisplay} of ${options.totalFileLines} (${formatSize(DEFAULT_MAX_BYTES)} limit). Use offset=${nextOffset} to continue.]`;\n\t\t}\n\t\tdetails = { truncation };\n\t} else if (options.endLine < options.totalFileLines) {\n\t\tconst remaining = options.totalFileLines - options.endLine;\n\t\ttext = `${truncation.content}\\n\\n[${remaining} more lines in file. Use offset=${options.endLine + 1} to continue.]`;\n\t} else {\n\t\ttext = truncation.content;\n\t}\n\treturn { content: [{ type: \"text\", text }], details };\n}\n\nasync function readTextFile(\n\toperations: ToolOperations,\n\tpath: string,\n\toffset: number | undefined,\n\tlimit: number | undefined,\n): Promise<AgentToolResult<ReadToolDetails | undefined>> {\n\tawait initHasher();\n\tconst buffer = await operations.readFile(path);\n\tconst textContent = buffer.toString(\"utf-8\").replace(/\\r\\n/g, \"\\n\").replace(/\\r/g, \"\\n\");\n\tconst allLines = hashlineVisLines(textContent);\n\tconst totalFileLines = allLines.length;\n\tconst startLine = offset ? Math.max(0, offset - 1) : 0;\n\tconst startLineDisplay = startLine + 1;\n\tif (totalFileLines === 0) {\n\t\tif (startLineDisplay !== 1) throw new Error(`Offset ${offset} is beyond end of file (0 lines total)`);\n\t\tconst emptyHash = (await lineHashes(textContent, path))[0] ?? \"\";\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: `${emptyHash}${HASH_SEP}\\n[File is empty. Use edit to insert content.]` }],\n\t\t\tdetails: undefined,\n\t\t};\n\t}\n\tif (startLine >= totalFileLines) {\n\t\tthrow new Error(`Offset ${offset} is beyond end of file (${totalFileLines} lines total)`);\n\t}\n\tconst endLine = limit !== undefined ? Math.min(startLine + limit, totalFileLines) : totalFileLines;\n\tconst allHashes = await lineHashes(textContent, path);\n\tconst selectedContent = fmtRegion(allHashes.slice(startLine, endLine), allLines.slice(startLine, endLine));\n\treturn formatTextReadOutput({\n\t\ttruncation: truncateHead(selectedContent),\n\t\tallLines,\n\t\tstartLine,\n\t\tstartLineDisplay,\n\t\tendLine,\n\t\ttotalFileLines,\n\t});\n}\n\nasync function executeReadRequest(\n\toptions: ReadExecutionOptions,\n\tisAborted: () => boolean,\n): Promise<AgentToolResult<ReadToolDetails | undefined> | undefined> {\n\tconst target = await resolveReadTarget(options);\n\tif (isAborted()) return undefined;\n\tawait target.operations.access(target.path, \"read\");\n\tif (isAborted()) return undefined;\n\tconst mimeType = target.operations.detectImageMimeType\n\t\t? await target.operations.detectImageMimeType(target.path)\n\t\t: undefined;\n\tconst nonVisionImageNote = getNonVisionImageNote(options.model);\n\tconst result = mimeType\n\t\t? await readImageFile(target.operations, target.path, mimeType, options.autoResizeImages, nonVisionImageNote)\n\t\t: await readTextFile(target.operations, target.path, options.input.offset, options.input.limit);\n\treturn isAborted() ? undefined : result;\n}\n\nfunction executeAbortableRead(options: ReadExecutionOptions): Promise<AgentToolResult<ReadToolDetails | undefined>> {\n\treturn new Promise((resolve, reject) => {\n\t\tif (options.signal?.aborted) {\n\t\t\treject(new Error(\"Operation aborted\"));\n\t\t\treturn;\n\t\t}\n\t\tlet aborted = false;\n\t\tconst onAbort = () => {\n\t\t\taborted = true;\n\t\t\treject(new Error(\"Operation aborted\"));\n\t\t};\n\t\toptions.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\t\tvoid executeReadRequest(options, () => aborted).then(\n\t\t\t(result) => {\n\t\t\t\tif (result === undefined) return;\n\t\t\t\toptions.signal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\tresolve(result);\n\t\t\t},\n\t\t\t(error) => {\n\t\t\t\toptions.signal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\tif (!aborted) reject(error);\n\t\t\t},\n\t\t);\n\t});\n}\n\nexport type ReadToolDefinition = ToolDefinition<typeof readSchema, ReadToolDetails | undefined>;\n\nexport function createReadToolDefinition(operations: ToolOperations, options?: ReadToolOptions): ReadToolDefinition {\n\tconst autoResizeImages = options?.autoResizeImages ?? true;\n\tconst ops = operations;\n\tconst cwd = operations.cwd;\n\tconst operationsForPath = options?.operationsForPath;\n\treturn {\n\t\tname: \"read\",\n\t\tlabel: \"read\",\n\t\tdescription: `Read the contents of a file. Supports text files and images (jpg, png, gif, webp). Images are sent as attachments. Text files are returned as HASH│content rows for hash-anchored editing. Output is truncated to ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). Use offset/limit for large files. When you need the full file, continue with offset until complete.`,\n\t\tpromptSnippet: \"Read file contents with hashline anchors\",\n\t\tpromptGuidelines: [\n\t\t\t\"Use read to examine files instead of cat or sed.\",\n\t\t\t\"For edits, copy only the 3-character HASH values into edit hash_range_inclusive; do not include HASH│ prefixes in content_lines.\",\n\t\t],\n\t\tparameters: readSchema,\n\t\tasync execute(_toolCallId, input: ReadToolInput, signal?: AbortSignal, _onUpdate?, ctx?) {\n\t\t\treturn executeAbortableRead({\n\t\t\t\tinput,\n\t\t\t\tdefaultOperations: ops,\n\t\t\t\tcwd,\n\t\t\t\toperationsForPath,\n\t\t\t\tautoResizeImages,\n\t\t\t\tmodel: ctx?.model,\n\t\t\t\tsignal,\n\t\t\t});\n\t\t},\n\t\trenderCall(args, theme, context) {\n\t\t\tconst text = (context.lastComponent as Text | undefined) ?? new Text(\"\", 0, 0);\n\t\t\tconst classification = !context.expanded ? getCompactReadClassification(args, context.cwd) : undefined;\n\t\t\tconst renderArgs = args as ReadRenderArgs | undefined;\n\t\t\tconst rawPath = str(renderArgs?.file_path ?? renderArgs?.path);\n\t\t\tconst displayOps = rawPath\n\t\t\t\t? (getReadToolOperations(operationsForPath?.(resolveToCwd(rawPath, cwd))) ?? ops)\n\t\t\t\t: ops;\n\t\t\ttext.setText(\n\t\t\t\tformatBackendIcon(displayOps.getBackendInfo?.(), theme) +\n\t\t\t\t\t(classification ? formatCompactReadCall(classification, args, theme) : formatReadCall(args, theme)),\n\t\t\t);\n\t\t\treturn text;\n\t\t},\n\t\trenderResult(result, options, theme, context) {\n\t\t\tconst text = (context.lastComponent as Text | undefined) ?? new Text(\"\", 0, 0);\n\t\t\ttext.setText(\n\t\t\t\tformatReadResult(context.args, result, options, theme, context.showImages, context.cwd, context.isError),\n\t\t\t);\n\t\t\treturn text;\n\t\t},\n\t};\n}\n\nexport function createReadTool(operations: ToolOperations, options?: ReadToolOptions): AgentTool<typeof readSchema> {\n\treturn wrapToolDefinition(createReadToolDefinition(operations, options));\n}\n"]}

package/dist/core/tools/render-utils.d.ts

@@ -0,0 +1,33 @@
+import type { ImageContent, TextContent } from "@greppleai/grip-ai";
+import type { ThemeColor } from "../../modes/interactive/theme/theme.ts";
+import type { ToolBackendInfo } from "./operations.ts";
+export declare function shortenPath(path: unknown): string;
+export declare function str(value: unknown): string | null;
+export declare function replaceTabs(text: string): string;
+export declare function normalizeDisplayText(text: string): string;
+export interface ToolTextOutputContent {
+    type: string;
+    text?: string;
+    data?: string;
+    mimeType?: string;
+}
+interface ToolTextOutputSource {
+    content: ToolTextOutputContent[];
+}
+interface ToolRenderTheme {
+    fg(name: ThemeColor, text: string): string;
+}
+export declare function getTextOutput(result: ToolTextOutputSource | undefined, showImages: boolean): string;
+export type ToolRenderResultLike<TDetails> = {
+    content: (TextContent | ImageContent)[];
+    details: TDetails;
+};
+export declare function invalidArgText(theme: ToolRenderTheme): string;
+/**
+ * Render a small icon prefix for a tool-call header indicating whether the tool
+ * runs against the local machine or a remote daemon backend. Placed at the start
+ * of the header so the local/remote target is visible at a glance.
+ */
+export declare function formatBackendIcon(backendInfo: ToolBackendInfo | undefined, theme: ToolRenderTheme): string;
+export {};
+//# sourceMappingURL=render-utils.d.ts.map

package/dist/core/tools/render-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-utils.d.ts","sourceRoot":"","sources":["../../../src/core/tools/render-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAGzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAOjD;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIjD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,oBAAoB;IAC7B,OAAO,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAED,UAAU,eAAe;IACxB,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3C;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAsBnG;AAED,MAAM,MAAM,oBAAoB,CAAC,QAAQ,IAAI;IAC5C,OAAO,EAAE,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,CAAC;IACxC,OAAO,EAAE,QAAQ,CAAC;CAClB,CAAC;AAEF,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,eAAe,GAAG,SAAS,EAAE,KAAK,EAAE,eAAe,GAAG,MAAM,CAI1G","sourcesContent":["import * as os from \"node:os\";\nimport type { ImageContent, TextContent } from \"@greppleai/grip-ai\";\nimport { getCapabilities, getImageDimensions, imageFallback } from \"@greppleai/grip-tui\";\nimport type { ThemeColor } from \"../../modes/interactive/theme/theme.ts\";\nimport { stripAnsi } from \"../../utils/ansi.ts\";\nimport { sanitizeBinaryOutput } from \"../../utils/shell.ts\";\nimport type { ToolBackendInfo } from \"./operations.ts\";\n\nexport function shortenPath(path: unknown): string {\n\tif (typeof path !== \"string\") return \"\";\n\tconst home = os.homedir();\n\tif (path.startsWith(home)) {\n\t\treturn `~${path.slice(home.length)}`;\n\t}\n\treturn path;\n}\n\nexport function str(value: unknown): string | null {\n\tif (typeof value === \"string\") return value;\n\tif (value == null) return \"\";\n\treturn null;\n}\n\nexport function replaceTabs(text: string): string {\n\treturn text.replace(/\\t/g, \"   \");\n}\n\nexport function normalizeDisplayText(text: string): string {\n\treturn text.replace(/\\r/g, \"\");\n}\n\nexport interface ToolTextOutputContent {\n\ttype: string;\n\ttext?: string;\n\tdata?: string;\n\tmimeType?: string;\n}\n\ninterface ToolTextOutputSource {\n\tcontent: ToolTextOutputContent[];\n}\n\ninterface ToolRenderTheme {\n\tfg(name: ThemeColor, text: string): string;\n}\n\nexport function getTextOutput(result: ToolTextOutputSource | undefined, showImages: boolean): string {\n\tif (!result) return \"\";\n\n\tconst textBlocks = result.content.filter((c) => c.type === \"text\");\n\tconst imageBlocks = result.content.filter((c) => c.type === \"image\");\n\n\tlet output = textBlocks.map((c) => sanitizeBinaryOutput(stripAnsi(c.text || \"\")).replace(/\\r/g, \"\")).join(\"\\n\");\n\n\tconst caps = getCapabilities();\n\tif (imageBlocks.length > 0 && (!caps.images || !showImages)) {\n\t\tconst imageIndicators = imageBlocks\n\t\t\t.map((img) => {\n\t\t\t\tconst mimeType = img.mimeType ?? \"image/unknown\";\n\t\t\t\tconst dims =\n\t\t\t\t\timg.data && img.mimeType ? (getImageDimensions(img.data, img.mimeType) ?? undefined) : undefined;\n\t\t\t\treturn imageFallback(mimeType, dims);\n\t\t\t})\n\t\t\t.join(\"\\n\");\n\t\toutput = output ? `${output}\\n${imageIndicators}` : imageIndicators;\n\t}\n\n\treturn output;\n}\n\nexport type ToolRenderResultLike<TDetails> = {\n\tcontent: (TextContent | ImageContent)[];\n\tdetails: TDetails;\n};\n\nexport function invalidArgText(theme: ToolRenderTheme): string {\n\treturn theme.fg(\"error\", \"[invalid arg]\");\n}\n\n/**\n * Render a small icon prefix for a tool-call header indicating whether the tool\n * runs against the local machine or a remote daemon backend. Placed at the start\n * of the header so the local/remote target is visible at a glance.\n */\nexport function formatBackendIcon(backendInfo: ToolBackendInfo | undefined, theme: ToolRenderTheme): string {\n\tif (!backendInfo) return \"\";\n\tif (backendInfo.type === \"local\") return theme.fg(\"muted\", \"\\u{1F5A5} \");\n\treturn backendInfo.configured ? theme.fg(\"muted\", \"\\u2601 \") : theme.fg(\"warning\", \"\\u2601 \");\n}\n"]}

package/dist/core/tools/render-utils.js

@@ -0,0 +1,61 @@
+import * as os from "node:os";
+import { getCapabilities, getImageDimensions, imageFallback } from "@greppleai/grip-tui";
+import { stripAnsi } from "../../utils/ansi.js";
+import { sanitizeBinaryOutput } from "../../utils/shell.js";
+export function shortenPath(path) {
+    if (typeof path !== "string")
+        return "";
+    const home = os.homedir();
+    if (path.startsWith(home)) {
+        return `~${path.slice(home.length)}`;
+    }
+    return path;
+}
+export function str(value) {
+    if (typeof value === "string")
+        return value;
+    if (value == null)
+        return "";
+    return null;
+}
+export function replaceTabs(text) {
+    return text.replace(/\t/g, "   ");
+}
+export function normalizeDisplayText(text) {
+    return text.replace(/\r/g, "");
+}
+export function getTextOutput(result, showImages) {
+    if (!result)
+        return "";
+    const textBlocks = result.content.filter((c) => c.type === "text");
+    const imageBlocks = result.content.filter((c) => c.type === "image");
+    let output = textBlocks.map((c) => sanitizeBinaryOutput(stripAnsi(c.text || "")).replace(/\r/g, "")).join("\n");
+    const caps = getCapabilities();
+    if (imageBlocks.length > 0 && (!caps.images || !showImages)) {
+        const imageIndicators = imageBlocks
+            .map((img) => {
+            const mimeType = img.mimeType ?? "image/unknown";
+            const dims = img.data && img.mimeType ? (getImageDimensions(img.data, img.mimeType) ?? undefined) : undefined;
+            return imageFallback(mimeType, dims);
+        })
+            .join("\n");
+        output = output ? `${output}\n${imageIndicators}` : imageIndicators;
+    }
+    return output;
+}
+export function invalidArgText(theme) {
+    return theme.fg("error", "[invalid arg]");
+}
+/**
+ * Render a small icon prefix for a tool-call header indicating whether the tool
+ * runs against the local machine or a remote daemon backend. Placed at the start
+ * of the header so the local/remote target is visible at a glance.
+ */
+export function formatBackendIcon(backendInfo, theme) {
+    if (!backendInfo)
+        return "";
+    if (backendInfo.type === "local")
+        return theme.fg("muted", "\u{1F5A5} ");
+    return backendInfo.configured ? theme.fg("muted", "\u2601 ") : theme.fg("warning", "\u2601 ");
+}
+//# sourceMappingURL=render-utils.js.map

package/dist/core/tools/render-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-utils.js","sourceRoot":"","sources":["../../../src/core/tools/render-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import * as os from \"node:os\";\nimport type { ImageContent, TextContent } from \"@greppleai/grip-ai\";\nimport { getCapabilities, getImageDimensions, imageFallback } from \"@greppleai/grip-tui\";\nimport type { ThemeColor } from \"../../modes/interactive/theme/theme.ts\";\nimport { stripAnsi } from \"../../utils/ansi.ts\";\nimport { sanitizeBinaryOutput } from \"../../utils/shell.ts\";\nimport type { ToolBackendInfo } from \"./operations.ts\";\n\nexport function shortenPath(path: unknown): string {\n\tif (typeof path !== \"string\") return \"\";\n\tconst home = os.homedir();\n\tif (path.startsWith(home)) {\n\t\treturn `~${path.slice(home.length)}`;\n\t}\n\treturn path;\n}\n\nexport function str(value: unknown): string | null {\n\tif (typeof value === \"string\") return value;\n\tif (value == null) return \"\";\n\treturn null;\n}\n\nexport function replaceTabs(text: string): string {\n\treturn text.replace(/\\t/g, \"   \");\n}\n\nexport function normalizeDisplayText(text: string): string {\n\treturn text.replace(/\\r/g, \"\");\n}\n\nexport interface ToolTextOutputContent {\n\ttype: string;\n\ttext?: string;\n\tdata?: string;\n\tmimeType?: string;\n}\n\ninterface ToolTextOutputSource {\n\tcontent: ToolTextOutputContent[];\n}\n\ninterface ToolRenderTheme {\n\tfg(name: ThemeColor, text: string): string;\n}\n\nexport function getTextOutput(result: ToolTextOutputSource | undefined, showImages: boolean): string {\n\tif (!result) return \"\";\n\n\tconst textBlocks = result.content.filter((c) => c.type === \"text\");\n\tconst imageBlocks = result.content.filter((c) => c.type === \"image\");\n\n\tlet output = textBlocks.map((c) => sanitizeBinaryOutput(stripAnsi(c.text || \"\")).replace(/\\r/g, \"\")).join(\"\\n\");\n\n\tconst caps = getCapabilities();\n\tif (imageBlocks.length > 0 && (!caps.images || !showImages)) {\n\t\tconst imageIndicators = imageBlocks\n\t\t\t.map((img) => {\n\t\t\t\tconst mimeType = img.mimeType ?? \"image/unknown\";\n\t\t\t\tconst dims =\n\t\t\t\t\timg.data && img.mimeType ? (getImageDimensions(img.data, img.mimeType) ?? undefined) : undefined;\n\t\t\t\treturn imageFallback(mimeType, dims);\n\t\t\t})\n\t\t\t.join(\"\\n\");\n\t\toutput = output ? `${output}\\n${imageIndicators}` : imageIndicators;\n\t}\n\n\treturn output;\n}\n\nexport type ToolRenderResultLike<TDetails> = {\n\tcontent: (TextContent | ImageContent)[];\n\tdetails: TDetails;\n};\n\nexport function invalidArgText(theme: ToolRenderTheme): string {\n\treturn theme.fg(\"error\", \"[invalid arg]\");\n}\n\n/**\n * Render a small icon prefix for a tool-call header indicating whether the tool\n * runs against the local machine or a remote daemon backend. Placed at the start\n * of the header so the local/remote target is visible at a glance.\n */\nexport function formatBackendIcon(backendInfo: ToolBackendInfo | undefined, theme: ToolRenderTheme): string {\n\tif (!backendInfo) return \"\";\n\tif (backendInfo.type === \"local\") return theme.fg(\"muted\", \"\\u{1F5A5} \");\n\treturn backendInfo.configured ? theme.fg(\"muted\", \"\\u2601 \") : theme.fg(\"warning\", \"\\u2601 \");\n}\n"]}

package/dist/core/tools/replace-diff.d.ts

@@ -0,0 +1,16 @@
+export type LineEnding = "\r\n" | "\n";
+export declare function detectEnding(content: string): LineEnding;
+export declare function toLF(text: string): string;
+export declare function restoreEndings(text: string, ending: LineEnding): string;
+interface StrippedBomContent {
+    bom: string;
+    text: string;
+}
+interface HashlineDiffResult {
+    diff: string;
+    firstChangedLine: number | undefined;
+}
+export declare function stripBOM(content: string): StrippedBomContent;
+export declare function genDiff(oldContent: string, newContent: string, contextLines?: number, newContentHashes?: string[], _oldHashes?: string[]): HashlineDiffResult;
+export {};
+//# sourceMappingURL=replace-diff.d.ts.map

package/dist/core/tools/replace-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-diff.d.ts","sourceRoot":"","sources":["../../../src/core/tools/replace-diff.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC;AAGvC,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAKxD;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAEvE;AAED,UAAU,kBAAkB;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACb;AAED,UAAU,kBAAkB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAE5D;AA6FD,wBAAgB,OAAO,CACtB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,YAAY,SAAI,EAChB,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,GACnB,kBAAkB,CAiCpB","sourcesContent":["import * as Diff from \"diff\";\nimport { _lineHashesPure, ANCHOR_LEN, HASH_SEP } from \"./hashline/hash.ts\";\n\nexport type LineEnding = \"\\r\\n\" | \"\\n\";\ntype DiffLinePrefix = \" \" | \"+\" | \"-\";\n\nexport function detectEnding(content: string): LineEnding {\n\tconst crlfIdx = content.indexOf(\"\\r\\n\");\n\tconst lfIdx = content.indexOf(\"\\n\");\n\tif (lfIdx === -1 || crlfIdx === -1) return \"\\n\";\n\treturn crlfIdx < lfIdx ? \"\\r\\n\" : \"\\n\";\n}\n\nexport function toLF(text: string): string {\n\treturn text.replace(/\\r\\n/g, \"\\n\").replace(/\\r/g, \"\\n\");\n}\n\nexport function restoreEndings(text: string, ending: LineEnding): string {\n\treturn ending === \"\\r\\n\" ? text.replace(/\\n/g, \"\\r\\n\") : text;\n}\n\ninterface StrippedBomContent {\n\tbom: string;\n\ttext: string;\n}\n\ninterface HashlineDiffResult {\n\tdiff: string;\n\tfirstChangedLine: number | undefined;\n}\n\nexport function stripBOM(content: string): StrippedBomContent {\n\treturn content.startsWith(\"\\uFEFF\") ? { bom: \"\\uFEFF\", text: content.slice(1) } : { bom: \"\", text: content };\n}\n\nfunction fmtDiffLine(prefix: DiffLinePrefix, line: string, hash: string | undefined): string {\n\tif (hash === undefined) {\n\t\treturn `${prefix}${\" \".repeat(ANCHOR_LEN)}${HASH_SEP}${line}`;\n\t}\n\treturn `${prefix}${hash}${HASH_SEP}${line}`;\n}\ninterface DiffRenderState {\n\toutput: string[];\n\tnewLineNumber: number;\n\tlastPartWasChange: boolean;\n\tfirstChangedLine: number | undefined;\n}\n\ninterface DiffContextWindow {\n\tlines: string[];\n\tskippedStartLines: number;\n\tskippedMiddleLines: number;\n}\n\nconst DIFF_ELLIPSIS_MARKER = \"__ELLIPSIS__\";\n\nfunction getDiffDisplayLines(part: Diff.Change): string[] {\n\tconst lines = part.value.split(\"\\n\");\n\tif (lines[lines.length - 1] === \"\") lines.pop();\n\treturn lines;\n}\n\nfunction isChangedPart(part: Diff.Change): boolean {\n\treturn part.added || part.removed;\n}\n\nfunction renderChangedLines(\n\tpart: Diff.Change,\n\tlines: string[],\n\tnewContentHashes: string[],\n\tstate: DiffRenderState,\n): void {\n\tif (state.firstChangedLine === undefined) state.firstChangedLine = state.newLineNumber;\n\tfor (const line of lines) {\n\t\tif (part.added) {\n\t\t\tconst hash = newContentHashes[state.newLineNumber - 1];\n\t\t\tstate.output.push(fmtDiffLine(\"+\", line, hash));\n\t\t\tstate.newLineNumber++;\n\t\t} else {\n\t\t\tstate.output.push(fmtDiffLine(\"-\", line, undefined));\n\t\t}\n\t}\n\tstate.lastPartWasChange = true;\n}\n\nfunction selectDiffContextWindow(\n\tlines: string[],\n\tlastPartWasChange: boolean,\n\tnextPartIsChange: boolean,\n\tcontextLines: number,\n): DiffContextWindow {\n\tif (!lastPartWasChange) {\n\t\tconst skippedStartLines = Math.max(0, lines.length - contextLines);\n\t\treturn { lines: lines.slice(skippedStartLines), skippedStartLines, skippedMiddleLines: 0 };\n\t}\n\tif (nextPartIsChange && lines.length > contextLines * 2) {\n\t\treturn {\n\t\t\tlines: [...lines.slice(0, contextLines), DIFF_ELLIPSIS_MARKER, ...lines.slice(-contextLines)],\n\t\t\tskippedStartLines: 0,\n\t\t\tskippedMiddleLines: lines.length - contextLines * 2,\n\t\t};\n\t}\n\treturn {\n\t\tlines: lines.length > contextLines ? lines.slice(0, contextLines) : lines,\n\t\tskippedStartLines: 0,\n\t\tskippedMiddleLines: 0,\n\t};\n}\n\nfunction renderDiffContext(window: DiffContextWindow, newContentHashes: string[], state: DiffRenderState): void {\n\tif (window.skippedStartLines > 0) {\n\t\tstate.output.push(\" ...\");\n\t\tstate.newLineNumber += window.skippedStartLines;\n\t}\n\tfor (const line of window.lines) {\n\t\tif (line === DIFF_ELLIPSIS_MARKER) {\n\t\t\tstate.output.push(\" ...\");\n\t\t\tstate.newLineNumber += window.skippedMiddleLines;\n\t\t\tcontinue;\n\t\t}\n\t\tconst hash = newContentHashes[state.newLineNumber - 1];\n\t\tstate.output.push(fmtDiffLine(\" \", line, hash));\n\t\tstate.newLineNumber++;\n\t}\n}\n\nexport function genDiff(\n\toldContent: string,\n\tnewContent: string,\n\tcontextLines = 2,\n\tnewContentHashes?: string[],\n\t_oldHashes?: string[],\n): HashlineDiffResult {\n\t// Run Diff.diffLines on raw content only (no hash annotations) so that\n\t// lines whose content is identical are never reported as changed even\n\t// when their hash differs due to collision resolution or position\n\t// tracking. Hashes are used purely for display via fmtDiffLine.\n\tconst effectiveNewHashes = newContentHashes ?? _lineHashesPure(newContent);\n\tconst parts = Diff.diffLines(oldContent, newContent);\n\tconst state: DiffRenderState = {\n\t\toutput: [],\n\t\tnewLineNumber: 1,\n\t\tlastPartWasChange: false,\n\t\tfirstChangedLine: undefined,\n\t};\n\n\tfor (let index = 0; index < parts.length; index++) {\n\t\tconst part = parts[index]!;\n\t\tconst displayLines = getDiffDisplayLines(part);\n\t\tif (isChangedPart(part)) {\n\t\t\trenderChangedLines(part, displayLines, effectiveNewHashes, state);\n\t\t\tcontinue;\n\t\t}\n\t\tconst nextPart = parts[index + 1];\n\t\tconst nextPartIsChange = nextPart !== undefined && isChangedPart(nextPart);\n\t\tif (state.lastPartWasChange || nextPartIsChange) {\n\t\t\tconst window = selectDiffContextWindow(displayLines, state.lastPartWasChange, nextPartIsChange, contextLines);\n\t\t\trenderDiffContext(window, effectiveNewHashes, state);\n\t\t} else {\n\t\t\tstate.newLineNumber += displayLines.length;\n\t\t}\n\t\tstate.lastPartWasChange = false;\n\t}\n\n\treturn { diff: state.output.join(\"\\n\"), firstChangedLine: state.firstChangedLine };\n}\n"]}