@imdigitalashish/zpi 0.1.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/core/tools/memory.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * Built-in memory tools: memory_write, memory_read, memory_update, memory_delete\r\n */\r\n\r\nimport type { AgentTool } from \"@mariozechner/pi-agent-core\";\r\nimport { StringEnum } from \"@mariozechner/pi-ai\";\r\nimport { type Static, Type } from \"@sinclair/typebox\";\r\nimport {\r\n\ttype EpisodicMemory,\r\n\tformatEpisodicForDisplay,\r\n\tformatProceduralForDisplay,\r\n\tformatSemanticForDisplay,\r\n\tgenerateId,\r\n\tloadStore,\r\n\tnowISO,\r\n\ttype ProceduralMemory,\r\n\ttype SemanticMemory,\r\n\tsaveStore,\r\n\tsearchMemories,\r\n} from \"../memory.js\";\r\n\r\nexport interface MemoryToolContext {\r\n\tcwd: string;\r\n\tsessionId: string;\r\n}\r\n\r\nlet memoryContext: MemoryToolContext = { cwd: process.cwd(), sessionId: `session_${Date.now()}` };\r\n\r\nexport function setMemoryToolContext(ctx: MemoryToolContext): void {\r\n\tmemoryContext = ctx;\r\n}\r\n\r\n// ---------------------------------------------------------------------------\r\n// Schemas\r\n// ---------------------------------------------------------------------------\r\n\r\nconst memoryWriteSchema = Type.Object({\r\n\ttype: StringEnum([\"procedural\", \"episodic\", \"semantic\"] as const),\r\n\tname: Type.Optional(Type.String({ description: \"Name for procedural memories (e.g., 'deploy-service')\" })),\r\n\ttrigger: Type.Optional(\r\n\t\tType.String({ description: \"When to invoke this procedure (e.g., 'user asks to deploy a service')\" }),\r\n\t),\r\n\tsteps: Type.Optional(Type.Array(Type.String(), { description: \"Steps for procedural memory\" })),\r\n\tsummary: Type.Optional(Type.String({ description: \"Summary for episodic memory\" })),\r\n\tdetails: Type.Optional(Type.Array(Type.String(), { description: \"Details for episodic memory\" })),\r\n\tcategory: Type.Optional(\r\n\t\tStringEnum([\"preference\", \"architecture\", \"convention\", \"fact\"] as const, {\r\n\t\t\tdescription: \"Category for semantic memory\",\r\n\t\t}),\r\n\t),\r\n\ttext: Type.Optional(Type.String({ description: \"Text content for semantic memory\" })),\r\n\ttags: Type.Optional(Type.Array(Type.String(), { description: \"Tags for searchability\" })),\r\n\treflection_mistakes: Type.Optional(\r\n\t\tType.Array(Type.String(), { description: \"Mistakes made (for episodic reflection)\" }),\r\n\t),\r\n\treflection_lessons: Type.Optional(\r\n\t\tType.Array(Type.String(), { description: \"Lessons learned (for episodic reflection)\" }),\r\n\t),\r\n});\r\n\r\ntype MemoryWriteInput = Static<typeof memoryWriteSchema>;\r\n\r\nconst memoryReadSchema = Type.Object({\r\n\ttype: Type.Optional(StringEnum([\"procedural\", \"episodic\", \"semantic\", \"all\"] as const)),\r\n\tid: Type.Optional(Type.String({ description: \"Specific memory ID to retrieve\" })),\r\n\tquery: Type.Optional(Type.String({ description: \"Search query to find relevant memories\" })),\r\n});\r\n\r\ntype MemoryReadInput = Static<typeof memoryReadSchema>;\r\n\r\nconst memoryUpdateSchema = Type.Object({\r\n\tid: Type.String({ description: \"Memory ID to update\" }),\r\n\ttext: Type.Optional(Type.String({ description: \"New text (for semantic memories)\" })),\r\n\tsteps: Type.Optional(Type.Array(Type.String(), { description: \"New steps (for procedural memories)\" })),\r\n\ttrigger: Type.Optional(Type.String({ description: \"New trigger (for procedural memories)\" })),\r\n\ttags: Type.Optional(Type.Array(Type.String(), { description: \"Replace tags\" })),\r\n});\r\n\r\ntype MemoryUpdateInput = Static<typeof memoryUpdateSchema>;\r\n\r\nconst memoryDeleteSchema = Type.Object({\r\n\tid: Type.String({ description: \"Memory ID to delete (e.g., 'proc_001', 'sem_003')\" }),\r\n});\r\n\r\ntype MemoryDeleteInput = Static<typeof memoryDeleteSchema>;\r\n\r\n// ---------------------------------------------------------------------------\r\n// memory_write\r\n// ---------------------------------------------------------------------------\r\n\r\nexport const memoryWriteTool: AgentTool<typeof memoryWriteSchema> = {\r\n\tname: \"memory_write\",\r\n\tlabel: \"Write Memory\",\r\n\tdescription:\r\n\t\t\"Save a memory to the persistent memory system. Use this automatically when: \" +\r\n\t\t\"(1) the user teaches you a multi-step workflow — save as 'procedural', \" +\r\n\t\t\"(2) the user states a preference, rule, or fact — save as 'semantic', \" +\r\n\t\t\"(3) a significant task completes — save as 'episodic'. \" +\r\n\t\t\"Do NOT ask the user for permission to save unless there is a conflict with an existing memory.\",\r\n\tparameters: memoryWriteSchema,\r\n\texecute: async (_toolCallId: string, params: MemoryWriteInput) => {\r\n\t\tconst { cwd, sessionId } = memoryContext;\r\n\t\tconst tags = params.tags ?? [];\r\n\r\n\t\tif (params.type === \"procedural\") {\r\n\t\t\tif (!params.name || !params.trigger || !params.steps?.length) {\r\n\t\t\t\treturn {\r\n\t\t\t\t\tcontent: [{ type: \"text\", text: \"Error: procedural memory requires name, trigger, and steps.\" }],\r\n\t\t\t\t\tdetails: {},\r\n\t\t\t\t};\r\n\t\t\t}\r\n\t\t\tconst store = loadStore<ProceduralMemory>(cwd, \"procedural.json\");\r\n\t\t\tconst existing = store.memories.find((m) => m.name === params.name);\r\n\t\t\tif (existing) {\r\n\t\t\t\texisting.steps = params.steps;\r\n\t\t\t\texisting.trigger = params.trigger;\r\n\t\t\t\texisting.tags = [...new Set([...existing.tags, ...tags])];\r\n\t\t\t\texisting.updated = nowISO();\r\n\t\t\t\tsaveStore(cwd, \"procedural.json\", store);\r\n\t\t\t\treturn {\r\n\t\t\t\t\tcontent: [{ type: \"text\", text: `Updated procedural memory [${existing.id}] \"${params.name}\".` }],\r\n\t\t\t\t\tdetails: { action: \"updated\", id: existing.id },\r\n\t\t\t\t};\r\n\t\t\t}\r\n\t\t\tconst id = generateId(\"proc\", store);\r\n\t\t\tstore.memories.push({\r\n\t\t\t\tid,\r\n\t\t\t\tname: params.name,\r\n\t\t\t\ttrigger: params.trigger,\r\n\t\t\t\tsteps: params.steps,\r\n\t\t\t\ttags,\r\n\t\t\t\tcreated: nowISO(),\r\n\t\t\t\tupdated: nowISO(),\r\n\t\t\t\tsourceSession: sessionId,\r\n\t\t\t});\r\n\t\t\tsaveStore(cwd, \"procedural.json\", store);\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: `Saved procedural memory [${id}] \"${params.name}\".` }],\r\n\t\t\t\tdetails: { action: \"created\", id },\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\tif (params.type === \"episodic\") {\r\n\t\t\tif (!params.summary) {\r\n\t\t\t\treturn {\r\n\t\t\t\t\tcontent: [{ type: \"text\", text: \"Error: episodic memory requires a summary.\" }],\r\n\t\t\t\t\tdetails: {},\r\n\t\t\t\t};\r\n\t\t\t}\r\n\t\t\tconst store = loadStore<EpisodicMemory>(cwd, \"episodic.json\");\r\n\t\t\tconst id = generateId(\"ep\", store);\r\n\t\t\tconst reflection =\r\n\t\t\t\tparams.reflection_mistakes?.length || params.reflection_lessons?.length\r\n\t\t\t\t\t? { mistakes: params.reflection_mistakes ?? [], lessons: params.reflection_lessons ?? [] }\r\n\t\t\t\t\t: undefined;\r\n\t\t\tstore.memories.push({\r\n\t\t\t\tid,\r\n\t\t\t\tsummary: params.summary,\r\n\t\t\t\tdetails: params.details ?? [],\r\n\t\t\t\treflection,\r\n\t\t\t\ttags,\r\n\t\t\t\tdate: new Date().toISOString().split(\"T\")[0],\r\n\t\t\t\tsourceSession: sessionId,\r\n\t\t\t});\r\n\t\t\tsaveStore(cwd, \"episodic.json\", store);\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: `Saved episodic memory [${id}] \"${params.summary}\".` }],\r\n\t\t\t\tdetails: { action: \"created\", id },\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\tif (params.type === \"semantic\") {\r\n\t\t\tif (!params.text || !params.category) {\r\n\t\t\t\treturn {\r\n\t\t\t\t\tcontent: [{ type: \"text\", text: \"Error: semantic memory requires text and category.\" }],\r\n\t\t\t\t\tdetails: {},\r\n\t\t\t\t};\r\n\t\t\t}\r\n\t\t\tconst store = loadStore<SemanticMemory>(cwd, \"semantic.json\");\r\n\t\t\tconst existing = store.memories.find(\r\n\t\t\t\t(m) => m.category === params.category && m.text.toLowerCase() === params.text!.toLowerCase(),\r\n\t\t\t);\r\n\t\t\tif (existing) {\r\n\t\t\t\treturn {\r\n\t\t\t\t\tcontent: [{ type: \"text\", text: `This semantic memory already exists [${existing.id}].` }],\r\n\t\t\t\t\tdetails: { action: \"duplicate\", id: existing.id },\r\n\t\t\t\t};\r\n\t\t\t}\r\n\t\t\tconst id = generateId(\"sem\", store);\r\n\t\t\tstore.memories.push({\r\n\t\t\t\tid,\r\n\t\t\t\tcategory: params.category,\r\n\t\t\t\ttext: params.text,\r\n\t\t\t\ttags,\r\n\t\t\t\tcreated: nowISO(),\r\n\t\t\t\tsourceSession: sessionId,\r\n\t\t\t});\r\n\t\t\tsaveStore(cwd, \"semantic.json\", store);\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: `Saved semantic memory [${id}] (${params.category}): \"${params.text}\".` }],\r\n\t\t\t\tdetails: { action: \"created\", id },\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\treturn {\r\n\t\t\tcontent: [{ type: \"text\", text: `Unknown memory type: ${params.type}` }],\r\n\t\t\tdetails: {},\r\n\t\t};\r\n\t},\r\n};\r\n\r\n// ---------------------------------------------------------------------------\r\n// memory_read\r\n// ---------------------------------------------------------------------------\r\n\r\nexport const memoryReadTool: AgentTool<typeof memoryReadSchema> = {\r\n\tname: \"memory_read\",\r\n\tlabel: \"Read Memory\",\r\n\tdescription:\r\n\t\t\"Read memories from the persistent memory system. Use this when you need to recall \" +\r\n\t\t\"past workflows, user preferences, or what happened in previous sessions. \" +\r\n\t\t\"You can read all memories of a type, a specific memory by ID, or search by query.\",\r\n\tparameters: memoryReadSchema,\r\n\texecute: async (_toolCallId: string, params: MemoryReadInput) => {\r\n\t\tconst { cwd } = memoryContext;\r\n\r\n\t\tif (params.id) {\r\n\t\t\tconst allStores: Array<{ file: string; format: (m: any) => string }> = [\r\n\t\t\t\t{ file: \"procedural.json\", format: formatProceduralForDisplay },\r\n\t\t\t\t{ file: \"episodic.json\", format: formatEpisodicForDisplay },\r\n\t\t\t\t{ file: \"semantic.json\", format: formatSemanticForDisplay },\r\n\t\t\t];\r\n\t\t\tfor (const { file, format } of allStores) {\r\n\t\t\t\tconst store = loadStore<{ id: string }>(cwd, file);\r\n\t\t\t\tconst found = store.memories.find((m) => m.id === params.id);\r\n\t\t\t\tif (found) {\r\n\t\t\t\t\treturn {\r\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: format(found) }],\r\n\t\t\t\t\t\tdetails: { found: true },\r\n\t\t\t\t\t};\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: `No memory found with ID \"${params.id}\".` }],\r\n\t\t\t\tdetails: { found: false },\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\tif (params.query) {\r\n\t\t\tconst results: string[] = [];\r\n\t\t\tconst type = params.type ?? \"all\";\r\n\r\n\t\t\tif (type === \"all\" || type === \"procedural\") {\r\n\t\t\t\tconst store = loadStore<ProceduralMemory>(cwd, \"procedural.json\");\r\n\t\t\t\tconst matches = searchMemories(\r\n\t\t\t\t\tstore.memories,\r\n\t\t\t\t\tparams.query,\r\n\t\t\t\t\t(m) => `${m.name} ${m.trigger} ${m.steps.join(\" \")}`,\r\n\t\t\t\t);\r\n\t\t\t\tresults.push(...matches.map(formatProceduralForDisplay));\r\n\t\t\t}\r\n\t\t\tif (type === \"all\" || type === \"episodic\") {\r\n\t\t\t\tconst store = loadStore<EpisodicMemory>(cwd, \"episodic.json\");\r\n\t\t\t\tconst matches = searchMemories(store.memories, params.query, (m) => `${m.summary} ${m.details.join(\" \")}`);\r\n\t\t\t\tresults.push(...matches.map(formatEpisodicForDisplay));\r\n\t\t\t}\r\n\t\t\tif (type === \"all\" || type === \"semantic\") {\r\n\t\t\t\tconst store = loadStore<SemanticMemory>(cwd, \"semantic.json\");\r\n\t\t\t\tconst matches = searchMemories(store.memories, params.query, (m) => `${m.category} ${m.text}`);\r\n\t\t\t\tresults.push(...matches.map(formatSemanticForDisplay));\r\n\t\t\t}\r\n\r\n\t\t\tif (results.length === 0) {\r\n\t\t\t\treturn {\r\n\t\t\t\t\tcontent: [{ type: \"text\", text: `No memories found matching \"${params.query}\".` }],\r\n\t\t\t\t\tdetails: { count: 0 },\r\n\t\t\t\t};\r\n\t\t\t}\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: results.join(\"\\n\\n\") }],\r\n\t\t\t\tdetails: { count: results.length },\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\tconst type = params.type ?? \"all\";\r\n\t\tconst results: string[] = [];\r\n\r\n\t\tif (type === \"all\" || type === \"procedural\") {\r\n\t\t\tconst store = loadStore<ProceduralMemory>(cwd, \"procedural.json\");\r\n\t\t\tif (store.memories.length > 0) {\r\n\t\t\t\tresults.push(\"=== Procedural Memories ===\");\r\n\t\t\t\tresults.push(...store.memories.map(formatProceduralForDisplay));\r\n\t\t\t}\r\n\t\t}\r\n\t\tif (type === \"all\" || type === \"episodic\") {\r\n\t\t\tconst store = loadStore<EpisodicMemory>(cwd, \"episodic.json\");\r\n\t\t\tif (store.memories.length > 0) {\r\n\t\t\t\tresults.push(\"=== Episodic Memories ===\");\r\n\t\t\t\tresults.push(...store.memories.map(formatEpisodicForDisplay));\r\n\t\t\t}\r\n\t\t}\r\n\t\tif (type === \"all\" || type === \"semantic\") {\r\n\t\t\tconst store = loadStore<SemanticMemory>(cwd, \"semantic.json\");\r\n\t\t\tif (store.memories.length > 0) {\r\n\t\t\t\tresults.push(\"=== Semantic Memories ===\");\r\n\t\t\t\tresults.push(...store.memories.map(formatSemanticForDisplay));\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\tif (results.length === 0) {\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: \"No memories stored yet.\" }],\r\n\t\t\t\tdetails: { count: 0 },\r\n\t\t\t};\r\n\t\t}\r\n\t\treturn {\r\n\t\t\tcontent: [{ type: \"text\", text: results.join(\"\\n\\n\") }],\r\n\t\t\tdetails: { count: results.length },\r\n\t\t};\r\n\t},\r\n};\r\n\r\n// ---------------------------------------------------------------------------\r\n// memory_update\r\n// ---------------------------------------------------------------------------\r\n\r\nexport const memoryUpdateTool: AgentTool<typeof memoryUpdateSchema> = {\r\n\tname: \"memory_update\",\r\n\tlabel: \"Update Memory\",\r\n\tdescription:\r\n\t\t\"Update an existing memory. Use this when the user confirms a change to a \" +\r\n\t\t\"previously stored preference, procedure step, or fact. Always ask for \" +\r\n\t\t\"confirmation before updating if there is a conflict.\",\r\n\tparameters: memoryUpdateSchema,\r\n\texecute: async (_toolCallId: string, params: MemoryUpdateInput) => {\r\n\t\tconst { cwd } = memoryContext;\r\n\r\n\t\tconst procStore = loadStore<ProceduralMemory>(cwd, \"procedural.json\");\r\n\t\tconst proc = procStore.memories.find((m) => m.id === params.id);\r\n\t\tif (proc) {\r\n\t\t\tif (params.steps) proc.steps = params.steps;\r\n\t\t\tif (params.trigger) proc.trigger = params.trigger;\r\n\t\t\tif (params.tags) proc.tags = params.tags;\r\n\t\t\tproc.updated = nowISO();\r\n\t\t\tsaveStore(cwd, \"procedural.json\", procStore);\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: `Updated procedural memory [${params.id}].` }],\r\n\t\t\t\tdetails: { updated: true },\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\tconst semStore = loadStore<SemanticMemory>(cwd, \"semantic.json\");\r\n\t\tconst sem = semStore.memories.find((m) => m.id === params.id);\r\n\t\tif (sem) {\r\n\t\t\tif (params.text) sem.text = params.text;\r\n\t\t\tif (params.tags) sem.tags = params.tags;\r\n\t\t\tsaveStore(cwd, \"semantic.json\", semStore);\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: `Updated semantic memory [${params.id}].` }],\r\n\t\t\t\tdetails: { updated: true },\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\tconst epStore = loadStore<EpisodicMemory>(cwd, \"episodic.json\");\r\n\t\tconst ep = epStore.memories.find((m) => m.id === params.id);\r\n\t\tif (ep) {\r\n\t\t\tif (params.tags) ep.tags = params.tags;\r\n\t\t\tsaveStore(cwd, \"episodic.json\", epStore);\r\n\t\t\treturn {\r\n\t\t\t\tcontent: [{ type: \"text\", text: `Updated episodic memory [${params.id}].` }],\r\n\t\t\t\tdetails: { updated: true },\r\n\t\t\t};\r\n\t\t}\r\n\r\n\t\treturn {\r\n\t\t\tcontent: [{ type: \"text\", text: `No memory found with ID \"${params.id}\".` }],\r\n\t\t\tdetails: { updated: false },\r\n\t\t};\r\n\t},\r\n};\r\n\r\n// ---------------------------------------------------------------------------\r\n// memory_delete\r\n// ---------------------------------------------------------------------------\r\n\r\nexport const memoryDeleteTool: AgentTool<typeof memoryDeleteSchema> = {\r\n\tname: \"memory_delete\",\r\n\tlabel: \"Delete Memory\",\r\n\tdescription:\r\n\t\t\"Delete a specific memory by ID. Use this when the user asks to remove a memory \" +\r\n\t\t\"or when a memory is confirmed to be outdated.\",\r\n\tparameters: memoryDeleteSchema,\r\n\texecute: async (_toolCallId: string, params: MemoryDeleteInput) => {\r\n\t\tconst { cwd } = memoryContext;\r\n\t\tconst files = [\"procedural.json\", \"episodic.json\", \"semantic.json\"] as const;\r\n\r\n\t\tfor (const file of files) {\r\n\t\t\tconst store = loadStore<{ id: string }>(cwd, file);\r\n\t\t\tconst idx = store.memories.findIndex((m) => m.id === params.id);\r\n\t\t\tif (idx !== -1) {\r\n\t\t\t\tstore.memories.splice(idx, 1);\r\n\t\t\t\tsaveStore(cwd, file, store);\r\n\t\t\t\treturn {\r\n\t\t\t\t\tcontent: [{ type: \"text\", text: `Deleted memory [${params.id}] from ${file.replace(\".json\", \"\")}.` }],\r\n\t\t\t\t\tdetails: { deleted: true },\r\n\t\t\t\t};\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\treturn {\r\n\t\t\tcontent: [{ type: \"text\", text: `No memory found with ID \"${params.id}\".` }],\r\n\t\t\tdetails: { deleted: false },\r\n\t\t};\r\n\t},\r\n};\r\n\r\n/** All memory tools */\r\nexport const memoryTools: AgentTool<any>[] = [memoryWriteTool, memoryReadTool, memoryUpdateTool, memoryDeleteTool];\r\n"]}

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

