@agimon-ai/po-edit 0.0.0-alpha.30 → 0.0.0-alpha.32

package/README.md

@@ -51,6 +51,10 @@ Pass exactly one anchor in each `from` and `to` value, for example `5#abc`. Anch
 `>`, `+`, or `-` display prefix are accepted, as are uppercase anchor letters, whitespace around
 the separator, and the legacy `5:abc` separator. Pasted multiline blocks are rejected.
 
+Files over 8 MiB are refused before decoding or preparing edits, including reads with a small
+`limit`. Use runner log tools for logs. Factories require an injected `FileSystem` or getter;
+execution functions take a `FileSystem` after the abort signal.
+
 ## Attribution
 
 The hashline protocol and FNV anchor approach are adapted from

package/dist/{editTool--RaZ-yPH.mjs → editTool-DVt2xCNP.mjs}

@@ -1,5 +1,4 @@
-import { constants } from "node:fs";
-import { access, readFile, writeFile } from "node:fs/promises";
+import { BACKGROUND_CONTEXT, FileTooLargeError, getOrThrow, readBoundedFile, withAbortSignal } from "@agimon-ai/po-core/platform";
 import { applyHashlineEdits, normalizeFileTag, normalizeToLf, stripBom } from "@agimon-ai/po-hashline";
 import { computeFileTag, decodeUtf8, displayPath, resolveInputPath } from "@agimon-ai/po-hashline/files";
 import { generateDiffString, generateUnifiedPatch, withFileMutationQueue } from "@earendil-works/pi-coding-agent";
@@ -20,11 +19,11 @@ const EditParamsSchema = Type.Object({
 });
 //#endregion
 //#region src/services/editTool/index.ts
