@agimon-ai/po-edit 0.0.0-alpha.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Vuong Ngo
+Copyright (c) 2026 pulseaiclub
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,83 @@
+# @agimon-ai/po-edit
+
+Snapshot-bound hashline edit tool for Po.
+
+Part of the [Po distribution](https://www.npmjs.com/package/@agimon-ai/po).
+
+The native `edit` tool consumes the exact file tags and stable
+three-letter anchors produced by `@agimon-ai/po-read`, `@agimon-ai/po-grep`, or another
+compatible hashline producer. Stale or ambiguous mutations fail before any file is changed.
+
+> **Alpha:** tool and protocol contracts may change between releases.
+
+## Requirements
+
+- Node.js 24 or newer
+
+## Tool protocol
+
+Compatible read and grep results start with a file header followed by tagged lines:
+
+```text
+@file src/example.ts#A1b2C3d4
+1#abc|const value = 1;
+```
+
+The shared protocol is implemented by `@agimon-ai/po-hashline`. The eight-character file tag is
+the base64url SHA-256 prefix of the exact file bytes. The three-letter line anchor is a
+whitespace-insensitive FNV-1a64 tag.
+
+`edit` accepts:
+
+```json
+{
+  "path": "src/example.ts",
+  "hash": "A1b2C3d4",
+  "edits": [
+    {
+      "from": "1#abc",
+      "to": "1#abc",
+      "content": "const value = 2;"
+    }
+  ]
+}
+```
+
+All anchors refer to the original snapshot. Ranges are inclusive. Omit `content` to delete a range.
+Exact duplicate edits are applied once, but any other overlapping ranges are rejected before
+mutation.
+
+Pass exactly one anchor in each `from` and `to` value, for example `5#abc`. Anchors copied with a
+`>`, `+`, or `-` display prefix are accepted, as are uppercase anchor letters, whitespace around
+the separator, and the legacy `5:abc` separator. Pasted multiline blocks are rejected.
+
+## Attribution
+
+The hashline protocol and FNV anchor approach are adapted from
+[Phi's writetool](https://github.com/pulseaiclub/phi/tree/main/internal/tools/writetool), licensed
+under MIT by pulseaiclub. Po uses an exact-byte SHA-256 file tag as an intentional compatibility
+boundary.
+
+## Public API
+
+```ts
+import { EditParamsSchema, executeHashlineEdit, createHashlineEditTool } from '@agimon-ai/po-edit';
+import type { EditParams, HashlineRange } from '@agimon-ai/po-edit';
+```
+
+## Development
+
+```bash
+pnpm build
+pnpm typecheck
+pnpm test
+pnpm lint
+```
+
+Maintained by [Agimon](https://agimon.ai/about).
+
+## License
+
+MIT
+
+The native tool declaration consumes `services/editTool`, and reusable factories and schemas are exposed through flat `src/exports`.

package/dist/apiContracts.cjs

@@ -0,0 +1,17 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region src/schemas/apiContracts.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+const apiContracts = (0, require("@agimon-ai/po-core/apiContracts").defineApiContract)({
+	version: 1,
+	http: [],
+	sockets: [],
+	dynamic: []
+});
+//#endregion
+exports.apiContracts = apiContracts;
+exports.default = apiContracts;
+
+//# sourceMappingURL=apiContracts.cjs.map

package/dist/apiContracts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.cjs","names":["defineApiContract"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;;;;AAGA,MAAa,gBAAA,4CAAeA,CAAAA,CAAAA,kBAAAA,CAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}

package/dist/apiContracts.d.mts

@@ -0,0 +1,53 @@
+//#region src/schemas/apiContracts.d.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+export declare const apiContracts: {
+  version: 1;
+  protocols?: Record<string, string> | undefined;
+  schemas?: Record<string, boolean | object> | undefined;
+  http: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    basePath?: string | undefined;
+    path: string;
+    method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT";
+    description: string;
+    availability?: string | undefined;
+    authentication: "device" | "none" | "owner";
+    parameters?: {
+      name: string;
+      in: "header" | "path" | "query";
+      required: boolean;
+      schema: boolean | object;
+    }[] | undefined;
+    body?: {
+      contentType: string;
+      contentTypes?: string[] | undefined;
+      required: boolean;
+      schema: boolean | object;
+    } | undefined;
+    responses: Record<string, {
+      description: string;
+      contentType?: string | undefined;
+      schema?: boolean | object | undefined;
+      events?: Record<string, boolean | object> | undefined;
+    }>;
+  }[];
+  sockets: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    description: string;
+    availability?: string | undefined;
+    service: string;
+    member: string;
+    direction: "client-to-server" | "server-to-client";
+    kind: "channel" | "method" | "state";
+    input: boolean | object;
+    output?: boolean | object | undefined;
+    errors?: boolean | object | undefined;
+  }[];
+  dynamic: string[];
+  gaps?: string[] | undefined;
+};
+//#endregion
+export { apiContracts as default };
+//# sourceMappingURL=apiContracts.d.mts.map