@@ -0,0 +1,8 @@
+export declare function expandPath(filePath: string): string;
+/**
+ * Resolve a path relative to the given cwd.
+ * Handles ~ expansion and absolute paths.
+ */
+export declare function resolveToCwd(filePath: string, cwd: string): string;
+export declare function resolveReadPath(filePath: string, cwd: string): string;
+//# sourceMappingURL=path-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../../src/core/tools/path-utils.ts"],"names":[],"mappings":"AAsCA,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CASnD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAMlE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAgCrE","sourcesContent":["import { accessSync, constants } from \"node:fs\";\r\nimport * as os from \"node:os\";\r\nimport { isAbsolute, resolve as resolvePath } from \"node:path\";\r\n\r\nconst UNICODE_SPACES = /[\\u00A0\\u2000-\\u200A\\u202F\\u205F\\u3000]/g;\r\nconst NARROW_NO_BREAK_SPACE = \"\\u202F\";\r\nfunction normalizeUnicodeSpaces(str: string): string {\r\n\treturn str.replace(UNICODE_SPACES, \" \");\r\n}\r\n\r\nfunction tryMacOSScreenshotPath(filePath: string): string {\r\n\treturn filePath.replace(/ (AM|PM)\\./g, `${NARROW_NO_BREAK_SPACE}$1.`);\r\n}\r\n\r\nfunction tryNFDVariant(filePath: string): string {\r\n\t// macOS stores filenames in NFD (decomposed) form, try converting user input to NFD\r\n\treturn filePath.normalize(\"NFD\");\r\n}\r\n\r\nfunction tryCurlyQuoteVariant(filePath: string): string {\r\n\t// macOS uses U+2019 (right single quotation mark) in screenshot names like \"Capture d'écran\"\r\n\t// Users typically type U+0027 (straight apostrophe)\r\n\treturn filePath.replace(/'/g, \"\\u2019\");\r\n}\r\n\r\nfunction fileExists(filePath: string): boolean {\r\n\ttry {\r\n\t\taccessSync(filePath, constants.F_OK);\r\n\t\treturn true;\r\n\t} catch {\r\n\t\treturn false;\r\n\t}\r\n}\r\n\r\nfunction normalizeAtPrefix(filePath: string): string {\r\n\treturn filePath.startsWith(\"@\") ? filePath.slice(1) : filePath;\r\n}\r\n\r\nexport function expandPath(filePath: string): string {\r\n\tconst normalized = normalizeUnicodeSpaces(normalizeAtPrefix(filePath));\r\n\tif (normalized === \"~\") {\r\n\t\treturn os.homedir();\r\n\t}\r\n\tif (normalized.startsWith(\"~/\")) {\r\n\t\treturn os.homedir() + normalized.slice(1);\r\n\t}\r\n\treturn normalized;\r\n}\r\n\r\n/**\r\n * Resolve a path relative to the given cwd.\r\n * Handles ~ expansion and absolute paths.\r\n */\r\nexport function resolveToCwd(filePath: string, cwd: string): string {\r\n\tconst expanded = expandPath(filePath);\r\n\tif (isAbsolute(expanded)) {\r\n\t\treturn expanded;\r\n\t}\r\n\treturn resolvePath(cwd, expanded);\r\n}\r\n\r\nexport function resolveReadPath(filePath: string, cwd: string): string {\r\n\tconst resolved = resolveToCwd(filePath, cwd);\r\n\r\n\tif (fileExists(resolved)) {\r\n\t\treturn resolved;\r\n\t}\r\n\r\n\t// Try macOS AM/PM variant (narrow no-break space before AM/PM)\r\n\tconst amPmVariant = tryMacOSScreenshotPath(resolved);\r\n\tif (amPmVariant !== resolved && fileExists(amPmVariant)) {\r\n\t\treturn amPmVariant;\r\n\t}\r\n\r\n\t// Try NFD variant (macOS stores filenames in NFD form)\r\n\tconst nfdVariant = tryNFDVariant(resolved);\r\n\tif (nfdVariant !== resolved && fileExists(nfdVariant)) {\r\n\t\treturn nfdVariant;\r\n\t}\r\n\r\n\t// Try curly quote variant (macOS uses U+2019 in screenshot names)\r\n\tconst curlyVariant = tryCurlyQuoteVariant(resolved);\r\n\tif (curlyVariant !== resolved && fileExists(curlyVariant)) {\r\n\t\treturn curlyVariant;\r\n\t}\r\n\r\n\t// Try combined NFD + curly quote (for French macOS screenshots like \"Capture d'écran\")\r\n\tconst nfdCurlyVariant = tryCurlyQuoteVariant(nfdVariant);\r\n\tif (nfdCurlyVariant !== resolved && fileExists(nfdCurlyVariant)) {\r\n\t\treturn nfdCurlyVariant;\r\n\t}\r\n\r\n\treturn resolved;\r\n}\r\n"]}

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

