@agimon-ai/po-read 0.0.0-alpha.111 → 0.0.0-alpha.112

package/dist/extensions/mcp.cjs

@@ -6,9 +6,9 @@ let _agimon_ai_po_core_mcpFacet = require("@agimon-ai/po-core/mcpFacet");
 let _agimon_ai_po_core_platform = require("@agimon-ai/po-core/platform");
 let _agimon_ai_po_hashline = require("@agimon-ai/po-hashline");
 let _agimon_ai_po_hashline_files = require("@agimon-ai/po-hashline/files");
-let _earendil_works_pi_coding_agent = require("@earendil-works/pi-coding-agent");
 let typebox = require("typebox");
 let _agimon_ai_po_config_piConfig = require("@agimon-ai/po-config/piConfig");
+let _earendil_works_pi_coding_agent = require("@earendil-works/pi-coding-agent");
 //#region src/schemas/readTool.ts
 const ReadParamsSchema = typebox.Type.Object({
 	path: typebox.Type.String({ description: "Path to the file to read." }),
@@ -22,11 +22,17 @@ const ReadParamsSchema = typebox.Type.Object({
 	}))
 });
 //#endregion
-//#region src/services/readImage/index.ts
-const OMITTED_NOTE = "[Image omitted: could not be resized below the inline image size limit.]";
-function imageLimits() {
+//#region src/services/readHost/index.ts
+const resizeOperations = {
+	resize: _earendil_works_pi_coding_agent.resizeImage,
+	formatDimensionNote: (result) => (0, _earendil_works_pi_coding_agent.formatDimensionNote)(result)
+};
+async function readImageLimits(_filesystem, _context) {
 	return (0, _agimon_ai_po_config_piConfig.loadPiImageSettings)();
 }
+//#endregion
+//#region src/services/readImage/index.ts
+const OMITTED_NOTE = "[Image omitted: could not be resized below the inline image size limit.]";
 async function applyImageLimits(content, limits, operations) {
 	if (!limits.autoResize || !content.some((part) => part.type === "image")) return content;
 	const resolved = [];
@@ -61,10 +67,6 @@ async function applyImageLimits(content, limits, operations) {
 }
 //#endregion
 //#region src/services/readTool/index.ts
-const resizeOperations = {
-	resize: _earendil_works_pi_coding_agent.resizeImage,
-	formatDimensionNote: (result) => (0, _earendil_works_pi_coding_agent.formatDimensionNote)(result)
-};
 function assertNotAborted(signal) {
 	if (signal?.aborted) throw new Error("Operation aborted");
 }
@@ -100,7 +102,7 @@ async function executeHeadlessRead(params, cwd, signal, filesystem) {
 		type: "image",
 		data: bytes.toString("base64"),
 		mimeType
-	}], imageLimits(), resizeOperations) };
+	}], await readImageLimits(filesystem, context), resizeOperations) };
 	if (!await (0, _agimon_ai_po_hashline_files.isWritableFile)(absolutePath)) return { content: [{
 		type: "text",
 		text: (0, _agimon_ai_po_hashline_files.decodeUtf8)(bytes, (0, _agimon_ai_po_hashline_files.displayPath)(absolutePath, cwd))

package/dist/extensions/mcp.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.cjs","names":["Type","loadPiImageSettings","resizeImage","formatDimensionNote","resolveReadInputPath","withAbortSignal","BACKGROUND_CONTEXT","readBoundedFile","FileTooLargeError","displayPath","isWritableFile","decodeUtf8","splitLines","formatFileHeader","computeFileTag","formatTaggedLine","DEFAULT_MAX_BYTES","truncateLine","truncateHead","formatSize","defineMcpTool","PO_FS_SERVICE","defineMcpPlugin","toolRead"],"sources":["../../src/schemas/readTool.ts","../../src/services/readImage/index.ts","../../src/services/readTool/index.ts","../../src/extensions/workspaces/sessions/(backend)/tool/read.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const ReadParamsSchema = Type.Object({\n  path: Type.String({ description: 'Path to the file to read.' }),\n  offset: Type.Optional(Type.Integer({ minimum: 1, description: 'One-based line offset.' })),\n  limit: Type.Optional(Type.Integer({ minimum: 1, description: 'Maximum number of lines to return.' })),\n});\n\nexport type ReadParams = Static<typeof ReadParamsSchema>;\n","import { loadPiImageSettings, type PiImageSettings } from '@agimon-ai/po-config/piConfig';\n\nconst OMITTED_NOTE = '[Image omitted: could not be resized below the inline image size limit.]';\n\nexport interface ReadTextPart {\n  type: 'text';\n  text: string;\n}\n\nexport interface ReadImagePart {\n  type: 'image';\n  data: string;\n  mimeType: string;\n}\n\nexport type ReadContentPart = ReadTextPart | ReadImagePart;\n\nexport interface ReadImageResizeResult {\n  readonly data: string;\n  readonly mimeType: string;\n  readonly originalWidth: number;\n  readonly originalHeight: number;\n  readonly width: number;\n  readonly height: number;\n  readonly wasResized: boolean;\n}\n\nexport interface ReadImageResizeOperations {\n  resize(\n    inputBytes: Uint8Array,\n    mimeType: string,\n    options: { readonly maxWidth: number; readonly maxHeight: number },\n  ): Promise<ReadImageResizeResult | null>;\n  formatDimensionNote(result: ReadImageResizeResult): string | undefined;\n}\n\nexport function imageLimits(): PiImageSettings {\n  return loadPiImageSettings();\n}\n\nexport async function applyImageLimits(\n  content: ReadContentPart[],\n  limits: PiImageSettings,\n  operations: ReadImageResizeOperations,\n): Promise<ReadContentPart[]> {\n  if (!limits.autoResize || !content.some((part) => part.type === 'image')) return content;\n  const resolved: ReadContentPart[] = [];\n  for (const part of content) {\n    if (part.type !== 'image') {\n      resolved.push(part);\n      continue;\n    }\n    const resized = await operations.resize(Buffer.from(part.data, 'base64'), part.mimeType, {\n      maxWidth: limits.maxDimension,\n      maxHeight: limits.maxDimension,\n    });\n    if (!resized) {\n      resolved.push({ type: 'text', text: OMITTED_NOTE });\n      continue;\n    }\n    resolved.push({ type: 'image', data: resized.data, mimeType: resized.mimeType });\n    const note = operations.formatDimensionNote(resized);\n    if (note) resolved.push({ type: 'text', text: note });\n  }\n  return resolved;\n}\n","import type { PoHeadlessExecutionContext, PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport {\n  BACKGROUND_CONTEXT,\n  FileTooLargeError,\n  readBoundedFile,\n  withAbortSignal,\n  type FileSystem,\n} from '@agimon-ai/po-core/platform';\nimport { formatFileHeader, formatTaggedLine, splitLines } from '@agimon-ai/po-hashline';\nimport {\n  computeFileTag,\n  decodeUtf8,\n  displayPath,\n  isWritableFile,\n  resolveReadInputPath,\n} from '@agimon-ai/po-hashline/files';\nimport {\n  DEFAULT_MAX_BYTES,\n  formatDimensionNote,\n  formatSize,\n  resizeImage,\n  truncateHead,\n  truncateLine,\n  type ReadToolDetails,\n} from '@earendil-works/pi-coding-agent';\n\nimport { ReadParamsSchema, type ReadParams } from '../../schemas/readTool';\nimport {\n  applyImageLimits,\n  imageLimits,\n  type ReadContentPart,\n  type ReadImageResizeOperations,\n  type ReadTextPart,\n} from '../readImage';\n\nconst resizeOperations: ReadImageResizeOperations = {\n  resize: resizeImage,\n  formatDimensionNote: (result) => formatDimensionNote(result),\n};\n\nexport interface ReadToolResult {\n  content: ReadContentPart[];\n  details?: ReadToolDetails;\n}\n\ninterface ReadTextToolResult {\n  content: ReadTextPart[];\n  details?: ReadToolDetails;\n}\n\nexport function assertNotAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw new Error('Operation aborted');\n}\n\nexport function isImagePath(filePath: string): string | undefined {\n  const extension = filePath.toLowerCase().match(/\\.([a-z0-9]+)$/u)?.[1];\n  if (!extension) return undefined;\n  const mimeTypes: Record<string, string> = {\n    avif: 'image/avif',\n    gif: 'image/gif',\n    jpeg: 'image/jpeg',\n    jpg: 'image/jpeg',\n    png: 'image/png',\n    webp: 'image/webp',\n  };\n  return mimeTypes[extension];\n}\n\nexport async function executeHeadlessRead(\n  params: ReadParams,\n  cwd: string,\n  signal: AbortSignal | undefined,\n  filesystem: FileSystem,\n): Promise<ReadToolResult> {\n  assertNotAborted(signal);\n  const absolutePath = await resolveReadInputPath(params.path, cwd);\n  const context = signal ? withAbortSignal(signal, BACKGROUND_CONTEXT) : BACKGROUND_CONTEXT;\n  let bytes: Buffer;\n  try {\n    bytes = Buffer.from(await readBoundedFile(filesystem, absolutePath, 8 * 1024 * 1024, context));\n  } catch (error) {\n    if (error instanceof FileTooLargeError) {\n      throw new Error('File is over 8 MiB, hashline read refuses; use runner log tools for logs.', { cause: error });\n    }\n    throw error;\n  }\n  assertNotAborted(signal);\n  const mimeType = isImagePath(absolutePath);\n  if (mimeType) {\n    const content: ReadContentPart[] = [\n      { type: 'text', text: `Read image file ${displayPath(absolutePath, cwd)} [${mimeType}]` },\n      { type: 'image', data: bytes.toString('base64'), mimeType },\n    ];\n    return { content: await applyImageLimits(content, imageLimits(), resizeOperations) };\n  }\n  if (!(await isWritableFile(absolutePath))) {\n    return { content: [{ type: 'text', text: decodeUtf8(bytes, displayPath(absolutePath, cwd)) }] };\n  }\n  return createTaggedReadResult(bytes, displayPath(absolutePath, cwd), params);\n}\n\nexport function createTaggedReadResult(bytes: Buffer, path: string, params: ReadParams): ReadTextToolResult {\n  const lines = splitLines(decodeUtf8(bytes, path));\n  const startIndex = params.offset === undefined ? 0 : params.offset - 1;\n  if (startIndex >= lines.length) {\n    throw new Error(`Offset ${params.offset} is beyond end of file (${lines.length} lines total).`);\n  }\n\n  const endIndex = params.limit === undefined ? lines.length : Math.min(lines.length, startIndex + params.limit);\n  const selected = lines.slice(startIndex, endIndex);\n  const header = formatFileHeader(path, computeFileTag(bytes));\n  const compactedLines: number[] = [];\n  const headerBytes = Buffer.byteLength(header, 'utf8') + 1;\n  const tagged = selected.map((line, index) => {\n    const lineNumber = startIndex + index + 1;\n    const full = formatTaggedLine(line, lineNumber);\n    if (Buffer.byteLength(full, 'utf8') <= DEFAULT_MAX_BYTES - headerBytes) return full;\n    compactedLines.push(lineNumber);\n    return formatTaggedLine(truncateLine(line).text, lineNumber, '', line);\n  });\n  const truncation = truncateHead([header, ...tagged].join('\\n'));\n  let text = truncation.content;\n  let details: ReadToolDetails | undefined;\n\n  if (truncation.truncated) {\n    const shownLines = Math.max(0, truncation.outputLines - 1);\n    const nextOffset = startIndex + shownLines + 1;\n    const reason = truncation.truncatedBy === 'bytes' ? `, ${formatSize(DEFAULT_MAX_BYTES)} limit` : '';\n    text += `\\n\\n[Showing ${shownLines} anchored lines${reason}. Use offset=${nextOffset} to continue.]`;\n    details = { truncation };\n  } else {\n    const notices: string[] = [];\n    if (compactedLines.length > 0) {\n      notices.push(`Lines ${compactedLines.join(', ')} shown compactly. Their anchors hash the full original lines`);\n    }\n    if (endIndex < lines.length) {\n      notices.push(`${lines.length - endIndex} more lines in file. Use offset=${endIndex + 1} to continue`);\n    }\n    if (notices.length > 0) text += `\\n\\n[${notices.join('. ')}.]`;\n  }\n\n  return { content: [{ type: 'text', text }], details };\n}\n\nexport function isImageRead(content: readonly { readonly type: string; readonly text?: string }[]): boolean {\n  return content.some((part) => part.type === 'image' || part.text?.startsWith('Read image file') === true);\n}\n\nexport function createHeadlessReadTool(\n  filesystem: FileSystem | (() => FileSystem),\n): PoHeadlessTool<typeof ReadParamsSchema> {\n  return {\n    name: 'read',\n    label: 'read',\n    description:\n      'Read a writable text file with an exact-byte file tag and stable line anchors. Non-writable files and images return native-compatible content. Files over 8 MiB are refused. Text is truncated to 50.0KB.',\n    promptSnippet: 'Read file contents with snapshot-bound line anchors',\n    promptGuidelines: [\n      'Use read before edit. When hashline metadata is present, preserve the @file hash and anchors such as 5#abc exactly.',\n      'Continue large reads with offset until the required anchored lines are visible.',\n    ],\n    parameters: ReadParamsSchema,\n    executionMode: 'parallel',\n    execute: async (\n      _toolCallId: string,\n      params: ReadParams,\n      signal: AbortSignal | undefined,\n      _onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => executeHeadlessRead(params, context.cwd, signal, typeof filesystem === 'function' ? filesystem() : filesystem),\n  };\n}\n","import { defineMcpTool, type PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\nimport { PO_FS_SERVICE, type FileSystem } from '@agimon-ai/po-core/platform';\n\nimport { createHeadlessReadTool } from '../../../../../services/readTool';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => {\n  const filesystem = context.services.get<FileSystem>(PO_FS_SERVICE);\n  if (!filesystem) throw new Error('Read filesystem service is unavailable.');\n  return {\n    ...createHeadlessReadTool(filesystem),\n    description:\n      \"Read a text file from the Po session's repository on the host machine (open, view, cat). Returns a file hash and line anchors such as 5#abc that this server's edit tool requires. Use offset and limit for large files; files over 8 MiB are refused; text is truncated at 2000 lines or 50KB.\",\n  };\n});\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineMcpPlugin, type PoMcpSessionPlugin } from '@agimon-ai/po-core/mcpFacet';\n\nimport toolRead from '../src/extensions/workspaces/sessions/(backend)/tool/read.mcp';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nconst withWidget = <T>(key: string, value: T): T => value === undefined ? value : ({\n  ...value, _meta: { ...(value as { _meta?: object })._meta, [\"po/widget\"]: key },\n});\n\nexport const mcp = defineMcpPlugin({\n  name: '@agimon-ai/po-read',\n  session: (context) => ({\n    get tools(): PoMcpSessionPlugin['tools'] { return [withWidget(\"@agimon-ai/po-read/read\", via({ name: 'read' }, at(toolRead, context)))]; },\n  }) satisfies PoMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":"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"}
+{"version":3,"file":"mcp.cjs","names":["Type","resizeImage","formatDimensionNote","loadPiImageSettings","resolveReadInputPath","withAbortSignal","BACKGROUND_CONTEXT","readBoundedFile","FileTooLargeError","displayPath","isWritableFile","decodeUtf8","splitLines","formatFileHeader","computeFileTag","formatTaggedLine","DEFAULT_MAX_BYTES","truncateLine","truncateHead","formatSize","defineMcpTool","PO_FS_SERVICE","defineMcpPlugin","toolRead"],"sources":["../../src/schemas/readTool.ts","../../src/services/readHost/index.ts","../../src/services/readImage/index.ts","../../src/services/readTool/index.ts","../../src/extensions/workspaces/sessions/(backend)/tool/read.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const ReadParamsSchema = Type.Object({\n  path: Type.String({ description: 'Path to the file to read.' }),\n  offset: Type.Optional(Type.Integer({ minimum: 1, description: 'One-based line offset.' })),\n  limit: Type.Optional(Type.Integer({ minimum: 1, description: 'Maximum number of lines to return.' })),\n});\n\nexport type ReadParams = Static<typeof ReadParamsSchema>;\n","import { loadPiImageSettings, type PiImageSettings } from '@agimon-ai/po-config/piConfig';\nimport type { FileSystem } from '@agimon-ai/po-core/platform';\nimport {\n  DEFAULT_MAX_BYTES,\n  formatDimensionNote,\n  formatSize,\n  resizeImage,\n  truncateHead,\n  truncateLine,\n} from '@earendil-works/pi-coding-agent';\n\nimport type { ReadImageResizeOperations } from '../readImage';\nimport type { ReadHostContext } from './type';\n\n// The Node form of the read tool's host seam: Pi's own limits and resizer, and the image settings Pi keeps under the\n// user's home. ./index.edge replaces this module in the Worker build, where Pi cannot load.\nexport { DEFAULT_MAX_BYTES, formatSize, truncateHead, truncateLine };\n\nexport const resizeOperations: ReadImageResizeOperations = {\n  resize: resizeImage,\n  formatDimensionNote: (result) => formatDimensionNote(result),\n};\n\nexport async function readImageLimits(_filesystem: FileSystem, _context: ReadHostContext): Promise<PiImageSettings> {\n  return loadPiImageSettings();\n}\n","import type { PiImageSettings } from '@agimon-ai/po-config/piConfig';\n\nconst OMITTED_NOTE = '[Image omitted: could not be resized below the inline image size limit.]';\n\nexport interface ReadTextPart {\n  type: 'text';\n  text: string;\n}\n\nexport interface ReadImagePart {\n  type: 'image';\n  data: string;\n  mimeType: string;\n}\n\nexport type ReadContentPart = ReadTextPart | ReadImagePart;\n\nexport interface ReadImageResizeResult {\n  readonly data: string;\n  readonly mimeType: string;\n  readonly originalWidth: number;\n  readonly originalHeight: number;\n  readonly width: number;\n  readonly height: number;\n  readonly wasResized: boolean;\n}\n\nexport interface ReadImageResizeOperations {\n  resize(\n    inputBytes: Uint8Array,\n    mimeType: string,\n    options: { readonly maxWidth: number; readonly maxHeight: number },\n  ): Promise<ReadImageResizeResult | null>;\n  formatDimensionNote(result: ReadImageResizeResult): string | undefined;\n}\n\nexport async function applyImageLimits(\n  content: ReadContentPart[],\n  limits: PiImageSettings,\n  operations: ReadImageResizeOperations,\n): Promise<ReadContentPart[]> {\n  if (!limits.autoResize || !content.some((part) => part.type === 'image')) return content;\n  const resolved: ReadContentPart[] = [];\n  for (const part of content) {\n    if (part.type !== 'image') {\n      resolved.push(part);\n      continue;\n    }\n    const resized = await operations.resize(Buffer.from(part.data, 'base64'), part.mimeType, {\n      maxWidth: limits.maxDimension,\n      maxHeight: limits.maxDimension,\n    });\n    if (!resized) {\n      resolved.push({ type: 'text', text: OMITTED_NOTE });\n      continue;\n    }\n    resolved.push({ type: 'image', data: resized.data, mimeType: resized.mimeType });\n    const note = operations.formatDimensionNote(resized);\n    if (note) resolved.push({ type: 'text', text: note });\n  }\n  return resolved;\n}\n","import type { PoHeadlessExecutionContext, PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport {\n  BACKGROUND_CONTEXT,\n  FileTooLargeError,\n  readBoundedFile,\n  withAbortSignal,\n  type FileSystem,\n} from '@agimon-ai/po-core/platform';\nimport { formatFileHeader, formatTaggedLine, splitLines } from '@agimon-ai/po-hashline';\nimport {\n  computeFileTag,\n  decodeUtf8,\n  displayPath,\n  isWritableFile,\n  resolveReadInputPath,\n} from '@agimon-ai/po-hashline/files';\nimport type { ReadToolDetails } from '@earendil-works/pi-coding-agent';\n\nimport { ReadParamsSchema, type ReadParams } from '../../schemas/readTool';\nimport {\n  DEFAULT_MAX_BYTES,\n  formatSize,\n  readImageLimits,\n  resizeOperations,\n  truncateHead,\n  truncateLine,\n} from '../readHost';\nimport { applyImageLimits, type ReadContentPart, type ReadTextPart } from '../readImage';\n\nexport interface ReadToolResult {\n  content: ReadContentPart[];\n  details?: ReadToolDetails;\n}\n\ninterface ReadTextToolResult {\n  content: ReadTextPart[];\n  details?: ReadToolDetails;\n}\n\nexport function assertNotAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw new Error('Operation aborted');\n}\n\nexport function isImagePath(filePath: string): string | undefined {\n  const extension = filePath.toLowerCase().match(/\\.([a-z0-9]+)$/u)?.[1];\n  if (!extension) return undefined;\n  const mimeTypes: Record<string, string> = {\n    avif: 'image/avif',\n    gif: 'image/gif',\n    jpeg: 'image/jpeg',\n    jpg: 'image/jpeg',\n    png: 'image/png',\n    webp: 'image/webp',\n  };\n  return mimeTypes[extension];\n}\n\nexport async function executeHeadlessRead(\n  params: ReadParams,\n  cwd: string,\n  signal: AbortSignal | undefined,\n  filesystem: FileSystem,\n): Promise<ReadToolResult> {\n  assertNotAborted(signal);\n  const absolutePath = await resolveReadInputPath(params.path, cwd);\n  const context = signal ? withAbortSignal(signal, BACKGROUND_CONTEXT) : BACKGROUND_CONTEXT;\n  let bytes: Buffer;\n  try {\n    bytes = Buffer.from(await readBoundedFile(filesystem, absolutePath, 8 * 1024 * 1024, context));\n  } catch (error) {\n    if (error instanceof FileTooLargeError) {\n      throw new Error('File is over 8 MiB, hashline read refuses; use runner log tools for logs.', { cause: error });\n    }\n    throw error;\n  }\n  assertNotAborted(signal);\n  const mimeType = isImagePath(absolutePath);\n  if (mimeType) {\n    const content: ReadContentPart[] = [\n      { type: 'text', text: `Read image file ${displayPath(absolutePath, cwd)} [${mimeType}]` },\n      { type: 'image', data: bytes.toString('base64'), mimeType },\n    ];\n    return { content: await applyImageLimits(content, await readImageLimits(filesystem, context), resizeOperations) };\n  }\n  if (!(await isWritableFile(absolutePath))) {\n    return { content: [{ type: 'text', text: decodeUtf8(bytes, displayPath(absolutePath, cwd)) }] };\n  }\n  return createTaggedReadResult(bytes, displayPath(absolutePath, cwd), params);\n}\n\nexport function createTaggedReadResult(bytes: Buffer, path: string, params: ReadParams): ReadTextToolResult {\n  const lines = splitLines(decodeUtf8(bytes, path));\n  const startIndex = params.offset === undefined ? 0 : params.offset - 1;\n  if (startIndex >= lines.length) {\n    throw new Error(`Offset ${params.offset} is beyond end of file (${lines.length} lines total).`);\n  }\n\n  const endIndex = params.limit === undefined ? lines.length : Math.min(lines.length, startIndex + params.limit);\n  const selected = lines.slice(startIndex, endIndex);\n  const header = formatFileHeader(path, computeFileTag(bytes));\n  const compactedLines: number[] = [];\n  const headerBytes = Buffer.byteLength(header, 'utf8') + 1;\n  const tagged = selected.map((line, index) => {\n    const lineNumber = startIndex + index + 1;\n    const full = formatTaggedLine(line, lineNumber);\n    if (Buffer.byteLength(full, 'utf8') <= DEFAULT_MAX_BYTES - headerBytes) return full;\n    compactedLines.push(lineNumber);\n    return formatTaggedLine(truncateLine(line).text, lineNumber, '', line);\n  });\n  const truncation = truncateHead([header, ...tagged].join('\\n'));\n  let text = truncation.content;\n  let details: ReadToolDetails | undefined;\n\n  if (truncation.truncated) {\n    const shownLines = Math.max(0, truncation.outputLines - 1);\n    const nextOffset = startIndex + shownLines + 1;\n    const reason = truncation.truncatedBy === 'bytes' ? `, ${formatSize(DEFAULT_MAX_BYTES)} limit` : '';\n    text += `\\n\\n[Showing ${shownLines} anchored lines${reason}. Use offset=${nextOffset} to continue.]`;\n    details = { truncation };\n  } else {\n    const notices: string[] = [];\n    if (compactedLines.length > 0) {\n      notices.push(`Lines ${compactedLines.join(', ')} shown compactly. Their anchors hash the full original lines`);\n    }\n    if (endIndex < lines.length) {\n      notices.push(`${lines.length - endIndex} more lines in file. Use offset=${endIndex + 1} to continue`);\n    }\n    if (notices.length > 0) text += `\\n\\n[${notices.join('. ')}.]`;\n  }\n\n  return { content: [{ type: 'text', text }], details };\n}\n\nexport function isImageRead(content: readonly { readonly type: string; readonly text?: string }[]): boolean {\n  return content.some((part) => part.type === 'image' || part.text?.startsWith('Read image file') === true);\n}\n\nexport function createHeadlessReadTool(\n  filesystem: FileSystem | (() => FileSystem),\n): PoHeadlessTool<typeof ReadParamsSchema> {\n  return {\n    name: 'read',\n    label: 'read',\n    description:\n      'Read a writable text file with an exact-byte file tag and stable line anchors. Non-writable files and images return native-compatible content. Files over 8 MiB are refused. Text is truncated to 50.0KB.',\n    promptSnippet: 'Read file contents with snapshot-bound line anchors',\n    promptGuidelines: [\n      'Use read before edit. When hashline metadata is present, preserve the @file hash and anchors such as 5#abc exactly.',\n      'Continue large reads with offset until the required anchored lines are visible.',\n    ],\n    parameters: ReadParamsSchema,\n    executionMode: 'parallel',\n    execute: async (\n      _toolCallId: string,\n      params: ReadParams,\n      signal: AbortSignal | undefined,\n      _onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => executeHeadlessRead(params, context.cwd, signal, typeof filesystem === 'function' ? filesystem() : filesystem),\n  };\n}\n","import { defineMcpTool, type PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\nimport { PO_FS_SERVICE, type FileSystem } from '@agimon-ai/po-core/platform';\n\nimport { createHeadlessReadTool } from '../../../../../services/readTool';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => {\n  const filesystem = context.services.get<FileSystem>(PO_FS_SERVICE);\n  if (!filesystem) throw new Error('Read filesystem service is unavailable.');\n  return {\n    ...createHeadlessReadTool(filesystem),\n    description:\n      \"Read a text file from the Po session's repository on the host machine (open, view, cat). Returns a file hash and line anchors such as 5#abc that this server's edit tool requires. Use offset and limit for large files; files over 8 MiB are refused; text is truncated at 2000 lines or 50KB.\",\n  };\n});\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineMcpPlugin, type PoMcpSessionPlugin } from '@agimon-ai/po-core/mcpFacet';\n\nimport toolRead from '../src/extensions/workspaces/sessions/(backend)/tool/read.mcp';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nconst withWidget = <T>(key: string, value: T): T => value === undefined ? value : ({\n  ...value, _meta: { ...(value as { _meta?: object })._meta, [\"po/widget\"]: key },\n});\n\nexport const mcp = defineMcpPlugin({\n  name: '@agimon-ai/po-read',\n  session: (context) => ({\n    get tools(): PoMcpSessionPlugin['tools'] { return [withWidget(\"@agimon-ai/po-read/read\", via({ name: 'read' }, at(toolRead, context)))]; },\n  }) satisfies PoMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":"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"}

package/dist/extensions/mcp.mjs

@@ -2,9 +2,9 @@ import { defineMcpPlugin, defineMcpTool } from "@agimon-ai/po-core/mcpFacet";
 import { BACKGROUND_CONTEXT, FileTooLargeError, PO_FS_SERVICE, readBoundedFile, withAbortSignal } from "@agimon-ai/po-core/platform";
 import { formatFileHeader, formatTaggedLine, splitLines } from "@agimon-ai/po-hashline";
 import { computeFileTag, decodeUtf8, displayPath, isWritableFile, resolveReadInputPath } from "@agimon-ai/po-hashline/files";
-import { DEFAULT_MAX_BYTES, formatDimensionNote, formatSize, resizeImage, truncateHead, truncateLine } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import { loadPiImageSettings } from "@agimon-ai/po-config/piConfig";
+import { DEFAULT_MAX_BYTES, formatDimensionNote, formatSize, resizeImage, truncateHead, truncateLine } from "@earendil-works/pi-coding-agent";
 //#region src/schemas/readTool.ts
 const ReadParamsSchema = Type.Object({
 	path: Type.String({ description: "Path to the file to read." }),
@@ -18,11 +18,17 @@ const ReadParamsSchema = Type.Object({
 	}))
 });
 //#endregion
-//#region src/services/readImage/index.ts
-const OMITTED_NOTE = "[Image omitted: could not be resized below the inline image size limit.]";
-function imageLimits() {
+//#region src/services/readHost/index.ts
+const resizeOperations = {
+	resize: resizeImage,
+	formatDimensionNote: (result) => formatDimensionNote(result)
+};
+async function readImageLimits(_filesystem, _context) {
 	return loadPiImageSettings();
 }
+//#endregion
+//#region src/services/readImage/index.ts
+const OMITTED_NOTE = "[Image omitted: could not be resized below the inline image size limit.]";
 async function applyImageLimits(content, limits, operations) {
 	if (!limits.autoResize || !content.some((part) => part.type === "image")) return content;
 	const resolved = [];
@@ -57,10 +63,6 @@ async function applyImageLimits(content, limits, operations) {
 }
 //#endregion
 //#region src/services/readTool/index.ts
-const resizeOperations = {
-	resize: resizeImage,
-	formatDimensionNote: (result) => formatDimensionNote(result)
-};
 function assertNotAborted(signal) {
 	if (signal?.aborted) throw new Error("Operation aborted");
 }
@@ -96,7 +98,7 @@ async function executeHeadlessRead(params, cwd, signal, filesystem) {
 		type: "image",
 		data: bytes.toString("base64"),
 		mimeType
-	}], imageLimits(), resizeOperations) };
+	}], await readImageLimits(filesystem, context), resizeOperations) };
 	if (!await isWritableFile(absolutePath)) return { content: [{
 		type: "text",
 		text: decodeUtf8(bytes, displayPath(absolutePath, cwd))

package/dist/extensions/mcp.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.mjs","names":["toolRead"],"sources":["../../src/schemas/readTool.ts","../../src/services/readImage/index.ts","../../src/services/readTool/index.ts","../../src/extensions/workspaces/sessions/(backend)/tool/read.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const ReadParamsSchema = Type.Object({\n  path: Type.String({ description: 'Path to the file to read.' }),\n  offset: Type.Optional(Type.Integer({ minimum: 1, description: 'One-based line offset.' })),\n  limit: Type.Optional(Type.Integer({ minimum: 1, description: 'Maximum number of lines to return.' })),\n});\n\nexport type ReadParams = Static<typeof ReadParamsSchema>;\n","import { loadPiImageSettings, type PiImageSettings } from '@agimon-ai/po-config/piConfig';\n\nconst OMITTED_NOTE = '[Image omitted: could not be resized below the inline image size limit.]';\n\nexport interface ReadTextPart {\n  type: 'text';\n  text: string;\n}\n\nexport interface ReadImagePart {\n  type: 'image';\n  data: string;\n  mimeType: string;\n}\n\nexport type ReadContentPart = ReadTextPart | ReadImagePart;\n\nexport interface ReadImageResizeResult {\n  readonly data: string;\n  readonly mimeType: string;\n  readonly originalWidth: number;\n  readonly originalHeight: number;\n  readonly width: number;\n  readonly height: number;\n  readonly wasResized: boolean;\n}\n\nexport interface ReadImageResizeOperations {\n  resize(\n    inputBytes: Uint8Array,\n    mimeType: string,\n    options: { readonly maxWidth: number; readonly maxHeight: number },\n  ): Promise<ReadImageResizeResult | null>;\n  formatDimensionNote(result: ReadImageResizeResult): string | undefined;\n}\n\nexport function imageLimits(): PiImageSettings {\n  return loadPiImageSettings();\n}\n\nexport async function applyImageLimits(\n  content: ReadContentPart[],\n  limits: PiImageSettings,\n  operations: ReadImageResizeOperations,\n): Promise<ReadContentPart[]> {\n  if (!limits.autoResize || !content.some((part) => part.type === 'image')) return content;\n  const resolved: ReadContentPart[] = [];\n  for (const part of content) {\n    if (part.type !== 'image') {\n      resolved.push(part);\n      continue;\n    }\n    const resized = await operations.resize(Buffer.from(part.data, 'base64'), part.mimeType, {\n      maxWidth: limits.maxDimension,\n      maxHeight: limits.maxDimension,\n    });\n    if (!resized) {\n      resolved.push({ type: 'text', text: OMITTED_NOTE });\n      continue;\n    }\n    resolved.push({ type: 'image', data: resized.data, mimeType: resized.mimeType });\n    const note = operations.formatDimensionNote(resized);\n    if (note) resolved.push({ type: 'text', text: note });\n  }\n  return resolved;\n}\n","import type { PoHeadlessExecutionContext, PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport {\n  BACKGROUND_CONTEXT,\n  FileTooLargeError,\n  readBoundedFile,\n  withAbortSignal,\n  type FileSystem,\n} from '@agimon-ai/po-core/platform';\nimport { formatFileHeader, formatTaggedLine, splitLines } from '@agimon-ai/po-hashline';\nimport {\n  computeFileTag,\n  decodeUtf8,\n  displayPath,\n  isWritableFile,\n  resolveReadInputPath,\n} from '@agimon-ai/po-hashline/files';\nimport {\n  DEFAULT_MAX_BYTES,\n  formatDimensionNote,\n  formatSize,\n  resizeImage,\n  truncateHead,\n  truncateLine,\n  type ReadToolDetails,\n} from '@earendil-works/pi-coding-agent';\n\nimport { ReadParamsSchema, type ReadParams } from '../../schemas/readTool';\nimport {\n  applyImageLimits,\n  imageLimits,\n  type ReadContentPart,\n  type ReadImageResizeOperations,\n  type ReadTextPart,\n} from '../readImage';\n\nconst resizeOperations: ReadImageResizeOperations = {\n  resize: resizeImage,\n  formatDimensionNote: (result) => formatDimensionNote(result),\n};\n\nexport interface ReadToolResult {\n  content: ReadContentPart[];\n  details?: ReadToolDetails;\n}\n\ninterface ReadTextToolResult {\n  content: ReadTextPart[];\n  details?: ReadToolDetails;\n}\n\nexport function assertNotAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw new Error('Operation aborted');\n}\n\nexport function isImagePath(filePath: string): string | undefined {\n  const extension = filePath.toLowerCase().match(/\\.([a-z0-9]+)$/u)?.[1];\n  if (!extension) return undefined;\n  const mimeTypes: Record<string, string> = {\n    avif: 'image/avif',\n    gif: 'image/gif',\n    jpeg: 'image/jpeg',\n    jpg: 'image/jpeg',\n    png: 'image/png',\n    webp: 'image/webp',\n  };\n  return mimeTypes[extension];\n}\n\nexport async function executeHeadlessRead(\n  params: ReadParams,\n  cwd: string,\n  signal: AbortSignal | undefined,\n  filesystem: FileSystem,\n): Promise<ReadToolResult> {\n  assertNotAborted(signal);\n  const absolutePath = await resolveReadInputPath(params.path, cwd);\n  const context = signal ? withAbortSignal(signal, BACKGROUND_CONTEXT) : BACKGROUND_CONTEXT;\n  let bytes: Buffer;\n  try {\n    bytes = Buffer.from(await readBoundedFile(filesystem, absolutePath, 8 * 1024 * 1024, context));\n  } catch (error) {\n    if (error instanceof FileTooLargeError) {\n      throw new Error('File is over 8 MiB, hashline read refuses; use runner log tools for logs.', { cause: error });\n    }\n    throw error;\n  }\n  assertNotAborted(signal);\n  const mimeType = isImagePath(absolutePath);\n  if (mimeType) {\n    const content: ReadContentPart[] = [\n      { type: 'text', text: `Read image file ${displayPath(absolutePath, cwd)} [${mimeType}]` },\n      { type: 'image', data: bytes.toString('base64'), mimeType },\n    ];\n    return { content: await applyImageLimits(content, imageLimits(), resizeOperations) };\n  }\n  if (!(await isWritableFile(absolutePath))) {\n    return { content: [{ type: 'text', text: decodeUtf8(bytes, displayPath(absolutePath, cwd)) }] };\n  }\n  return createTaggedReadResult(bytes, displayPath(absolutePath, cwd), params);\n}\n\nexport function createTaggedReadResult(bytes: Buffer, path: string, params: ReadParams): ReadTextToolResult {\n  const lines = splitLines(decodeUtf8(bytes, path));\n  const startIndex = params.offset === undefined ? 0 : params.offset - 1;\n  if (startIndex >= lines.length) {\n    throw new Error(`Offset ${params.offset} is beyond end of file (${lines.length} lines total).`);\n  }\n\n  const endIndex = params.limit === undefined ? lines.length : Math.min(lines.length, startIndex + params.limit);\n  const selected = lines.slice(startIndex, endIndex);\n  const header = formatFileHeader(path, computeFileTag(bytes));\n  const compactedLines: number[] = [];\n  const headerBytes = Buffer.byteLength(header, 'utf8') + 1;\n  const tagged = selected.map((line, index) => {\n    const lineNumber = startIndex + index + 1;\n    const full = formatTaggedLine(line, lineNumber);\n    if (Buffer.byteLength(full, 'utf8') <= DEFAULT_MAX_BYTES - headerBytes) return full;\n    compactedLines.push(lineNumber);\n    return formatTaggedLine(truncateLine(line).text, lineNumber, '', line);\n  });\n  const truncation = truncateHead([header, ...tagged].join('\\n'));\n  let text = truncation.content;\n  let details: ReadToolDetails | undefined;\n\n  if (truncation.truncated) {\n    const shownLines = Math.max(0, truncation.outputLines - 1);\n    const nextOffset = startIndex + shownLines + 1;\n    const reason = truncation.truncatedBy === 'bytes' ? `, ${formatSize(DEFAULT_MAX_BYTES)} limit` : '';\n    text += `\\n\\n[Showing ${shownLines} anchored lines${reason}. Use offset=${nextOffset} to continue.]`;\n    details = { truncation };\n  } else {\n    const notices: string[] = [];\n    if (compactedLines.length > 0) {\n      notices.push(`Lines ${compactedLines.join(', ')} shown compactly. Their anchors hash the full original lines`);\n    }\n    if (endIndex < lines.length) {\n      notices.push(`${lines.length - endIndex} more lines in file. Use offset=${endIndex + 1} to continue`);\n    }\n    if (notices.length > 0) text += `\\n\\n[${notices.join('. ')}.]`;\n  }\n\n  return { content: [{ type: 'text', text }], details };\n}\n\nexport function isImageRead(content: readonly { readonly type: string; readonly text?: string }[]): boolean {\n  return content.some((part) => part.type === 'image' || part.text?.startsWith('Read image file') === true);\n}\n\nexport function createHeadlessReadTool(\n  filesystem: FileSystem | (() => FileSystem),\n): PoHeadlessTool<typeof ReadParamsSchema> {\n  return {\n    name: 'read',\n    label: 'read',\n    description:\n      'Read a writable text file with an exact-byte file tag and stable line anchors. Non-writable files and images return native-compatible content. Files over 8 MiB are refused. Text is truncated to 50.0KB.',\n    promptSnippet: 'Read file contents with snapshot-bound line anchors',\n    promptGuidelines: [\n      'Use read before edit. When hashline metadata is present, preserve the @file hash and anchors such as 5#abc exactly.',\n      'Continue large reads with offset until the required anchored lines are visible.',\n    ],\n    parameters: ReadParamsSchema,\n    executionMode: 'parallel',\n    execute: async (\n      _toolCallId: string,\n      params: ReadParams,\n      signal: AbortSignal | undefined,\n      _onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => executeHeadlessRead(params, context.cwd, signal, typeof filesystem === 'function' ? filesystem() : filesystem),\n  };\n}\n","import { defineMcpTool, type PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\nimport { PO_FS_SERVICE, type FileSystem } from '@agimon-ai/po-core/platform';\n\nimport { createHeadlessReadTool } from '../../../../../services/readTool';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => {\n  const filesystem = context.services.get<FileSystem>(PO_FS_SERVICE);\n  if (!filesystem) throw new Error('Read filesystem service is unavailable.');\n  return {\n    ...createHeadlessReadTool(filesystem),\n    description:\n      \"Read a text file from the Po session's repository on the host machine (open, view, cat). Returns a file hash and line anchors such as 5#abc that this server's edit tool requires. Use offset and limit for large files; files over 8 MiB are refused; text is truncated at 2000 lines or 50KB.\",\n  };\n});\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineMcpPlugin, type PoMcpSessionPlugin } from '@agimon-ai/po-core/mcpFacet';\n\nimport toolRead from '../src/extensions/workspaces/sessions/(backend)/tool/read.mcp';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nconst withWidget = <T>(key: string, value: T): T => value === undefined ? value : ({\n  ...value, _meta: { ...(value as { _meta?: object })._meta, [\"po/widget\"]: key },\n});\n\nexport const mcp = defineMcpPlugin({\n  name: '@agimon-ai/po-read',\n  session: (context) => ({\n    get tools(): PoMcpSessionPlugin['tools'] { return [withWidget(\"@agimon-ai/po-read/read\", via({ name: 'read' }, at(toolRead, context)))]; },\n  }) satisfies PoMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":"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"}
+{"version":3,"file":"mcp.mjs","names":["toolRead"],"sources":["../../src/schemas/readTool.ts","../../src/services/readHost/index.ts","../../src/services/readImage/index.ts","../../src/services/readTool/index.ts","../../src/extensions/workspaces/sessions/(backend)/tool/read.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const ReadParamsSchema = Type.Object({\n  path: Type.String({ description: 'Path to the file to read.' }),\n  offset: Type.Optional(Type.Integer({ minimum: 1, description: 'One-based line offset.' })),\n  limit: Type.Optional(Type.Integer({ minimum: 1, description: 'Maximum number of lines to return.' })),\n});\n\nexport type ReadParams = Static<typeof ReadParamsSchema>;\n","import { loadPiImageSettings, type PiImageSettings } from '@agimon-ai/po-config/piConfig';\nimport type { FileSystem } from '@agimon-ai/po-core/platform';\nimport {\n  DEFAULT_MAX_BYTES,\n  formatDimensionNote,\n  formatSize,\n  resizeImage,\n  truncateHead,\n  truncateLine,\n} from '@earendil-works/pi-coding-agent';\n\nimport type { ReadImageResizeOperations } from '../readImage';\nimport type { ReadHostContext } from './type';\n\n// The Node form of the read tool's host seam: Pi's own limits and resizer, and the image settings Pi keeps under the\n// user's home. ./index.edge replaces this module in the Worker build, where Pi cannot load.\nexport { DEFAULT_MAX_BYTES, formatSize, truncateHead, truncateLine };\n\nexport const resizeOperations: ReadImageResizeOperations = {\n  resize: resizeImage,\n  formatDimensionNote: (result) => formatDimensionNote(result),\n};\n\nexport async function readImageLimits(_filesystem: FileSystem, _context: ReadHostContext): Promise<PiImageSettings> {\n  return loadPiImageSettings();\n}\n","import type { PiImageSettings } from '@agimon-ai/po-config/piConfig';\n\nconst OMITTED_NOTE = '[Image omitted: could not be resized below the inline image size limit.]';\n\nexport interface ReadTextPart {\n  type: 'text';\n  text: string;\n}\n\nexport interface ReadImagePart {\n  type: 'image';\n  data: string;\n  mimeType: string;\n}\n\nexport type ReadContentPart = ReadTextPart | ReadImagePart;\n\nexport interface ReadImageResizeResult {\n  readonly data: string;\n  readonly mimeType: string;\n  readonly originalWidth: number;\n  readonly originalHeight: number;\n  readonly width: number;\n  readonly height: number;\n  readonly wasResized: boolean;\n}\n\nexport interface ReadImageResizeOperations {\n  resize(\n    inputBytes: Uint8Array,\n    mimeType: string,\n    options: { readonly maxWidth: number; readonly maxHeight: number },\n  ): Promise<ReadImageResizeResult | null>;\n  formatDimensionNote(result: ReadImageResizeResult): string | undefined;\n}\n\nexport async function applyImageLimits(\n  content: ReadContentPart[],\n  limits: PiImageSettings,\n  operations: ReadImageResizeOperations,\n): Promise<ReadContentPart[]> {\n  if (!limits.autoResize || !content.some((part) => part.type === 'image')) return content;\n  const resolved: ReadContentPart[] = [];\n  for (const part of content) {\n    if (part.type !== 'image') {\n      resolved.push(part);\n      continue;\n    }\n    const resized = await operations.resize(Buffer.from(part.data, 'base64'), part.mimeType, {\n      maxWidth: limits.maxDimension,\n      maxHeight: limits.maxDimension,\n    });\n    if (!resized) {\n      resolved.push({ type: 'text', text: OMITTED_NOTE });\n      continue;\n    }\n    resolved.push({ type: 'image', data: resized.data, mimeType: resized.mimeType });\n    const note = operations.formatDimensionNote(resized);\n    if (note) resolved.push({ type: 'text', text: note });\n  }\n  return resolved;\n}\n","import type { PoHeadlessExecutionContext, PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport {\n  BACKGROUND_CONTEXT,\n  FileTooLargeError,\n  readBoundedFile,\n  withAbortSignal,\n  type FileSystem,\n} from '@agimon-ai/po-core/platform';\nimport { formatFileHeader, formatTaggedLine, splitLines } from '@agimon-ai/po-hashline';\nimport {\n  computeFileTag,\n  decodeUtf8,\n  displayPath,\n  isWritableFile,\n  resolveReadInputPath,\n} from '@agimon-ai/po-hashline/files';\nimport type { ReadToolDetails } from '@earendil-works/pi-coding-agent';\n\nimport { ReadParamsSchema, type ReadParams } from '../../schemas/readTool';\nimport {\n  DEFAULT_MAX_BYTES,\n  formatSize,\n  readImageLimits,\n  resizeOperations,\n  truncateHead,\n  truncateLine,\n} from '../readHost';\nimport { applyImageLimits, type ReadContentPart, type ReadTextPart } from '../readImage';\n\nexport interface ReadToolResult {\n  content: ReadContentPart[];\n  details?: ReadToolDetails;\n}\n\ninterface ReadTextToolResult {\n  content: ReadTextPart[];\n  details?: ReadToolDetails;\n}\n\nexport function assertNotAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw new Error('Operation aborted');\n}\n\nexport function isImagePath(filePath: string): string | undefined {\n  const extension = filePath.toLowerCase().match(/\\.([a-z0-9]+)$/u)?.[1];\n  if (!extension) return undefined;\n  const mimeTypes: Record<string, string> = {\n    avif: 'image/avif',\n    gif: 'image/gif',\n    jpeg: 'image/jpeg',\n    jpg: 'image/jpeg',\n    png: 'image/png',\n    webp: 'image/webp',\n  };\n  return mimeTypes[extension];\n}\n\nexport async function executeHeadlessRead(\n  params: ReadParams,\n  cwd: string,\n  signal: AbortSignal | undefined,\n  filesystem: FileSystem,\n): Promise<ReadToolResult> {\n  assertNotAborted(signal);\n  const absolutePath = await resolveReadInputPath(params.path, cwd);\n  const context = signal ? withAbortSignal(signal, BACKGROUND_CONTEXT) : BACKGROUND_CONTEXT;\n  let bytes: Buffer;\n  try {\n    bytes = Buffer.from(await readBoundedFile(filesystem, absolutePath, 8 * 1024 * 1024, context));\n  } catch (error) {\n    if (error instanceof FileTooLargeError) {\n      throw new Error('File is over 8 MiB, hashline read refuses; use runner log tools for logs.', { cause: error });\n    }\n    throw error;\n  }\n  assertNotAborted(signal);\n  const mimeType = isImagePath(absolutePath);\n  if (mimeType) {\n    const content: ReadContentPart[] = [\n      { type: 'text', text: `Read image file ${displayPath(absolutePath, cwd)} [${mimeType}]` },\n      { type: 'image', data: bytes.toString('base64'), mimeType },\n    ];\n    return { content: await applyImageLimits(content, await readImageLimits(filesystem, context), resizeOperations) };\n  }\n  if (!(await isWritableFile(absolutePath))) {\n    return { content: [{ type: 'text', text: decodeUtf8(bytes, displayPath(absolutePath, cwd)) }] };\n  }\n  return createTaggedReadResult(bytes, displayPath(absolutePath, cwd), params);\n}\n\nexport function createTaggedReadResult(bytes: Buffer, path: string, params: ReadParams): ReadTextToolResult {\n  const lines = splitLines(decodeUtf8(bytes, path));\n  const startIndex = params.offset === undefined ? 0 : params.offset - 1;\n  if (startIndex >= lines.length) {\n    throw new Error(`Offset ${params.offset} is beyond end of file (${lines.length} lines total).`);\n  }\n\n  const endIndex = params.limit === undefined ? lines.length : Math.min(lines.length, startIndex + params.limit);\n  const selected = lines.slice(startIndex, endIndex);\n  const header = formatFileHeader(path, computeFileTag(bytes));\n  const compactedLines: number[] = [];\n  const headerBytes = Buffer.byteLength(header, 'utf8') + 1;\n  const tagged = selected.map((line, index) => {\n    const lineNumber = startIndex + index + 1;\n    const full = formatTaggedLine(line, lineNumber);\n    if (Buffer.byteLength(full, 'utf8') <= DEFAULT_MAX_BYTES - headerBytes) return full;\n    compactedLines.push(lineNumber);\n    return formatTaggedLine(truncateLine(line).text, lineNumber, '', line);\n  });\n  const truncation = truncateHead([header, ...tagged].join('\\n'));\n  let text = truncation.content;\n  let details: ReadToolDetails | undefined;\n\n  if (truncation.truncated) {\n    const shownLines = Math.max(0, truncation.outputLines - 1);\n    const nextOffset = startIndex + shownLines + 1;\n    const reason = truncation.truncatedBy === 'bytes' ? `, ${formatSize(DEFAULT_MAX_BYTES)} limit` : '';\n    text += `\\n\\n[Showing ${shownLines} anchored lines${reason}. Use offset=${nextOffset} to continue.]`;\n    details = { truncation };\n  } else {\n    const notices: string[] = [];\n    if (compactedLines.length > 0) {\n      notices.push(`Lines ${compactedLines.join(', ')} shown compactly. Their anchors hash the full original lines`);\n    }\n    if (endIndex < lines.length) {\n      notices.push(`${lines.length - endIndex} more lines in file. Use offset=${endIndex + 1} to continue`);\n    }\n    if (notices.length > 0) text += `\\n\\n[${notices.join('. ')}.]`;\n  }\n\n  return { content: [{ type: 'text', text }], details };\n}\n\nexport function isImageRead(content: readonly { readonly type: string; readonly text?: string }[]): boolean {\n  return content.some((part) => part.type === 'image' || part.text?.startsWith('Read image file') === true);\n}\n\nexport function createHeadlessReadTool(\n  filesystem: FileSystem | (() => FileSystem),\n): PoHeadlessTool<typeof ReadParamsSchema> {\n  return {\n    name: 'read',\n    label: 'read',\n    description:\n      'Read a writable text file with an exact-byte file tag and stable line anchors. Non-writable files and images return native-compatible content. Files over 8 MiB are refused. Text is truncated to 50.0KB.',\n    promptSnippet: 'Read file contents with snapshot-bound line anchors',\n    promptGuidelines: [\n      'Use read before edit. When hashline metadata is present, preserve the @file hash and anchors such as 5#abc exactly.',\n      'Continue large reads with offset until the required anchored lines are visible.',\n    ],\n    parameters: ReadParamsSchema,\n    executionMode: 'parallel',\n    execute: async (\n      _toolCallId: string,\n      params: ReadParams,\n      signal: AbortSignal | undefined,\n      _onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => executeHeadlessRead(params, context.cwd, signal, typeof filesystem === 'function' ? filesystem() : filesystem),\n  };\n}\n","import { defineMcpTool, type PoMcpPluginContext } from '@agimon-ai/po-core/mcpFacet';\nimport { PO_FS_SERVICE, type FileSystem } from '@agimon-ai/po-core/platform';\n\nimport { createHeadlessReadTool } from '../../../../../services/readTool';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => {\n  const filesystem = context.services.get<FileSystem>(PO_FS_SERVICE);\n  if (!filesystem) throw new Error('Read filesystem service is unavailable.');\n  return {\n    ...createHeadlessReadTool(filesystem),\n    description:\n      \"Read a text file from the Po session's repository on the host machine (open, view, cat). Returns a file hash and line anchors such as 5#abc that this server's edit tool requires. Use offset and limit for large files; files over 8 MiB are refused; text is truncated at 2000 lines or 50KB.\",\n  };\n});\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineMcpPlugin, type PoMcpSessionPlugin } from '@agimon-ai/po-core/mcpFacet';\n\nimport toolRead from '../src/extensions/workspaces/sessions/(backend)/tool/read.mcp';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nconst withWidget = <T>(key: string, value: T): T => value === undefined ? value : ({\n  ...value, _meta: { ...(value as { _meta?: object })._meta, [\"po/widget\"]: key },\n});\n\nexport const mcp = defineMcpPlugin({\n  name: '@agimon-ai/po-read',\n  session: (context) => ({\n    get tools(): PoMcpSessionPlugin['tools'] { return [withWidget(\"@agimon-ai/po-read/read\", via({ name: 'read' }, at(toolRead, context)))]; },\n  }) satisfies PoMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":";;;;;;;;AAEA,MAAa,mBAAmB,KAAK,OAAO;CAC1C,MAAM,KAAK,OAAO,EAAE,aAAa,4BAA4B,CAAC;CAC9D,QAAQ,KAAK,SAAS,KAAK,QAAQ;EAAE,SAAS;EAAG,aAAa;CAAyB,CAAC,CAAC;CACzF,OAAO,KAAK,SAAS,KAAK,QAAQ;EAAE,SAAS;EAAG,aAAa;CAAqC,CAAC,CAAC;AACtG,CAAC;;;ACYD,MAAa,mBAA8C;CACzD,QAAQ;CACR,sBAAsB,WAAW,oBAAoB,MAAM;AAC7D;AAEA,eAAsB,gBAAgB,aAAyB,UAAqD;CAClH,OAAO,oBAAoB;AAC7B;;;ACvBA,MAAM,eAAe;AAkCrB,eAAsB,iBACpB,SACA,QACA,YAC4B;CAC5B,IAAI,CAAC,OAAO,cAAc,CAAC,QAAQ,MAAM,SAAS,KAAK,SAAS,OAAO,GAAG,OAAO;CACjF,MAAM,WAA8B,CAAC;CACrC,KAAK,MAAM,QAAQ,SAAS;EAC1B,IAAI,KAAK,SAAS,SAAS;GACzB,SAAS,KAAK,IAAI;GAClB;EACF;EACA,MAAM,UAAU,MAAM,WAAW,OAAO,OAAO,KAAK,KAAK,MAAM,QAAQ,GAAG,KAAK,UAAU;GACvF,UAAU,OAAO;GACjB,WAAW,OAAO;EACpB,CAAC;EACD,IAAI,CAAC,SAAS;GACZ,SAAS,KAAK;IAAE,MAAM;IAAQ,MAAM;GAAa,CAAC;GAClD;EACF;EACA,SAAS,KAAK;GAAE,MAAM;GAAS,MAAM,QAAQ;GAAM,UAAU,QAAQ;EAAS,CAAC;EAC/E,MAAM,OAAO,WAAW,oBAAoB,OAAO;EACnD,IAAI,MAAM,SAAS,KAAK;GAAE,MAAM;GAAQ,MAAM;EAAK,CAAC;CACtD;CACA,OAAO;AACT;;;ACtBA,SAAgB,iBAAiB,QAAuC;CACtE,IAAI,QAAQ,SAAS,MAAM,IAAI,MAAM,mBAAmB;AAC1D;AAEA,SAAgB,YAAY,UAAsC;CAChE,MAAM,YAAY,SAAS,YAAY,CAAC,CAAC,MAAM,iBAAiB,CAAC,GAAG;CACpE,IAAI,CAAC,WAAW,OAAO,KAAA;CASvB,OAAO;EAPL,MAAM;EACN,KAAK;EACL,MAAM;EACN,KAAK;EACL,KAAK;EACL,MAAM;CAEO,EAAE;AACnB;AAEA,eAAsB,oBACpB,QACA,KACA,QACA,YACyB;CACzB,iBAAiB,MAAM;CACvB,MAAM,eAAe,MAAM,qBAAqB,OAAO,MAAM,GAAG;CAChE,MAAM,UAAU,SAAS,gBAAgB,QAAQ,kBAAkB,IAAI;CACvE,IAAI;CACJ,IAAI;EACF,QAAQ,OAAO,KAAK,MAAM,gBAAgB,YAAY,cAAc,SAAiB,OAAO,CAAC;CAC/F,SAAS,OAAO;EACd,IAAI,iBAAiB,mBACnB,MAAM,IAAI,MAAM,6EAA6E,EAAE,OAAO,MAAM,CAAC;EAE/G,MAAM;CACR;CACA,iBAAiB,MAAM;CACvB,MAAM,WAAW,YAAY,YAAY;CACzC,IAAI,UAKF,OAAO,EAAE,SAAS,MAAM,iBAAiB,CAHvC;EAAE,MAAM;EAAQ,MAAM,mBAAmB,YAAY,cAAc,GAAG,EAAE,IAAI,SAAS;CAAG,GACxF;EAAE,MAAM;EAAS,MAAM,MAAM,SAAS,QAAQ;EAAG;CAAS,CAEnB,GAAS,MAAM,gBAAgB,YAAY,OAAO,GAAG,gBAAgB,EAAE;CAElH,IAAI,CAAE,MAAM,eAAe,YAAY,GACrC,OAAO,EAAE,SAAS,CAAC;EAAE,MAAM;EAAQ,MAAM,WAAW,OAAO,YAAY,cAAc,GAAG,CAAC;CAAE,CAAC,EAAE;CAEhG,OAAO,uBAAuB,OAAO,YAAY,cAAc,GAAG,GAAG,MAAM;AAC7E;AAEA,SAAgB,uBAAuB,OAAe,MAAc,QAAwC;CAC1G,MAAM,QAAQ,WAAW,WAAW,OAAO,IAAI,CAAC;CAChD,MAAM,aAAa,OAAO,WAAW,KAAA,IAAY,IAAI,OAAO,SAAS;CACrE,IAAI,cAAc,MAAM,QACtB,MAAM,IAAI,MAAM,UAAU,OAAO,OAAO,0BAA0B,MAAM,OAAO,eAAe;CAGhG,MAAM,WAAW,OAAO,UAAU,KAAA,IAAY,MAAM,SAAS,KAAK,IAAI,MAAM,QAAQ,aAAa,OAAO,KAAK;CAC7G,MAAM,WAAW,MAAM,MAAM,YAAY,QAAQ;CACjD,MAAM,SAAS,iBAAiB,MAAM,eAAe,KAAK,CAAC;CAC3D,MAAM,iBAA2B,CAAC;CAClC,MAAM,cAAc,OAAO,WAAW,QAAQ,MAAM,IAAI;CACxD,MAAM,SAAS,SAAS,KAAK,MAAM,UAAU;EAC3C,MAAM,aAAa,aAAa,QAAQ;EACxC,MAAM,OAAO,iBAAiB,MAAM,UAAU;EAC9C,IAAI,OAAO,WAAW,MAAM,MAAM,KAAK,oBAAoB,aAAa,OAAO;EAC/E,eAAe,KAAK,UAAU;EAC9B,OAAO,iBAAiB,aAAa,IAAI,CAAC,CAAC,MAAM,YAAY,IAAI,IAAI;CACvE,CAAC;CACD,MAAM,aAAa,aAAa,CAAC,QAAQ,GAAG,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC;CAC9D,IAAI,OAAO,WAAW;CACtB,IAAI;CAEJ,IAAI,WAAW,WAAW;EACxB,MAAM,aAAa,KAAK,IAAI,GAAG,WAAW,cAAc,CAAC;EACzD,MAAM,aAAa,aAAa,aAAa;EAC7C,MAAM,SAAS,WAAW,gBAAgB,UAAU,KAAK,WAAW,iBAAiB,EAAE,UAAU;EACjG,QAAQ,gBAAgB,WAAW,iBAAiB,OAAO,eAAe,WAAW;EACrF,UAAU,EAAE,WAAW;CACzB,OAAO;EACL,MAAM,UAAoB,CAAC;EAC3B,IAAI,eAAe,SAAS,GAC1B,QAAQ,KAAK,SAAS,eAAe,KAAK,IAAI,EAAE,6DAA6D;EAE/G,IAAI,WAAW,MAAM,QACnB,QAAQ,KAAK,GAAG,MAAM,SAAS,SAAS,kCAAkC,WAAW,EAAE,aAAa;EAEtG,IAAI,QAAQ,SAAS,GAAG,QAAQ,QAAQ,QAAQ,KAAK,IAAI,EAAE;CAC7D;CAEA,OAAO;EAAE,SAAS,CAAC;GAAE,MAAM;GAAQ;EAAK,CAAC;EAAG;CAAQ;AACtD;AAMA,SAAgB,uBACd,YACyC;CACzC,OAAO;EACL,MAAM;EACN,OAAO;EACP,aACE;EACF,eAAe;EACf,kBAAkB,CAChB,uHACA,iFACF;EACA,YAAY;EACZ,eAAe;EACf,SAAS,OACP,aACA,QACA,QACA,WACA,YACG,oBAAoB,QAAQ,QAAQ,KAAK,QAAQ,OAAO,eAAe,aAAa,WAAW,IAAI,UAAU;CACpH;AACF;;;AC3JA,IAAA,mBAAe,eAAe,YAAgC;CAC5D,MAAM,aAAa,QAAQ,SAAS,IAAgB,aAAa;CACjE,IAAI,CAAC,YAAY,MAAM,IAAI,MAAM,yCAAyC;CAC1E,OAAO;EACL,GAAG,uBAAuB,UAAU;EACpC,aACE;CACJ;AACF,CAAC;;;ACPD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AACpE,MAAM,OAAU,UAAmC,UAChD,UAAU,KAAA,IAAY,KAAA,IAAY;CAAE,GAAG;CAAU,GAAI;AAAiB;AAEzE,MAAM,cAAiB,KAAa,UAAgB,UAAU,KAAA,IAAY,QAAS;CACjF,GAAG;CAAO,OAAO;EAAE,GAAI,MAA6B;GAAQ,cAAc;CAAI;AAChF;AAEA,MAAa,MAAM,gBAAgB;CACjC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,QAAqC;EAAE,OAAO,CAAC,WAAW,2BAA2B,IAAI,EAAE,MAAM,OAAO,GAAG,GAAGA,kBAAU,OAAO,CAAC,CAAC,CAAC;CAAG,EAC3I;AACF,CAAC"}

package/dist/extensions/server.cjs

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_readTool = require("../readTool-0aiSTVYz.cjs");
+const require_readTool = require("../readTool-DQSyk5NY.cjs");
 let _agimon_ai_po_core_platform = require("@agimon-ai/po-core/platform");
 let _agimon_ai_po_core_serverPlugin = require("@agimon-ai/po-core/serverPlugin");
 //#region src/extensions/workspaces/sessions/(backend)/tool/read.server.ts

package/dist/extensions/server.mjs

@@ -1,4 +1,4 @@
-import { t as createHeadlessReadTool } from "../readTool-Cja4cIaR.mjs";
+import { t as createHeadlessReadTool } from "../readTool-CCyLjl3E.mjs";
 import { PO_FS_SERVICE, requirePoFs } from "@agimon-ai/po-core/platform";
 import { defineServerPlugin } from "@agimon-ai/po-core/serverPlugin";
 import { defineServerTool } from "@agimon-ai/po-core/extensionFile";

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_readTool = require("./readTool-0aiSTVYz.cjs");
+const require_readTool = require("./readTool-DQSyk5NY.cjs");
 exports.ReadParamsSchema = require_readTool.ReadParamsSchema;
 exports.createHeadlessReadTool = require_readTool.createHeadlessReadTool;
 exports.executeHeadlessRead = require_readTool.executeHeadlessRead;

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { FileSystem } from "@agimon-ai/po-core/platform";
-import { ReadToolDetails } from "@earendil-works/pi-coding-agent";
 import { Static, Type } from "typebox";
 import "@agimon-ai/po-config/piConfig";
+import { ReadToolDetails } from "@earendil-works/pi-coding-agent";
 import { PoHeadlessTool } from "@agimon-ai/po-core/headless";
 //#region src/schemas/readTool.d.ts
 export declare const ReadParamsSchema: Type.TObject<{

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/schemas/readTool.ts","../src/services/readImage/index.ts","../src/services/readTool/index.ts"],"mappings":";;;;;;qBAEa,kBAAgB,KAAA;;;;;KAMjB,aAAa,cAAc;;;UCJtB;EACf;EACA;;UAGe;EACf;EACA;EACA;;KAGU,kBAAkB,eAAe;;;UCyB5B;EACf,SAAS;EACT,UAAU;;wBA0BU,oBACpB,QAAQ,YACR,aACA,QAAQ,yBACR,YAAY,aACX,QAAQ;wBA2EK,uBACd,YAAY,oBAAoB,cAC/B,sBAAsB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/schemas/readTool.ts","../src/services/readImage/index.ts","../src/services/readTool/index.ts"],"mappings":";;;;;;qBAEa,kBAAgB,KAAA;;;;;KAMjB,aAAa,cAAc;;;UCJtB;EACf;EACA;;UAGe;EACf;EACA;EACA;;KAGU,kBAAkB,eAAe;;;UCc5B;EACf,SAAS;EACT,UAAU;;wBA0BU,oBACpB,QAAQ,YACR,aACA,QAAQ,yBACR,YAAY,aACX,QAAQ;wBA2EK,uBACd,YAAY,oBAAoB,cAC/B,sBAAsB"}

package/dist/index.mjs

@@ -1 +1 @@
-export { r as ReadParamsSchema, t as createHeadlessReadTool, n as executeHeadlessRead } from "./readTool-Cja4cIaR.mjs";
+export { r as ReadParamsSchema, t as createHeadlessReadTool, n as executeHeadlessRead } from "./readTool-CCyLjl3E.mjs";

package/dist/{readTool-Cja4cIaR.mjs → readTool-CCyLjl3E.mjs}

@@ -1,9 +1,9 @@
 import { BACKGROUND_CONTEXT, FileTooLargeError, readBoundedFile, withAbortSignal } from "@agimon-ai/po-core/platform";
 import { formatFileHeader, formatTaggedLine, splitLines } from "@agimon-ai/po-hashline";
 import { computeFileTag, decodeUtf8, displayPath, isWritableFile, resolveReadInputPath } from "@agimon-ai/po-hashline/files";
-import { DEFAULT_MAX_BYTES, formatDimensionNote, formatSize, resizeImage, truncateHead, truncateLine } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import { loadPiImageSettings } from "@agimon-ai/po-config/piConfig";
+import { DEFAULT_MAX_BYTES, formatDimensionNote, formatSize, resizeImage, truncateHead, truncateLine } from "@earendil-works/pi-coding-agent";
 //#region src/schemas/readTool.ts
 const ReadParamsSchema = Type.Object({
 	path: Type.String({ description: "Path to the file to read." }),
@@ -17,11 +17,17 @@ const ReadParamsSchema = Type.Object({
 	}))
 });
 //#endregion
-//#region src/services/readImage/index.ts
-const OMITTED_NOTE = "[Image omitted: could not be resized below the inline image size limit.]";
-function imageLimits() {
+//#region src/services/readHost/index.ts
+const resizeOperations = {
+	resize: resizeImage,
+	formatDimensionNote: (result) => formatDimensionNote(result)
+};
+async function readImageLimits(_filesystem, _context) {
 	return loadPiImageSettings();
 }
+//#endregion
+//#region src/services/readImage/index.ts
+const OMITTED_NOTE = "[Image omitted: could not be resized below the inline image size limit.]";
 async function applyImageLimits(content, limits, operations) {
 	if (!limits.autoResize || !content.some((part) => part.type === "image")) return content;
 	const resolved = [];
@@ -56,10 +62,6 @@ async function applyImageLimits(content, limits, operations) {
 }
 //#endregion
 //#region src/services/readTool/index.ts
-const resizeOperations = {
-	resize: resizeImage,
-	formatDimensionNote: (result) => formatDimensionNote(result)
-};
 function assertNotAborted(signal) {
 	if (signal?.aborted) throw new Error("Operation aborted");
 }
@@ -95,7 +97,7 @@ async function executeHeadlessRead(params, cwd, signal, filesystem) {
 		type: "image",
 		data: bytes.toString("base64"),
 		mimeType
-	}], imageLimits(), resizeOperations) };
+	}], await readImageLimits(filesystem, context), resizeOperations) };
 	if (!await isWritableFile(absolutePath)) return { content: [{
 		type: "text",
 		text: decodeUtf8(bytes, displayPath(absolutePath, cwd))
@@ -156,4 +158,4 @@ function createHeadlessReadTool(filesystem) {
 //#endregion
 export { executeHeadlessRead as n, ReadParamsSchema as r, createHeadlessReadTool as t };
 
-//# sourceMappingURL=readTool-Cja4cIaR.mjs.map
+//# sourceMappingURL=readTool-CCyLjl3E.mjs.map

package/dist/readTool-CCyLjl3E.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"readTool-CCyLjl3E.mjs","names":[],"sources":["../src/schemas/readTool.ts","../src/services/readHost/index.ts","../src/services/readImage/index.ts","../src/services/readTool/index.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const ReadParamsSchema = Type.Object({\n  path: Type.String({ description: 'Path to the file to read.' }),\n  offset: Type.Optional(Type.Integer({ minimum: 1, description: 'One-based line offset.' })),\n  limit: Type.Optional(Type.Integer({ minimum: 1, description: 'Maximum number of lines to return.' })),\n});\n\nexport type ReadParams = Static<typeof ReadParamsSchema>;\n","import { loadPiImageSettings, type PiImageSettings } from '@agimon-ai/po-config/piConfig';\nimport type { FileSystem } from '@agimon-ai/po-core/platform';\nimport {\n  DEFAULT_MAX_BYTES,\n  formatDimensionNote,\n  formatSize,\n  resizeImage,\n  truncateHead,\n  truncateLine,\n} from '@earendil-works/pi-coding-agent';\n\nimport type { ReadImageResizeOperations } from '../readImage';\nimport type { ReadHostContext } from './type';\n\n// The Node form of the read tool's host seam: Pi's own limits and resizer, and the image settings Pi keeps under the\n// user's home. ./index.edge replaces this module in the Worker build, where Pi cannot load.\nexport { DEFAULT_MAX_BYTES, formatSize, truncateHead, truncateLine };\n\nexport const resizeOperations: ReadImageResizeOperations = {\n  resize: resizeImage,\n  formatDimensionNote: (result) => formatDimensionNote(result),\n};\n\nexport async function readImageLimits(_filesystem: FileSystem, _context: ReadHostContext): Promise<PiImageSettings> {\n  return loadPiImageSettings();\n}\n","import type { PiImageSettings } from '@agimon-ai/po-config/piConfig';\n\nconst OMITTED_NOTE = '[Image omitted: could not be resized below the inline image size limit.]';\n\nexport interface ReadTextPart {\n  type: 'text';\n  text: string;\n}\n\nexport interface ReadImagePart {\n  type: 'image';\n  data: string;\n  mimeType: string;\n}\n\nexport type ReadContentPart = ReadTextPart | ReadImagePart;\n\nexport interface ReadImageResizeResult {\n  readonly data: string;\n  readonly mimeType: string;\n  readonly originalWidth: number;\n  readonly originalHeight: number;\n  readonly width: number;\n  readonly height: number;\n  readonly wasResized: boolean;\n}\n\nexport interface ReadImageResizeOperations {\n  resize(\n    inputBytes: Uint8Array,\n    mimeType: string,\n    options: { readonly maxWidth: number; readonly maxHeight: number },\n  ): Promise<ReadImageResizeResult | null>;\n  formatDimensionNote(result: ReadImageResizeResult): string | undefined;\n}\n\nexport async function applyImageLimits(\n  content: ReadContentPart[],\n  limits: PiImageSettings,\n  operations: ReadImageResizeOperations,\n): Promise<ReadContentPart[]> {\n  if (!limits.autoResize || !content.some((part) => part.type === 'image')) return content;\n  const resolved: ReadContentPart[] = [];\n  for (const part of content) {\n    if (part.type !== 'image') {\n      resolved.push(part);\n      continue;\n    }\n    const resized = await operations.resize(Buffer.from(part.data, 'base64'), part.mimeType, {\n      maxWidth: limits.maxDimension,\n      maxHeight: limits.maxDimension,\n    });\n    if (!resized) {\n      resolved.push({ type: 'text', text: OMITTED_NOTE });\n      continue;\n    }\n    resolved.push({ type: 'image', data: resized.data, mimeType: resized.mimeType });\n    const note = operations.formatDimensionNote(resized);\n    if (note) resolved.push({ type: 'text', text: note });\n  }\n  return resolved;\n}\n","import type { PoHeadlessExecutionContext, PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport {\n  BACKGROUND_CONTEXT,\n  FileTooLargeError,\n  readBoundedFile,\n  withAbortSignal,\n  type FileSystem,\n} from '@agimon-ai/po-core/platform';\nimport { formatFileHeader, formatTaggedLine, splitLines } from '@agimon-ai/po-hashline';\nimport {\n  computeFileTag,\n  decodeUtf8,\n  displayPath,\n  isWritableFile,\n  resolveReadInputPath,\n} from '@agimon-ai/po-hashline/files';\nimport type { ReadToolDetails } from '@earendil-works/pi-coding-agent';\n\nimport { ReadParamsSchema, type ReadParams } from '../../schemas/readTool';\nimport {\n  DEFAULT_MAX_BYTES,\n  formatSize,\n  readImageLimits,\n  resizeOperations,\n  truncateHead,\n  truncateLine,\n} from '../readHost';\nimport { applyImageLimits, type ReadContentPart, type ReadTextPart } from '../readImage';\n\nexport interface ReadToolResult {\n  content: ReadContentPart[];\n  details?: ReadToolDetails;\n}\n\ninterface ReadTextToolResult {\n  content: ReadTextPart[];\n  details?: ReadToolDetails;\n}\n\nexport function assertNotAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw new Error('Operation aborted');\n}\n\nexport function isImagePath(filePath: string): string | undefined {\n  const extension = filePath.toLowerCase().match(/\\.([a-z0-9]+)$/u)?.[1];\n  if (!extension) return undefined;\n  const mimeTypes: Record<string, string> = {\n    avif: 'image/avif',\n    gif: 'image/gif',\n    jpeg: 'image/jpeg',\n    jpg: 'image/jpeg',\n    png: 'image/png',\n    webp: 'image/webp',\n  };\n  return mimeTypes[extension];\n}\n\nexport async function executeHeadlessRead(\n  params: ReadParams,\n  cwd: string,\n  signal: AbortSignal | undefined,\n  filesystem: FileSystem,\n): Promise<ReadToolResult> {\n  assertNotAborted(signal);\n  const absolutePath = await resolveReadInputPath(params.path, cwd);\n  const context = signal ? withAbortSignal(signal, BACKGROUND_CONTEXT) : BACKGROUND_CONTEXT;\n  let bytes: Buffer;\n  try {\n    bytes = Buffer.from(await readBoundedFile(filesystem, absolutePath, 8 * 1024 * 1024, context));\n  } catch (error) {\n    if (error instanceof FileTooLargeError) {\n      throw new Error('File is over 8 MiB, hashline read refuses; use runner log tools for logs.', { cause: error });\n    }\n    throw error;\n  }\n  assertNotAborted(signal);\n  const mimeType = isImagePath(absolutePath);\n  if (mimeType) {\n    const content: ReadContentPart[] = [\n      { type: 'text', text: `Read image file ${displayPath(absolutePath, cwd)} [${mimeType}]` },\n      { type: 'image', data: bytes.toString('base64'), mimeType },\n    ];\n    return { content: await applyImageLimits(content, await readImageLimits(filesystem, context), resizeOperations) };\n  }\n  if (!(await isWritableFile(absolutePath))) {\n    return { content: [{ type: 'text', text: decodeUtf8(bytes, displayPath(absolutePath, cwd)) }] };\n  }\n  return createTaggedReadResult(bytes, displayPath(absolutePath, cwd), params);\n}\n\nexport function createTaggedReadResult(bytes: Buffer, path: string, params: ReadParams): ReadTextToolResult {\n  const lines = splitLines(decodeUtf8(bytes, path));\n  const startIndex = params.offset === undefined ? 0 : params.offset - 1;\n  if (startIndex >= lines.length) {\n    throw new Error(`Offset ${params.offset} is beyond end of file (${lines.length} lines total).`);\n  }\n\n  const endIndex = params.limit === undefined ? lines.length : Math.min(lines.length, startIndex + params.limit);\n  const selected = lines.slice(startIndex, endIndex);\n  const header = formatFileHeader(path, computeFileTag(bytes));\n  const compactedLines: number[] = [];\n  const headerBytes = Buffer.byteLength(header, 'utf8') + 1;\n  const tagged = selected.map((line, index) => {\n    const lineNumber = startIndex + index + 1;\n    const full = formatTaggedLine(line, lineNumber);\n    if (Buffer.byteLength(full, 'utf8') <= DEFAULT_MAX_BYTES - headerBytes) return full;\n    compactedLines.push(lineNumber);\n    return formatTaggedLine(truncateLine(line).text, lineNumber, '', line);\n  });\n  const truncation = truncateHead([header, ...tagged].join('\\n'));\n  let text = truncation.content;\n  let details: ReadToolDetails | undefined;\n\n  if (truncation.truncated) {\n    const shownLines = Math.max(0, truncation.outputLines - 1);\n    const nextOffset = startIndex + shownLines + 1;\n    const reason = truncation.truncatedBy === 'bytes' ? `, ${formatSize(DEFAULT_MAX_BYTES)} limit` : '';\n    text += `\\n\\n[Showing ${shownLines} anchored lines${reason}. Use offset=${nextOffset} to continue.]`;\n    details = { truncation };\n  } else {\n    const notices: string[] = [];\n    if (compactedLines.length > 0) {\n      notices.push(`Lines ${compactedLines.join(', ')} shown compactly. Their anchors hash the full original lines`);\n    }\n    if (endIndex < lines.length) {\n      notices.push(`${lines.length - endIndex} more lines in file. Use offset=${endIndex + 1} to continue`);\n    }\n    if (notices.length > 0) text += `\\n\\n[${notices.join('. ')}.]`;\n  }\n\n  return { content: [{ type: 'text', text }], details };\n}\n\nexport function isImageRead(content: readonly { readonly type: string; readonly text?: string }[]): boolean {\n  return content.some((part) => part.type === 'image' || part.text?.startsWith('Read image file') === true);\n}\n\nexport function createHeadlessReadTool(\n  filesystem: FileSystem | (() => FileSystem),\n): PoHeadlessTool<typeof ReadParamsSchema> {\n  return {\n    name: 'read',\n    label: 'read',\n    description:\n      'Read a writable text file with an exact-byte file tag and stable line anchors. Non-writable files and images return native-compatible content. Files over 8 MiB are refused. Text is truncated to 50.0KB.',\n    promptSnippet: 'Read file contents with snapshot-bound line anchors',\n    promptGuidelines: [\n      'Use read before edit. When hashline metadata is present, preserve the @file hash and anchors such as 5#abc exactly.',\n      'Continue large reads with offset until the required anchored lines are visible.',\n    ],\n    parameters: ReadParamsSchema,\n    executionMode: 'parallel',\n    execute: async (\n      _toolCallId: string,\n      params: ReadParams,\n      signal: AbortSignal | undefined,\n      _onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => executeHeadlessRead(params, context.cwd, signal, typeof filesystem === 'function' ? filesystem() : filesystem),\n  };\n}\n"],"mappings":"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"}

package/dist/{readTool-0aiSTVYz.cjs → readTool-DQSyk5NY.cjs}

@@ -1,9 +1,9 @@
 let _agimon_ai_po_core_platform = require("@agimon-ai/po-core/platform");
 let _agimon_ai_po_hashline = require("@agimon-ai/po-hashline");
 let _agimon_ai_po_hashline_files = require("@agimon-ai/po-hashline/files");
-let _earendil_works_pi_coding_agent = require("@earendil-works/pi-coding-agent");
 let typebox = require("typebox");
 let _agimon_ai_po_config_piConfig = require("@agimon-ai/po-config/piConfig");
+let _earendil_works_pi_coding_agent = require("@earendil-works/pi-coding-agent");
 //#region src/schemas/readTool.ts
 const ReadParamsSchema = typebox.Type.Object({
 	path: typebox.Type.String({ description: "Path to the file to read." }),
@@ -17,11 +17,17 @@ const ReadParamsSchema = typebox.Type.Object({
 	}))
 });
 //#endregion
-//#region src/services/readImage/index.ts
-const OMITTED_NOTE = "[Image omitted: could not be resized below the inline image size limit.]";
-function imageLimits() {
+//#region src/services/readHost/index.ts
+const resizeOperations = {
+	resize: _earendil_works_pi_coding_agent.resizeImage,
+	formatDimensionNote: (result) => (0, _earendil_works_pi_coding_agent.formatDimensionNote)(result)
+};
+async function readImageLimits(_filesystem, _context) {
 	return (0, _agimon_ai_po_config_piConfig.loadPiImageSettings)();
 }
+//#endregion
+//#region src/services/readImage/index.ts
+const OMITTED_NOTE = "[Image omitted: could not be resized below the inline image size limit.]";
 async function applyImageLimits(content, limits, operations) {
 	if (!limits.autoResize || !content.some((part) => part.type === "image")) return content;
 	const resolved = [];
@@ -56,10 +62,6 @@ async function applyImageLimits(content, limits, operations) {
 }
 //#endregion
 //#region src/services/readTool/index.ts
-const resizeOperations = {
-	resize: _earendil_works_pi_coding_agent.resizeImage,
-	formatDimensionNote: (result) => (0, _earendil_works_pi_coding_agent.formatDimensionNote)(result)
-};
 function assertNotAborted(signal) {
 	if (signal?.aborted) throw new Error("Operation aborted");
 }
@@ -95,7 +97,7 @@ async function executeHeadlessRead(params, cwd, signal, filesystem) {
 		type: "image",
 		data: bytes.toString("base64"),
 		mimeType
-	}], imageLimits(), resizeOperations) };
+	}], await readImageLimits(filesystem, context), resizeOperations) };
 	if (!await (0, _agimon_ai_po_hashline_files.isWritableFile)(absolutePath)) return { content: [{
 		type: "text",
 		text: (0, _agimon_ai_po_hashline_files.decodeUtf8)(bytes, (0, _agimon_ai_po_hashline_files.displayPath)(absolutePath, cwd))
@@ -173,4 +175,4 @@ Object.defineProperty(exports, "executeHeadlessRead", {
 	}
 });
 
-//# sourceMappingURL=readTool-0aiSTVYz.cjs.map
+//# sourceMappingURL=readTool-DQSyk5NY.cjs.map

package/dist/readTool-DQSyk5NY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"readTool-DQSyk5NY.cjs","names":["Type","resizeImage","formatDimensionNote","loadPiImageSettings","resolveReadInputPath","withAbortSignal","BACKGROUND_CONTEXT","readBoundedFile","FileTooLargeError","displayPath","isWritableFile","decodeUtf8","splitLines","formatFileHeader","computeFileTag","formatTaggedLine","DEFAULT_MAX_BYTES","truncateLine","truncateHead","formatSize"],"sources":["../src/schemas/readTool.ts","../src/services/readHost/index.ts","../src/services/readImage/index.ts","../src/services/readTool/index.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const ReadParamsSchema = Type.Object({\n  path: Type.String({ description: 'Path to the file to read.' }),\n  offset: Type.Optional(Type.Integer({ minimum: 1, description: 'One-based line offset.' })),\n  limit: Type.Optional(Type.Integer({ minimum: 1, description: 'Maximum number of lines to return.' })),\n});\n\nexport type ReadParams = Static<typeof ReadParamsSchema>;\n","import { loadPiImageSettings, type PiImageSettings } from '@agimon-ai/po-config/piConfig';\nimport type { FileSystem } from '@agimon-ai/po-core/platform';\nimport {\n  DEFAULT_MAX_BYTES,\n  formatDimensionNote,\n  formatSize,\n  resizeImage,\n  truncateHead,\n  truncateLine,\n} from '@earendil-works/pi-coding-agent';\n\nimport type { ReadImageResizeOperations } from '../readImage';\nimport type { ReadHostContext } from './type';\n\n// The Node form of the read tool's host seam: Pi's own limits and resizer, and the image settings Pi keeps under the\n// user's home. ./index.edge replaces this module in the Worker build, where Pi cannot load.\nexport { DEFAULT_MAX_BYTES, formatSize, truncateHead, truncateLine };\n\nexport const resizeOperations: ReadImageResizeOperations = {\n  resize: resizeImage,\n  formatDimensionNote: (result) => formatDimensionNote(result),\n};\n\nexport async function readImageLimits(_filesystem: FileSystem, _context: ReadHostContext): Promise<PiImageSettings> {\n  return loadPiImageSettings();\n}\n","import type { PiImageSettings } from '@agimon-ai/po-config/piConfig';\n\nconst OMITTED_NOTE = '[Image omitted: could not be resized below the inline image size limit.]';\n\nexport interface ReadTextPart {\n  type: 'text';\n  text: string;\n}\n\nexport interface ReadImagePart {\n  type: 'image';\n  data: string;\n  mimeType: string;\n}\n\nexport type ReadContentPart = ReadTextPart | ReadImagePart;\n\nexport interface ReadImageResizeResult {\n  readonly data: string;\n  readonly mimeType: string;\n  readonly originalWidth: number;\n  readonly originalHeight: number;\n  readonly width: number;\n  readonly height: number;\n  readonly wasResized: boolean;\n}\n\nexport interface ReadImageResizeOperations {\n  resize(\n    inputBytes: Uint8Array,\n    mimeType: string,\n    options: { readonly maxWidth: number; readonly maxHeight: number },\n  ): Promise<ReadImageResizeResult | null>;\n  formatDimensionNote(result: ReadImageResizeResult): string | undefined;\n}\n\nexport async function applyImageLimits(\n  content: ReadContentPart[],\n  limits: PiImageSettings,\n  operations: ReadImageResizeOperations,\n): Promise<ReadContentPart[]> {\n  if (!limits.autoResize || !content.some((part) => part.type === 'image')) return content;\n  const resolved: ReadContentPart[] = [];\n  for (const part of content) {\n    if (part.type !== 'image') {\n      resolved.push(part);\n      continue;\n    }\n    const resized = await operations.resize(Buffer.from(part.data, 'base64'), part.mimeType, {\n      maxWidth: limits.maxDimension,\n      maxHeight: limits.maxDimension,\n    });\n    if (!resized) {\n      resolved.push({ type: 'text', text: OMITTED_NOTE });\n      continue;\n    }\n    resolved.push({ type: 'image', data: resized.data, mimeType: resized.mimeType });\n    const note = operations.formatDimensionNote(resized);\n    if (note) resolved.push({ type: 'text', text: note });\n  }\n  return resolved;\n}\n","import type { PoHeadlessExecutionContext, PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport {\n  BACKGROUND_CONTEXT,\n  FileTooLargeError,\n  readBoundedFile,\n  withAbortSignal,\n  type FileSystem,\n} from '@agimon-ai/po-core/platform';\nimport { formatFileHeader, formatTaggedLine, splitLines } from '@agimon-ai/po-hashline';\nimport {\n  computeFileTag,\n  decodeUtf8,\n  displayPath,\n  isWritableFile,\n  resolveReadInputPath,\n} from '@agimon-ai/po-hashline/files';\nimport type { ReadToolDetails } from '@earendil-works/pi-coding-agent';\n\nimport { ReadParamsSchema, type ReadParams } from '../../schemas/readTool';\nimport {\n  DEFAULT_MAX_BYTES,\n  formatSize,\n  readImageLimits,\n  resizeOperations,\n  truncateHead,\n  truncateLine,\n} from '../readHost';\nimport { applyImageLimits, type ReadContentPart, type ReadTextPart } from '../readImage';\n\nexport interface ReadToolResult {\n  content: ReadContentPart[];\n  details?: ReadToolDetails;\n}\n\ninterface ReadTextToolResult {\n  content: ReadTextPart[];\n  details?: ReadToolDetails;\n}\n\nexport function assertNotAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw new Error('Operation aborted');\n}\n\nexport function isImagePath(filePath: string): string | undefined {\n  const extension = filePath.toLowerCase().match(/\\.([a-z0-9]+)$/u)?.[1];\n  if (!extension) return undefined;\n  const mimeTypes: Record<string, string> = {\n    avif: 'image/avif',\n    gif: 'image/gif',\n    jpeg: 'image/jpeg',\n    jpg: 'image/jpeg',\n    png: 'image/png',\n    webp: 'image/webp',\n  };\n  return mimeTypes[extension];\n}\n\nexport async function executeHeadlessRead(\n  params: ReadParams,\n  cwd: string,\n  signal: AbortSignal | undefined,\n  filesystem: FileSystem,\n): Promise<ReadToolResult> {\n  assertNotAborted(signal);\n  const absolutePath = await resolveReadInputPath(params.path, cwd);\n  const context = signal ? withAbortSignal(signal, BACKGROUND_CONTEXT) : BACKGROUND_CONTEXT;\n  let bytes: Buffer;\n  try {\n    bytes = Buffer.from(await readBoundedFile(filesystem, absolutePath, 8 * 1024 * 1024, context));\n  } catch (error) {\n    if (error instanceof FileTooLargeError) {\n      throw new Error('File is over 8 MiB, hashline read refuses; use runner log tools for logs.', { cause: error });\n    }\n    throw error;\n  }\n  assertNotAborted(signal);\n  const mimeType = isImagePath(absolutePath);\n  if (mimeType) {\n    const content: ReadContentPart[] = [\n      { type: 'text', text: `Read image file ${displayPath(absolutePath, cwd)} [${mimeType}]` },\n      { type: 'image', data: bytes.toString('base64'), mimeType },\n    ];\n    return { content: await applyImageLimits(content, await readImageLimits(filesystem, context), resizeOperations) };\n  }\n  if (!(await isWritableFile(absolutePath))) {\n    return { content: [{ type: 'text', text: decodeUtf8(bytes, displayPath(absolutePath, cwd)) }] };\n  }\n  return createTaggedReadResult(bytes, displayPath(absolutePath, cwd), params);\n}\n\nexport function createTaggedReadResult(bytes: Buffer, path: string, params: ReadParams): ReadTextToolResult {\n  const lines = splitLines(decodeUtf8(bytes, path));\n  const startIndex = params.offset === undefined ? 0 : params.offset - 1;\n  if (startIndex >= lines.length) {\n    throw new Error(`Offset ${params.offset} is beyond end of file (${lines.length} lines total).`);\n  }\n\n  const endIndex = params.limit === undefined ? lines.length : Math.min(lines.length, startIndex + params.limit);\n  const selected = lines.slice(startIndex, endIndex);\n  const header = formatFileHeader(path, computeFileTag(bytes));\n  const compactedLines: number[] = [];\n  const headerBytes = Buffer.byteLength(header, 'utf8') + 1;\n  const tagged = selected.map((line, index) => {\n    const lineNumber = startIndex + index + 1;\n    const full = formatTaggedLine(line, lineNumber);\n    if (Buffer.byteLength(full, 'utf8') <= DEFAULT_MAX_BYTES - headerBytes) return full;\n    compactedLines.push(lineNumber);\n    return formatTaggedLine(truncateLine(line).text, lineNumber, '', line);\n  });\n  const truncation = truncateHead([header, ...tagged].join('\\n'));\n  let text = truncation.content;\n  let details: ReadToolDetails | undefined;\n\n  if (truncation.truncated) {\n    const shownLines = Math.max(0, truncation.outputLines - 1);\n    const nextOffset = startIndex + shownLines + 1;\n    const reason = truncation.truncatedBy === 'bytes' ? `, ${formatSize(DEFAULT_MAX_BYTES)} limit` : '';\n    text += `\\n\\n[Showing ${shownLines} anchored lines${reason}. Use offset=${nextOffset} to continue.]`;\n    details = { truncation };\n  } else {\n    const notices: string[] = [];\n    if (compactedLines.length > 0) {\n      notices.push(`Lines ${compactedLines.join(', ')} shown compactly. Their anchors hash the full original lines`);\n    }\n    if (endIndex < lines.length) {\n      notices.push(`${lines.length - endIndex} more lines in file. Use offset=${endIndex + 1} to continue`);\n    }\n    if (notices.length > 0) text += `\\n\\n[${notices.join('. ')}.]`;\n  }\n\n  return { content: [{ type: 'text', text }], details };\n}\n\nexport function isImageRead(content: readonly { readonly type: string; readonly text?: string }[]): boolean {\n  return content.some((part) => part.type === 'image' || part.text?.startsWith('Read image file') === true);\n}\n\nexport function createHeadlessReadTool(\n  filesystem: FileSystem | (() => FileSystem),\n): PoHeadlessTool<typeof ReadParamsSchema> {\n  return {\n    name: 'read',\n    label: 'read',\n    description:\n      'Read a writable text file with an exact-byte file tag and stable line anchors. Non-writable files and images return native-compatible content. Files over 8 MiB are refused. Text is truncated to 50.0KB.',\n    promptSnippet: 'Read file contents with snapshot-bound line anchors',\n    promptGuidelines: [\n      'Use read before edit. When hashline metadata is present, preserve the @file hash and anchors such as 5#abc exactly.',\n      'Continue large reads with offset until the required anchored lines are visible.',\n    ],\n    parameters: ReadParamsSchema,\n    executionMode: 'parallel',\n    execute: async (\n      _toolCallId: string,\n      params: ReadParams,\n      signal: AbortSignal | undefined,\n      _onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => executeHeadlessRead(params, context.cwd, signal, typeof filesystem === 'function' ? filesystem() : filesystem),\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/po-read",
-  "version": "0.0.0-alpha.111",
+  "version": "0.0.0-alpha.112",
   "description": "Snapshot-bound hashline read tool for Pi and Po.",
   "keywords": [
     "ai",
@@ -60,17 +60,17 @@
     "access": "public"
   },
   "dependencies": {
-    "@agimon-ai/po-config": "0.0.0-alpha.111",
-    "@agimon-ai/po-core": "0.0.0-alpha.111",
-    "@agimon-ai/po-hashline": "0.0.0-alpha.111",
-    "@agimon-ai/po-ui": "0.0.0-alpha.111",
-    "@agimon-ai/po-web-components": "0.0.0-alpha.111",
+    "@agimon-ai/po-config": "0.0.0-alpha.112",
+    "@agimon-ai/po-core": "0.0.0-alpha.112",
+    "@agimon-ai/po-hashline": "0.0.0-alpha.112",
+    "@agimon-ai/po-ui": "0.0.0-alpha.112",
+    "@agimon-ai/po-web-components": "0.0.0-alpha.112",
     "@deepseek-ai/cordis": "4.0.5",
     "typebox": "1.4.2"
   },
   "devDependencies": {
-    "@agimon-ai/po-build": "0.0.0-alpha.111",
-    "@agimon-ai/po-native-components": "0.0.0-alpha.111",
+    "@agimon-ai/po-build": "0.0.0-alpha.112",
+    "@agimon-ai/po-native-components": "0.0.0-alpha.112",
     "@earendil-works/pi-coding-agent": "1.5.0",
     "@earendil-works/pi-durable": "1.5.0",
     "@tanstack/react-store": "0.11.2",
@@ -87,7 +87,7 @@
     "vitest": "5.0.4"
   },
   "peerDependencies": {
-    "@agimon-ai/po-native-components": "0.0.0-alpha.111",
+    "@agimon-ai/po-native-components": "0.0.0-alpha.112",
     "@earendil-works/pi-coding-agent": "1.5.0",
     "react-native": "0.88.1",
     "react-native-unistyles": "^3.5.3"

package/dist/readTool-0aiSTVYz.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"readTool-0aiSTVYz.cjs","names":["Type","loadPiImageSettings","resizeImage","formatDimensionNote","resolveReadInputPath","withAbortSignal","BACKGROUND_CONTEXT","readBoundedFile","FileTooLargeError","displayPath","isWritableFile","decodeUtf8","splitLines","formatFileHeader","computeFileTag","formatTaggedLine","DEFAULT_MAX_BYTES","truncateLine","truncateHead","formatSize"],"sources":["../src/schemas/readTool.ts","../src/services/readImage/index.ts","../src/services/readTool/index.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const ReadParamsSchema = Type.Object({\n  path: Type.String({ description: 'Path to the file to read.' }),\n  offset: Type.Optional(Type.Integer({ minimum: 1, description: 'One-based line offset.' })),\n  limit: Type.Optional(Type.Integer({ minimum: 1, description: 'Maximum number of lines to return.' })),\n});\n\nexport type ReadParams = Static<typeof ReadParamsSchema>;\n","import { loadPiImageSettings, type PiImageSettings } from '@agimon-ai/po-config/piConfig';\n\nconst OMITTED_NOTE = '[Image omitted: could not be resized below the inline image size limit.]';\n\nexport interface ReadTextPart {\n  type: 'text';\n  text: string;\n}\n\nexport interface ReadImagePart {\n  type: 'image';\n  data: string;\n  mimeType: string;\n}\n\nexport type ReadContentPart = ReadTextPart | ReadImagePart;\n\nexport interface ReadImageResizeResult {\n  readonly data: string;\n  readonly mimeType: string;\n  readonly originalWidth: number;\n  readonly originalHeight: number;\n  readonly width: number;\n  readonly height: number;\n  readonly wasResized: boolean;\n}\n\nexport interface ReadImageResizeOperations {\n  resize(\n    inputBytes: Uint8Array,\n    mimeType: string,\n    options: { readonly maxWidth: number; readonly maxHeight: number },\n  ): Promise<ReadImageResizeResult | null>;\n  formatDimensionNote(result: ReadImageResizeResult): string | undefined;\n}\n\nexport function imageLimits(): PiImageSettings {\n  return loadPiImageSettings();\n}\n\nexport async function applyImageLimits(\n  content: ReadContentPart[],\n  limits: PiImageSettings,\n  operations: ReadImageResizeOperations,\n): Promise<ReadContentPart[]> {\n  if (!limits.autoResize || !content.some((part) => part.type === 'image')) return content;\n  const resolved: ReadContentPart[] = [];\n  for (const part of content) {\n    if (part.type !== 'image') {\n      resolved.push(part);\n      continue;\n    }\n    const resized = await operations.resize(Buffer.from(part.data, 'base64'), part.mimeType, {\n      maxWidth: limits.maxDimension,\n      maxHeight: limits.maxDimension,\n    });\n    if (!resized) {\n      resolved.push({ type: 'text', text: OMITTED_NOTE });\n      continue;\n    }\n    resolved.push({ type: 'image', data: resized.data, mimeType: resized.mimeType });\n    const note = operations.formatDimensionNote(resized);\n    if (note) resolved.push({ type: 'text', text: note });\n  }\n  return resolved;\n}\n","import type { PoHeadlessExecutionContext, PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport {\n  BACKGROUND_CONTEXT,\n  FileTooLargeError,\n  readBoundedFile,\n  withAbortSignal,\n  type FileSystem,\n} from '@agimon-ai/po-core/platform';\nimport { formatFileHeader, formatTaggedLine, splitLines } from '@agimon-ai/po-hashline';\nimport {\n  computeFileTag,\n  decodeUtf8,\n  displayPath,\n  isWritableFile,\n  resolveReadInputPath,\n} from '@agimon-ai/po-hashline/files';\nimport {\n  DEFAULT_MAX_BYTES,\n  formatDimensionNote,\n  formatSize,\n  resizeImage,\n  truncateHead,\n  truncateLine,\n  type ReadToolDetails,\n} from '@earendil-works/pi-coding-agent';\n\nimport { ReadParamsSchema, type ReadParams } from '../../schemas/readTool';\nimport {\n  applyImageLimits,\n  imageLimits,\n  type ReadContentPart,\n  type ReadImageResizeOperations,\n  type ReadTextPart,\n} from '../readImage';\n\nconst resizeOperations: ReadImageResizeOperations = {\n  resize: resizeImage,\n  formatDimensionNote: (result) => formatDimensionNote(result),\n};\n\nexport interface ReadToolResult {\n  content: ReadContentPart[];\n  details?: ReadToolDetails;\n}\n\ninterface ReadTextToolResult {\n  content: ReadTextPart[];\n  details?: ReadToolDetails;\n}\n\nexport function assertNotAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw new Error('Operation aborted');\n}\n\nexport function isImagePath(filePath: string): string | undefined {\n  const extension = filePath.toLowerCase().match(/\\.([a-z0-9]+)$/u)?.[1];\n  if (!extension) return undefined;\n  const mimeTypes: Record<string, string> = {\n    avif: 'image/avif',\n    gif: 'image/gif',\n    jpeg: 'image/jpeg',\n    jpg: 'image/jpeg',\n    png: 'image/png',\n    webp: 'image/webp',\n  };\n  return mimeTypes[extension];\n}\n\nexport async function executeHeadlessRead(\n  params: ReadParams,\n  cwd: string,\n  signal: AbortSignal | undefined,\n  filesystem: FileSystem,\n): Promise<ReadToolResult> {\n  assertNotAborted(signal);\n  const absolutePath = await resolveReadInputPath(params.path, cwd);\n  const context = signal ? withAbortSignal(signal, BACKGROUND_CONTEXT) : BACKGROUND_CONTEXT;\n  let bytes: Buffer;\n  try {\n    bytes = Buffer.from(await readBoundedFile(filesystem, absolutePath, 8 * 1024 * 1024, context));\n  } catch (error) {\n    if (error instanceof FileTooLargeError) {\n      throw new Error('File is over 8 MiB, hashline read refuses; use runner log tools for logs.', { cause: error });\n    }\n    throw error;\n  }\n  assertNotAborted(signal);\n  const mimeType = isImagePath(absolutePath);\n  if (mimeType) {\n    const content: ReadContentPart[] = [\n      { type: 'text', text: `Read image file ${displayPath(absolutePath, cwd)} [${mimeType}]` },\n      { type: 'image', data: bytes.toString('base64'), mimeType },\n    ];\n    return { content: await applyImageLimits(content, imageLimits(), resizeOperations) };\n  }\n  if (!(await isWritableFile(absolutePath))) {\n    return { content: [{ type: 'text', text: decodeUtf8(bytes, displayPath(absolutePath, cwd)) }] };\n  }\n  return createTaggedReadResult(bytes, displayPath(absolutePath, cwd), params);\n}\n\nexport function createTaggedReadResult(bytes: Buffer, path: string, params: ReadParams): ReadTextToolResult {\n  const lines = splitLines(decodeUtf8(bytes, path));\n  const startIndex = params.offset === undefined ? 0 : params.offset - 1;\n  if (startIndex >= lines.length) {\n    throw new Error(`Offset ${params.offset} is beyond end of file (${lines.length} lines total).`);\n  }\n\n  const endIndex = params.limit === undefined ? lines.length : Math.min(lines.length, startIndex + params.limit);\n  const selected = lines.slice(startIndex, endIndex);\n  const header = formatFileHeader(path, computeFileTag(bytes));\n  const compactedLines: number[] = [];\n  const headerBytes = Buffer.byteLength(header, 'utf8') + 1;\n  const tagged = selected.map((line, index) => {\n    const lineNumber = startIndex + index + 1;\n    const full = formatTaggedLine(line, lineNumber);\n    if (Buffer.byteLength(full, 'utf8') <= DEFAULT_MAX_BYTES - headerBytes) return full;\n    compactedLines.push(lineNumber);\n    return formatTaggedLine(truncateLine(line).text, lineNumber, '', line);\n  });\n  const truncation = truncateHead([header, ...tagged].join('\\n'));\n  let text = truncation.content;\n  let details: ReadToolDetails | undefined;\n\n  if (truncation.truncated) {\n    const shownLines = Math.max(0, truncation.outputLines - 1);\n    const nextOffset = startIndex + shownLines + 1;\n    const reason = truncation.truncatedBy === 'bytes' ? `, ${formatSize(DEFAULT_MAX_BYTES)} limit` : '';\n    text += `\\n\\n[Showing ${shownLines} anchored lines${reason}. Use offset=${nextOffset} to continue.]`;\n    details = { truncation };\n  } else {\n    const notices: string[] = [];\n    if (compactedLines.length > 0) {\n      notices.push(`Lines ${compactedLines.join(', ')} shown compactly. Their anchors hash the full original lines`);\n    }\n    if (endIndex < lines.length) {\n      notices.push(`${lines.length - endIndex} more lines in file. Use offset=${endIndex + 1} to continue`);\n    }\n    if (notices.length > 0) text += `\\n\\n[${notices.join('. ')}.]`;\n  }\n\n  return { content: [{ type: 'text', text }], details };\n}\n\nexport function isImageRead(content: readonly { readonly type: string; readonly text?: string }[]): boolean {\n  return content.some((part) => part.type === 'image' || part.text?.startsWith('Read image file') === true);\n}\n\nexport function createHeadlessReadTool(\n  filesystem: FileSystem | (() => FileSystem),\n): PoHeadlessTool<typeof ReadParamsSchema> {\n  return {\n    name: 'read',\n    label: 'read',\n    description:\n      'Read a writable text file with an exact-byte file tag and stable line anchors. Non-writable files and images return native-compatible content. Files over 8 MiB are refused. Text is truncated to 50.0KB.',\n    promptSnippet: 'Read file contents with snapshot-bound line anchors',\n    promptGuidelines: [\n      'Use read before edit. When hashline metadata is present, preserve the @file hash and anchors such as 5#abc exactly.',\n      'Continue large reads with offset until the required anchored lines are visible.',\n    ],\n    parameters: ReadParamsSchema,\n    executionMode: 'parallel',\n    execute: async (\n      _toolCallId: string,\n      params: ReadParams,\n      signal: AbortSignal | undefined,\n      _onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => executeHeadlessRead(params, context.cwd, signal, typeof filesystem === 'function' ? filesystem() : filesystem),\n  };\n}\n"],"mappings":"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"}

package/dist/readTool-Cja4cIaR.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"readTool-Cja4cIaR.mjs","names":[],"sources":["../src/schemas/readTool.ts","../src/services/readImage/index.ts","../src/services/readTool/index.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const ReadParamsSchema = Type.Object({\n  path: Type.String({ description: 'Path to the file to read.' }),\n  offset: Type.Optional(Type.Integer({ minimum: 1, description: 'One-based line offset.' })),\n  limit: Type.Optional(Type.Integer({ minimum: 1, description: 'Maximum number of lines to return.' })),\n});\n\nexport type ReadParams = Static<typeof ReadParamsSchema>;\n","import { loadPiImageSettings, type PiImageSettings } from '@agimon-ai/po-config/piConfig';\n\nconst OMITTED_NOTE = '[Image omitted: could not be resized below the inline image size limit.]';\n\nexport interface ReadTextPart {\n  type: 'text';\n  text: string;\n}\n\nexport interface ReadImagePart {\n  type: 'image';\n  data: string;\n  mimeType: string;\n}\n\nexport type ReadContentPart = ReadTextPart | ReadImagePart;\n\nexport interface ReadImageResizeResult {\n  readonly data: string;\n  readonly mimeType: string;\n  readonly originalWidth: number;\n  readonly originalHeight: number;\n  readonly width: number;\n  readonly height: number;\n  readonly wasResized: boolean;\n}\n\nexport interface ReadImageResizeOperations {\n  resize(\n    inputBytes: Uint8Array,\n    mimeType: string,\n    options: { readonly maxWidth: number; readonly maxHeight: number },\n  ): Promise<ReadImageResizeResult | null>;\n  formatDimensionNote(result: ReadImageResizeResult): string | undefined;\n}\n\nexport function imageLimits(): PiImageSettings {\n  return loadPiImageSettings();\n}\n\nexport async function applyImageLimits(\n  content: ReadContentPart[],\n  limits: PiImageSettings,\n  operations: ReadImageResizeOperations,\n): Promise<ReadContentPart[]> {\n  if (!limits.autoResize || !content.some((part) => part.type === 'image')) return content;\n  const resolved: ReadContentPart[] = [];\n  for (const part of content) {\n    if (part.type !== 'image') {\n      resolved.push(part);\n      continue;\n    }\n    const resized = await operations.resize(Buffer.from(part.data, 'base64'), part.mimeType, {\n      maxWidth: limits.maxDimension,\n      maxHeight: limits.maxDimension,\n    });\n    if (!resized) {\n      resolved.push({ type: 'text', text: OMITTED_NOTE });\n      continue;\n    }\n    resolved.push({ type: 'image', data: resized.data, mimeType: resized.mimeType });\n    const note = operations.formatDimensionNote(resized);\n    if (note) resolved.push({ type: 'text', text: note });\n  }\n  return resolved;\n}\n","import type { PoHeadlessExecutionContext, PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport {\n  BACKGROUND_CONTEXT,\n  FileTooLargeError,\n  readBoundedFile,\n  withAbortSignal,\n  type FileSystem,\n} from '@agimon-ai/po-core/platform';\nimport { formatFileHeader, formatTaggedLine, splitLines } from '@agimon-ai/po-hashline';\nimport {\n  computeFileTag,\n  decodeUtf8,\n  displayPath,\n  isWritableFile,\n  resolveReadInputPath,\n} from '@agimon-ai/po-hashline/files';\nimport {\n  DEFAULT_MAX_BYTES,\n  formatDimensionNote,\n  formatSize,\n  resizeImage,\n  truncateHead,\n  truncateLine,\n  type ReadToolDetails,\n} from '@earendil-works/pi-coding-agent';\n\nimport { ReadParamsSchema, type ReadParams } from '../../schemas/readTool';\nimport {\n  applyImageLimits,\n  imageLimits,\n  type ReadContentPart,\n  type ReadImageResizeOperations,\n  type ReadTextPart,\n} from '../readImage';\n\nconst resizeOperations: ReadImageResizeOperations = {\n  resize: resizeImage,\n  formatDimensionNote: (result) => formatDimensionNote(result),\n};\n\nexport interface ReadToolResult {\n  content: ReadContentPart[];\n  details?: ReadToolDetails;\n}\n\ninterface ReadTextToolResult {\n  content: ReadTextPart[];\n  details?: ReadToolDetails;\n}\n\nexport function assertNotAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw new Error('Operation aborted');\n}\n\nexport function isImagePath(filePath: string): string | undefined {\n  const extension = filePath.toLowerCase().match(/\\.([a-z0-9]+)$/u)?.[1];\n  if (!extension) return undefined;\n  const mimeTypes: Record<string, string> = {\n    avif: 'image/avif',\n    gif: 'image/gif',\n    jpeg: 'image/jpeg',\n    jpg: 'image/jpeg',\n    png: 'image/png',\n    webp: 'image/webp',\n  };\n  return mimeTypes[extension];\n}\n\nexport async function executeHeadlessRead(\n  params: ReadParams,\n  cwd: string,\n  signal: AbortSignal | undefined,\n  filesystem: FileSystem,\n): Promise<ReadToolResult> {\n  assertNotAborted(signal);\n  const absolutePath = await resolveReadInputPath(params.path, cwd);\n  const context = signal ? withAbortSignal(signal, BACKGROUND_CONTEXT) : BACKGROUND_CONTEXT;\n  let bytes: Buffer;\n  try {\n    bytes = Buffer.from(await readBoundedFile(filesystem, absolutePath, 8 * 1024 * 1024, context));\n  } catch (error) {\n    if (error instanceof FileTooLargeError) {\n      throw new Error('File is over 8 MiB, hashline read refuses; use runner log tools for logs.', { cause: error });\n    }\n    throw error;\n  }\n  assertNotAborted(signal);\n  const mimeType = isImagePath(absolutePath);\n  if (mimeType) {\n    const content: ReadContentPart[] = [\n      { type: 'text', text: `Read image file ${displayPath(absolutePath, cwd)} [${mimeType}]` },\n      { type: 'image', data: bytes.toString('base64'), mimeType },\n    ];\n    return { content: await applyImageLimits(content, imageLimits(), resizeOperations) };\n  }\n  if (!(await isWritableFile(absolutePath))) {\n    return { content: [{ type: 'text', text: decodeUtf8(bytes, displayPath(absolutePath, cwd)) }] };\n  }\n  return createTaggedReadResult(bytes, displayPath(absolutePath, cwd), params);\n}\n\nexport function createTaggedReadResult(bytes: Buffer, path: string, params: ReadParams): ReadTextToolResult {\n  const lines = splitLines(decodeUtf8(bytes, path));\n  const startIndex = params.offset === undefined ? 0 : params.offset - 1;\n  if (startIndex >= lines.length) {\n    throw new Error(`Offset ${params.offset} is beyond end of file (${lines.length} lines total).`);\n  }\n\n  const endIndex = params.limit === undefined ? lines.length : Math.min(lines.length, startIndex + params.limit);\n  const selected = lines.slice(startIndex, endIndex);\n  const header = formatFileHeader(path, computeFileTag(bytes));\n  const compactedLines: number[] = [];\n  const headerBytes = Buffer.byteLength(header, 'utf8') + 1;\n  const tagged = selected.map((line, index) => {\n    const lineNumber = startIndex + index + 1;\n    const full = formatTaggedLine(line, lineNumber);\n    if (Buffer.byteLength(full, 'utf8') <= DEFAULT_MAX_BYTES - headerBytes) return full;\n    compactedLines.push(lineNumber);\n    return formatTaggedLine(truncateLine(line).text, lineNumber, '', line);\n  });\n  const truncation = truncateHead([header, ...tagged].join('\\n'));\n  let text = truncation.content;\n  let details: ReadToolDetails | undefined;\n\n  if (truncation.truncated) {\n    const shownLines = Math.max(0, truncation.outputLines - 1);\n    const nextOffset = startIndex + shownLines + 1;\n    const reason = truncation.truncatedBy === 'bytes' ? `, ${formatSize(DEFAULT_MAX_BYTES)} limit` : '';\n    text += `\\n\\n[Showing ${shownLines} anchored lines${reason}. Use offset=${nextOffset} to continue.]`;\n    details = { truncation };\n  } else {\n    const notices: string[] = [];\n    if (compactedLines.length > 0) {\n      notices.push(`Lines ${compactedLines.join(', ')} shown compactly. Their anchors hash the full original lines`);\n    }\n    if (endIndex < lines.length) {\n      notices.push(`${lines.length - endIndex} more lines in file. Use offset=${endIndex + 1} to continue`);\n    }\n    if (notices.length > 0) text += `\\n\\n[${notices.join('. ')}.]`;\n  }\n\n  return { content: [{ type: 'text', text }], details };\n}\n\nexport function isImageRead(content: readonly { readonly type: string; readonly text?: string }[]): boolean {\n  return content.some((part) => part.type === 'image' || part.text?.startsWith('Read image file') === true);\n}\n\nexport function createHeadlessReadTool(\n  filesystem: FileSystem | (() => FileSystem),\n): PoHeadlessTool<typeof ReadParamsSchema> {\n  return {\n    name: 'read',\n    label: 'read',\n    description:\n      'Read a writable text file with an exact-byte file tag and stable line anchors. Non-writable files and images return native-compatible content. Files over 8 MiB are refused. Text is truncated to 50.0KB.',\n    promptSnippet: 'Read file contents with snapshot-bound line anchors',\n    promptGuidelines: [\n      'Use read before edit. When hashline metadata is present, preserve the @file hash and anchors such as 5#abc exactly.',\n      'Continue large reads with offset until the required anchored lines are visible.',\n    ],\n    parameters: ReadParamsSchema,\n    executionMode: 'parallel',\n    execute: async (\n      _toolCallId: string,\n      params: ReadParams,\n      signal: AbortSignal | undefined,\n      _onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => executeHeadlessRead(params, context.cwd, signal, typeof filesystem === 'function' ? filesystem() : filesystem),\n  };\n}\n"],"mappings":"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"}