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

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

@@ -1,8 +1,8 @@
 let _agimon_ai_po_core_platform = require("@agimon-ai/po-core/platform");
 let _agimon_ai_po_hashline = require("@agimon-ai/po-hashline");
 let _agimon_ai_po_hashline_files = require("@agimon-ai/po-hashline/files");
-let _earendil_works_pi_coding_agent = require("@earendil-works/pi-coding-agent");
 let typebox = require("typebox");
+let _earendil_works_pi_coding_agent = require("@earendil-works/pi-coding-agent");
 //#region src/schemas/editTool.ts
 const HashlineRangeSchema = typebox.Type.Object({
 	from: typebox.Type.String({ description: "One inclusive starting anchor, for example 5#abc. Do not paste multiple lines." }),
@@ -18,6 +18,12 @@ const EditParamsSchema = typebox.Type.Object({
 	})
 });
 //#endregion
+//#region src/services/editHost/index.ts
+/** Serialize mutations of one file. Pi keys the queue by the real path, so the filesystem is not needed. */
+function withFileMutationQueue(_filesystem, filePath, run) {
+	return (0, _earendil_works_pi_coding_agent.withFileMutationQueue)(filePath, run);
+}
+//#endregion
 //#region src/services/editTool/index.ts
 function createHashlineEditTool(filesystem) {
 	return {
@@ -65,7 +71,7 @@ async function executeHashlineEdit(params, cwd, signal, filesystem) {
 		}
 	};
 	const expectedHash = (0, _agimon_ai_po_hashline.normalizeFileTag)(params.hash);
-	return (0, _earendil_works_pi_coding_agent.withFileMutationQueue)(absolutePath, async () => {
+	return withFileMutationQueue(filesystem, absolutePath, async () => {
 		assertNotAborted(signal);
 		(0, _agimon_ai_po_core_platform.getOrThrow)(await filesystem.fileInfo(absolutePath, context));
 		const beforeBytes = await readSnapshot();
@@ -191,4 +197,4 @@ Object.defineProperty(exports, "executeHashlineEdit", {
 	}
 });
 
-//# sourceMappingURL=editTool-VO-ySAzl.cjs.map
+//# sourceMappingURL=editTool-BWdLe7BE.cjs.map

package/dist/editTool-BWdLe7BE.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"editTool-BWdLe7BE.cjs","names":["Type","piWithFileMutationQueue","resolveInputPath","withAbortSignal","BACKGROUND_CONTEXT","readBoundedFile","FileTooLargeError","normalizeFileTag","computeFileTag","decodeUtf8","stripBom","normalizeToLf","applyHashlineEdits","generateDiffString","generateUnifiedPatch","displayPath"],"sources":["../src/schemas/editTool.ts","../src/services/editHost/index.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 { FileSystem } from '@agimon-ai/po-core/platform';\nimport {\n  generateDiffString,\n  generateUnifiedPatch,\n  withFileMutationQueue as piWithFileMutationQueue,\n} from '@earendil-works/pi-coding-agent';\n\n// The Node form of the edit tool's host seam: Pi's own diff generation and mutation queue. ./index.edge replaces this\n// module in the Worker build, where Pi cannot load.\nexport { generateDiffString, generateUnifiedPatch };\n\n/** Serialize mutations of one file. Pi keys the queue by the real path, so the filesystem is not needed. */\nexport function withFileMutationQueue<T>(_filesystem: FileSystem, filePath: string, run: () => Promise<T>): Promise<T> {\n  return piWithFileMutationQueue(filePath, run);\n}\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 type { EditToolDetails, ToolDefinition } from '@earendil-works/pi-coding-agent';\n\nimport { EditParamsSchema, type EditParams } from '../../schemas/editTool';\nimport { generateDiffString, generateUnifiedPatch, withFileMutationQueue } from '../editHost';\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(filesystem, 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-DVt2xCNP.mjs → editTool-CgslJ5Or.mjs}

@@ -1,8 +1,8 @@
 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";
 import { Type } from "typebox";
+import { generateDiffString, generateUnifiedPatch, withFileMutationQueue } from "@earendil-works/pi-coding-agent";
 //#region src/schemas/editTool.ts
 const HashlineRangeSchema = Type.Object({
 	from: Type.String({ description: "One inclusive starting anchor, for example 5#abc. Do not paste multiple lines." }),
@@ -18,6 +18,12 @@ const EditParamsSchema = Type.Object({
 	})
 });
 //#endregion
+//#region src/services/editHost/index.ts
+/** Serialize mutations of one file. Pi keys the queue by the real path, so the filesystem is not needed. */
+function withFileMutationQueue$1(_filesystem, filePath, run) {
+	return withFileMutationQueue(filePath, run);
+}
+//#endregion
 //#region src/services/editTool/index.ts
 function createHashlineEditTool(filesystem) {
 	return {
@@ -65,7 +71,7 @@ async function executeHashlineEdit(params, cwd, signal, filesystem) {
 		}
 	};
 	const expectedHash = normalizeFileTag(params.hash);
-	return withFileMutationQueue(absolutePath, async () => {
+	return withFileMutationQueue$1(filesystem, absolutePath, async () => {
 		assertNotAborted(signal);
 		getOrThrow(await filesystem.fileInfo(absolutePath, context));
 		const beforeBytes = await readSnapshot();
@@ -162,4 +168,4 @@ function replacementLines(content) {
 //#endregion
 export { HashlineRangeSchema as a, EditParamsSchema as i, createHeadlessEditTool as n, executeHashlineEdit as r, createHashlineEditTool as t };
 
-//# sourceMappingURL=editTool-DVt2xCNP.mjs.map
+//# sourceMappingURL=editTool-CgslJ5Or.mjs.map

package/dist/editTool-CgslJ5Or.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"editTool-CgslJ5Or.mjs","names":["withFileMutationQueue","piWithFileMutationQueue","withFileMutationQueue"],"sources":["../src/schemas/editTool.ts","../src/services/editHost/index.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 { FileSystem } from '@agimon-ai/po-core/platform';\nimport {\n  generateDiffString,\n  generateUnifiedPatch,\n  withFileMutationQueue as piWithFileMutationQueue,\n} from '@earendil-works/pi-coding-agent';\n\n// The Node form of the edit tool's host seam: Pi's own diff generation and mutation queue. ./index.edge replaces this\n// module in the Worker build, where Pi cannot load.\nexport { generateDiffString, generateUnifiedPatch };\n\n/** Serialize mutations of one file. Pi keys the queue by the real path, so the filesystem is not needed. */\nexport function withFileMutationQueue<T>(_filesystem: FileSystem, filePath: string, run: () => Promise<T>): Promise<T> {\n  return piWithFileMutationQueue(filePath, run);\n}\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 type { EditToolDetails, ToolDefinition } from '@earendil-works/pi-coding-agent';\n\nimport { EditParamsSchema, type EditParams } from '../../schemas/editTool';\nimport { generateDiffString, generateUnifiedPatch, withFileMutationQueue } from '../editHost';\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(filesystem, 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

@@ -6,8 +6,8 @@ let _agimon_ai_po_core_mcpFacet = require("@agimon-ai/po-core/mcpFacet");
 let _agimon_ai_po_core_platform = require("@agimon-ai/po-core/platform");
 let _agimon_ai_po_hashline = require("@agimon-ai/po-hashline");
 let _agimon_ai_po_hashline_files = require("@agimon-ai/po-hashline/files");
-let _earendil_works_pi_coding_agent = require("@earendil-works/pi-coding-agent");
 let typebox = require("typebox");
+let _earendil_works_pi_coding_agent = require("@earendil-works/pi-coding-agent");
 //#region src/schemas/editTool.ts
 const HashlineRangeSchema = typebox.Type.Object({
 	from: typebox.Type.String({ description: "One inclusive starting anchor, for example 5#abc. Do not paste multiple lines." }),
@@ -23,6 +23,12 @@ const EditParamsSchema = typebox.Type.Object({
 	})
 });
 //#endregion
+//#region src/services/editHost/index.ts
+/** Serialize mutations of one file. Pi keys the queue by the real path, so the filesystem is not needed. */
+function withFileMutationQueue(_filesystem, filePath, run) {
+	return (0, _earendil_works_pi_coding_agent.withFileMutationQueue)(filePath, run);
+}
+//#endregion
 //#region src/services/editTool/index.ts
 function createHeadlessEditTool(filesystem) {
 	return {
@@ -51,7 +57,7 @@ async function executeHashlineEdit(params, cwd, signal, filesystem) {
 		}
 	};
 	const expectedHash = (0, _agimon_ai_po_hashline.normalizeFileTag)(params.hash);
-	return (0, _earendil_works_pi_coding_agent.withFileMutationQueue)(absolutePath, async () => {
+	return withFileMutationQueue(filesystem, absolutePath, async () => {
 		assertNotAborted(signal);
 		(0, _agimon_ai_po_core_platform.getOrThrow)(await filesystem.fileInfo(absolutePath, context));
 		const beforeBytes = await readSnapshot();

package/dist/extensions/mcp.cjs.map

@@ -1 +1 @@
-{"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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"}
+{"version":3,"file":"mcp.cjs","names":["Type","piWithFileMutationQueue","resolveInputPath","withAbortSignal","BACKGROUND_CONTEXT","readBoundedFile","FileTooLargeError","normalizeFileTag","computeFileTag","decodeUtf8","stripBom","normalizeToLf","applyHashlineEdits","generateDiffString","generateUnifiedPatch","displayPath","defineMcpTool","PO_FS_SERVICE","defineMcpPlugin","toolEdit"],"sources":["../../src/schemas/editTool.ts","../../src/services/editHost/index.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 { FileSystem } from '@agimon-ai/po-core/platform';\nimport {\n  generateDiffString,\n  generateUnifiedPatch,\n  withFileMutationQueue as piWithFileMutationQueue,\n} from '@earendil-works/pi-coding-agent';\n\n// The Node form of the edit tool's host seam: Pi's own diff generation and mutation queue. ./index.edge replaces this\n// module in the Worker build, where Pi cannot load.\nexport { generateDiffString, generateUnifiedPatch };\n\n/** Serialize mutations of one file. Pi keys the queue by the real path, so the filesystem is not needed. */\nexport function withFileMutationQueue<T>(_filesystem: FileSystem, filePath: string, run: () => Promise<T>): Promise<T> {\n  return piWithFileMutationQueue(filePath, run);\n}\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 type { EditToolDetails, ToolDefinition } from '@earendil-works/pi-coding-agent';\n\nimport { EditParamsSchema, type EditParams } from '../../schemas/editTool';\nimport { generateDiffString, generateUnifiedPatch, withFileMutationQueue } from '../editHost';\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(filesystem, 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":";;;;;;;;;;;AAEA,MAAa,sBAAsBA,QAAAA,KAAK,OAAO;CAC7C,MAAMA,QAAAA,KAAK,OAAO,EAAE,aAAa,iFAAiF,CAAC;CACnH,IAAIA,QAAAA,KAAK,OAAO,EAAE,aAAa,+EAA+E,CAAC;CAC/G,SAASA,QAAAA,KAAK,SACZA,QAAAA,KAAK,MAAM,CACTA,QAAAA,KAAK,OAAO,EAAE,aAAa,iEAAiE,CAAC,GAC7FA,QAAAA,KAAK,KAAK,EAAE,aAAa,6BAA6B,CAAC,CACzD,CAAC,CACH;AACF,CAAC;AAED,MAAa,mBAAmBA,QAAAA,KAAK,OAAO;CAC1C,MAAMA,QAAAA,KAAK,OAAO,EAAE,aAAa,wEAAwE,CAAC;CAC1G,MAAMA,QAAAA,KAAK,OAAO,EAAE,aAAa,gEAAgE,CAAC;CAClG,OAAOA,QAAAA,KAAK,MAAM,qBAAqB;EACrC,UAAU;EACV,aAAa;CACf,CAAC;AACH,CAAC;;;;ACRD,SAAgB,sBAAyB,aAAyB,UAAkB,KAAmC;CACrH,QAAA,GAAOC,gCAAAA,sBAAAA,CAAwB,UAAU,GAAG;AAC9C;;;ACoCA,SAAgB,uBACd,YACyC;CACzC,OAAO;EACL,MAAM;EACN,OAAO;EACP,aACE;EACF,eAAe;EACf,kBAAkB,CAChB,qHACA,yGACF;EACA,YAAY;EACZ,eAAe;EACf,UACE,aACA,QACA,QACA,WACA,YACG,oBAAoB,QAAQ,QAAQ,KAAK,QAAQ,OAAO,eAAe,aAAa,WAAW,IAAI,UAAU;CACpH;AACF;AAEA,SAAgB,iBAAiB,QAAuC;CACtE,IAAI,QAAQ,SAAS,MAAM,IAAI,MAAM,mBAAmB;AAC1D;AAEA,eAAsB,oBACpB,QACA,KACA,QACA,YACkF;CAClF,MAAM,gBAAA,GAAeC,6BAAAA,iBAAAA,CAAiB,OAAO,MAAM,GAAG;CACtD,MAAM,UAAU,UAAA,GAASC,4BAAAA,gBAAAA,CAAgB,QAAQC,4BAAAA,kBAAkB,IAAIA,4BAAAA;CACvE,MAAM,eAAe,YAA6B;EAChD,IAAI;GACF,OAAO,OAAO,KAAK,OAAA,GAAMC,4BAAAA,gBAAAA,CAAgB,YAAY,cAAc,SAAiB,OAAO,CAAC;EAC9F,SAAS,OAAO;GACd,IAAI,iBAAiBC,4BAAAA,mBACnB,MAAM,IAAI,MAAM,6EAA6E,EAAE,OAAO,MAAM,CAAC;GAE/G,MAAM;EACR;CACF;CACA,MAAM,gBAAA,GAAeC,uBAAAA,iBAAAA,CAAiB,OAAO,IAAI;CACjD,OAAO,sBAAsB,YAAY,cAAc,YAAY;EACjE,iBAAiB,MAAM;EACvB,CAAA,GAAA,4BAAA,WAAA,CAAW,MAAM,WAAW,SAAS,cAAc,OAAO,CAAC;EAC3D,MAAM,cAAc,MAAM,aAAa;EACvC,iBAAiB,MAAM;EAEvB,MAAM,cAAA,GAAaC,6BAAAA,eAAAA,CAAe,WAAW;EAC7C,IAAI,eAAe,cACjB,MAAM,IAAI,MAAM,mBAAmB,aAAa,oBAAoB,WAAW,8BAA8B;EAG/G,MAAM,SAAS,YAAY,SAAS,GAAG,CAAC,CAAC,CAAC,OAAO,OAAO,KAAK;GAAC;GAAM;GAAM;EAAI,CAAC,CAAC;EAChF,MAAM,WAAA,GAAUC,6BAAAA,WAAAA,CAAW,aAAa,OAAO,IAAI;EACnD,MAAM,cAAA,GAAaC,uBAAAA,SAAAA,CAAS,OAAO;EACnC,MAAM,UAAA,GAASC,uBAAAA,cAAAA,CAAc,UAAU;EACvC,MAAM,WAAA,GAAUC,uBAAAA,mBAAAA,CAAmB,QAAQ,OAAO,KAAK;EACvD,MAAM,aAAa,2BAA2B,YAAY,QAAQ,KAAK;EACvE,KAAA,GAAID,uBAAAA,cAAAA,CAAc,UAAU,MAAM,QAAQ,SACxC,MAAM,IAAI,MAAM,4EAA4E;EAE9F,MAAM,QAAA,GAAOE,gCAAAA,mBAAAA,CAAmB,QAAQ,QAAQ,OAAO;EACvD,MAAM,SAAA,GAAQC,gCAAAA,qBAAAA,EAAAA,GAAqBC,6BAAAA,YAAAA,CAAY,cAAc,GAAG,GAAG,QAAQ,QAAQ,OAAO;EAC1F,MAAM,UAA2B;GAAE,MAAM,KAAK;GAAM;GAAO,kBAAkB,KAAK;EAAiB;EAEnG,iBAAiB,MAAM;EAEvB,IAAI,EAAC,MADsB,aAAa,EAAA,CACtB,OAAO,WAAW,GAClC,MAAM,IAAI,MAAM,2EAA2E;EAE7F,iBAAiB,MAAM;EAEvB,IAAI,QAAQ,YAAY,QAAQ;GAC9B,MAAM,SAAS,OAAO,KAAK,GAAG,SAAS,MAAW,KAAK,cAAc,MAAM;GAC3E,CAAA,GAAA,4BAAA,WAAA,CAAW,MAAM,WAAW,UAAU,cAAc,QAAQX,4BAAAA,kBAAkB,CAAC;EACjF;EAEA,MAAM,QAAQ,QAAQ,MAAM;EAC5B,MAAM,OAAO,UAAU,IAAI,UAAU;EAGrC,OAAO;GAAE,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM,GADvC,QAAQ,YAAY,SAAS,wBAAwB,OAAO,KAAK,KAAK,UAAU,OAAO,KAAK,IAAI,MAAM,GAAG,KAAK,IAC5D;GAAmC,CAAC;GAAG;EAAQ;CACrG,CAAC;AACH;AAOA,SAAS,2BAA2B,UAAkB,OAAgD;CACpG,MAAM,SAAS,cAAc,QAAQ;CACrC,MAAM,gBAAgB,OAAO,MAAM,UAAU,MAAM,WAAW,EAAE,CAAC,EAAE,UAAU;CAC7E,KAAK,MAAM,QAAQ,CAAC,GAAG,KAAK,CAAC,CAAC,QAAQ,GAAG;EACvC,MAAM,QAAQ,KAAK,KAAK,OAAO;EAC/B,MAAM,QAAQ,KAAK,GAAG,OAAO,KAAK,KAAK,OAAO;EAC9C,MAAM,UAAU,OAAO,MAAM,OAAO,QAAQ,KAAK;EACjD,MAAM,kBAAkB,QAAQ,GAAG,EAAE,CAAC,EAAE,UAAU;EAClD,MAAM,iBAAiB,QAAQ,MAAM,UAAU,MAAM,WAAW,EAAE,CAAC,EAAE,UAAU;EAC/E,MAAM,QAAQ,iBAAiB,KAAK,OAAO;EAC3C,IAAI,MAAM,WAAW,KAAK,QAAQ,GAAG,EAAE,CAAC,EAAE,WAAW,MAAM,QAAQ,GAAG;GACpE,MAAM,WAAW,OAAO,QAAQ;GAChC,IAAI,UAAU,OAAO,QAAQ,KAAK;IAAE,GAAG;IAAU,QAAQ;GAAG;EAC9D;EACA,MAAM,eAAe,MAAM,KAAgB,MAAM,WAAW;GAC1D;GACA,QAAQ,UAAU,MAAM,SAAS,IAAI,kBAAkB;EACzD,EAAE;EACF,OAAO,OAAO,OAAO,OAAO,GAAG,YAAY;CAC7C;CACA,OAAO,OAAO,KAAK,UAAU,GAAG,MAAM,OAAO,MAAM,QAAQ,CAAC,CAAC,KAAK,EAAE;AACtE;AAEA,SAAS,cAAc,SAA8B;CACnD,MAAM,SAAsB,CAAC;CAC7B,IAAI,QAAQ;CACZ,KAAK,IAAI,QAAQ,GAAG,QAAQ,QAAQ,QAAQ,SAAS,GAAG;EACtD,MAAM,YAAY,QAAQ;EAC1B,IAAI,cAAc,QAAQ,cAAc,MAAM;EAC9C,MAAM,SAAS,cAAc,QAAQ,QAAQ,QAAQ,OAAO,OAAO,SAAS;EAC5E,OAAO,KAAK;GAAE,MAAM,QAAQ,MAAM,OAAO,KAAK;GAAG;EAAO,CAAC;EACzD,IAAI,WAAW,QAAQ,SAAS;EAChC,QAAQ,QAAQ;CAClB;CACA,OAAO,KAAK;EAAE,MAAM,QAAQ,MAAM,KAAK;EAAG,QAAQ;CAAG,CAAC;CACtD,OAAO;AACT;AAEA,SAAS,iBAAiB,SAAkC;CAC1D,IAAI,YAAY,QAAQ,YAAY,IAAI,OAAO,CAAC;CAChD,MAAM,cAAA,GAAaO,uBAAAA,cAAAA,CAAc,OAAO;CACxC,MAAM,UAAU,WAAW,SAAS,IAAI,IAAI,WAAW,MAAM,GAAG,EAAE,IAAI;CACtE,OAAO,YAAY,KAAK,CAAC,IAAI,QAAQ,MAAM,IAAI;AACjD;;;ACzLA,IAAA,oBAAA,GAAeK,4BAAAA,cAAAA,EAAe,YAAgC;CAC5D,MAAM,aAAa,QAAQ,SAAS,IAAgBC,4BAAAA,aAAa;CACjE,IAAI,CAAC,YAAY,MAAM,IAAI,MAAM,yCAAyC;CAC1E,OAAO;EACL,GAAG,uBAAuB,UAAU;EACpC,aACE;CACJ;AACF,CAAC;;;ACPD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AACpE,MAAM,OAAU,UAAmC,UAChD,UAAU,KAAA,IAAY,KAAA,IAAY;CAAE,GAAG;CAAU,GAAI;AAAiB;AAEzE,MAAM,cAAiB,KAAa,UAAgB,UAAU,KAAA,IAAY,QAAS;CACjF,GAAG;CAAO,OAAO;EAAE,GAAI,MAA6B;GAAQ,cAAc;CAAI;AAChF;AAEA,MAAa,OAAA,GAAMC,4BAAAA,gBAAAA,CAAgB;CACjC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,QAAqC;EAAE,OAAO,CAAC,WAAW,2BAA2B,IAAI,EAAE,MAAM,OAAO,GAAG,GAAGC,kBAAU,OAAO,CAAC,CAAC,CAAC;CAAG,EAC3I;AACF,CAAC"}

package/dist/extensions/mcp.mjs

@@ -2,8 +2,8 @@ import { defineMcpPlugin, defineMcpTool } from "@agimon-ai/po-core/mcpFacet";
 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";
 import { Type } from "typebox";
+import { generateDiffString, generateUnifiedPatch, withFileMutationQueue } from "@earendil-works/pi-coding-agent";
 //#region src/schemas/editTool.ts
 const HashlineRangeSchema = Type.Object({
 	from: Type.String({ description: "One inclusive starting anchor, for example 5#abc. Do not paste multiple lines." }),
@@ -19,6 +19,12 @@ const EditParamsSchema = Type.Object({
 	})
 });
 //#endregion
+//#region src/services/editHost/index.ts
+/** Serialize mutations of one file. Pi keys the queue by the real path, so the filesystem is not needed. */
+function withFileMutationQueue$1(_filesystem, filePath, run) {
+	return withFileMutationQueue(filePath, run);
+}
+//#endregion
 //#region src/services/editTool/index.ts
 function createHeadlessEditTool(filesystem) {
 	return {
@@ -47,7 +53,7 @@ async function executeHashlineEdit(params, cwd, signal, filesystem) {
 		}
 	};
 	const expectedHash = normalizeFileTag(params.hash);
-	return withFileMutationQueue(absolutePath, async () => {
+	return withFileMutationQueue$1(filesystem, absolutePath, async () => {
 		assertNotAborted(signal);
 		getOrThrow(await filesystem.fileInfo(absolutePath, context));
 		const beforeBytes = await readSnapshot();

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 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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"}
+{"version":3,"file":"mcp.mjs","names":["withFileMutationQueue","piWithFileMutationQueue","withFileMutationQueue","toolEdit"],"sources":["../../src/schemas/editTool.ts","../../src/services/editHost/index.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 { FileSystem } from '@agimon-ai/po-core/platform';\nimport {\n  generateDiffString,\n  generateUnifiedPatch,\n  withFileMutationQueue as piWithFileMutationQueue,\n} from '@earendil-works/pi-coding-agent';\n\n// The Node form of the edit tool's host seam: Pi's own diff generation and mutation queue. ./index.edge replaces this\n// module in the Worker build, where Pi cannot load.\nexport { generateDiffString, generateUnifiedPatch };\n\n/** Serialize mutations of one file. Pi keys the queue by the real path, so the filesystem is not needed. */\nexport function withFileMutationQueue<T>(_filesystem: FileSystem, filePath: string, run: () => Promise<T>): Promise<T> {\n  return piWithFileMutationQueue(filePath, run);\n}\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 type { EditToolDetails, ToolDefinition } from '@earendil-works/pi-coding-agent';\n\nimport { EditParamsSchema, type EditParams } from '../../schemas/editTool';\nimport { generateDiffString, generateUnifiedPatch, withFileMutationQueue } from '../editHost';\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(filesystem, 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,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_editTool = require("../editTool-VO-ySAzl.cjs");
+const require_editTool = require("../editTool-BWdLe7BE.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

package/dist/extensions/server.mjs

@@ -1,4 +1,4 @@
-import { n as createHeadlessEditTool } from "../editTool-DVt2xCNP.mjs";
+import { n as createHeadlessEditTool } from "../editTool-CgslJ5Or.mjs";
 import { PO_FS_SERVICE, requirePoFs } from "@agimon-ai/po-core/platform";
 import { defineServerPlugin } from "@agimon-ai/po-core/serverPlugin";
 import { defineServerTool } from "@agimon-ai/po-core/extensionFile";

package/dist/index.cjs

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

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { FileSystem } from "@agimon-ai/po-core/platform";
-import { EditToolDetails, ToolDefinition } from "@earendil-works/pi-coding-agent";
 import { Static, Type } from "typebox";
+import { EditToolDetails, ToolDefinition } from "@earendil-works/pi-coding-agent";
 import { PoHeadlessTool } from "@agimon-ai/po-core/headless";
 //#region src/schemas/editTool.d.ts
 export declare const HashlineRangeSchema: Type.TObject<{

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;;;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"}
+{"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,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-DVt2xCNP.mjs";
+export { i as EditParamsSchema, a as HashlineRangeSchema, t as createHashlineEditTool, n as createHeadlessEditTool, r as executeHashlineEdit } from "./editTool-CgslJ5Or.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/po-edit",
-  "version": "0.0.0-alpha.111",
+  "version": "0.0.0-alpha.112",
   "description": "Snapshot-bound hashline edit tool for Pi and Po.",
   "keywords": [
     "ai",
@@ -59,16 +59,16 @@
     "access": "public"
   },
   "dependencies": {
-    "@agimon-ai/po-core": "0.0.0-alpha.111",
-    "@agimon-ai/po-hashline": "0.0.0-alpha.111",
-    "@agimon-ai/po-ui": "0.0.0-alpha.111",
-    "@agimon-ai/po-web-components": "0.0.0-alpha.111",
+    "@agimon-ai/po-core": "0.0.0-alpha.112",
+    "@agimon-ai/po-hashline": "0.0.0-alpha.112",
+    "@agimon-ai/po-ui": "0.0.0-alpha.112",
+    "@agimon-ai/po-web-components": "0.0.0-alpha.112",
     "@deepseek-ai/cordis": "4.0.5",
     "typebox": "1.4.2"
   },
   "devDependencies": {
-    "@agimon-ai/po-build": "0.0.0-alpha.111",
-    "@agimon-ai/po-native-components": "0.0.0-alpha.111",
+    "@agimon-ai/po-build": "0.0.0-alpha.112",
+    "@agimon-ai/po-native-components": "0.0.0-alpha.112",
     "@earendil-works/pi-coding-agent": "1.5.0",
     "@earendil-works/pi-durable": "1.5.0",
     "@tanstack/react-store": "0.11.2",
@@ -76,6 +76,7 @@
     "@types/node": "26.6.5",
     "@types/react": "19.3.0",
     "@vitest/coverage-v8": "5.0.4",
+    "diff": "8.0.4",
     "react": "19.3.1",
     "react-dom": "19.3.1",
     "react-native": "0.88.1",
@@ -85,7 +86,7 @@
     "vitest": "5.0.4"
   },
   "peerDependencies": {
-    "@agimon-ai/po-native-components": "0.0.0-alpha.111",
+    "@agimon-ai/po-native-components": "0.0.0-alpha.112",
     "@earendil-works/pi-coding-agent": "1.5.0",
     "react-native": "0.88.1",
     "react-native-unistyles": "^3.5.3"

package/dist/editTool-DVt2xCNP.mjs.map

@@ -1 +0,0 @@
-{"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-VO-ySAzl.cjs.map

@@ -1 +0,0 @@
-{"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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"}