@@ -0,0 +1,81 @@
+import { accessSync, constants } from "node:fs";
+import * as os from "node:os";
+import { isAbsolute, resolve as resolvePath } from "node:path";
+const UNICODE_SPACES = /[\u00A0\u2000-\u200A\u202F\u205F\u3000]/g;
+const NARROW_NO_BREAK_SPACE = "\u202F";
+function normalizeUnicodeSpaces(str) {
+    return str.replace(UNICODE_SPACES, " ");
+}
+function tryMacOSScreenshotPath(filePath) {
+    return filePath.replace(/ (AM|PM)\./g, `${NARROW_NO_BREAK_SPACE}$1.`);
+}
+function tryNFDVariant(filePath) {
+    // macOS stores filenames in NFD (decomposed) form, try converting user input to NFD
+    return filePath.normalize("NFD");
+}
+function tryCurlyQuoteVariant(filePath) {
+    // macOS uses U+2019 (right single quotation mark) in screenshot names like "Capture d'écran"
+    // Users typically type U+0027 (straight apostrophe)
+    return filePath.replace(/'/g, "\u2019");
+}
+function fileExists(filePath) {
+    try {
+        accessSync(filePath, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function normalizeAtPrefix(filePath) {
+    return filePath.startsWith("@") ? filePath.slice(1) : filePath;
+}
+export function expandPath(filePath) {
+    const normalized = normalizeUnicodeSpaces(normalizeAtPrefix(filePath));
+    if (normalized === "~") {
+        return os.homedir();
+    }
+    if (normalized.startsWith("~/")) {
+        return os.homedir() + normalized.slice(1);
+    }
+    return normalized;
+}
+/**
+ * Resolve a path relative to the given cwd.
+ * Handles ~ expansion and absolute paths.
+ */
+export function resolveToCwd(filePath, cwd) {
+    const expanded = expandPath(filePath);
+    if (isAbsolute(expanded)) {
+        return expanded;
+    }
+    return resolvePath(cwd, expanded);
+}
+export function resolveReadPath(filePath, cwd) {
+    const resolved = resolveToCwd(filePath, cwd);
+    if (fileExists(resolved)) {
+        return resolved;
+    }
+    // Try macOS AM/PM variant (narrow no-break space before AM/PM)
+    const amPmVariant = tryMacOSScreenshotPath(resolved);
+    if (amPmVariant !== resolved && fileExists(amPmVariant)) {
+        return amPmVariant;
+    }
+    // Try NFD variant (macOS stores filenames in NFD form)
+    const nfdVariant = tryNFDVariant(resolved);
+    if (nfdVariant !== resolved && fileExists(nfdVariant)) {
+        return nfdVariant;
+    }
+    // Try curly quote variant (macOS uses U+2019 in screenshot names)
+    const curlyVariant = tryCurlyQuoteVariant(resolved);
+    if (curlyVariant !== resolved && fileExists(curlyVariant)) {
+        return curlyVariant;
+    }
+    // Try combined NFD + curly quote (for French macOS screenshots like "Capture d'écran")
+    const nfdCurlyVariant = tryCurlyQuoteVariant(nfdVariant);
+    if (nfdCurlyVariant !== resolved && fileExists(nfdCurlyVariant)) {
+        return nfdCurlyVariant;
+    }
+    return resolved;
+}
+//# sourceMappingURL=path-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../../../src/core/tools/path-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { accessSync, constants } from \"node:fs\";\r\nimport * as os from \"node:os\";\r\nimport { isAbsolute, resolve as resolvePath } from \"node:path\";\r\n\r\nconst UNICODE_SPACES = /[\\u00A0\\u2000-\\u200A\\u202F\\u205F\\u3000]/g;\r\nconst NARROW_NO_BREAK_SPACE = \"\\u202F\";\r\nfunction normalizeUnicodeSpaces(str: string): string {\r\n\treturn str.replace(UNICODE_SPACES, \" \");\r\n}\r\n\r\nfunction tryMacOSScreenshotPath(filePath: string): string {\r\n\treturn filePath.replace(/ (AM|PM)\\./g, `${NARROW_NO_BREAK_SPACE}$1.`);\r\n}\r\n\r\nfunction tryNFDVariant(filePath: string): string {\r\n\t// macOS stores filenames in NFD (decomposed) form, try converting user input to NFD\r\n\treturn filePath.normalize(\"NFD\");\r\n}\r\n\r\nfunction tryCurlyQuoteVariant(filePath: string): string {\r\n\t// macOS uses U+2019 (right single quotation mark) in screenshot names like \"Capture d'écran\"\r\n\t// Users typically type U+0027 (straight apostrophe)\r\n\treturn filePath.replace(/'/g, \"\\u2019\");\r\n}\r\n\r\nfunction fileExists(filePath: string): boolean {\r\n\ttry {\r\n\t\taccessSync(filePath, constants.F_OK);\r\n\t\treturn true;\r\n\t} catch {\r\n\t\treturn false;\r\n\t}\r\n}\r\n\r\nfunction normalizeAtPrefix(filePath: string): string {\r\n\treturn filePath.startsWith(\"@\") ? filePath.slice(1) : filePath;\r\n}\r\n\r\nexport function expandPath(filePath: string): string {\r\n\tconst normalized = normalizeUnicodeSpaces(normalizeAtPrefix(filePath));\r\n\tif (normalized === \"~\") {\r\n\t\treturn os.homedir();\r\n\t}\r\n\tif (normalized.startsWith(\"~/\")) {\r\n\t\treturn os.homedir() + normalized.slice(1);\r\n\t}\r\n\treturn normalized;\r\n}\r\n\r\n/**\r\n * Resolve a path relative to the given cwd.\r\n * Handles ~ expansion and absolute paths.\r\n */\r\nexport function resolveToCwd(filePath: string, cwd: string): string {\r\n\tconst expanded = expandPath(filePath);\r\n\tif (isAbsolute(expanded)) {\r\n\t\treturn expanded;\r\n\t}\r\n\treturn resolvePath(cwd, expanded);\r\n}\r\n\r\nexport function resolveReadPath(filePath: string, cwd: string): string {\r\n\tconst resolved = resolveToCwd(filePath, cwd);\r\n\r\n\tif (fileExists(resolved)) {\r\n\t\treturn resolved;\r\n\t}\r\n\r\n\t// Try macOS AM/PM variant (narrow no-break space before AM/PM)\r\n\tconst amPmVariant = tryMacOSScreenshotPath(resolved);\r\n\tif (amPmVariant !== resolved && fileExists(amPmVariant)) {\r\n\t\treturn amPmVariant;\r\n\t}\r\n\r\n\t// Try NFD variant (macOS stores filenames in NFD form)\r\n\tconst nfdVariant = tryNFDVariant(resolved);\r\n\tif (nfdVariant !== resolved && fileExists(nfdVariant)) {\r\n\t\treturn nfdVariant;\r\n\t}\r\n\r\n\t// Try curly quote variant (macOS uses U+2019 in screenshot names)\r\n\tconst curlyVariant = tryCurlyQuoteVariant(resolved);\r\n\tif (curlyVariant !== resolved && fileExists(curlyVariant)) {\r\n\t\treturn curlyVariant;\r\n\t}\r\n\r\n\t// Try combined NFD + curly quote (for French macOS screenshots like \"Capture d'écran\")\r\n\tconst nfdCurlyVariant = tryCurlyQuoteVariant(nfdVariant);\r\n\tif (nfdCurlyVariant !== resolved && fileExists(nfdCurlyVariant)) {\r\n\t\treturn nfdCurlyVariant;\r\n\t}\r\n\r\n\treturn resolved;\r\n}\r\n"]}

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

@@ -0,0 +1,39 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import { type Static } from "@sinclair/typebox";
+import { type TruncationResult } from "./truncate.js";
+declare const readSchema: import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+    offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export type ReadToolInput = Static<typeof readSchema>;
+export interface ReadToolDetails {
+    truncation?: TruncationResult;
+}
+/**
+ * Pluggable operations for the read tool.
+ * Override these to delegate file reading to remote systems (e.g., SSH).
+ */
+export interface ReadOperations {
+    /** Read file contents as a Buffer */
+    readFile: (absolutePath: string) => Promise<Buffer>;
+    /** Check if file is readable (throw if not) */
+    access: (absolutePath: string) => Promise<void>;
+    /** Detect image MIME type, return null/undefined for non-images */
+    detectImageMimeType?: (absolutePath: string) => Promise<string | null | undefined>;
+}
+export interface ReadToolOptions {
+    /** Whether to auto-resize images to 2000x2000 max. Default: true */
+    autoResizeImages?: boolean;
+    /** Custom operations for file reading. Default: local filesystem */
+    operations?: ReadOperations;
+}
+export declare function createReadTool(cwd: string, options?: ReadToolOptions): AgentTool<typeof readSchema>;
+/** Default read tool using process.cwd() - for backwards compatibility */
+export declare const readTool: AgentTool<import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+    offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>, any>;
+export {};
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/core/tools/read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AAMtD,OAAO,EAAoD,KAAK,gBAAgB,EAAgB,MAAM,eAAe,CAAC;AAEtH,QAAA,MAAM,UAAU;;;;EAId,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC/B,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,qCAAqC;IACrC,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,+CAA+C;IAC/C,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,mEAAmE;IACnE,mBAAmB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACnF;AAQD,MAAM,WAAW,eAAe;IAC/B,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oEAAoE;IACpE,UAAU,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,OAAO,UAAU,CAAC,CA0KnG;AAED,0EAA0E;AAC1E,eAAO,MAAM,QAAQ;;;;QAAgC,CAAC","sourcesContent":["import type { AgentTool } from \"@mariozechner/pi-agent-core\";\r\nimport type { ImageContent, TextContent } from \"@mariozechner/pi-ai\";\r\nimport { type Static, Type } from \"@sinclair/typebox\";\r\nimport { constants } from \"fs\";\r\nimport { access as fsAccess, readFile as fsReadFile } from \"fs/promises\";\r\nimport { formatDimensionNote, resizeImage } from \"../../utils/image-resize.js\";\r\nimport { detectSupportedImageMimeTypeFromFile } from \"../../utils/mime.js\";\r\nimport { resolveReadPath } from \"./path-utils.js\";\r\nimport { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, type TruncationResult, truncateHead } from \"./truncate.js\";\r\n\r\nconst readSchema = Type.Object({\r\n\tpath: Type.String({ description: \"Path to the file to read (relative or absolute)\" }),\r\n\toffset: Type.Optional(Type.Number({ description: \"Line number to start reading from (1-indexed)\" })),\r\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of lines to read\" })),\r\n});\r\n\r\nexport type ReadToolInput = Static<typeof readSchema>;\r\n\r\nexport interface ReadToolDetails {\r\n\ttruncation?: TruncationResult;\r\n}\r\n\r\n/**\r\n * Pluggable operations for the read tool.\r\n * Override these to delegate file reading to remote systems (e.g., SSH).\r\n */\r\nexport interface ReadOperations {\r\n\t/** Read file contents as a Buffer */\r\n\treadFile: (absolutePath: string) => Promise<Buffer>;\r\n\t/** Check if file is readable (throw if not) */\r\n\taccess: (absolutePath: string) => Promise<void>;\r\n\t/** Detect image MIME type, return null/undefined for non-images */\r\n\tdetectImageMimeType?: (absolutePath: string) => Promise<string | null | undefined>;\r\n}\r\n\r\nconst defaultReadOperations: ReadOperations = {\r\n\treadFile: (path) => fsReadFile(path),\r\n\taccess: (path) => fsAccess(path, constants.R_OK),\r\n\tdetectImageMimeType: detectSupportedImageMimeTypeFromFile,\r\n};\r\n\r\nexport interface ReadToolOptions {\r\n\t/** Whether to auto-resize images to 2000x2000 max. Default: true */\r\n\tautoResizeImages?: boolean;\r\n\t/** Custom operations for file reading. Default: local filesystem */\r\n\toperations?: ReadOperations;\r\n}\r\n\r\nexport function createReadTool(cwd: string, options?: ReadToolOptions): AgentTool<typeof readSchema> {\r\n\tconst autoResizeImages = options?.autoResizeImages ?? true;\r\n\tconst ops = options?.operations ?? defaultReadOperations;\r\n\r\n\treturn {\r\n\t\tname: \"read\",\r\n\t\tlabel: \"read\",\r\n\t\tdescription: `Read the contents of a file. Supports text files and images (jpg, png, gif, webp). Images are sent as attachments. For text files, output is truncated to ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). Use offset/limit for large files. When you need the full file, continue with offset until complete.`,\r\n\t\tparameters: readSchema,\r\n\t\texecute: async (\r\n\t\t\t_toolCallId: string,\r\n\t\t\t{ path, offset, limit }: { path: string; offset?: number; limit?: number },\r\n\t\t\tsignal?: AbortSignal,\r\n\t\t) => {\r\n\t\t\tconst absolutePath = resolveReadPath(path, cwd);\r\n\r\n\t\t\treturn new Promise<{ content: (TextContent | ImageContent)[]; details: ReadToolDetails | undefined }>(\r\n\t\t\t\t(resolve, reject) => {\r\n\t\t\t\t\t// Check if already aborted\r\n\t\t\t\t\tif (signal?.aborted) {\r\n\t\t\t\t\t\treject(new Error(\"Operation aborted\"));\r\n\t\t\t\t\t\treturn;\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\tlet aborted = false;\r\n\r\n\t\t\t\t\t// Set up abort handler\r\n\t\t\t\t\tconst onAbort = () => {\r\n\t\t\t\t\t\taborted = true;\r\n\t\t\t\t\t\treject(new Error(\"Operation aborted\"));\r\n\t\t\t\t\t};\r\n\r\n\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\tsignal.addEventListener(\"abort\", onAbort, { once: true });\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\t// Perform the read operation\r\n\t\t\t\t\t(async () => {\r\n\t\t\t\t\t\ttry {\r\n\t\t\t\t\t\t\t// Check if file exists\r\n\t\t\t\t\t\t\tawait ops.access(absolutePath);\r\n\r\n\t\t\t\t\t\t\t// Check if aborted before reading\r\n\t\t\t\t\t\t\tif (aborted) {\r\n\t\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tconst mimeType = ops.detectImageMimeType ? await ops.detectImageMimeType(absolutePath) : undefined;\r\n\r\n\t\t\t\t\t\t\t// Read the file based on type\r\n\t\t\t\t\t\t\tlet content: (TextContent | ImageContent)[];\r\n\t\t\t\t\t\t\tlet details: ReadToolDetails | undefined;\r\n\r\n\t\t\t\t\t\t\tif (mimeType) {\r\n\t\t\t\t\t\t\t\t// Read as image (binary)\r\n\t\t\t\t\t\t\t\tconst buffer = await ops.readFile(absolutePath);\r\n\t\t\t\t\t\t\t\tconst base64 = buffer.toString(\"base64\");\r\n\r\n\t\t\t\t\t\t\t\tif (autoResizeImages) {\r\n\t\t\t\t\t\t\t\t\t// Resize image if needed\r\n\t\t\t\t\t\t\t\t\tconst resized = await resizeImage({ type: \"image\", data: base64, mimeType });\r\n\t\t\t\t\t\t\t\t\tconst dimensionNote = formatDimensionNote(resized);\r\n\r\n\t\t\t\t\t\t\t\t\tlet textNote = `Read image file [${resized.mimeType}]`;\r\n\t\t\t\t\t\t\t\t\tif (dimensionNote) {\r\n\t\t\t\t\t\t\t\t\t\ttextNote += `\\n${dimensionNote}`;\r\n\t\t\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t\t\tcontent = [\r\n\t\t\t\t\t\t\t\t\t\t{ type: \"text\", text: textNote },\r\n\t\t\t\t\t\t\t\t\t\t{ type: \"image\", data: resized.data, mimeType: resized.mimeType },\r\n\t\t\t\t\t\t\t\t\t];\r\n\t\t\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\t\t\tconst textNote = `Read image file [${mimeType}]`;\r\n\t\t\t\t\t\t\t\t\tcontent = [\r\n\t\t\t\t\t\t\t\t\t\t{ type: \"text\", text: textNote },\r\n\t\t\t\t\t\t\t\t\t\t{ type: \"image\", data: base64, mimeType },\r\n\t\t\t\t\t\t\t\t\t];\r\n\t\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\t\t// Read as text\r\n\t\t\t\t\t\t\t\tconst buffer = await ops.readFile(absolutePath);\r\n\t\t\t\t\t\t\t\tconst textContent = buffer.toString(\"utf-8\");\r\n\t\t\t\t\t\t\t\tconst allLines = textContent.split(\"\\n\");\r\n\t\t\t\t\t\t\t\tconst totalFileLines = allLines.length;\r\n\r\n\t\t\t\t\t\t\t\t// Apply offset if specified (1-indexed to 0-indexed)\r\n\t\t\t\t\t\t\t\tconst startLine = offset ? Math.max(0, offset - 1) : 0;\r\n\t\t\t\t\t\t\t\tconst startLineDisplay = startLine + 1; // For display (1-indexed)\r\n\r\n\t\t\t\t\t\t\t\t// Check if offset is out of bounds\r\n\t\t\t\t\t\t\t\tif (startLine >= allLines.length) {\r\n\t\t\t\t\t\t\t\t\tthrow new Error(`Offset ${offset} is beyond end of file (${allLines.length} lines total)`);\r\n\t\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t\t// If limit is specified by user, use it; otherwise we'll let truncateHead decide\r\n\t\t\t\t\t\t\t\tlet selectedContent: string;\r\n\t\t\t\t\t\t\t\tlet userLimitedLines: number | undefined;\r\n\t\t\t\t\t\t\t\tif (limit !== undefined) {\r\n\t\t\t\t\t\t\t\t\tconst endLine = Math.min(startLine + limit, allLines.length);\r\n\t\t\t\t\t\t\t\t\tselectedContent = allLines.slice(startLine, endLine).join(\"\\n\");\r\n\t\t\t\t\t\t\t\t\tuserLimitedLines = endLine - startLine;\r\n\t\t\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\t\t\tselectedContent = allLines.slice(startLine).join(\"\\n\");\r\n\t\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t\t// Apply truncation (respects both line and byte limits)\r\n\t\t\t\t\t\t\t\tconst truncation = truncateHead(selectedContent);\r\n\r\n\t\t\t\t\t\t\t\tlet outputText: string;\r\n\r\n\t\t\t\t\t\t\t\tif (truncation.firstLineExceedsLimit) {\r\n\t\t\t\t\t\t\t\t\t// First line at offset exceeds 30KB - tell model to use bash\r\n\t\t\t\t\t\t\t\t\tconst firstLineSize = formatSize(Buffer.byteLength(allLines[startLine], \"utf-8\"));\r\n\t\t\t\t\t\t\t\t\toutputText = `[Line ${startLineDisplay} is ${firstLineSize}, exceeds ${formatSize(DEFAULT_MAX_BYTES)} limit. Use bash: sed -n '${startLineDisplay}p' ${path} | head -c ${DEFAULT_MAX_BYTES}]`;\r\n\t\t\t\t\t\t\t\t\tdetails = { truncation };\r\n\t\t\t\t\t\t\t\t} else if (truncation.truncated) {\r\n\t\t\t\t\t\t\t\t\t// Truncation occurred - build actionable notice\r\n\t\t\t\t\t\t\t\t\tconst endLineDisplay = startLineDisplay + truncation.outputLines - 1;\r\n\t\t\t\t\t\t\t\t\tconst nextOffset = endLineDisplay + 1;\r\n\r\n\t\t\t\t\t\t\t\t\toutputText = truncation.content;\r\n\r\n\t\t\t\t\t\t\t\t\tif (truncation.truncatedBy === \"lines\") {\r\n\t\t\t\t\t\t\t\t\t\toutputText += `\\n\\n[Showing lines ${startLineDisplay}-${endLineDisplay} of ${totalFileLines}. Use offset=${nextOffset} to continue.]`;\r\n\t\t\t\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\t\t\t\toutputText += `\\n\\n[Showing lines ${startLineDisplay}-${endLineDisplay} of ${totalFileLines} (${formatSize(DEFAULT_MAX_BYTES)} limit). Use offset=${nextOffset} to continue.]`;\r\n\t\t\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\t\t\tdetails = { truncation };\r\n\t\t\t\t\t\t\t\t} else if (userLimitedLines !== undefined && startLine + userLimitedLines < allLines.length) {\r\n\t\t\t\t\t\t\t\t\t// User specified limit, there's more content, but no truncation\r\n\t\t\t\t\t\t\t\t\tconst remaining = allLines.length - (startLine + userLimitedLines);\r\n\t\t\t\t\t\t\t\t\tconst nextOffset = startLine + userLimitedLines + 1;\r\n\r\n\t\t\t\t\t\t\t\t\toutputText = truncation.content;\r\n\t\t\t\t\t\t\t\t\toutputText += `\\n\\n[${remaining} more lines in file. Use offset=${nextOffset} to continue.]`;\r\n\t\t\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\t\t\t// No truncation, no user limit exceeded\r\n\t\t\t\t\t\t\t\t\toutputText = truncation.content;\r\n\t\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t\tcontent = [{ type: \"text\", text: outputText }];\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t// Check if aborted after reading\r\n\t\t\t\t\t\t\tif (aborted) {\r\n\t\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t// Clean up abort handler\r\n\t\t\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tresolve({ content, details });\r\n\t\t\t\t\t\t} catch (error: any) {\r\n\t\t\t\t\t\t\t// Clean up abort handler\r\n\t\t\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tif (!aborted) {\r\n\t\t\t\t\t\t\t\treject(error);\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t})();\r\n\t\t\t\t},\r\n\t\t\t);\r\n\t\t},\r\n\t};\r\n}\r\n\r\n/** Default read tool using process.cwd() - for backwards compatibility */\r\nexport const readTool = createReadTool(process.cwd());\r\n"]}

package/dist/core/tools/read.js

@@ -0,0 +1,166 @@
+import { Type } from "@sinclair/typebox";
+import { constants } from "fs";
+import { access as fsAccess, readFile as fsReadFile } from "fs/promises";
+import { formatDimensionNote, resizeImage } from "../../utils/image-resize.js";
+import { detectSupportedImageMimeTypeFromFile } from "../../utils/mime.js";
+import { resolveReadPath } from "./path-utils.js";
+import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, truncateHead } from "./truncate.js";
+const readSchema = Type.Object({
+    path: Type.String({ description: "Path to the file to read (relative or absolute)" }),
+    offset: Type.Optional(Type.Number({ description: "Line number to start reading from (1-indexed)" })),
+    limit: Type.Optional(Type.Number({ description: "Maximum number of lines to read" })),
+});
+const defaultReadOperations = {
+    readFile: (path) => fsReadFile(path),
+    access: (path) => fsAccess(path, constants.R_OK),
+    detectImageMimeType: detectSupportedImageMimeTypeFromFile,
+};
+export function createReadTool(cwd, options) {
+    const autoResizeImages = options?.autoResizeImages ?? true;
+    const ops = options?.operations ?? defaultReadOperations;
+    return {
+        name: "read",
+        label: "read",
+        description: `Read the contents of a file. Supports text files and images (jpg, png, gif, webp). Images are sent as attachments. For text files, output is truncated to ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). Use offset/limit for large files. When you need the full file, continue with offset until complete.`,
+        parameters: readSchema,
+        execute: async (_toolCallId, { path, offset, limit }, signal) => {
+            const absolutePath = resolveReadPath(path, cwd);
+            return new Promise((resolve, reject) => {
+                // Check if already aborted
+                if (signal?.aborted) {
+                    reject(new Error("Operation aborted"));
+                    return;
+                }
+                let aborted = false;
+                // Set up abort handler
+                const onAbort = () => {
+                    aborted = true;
+                    reject(new Error("Operation aborted"));
+                };
+                if (signal) {
+                    signal.addEventListener("abort", onAbort, { once: true });
+                }
+                // Perform the read operation
+                (async () => {
+                    try {
+                        // Check if file exists
+                        await ops.access(absolutePath);
+                        // Check if aborted before reading
+                        if (aborted) {
+                            return;
+                        }
+                        const mimeType = ops.detectImageMimeType ? await ops.detectImageMimeType(absolutePath) : undefined;
+                        // Read the file based on type
+                        let content;
+                        let details;
+                        if (mimeType) {
+                            // Read as image (binary)
+                            const buffer = await ops.readFile(absolutePath);
+                            const base64 = buffer.toString("base64");
+                            if (autoResizeImages) {
+                                // Resize image if needed
+                                const resized = await resizeImage({ type: "image", data: base64, mimeType });
+                                const dimensionNote = formatDimensionNote(resized);
+                                let textNote = `Read image file [${resized.mimeType}]`;
+                                if (dimensionNote) {
+                                    textNote += `\n${dimensionNote}`;
+                                }
+                                content = [
+                                    { type: "text", text: textNote },
+                                    { type: "image", data: resized.data, mimeType: resized.mimeType },
+                                ];
+                            }
+                            else {
+                                const textNote = `Read image file [${mimeType}]`;
+                                content = [
+                                    { type: "text", text: textNote },
+                                    { type: "image", data: base64, mimeType },
+                                ];
+                            }
+                        }
+                        else {
+                            // Read as text
+                            const buffer = await ops.readFile(absolutePath);
+                            const textContent = buffer.toString("utf-8");
+                            const allLines = textContent.split("\n");
+                            const totalFileLines = allLines.length;
+                            // Apply offset if specified (1-indexed to 0-indexed)
+                            const startLine = offset ? Math.max(0, offset - 1) : 0;
+                            const startLineDisplay = startLine + 1; // For display (1-indexed)
+                            // Check if offset is out of bounds
+                            if (startLine >= allLines.length) {
+                                throw new Error(`Offset ${offset} is beyond end of file (${allLines.length} lines total)`);
+                            }
+                            // If limit is specified by user, use it; otherwise we'll let truncateHead decide
+                            let selectedContent;
+                            let userLimitedLines;
+                            if (limit !== undefined) {
+                                const endLine = Math.min(startLine + limit, allLines.length);
+                                selectedContent = allLines.slice(startLine, endLine).join("\n");
+                                userLimitedLines = endLine - startLine;
+                            }
+                            else {
+                                selectedContent = allLines.slice(startLine).join("\n");
+                            }
+                            // Apply truncation (respects both line and byte limits)
+                            const truncation = truncateHead(selectedContent);
+                            let outputText;
+                            if (truncation.firstLineExceedsLimit) {
+                                // First line at offset exceeds 30KB - tell model to use bash
+                                const firstLineSize = formatSize(Buffer.byteLength(allLines[startLine], "utf-8"));
+                                outputText = `[Line ${startLineDisplay} is ${firstLineSize}, exceeds ${formatSize(DEFAULT_MAX_BYTES)} limit. Use bash: sed -n '${startLineDisplay}p' ${path} | head -c ${DEFAULT_MAX_BYTES}]`;
+                                details = { truncation };
+                            }
+                            else if (truncation.truncated) {
+                                // Truncation occurred - build actionable notice
+                                const endLineDisplay = startLineDisplay + truncation.outputLines - 1;
+                                const nextOffset = endLineDisplay + 1;
+                                outputText = truncation.content;
+                                if (truncation.truncatedBy === "lines") {
+                                    outputText += `\n\n[Showing lines ${startLineDisplay}-${endLineDisplay} of ${totalFileLines}. Use offset=${nextOffset} to continue.]`;
+                                }
+                                else {
+                                    outputText += `\n\n[Showing lines ${startLineDisplay}-${endLineDisplay} of ${totalFileLines} (${formatSize(DEFAULT_MAX_BYTES)} limit). Use offset=${nextOffset} to continue.]`;
+                                }
+                                details = { truncation };
+                            }
+                            else if (userLimitedLines !== undefined && startLine + userLimitedLines < allLines.length) {
+                                // User specified limit, there's more content, but no truncation
+                                const remaining = allLines.length - (startLine + userLimitedLines);
+                                const nextOffset = startLine + userLimitedLines + 1;
+                                outputText = truncation.content;
+                                outputText += `\n\n[${remaining} more lines in file. Use offset=${nextOffset} to continue.]`;
+                            }
+                            else {
+                                // No truncation, no user limit exceeded
+                                outputText = truncation.content;
+                            }
+                            content = [{ type: "text", text: outputText }];
+                        }
+                        // Check if aborted after reading
+                        if (aborted) {
+                            return;
+                        }
+                        // Clean up abort handler
+                        if (signal) {
+                            signal.removeEventListener("abort", onAbort);
+                        }
+                        resolve({ content, details });
+                    }
+                    catch (error) {
+                        // Clean up abort handler
+                        if (signal) {
+                            signal.removeEventListener("abort", onAbort);
+                        }
+                        if (!aborted) {
+                            reject(error);
+                        }
+                    }
+                })();
+            });
+        },
+    };
+}
+/** Default read tool using process.cwd() - for backwards compatibility */
+export const readTool = createReadTool(process.cwd());
+//# sourceMappingURL=read.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/core/tools/read.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@mariozechner/pi-agent-core\";\r\nimport type { ImageContent, TextContent } from \"@mariozechner/pi-ai\";\r\nimport { type Static, Type } from \"@sinclair/typebox\";\r\nimport { constants } from \"fs\";\r\nimport { access as fsAccess, readFile as fsReadFile } from \"fs/promises\";\r\nimport { formatDimensionNote, resizeImage } from \"../../utils/image-resize.js\";\r\nimport { detectSupportedImageMimeTypeFromFile } from \"../../utils/mime.js\";\r\nimport { resolveReadPath } from \"./path-utils.js\";\r\nimport { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, type TruncationResult, truncateHead } from \"./truncate.js\";\r\n\r\nconst readSchema = Type.Object({\r\n\tpath: Type.String({ description: \"Path to the file to read (relative or absolute)\" }),\r\n\toffset: Type.Optional(Type.Number({ description: \"Line number to start reading from (1-indexed)\" })),\r\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of lines to read\" })),\r\n});\r\n\r\nexport type ReadToolInput = Static<typeof readSchema>;\r\n\r\nexport interface ReadToolDetails {\r\n\ttruncation?: TruncationResult;\r\n}\r\n\r\n/**\r\n * Pluggable operations for the read tool.\r\n * Override these to delegate file reading to remote systems (e.g., SSH).\r\n */\r\nexport interface ReadOperations {\r\n\t/** Read file contents as a Buffer */\r\n\treadFile: (absolutePath: string) => Promise<Buffer>;\r\n\t/** Check if file is readable (throw if not) */\r\n\taccess: (absolutePath: string) => Promise<void>;\r\n\t/** Detect image MIME type, return null/undefined for non-images */\r\n\tdetectImageMimeType?: (absolutePath: string) => Promise<string | null | undefined>;\r\n}\r\n\r\nconst defaultReadOperations: ReadOperations = {\r\n\treadFile: (path) => fsReadFile(path),\r\n\taccess: (path) => fsAccess(path, constants.R_OK),\r\n\tdetectImageMimeType: detectSupportedImageMimeTypeFromFile,\r\n};\r\n\r\nexport interface ReadToolOptions {\r\n\t/** Whether to auto-resize images to 2000x2000 max. Default: true */\r\n\tautoResizeImages?: boolean;\r\n\t/** Custom operations for file reading. Default: local filesystem */\r\n\toperations?: ReadOperations;\r\n}\r\n\r\nexport function createReadTool(cwd: string, options?: ReadToolOptions): AgentTool<typeof readSchema> {\r\n\tconst autoResizeImages = options?.autoResizeImages ?? true;\r\n\tconst ops = options?.operations ?? defaultReadOperations;\r\n\r\n\treturn {\r\n\t\tname: \"read\",\r\n\t\tlabel: \"read\",\r\n\t\tdescription: `Read the contents of a file. Supports text files and images (jpg, png, gif, webp). Images are sent as attachments. For text files, output is truncated to ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). Use offset/limit for large files. When you need the full file, continue with offset until complete.`,\r\n\t\tparameters: readSchema,\r\n\t\texecute: async (\r\n\t\t\t_toolCallId: string,\r\n\t\t\t{ path, offset, limit }: { path: string; offset?: number; limit?: number },\r\n\t\t\tsignal?: AbortSignal,\r\n\t\t) => {\r\n\t\t\tconst absolutePath = resolveReadPath(path, cwd);\r\n\r\n\t\t\treturn new Promise<{ content: (TextContent | ImageContent)[]; details: ReadToolDetails | undefined }>(\r\n\t\t\t\t(resolve, reject) => {\r\n\t\t\t\t\t// Check if already aborted\r\n\t\t\t\t\tif (signal?.aborted) {\r\n\t\t\t\t\t\treject(new Error(\"Operation aborted\"));\r\n\t\t\t\t\t\treturn;\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\tlet aborted = false;\r\n\r\n\t\t\t\t\t// Set up abort handler\r\n\t\t\t\t\tconst onAbort = () => {\r\n\t\t\t\t\t\taborted = true;\r\n\t\t\t\t\t\treject(new Error(\"Operation aborted\"));\r\n\t\t\t\t\t};\r\n\r\n\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\tsignal.addEventListener(\"abort\", onAbort, { once: true });\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\t// Perform the read operation\r\n\t\t\t\t\t(async () => {\r\n\t\t\t\t\t\ttry {\r\n\t\t\t\t\t\t\t// Check if file exists\r\n\t\t\t\t\t\t\tawait ops.access(absolutePath);\r\n\r\n\t\t\t\t\t\t\t// Check if aborted before reading\r\n\t\t\t\t\t\t\tif (aborted) {\r\n\t\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tconst mimeType = ops.detectImageMimeType ? await ops.detectImageMimeType(absolutePath) : undefined;\r\n\r\n\t\t\t\t\t\t\t// Read the file based on type\r\n\t\t\t\t\t\t\tlet content: (TextContent | ImageContent)[];\r\n\t\t\t\t\t\t\tlet details: ReadToolDetails | undefined;\r\n\r\n\t\t\t\t\t\t\tif (mimeType) {\r\n\t\t\t\t\t\t\t\t// Read as image (binary)\r\n\t\t\t\t\t\t\t\tconst buffer = await ops.readFile(absolutePath);\r\n\t\t\t\t\t\t\t\tconst base64 = buffer.toString(\"base64\");\r\n\r\n\t\t\t\t\t\t\t\tif (autoResizeImages) {\r\n\t\t\t\t\t\t\t\t\t// Resize image if needed\r\n\t\t\t\t\t\t\t\t\tconst resized = await resizeImage({ type: \"image\", data: base64, mimeType });\r\n\t\t\t\t\t\t\t\t\tconst dimensionNote = formatDimensionNote(resized);\r\n\r\n\t\t\t\t\t\t\t\t\tlet textNote = `Read image file [${resized.mimeType}]`;\r\n\t\t\t\t\t\t\t\t\tif (dimensionNote) {\r\n\t\t\t\t\t\t\t\t\t\ttextNote += `\\n${dimensionNote}`;\r\n\t\t\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t\t\tcontent = [\r\n\t\t\t\t\t\t\t\t\t\t{ type: \"text\", text: textNote },\r\n\t\t\t\t\t\t\t\t\t\t{ type: \"image\", data: resized.data, mimeType: resized.mimeType },\r\n\t\t\t\t\t\t\t\t\t];\r\n\t\t\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\t\t\tconst textNote = `Read image file [${mimeType}]`;\r\n\t\t\t\t\t\t\t\t\tcontent = [\r\n\t\t\t\t\t\t\t\t\t\t{ type: \"text\", text: textNote },\r\n\t\t\t\t\t\t\t\t\t\t{ type: \"image\", data: base64, mimeType },\r\n\t\t\t\t\t\t\t\t\t];\r\n\t\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\t\t// Read as text\r\n\t\t\t\t\t\t\t\tconst buffer = await ops.readFile(absolutePath);\r\n\t\t\t\t\t\t\t\tconst textContent = buffer.toString(\"utf-8\");\r\n\t\t\t\t\t\t\t\tconst allLines = textContent.split(\"\\n\");\r\n\t\t\t\t\t\t\t\tconst totalFileLines = allLines.length;\r\n\r\n\t\t\t\t\t\t\t\t// Apply offset if specified (1-indexed to 0-indexed)\r\n\t\t\t\t\t\t\t\tconst startLine = offset ? Math.max(0, offset - 1) : 0;\r\n\t\t\t\t\t\t\t\tconst startLineDisplay = startLine + 1; // For display (1-indexed)\r\n\r\n\t\t\t\t\t\t\t\t// Check if offset is out of bounds\r\n\t\t\t\t\t\t\t\tif (startLine >= allLines.length) {\r\n\t\t\t\t\t\t\t\t\tthrow new Error(`Offset ${offset} is beyond end of file (${allLines.length} lines total)`);\r\n\t\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t\t// If limit is specified by user, use it; otherwise we'll let truncateHead decide\r\n\t\t\t\t\t\t\t\tlet selectedContent: string;\r\n\t\t\t\t\t\t\t\tlet userLimitedLines: number | undefined;\r\n\t\t\t\t\t\t\t\tif (limit !== undefined) {\r\n\t\t\t\t\t\t\t\t\tconst endLine = Math.min(startLine + limit, allLines.length);\r\n\t\t\t\t\t\t\t\t\tselectedContent = allLines.slice(startLine, endLine).join(\"\\n\");\r\n\t\t\t\t\t\t\t\t\tuserLimitedLines = endLine - startLine;\r\n\t\t\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\t\t\tselectedContent = allLines.slice(startLine).join(\"\\n\");\r\n\t\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t\t// Apply truncation (respects both line and byte limits)\r\n\t\t\t\t\t\t\t\tconst truncation = truncateHead(selectedContent);\r\n\r\n\t\t\t\t\t\t\t\tlet outputText: string;\r\n\r\n\t\t\t\t\t\t\t\tif (truncation.firstLineExceedsLimit) {\r\n\t\t\t\t\t\t\t\t\t// First line at offset exceeds 30KB - tell model to use bash\r\n\t\t\t\t\t\t\t\t\tconst firstLineSize = formatSize(Buffer.byteLength(allLines[startLine], \"utf-8\"));\r\n\t\t\t\t\t\t\t\t\toutputText = `[Line ${startLineDisplay} is ${firstLineSize}, exceeds ${formatSize(DEFAULT_MAX_BYTES)} limit. Use bash: sed -n '${startLineDisplay}p' ${path} | head -c ${DEFAULT_MAX_BYTES}]`;\r\n\t\t\t\t\t\t\t\t\tdetails = { truncation };\r\n\t\t\t\t\t\t\t\t} else if (truncation.truncated) {\r\n\t\t\t\t\t\t\t\t\t// Truncation occurred - build actionable notice\r\n\t\t\t\t\t\t\t\t\tconst endLineDisplay = startLineDisplay + truncation.outputLines - 1;\r\n\t\t\t\t\t\t\t\t\tconst nextOffset = endLineDisplay + 1;\r\n\r\n\t\t\t\t\t\t\t\t\toutputText = truncation.content;\r\n\r\n\t\t\t\t\t\t\t\t\tif (truncation.truncatedBy === \"lines\") {\r\n\t\t\t\t\t\t\t\t\t\toutputText += `\\n\\n[Showing lines ${startLineDisplay}-${endLineDisplay} of ${totalFileLines}. Use offset=${nextOffset} to continue.]`;\r\n\t\t\t\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\t\t\t\toutputText += `\\n\\n[Showing lines ${startLineDisplay}-${endLineDisplay} of ${totalFileLines} (${formatSize(DEFAULT_MAX_BYTES)} limit). Use offset=${nextOffset} to continue.]`;\r\n\t\t\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t\t\t\tdetails = { truncation };\r\n\t\t\t\t\t\t\t\t} else if (userLimitedLines !== undefined && startLine + userLimitedLines < allLines.length) {\r\n\t\t\t\t\t\t\t\t\t// User specified limit, there's more content, but no truncation\r\n\t\t\t\t\t\t\t\t\tconst remaining = allLines.length - (startLine + userLimitedLines);\r\n\t\t\t\t\t\t\t\t\tconst nextOffset = startLine + userLimitedLines + 1;\r\n\r\n\t\t\t\t\t\t\t\t\toutputText = truncation.content;\r\n\t\t\t\t\t\t\t\t\toutputText += `\\n\\n[${remaining} more lines in file. Use offset=${nextOffset} to continue.]`;\r\n\t\t\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\t\t\t// No truncation, no user limit exceeded\r\n\t\t\t\t\t\t\t\t\toutputText = truncation.content;\r\n\t\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t\tcontent = [{ type: \"text\", text: outputText }];\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t// Check if aborted after reading\r\n\t\t\t\t\t\t\tif (aborted) {\r\n\t\t\t\t\t\t\t\treturn;\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\t// Clean up abort handler\r\n\t\t\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tresolve({ content, details });\r\n\t\t\t\t\t\t} catch (error: any) {\r\n\t\t\t\t\t\t\t// Clean up abort handler\r\n\t\t\t\t\t\t\tif (signal) {\r\n\t\t\t\t\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t\tif (!aborted) {\r\n\t\t\t\t\t\t\t\treject(error);\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t})();\r\n\t\t\t\t},\r\n\t\t\t);\r\n\t\t},\r\n\t};\r\n}\r\n\r\n/** Default read tool using process.cwd() - for backwards compatibility */\r\nexport const readTool = createReadTool(process.cwd());\r\n"]}

package/dist/core/tools/truncate.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Shared truncation utilities for tool outputs.
+ *
+ * Truncation is based on two independent limits - whichever is hit first wins:
+ * - Line limit (default: 2000 lines)
+ * - Byte limit (default: 50KB)
+ *
+ * Never returns partial lines (except bash tail truncation edge case).
+ */
+export declare const DEFAULT_MAX_LINES = 2000;
+export declare const DEFAULT_MAX_BYTES: number;
+export declare const GREP_MAX_LINE_LENGTH = 500;
+export interface TruncationResult {
+    /** The truncated content */
+    content: string;
+    /** Whether truncation occurred */
+    truncated: boolean;
+    /** Which limit was hit: "lines", "bytes", or null if not truncated */
+    truncatedBy: "lines" | "bytes" | null;
+    /** Total number of lines in the original content */
+    totalLines: number;
+    /** Total number of bytes in the original content */
+    totalBytes: number;
+    /** Number of complete lines in the truncated output */
+    outputLines: number;
+    /** Number of bytes in the truncated output */
+    outputBytes: number;
+    /** Whether the last line was partially truncated (only for tail truncation edge case) */
+    lastLinePartial: boolean;
+    /** Whether the first line exceeded the byte limit (for head truncation) */
+    firstLineExceedsLimit: boolean;
+    /** The max lines limit that was applied */
+    maxLines: number;
+    /** The max bytes limit that was applied */
+    maxBytes: number;
+}
+export interface TruncationOptions {
+    /** Maximum number of lines (default: 2000) */
+    maxLines?: number;
+    /** Maximum number of bytes (default: 50KB) */
+    maxBytes?: number;
+}
+/**
+ * Format bytes as human-readable size.
+ */
+export declare function formatSize(bytes: number): string;
+/**
+ * Truncate content from the head (keep first N lines/bytes).
+ * Suitable for file reads where you want to see the beginning.
+ *
+ * Never returns partial lines. If first line exceeds byte limit,
+ * returns empty content with firstLineExceedsLimit=true.
+ */
+export declare function truncateHead(content: string, options?: TruncationOptions): TruncationResult;
+/**
+ * Truncate content from the tail (keep last N lines/bytes).
+ * Suitable for bash output where you want to see the end (errors, final results).
+ *
+ * May return partial first line if the last line of original content exceeds byte limit.
+ */
+export declare function truncateTail(content: string, options?: TruncationOptions): TruncationResult;
+/**
+ * Truncate a single line to max characters, adding [truncated] suffix.
+ * Used for grep match lines.
+ */
+export declare function truncateLine(line: string, maxChars?: number): {
+    text: string;
+    wasTruncated: boolean;
+};
+//# sourceMappingURL=truncate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../../src/core/tools/truncate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,iBAAiB,QAAY,CAAC;AAC3C,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,MAAM,WAAW,gBAAgB;IAChC,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,WAAW,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;IACtC,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,yFAAyF;IACzF,eAAe,EAAE,OAAO,CAAC;IACzB,2EAA2E;IAC3E,qBAAqB,EAAE,OAAO,CAAC;IAC/B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IACjC,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CAkF/F;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CAyE/F;AAuBD;;;GAGG;AACH,wBAAgB,YAAY,CAC3B,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAA6B,GACrC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAKzC","sourcesContent":["/**\r\n * Shared truncation utilities for tool outputs.\r\n *\r\n * Truncation is based on two independent limits - whichever is hit first wins:\r\n * - Line limit (default: 2000 lines)\r\n * - Byte limit (default: 50KB)\r\n *\r\n * Never returns partial lines (except bash tail truncation edge case).\r\n */\r\n\r\nexport const DEFAULT_MAX_LINES = 2000;\r\nexport const DEFAULT_MAX_BYTES = 50 * 1024; // 50KB\r\nexport const GREP_MAX_LINE_LENGTH = 500; // Max chars per grep match line\r\n\r\nexport interface TruncationResult {\r\n\t/** The truncated content */\r\n\tcontent: string;\r\n\t/** Whether truncation occurred */\r\n\ttruncated: boolean;\r\n\t/** Which limit was hit: \"lines\", \"bytes\", or null if not truncated */\r\n\ttruncatedBy: \"lines\" | \"bytes\" | null;\r\n\t/** Total number of lines in the original content */\r\n\ttotalLines: number;\r\n\t/** Total number of bytes in the original content */\r\n\ttotalBytes: number;\r\n\t/** Number of complete lines in the truncated output */\r\n\toutputLines: number;\r\n\t/** Number of bytes in the truncated output */\r\n\toutputBytes: number;\r\n\t/** Whether the last line was partially truncated (only for tail truncation edge case) */\r\n\tlastLinePartial: boolean;\r\n\t/** Whether the first line exceeded the byte limit (for head truncation) */\r\n\tfirstLineExceedsLimit: boolean;\r\n\t/** The max lines limit that was applied */\r\n\tmaxLines: number;\r\n\t/** The max bytes limit that was applied */\r\n\tmaxBytes: number;\r\n}\r\n\r\nexport interface TruncationOptions {\r\n\t/** Maximum number of lines (default: 2000) */\r\n\tmaxLines?: number;\r\n\t/** Maximum number of bytes (default: 50KB) */\r\n\tmaxBytes?: number;\r\n}\r\n\r\n/**\r\n * Format bytes as human-readable size.\r\n */\r\nexport function formatSize(bytes: number): string {\r\n\tif (bytes < 1024) {\r\n\t\treturn `${bytes}B`;\r\n\t} else if (bytes < 1024 * 1024) {\r\n\t\treturn `${(bytes / 1024).toFixed(1)}KB`;\r\n\t} else {\r\n\t\treturn `${(bytes / (1024 * 1024)).toFixed(1)}MB`;\r\n\t}\r\n}\r\n\r\n/**\r\n * Truncate content from the head (keep first N lines/bytes).\r\n * Suitable for file reads where you want to see the beginning.\r\n *\r\n * Never returns partial lines. If first line exceeds byte limit,\r\n * returns empty content with firstLineExceedsLimit=true.\r\n */\r\nexport function truncateHead(content: string, options: TruncationOptions = {}): TruncationResult {\r\n\tconst maxLines = options.maxLines ?? DEFAULT_MAX_LINES;\r\n\tconst maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;\r\n\r\n\tconst totalBytes = Buffer.byteLength(content, \"utf-8\");\r\n\tconst lines = content.split(\"\\n\");\r\n\tconst totalLines = lines.length;\r\n\r\n\t// Check if no truncation needed\r\n\tif (totalLines <= maxLines && totalBytes <= maxBytes) {\r\n\t\treturn {\r\n\t\t\tcontent,\r\n\t\t\ttruncated: false,\r\n\t\t\ttruncatedBy: null,\r\n\t\t\ttotalLines,\r\n\t\t\ttotalBytes,\r\n\t\t\toutputLines: totalLines,\r\n\t\t\toutputBytes: totalBytes,\r\n\t\t\tlastLinePartial: false,\r\n\t\t\tfirstLineExceedsLimit: false,\r\n\t\t\tmaxLines,\r\n\t\t\tmaxBytes,\r\n\t\t};\r\n\t}\r\n\r\n\t// Check if first line alone exceeds byte limit\r\n\tconst firstLineBytes = Buffer.byteLength(lines[0], \"utf-8\");\r\n\tif (firstLineBytes > maxBytes) {\r\n\t\treturn {\r\n\t\t\tcontent: \"\",\r\n\t\t\ttruncated: true,\r\n\t\t\ttruncatedBy: \"bytes\",\r\n\t\t\ttotalLines,\r\n\t\t\ttotalBytes,\r\n\t\t\toutputLines: 0,\r\n\t\t\toutputBytes: 0,\r\n\t\t\tlastLinePartial: false,\r\n\t\t\tfirstLineExceedsLimit: true,\r\n\t\t\tmaxLines,\r\n\t\t\tmaxBytes,\r\n\t\t};\r\n\t}\r\n\r\n\t// Collect complete lines that fit\r\n\tconst outputLinesArr: string[] = [];\r\n\tlet outputBytesCount = 0;\r\n\tlet truncatedBy: \"lines\" | \"bytes\" = \"lines\";\r\n\r\n\tfor (let i = 0; i < lines.length && i < maxLines; i++) {\r\n\t\tconst line = lines[i];\r\n\t\tconst lineBytes = Buffer.byteLength(line, \"utf-8\") + (i > 0 ? 1 : 0); // +1 for newline\r\n\r\n\t\tif (outputBytesCount + lineBytes > maxBytes) {\r\n\t\t\ttruncatedBy = \"bytes\";\r\n\t\t\tbreak;\r\n\t\t}\r\n\r\n\t\toutputLinesArr.push(line);\r\n\t\toutputBytesCount += lineBytes;\r\n\t}\r\n\r\n\t// If we exited due to line limit\r\n\tif (outputLinesArr.length >= maxLines && outputBytesCount <= maxBytes) {\r\n\t\ttruncatedBy = \"lines\";\r\n\t}\r\n\r\n\tconst outputContent = outputLinesArr.join(\"\\n\");\r\n\tconst finalOutputBytes = Buffer.byteLength(outputContent, \"utf-8\");\r\n\r\n\treturn {\r\n\t\tcontent: outputContent,\r\n\t\ttruncated: true,\r\n\t\ttruncatedBy,\r\n\t\ttotalLines,\r\n\t\ttotalBytes,\r\n\t\toutputLines: outputLinesArr.length,\r\n\t\toutputBytes: finalOutputBytes,\r\n\t\tlastLinePartial: false,\r\n\t\tfirstLineExceedsLimit: false,\r\n\t\tmaxLines,\r\n\t\tmaxBytes,\r\n\t};\r\n}\r\n\r\n/**\r\n * Truncate content from the tail (keep last N lines/bytes).\r\n * Suitable for bash output where you want to see the end (errors, final results).\r\n *\r\n * May return partial first line if the last line of original content exceeds byte limit.\r\n */\r\nexport function truncateTail(content: string, options: TruncationOptions = {}): TruncationResult {\r\n\tconst maxLines = options.maxLines ?? DEFAULT_MAX_LINES;\r\n\tconst maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;\r\n\r\n\tconst totalBytes = Buffer.byteLength(content, \"utf-8\");\r\n\tconst lines = content.split(\"\\n\");\r\n\tconst totalLines = lines.length;\r\n\r\n\t// Check if no truncation needed\r\n\tif (totalLines <= maxLines && totalBytes <= maxBytes) {\r\n\t\treturn {\r\n\t\t\tcontent,\r\n\t\t\ttruncated: false,\r\n\t\t\ttruncatedBy: null,\r\n\t\t\ttotalLines,\r\n\t\t\ttotalBytes,\r\n\t\t\toutputLines: totalLines,\r\n\t\t\toutputBytes: totalBytes,\r\n\t\t\tlastLinePartial: false,\r\n\t\t\tfirstLineExceedsLimit: false,\r\n\t\t\tmaxLines,\r\n\t\t\tmaxBytes,\r\n\t\t};\r\n\t}\r\n\r\n\t// Work backwards from the end\r\n\tconst outputLinesArr: string[] = [];\r\n\tlet outputBytesCount = 0;\r\n\tlet truncatedBy: \"lines\" | \"bytes\" = \"lines\";\r\n\tlet lastLinePartial = false;\r\n\r\n\tfor (let i = lines.length - 1; i >= 0 && outputLinesArr.length < maxLines; i--) {\r\n\t\tconst line = lines[i];\r\n\t\tconst lineBytes = Buffer.byteLength(line, \"utf-8\") + (outputLinesArr.length > 0 ? 1 : 0); // +1 for newline\r\n\r\n\t\tif (outputBytesCount + lineBytes > maxBytes) {\r\n\t\t\ttruncatedBy = \"bytes\";\r\n\t\t\t// Edge case: if we haven't added ANY lines yet and this line exceeds maxBytes,\r\n\t\t\t// take the end of the line (partial)\r\n\t\t\tif (outputLinesArr.length === 0) {\r\n\t\t\t\tconst truncatedLine = truncateStringToBytesFromEnd(line, maxBytes);\r\n\t\t\t\toutputLinesArr.unshift(truncatedLine);\r\n\t\t\t\toutputBytesCount = Buffer.byteLength(truncatedLine, \"utf-8\");\r\n\t\t\t\tlastLinePartial = true;\r\n\t\t\t}\r\n\t\t\tbreak;\r\n\t\t}\r\n\r\n\t\toutputLinesArr.unshift(line);\r\n\t\toutputBytesCount += lineBytes;\r\n\t}\r\n\r\n\t// If we exited due to line limit\r\n\tif (outputLinesArr.length >= maxLines && outputBytesCount <= maxBytes) {\r\n\t\ttruncatedBy = \"lines\";\r\n\t}\r\n\r\n\tconst outputContent = outputLinesArr.join(\"\\n\");\r\n\tconst finalOutputBytes = Buffer.byteLength(outputContent, \"utf-8\");\r\n\r\n\treturn {\r\n\t\tcontent: outputContent,\r\n\t\ttruncated: true,\r\n\t\ttruncatedBy,\r\n\t\ttotalLines,\r\n\t\ttotalBytes,\r\n\t\toutputLines: outputLinesArr.length,\r\n\t\toutputBytes: finalOutputBytes,\r\n\t\tlastLinePartial,\r\n\t\tfirstLineExceedsLimit: false,\r\n\t\tmaxLines,\r\n\t\tmaxBytes,\r\n\t};\r\n}\r\n\r\n/**\r\n * Truncate a string to fit within a byte limit (from the end).\r\n * Handles multi-byte UTF-8 characters correctly.\r\n */\r\nfunction truncateStringToBytesFromEnd(str: string, maxBytes: number): string {\r\n\tconst buf = Buffer.from(str, \"utf-8\");\r\n\tif (buf.length <= maxBytes) {\r\n\t\treturn str;\r\n\t}\r\n\r\n\t// Start from the end, skip maxBytes back\r\n\tlet start = buf.length - maxBytes;\r\n\r\n\t// Find a valid UTF-8 boundary (start of a character)\r\n\twhile (start < buf.length && (buf[start] & 0xc0) === 0x80) {\r\n\t\tstart++;\r\n\t}\r\n\r\n\treturn buf.slice(start).toString(\"utf-8\");\r\n}\r\n\r\n/**\r\n * Truncate a single line to max characters, adding [truncated] suffix.\r\n * Used for grep match lines.\r\n */\r\nexport function truncateLine(\r\n\tline: string,\r\n\tmaxChars: number = GREP_MAX_LINE_LENGTH,\r\n): { text: string; wasTruncated: boolean } {\r\n\tif (line.length <= maxChars) {\r\n\t\treturn { text: line, wasTruncated: false };\r\n\t}\r\n\treturn { text: `${line.slice(0, maxChars)}... [truncated]`, wasTruncated: true };\r\n}\r\n"]}