-function createHashlineEditTool() {
+function createHashlineEditTool(filesystem) {
 	return {
 		name: "edit",
 		label: "edit",
-		description: "Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range.",
+		description: "Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range. Files over 8 MiB are refused.",
 		promptSnippet: "Edit files with snapshot-bound hashline ranges",
 		promptGuidelines: [
 			"Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.",
@@ -35,32 +34,41 @@ function createHashlineEditTool() {
 		parameters: EditParamsSchema,
 		executionMode: "parallel",
 		async execute(_toolCallId, params, signal, _onUpdate, ctx) {
-			return executeHashlineEdit(params, ctx.cwd, signal);
+			return executeHashlineEdit(params, ctx.cwd, signal, typeof filesystem === "function" ? filesystem() : filesystem);
 		}
 	};
 }
-function createHeadlessEditTool() {
+function createHeadlessEditTool(filesystem) {
 	return {
 		name: "edit",
 		label: "edit",
-		description: "Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range.",
+		description: "Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range. Files over 8 MiB are refused.",
 		promptSnippet: "Edit files with snapshot-bound hashline ranges",
 		promptGuidelines: ["Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.", "Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks."],
 		parameters: EditParamsSchema,
 		executionMode: "parallel",
-		execute: (_toolCallId, params, signal, _onUpdate, context) => executeHashlineEdit(params, context.cwd, signal)
+		execute: (_toolCallId, params, signal, _onUpdate, context) => executeHashlineEdit(params, context.cwd, signal, typeof filesystem === "function" ? filesystem() : filesystem)
 	};
 }
 function assertNotAborted(signal) {
 	if (signal?.aborted) throw new Error("Operation aborted");
 }
-async function executeHashlineEdit(params, cwd, signal) {
+async function executeHashlineEdit(params, cwd, signal, filesystem) {
 	const absolutePath = resolveInputPath(params.path, cwd);
+	const context = signal ? withAbortSignal(signal, BACKGROUND_CONTEXT) : BACKGROUND_CONTEXT;
+	const readSnapshot = async () => {
+		try {
+			return Buffer.from(await readBoundedFile(filesystem, absolutePath, 8388608, context));
+		} catch (error) {
+			if (error instanceof FileTooLargeError) throw new Error("File is over 8 MiB, hashline edit refuses; use runner log tools for logs.", { cause: error });
+			throw error;
+		}
+	};
 	const expectedHash = normalizeFileTag(params.hash);
 	return withFileMutationQueue(absolutePath, async () => {
 		assertNotAborted(signal);
-		await access(absolutePath, constants.R_OK | constants.W_OK);
-		const beforeBytes = await readFile(absolutePath);
+		getOrThrow(await filesystem.fileInfo(absolutePath, context));
+		const beforeBytes = await readSnapshot();
 		assertNotAborted(signal);
 		const actualHash = computeFileTag(beforeBytes);
 		if (actualHash !== expectedHash) throw new Error(`Stale file hash ${expectedHash}. Current hash is ${actualHash}. Re-read the file and retry.`);
@@ -83,11 +91,11 @@ async function executeHashlineEdit(params, cwd, signal) {
 			firstChangedLine: diff.firstChangedLine
 		};
 		assertNotAborted(signal);
-		if (!(await readFile(absolutePath)).equals(beforeBytes)) throw new Error("The file changed while the edit was being prepared. Re-read it and retry.");
+		if (!(await readSnapshot()).equals(beforeBytes)) throw new Error("The file changed while the edit was being prepared. Re-read it and retry.");
 		assertNotAborted(signal);
 		if (applied.content !== before) {
 			const output = Buffer.from(`${hasBom ? "" : ""}${editedText}`, "utf8");
-			await writeFile(absolutePath, output);
+			getOrThrow(await filesystem.writeFile(absolutePath, output, BACKGROUND_CONTEXT));
 		}
 		const count = applied.edits.length;
 		const noun = count === 1 ? "range" : "ranges";
@@ -154,4 +162,4 @@ function replacementLines(content) {
 //#endregion
 export { HashlineRangeSchema as a, EditParamsSchema as i, createHeadlessEditTool as n, executeHashlineEdit as r, createHashlineEditTool as t };
 
-//# sourceMappingURL=editTool--RaZ-yPH.mjs.map
+//# sourceMappingURL=editTool-DVt2xCNP.mjs.map

package/dist/editTool-DVt2xCNP.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"editTool-DVt2xCNP.mjs","names":[],"sources":["../src/schemas/editTool.ts","../src/services/editTool/index.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const HashlineRangeSchema = Type.Object({\n  from: Type.String({ description: 'One inclusive starting anchor, for example 5#abc. Do not paste multiple lines.' }),\n  to: Type.String({ description: 'One inclusive ending anchor, for example 8#def. Do not paste multiple lines.' }),\n  content: Type.Optional(\n    Type.Union([\n      Type.String({ description: 'Replacement content. Empty content deletes the selected lines.' }),\n      Type.Null({ description: 'Delete the selected lines.' }),\n    ]),\n  ),\n});\n\nexport const EditParamsSchema = Type.Object({\n  path: Type.String({ description: 'Path to the file returned by a compatible hashline read or grep tool.' }),\n  hash: Type.String({ description: 'Eight-character exact-byte file tag returned by read or grep.' }),\n  edits: Type.Array(HashlineRangeSchema, {\n    minItems: 1,\n    description: 'Non-overlapping inclusive ranges from the same original snapshot.',\n  }),\n});\n\nexport type HashlineRange = Static<typeof HashlineRangeSchema>;\nexport type EditParams = Static<typeof EditParamsSchema>;\n","import type { PoHeadlessExecutionContext, PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport {\n  BACKGROUND_CONTEXT,\n  FileTooLargeError,\n  getOrThrow,\n  readBoundedFile,\n  withAbortSignal,\n  type FileSystem,\n} from '@agimon-ai/po-core/platform';\nimport {\n  applyHashlineEdits,\n  normalizeFileTag,\n  normalizeToLf,\n  stripBom,\n  type PreparedHashlineEdit,\n} from '@agimon-ai/po-hashline';\nimport { computeFileTag, decodeUtf8, displayPath, resolveInputPath } from '@agimon-ai/po-hashline/files';\nimport {\n  generateDiffString,\n  generateUnifiedPatch,\n  withFileMutationQueue,\n  type EditToolDetails,\n} from '@earendil-works/pi-coding-agent';\nimport type { ToolDefinition } from '@earendil-works/pi-coding-agent';\n\nimport { EditParamsSchema, type EditParams } from '../../schemas/editTool';\n\nexport function createHashlineEditTool(\n  filesystem: FileSystem | (() => FileSystem),\n): ToolDefinition<typeof EditParamsSchema> {\n  return {\n    name: 'edit',\n    label: 'edit',\n    description:\n      'Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range. Files over 8 MiB are refused.',\n    promptSnippet: 'Edit files with snapshot-bound hashline ranges',\n    promptGuidelines: [\n      'Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.',\n      'Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks.',\n      'Put multiple disjoint changes to one file in one edit call. All anchors must describe the original snapshot.',\n      'Omit content or pass an empty string to delete an inclusive range. Merge overlapping ranges before calling edit.',\n    ],\n    parameters: EditParamsSchema,\n    executionMode: 'parallel',\n    async execute(_toolCallId, params, signal, _onUpdate, ctx) {\n      return executeHashlineEdit(\n        params as EditParams,\n        ctx.cwd,\n        signal,\n        typeof filesystem === 'function' ? filesystem() : filesystem,\n      );\n    },\n  };\n}\n\nexport function createHeadlessEditTool(\n  filesystem: FileSystem | (() => FileSystem),\n): PoHeadlessTool<typeof EditParamsSchema> {\n  return {\n    name: 'edit',\n    label: 'edit',\n    description:\n      'Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range. Files over 8 MiB are refused.',\n    promptSnippet: 'Edit files with snapshot-bound hashline ranges',\n    promptGuidelines: [\n      'Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.',\n      'Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks.',\n    ],\n    parameters: EditParamsSchema,\n    executionMode: 'parallel',\n    execute: (\n      _toolCallId: string,\n      params: EditParams,\n      signal: AbortSignal | undefined,\n      _onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => executeHashlineEdit(params, context.cwd, signal, typeof filesystem === 'function' ? filesystem() : filesystem),\n  };\n}\n\nexport function assertNotAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw new Error('Operation aborted');\n}\n\nexport async function executeHashlineEdit(\n  params: EditParams,\n  cwd: string,\n  signal: AbortSignal | undefined,\n  filesystem: FileSystem,\n): Promise<{ content: [{ type: 'text'; text: string }]; details: EditToolDetails }> {\n  const absolutePath = resolveInputPath(params.path, cwd);\n  const context = signal ? withAbortSignal(signal, BACKGROUND_CONTEXT) : BACKGROUND_CONTEXT;\n  const readSnapshot = async (): Promise<Buffer> => {\n    try {\n      return 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 edit refuses; use runner log tools for logs.', { cause: error });\n      }\n      throw error;\n    }\n  };\n  const expectedHash = normalizeFileTag(params.hash);\n  return withFileMutationQueue(absolutePath, async () => {\n    assertNotAborted(signal);\n    getOrThrow(await filesystem.fileInfo(absolutePath, context));\n    const beforeBytes = await readSnapshot();\n    assertNotAborted(signal);\n\n    const actualHash = computeFileTag(beforeBytes);\n    if (actualHash !== expectedHash) {\n      throw new Error(`Stale file hash ${expectedHash}. Current hash is ${actualHash}. Re-read the file and retry.`);\n    }\n\n    const hasBom = beforeBytes.subarray(0, 3).equals(Buffer.from([0xef, 0xbb, 0xbf]));\n    const decoded = decodeUtf8(beforeBytes, params.path);\n    const withoutBom = stripBom(decoded);\n    const before = normalizeToLf(withoutBom);\n    const applied = applyHashlineEdits(before, params.edits);\n    const editedText = restoreOriginalLineEndings(withoutBom, applied.edits);\n    if (normalizeToLf(editedText) !== applied.content) {\n      throw new Error('Could not preserve the file line endings safely. The file was not changed.');\n    }\n    const diff = generateDiffString(before, applied.content);\n    const patch = generateUnifiedPatch(displayPath(absolutePath, cwd), before, applied.content);\n    const details: EditToolDetails = { diff: diff.diff, patch, firstChangedLine: diff.firstChangedLine };\n\n    assertNotAborted(signal);\n    const currentBytes = await readSnapshot();\n    if (!currentBytes.equals(beforeBytes)) {\n      throw new Error('The file changed while the edit was being prepared. Re-read it and retry.');\n    }\n    assertNotAborted(signal);\n\n    if (applied.content !== before) {\n      const output = Buffer.from(`${hasBom ? '\\ufeff' : ''}${editedText}`, 'utf8');\n      getOrThrow(await filesystem.writeFile(absolutePath, output, BACKGROUND_CONTEXT));\n    }\n\n    const count = applied.edits.length;\n    const noun = count === 1 ? 'range' : 'ranges';\n    const message =\n      applied.content === before ? `No changes needed in ${params.path}.` : `Edited ${params.path} (${count} ${noun}).`;\n    return { content: [{ type: 'text', text: `${message} Re-read before editing it again.` }], details };\n  });\n}\n\ninterface LineToken {\n  readonly text: string;\n  readonly ending: '\\r\\n' | '\\n' | '\\r' | '';\n}\n\nfunction restoreOriginalLineEndings(original: string, edits: readonly PreparedHashlineEdit[]): string {\n  const tokens = tokenizeLines(original);\n  const defaultEnding = tokens.find((token) => token.ending !== '')?.ending ?? '\\n';\n  for (const edit of [...edits].reverse()) {\n    const start = edit.from.line - 1;\n    const count = edit.to.line - edit.from.line + 1;\n    const removed = tokens.slice(start, start + count);\n    const inheritedEnding = removed.at(-1)?.ending ?? '';\n    const internalEnding = removed.find((token) => token.ending !== '')?.ending ?? defaultEnding;\n    const lines = replacementLines(edit.content);\n    if (lines.length === 0 && removed.at(-1)?.ending === '' && start > 0) {\n      const previous = tokens[start - 1];\n      if (previous) tokens[start - 1] = { ...previous, ending: '' };\n    }\n    const replacements = lines.map<LineToken>((text, index) => ({\n      text,\n      ending: index === lines.length - 1 ? inheritedEnding : internalEnding,\n    }));\n    tokens.splice(start, count, ...replacements);\n  }\n  return tokens.map((token) => `${token.text}${token.ending}`).join('');\n}\n\nfunction tokenizeLines(content: string): LineToken[] {\n  const tokens: LineToken[] = [];\n  let start = 0;\n  for (let index = 0; index < content.length; index += 1) {\n    const character = content[index];\n    if (character !== '\\r' && character !== '\\n') continue;\n    const ending = character === '\\r' && content[index + 1] === '\\n' ? '\\r\\n' : character;\n    tokens.push({ text: content.slice(start, index), ending });\n    if (ending === '\\r\\n') index += 1;\n    start = index + 1;\n  }\n  tokens.push({ text: content.slice(start), ending: '' });\n  return tokens;\n}\n\nfunction replacementLines(content: string | null): string[] {\n  if (content === null || content === '') return [];\n  const normalized = normalizeToLf(content);\n  const trimmed = normalized.endsWith('\\n') ? normalized.slice(0, -1) : normalized;\n  return trimmed === '' ? [] : trimmed.split('\\n');\n}\n"],"mappings":"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"}

package/dist/{editTool-BKaEjUdm.cjs → editTool-VO-ySAzl.cjs}

@@ -1,5 +1,4 @@
-let node_fs = require("node:fs");
-let node_fs_promises = require("node:fs/promises");
+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");
@@ -20,11 +19,11 @@ const EditParamsSchema = typebox.Type.Object({
 });
 //#endregion
 //#region src/services/editTool/index.ts
-function createHashlineEditTool() {
+function createHashlineEditTool(filesystem) {
 	return {
 		name: "edit",
 		label: "edit",
-		description: "Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range.",
+		description: "Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range. Files over 8 MiB are refused.",
 		promptSnippet: "Edit files with snapshot-bound hashline ranges",
 		promptGuidelines: [
 			"Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.",
@@ -35,32 +34,41 @@ function createHashlineEditTool() {
 		parameters: EditParamsSchema,
 		executionMode: "parallel",
 		async execute(_toolCallId, params, signal, _onUpdate, ctx) {
-			return executeHashlineEdit(params, ctx.cwd, signal);
+			return executeHashlineEdit(params, ctx.cwd, signal, typeof filesystem === "function" ? filesystem() : filesystem);
 		}
 	};
 }
-function createHeadlessEditTool() {
+function createHeadlessEditTool(filesystem) {
 	return {
 		name: "edit",
 		label: "edit",
-		description: "Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range.",
+		description: "Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range. Files over 8 MiB are refused.",
 		promptSnippet: "Edit files with snapshot-bound hashline ranges",
 		promptGuidelines: ["Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.", "Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks."],
 		parameters: EditParamsSchema,
 		executionMode: "parallel",
-		execute: (_toolCallId, params, signal, _onUpdate, context) => executeHashlineEdit(params, context.cwd, signal)
+		execute: (_toolCallId, params, signal, _onUpdate, context) => executeHashlineEdit(params, context.cwd, signal, typeof filesystem === "function" ? filesystem() : filesystem)
 	};
 }
 function assertNotAborted(signal) {
 	if (signal?.aborted) throw new Error("Operation aborted");
 }
-async function executeHashlineEdit(params, cwd, signal) {
+async function executeHashlineEdit(params, cwd, signal, filesystem) {
 	const absolutePath = (0, _agimon_ai_po_hashline_files.resolveInputPath)(params.path, cwd);
+	const context = signal ? (0, _agimon_ai_po_core_platform.withAbortSignal)(signal, _agimon_ai_po_core_platform.BACKGROUND_CONTEXT) : _agimon_ai_po_core_platform.BACKGROUND_CONTEXT;
+	const readSnapshot = async () => {
+		try {
+			return Buffer.from(await (0, _agimon_ai_po_core_platform.readBoundedFile)(filesystem, absolutePath, 8388608, context));
+		} catch (error) {
+			if (error instanceof _agimon_ai_po_core_platform.FileTooLargeError) throw new Error("File is over 8 MiB, hashline edit refuses; use runner log tools for logs.", { cause: error });
+			throw error;
+		}
+	};
 	const expectedHash = (0, _agimon_ai_po_hashline.normalizeFileTag)(params.hash);
 	return (0, _earendil_works_pi_coding_agent.withFileMutationQueue)(absolutePath, async () => {
 		assertNotAborted(signal);
-		await (0, node_fs_promises.access)(absolutePath, node_fs.constants.R_OK | node_fs.constants.W_OK);
-		const beforeBytes = await (0, node_fs_promises.readFile)(absolutePath);
+		(0, _agimon_ai_po_core_platform.getOrThrow)(await filesystem.fileInfo(absolutePath, context));
+		const beforeBytes = await readSnapshot();
 		assertNotAborted(signal);
 		const actualHash = (0, _agimon_ai_po_hashline_files.computeFileTag)(beforeBytes);
 		if (actualHash !== expectedHash) throw new Error(`Stale file hash ${expectedHash}. Current hash is ${actualHash}. Re-read the file and retry.`);
@@ -83,11 +91,11 @@ async function executeHashlineEdit(params, cwd, signal) {
 			firstChangedLine: diff.firstChangedLine
 		};
 		assertNotAborted(signal);
-		if (!(await (0, node_fs_promises.readFile)(absolutePath)).equals(beforeBytes)) throw new Error("The file changed while the edit was being prepared. Re-read it and retry.");
+		if (!(await readSnapshot()).equals(beforeBytes)) throw new Error("The file changed while the edit was being prepared. Re-read it and retry.");
 		assertNotAborted(signal);
 		if (applied.content !== before) {
 			const output = Buffer.from(`${hasBom ? "" : ""}${editedText}`, "utf8");
-			await (0, node_fs_promises.writeFile)(absolutePath, output);
+			(0, _agimon_ai_po_core_platform.getOrThrow)(await filesystem.writeFile(absolutePath, output, _agimon_ai_po_core_platform.BACKGROUND_CONTEXT));
 		}
 		const count = applied.edits.length;
 		const noun = count === 1 ? "range" : "ranges";
@@ -183,4 +191,4 @@ Object.defineProperty(exports, "executeHashlineEdit", {
 	}
 });
 
-//# sourceMappingURL=editTool-BKaEjUdm.cjs.map
+//# sourceMappingURL=editTool-VO-ySAzl.cjs.map

package/dist/editTool-VO-ySAzl.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"editTool-VO-ySAzl.cjs","names":["Type","resolveInputPath","withAbortSignal","BACKGROUND_CONTEXT","readBoundedFile","FileTooLargeError","normalizeFileTag","withFileMutationQueue","computeFileTag","decodeUtf8","stripBom","normalizeToLf","applyHashlineEdits","generateDiffString","generateUnifiedPatch","displayPath"],"sources":["../src/schemas/editTool.ts","../src/services/editTool/index.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const HashlineRangeSchema = Type.Object({\n  from: Type.String({ description: 'One inclusive starting anchor, for example 5#abc. Do not paste multiple lines.' }),\n  to: Type.String({ description: 'One inclusive ending anchor, for example 8#def. Do not paste multiple lines.' }),\n  content: Type.Optional(\n    Type.Union([\n      Type.String({ description: 'Replacement content. Empty content deletes the selected lines.' }),\n      Type.Null({ description: 'Delete the selected lines.' }),\n    ]),\n  ),\n});\n\nexport const EditParamsSchema = Type.Object({\n  path: Type.String({ description: 'Path to the file returned by a compatible hashline read or grep tool.' }),\n  hash: Type.String({ description: 'Eight-character exact-byte file tag returned by read or grep.' }),\n  edits: Type.Array(HashlineRangeSchema, {\n    minItems: 1,\n    description: 'Non-overlapping inclusive ranges from the same original snapshot.',\n  }),\n});\n\nexport type HashlineRange = Static<typeof HashlineRangeSchema>;\nexport type EditParams = Static<typeof EditParamsSchema>;\n","import type { PoHeadlessExecutionContext, PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport {\n  BACKGROUND_CONTEXT,\n  FileTooLargeError,\n  getOrThrow,\n  readBoundedFile,\n  withAbortSignal,\n  type FileSystem,\n} from '@agimon-ai/po-core/platform';\nimport {\n  applyHashlineEdits,\n  normalizeFileTag,\n  normalizeToLf,\n  stripBom,\n  type PreparedHashlineEdit,\n} from '@agimon-ai/po-hashline';\nimport { computeFileTag, decodeUtf8, displayPath, resolveInputPath } from '@agimon-ai/po-hashline/files';\nimport {\n  generateDiffString,\n  generateUnifiedPatch,\n  withFileMutationQueue,\n  type EditToolDetails,\n} from '@earendil-works/pi-coding-agent';\nimport type { ToolDefinition } from '@earendil-works/pi-coding-agent';\n\nimport { EditParamsSchema, type EditParams } from '../../schemas/editTool';\n\nexport function createHashlineEditTool(\n  filesystem: FileSystem | (() => FileSystem),\n): ToolDefinition<typeof EditParamsSchema> {\n  return {\n    name: 'edit',\n    label: 'edit',\n    description:\n      'Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range. Files over 8 MiB are refused.',\n    promptSnippet: 'Edit files with snapshot-bound hashline ranges',\n    promptGuidelines: [\n      'Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.',\n      'Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks.',\n      'Put multiple disjoint changes to one file in one edit call. All anchors must describe the original snapshot.',\n      'Omit content or pass an empty string to delete an inclusive range. Merge overlapping ranges before calling edit.',\n    ],\n    parameters: EditParamsSchema,\n    executionMode: 'parallel',\n    async execute(_toolCallId, params, signal, _onUpdate, ctx) {\n      return executeHashlineEdit(\n        params as EditParams,\n        ctx.cwd,\n        signal,\n        typeof filesystem === 'function' ? filesystem() : filesystem,\n      );\n    },\n  };\n}\n\nexport function createHeadlessEditTool(\n  filesystem: FileSystem | (() => FileSystem),\n): PoHeadlessTool<typeof EditParamsSchema> {\n  return {\n    name: 'edit',\n    label: 'edit',\n    description:\n      'Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range. Files over 8 MiB are refused.',\n    promptSnippet: 'Edit files with snapshot-bound hashline ranges',\n    promptGuidelines: [\n      'Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.',\n      'Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks.',\n    ],\n    parameters: EditParamsSchema,\n    executionMode: 'parallel',\n    execute: (\n      _toolCallId: string,\n      params: EditParams,\n      signal: AbortSignal | undefined,\n      _onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => executeHashlineEdit(params, context.cwd, signal, typeof filesystem === 'function' ? filesystem() : filesystem),\n  };\n}\n\nexport function assertNotAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw new Error('Operation aborted');\n}\n\nexport async function executeHashlineEdit(\n  params: EditParams,\n  cwd: string,\n  signal: AbortSignal | undefined,\n  filesystem: FileSystem,\n): Promise<{ content: [{ type: 'text'; text: string }]; details: EditToolDetails }> {\n  const absolutePath = resolveInputPath(params.path, cwd);\n  const context = signal ? withAbortSignal(signal, BACKGROUND_CONTEXT) : BACKGROUND_CONTEXT;\n  const readSnapshot = async (): Promise<Buffer> => {\n    try {\n      return 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 edit refuses; use runner log tools for logs.', { cause: error });\n      }\n      throw error;\n    }\n  };\n  const expectedHash = normalizeFileTag(params.hash);\n  return withFileMutationQueue(absolutePath, async () => {\n    assertNotAborted(signal);\n    getOrThrow(await filesystem.fileInfo(absolutePath, context));\n    const beforeBytes = await readSnapshot();\n    assertNotAborted(signal);\n\n    const actualHash = computeFileTag(beforeBytes);\n    if (actualHash !== expectedHash) {\n      throw new Error(`Stale file hash ${expectedHash}. Current hash is ${actualHash}. Re-read the file and retry.`);\n    }\n\n    const hasBom = beforeBytes.subarray(0, 3).equals(Buffer.from([0xef, 0xbb, 0xbf]));\n    const decoded = decodeUtf8(beforeBytes, params.path);\n    const withoutBom = stripBom(decoded);\n    const before = normalizeToLf(withoutBom);\n    const applied = applyHashlineEdits(before, params.edits);\n    const editedText = restoreOriginalLineEndings(withoutBom, applied.edits);\n    if (normalizeToLf(editedText) !== applied.content) {\n      throw new Error('Could not preserve the file line endings safely. The file was not changed.');\n    }\n    const diff = generateDiffString(before, applied.content);\n    const patch = generateUnifiedPatch(displayPath(absolutePath, cwd), before, applied.content);\n    const details: EditToolDetails = { diff: diff.diff, patch, firstChangedLine: diff.firstChangedLine };\n\n    assertNotAborted(signal);\n    const currentBytes = await readSnapshot();\n    if (!currentBytes.equals(beforeBytes)) {\n      throw new Error('The file changed while the edit was being prepared. Re-read it and retry.');\n    }\n    assertNotAborted(signal);\n\n    if (applied.content !== before) {\n      const output = Buffer.from(`${hasBom ? '\\ufeff' : ''}${editedText}`, 'utf8');\n      getOrThrow(await filesystem.writeFile(absolutePath, output, BACKGROUND_CONTEXT));\n    }\n\n    const count = applied.edits.length;\n    const noun = count === 1 ? 'range' : 'ranges';\n    const message =\n      applied.content === before ? `No changes needed in ${params.path}.` : `Edited ${params.path} (${count} ${noun}).`;\n    return { content: [{ type: 'text', text: `${message} Re-read before editing it again.` }], details };\n  });\n}\n\ninterface LineToken {\n  readonly text: string;\n  readonly ending: '\\r\\n' | '\\n' | '\\r' | '';\n}\n\nfunction restoreOriginalLineEndings(original: string, edits: readonly PreparedHashlineEdit[]): string {\n  const tokens = tokenizeLines(original);\n  const defaultEnding = tokens.find((token) => token.ending !== '')?.ending ?? '\\n';\n  for (const edit of [...edits].reverse()) {\n    const start = edit.from.line - 1;\n    const count = edit.to.line - edit.from.line + 1;\n    const removed = tokens.slice(start, start + count);\n    const inheritedEnding = removed.at(-1)?.ending ?? '';\n    const internalEnding = removed.find((token) => token.ending !== '')?.ending ?? defaultEnding;\n    const lines = replacementLines(edit.content);\n    if (lines.length === 0 && removed.at(-1)?.ending === '' && start > 0) {\n      const previous = tokens[start - 1];\n      if (previous) tokens[start - 1] = { ...previous, ending: '' };\n    }\n    const replacements = lines.map<LineToken>((text, index) => ({\n      text,\n      ending: index === lines.length - 1 ? inheritedEnding : internalEnding,\n    }));\n    tokens.splice(start, count, ...replacements);\n  }\n  return tokens.map((token) => `${token.text}${token.ending}`).join('');\n}\n\nfunction tokenizeLines(content: string): LineToken[] {\n  const tokens: LineToken[] = [];\n  let start = 0;\n  for (let index = 0; index < content.length; index += 1) {\n    const character = content[index];\n    if (character !== '\\r' && character !== '\\n') continue;\n    const ending = character === '\\r' && content[index + 1] === '\\n' ? '\\r\\n' : character;\n    tokens.push({ text: content.slice(start, index), ending });\n    if (ending === '\\r\\n') index += 1;\n    start = index + 1;\n  }\n  tokens.push({ text: content.slice(start), ending: '' });\n  return tokens;\n}\n\nfunction replacementLines(content: string | null): string[] {\n  if (content === null || content === '') return [];\n  const normalized = normalizeToLf(content);\n  const trimmed = normalized.endsWith('\\n') ? normalized.slice(0, -1) : normalized;\n  return trimmed === '' ? [] : trimmed.split('\\n');\n}\n"],"mappings":"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"}

package/dist/extensions/mcp.cjs

@@ -3,8 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 let _agimon_ai_po_core_mcpFacet = require("@agimon-ai/po-core/mcpFacet");
-let node_fs = require("node:fs");
-let node_fs_promises = require("node:fs/promises");
+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");
@@ -25,28 +24,37 @@ const EditParamsSchema = typebox.Type.Object({
 });
 //#endregion
 //#region src/services/editTool/index.ts
-function createHeadlessEditTool() {
+function createHeadlessEditTool(filesystem) {
 	return {
 		name: "edit",
 		label: "edit",
-		description: "Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range.",
+		description: "Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range. Files over 8 MiB are refused.",
 		promptSnippet: "Edit files with snapshot-bound hashline ranges",
 		promptGuidelines: ["Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.", "Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks."],
 		parameters: EditParamsSchema,
 		executionMode: "parallel",
-		execute: (_toolCallId, params, signal, _onUpdate, context) => executeHashlineEdit(params, context.cwd, signal)
+		execute: (_toolCallId, params, signal, _onUpdate, context) => executeHashlineEdit(params, context.cwd, signal, typeof filesystem === "function" ? filesystem() : filesystem)
 	};
 }
 function assertNotAborted(signal) {
 	if (signal?.aborted) throw new Error("Operation aborted");
 }
-async function executeHashlineEdit(params, cwd, signal) {
+async function executeHashlineEdit(params, cwd, signal, filesystem) {
 	const absolutePath = (0, _agimon_ai_po_hashline_files.resolveInputPath)(params.path, cwd);
+	const context = signal ? (0, _agimon_ai_po_core_platform.withAbortSignal)(signal, _agimon_ai_po_core_platform.BACKGROUND_CONTEXT) : _agimon_ai_po_core_platform.BACKGROUND_CONTEXT;
+	const readSnapshot = async () => {
+		try {
+			return Buffer.from(await (0, _agimon_ai_po_core_platform.readBoundedFile)(filesystem, absolutePath, 8388608, context));
+		} catch (error) {
+			if (error instanceof _agimon_ai_po_core_platform.FileTooLargeError) throw new Error("File is over 8 MiB, hashline edit refuses; use runner log tools for logs.", { cause: error });
+			throw error;
+		}
+	};
 	const expectedHash = (0, _agimon_ai_po_hashline.normalizeFileTag)(params.hash);
 	return (0, _earendil_works_pi_coding_agent.withFileMutationQueue)(absolutePath, async () => {
 		assertNotAborted(signal);
-		await (0, node_fs_promises.access)(absolutePath, node_fs.constants.R_OK | node_fs.constants.W_OK);
-		const beforeBytes = await (0, node_fs_promises.readFile)(absolutePath);
+		(0, _agimon_ai_po_core_platform.getOrThrow)(await filesystem.fileInfo(absolutePath, context));
+		const beforeBytes = await readSnapshot();
 		assertNotAborted(signal);
 		const actualHash = (0, _agimon_ai_po_hashline_files.computeFileTag)(beforeBytes);
 		if (actualHash !== expectedHash) throw new Error(`Stale file hash ${expectedHash}. Current hash is ${actualHash}. Re-read the file and retry.`);
@@ -69,11 +77,11 @@ async function executeHashlineEdit(params, cwd, signal) {
 			firstChangedLine: diff.firstChangedLine
 		};
 		assertNotAborted(signal);
-		if (!(await (0, node_fs_promises.readFile)(absolutePath)).equals(beforeBytes)) throw new Error("The file changed while the edit was being prepared. Re-read it and retry.");
+		if (!(await readSnapshot()).equals(beforeBytes)) throw new Error("The file changed while the edit was being prepared. Re-read it and retry.");
 		assertNotAborted(signal);
 		if (applied.content !== before) {
 			const output = Buffer.from(`${hasBom ? "" : ""}${editedText}`, "utf8");
-			await (0, node_fs_promises.writeFile)(absolutePath, output);
+			(0, _agimon_ai_po_core_platform.getOrThrow)(await filesystem.writeFile(absolutePath, output, _agimon_ai_po_core_platform.BACKGROUND_CONTEXT));
 		}
 		const count = applied.edits.length;
 		const noun = count === 1 ? "range" : "ranges";
@@ -139,10 +147,14 @@ function replacementLines(content) {
 }
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/tool/edit.mcp.ts
-var edit_mcp_default = (0, _agimon_ai_po_core_mcpFacet.defineMcpTool)(() => ({
-	...createHeadlessEditTool(),
-	description: "Edit or patch an existing file in the Po session's repository on the host machine. Replace or delete line ranges using the file hash and anchors (such as 5#abc) from this server's read or grep tool. Each from and to holds one anchor; empty content deletes the range."
-}));
+var edit_mcp_default = (0, _agimon_ai_po_core_mcpFacet.defineMcpTool)((context) => {
+	const filesystem = context.services.get(_agimon_ai_po_core_platform.PO_FS_SERVICE);
+	if (!filesystem) throw new Error("Edit filesystem service is unavailable.");
+	return {
+		...createHeadlessEditTool(filesystem),
+		description: "Edit or patch an existing file in the Po session's repository on the host machine. Replace or delete line ranges using the file hash and anchors (such as 5#abc) from this server's read or grep tool. Each from and to holds one anchor; empty content deletes the range. Files over 8 MiB are refused."
+	};
+});
 //#endregion
 //#region generated/mcp.ts
 const at = (value, context) => typeof value === "function" ? value(context) : value;

package/dist/extensions/mcp.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.cjs","names":["Type","resolveInputPath","normalizeFileTag","withFileMutationQueue","access","constants","readFile","computeFileTag","decodeUtf8","stripBom","normalizeToLf","applyHashlineEdits","generateDiffString","generateUnifiedPatch","displayPath","writeFile","defineMcpTool","defineMcpPlugin","toolEdit"],"sources":["../../src/schemas/editTool.ts","../../src/services/editTool/index.ts","../../src/extensions/workspaces/sessions/(backend)/tool/edit.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const HashlineRangeSchema = Type.Object({\n  from: Type.String({ description: 'One inclusive starting anchor, for example 5#abc. Do not paste multiple lines.' }),\n  to: Type.String({ description: 'One inclusive ending anchor, for example 8#def. Do not paste multiple lines.' }),\n  content: Type.Optional(\n    Type.Union([\n      Type.String({ description: 'Replacement content. Empty content deletes the selected lines.' }),\n      Type.Null({ description: 'Delete the selected lines.' }),\n    ]),\n  ),\n});\n\nexport const EditParamsSchema = Type.Object({\n  path: Type.String({ description: 'Path to the file returned by a compatible hashline read or grep tool.' }),\n  hash: Type.String({ description: 'Eight-character exact-byte file tag returned by read or grep.' }),\n  edits: Type.Array(HashlineRangeSchema, {\n    minItems: 1,\n    description: 'Non-overlapping inclusive ranges from the same original snapshot.',\n  }),\n});\n\nexport type HashlineRange = Static<typeof HashlineRangeSchema>;\nexport type EditParams = Static<typeof EditParamsSchema>;\n","import { constants } from 'node:fs';\nimport { access, readFile, writeFile } from 'node:fs/promises';\n\nimport type { PoHeadlessExecutionContext, PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport {\n  applyHashlineEdits,\n  normalizeFileTag,\n  normalizeToLf,\n  stripBom,\n  type PreparedHashlineEdit,\n} from '@agimon-ai/po-hashline';\nimport { computeFileTag, decodeUtf8, displayPath, resolveInputPath } from '@agimon-ai/po-hashline/files';\nimport {\n  generateDiffString,\n  generateUnifiedPatch,\n  withFileMutationQueue,\n  type EditToolDetails,\n} from '@earendil-works/pi-coding-agent';\nimport type { ToolDefinition } from '@earendil-works/pi-coding-agent';\n\nimport { EditParamsSchema, type EditParams } from '../../schemas/editTool';\n\nexport function createHashlineEditTool(): ToolDefinition<typeof EditParamsSchema> {\n  return {\n    name: 'edit',\n    label: 'edit',\n    description:\n      'Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range.',\n    promptSnippet: 'Edit files with snapshot-bound hashline ranges',\n    promptGuidelines: [\n      'Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.',\n      'Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks.',\n      'Put multiple disjoint changes to one file in one edit call. All anchors must describe the original snapshot.',\n      'Omit content or pass an empty string to delete an inclusive range. Merge overlapping ranges before calling edit.',\n    ],\n    parameters: EditParamsSchema,\n    executionMode: 'parallel',\n    async execute(_toolCallId, params, signal, _onUpdate, ctx) {\n      return executeHashlineEdit(params as EditParams, ctx.cwd, signal);\n    },\n  };\n}\n\nexport function createHeadlessEditTool(): PoHeadlessTool<typeof EditParamsSchema> {\n  return {\n    name: 'edit',\n    label: 'edit',\n    description:\n      'Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range.',\n    promptSnippet: 'Edit files with snapshot-bound hashline ranges',\n    promptGuidelines: [\n      'Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.',\n      'Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks.',\n    ],\n    parameters: EditParamsSchema,\n    executionMode: 'parallel',\n    execute: (\n      _toolCallId: string,\n      params: EditParams,\n      signal: AbortSignal | undefined,\n      _onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => executeHashlineEdit(params, context.cwd, signal),\n  };\n}\n\nexport function assertNotAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw new Error('Operation aborted');\n}\n\nexport async function executeHashlineEdit(\n  params: EditParams,\n  cwd: string,\n  signal: AbortSignal | undefined,\n): Promise<{ content: [{ type: 'text'; text: string }]; details: EditToolDetails }> {\n  const absolutePath = resolveInputPath(params.path, cwd);\n  const expectedHash = normalizeFileTag(params.hash);\n  return withFileMutationQueue(absolutePath, async () => {\n    assertNotAborted(signal);\n    await access(absolutePath, constants.R_OK | constants.W_OK);\n    const beforeBytes = await readFile(absolutePath);\n    assertNotAborted(signal);\n\n    const actualHash = computeFileTag(beforeBytes);\n    if (actualHash !== expectedHash) {\n      throw new Error(`Stale file hash ${expectedHash}. Current hash is ${actualHash}. Re-read the file and retry.`);\n    }\n\n    const hasBom = beforeBytes.subarray(0, 3).equals(Buffer.from([0xef, 0xbb, 0xbf]));\n    const decoded = decodeUtf8(beforeBytes, params.path);\n    const withoutBom = stripBom(decoded);\n    const before = normalizeToLf(withoutBom);\n    const applied = applyHashlineEdits(before, params.edits);\n    const editedText = restoreOriginalLineEndings(withoutBom, applied.edits);\n    if (normalizeToLf(editedText) !== applied.content) {\n      throw new Error('Could not preserve the file line endings safely. The file was not changed.');\n    }\n    const diff = generateDiffString(before, applied.content);\n    const patch = generateUnifiedPatch(displayPath(absolutePath, cwd), before, applied.content);\n    const details: EditToolDetails = { diff: diff.diff, patch, firstChangedLine: diff.firstChangedLine };\n\n    assertNotAborted(signal);\n    const currentBytes = await readFile(absolutePath);\n    if (!currentBytes.equals(beforeBytes)) {\n      throw new Error('The file changed while the edit was being prepared. Re-read it and retry.');\n    }\n    assertNotAborted(signal);\n\n    if (applied.content !== before) {\n      const output = Buffer.from(`${hasBom ? '\\ufeff' : ''}${editedText}`, 'utf8');\n      await writeFile(absolutePath, output);\n    }\n\n    const count = applied.edits.length;\n    const noun = count === 1 ? 'range' : 'ranges';\n    const message =\n      applied.content === before ? `No changes needed in ${params.path}.` : `Edited ${params.path} (${count} ${noun}).`;\n    return { content: [{ type: 'text', text: `${message} Re-read before editing it again.` }], details };\n  });\n}\n\ninterface LineToken {\n  readonly text: string;\n  readonly ending: '\\r\\n' | '\\n' | '\\r' | '';\n}\n\nfunction restoreOriginalLineEndings(original: string, edits: readonly PreparedHashlineEdit[]): string {\n  const tokens = tokenizeLines(original);\n  const defaultEnding = tokens.find((token) => token.ending !== '')?.ending ?? '\\n';\n  for (const edit of [...edits].reverse()) {\n    const start = edit.from.line - 1;\n    const count = edit.to.line - edit.from.line + 1;\n    const removed = tokens.slice(start, start + count);\n    const inheritedEnding = removed.at(-1)?.ending ?? '';\n    const internalEnding = removed.find((token) => token.ending !== '')?.ending ?? defaultEnding;\n    const lines = replacementLines(edit.content);\n    if (lines.length === 0 && removed.at(-1)?.ending === '' && start > 0) {\n      const previous = tokens[start - 1];\n      if (previous) tokens[start - 1] = { ...previous, ending: '' };\n    }\n    const replacements = lines.map<LineToken>((text, index) => ({\n      text,\n      ending: index === lines.length - 1 ? inheritedEnding : internalEnding,\n    }));\n    tokens.splice(start, count, ...replacements);\n  }\n  return tokens.map((token) => `${token.text}${token.ending}`).join('');\n}\n\nfunction tokenizeLines(content: string): LineToken[] {\n  const tokens: LineToken[] = [];\n  let start = 0;\n  for (let index = 0; index < content.length; index += 1) {\n    const character = content[index];\n    if (character !== '\\r' && character !== '\\n') continue;\n    const ending = character === '\\r' && content[index + 1] === '\\n' ? '\\r\\n' : character;\n    tokens.push({ text: content.slice(start, index), ending });\n    if (ending === '\\r\\n') index += 1;\n    start = index + 1;\n  }\n  tokens.push({ text: content.slice(start), ending: '' });\n  return tokens;\n}\n\nfunction replacementLines(content: string | null): string[] {\n  if (content === null || content === '') return [];\n  const normalized = normalizeToLf(content);\n  const trimmed = normalized.endsWith('\\n') ? normalized.slice(0, -1) : normalized;\n  return trimmed === '' ? [] : trimmed.split('\\n');\n}\n","import { defineMcpTool } from '@agimon-ai/po-core/mcpFacet';\n\nimport { createHeadlessEditTool } from '../../../../../services/editTool';\n\nexport default defineMcpTool(() => ({\n  ...createHeadlessEditTool(),\n  description:\n    \"Edit or patch an existing file in the Po session's repository on the host machine. Replace or delete line ranges using the file hash and anchors (such as 5#abc) from this server's read or grep tool. Each from and to holds one anchor; empty content deletes the range.\",\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 toolEdit from '../src/extensions/workspaces/sessions/(backend)/tool/edit.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-edit',\n  session: (context) => ({\n    get tools(): PoMcpSessionPlugin['tools'] { return [withWidget(\"@agimon-ai/po-edit/edit\", via({ name: 'edit' }, at(toolEdit, context)))]; },\n  }) satisfies PoMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":"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"}
+{"version":3,"file":"mcp.cjs","names":["Type","resolveInputPath","withAbortSignal","BACKGROUND_CONTEXT","readBoundedFile","FileTooLargeError","normalizeFileTag","withFileMutationQueue","computeFileTag","decodeUtf8","stripBom","normalizeToLf","applyHashlineEdits","generateDiffString","generateUnifiedPatch","displayPath","defineMcpTool","PO_FS_SERVICE","defineMcpPlugin","toolEdit"],"sources":["../../src/schemas/editTool.ts","../../src/services/editTool/index.ts","../../src/extensions/workspaces/sessions/(backend)/tool/edit.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const HashlineRangeSchema = Type.Object({\n  from: Type.String({ description: 'One inclusive starting anchor, for example 5#abc. Do not paste multiple lines.' }),\n  to: Type.String({ description: 'One inclusive ending anchor, for example 8#def. Do not paste multiple lines.' }),\n  content: Type.Optional(\n    Type.Union([\n      Type.String({ description: 'Replacement content. Empty content deletes the selected lines.' }),\n      Type.Null({ description: 'Delete the selected lines.' }),\n    ]),\n  ),\n});\n\nexport const EditParamsSchema = Type.Object({\n  path: Type.String({ description: 'Path to the file returned by a compatible hashline read or grep tool.' }),\n  hash: Type.String({ description: 'Eight-character exact-byte file tag returned by read or grep.' }),\n  edits: Type.Array(HashlineRangeSchema, {\n    minItems: 1,\n    description: 'Non-overlapping inclusive ranges from the same original snapshot.',\n  }),\n});\n\nexport type HashlineRange = Static<typeof HashlineRangeSchema>;\nexport type EditParams = Static<typeof EditParamsSchema>;\n","import type { PoHeadlessExecutionContext, PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport {\n  BACKGROUND_CONTEXT,\n  FileTooLargeError,\n  getOrThrow,\n  readBoundedFile,\n  withAbortSignal,\n  type FileSystem,\n} from '@agimon-ai/po-core/platform';\nimport {\n  applyHashlineEdits,\n  normalizeFileTag,\n  normalizeToLf,\n  stripBom,\n  type PreparedHashlineEdit,\n} from '@agimon-ai/po-hashline';\nimport { computeFileTag, decodeUtf8, displayPath, resolveInputPath } from '@agimon-ai/po-hashline/files';\nimport {\n  generateDiffString,\n  generateUnifiedPatch,\n  withFileMutationQueue,\n  type EditToolDetails,\n} from '@earendil-works/pi-coding-agent';\nimport type { ToolDefinition } from '@earendil-works/pi-coding-agent';\n\nimport { EditParamsSchema, type EditParams } from '../../schemas/editTool';\n\nexport function createHashlineEditTool(\n  filesystem: FileSystem | (() => FileSystem),\n): ToolDefinition<typeof EditParamsSchema> {\n  return {\n    name: 'edit',\n    label: 'edit',\n    description:\n      'Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range. Files over 8 MiB are refused.',\n    promptSnippet: 'Edit files with snapshot-bound hashline ranges',\n    promptGuidelines: [\n      'Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.',\n      'Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks.',\n      'Put multiple disjoint changes to one file in one edit call. All anchors must describe the original snapshot.',\n      'Omit content or pass an empty string to delete an inclusive range. Merge overlapping ranges before calling edit.',\n    ],\n    parameters: EditParamsSchema,\n    executionMode: 'parallel',\n    async execute(_toolCallId, params, signal, _onUpdate, ctx) {\n      return executeHashlineEdit(\n        params as EditParams,\n        ctx.cwd,\n        signal,\n        typeof filesystem === 'function' ? filesystem() : filesystem,\n      );\n    },\n  };\n}\n\nexport function createHeadlessEditTool(\n  filesystem: FileSystem | (() => FileSystem),\n): PoHeadlessTool<typeof EditParamsSchema> {\n  return {\n    name: 'edit',\n    label: 'edit',\n    description:\n      'Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range. Files over 8 MiB are refused.',\n    promptSnippet: 'Edit files with snapshot-bound hashline ranges',\n    promptGuidelines: [\n      'Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.',\n      'Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks.',\n    ],\n    parameters: EditParamsSchema,\n    executionMode: 'parallel',\n    execute: (\n      _toolCallId: string,\n      params: EditParams,\n      signal: AbortSignal | undefined,\n      _onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => executeHashlineEdit(params, context.cwd, signal, typeof filesystem === 'function' ? filesystem() : filesystem),\n  };\n}\n\nexport function assertNotAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw new Error('Operation aborted');\n}\n\nexport async function executeHashlineEdit(\n  params: EditParams,\n  cwd: string,\n  signal: AbortSignal | undefined,\n  filesystem: FileSystem,\n): Promise<{ content: [{ type: 'text'; text: string }]; details: EditToolDetails }> {\n  const absolutePath = resolveInputPath(params.path, cwd);\n  const context = signal ? withAbortSignal(signal, BACKGROUND_CONTEXT) : BACKGROUND_CONTEXT;\n  const readSnapshot = async (): Promise<Buffer> => {\n    try {\n      return 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 edit refuses; use runner log tools for logs.', { cause: error });\n      }\n      throw error;\n    }\n  };\n  const expectedHash = normalizeFileTag(params.hash);\n  return withFileMutationQueue(absolutePath, async () => {\n    assertNotAborted(signal);\n    getOrThrow(await filesystem.fileInfo(absolutePath, context));\n    const beforeBytes = await readSnapshot();\n    assertNotAborted(signal);\n\n    const actualHash = computeFileTag(beforeBytes);\n    if (actualHash !== expectedHash) {\n      throw new Error(`Stale file hash ${expectedHash}. Current hash is ${actualHash}. Re-read the file and retry.`);\n    }\n\n    const hasBom = beforeBytes.subarray(0, 3).equals(Buffer.from([0xef, 0xbb, 0xbf]));\n    const decoded = decodeUtf8(beforeBytes, params.path);\n    const withoutBom = stripBom(decoded);\n    const before = normalizeToLf(withoutBom);\n    const applied = applyHashlineEdits(before, params.edits);\n    const editedText = restoreOriginalLineEndings(withoutBom, applied.edits);\n    if (normalizeToLf(editedText) !== applied.content) {\n      throw new Error('Could not preserve the file line endings safely. The file was not changed.');\n    }\n    const diff = generateDiffString(before, applied.content);\n    const patch = generateUnifiedPatch(displayPath(absolutePath, cwd), before, applied.content);\n    const details: EditToolDetails = { diff: diff.diff, patch, firstChangedLine: diff.firstChangedLine };\n\n    assertNotAborted(signal);\n    const currentBytes = await readSnapshot();\n    if (!currentBytes.equals(beforeBytes)) {\n      throw new Error('The file changed while the edit was being prepared. Re-read it and retry.');\n    }\n    assertNotAborted(signal);\n\n    if (applied.content !== before) {\n      const output = Buffer.from(`${hasBom ? '\\ufeff' : ''}${editedText}`, 'utf8');\n      getOrThrow(await filesystem.writeFile(absolutePath, output, BACKGROUND_CONTEXT));\n    }\n\n    const count = applied.edits.length;\n    const noun = count === 1 ? 'range' : 'ranges';\n    const message =\n      applied.content === before ? `No changes needed in ${params.path}.` : `Edited ${params.path} (${count} ${noun}).`;\n    return { content: [{ type: 'text', text: `${message} Re-read before editing it again.` }], details };\n  });\n}\n\ninterface LineToken {\n  readonly text: string;\n  readonly ending: '\\r\\n' | '\\n' | '\\r' | '';\n}\n\nfunction restoreOriginalLineEndings(original: string, edits: readonly PreparedHashlineEdit[]): string {\n  const tokens = tokenizeLines(original);\n  const defaultEnding = tokens.find((token) => token.ending !== '')?.ending ?? '\\n';\n  for (const edit of [...edits].reverse()) {\n    const start = edit.from.line - 1;\n    const count = edit.to.line - edit.from.line + 1;\n    const removed = tokens.slice(start, start + count);\n    const inheritedEnding = removed.at(-1)?.ending ?? '';\n    const internalEnding = removed.find((token) => token.ending !== '')?.ending ?? defaultEnding;\n    const lines = replacementLines(edit.content);\n    if (lines.length === 0 && removed.at(-1)?.ending === '' && start > 0) {\n      const previous = tokens[start - 1];\n      if (previous) tokens[start - 1] = { ...previous, ending: '' };\n    }\n    const replacements = lines.map<LineToken>((text, index) => ({\n      text,\n      ending: index === lines.length - 1 ? inheritedEnding : internalEnding,\n    }));\n    tokens.splice(start, count, ...replacements);\n  }\n  return tokens.map((token) => `${token.text}${token.ending}`).join('');\n}\n\nfunction tokenizeLines(content: string): LineToken[] {\n  const tokens: LineToken[] = [];\n  let start = 0;\n  for (let index = 0; index < content.length; index += 1) {\n    const character = content[index];\n    if (character !== '\\r' && character !== '\\n') continue;\n    const ending = character === '\\r' && content[index + 1] === '\\n' ? '\\r\\n' : character;\n    tokens.push({ text: content.slice(start, index), ending });\n    if (ending === '\\r\\n') index += 1;\n    start = index + 1;\n  }\n  tokens.push({ text: content.slice(start), ending: '' });\n  return tokens;\n}\n\nfunction replacementLines(content: string | null): string[] {\n  if (content === null || content === '') return [];\n  const normalized = normalizeToLf(content);\n  const trimmed = normalized.endsWith('\\n') ? normalized.slice(0, -1) : normalized;\n  return trimmed === '' ? [] : trimmed.split('\\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 { createHeadlessEditTool } from '../../../../../services/editTool';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => {\n  const filesystem = context.services.get<FileSystem>(PO_FS_SERVICE);\n  if (!filesystem) throw new Error('Edit filesystem service is unavailable.');\n  return {\n    ...createHeadlessEditTool(filesystem),\n    description:\n      \"Edit or patch an existing file in the Po session's repository on the host machine. Replace or delete line ranges using the file hash and anchors (such as 5#abc) from this server's read or grep tool. Each from and to holds one anchor; empty content deletes the range. Files over 8 MiB are refused.\",\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 toolEdit from '../src/extensions/workspaces/sessions/(backend)/tool/edit.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-edit',\n  session: (context) => ({\n    get tools(): PoMcpSessionPlugin['tools'] { return [withWidget(\"@agimon-ai/po-edit/edit\", via({ name: 'edit' }, at(toolEdit, context)))]; },\n  }) satisfies PoMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":"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"}

package/dist/extensions/mcp.mjs

@@ -1,6 +1,5 @@
 import { defineMcpPlugin, defineMcpTool } from "@agimon-ai/po-core/mcpFacet";
-import { constants } from "node:fs";
-import { access, readFile, writeFile } from "node:fs/promises";
+import { BACKGROUND_CONTEXT, FileTooLargeError, PO_FS_SERVICE, getOrThrow, readBoundedFile, withAbortSignal } from "@agimon-ai/po-core/platform";
 import { applyHashlineEdits, normalizeFileTag, normalizeToLf, stripBom } from "@agimon-ai/po-hashline";
 import { computeFileTag, decodeUtf8, displayPath, resolveInputPath } from "@agimon-ai/po-hashline/files";
 import { generateDiffString, generateUnifiedPatch, withFileMutationQueue } from "@earendil-works/pi-coding-agent";
@@ -21,28 +20,37 @@ const EditParamsSchema = Type.Object({
 });
 //#endregion
 //#region src/services/editTool/index.ts
-function createHeadlessEditTool() {
+function createHeadlessEditTool(filesystem) {
 	return {
 		name: "edit",
 		label: "edit",
-		description: "Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range.",
+		description: "Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range. Files over 8 MiB are refused.",
 		promptSnippet: "Edit files with snapshot-bound hashline ranges",
 		promptGuidelines: ["Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.", "Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks."],
 		parameters: EditParamsSchema,
 		executionMode: "parallel",
-		execute: (_toolCallId, params, signal, _onUpdate, context) => executeHashlineEdit(params, context.cwd, signal)
+		execute: (_toolCallId, params, signal, _onUpdate, context) => executeHashlineEdit(params, context.cwd, signal, typeof filesystem === "function" ? filesystem() : filesystem)
 	};
 }
 function assertNotAborted(signal) {
 	if (signal?.aborted) throw new Error("Operation aborted");
 }
-async function executeHashlineEdit(params, cwd, signal) {
+async function executeHashlineEdit(params, cwd, signal, filesystem) {
 	const absolutePath = resolveInputPath(params.path, cwd);
+	const context = signal ? withAbortSignal(signal, BACKGROUND_CONTEXT) : BACKGROUND_CONTEXT;
+	const readSnapshot = async () => {
+		try {
+			return Buffer.from(await readBoundedFile(filesystem, absolutePath, 8388608, context));
+		} catch (error) {
+			if (error instanceof FileTooLargeError) throw new Error("File is over 8 MiB, hashline edit refuses; use runner log tools for logs.", { cause: error });
+			throw error;
+		}
+	};
 	const expectedHash = normalizeFileTag(params.hash);
 	return withFileMutationQueue(absolutePath, async () => {
 		assertNotAborted(signal);
-		await access(absolutePath, constants.R_OK | constants.W_OK);
-		const beforeBytes = await readFile(absolutePath);
+		getOrThrow(await filesystem.fileInfo(absolutePath, context));
+		const beforeBytes = await readSnapshot();
 		assertNotAborted(signal);
 		const actualHash = computeFileTag(beforeBytes);
 		if (actualHash !== expectedHash) throw new Error(`Stale file hash ${expectedHash}. Current hash is ${actualHash}. Re-read the file and retry.`);
@@ -65,11 +73,11 @@ async function executeHashlineEdit(params, cwd, signal) {
 			firstChangedLine: diff.firstChangedLine
 		};
 		assertNotAborted(signal);
-		if (!(await readFile(absolutePath)).equals(beforeBytes)) throw new Error("The file changed while the edit was being prepared. Re-read it and retry.");
+		if (!(await readSnapshot()).equals(beforeBytes)) throw new Error("The file changed while the edit was being prepared. Re-read it and retry.");
 		assertNotAborted(signal);
 		if (applied.content !== before) {
 			const output = Buffer.from(`${hasBom ? "" : ""}${editedText}`, "utf8");
-			await writeFile(absolutePath, output);
+			getOrThrow(await filesystem.writeFile(absolutePath, output, BACKGROUND_CONTEXT));
 		}
 		const count = applied.edits.length;
 		const noun = count === 1 ? "range" : "ranges";
@@ -135,10 +143,14 @@ function replacementLines(content) {
 }
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/tool/edit.mcp.ts
-var edit_mcp_default = defineMcpTool(() => ({
-	...createHeadlessEditTool(),
-	description: "Edit or patch an existing file in the Po session's repository on the host machine. Replace or delete line ranges using the file hash and anchors (such as 5#abc) from this server's read or grep tool. Each from and to holds one anchor; empty content deletes the range."
-}));
+var edit_mcp_default = defineMcpTool((context) => {
+	const filesystem = context.services.get(PO_FS_SERVICE);
+	if (!filesystem) throw new Error("Edit filesystem service is unavailable.");
+	return {
+		...createHeadlessEditTool(filesystem),
+		description: "Edit or patch an existing file in the Po session's repository on the host machine. Replace or delete line ranges using the file hash and anchors (such as 5#abc) from this server's read or grep tool. Each from and to holds one anchor; empty content deletes the range. Files over 8 MiB are refused."
+	};
+});
 //#endregion
 //#region generated/mcp.ts
 const at = (value, context) => typeof value === "function" ? value(context) : value;

package/dist/extensions/mcp.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.mjs","names":["toolEdit"],"sources":["../../src/schemas/editTool.ts","../../src/services/editTool/index.ts","../../src/extensions/workspaces/sessions/(backend)/tool/edit.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const HashlineRangeSchema = Type.Object({\n  from: Type.String({ description: 'One inclusive starting anchor, for example 5#abc. Do not paste multiple lines.' }),\n  to: Type.String({ description: 'One inclusive ending anchor, for example 8#def. Do not paste multiple lines.' }),\n  content: Type.Optional(\n    Type.Union([\n      Type.String({ description: 'Replacement content. Empty content deletes the selected lines.' }),\n      Type.Null({ description: 'Delete the selected lines.' }),\n    ]),\n  ),\n});\n\nexport const EditParamsSchema = Type.Object({\n  path: Type.String({ description: 'Path to the file returned by a compatible hashline read or grep tool.' }),\n  hash: Type.String({ description: 'Eight-character exact-byte file tag returned by read or grep.' }),\n  edits: Type.Array(HashlineRangeSchema, {\n    minItems: 1,\n    description: 'Non-overlapping inclusive ranges from the same original snapshot.',\n  }),\n});\n\nexport type HashlineRange = Static<typeof HashlineRangeSchema>;\nexport type EditParams = Static<typeof EditParamsSchema>;\n","import { constants } from 'node:fs';\nimport { access, readFile, writeFile } from 'node:fs/promises';\n\nimport type { PoHeadlessExecutionContext, PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport {\n  applyHashlineEdits,\n  normalizeFileTag,\n  normalizeToLf,\n  stripBom,\n  type PreparedHashlineEdit,\n} from '@agimon-ai/po-hashline';\nimport { computeFileTag, decodeUtf8, displayPath, resolveInputPath } from '@agimon-ai/po-hashline/files';\nimport {\n  generateDiffString,\n  generateUnifiedPatch,\n  withFileMutationQueue,\n  type EditToolDetails,\n} from '@earendil-works/pi-coding-agent';\nimport type { ToolDefinition } from '@earendil-works/pi-coding-agent';\n\nimport { EditParamsSchema, type EditParams } from '../../schemas/editTool';\n\nexport function createHashlineEditTool(): ToolDefinition<typeof EditParamsSchema> {\n  return {\n    name: 'edit',\n    label: 'edit',\n    description:\n      'Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range.',\n    promptSnippet: 'Edit files with snapshot-bound hashline ranges',\n    promptGuidelines: [\n      'Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.',\n      'Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks.',\n      'Put multiple disjoint changes to one file in one edit call. All anchors must describe the original snapshot.',\n      'Omit content or pass an empty string to delete an inclusive range. Merge overlapping ranges before calling edit.',\n    ],\n    parameters: EditParamsSchema,\n    executionMode: 'parallel',\n    async execute(_toolCallId, params, signal, _onUpdate, ctx) {\n      return executeHashlineEdit(params as EditParams, ctx.cwd, signal);\n    },\n  };\n}\n\nexport function createHeadlessEditTool(): PoHeadlessTool<typeof EditParamsSchema> {\n  return {\n    name: 'edit',\n    label: 'edit',\n    description:\n      'Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range.',\n    promptSnippet: 'Edit files with snapshot-bound hashline ranges',\n    promptGuidelines: [\n      'Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.',\n      'Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks.',\n    ],\n    parameters: EditParamsSchema,\n    executionMode: 'parallel',\n    execute: (\n      _toolCallId: string,\n      params: EditParams,\n      signal: AbortSignal | undefined,\n      _onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => executeHashlineEdit(params, context.cwd, signal),\n  };\n}\n\nexport function assertNotAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw new Error('Operation aborted');\n}\n\nexport async function executeHashlineEdit(\n  params: EditParams,\n  cwd: string,\n  signal: AbortSignal | undefined,\n): Promise<{ content: [{ type: 'text'; text: string }]; details: EditToolDetails }> {\n  const absolutePath = resolveInputPath(params.path, cwd);\n  const expectedHash = normalizeFileTag(params.hash);\n  return withFileMutationQueue(absolutePath, async () => {\n    assertNotAborted(signal);\n    await access(absolutePath, constants.R_OK | constants.W_OK);\n    const beforeBytes = await readFile(absolutePath);\n    assertNotAborted(signal);\n\n    const actualHash = computeFileTag(beforeBytes);\n    if (actualHash !== expectedHash) {\n      throw new Error(`Stale file hash ${expectedHash}. Current hash is ${actualHash}. Re-read the file and retry.`);\n    }\n\n    const hasBom = beforeBytes.subarray(0, 3).equals(Buffer.from([0xef, 0xbb, 0xbf]));\n    const decoded = decodeUtf8(beforeBytes, params.path);\n    const withoutBom = stripBom(decoded);\n    const before = normalizeToLf(withoutBom);\n    const applied = applyHashlineEdits(before, params.edits);\n    const editedText = restoreOriginalLineEndings(withoutBom, applied.edits);\n    if (normalizeToLf(editedText) !== applied.content) {\n      throw new Error('Could not preserve the file line endings safely. The file was not changed.');\n    }\n    const diff = generateDiffString(before, applied.content);\n    const patch = generateUnifiedPatch(displayPath(absolutePath, cwd), before, applied.content);\n    const details: EditToolDetails = { diff: diff.diff, patch, firstChangedLine: diff.firstChangedLine };\n\n    assertNotAborted(signal);\n    const currentBytes = await readFile(absolutePath);\n    if (!currentBytes.equals(beforeBytes)) {\n      throw new Error('The file changed while the edit was being prepared. Re-read it and retry.');\n    }\n    assertNotAborted(signal);\n\n    if (applied.content !== before) {\n      const output = Buffer.from(`${hasBom ? '\\ufeff' : ''}${editedText}`, 'utf8');\n      await writeFile(absolutePath, output);\n    }\n\n    const count = applied.edits.length;\n    const noun = count === 1 ? 'range' : 'ranges';\n    const message =\n      applied.content === before ? `No changes needed in ${params.path}.` : `Edited ${params.path} (${count} ${noun}).`;\n    return { content: [{ type: 'text', text: `${message} Re-read before editing it again.` }], details };\n  });\n}\n\ninterface LineToken {\n  readonly text: string;\n  readonly ending: '\\r\\n' | '\\n' | '\\r' | '';\n}\n\nfunction restoreOriginalLineEndings(original: string, edits: readonly PreparedHashlineEdit[]): string {\n  const tokens = tokenizeLines(original);\n  const defaultEnding = tokens.find((token) => token.ending !== '')?.ending ?? '\\n';\n  for (const edit of [...edits].reverse()) {\n    const start = edit.from.line - 1;\n    const count = edit.to.line - edit.from.line + 1;\n    const removed = tokens.slice(start, start + count);\n    const inheritedEnding = removed.at(-1)?.ending ?? '';\n    const internalEnding = removed.find((token) => token.ending !== '')?.ending ?? defaultEnding;\n    const lines = replacementLines(edit.content);\n    if (lines.length === 0 && removed.at(-1)?.ending === '' && start > 0) {\n      const previous = tokens[start - 1];\n      if (previous) tokens[start - 1] = { ...previous, ending: '' };\n    }\n    const replacements = lines.map<LineToken>((text, index) => ({\n      text,\n      ending: index === lines.length - 1 ? inheritedEnding : internalEnding,\n    }));\n    tokens.splice(start, count, ...replacements);\n  }\n  return tokens.map((token) => `${token.text}${token.ending}`).join('');\n}\n\nfunction tokenizeLines(content: string): LineToken[] {\n  const tokens: LineToken[] = [];\n  let start = 0;\n  for (let index = 0; index < content.length; index += 1) {\n    const character = content[index];\n    if (character !== '\\r' && character !== '\\n') continue;\n    const ending = character === '\\r' && content[index + 1] === '\\n' ? '\\r\\n' : character;\n    tokens.push({ text: content.slice(start, index), ending });\n    if (ending === '\\r\\n') index += 1;\n    start = index + 1;\n  }\n  tokens.push({ text: content.slice(start), ending: '' });\n  return tokens;\n}\n\nfunction replacementLines(content: string | null): string[] {\n  if (content === null || content === '') return [];\n  const normalized = normalizeToLf(content);\n  const trimmed = normalized.endsWith('\\n') ? normalized.slice(0, -1) : normalized;\n  return trimmed === '' ? [] : trimmed.split('\\n');\n}\n","import { defineMcpTool } from '@agimon-ai/po-core/mcpFacet';\n\nimport { createHeadlessEditTool } from '../../../../../services/editTool';\n\nexport default defineMcpTool(() => ({\n  ...createHeadlessEditTool(),\n  description:\n    \"Edit or patch an existing file in the Po session's repository on the host machine. Replace or delete line ranges using the file hash and anchors (such as 5#abc) from this server's read or grep tool. Each from and to holds one anchor; empty content deletes the range.\",\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 toolEdit from '../src/extensions/workspaces/sessions/(backend)/tool/edit.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-edit',\n  session: (context) => ({\n    get tools(): PoMcpSessionPlugin['tools'] { return [withWidget(\"@agimon-ai/po-edit/edit\", via({ name: 'edit' }, at(toolEdit, context)))]; },\n  }) satisfies PoMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":"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"}
+{"version":3,"file":"mcp.mjs","names":["toolEdit"],"sources":["../../src/schemas/editTool.ts","../../src/services/editTool/index.ts","../../src/extensions/workspaces/sessions/(backend)/tool/edit.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const HashlineRangeSchema = Type.Object({\n  from: Type.String({ description: 'One inclusive starting anchor, for example 5#abc. Do not paste multiple lines.' }),\n  to: Type.String({ description: 'One inclusive ending anchor, for example 8#def. Do not paste multiple lines.' }),\n  content: Type.Optional(\n    Type.Union([\n      Type.String({ description: 'Replacement content. Empty content deletes the selected lines.' }),\n      Type.Null({ description: 'Delete the selected lines.' }),\n    ]),\n  ),\n});\n\nexport const EditParamsSchema = Type.Object({\n  path: Type.String({ description: 'Path to the file returned by a compatible hashline read or grep tool.' }),\n  hash: Type.String({ description: 'Eight-character exact-byte file tag returned by read or grep.' }),\n  edits: Type.Array(HashlineRangeSchema, {\n    minItems: 1,\n    description: 'Non-overlapping inclusive ranges from the same original snapshot.',\n  }),\n});\n\nexport type HashlineRange = Static<typeof HashlineRangeSchema>;\nexport type EditParams = Static<typeof EditParamsSchema>;\n","import type { PoHeadlessExecutionContext, PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport {\n  BACKGROUND_CONTEXT,\n  FileTooLargeError,\n  getOrThrow,\n  readBoundedFile,\n  withAbortSignal,\n  type FileSystem,\n} from '@agimon-ai/po-core/platform';\nimport {\n  applyHashlineEdits,\n  normalizeFileTag,\n  normalizeToLf,\n  stripBom,\n  type PreparedHashlineEdit,\n} from '@agimon-ai/po-hashline';\nimport { computeFileTag, decodeUtf8, displayPath, resolveInputPath } from '@agimon-ai/po-hashline/files';\nimport {\n  generateDiffString,\n  generateUnifiedPatch,\n  withFileMutationQueue,\n  type EditToolDetails,\n} from '@earendil-works/pi-coding-agent';\nimport type { ToolDefinition } from '@earendil-works/pi-coding-agent';\n\nimport { EditParamsSchema, type EditParams } from '../../schemas/editTool';\n\nexport function createHashlineEditTool(\n  filesystem: FileSystem | (() => FileSystem),\n): ToolDefinition<typeof EditParamsSchema> {\n  return {\n    name: 'edit',\n    label: 'edit',\n    description:\n      'Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range. Files over 8 MiB are refused.',\n    promptSnippet: 'Edit files with snapshot-bound hashline ranges',\n    promptGuidelines: [\n      'Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.',\n      'Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks.',\n      'Put multiple disjoint changes to one file in one edit call. All anchors must describe the original snapshot.',\n      'Omit content or pass an empty string to delete an inclusive range. Merge overlapping ranges before calling edit.',\n    ],\n    parameters: EditParamsSchema,\n    executionMode: 'parallel',\n    async execute(_toolCallId, params, signal, _onUpdate, ctx) {\n      return executeHashlineEdit(\n        params as EditParams,\n        ctx.cwd,\n        signal,\n        typeof filesystem === 'function' ? filesystem() : filesystem,\n      );\n    },\n  };\n}\n\nexport function createHeadlessEditTool(\n  filesystem: FileSystem | (() => FileSystem),\n): PoHeadlessTool<typeof EditParamsSchema> {\n  return {\n    name: 'edit',\n    label: 'edit',\n    description:\n      'Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range. Files over 8 MiB are refused.',\n    promptSnippet: 'Edit files with snapshot-bound hashline ranges',\n    promptGuidelines: [\n      'Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.',\n      'Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks.',\n    ],\n    parameters: EditParamsSchema,\n    executionMode: 'parallel',\n    execute: (\n      _toolCallId: string,\n      params: EditParams,\n      signal: AbortSignal | undefined,\n      _onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => executeHashlineEdit(params, context.cwd, signal, typeof filesystem === 'function' ? filesystem() : filesystem),\n  };\n}\n\nexport function assertNotAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw new Error('Operation aborted');\n}\n\nexport async function executeHashlineEdit(\n  params: EditParams,\n  cwd: string,\n  signal: AbortSignal | undefined,\n  filesystem: FileSystem,\n): Promise<{ content: [{ type: 'text'; text: string }]; details: EditToolDetails }> {\n  const absolutePath = resolveInputPath(params.path, cwd);\n  const context = signal ? withAbortSignal(signal, BACKGROUND_CONTEXT) : BACKGROUND_CONTEXT;\n  const readSnapshot = async (): Promise<Buffer> => {\n    try {\n      return 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 edit refuses; use runner log tools for logs.', { cause: error });\n      }\n      throw error;\n    }\n  };\n  const expectedHash = normalizeFileTag(params.hash);\n  return withFileMutationQueue(absolutePath, async () => {\n    assertNotAborted(signal);\n    getOrThrow(await filesystem.fileInfo(absolutePath, context));\n    const beforeBytes = await readSnapshot();\n    assertNotAborted(signal);\n\n    const actualHash = computeFileTag(beforeBytes);\n    if (actualHash !== expectedHash) {\n      throw new Error(`Stale file hash ${expectedHash}. Current hash is ${actualHash}. Re-read the file and retry.`);\n    }\n\n    const hasBom = beforeBytes.subarray(0, 3).equals(Buffer.from([0xef, 0xbb, 0xbf]));\n    const decoded = decodeUtf8(beforeBytes, params.path);\n    const withoutBom = stripBom(decoded);\n    const before = normalizeToLf(withoutBom);\n    const applied = applyHashlineEdits(before, params.edits);\n    const editedText = restoreOriginalLineEndings(withoutBom, applied.edits);\n    if (normalizeToLf(editedText) !== applied.content) {\n      throw new Error('Could not preserve the file line endings safely. The file was not changed.');\n    }\n    const diff = generateDiffString(before, applied.content);\n    const patch = generateUnifiedPatch(displayPath(absolutePath, cwd), before, applied.content);\n    const details: EditToolDetails = { diff: diff.diff, patch, firstChangedLine: diff.firstChangedLine };\n\n    assertNotAborted(signal);\n    const currentBytes = await readSnapshot();\n    if (!currentBytes.equals(beforeBytes)) {\n      throw new Error('The file changed while the edit was being prepared. Re-read it and retry.');\n    }\n    assertNotAborted(signal);\n\n    if (applied.content !== before) {\n      const output = Buffer.from(`${hasBom ? '\\ufeff' : ''}${editedText}`, 'utf8');\n      getOrThrow(await filesystem.writeFile(absolutePath, output, BACKGROUND_CONTEXT));\n    }\n\n    const count = applied.edits.length;\n    const noun = count === 1 ? 'range' : 'ranges';\n    const message =\n      applied.content === before ? `No changes needed in ${params.path}.` : `Edited ${params.path} (${count} ${noun}).`;\n    return { content: [{ type: 'text', text: `${message} Re-read before editing it again.` }], details };\n  });\n}\n\ninterface LineToken {\n  readonly text: string;\n  readonly ending: '\\r\\n' | '\\n' | '\\r' | '';\n}\n\nfunction restoreOriginalLineEndings(original: string, edits: readonly PreparedHashlineEdit[]): string {\n  const tokens = tokenizeLines(original);\n  const defaultEnding = tokens.find((token) => token.ending !== '')?.ending ?? '\\n';\n  for (const edit of [...edits].reverse()) {\n    const start = edit.from.line - 1;\n    const count = edit.to.line - edit.from.line + 1;\n    const removed = tokens.slice(start, start + count);\n    const inheritedEnding = removed.at(-1)?.ending ?? '';\n    const internalEnding = removed.find((token) => token.ending !== '')?.ending ?? defaultEnding;\n    const lines = replacementLines(edit.content);\n    if (lines.length === 0 && removed.at(-1)?.ending === '' && start > 0) {\n      const previous = tokens[start - 1];\n      if (previous) tokens[start - 1] = { ...previous, ending: '' };\n    }\n    const replacements = lines.map<LineToken>((text, index) => ({\n      text,\n      ending: index === lines.length - 1 ? inheritedEnding : internalEnding,\n    }));\n    tokens.splice(start, count, ...replacements);\n  }\n  return tokens.map((token) => `${token.text}${token.ending}`).join('');\n}\n\nfunction tokenizeLines(content: string): LineToken[] {\n  const tokens: LineToken[] = [];\n  let start = 0;\n  for (let index = 0; index < content.length; index += 1) {\n    const character = content[index];\n    if (character !== '\\r' && character !== '\\n') continue;\n    const ending = character === '\\r' && content[index + 1] === '\\n' ? '\\r\\n' : character;\n    tokens.push({ text: content.slice(start, index), ending });\n    if (ending === '\\r\\n') index += 1;\n    start = index + 1;\n  }\n  tokens.push({ text: content.slice(start), ending: '' });\n  return tokens;\n}\n\nfunction replacementLines(content: string | null): string[] {\n  if (content === null || content === '') return [];\n  const normalized = normalizeToLf(content);\n  const trimmed = normalized.endsWith('\\n') ? normalized.slice(0, -1) : normalized;\n  return trimmed === '' ? [] : trimmed.split('\\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 { createHeadlessEditTool } from '../../../../../services/editTool';\n\nexport default defineMcpTool((context: PoMcpPluginContext) => {\n  const filesystem = context.services.get<FileSystem>(PO_FS_SERVICE);\n  if (!filesystem) throw new Error('Edit filesystem service is unavailable.');\n  return {\n    ...createHeadlessEditTool(filesystem),\n    description:\n      \"Edit or patch an existing file in the Po session's repository on the host machine. Replace or delete line ranges using the file hash and anchors (such as 5#abc) from this server's read or grep tool. Each from and to holds one anchor; empty content deletes the range. Files over 8 MiB are refused.\",\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 toolEdit from '../src/extensions/workspaces/sessions/(backend)/tool/edit.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-edit',\n  session: (context) => ({\n    get tools(): PoMcpSessionPlugin['tools'] { return [withWidget(\"@agimon-ai/po-edit/edit\", via({ name: 'edit' }, at(toolEdit, context)))]; },\n  }) satisfies PoMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":"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"}

package/dist/extensions/server.cjs

@@ -2,10 +2,24 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_editTool = require("../editTool-BKaEjUdm.cjs");
+const require_editTool = require("../editTool-VO-ySAzl.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/edit.server.ts
-var edit_server_default = (0, require("@agimon-ai/po-core/extensionFile").defineServerTool)(require_editTool.createHeadlessEditTool);
+var edit_server_default = (0, require("@agimon-ai/po-core/extensionFile").defineServerTool)(({ context }) => {
+	let filesystem;
+	context.inject([_agimon_ai_po_core_platform.PO_FS_SERVICE], (scoped) => {
+		const bound = (0, _agimon_ai_po_core_platform.requirePoFs)(scoped);
+		filesystem = bound;
+		return () => {
+			if (filesystem === bound) filesystem = void 0;
+		};
+	});
+	return require_editTool.createHeadlessEditTool(() => {
+		if (!filesystem) throw new Error("Edit filesystem service is unavailable.");
+		return filesystem;
+	});
+});
 //#endregion
 //#region generated/server.ts
 const at = (value, context) => typeof value === "function" ? value(context) : value;

package/dist/extensions/server.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.cjs","names":["defineServerTool","createHeadlessEditTool","defineServerPlugin","toolEdit"],"sources":["../../src/extensions/workspaces/sessions/(backend)/tool/edit.server.ts","../../generated/server.ts"],"sourcesContent":["import { defineServerTool } from '@agimon-ai/po-core/extensionFile';\n\nimport { createHeadlessEditTool } from '../../../../../services/editTool';\n\nexport default defineServerTool(createHeadlessEditTool);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\n\nimport toolEdit from '../src/extensions/workspaces/sessions/(backend)/tool/edit.server';\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\nexport const serverPlugin = defineServerPlugin({\n  name: '@agimon-ai/po-edit',\n  session: (context) => ({\n    get tools(): PoServerSessionPlugin['tools'] { return [via({ name: 'edit' }, at(toolEdit, context))]; },\n  }),\n});\n\nexport default serverPlugin;\n"],"mappings":";;;;;;;AAIA,IAAA,uBAAA,6CAAeA,CAAAA,CAAAA,iBAAAA,CAAiBC,iBAAAA,sBAAsB;;;ACEtD,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,MAAa,gBAAA,GAAeC,gCAAAA,mBAAAA,CAAmB;CAC7C,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,QAAwC;EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,OAAO,GAAG,GAAGC,qBAAU,OAAO,CAAC,CAAC;CAAG,EACvG;AACF,CAAC"}
+{"version":3,"file":"server.cjs","names":["defineServerTool","PO_FS_SERVICE","requirePoFs","createHeadlessEditTool","defineServerPlugin","toolEdit"],"sources":["../../src/extensions/workspaces/sessions/(backend)/tool/edit.server.ts","../../generated/server.ts"],"sourcesContent":["import { defineServerTool } from '@agimon-ai/po-core/extensionFile';\nimport { PO_FS_SERVICE, requirePoFs, type FileSystem } from '@agimon-ai/po-core/platform';\nimport type { PoServerPluginContext } from '@agimon-ai/po-core/serverPlugin';\n\nimport { createHeadlessEditTool } from '../../../../../services/editTool';\n\nexport default defineServerTool(({ context }: PoServerPluginContext) => {\n  let filesystem: FileSystem | undefined;\n  context.inject([PO_FS_SERVICE], (scoped) => {\n    const bound = requirePoFs(scoped);\n    filesystem = bound;\n    return () => {\n      if (filesystem === bound) filesystem = undefined;\n    };\n  });\n  return createHeadlessEditTool(() => {\n    if (!filesystem) throw new Error('Edit filesystem service is unavailable.');\n    return filesystem;\n  });\n});\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\n\nimport toolEdit from '../src/extensions/workspaces/sessions/(backend)/tool/edit.server';\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\nexport const serverPlugin = defineServerPlugin({\n  name: '@agimon-ai/po-edit',\n  session: (context) => ({\n    get tools(): PoServerSessionPlugin['tools'] { return [via({ name: 'edit' }, at(toolEdit, context))]; },\n  }),\n});\n\nexport default serverPlugin;\n"],"mappings":";;;;;;;;AAMA,IAAA,uBAAA,6CAAeA,CAAAA,CAAAA,iBAAAA,EAAkB,EAAE,cAAqC;CACtE,IAAI;CACJ,QAAQ,OAAO,CAACC,4BAAAA,aAAa,IAAI,WAAW;EAC1C,MAAM,SAAA,GAAQC,4BAAAA,YAAAA,CAAY,MAAM;EAChC,aAAa;EACb,aAAa;GACX,IAAI,eAAe,OAAO,aAAa,KAAA;EACzC;CACF,CAAC;CACD,OAAOC,iBAAAA,6BAA6B;EAClC,IAAI,CAAC,YAAY,MAAM,IAAI,MAAM,yCAAyC;EAC1E,OAAO;CACT,CAAC;AACH,CAAC;;;ACbD,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,MAAa,gBAAA,GAAeC,gCAAAA,mBAAAA,CAAmB;CAC7C,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,QAAwC;EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,OAAO,GAAG,GAAGC,qBAAU,OAAO,CAAC,CAAC;CAAG,EACvG;AACF,CAAC"}

package/dist/extensions/server.mjs

@@ -1,8 +1,22 @@
-import { n as createHeadlessEditTool } from "../editTool--RaZ-yPH.mjs";
+import { n as createHeadlessEditTool } from "../editTool-DVt2xCNP.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";
 //#region src/extensions/workspaces/sessions/(backend)/tool/edit.server.ts
-var edit_server_default = defineServerTool(createHeadlessEditTool);
+var edit_server_default = defineServerTool(({ context }) => {
+	let filesystem;
+	context.inject([PO_FS_SERVICE], (scoped) => {
+		const bound = requirePoFs(scoped);
+		filesystem = bound;
+		return () => {
+			if (filesystem === bound) filesystem = void 0;
+		};
+	});
+	return createHeadlessEditTool(() => {
+		if (!filesystem) throw new Error("Edit filesystem service is unavailable.");
+		return filesystem;
+	});
+});
 //#endregion
 //#region generated/server.ts
 const at = (value, context) => typeof value === "function" ? value(context) : value;

package/dist/extensions/server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.mjs","names":["toolEdit"],"sources":["../../src/extensions/workspaces/sessions/(backend)/tool/edit.server.ts","../../generated/server.ts"],"sourcesContent":["import { defineServerTool } from '@agimon-ai/po-core/extensionFile';\n\nimport { createHeadlessEditTool } from '../../../../../services/editTool';\n\nexport default defineServerTool(createHeadlessEditTool);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\n\nimport toolEdit from '../src/extensions/workspaces/sessions/(backend)/tool/edit.server';\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\nexport const serverPlugin = defineServerPlugin({\n  name: '@agimon-ai/po-edit',\n  session: (context) => ({\n    get tools(): PoServerSessionPlugin['tools'] { return [via({ name: 'edit' }, at(toolEdit, context))]; },\n  }),\n});\n\nexport default serverPlugin;\n"],"mappings":";;;;AAIA,IAAA,sBAAe,iBAAiB,sBAAsB;;;ACEtD,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,MAAa,eAAe,mBAAmB;CAC7C,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,QAAwC;EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,OAAO,GAAG,GAAGA,qBAAU,OAAO,CAAC,CAAC;CAAG,EACvG;AACF,CAAC"}
+{"version":3,"file":"server.mjs","names":["toolEdit"],"sources":["../../src/extensions/workspaces/sessions/(backend)/tool/edit.server.ts","../../generated/server.ts"],"sourcesContent":["import { defineServerTool } from '@agimon-ai/po-core/extensionFile';\nimport { PO_FS_SERVICE, requirePoFs, type FileSystem } from '@agimon-ai/po-core/platform';\nimport type { PoServerPluginContext } from '@agimon-ai/po-core/serverPlugin';\n\nimport { createHeadlessEditTool } from '../../../../../services/editTool';\n\nexport default defineServerTool(({ context }: PoServerPluginContext) => {\n  let filesystem: FileSystem | undefined;\n  context.inject([PO_FS_SERVICE], (scoped) => {\n    const bound = requirePoFs(scoped);\n    filesystem = bound;\n    return () => {\n      if (filesystem === bound) filesystem = undefined;\n    };\n  });\n  return createHeadlessEditTool(() => {\n    if (!filesystem) throw new Error('Edit filesystem service is unavailable.');\n    return filesystem;\n  });\n});\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\n\nimport toolEdit from '../src/extensions/workspaces/sessions/(backend)/tool/edit.server';\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\nexport const serverPlugin = defineServerPlugin({\n  name: '@agimon-ai/po-edit',\n  session: (context) => ({\n    get tools(): PoServerSessionPlugin['tools'] { return [via({ name: 'edit' }, at(toolEdit, context))]; },\n  }),\n});\n\nexport default serverPlugin;\n"],"mappings":";;;;;AAMA,IAAA,sBAAe,kBAAkB,EAAE,cAAqC;CACtE,IAAI;CACJ,QAAQ,OAAO,CAAC,aAAa,IAAI,WAAW;EAC1C,MAAM,QAAQ,YAAY,MAAM;EAChC,aAAa;EACb,aAAa;GACX,IAAI,eAAe,OAAO,aAAa,KAAA;EACzC;CACF,CAAC;CACD,OAAO,6BAA6B;EAClC,IAAI,CAAC,YAAY,MAAM,IAAI,MAAM,yCAAyC;EAC1E,OAAO;CACT,CAAC;AACH,CAAC;;;ACbD,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,MAAa,eAAe,mBAAmB;CAC7C,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,QAAwC;EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,OAAO,GAAG,GAAGA,qBAAU,OAAO,CAAC,CAAC;CAAG,EACvG;AACF,CAAC"}

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_editTool = require("./editTool-BKaEjUdm.cjs");
+const require_editTool = require("./editTool-VO-ySAzl.cjs");
 exports.EditParamsSchema = require_editTool.EditParamsSchema;
 exports.HashlineRangeSchema = require_editTool.HashlineRangeSchema;
 exports.createHashlineEditTool = require_editTool.createHashlineEditTool;

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+import { FileSystem } from "@agimon-ai/po-core/platform";
 import { EditToolDetails, ToolDefinition } from "@earendil-works/pi-coding-agent";
 import { Static, Type } from "typebox";
 import { PoHeadlessTool } from "@agimon-ai/po-core/headless";
@@ -20,9 +21,9 @@ type HashlineRange = Static<typeof HashlineRangeSchema>;
 type EditParams = Static<typeof EditParamsSchema>;
 //#endregion
 //#region src/services/editTool/index.d.ts
-export declare function createHashlineEditTool(): ToolDefinition<typeof EditParamsSchema>;
-export declare function createHeadlessEditTool(): PoHeadlessTool<typeof EditParamsSchema>;
-export declare function executeHashlineEdit(params: EditParams, cwd: string, signal: AbortSignal | undefined): Promise<{
+export declare function createHashlineEditTool(filesystem: FileSystem | (() => FileSystem)): ToolDefinition<typeof EditParamsSchema>;
+export declare function createHeadlessEditTool(filesystem: FileSystem | (() => FileSystem)): PoHeadlessTool<typeof EditParamsSchema>;
+export declare function executeHashlineEdit(params: EditParams, cwd: string, signal: AbortSignal | undefined, filesystem: FileSystem): Promise<{
   content: [{
     type: 'text';
     text: string;

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/schemas/editTool.ts","../src/services/editTool/index.ts"],"mappings":";;;;qBAEa,qBAAmB,KAAA;;;;;qBAWnB,kBAAgB,KAAA;;;;;;;;;KASjB,gBAAgB,cAAc;KAC9B,aAAa,cAAc;;;wBCDvB,0BAA0B,sBAAsB;wBAqBhD,0BAA0B,sBAAsB;wBA2B1C,oBACpB,QAAQ,YACR,aACA,QAAQ,0BACP;EAAU;IAAY;IAAc;;EAAiB,SAAS"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/schemas/editTool.ts","../src/services/editTool/index.ts"],"mappings":";;;;;qBAEa,qBAAmB,KAAA;;;;;qBAWnB,kBAAgB,KAAA;;;;;;;;;KASjB,gBAAgB,cAAc;KAC9B,aAAa,cAAc;;;wBCIvB,uBACd,YAAY,oBAAoB,cAC/B,sBAAsB;wBA0BT,uBACd,YAAY,oBAAoB,cAC/B,sBAAsB;wBA2BH,oBACpB,QAAQ,YACR,aACA,QAAQ,yBACR,YAAY,aACX;EAAU;IAAY;IAAc;;EAAiB,SAAS"}

package/dist/index.mjs

@@ -1 +1 @@
-export { i as EditParamsSchema, a as HashlineRangeSchema, t as createHashlineEditTool, n as createHeadlessEditTool, r as executeHashlineEdit } from "./editTool--RaZ-yPH.mjs";
+export { i as EditParamsSchema, a as HashlineRangeSchema, t as createHashlineEditTool, n as createHeadlessEditTool, r as executeHashlineEdit } from "./editTool-DVt2xCNP.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/po-edit",
-  "version": "0.0.0-alpha.30",
+  "version": "0.0.0-alpha.32",
   "description": "Snapshot-bound hashline edit tool for Pi and Po.",
   "keywords": [
     "ai",
@@ -59,17 +59,18 @@
     "access": "public"
   },
   "dependencies": {
-    "@agimon-ai/po-core": "0.0.0-alpha.30",
-    "@agimon-ai/po-hashline": "0.0.0-alpha.30",
-    "@agimon-ai/po-ui": "0.0.0-alpha.30",
-    "@agimon-ai/po-web-components": "0.0.0-alpha.30",
+    "@agimon-ai/po-core": "0.0.0-alpha.32",
+    "@agimon-ai/po-hashline": "0.0.0-alpha.32",
+    "@agimon-ai/po-ui": "0.0.0-alpha.32",
+    "@agimon-ai/po-web-components": "0.0.0-alpha.32",
     "@deepseek-ai/cordis": "4.0.5",
     "typebox": "1.3.37"
   },
   "devDependencies": {
-    "@agimon-ai/po-build": "0.0.0-alpha.30",
-    "@agimon-ai/po-native-components": "0.0.0-alpha.30",
+    "@agimon-ai/po-build": "0.0.0-alpha.32",
+    "@agimon-ai/po-native-components": "0.0.0-alpha.32",
     "@earendil-works/pi-coding-agent": "1.3.0",
+    "@earendil-works/pi-durable": "1.3.0",
     "@tanstack/react-store": "0.11.2",
     "@tanstack/store": "0.11.2",
     "@types/node": "26.6.5",
@@ -84,7 +85,7 @@
     "vitest": "5.0.4"
   },
   "peerDependencies": {
-    "@agimon-ai/po-native-components": "0.0.0-alpha.30",
+    "@agimon-ai/po-native-components": "0.0.0-alpha.32",
     "@earendil-works/pi-coding-agent": "1.3.0",
     "react-native": "0.86.3",
     "react-native-unistyles": "^3.5.3"

package/dist/editTool--RaZ-yPH.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"editTool--RaZ-yPH.mjs","names":[],"sources":["../src/schemas/editTool.ts","../src/services/editTool/index.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const HashlineRangeSchema = Type.Object({\n  from: Type.String({ description: 'One inclusive starting anchor, for example 5#abc. Do not paste multiple lines.' }),\n  to: Type.String({ description: 'One inclusive ending anchor, for example 8#def. Do not paste multiple lines.' }),\n  content: Type.Optional(\n    Type.Union([\n      Type.String({ description: 'Replacement content. Empty content deletes the selected lines.' }),\n      Type.Null({ description: 'Delete the selected lines.' }),\n    ]),\n  ),\n});\n\nexport const EditParamsSchema = Type.Object({\n  path: Type.String({ description: 'Path to the file returned by a compatible hashline read or grep tool.' }),\n  hash: Type.String({ description: 'Eight-character exact-byte file tag returned by read or grep.' }),\n  edits: Type.Array(HashlineRangeSchema, {\n    minItems: 1,\n    description: 'Non-overlapping inclusive ranges from the same original snapshot.',\n  }),\n});\n\nexport type HashlineRange = Static<typeof HashlineRangeSchema>;\nexport type EditParams = Static<typeof EditParamsSchema>;\n","import { constants } from 'node:fs';\nimport { access, readFile, writeFile } from 'node:fs/promises';\n\nimport type { PoHeadlessExecutionContext, PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport {\n  applyHashlineEdits,\n  normalizeFileTag,\n  normalizeToLf,\n  stripBom,\n  type PreparedHashlineEdit,\n} from '@agimon-ai/po-hashline';\nimport { computeFileTag, decodeUtf8, displayPath, resolveInputPath } from '@agimon-ai/po-hashline/files';\nimport {\n  generateDiffString,\n  generateUnifiedPatch,\n  withFileMutationQueue,\n  type EditToolDetails,\n} from '@earendil-works/pi-coding-agent';\nimport type { ToolDefinition } from '@earendil-works/pi-coding-agent';\n\nimport { EditParamsSchema, type EditParams } from '../../schemas/editTool';\n\nexport function createHashlineEditTool(): ToolDefinition<typeof EditParamsSchema> {\n  return {\n    name: 'edit',\n    label: 'edit',\n    description:\n      'Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range.',\n    promptSnippet: 'Edit files with snapshot-bound hashline ranges',\n    promptGuidelines: [\n      'Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.',\n      'Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks.',\n      'Put multiple disjoint changes to one file in one edit call. All anchors must describe the original snapshot.',\n      'Omit content or pass an empty string to delete an inclusive range. Merge overlapping ranges before calling edit.',\n    ],\n    parameters: EditParamsSchema,\n    executionMode: 'parallel',\n    async execute(_toolCallId, params, signal, _onUpdate, ctx) {\n      return executeHashlineEdit(params as EditParams, ctx.cwd, signal);\n    },\n  };\n}\n\nexport function createHeadlessEditTool(): PoHeadlessTool<typeof EditParamsSchema> {\n  return {\n    name: 'edit',\n    label: 'edit',\n    description:\n      'Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range.',\n    promptSnippet: 'Edit files with snapshot-bound hashline ranges',\n    promptGuidelines: [\n      'Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.',\n      'Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks.',\n    ],\n    parameters: EditParamsSchema,\n    executionMode: 'parallel',\n    execute: (\n      _toolCallId: string,\n      params: EditParams,\n      signal: AbortSignal | undefined,\n      _onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => executeHashlineEdit(params, context.cwd, signal),\n  };\n}\n\nexport function assertNotAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw new Error('Operation aborted');\n}\n\nexport async function executeHashlineEdit(\n  params: EditParams,\n  cwd: string,\n  signal: AbortSignal | undefined,\n): Promise<{ content: [{ type: 'text'; text: string }]; details: EditToolDetails }> {\n  const absolutePath = resolveInputPath(params.path, cwd);\n  const expectedHash = normalizeFileTag(params.hash);\n  return withFileMutationQueue(absolutePath, async () => {\n    assertNotAborted(signal);\n    await access(absolutePath, constants.R_OK | constants.W_OK);\n    const beforeBytes = await readFile(absolutePath);\n    assertNotAborted(signal);\n\n    const actualHash = computeFileTag(beforeBytes);\n    if (actualHash !== expectedHash) {\n      throw new Error(`Stale file hash ${expectedHash}. Current hash is ${actualHash}. Re-read the file and retry.`);\n    }\n\n    const hasBom = beforeBytes.subarray(0, 3).equals(Buffer.from([0xef, 0xbb, 0xbf]));\n    const decoded = decodeUtf8(beforeBytes, params.path);\n    const withoutBom = stripBom(decoded);\n    const before = normalizeToLf(withoutBom);\n    const applied = applyHashlineEdits(before, params.edits);\n    const editedText = restoreOriginalLineEndings(withoutBom, applied.edits);\n    if (normalizeToLf(editedText) !== applied.content) {\n      throw new Error('Could not preserve the file line endings safely. The file was not changed.');\n    }\n    const diff = generateDiffString(before, applied.content);\n    const patch = generateUnifiedPatch(displayPath(absolutePath, cwd), before, applied.content);\n    const details: EditToolDetails = { diff: diff.diff, patch, firstChangedLine: diff.firstChangedLine };\n\n    assertNotAborted(signal);\n    const currentBytes = await readFile(absolutePath);\n    if (!currentBytes.equals(beforeBytes)) {\n      throw new Error('The file changed while the edit was being prepared. Re-read it and retry.');\n    }\n    assertNotAborted(signal);\n\n    if (applied.content !== before) {\n      const output = Buffer.from(`${hasBom ? '\\ufeff' : ''}${editedText}`, 'utf8');\n      await writeFile(absolutePath, output);\n    }\n\n    const count = applied.edits.length;\n    const noun = count === 1 ? 'range' : 'ranges';\n    const message =\n      applied.content === before ? `No changes needed in ${params.path}.` : `Edited ${params.path} (${count} ${noun}).`;\n    return { content: [{ type: 'text', text: `${message} Re-read before editing it again.` }], details };\n  });\n}\n\ninterface LineToken {\n  readonly text: string;\n  readonly ending: '\\r\\n' | '\\n' | '\\r' | '';\n}\n\nfunction restoreOriginalLineEndings(original: string, edits: readonly PreparedHashlineEdit[]): string {\n  const tokens = tokenizeLines(original);\n  const defaultEnding = tokens.find((token) => token.ending !== '')?.ending ?? '\\n';\n  for (const edit of [...edits].reverse()) {\n    const start = edit.from.line - 1;\n    const count = edit.to.line - edit.from.line + 1;\n    const removed = tokens.slice(start, start + count);\n    const inheritedEnding = removed.at(-1)?.ending ?? '';\n    const internalEnding = removed.find((token) => token.ending !== '')?.ending ?? defaultEnding;\n    const lines = replacementLines(edit.content);\n    if (lines.length === 0 && removed.at(-1)?.ending === '' && start > 0) {\n      const previous = tokens[start - 1];\n      if (previous) tokens[start - 1] = { ...previous, ending: '' };\n    }\n    const replacements = lines.map<LineToken>((text, index) => ({\n      text,\n      ending: index === lines.length - 1 ? inheritedEnding : internalEnding,\n    }));\n    tokens.splice(start, count, ...replacements);\n  }\n  return tokens.map((token) => `${token.text}${token.ending}`).join('');\n}\n\nfunction tokenizeLines(content: string): LineToken[] {\n  const tokens: LineToken[] = [];\n  let start = 0;\n  for (let index = 0; index < content.length; index += 1) {\n    const character = content[index];\n    if (character !== '\\r' && character !== '\\n') continue;\n    const ending = character === '\\r' && content[index + 1] === '\\n' ? '\\r\\n' : character;\n    tokens.push({ text: content.slice(start, index), ending });\n    if (ending === '\\r\\n') index += 1;\n    start = index + 1;\n  }\n  tokens.push({ text: content.slice(start), ending: '' });\n  return tokens;\n}\n\nfunction replacementLines(content: string | null): string[] {\n  if (content === null || content === '') return [];\n  const normalized = normalizeToLf(content);\n  const trimmed = normalized.endsWith('\\n') ? normalized.slice(0, -1) : normalized;\n  return trimmed === '' ? [] : trimmed.split('\\n');\n}\n"],"mappings":"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"}

package/dist/editTool-BKaEjUdm.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"editTool-BKaEjUdm.cjs","names":["Type","resolveInputPath","normalizeFileTag","withFileMutationQueue","access","constants","readFile","computeFileTag","decodeUtf8","stripBom","normalizeToLf","applyHashlineEdits","generateDiffString","generateUnifiedPatch","displayPath","writeFile"],"sources":["../src/schemas/editTool.ts","../src/services/editTool/index.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const HashlineRangeSchema = Type.Object({\n  from: Type.String({ description: 'One inclusive starting anchor, for example 5#abc. Do not paste multiple lines.' }),\n  to: Type.String({ description: 'One inclusive ending anchor, for example 8#def. Do not paste multiple lines.' }),\n  content: Type.Optional(\n    Type.Union([\n      Type.String({ description: 'Replacement content. Empty content deletes the selected lines.' }),\n      Type.Null({ description: 'Delete the selected lines.' }),\n    ]),\n  ),\n});\n\nexport const EditParamsSchema = Type.Object({\n  path: Type.String({ description: 'Path to the file returned by a compatible hashline read or grep tool.' }),\n  hash: Type.String({ description: 'Eight-character exact-byte file tag returned by read or grep.' }),\n  edits: Type.Array(HashlineRangeSchema, {\n    minItems: 1,\n    description: 'Non-overlapping inclusive ranges from the same original snapshot.',\n  }),\n});\n\nexport type HashlineRange = Static<typeof HashlineRangeSchema>;\nexport type EditParams = Static<typeof EditParamsSchema>;\n","import { constants } from 'node:fs';\nimport { access, readFile, writeFile } from 'node:fs/promises';\n\nimport type { PoHeadlessExecutionContext, PoHeadlessTool, PoHeadlessToolResult } from '@agimon-ai/po-core/headless';\nimport {\n  applyHashlineEdits,\n  normalizeFileTag,\n  normalizeToLf,\n  stripBom,\n  type PreparedHashlineEdit,\n} from '@agimon-ai/po-hashline';\nimport { computeFileTag, decodeUtf8, displayPath, resolveInputPath } from '@agimon-ai/po-hashline/files';\nimport {\n  generateDiffString,\n  generateUnifiedPatch,\n  withFileMutationQueue,\n  type EditToolDetails,\n} from '@earendil-works/pi-coding-agent';\nimport type { ToolDefinition } from '@earendil-works/pi-coding-agent';\n\nimport { EditParamsSchema, type EditParams } from '../../schemas/editTool';\n\nexport function createHashlineEditTool(): ToolDefinition<typeof EditParamsSchema> {\n  return {\n    name: 'edit',\n    label: 'edit',\n    description:\n      'Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range.',\n    promptSnippet: 'Edit files with snapshot-bound hashline ranges',\n    promptGuidelines: [\n      'Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.',\n      'Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks.',\n      'Put multiple disjoint changes to one file in one edit call. All anchors must describe the original snapshot.',\n      'Omit content or pass an empty string to delete an inclusive range. Merge overlapping ranges before calling edit.',\n    ],\n    parameters: EditParamsSchema,\n    executionMode: 'parallel',\n    async execute(_toolCallId, params, signal, _onUpdate, ctx) {\n      return executeHashlineEdit(params as EditParams, ctx.cwd, signal);\n    },\n  };\n}\n\nexport function createHeadlessEditTool(): PoHeadlessTool<typeof EditParamsSchema> {\n  return {\n    name: 'edit',\n    label: 'edit',\n    description:\n      'Edit one file using its exact snapshot hash and inclusive anchors such as 5#abc from read or grep. Each from and to value must contain one anchor, not a pasted block. All ranges refer to the original snapshot. Empty or omitted content deletes a range.',\n    promptSnippet: 'Edit files with snapshot-bound hashline ranges',\n    promptGuidelines: [\n      'Copy path, hash, and anchors from the latest compatible read or grep result. Re-read after every successful edit.',\n      'Pass one anchor such as 5#abc in each from and to value. Do not paste tagged lines or multiline blocks.',\n    ],\n    parameters: EditParamsSchema,\n    executionMode: 'parallel',\n    execute: (\n      _toolCallId: string,\n      params: EditParams,\n      signal: AbortSignal | undefined,\n      _onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n      context: PoHeadlessExecutionContext,\n    ) => executeHashlineEdit(params, context.cwd, signal),\n  };\n}\n\nexport function assertNotAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw new Error('Operation aborted');\n}\n\nexport async function executeHashlineEdit(\n  params: EditParams,\n  cwd: string,\n  signal: AbortSignal | undefined,\n): Promise<{ content: [{ type: 'text'; text: string }]; details: EditToolDetails }> {\n  const absolutePath = resolveInputPath(params.path, cwd);\n  const expectedHash = normalizeFileTag(params.hash);\n  return withFileMutationQueue(absolutePath, async () => {\n    assertNotAborted(signal);\n    await access(absolutePath, constants.R_OK | constants.W_OK);\n    const beforeBytes = await readFile(absolutePath);\n    assertNotAborted(signal);\n\n    const actualHash = computeFileTag(beforeBytes);\n    if (actualHash !== expectedHash) {\n      throw new Error(`Stale file hash ${expectedHash}. Current hash is ${actualHash}. Re-read the file and retry.`);\n    }\n\n    const hasBom = beforeBytes.subarray(0, 3).equals(Buffer.from([0xef, 0xbb, 0xbf]));\n    const decoded = decodeUtf8(beforeBytes, params.path);\n    const withoutBom = stripBom(decoded);\n    const before = normalizeToLf(withoutBom);\n    const applied = applyHashlineEdits(before, params.edits);\n    const editedText = restoreOriginalLineEndings(withoutBom, applied.edits);\n    if (normalizeToLf(editedText) !== applied.content) {\n      throw new Error('Could not preserve the file line endings safely. The file was not changed.');\n    }\n    const diff = generateDiffString(before, applied.content);\n    const patch = generateUnifiedPatch(displayPath(absolutePath, cwd), before, applied.content);\n    const details: EditToolDetails = { diff: diff.diff, patch, firstChangedLine: diff.firstChangedLine };\n\n    assertNotAborted(signal);\n    const currentBytes = await readFile(absolutePath);\n    if (!currentBytes.equals(beforeBytes)) {\n      throw new Error('The file changed while the edit was being prepared. Re-read it and retry.');\n    }\n    assertNotAborted(signal);\n\n    if (applied.content !== before) {\n      const output = Buffer.from(`${hasBom ? '\\ufeff' : ''}${editedText}`, 'utf8');\n      await writeFile(absolutePath, output);\n    }\n\n    const count = applied.edits.length;\n    const noun = count === 1 ? 'range' : 'ranges';\n    const message =\n      applied.content === before ? `No changes needed in ${params.path}.` : `Edited ${params.path} (${count} ${noun}).`;\n    return { content: [{ type: 'text', text: `${message} Re-read before editing it again.` }], details };\n  });\n}\n\ninterface LineToken {\n  readonly text: string;\n  readonly ending: '\\r\\n' | '\\n' | '\\r' | '';\n}\n\nfunction restoreOriginalLineEndings(original: string, edits: readonly PreparedHashlineEdit[]): string {\n  const tokens = tokenizeLines(original);\n  const defaultEnding = tokens.find((token) => token.ending !== '')?.ending ?? '\\n';\n  for (const edit of [...edits].reverse()) {\n    const start = edit.from.line - 1;\n    const count = edit.to.line - edit.from.line + 1;\n    const removed = tokens.slice(start, start + count);\n    const inheritedEnding = removed.at(-1)?.ending ?? '';\n    const internalEnding = removed.find((token) => token.ending !== '')?.ending ?? defaultEnding;\n    const lines = replacementLines(edit.content);\n    if (lines.length === 0 && removed.at(-1)?.ending === '' && start > 0) {\n      const previous = tokens[start - 1];\n      if (previous) tokens[start - 1] = { ...previous, ending: '' };\n    }\n    const replacements = lines.map<LineToken>((text, index) => ({\n      text,\n      ending: index === lines.length - 1 ? inheritedEnding : internalEnding,\n    }));\n    tokens.splice(start, count, ...replacements);\n  }\n  return tokens.map((token) => `${token.text}${token.ending}`).join('');\n}\n\nfunction tokenizeLines(content: string): LineToken[] {\n  const tokens: LineToken[] = [];\n  let start = 0;\n  for (let index = 0; index < content.length; index += 1) {\n    const character = content[index];\n    if (character !== '\\r' && character !== '\\n') continue;\n    const ending = character === '\\r' && content[index + 1] === '\\n' ? '\\r\\n' : character;\n    tokens.push({ text: content.slice(start, index), ending });\n    if (ending === '\\r\\n') index += 1;\n    start = index + 1;\n  }\n  tokens.push({ text: content.slice(start), ending: '' });\n  return tokens;\n}\n\nfunction replacementLines(content: string | null): string[] {\n  if (content === null || content === '') return [];\n  const normalized = normalizeToLf(content);\n  const trimmed = normalized.endsWith('\\n') ? normalized.slice(0, -1) : normalized;\n  return trimmed === '' ? [] : trimmed.split('\\n');\n}\n"],"mappings":"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"}