package/dist/apiContracts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.d.mts","names":[],"sources":["../src/schemas/apiContracts.ts"],"mappings":";;qBAGa"}

package/dist/apiContracts.mjs

@@ -0,0 +1,13 @@
+import { defineApiContract } from "@agimon-ai/po-core/apiContracts";
+//#region src/schemas/apiContracts.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+const apiContracts = defineApiContract({
+	version: 1,
+	http: [],
+	sockets: [],
+	dynamic: []
+});
+//#endregion
+export { apiContracts, apiContracts as default };
+
+//# sourceMappingURL=apiContracts.mjs.map

package/dist/apiContracts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;AAGA,MAAa,eAAe,kBAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}

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

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

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

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

package/dist/editTool-BKaEjUdm.cjs

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

package/dist/editTool-BKaEjUdm.cjs.map

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

package/dist/extensions/mcp-ui.mjs

@@ -0,0 +1,22 @@
+import { defineMcpWidget } from "@agimon-ai/po-core/web";
+import { McpToolFields, McpToolFrame, McpToolOutput } from "@agimon-ai/po-web-components";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/extensions/workspaces/sessions/(frontend)/tool/edit.mcp.tsx
+function EditMcpWidget(props) {
+	return /* @__PURE__ */ jsxs(McpToolFrame, {
+		...props,
+		title: "Edit file",
+		children: [/* @__PURE__ */ jsx(McpToolFields, { fields: [
+			["Path", props.args.path],
+			["File revision", props.args.hash],
+			["Changes", Array.isArray(props.args.edits) ? props.args.edits.length : void 0]
+		] }), /* @__PURE__ */ jsx(McpToolOutput, { result: props.result })]
+	});
+}
+//#endregion
+//#region generated/mcp-ui.ts
+const widgets = { "@agimon-ai/po-edit/edit": defineMcpWidget(EditMcpWidget) };
+//#endregion
+export { widgets };
+
+//# sourceMappingURL=mcp-ui.mjs.map

package/dist/extensions/mcp-ui.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-ui.mjs","names":["Widget0"],"sources":["../../src/extensions/workspaces/sessions/(frontend)/tool/edit.mcp.tsx","../../generated/mcp-ui.ts"],"sourcesContent":["import { defineMcpWidget, type DoomMcpWidgetProps } from '@agimon-ai/po-core/web';\nimport { McpToolFrame, McpToolFields, McpToolOutput } from '@agimon-ai/po-web-components';\n\nfunction EditMcpWidget(props: DoomMcpWidgetProps) {\n  return (\n    <McpToolFrame {...props} title=\"Edit file\">\n      <McpToolFields\n        fields={[\n          ['Path', props.args.path],\n          ['File revision', props.args.hash],\n          ['Changes', Array.isArray(props.args.edits) ? props.args.edits.length : undefined],\n        ]}\n      />\n      <McpToolOutput result={props.result} />\n    </McpToolFrame>\n  );\n}\n\nexport default defineMcpWidget(EditMcpWidget);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport type { ComponentType } from 'react';\nimport type { DoomMcpWidgetProps } from '@agimon-ai/po-core/mcpWidget';\nimport Widget0 from \"../src/extensions/workspaces/sessions/(frontend)/tool/edit.mcp\";\n\nexport const widgets: Readonly<Record<string, ComponentType<DoomMcpWidgetProps>>> = {\n  \"@agimon-ai/po-edit/edit\": Widget0,\n};\n"],"mappings":";;;;AAGA,SAAS,cAAc,OAA2B;CAChD,OACE,qBAAC,cAAD;EAAc,GAAI;EAAO,OAAM;EAA/B,UAAA,CACE,oBAAC,eAAD,EACE,QAAQ;GACN,CAAC,QAAQ,MAAM,KAAK,IAAI;GACxB,CAAC,iBAAiB,MAAM,KAAK,IAAI;GACjC,CAAC,WAAW,MAAM,QAAQ,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,SAAS,KAAA,CAAS;EACnF,EACD,CAAA,GACD,oBAAC,eAAD,EAAe,QAAQ,MAAM,OAAS,CAAA,CAC1B;;AAElB;;;ACXA,MAAa,UAAuE,EAClF,2BDYa,gBAAgB,aCZFA,EAC7B"}