@agimon-ai/po-grep 0.0.0-alpha.0 → 0.0.0-stage

package/README.md

@@ -1,66 +1,3 @@
-# @agimon-ai/po-grep
+# Temporary Holding Version
 
-Snapshot-bound hashline grep for Po.
-
-Part of the [Po distribution](https://www.npmjs.com/package/@agimon-ai/po).
-
-The native server facet owns `grep`. Its private ripgrep service searches files, then attaches exact-byte file tags and stable three-letter anchors to writable matching or context lines. Non-writable files retain plain output. `@agimon-ai/po-read` and `@agimon-ai/po-edit` use the same hashline protocol.
-
-> **Alpha:** tool and protocol contracts may change between releases.
-
-## Requirements
-
-- Node.js 24 or newer
-- A Po native server host
-
-## Install
-
-Select `@agimon-ai/po-grep` in `.po/modes.yaml` and run `po sync`. The package's `poServer` metadata names its built server facet. There is no standalone Pi entry or tool-registration ordering requirement against `po-ui`.
-
-Install `@agimon-ai/po-edit` when the model should apply the emitted anchors.
-
-## Tool protocol
-
-Writable search results group matching and context lines beneath an exact-byte
-file header:
-
-```text
-@file src/example.ts#A1b2C3d4
-   4#def|const previous = true;
->> 5#abc|const match = true;
-```
-
-The eight-character file tag and three-letter line anchors are model-facing protocol data. Po's
-human renderer hides the protocol tags and anchors while retaining file paths, line numbers, match
-markers, and syntax highlighting.
-
-## 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 { GrepParamsSchema } from '@agimon-ai/po-grep';
-import type { GrepParams } from '@agimon-ai/po-grep';
-```
-
-## Development
-
-```bash
-pnpm build
-pnpm typecheck
-pnpm test
-pnpm lint
-```
-
-Maintained by [Agimon](https://agimon.ai/about).
-
-## License
-
-MIT
-
-The server tool route lives in `src/extensions/workspaces/sessions/(backend)/tool/grep.server.ts` and delegates to the private grep service. Flat `src/exports` files only forward the public schema and parameter type; the tool factory is not public.
+This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/package.json

@@ -1,134 +1,6 @@
 {
   "name": "@agimon-ai/po-grep",
-  "version": "0.0.0-alpha.0",
-  "description": "Snapshot-bound hashline grep for Pi and Po.",
-  "keywords": [
-    "ai",
-    "coding-agent",
-    "developer-tools",
-    "grep",
-    "hashline",
-    "pi-coding-agent",
-    "pi-extension",
-    "pi-package",
-    "po"
-  ],
-  "homepage": "https://agimon.ai",
-  "bugs": {
-    "url": "https://github.com/AgiFlow/po/issues"
-  },
-  "license": "MIT",
-  "author": "Vuong Ngo",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/AgiFlow/po.git",
-    "directory": "packages/default/po-grep"
-  },
-  "files": [
-    "dist"
-  ],
-  "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
-  "jsnext:main": "./dist/index.mjs",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.mts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs"
-    },
-    "./apiContracts": {
-      "types": "./dist/apiContracts.d.mts",
-      "import": "./dist/apiContracts.mjs",
-      "require": "./dist/apiContracts.cjs"
-    },
-    "./extensions/server": {
-      "types": "./dist/extensions/server.d.mts",
-      "import": "./dist/extensions/server.mjs",
-      "require": "./dist/extensions/server.cjs"
-    },
-    "./extensions/web": {
-      "import": "./dist/extensions/web.mjs"
-    },
-    "./package.json": "./package.json"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "@agimon-ai/po-core": "0.0.0-alpha.0",
-    "@agimon-ai/po-hashline": "0.0.0-alpha.0",
-    "@agimon-ai/po-ui": "0.0.0-alpha.0",
-    "@agimon-ai/po-web-components": "0.0.0-alpha.0",
-    "@deepseek-ai/cordis": "4.0.4",
-    "typebox": "1.3.34"
-  },
-  "devDependencies": {
-    "@agimon-ai/po-build": "0.0.0-alpha.0",
-    "@earendil-works/pi-coding-agent": "1.0.2",
-    "@tanstack/react-store": "0.11.2",
-    "@tanstack/store": "0.11.2",
-    "@types/node": "26.6.4",
-    "@types/react": "19.3.0",
-    "@vitest/coverage-v8": "5.0.3",
-    "@vscode/ripgrep": "1.18.0",
-    "react": "19.3.0",
-    "react-dom": "19.3.0",
-    "tsdown": "0.23.0",
-    "typescript": "7.0.2",
-    "vitest": "5.0.3"
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "1.0.2"
-  },
-  "peerDependenciesMeta": {
-    "@earendil-works/pi-coding-agent": {
-      "optional": true
-    }
-  },
-  "engines": {
-    "node": ">=24"
-  },
-  "poMcp": {
-    "entry": "./generated/mcp.ts",
-    "dist": "./dist/extensions/mcp.mjs",
-    "scopes": [
-      "session"
-    ],
-    "ui": {
-      "entry": "./generated/mcp-ui.ts",
-      "dist": "./dist/extensions/mcp-ui.mjs",
-      "widgets": [
-        "@agimon-ai/po-grep/grep"
-      ]
-    }
-  },
-  "poServer": {
-    "entry": "./generated/server.ts",
-    "dist": "./dist/extensions/server.mjs",
-    "scopes": [
-      "session"
-    ],
-    "contracts": {
-      "entry": "./src/exports/apiContracts.ts",
-      "dist": "./dist/apiContracts.mjs"
-    }
-  },
-  "poWeb": {
-    "pluginId": "grep",
-    "channels": [],
-    "client": "./dist/extensions/web.mjs",
-    "scopes": [
-      "session"
-    ]
-  },
-  "scripts": {
-    "build": "tsdown && tsdown --config tsdown.mcp.config.ts",
-    "build:mcp": "tsdown --config tsdown.mcp.config.ts",
-    "test": "vitest --run",
-    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.web.json && tsc --noEmit -p tsconfig.mcp.json",
-    "lint": "oxlint . && oxfmt . --check",
-    "fixcode": "oxlint . --fix && oxfmt ."
-  }
+  "version": "0.0.0-stage",
+  "stub": true,
+  "description": "Temporary package placeholder for staged publishing"
 }

package/LICENSE

@@ -1,22 +0,0 @@
-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/dist/apiContracts.cjs

@@ -1,17 +0,0 @@
-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

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

@@ -1,53 +0,0 @@
-//#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

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

package/dist/apiContracts.mjs

@@ -1,13 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/extensions/mcp-ui.mjs

@@ -1,24 +0,0 @@
-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/grep.mcp.tsx
-function GrepMcpWidget(props) {
-	return /* @__PURE__ */ jsxs(McpToolFrame, {
-		...props,
-		title: "Search file contents",
-		children: [/* @__PURE__ */ jsx(McpToolFields, { fields: [
-			["Pattern", props.args.pattern],
-			["Path", props.args.path],
-			["Glob", props.args.glob],
-			["Ignore case", props.args.ignoreCase],
-			["Limit", props.args.limit]
-		] }), /* @__PURE__ */ jsx(McpToolOutput, { result: props.result })]
-	});
-}
-//#endregion
-//#region generated/mcp-ui.ts
-const widgets = { "@agimon-ai/po-grep/grep": defineMcpWidget(GrepMcpWidget) };
-//#endregion
-export { widgets };
-
-//# sourceMappingURL=mcp-ui.mjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-ui.mjs","names":["Widget0"],"sources":["../../src/extensions/workspaces/sessions/(frontend)/tool/grep.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 GrepMcpWidget(props: DoomMcpWidgetProps) {\n  return (\n    <McpToolFrame {...props} title=\"Search file contents\">\n      <McpToolFields\n        fields={[\n          ['Pattern', props.args.pattern],\n          ['Path', props.args.path],\n          ['Glob', props.args.glob],\n          ['Ignore case', props.args.ignoreCase],\n          ['Limit', props.args.limit],\n        ]}\n      />\n      <McpToolOutput result={props.result} />\n    </McpToolFrame>\n  );\n}\n\nexport default defineMcpWidget(GrepMcpWidget);\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/grep.mcp\";\n\nexport const widgets: Readonly<Record<string, ComponentType<DoomMcpWidgetProps>>> = {\n  \"@agimon-ai/po-grep/grep\": 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,WAAW,MAAM,KAAK,OAAO;GAC9B,CAAC,QAAQ,MAAM,KAAK,IAAI;GACxB,CAAC,QAAQ,MAAM,KAAK,IAAI;GACxB,CAAC,eAAe,MAAM,KAAK,UAAU;GACrC,CAAC,SAAS,MAAM,KAAK,KAAK;EAC5B,EACD,CAAA,GACD,oBAAC,eAAD,EAAe,QAAQ,MAAM,OAAS,CAAA,CAC1B;;AAElB;;;ACbA,MAAa,UAAuE,EAClF,2BDca,gBAAgB,aCdFA,EAC7B"}

package/dist/extensions/mcp.cjs

@@ -1,323 +0,0 @@
-Object.defineProperties(exports, {
-	__esModule: { value: true },
-	[Symbol.toStringTag]: { value: "Module" }
-});
-let _agimon_ai_po_core_mcpFacet = require("@agimon-ai/po-core/mcpFacet");
-let node_fs_promises = require("node:fs/promises");
-let node_path = require("node:path");
-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 node_child_process = require("node:child_process");
-//#region src/schemas/grepTool.ts
-const GrepParamsSchema = typebox.Type.Object({
-	pattern: typebox.Type.String({ description: "Regular expression or literal text to find." }),
-	path: typebox.Type.Optional(typebox.Type.String({ description: "File or directory to search. Defaults to the working directory." })),
-	glob: typebox.Type.Optional(typebox.Type.String({ description: "Glob filter for files to search." })),
-	ignoreCase: typebox.Type.Optional(typebox.Type.Boolean({ description: "Match without case sensitivity." })),
-	literal: typebox.Type.Optional(typebox.Type.Boolean({ description: "Treat pattern as literal text." })),
-	context: typebox.Type.Optional(typebox.Type.Integer({
-		minimum: 0,
-		description: "Context lines around every match."
-	})),
-	limit: typebox.Type.Optional(typebox.Type.Integer({
-		minimum: 1,
-		description: "Maximum number of matches."
-	}))
-});
-//#endregion
-//#region src/services/ripgrep/index.ts
-/** Search with ripgrep independently of the host. */
-async function runRipgrep(request) {
-	const { params, cwd, signal } = request;
-	const output = await spawnRipgrep(argumentsFor(params, cwd), cwd, signal);
-	if (output.trim() === "") return { content: [{
-		type: "text",
-		text: "No matches found"
-	}] };
-	return { content: [{
-		type: "text",
-		text: limitMatches(output, params.limit)
-	}] };
-}
-/** The ripgrep argv one search needs, exposed so a test can assert it without spawning. */
-function argumentsFor(params, cwd) {
-	const target = (0, _agimon_ai_po_hashline_files.resolveInputPath)(params.path ?? ".", cwd);
-	const args = [
-		"--color",
-		"never",
-		"--no-heading",
-		"--with-filename",
-		"--line-number"
-	];
-	if (params.ignoreCase === true) args.push("--ignore-case");
-	if (params.literal === true) args.push("--fixed-strings");
-	if (params.context !== void 0) args.push("--context", String(params.context));
-	if (params.glob !== void 0) args.push("--glob", params.glob);
-	args.push("--", params.pattern, target);
-	return args;
-}
-/**
-* Keeps at most `limit` matching lines, and every context line around them.
-*
-* A context line carries no `:<line>:` marker, which is what separates it from
-* a match, so trimming by line count alone would drop the context ripgrep was
-* asked for.
-*/
-function limitMatches(output, limit) {
-	if (limit === void 0) return output.trimEnd();
-	let matches = 0;
-	const selected = [];
-	for (const line of output.trimEnd().split("\n")) {
-		if (/:(\d+):/u.test(line)) {
-			matches++;
-			if (matches > limit) continue;
-		}
-		selected.push(line);
-	}
-	return selected.join("\n");
-}
-function spawnRipgrep(args, cwd, signal) {
-	return new Promise((resolveOutput, reject) => {
-		const child = (0, node_child_process.spawn)("rg", args, {
-			cwd,
-			stdio: [
-				"ignore",
-				"pipe",
-				"pipe"
-			]
-		});
-		let stdout = "";
-		let stderr = "";
-		child.stdout.on("data", (chunk) => {
-			stdout += chunk.toString();
-		});
-		child.stderr.on("data", (chunk) => {
-			stderr += chunk.toString();
-		});
-		const abort = () => {
-			child.kill("SIGTERM");
-			reject(/* @__PURE__ */ new Error("Operation aborted"));
-		};
-		if (signal?.aborted) {
-			abort();
-			return;
-		}
-		signal?.addEventListener("abort", abort, { once: true });
-		child.once("error", (error) => {
-			signal?.removeEventListener("abort", abort);
-			reject(new Error(`Could not start ripgrep: ${error.message}`, { cause: error }));
-		});
-		child.once("close", (code) => {
-			signal?.removeEventListener("abort", abort);
-			if (code === 0 || code === 1) {
-				resolveOutput(stdout);
-				return;
-			}
-			reject(new Error(stderr.trim() || `ripgrep exited with code ${code ?? "unknown"}`));
-		});
-	});
-}
-//#endregion
-//#region src/services/grepTool/index.ts
-const MATCH_DELIMITER = /:(\d+):/gu;
-const CONTEXT_DELIMITER = /-(\d+)-/gu;
-const NO_MATCHES = "No matches found";
-function createHeadlessGrepTool() {
-	return {
-		name: "grep",
-		label: "grep",
-		description: "Search file contents using ripgrep semantics, then add exact-byte file tags and stable line anchors for writable matches. Respects .gitignore.",
-		promptSnippet: "Search file contents and return editable hashline anchors",
-		parameters: GrepParamsSchema,
-		executionMode: "parallel",
-		execute: async (_toolCallId, params, signal, _onUpdate, context) => {
-			return tagGrepResult(await runRipgrep({
-				params,
-				cwd: context.cwd,
-				signal
-			}), params, context.cwd, signal);
-		}
-	};
-}
-/** Node adapters for hashline post-processing. */
-const nodeGrepFileSystem = {
-	stat: (path) => (0, node_fs_promises.stat)(path),
-	readFile: (path) => (0, node_fs_promises.readFile)(path)
-};
-const defaultGrepOutput = {
-	maxBytes: _earendil_works_pi_coding_agent.DEFAULT_MAX_BYTES,
-	formatSize: _earendil_works_pi_coding_agent.formatSize,
-	truncateHead: _earendil_works_pi_coding_agent.truncateHead,
-	truncateLine: _earendil_works_pi_coding_agent.truncateLine
-};
-async function tagGrepResult(nativeResult, params, cwd, signal, writable = _agimon_ai_po_hashline_files.isWritableFile, filesystem = nodeGrepFileSystem, outputOperations = defaultGrepOutput) {
-	const textPart = nativeResult.content.find((part) => part.type === "text");
-	if (!textPart || textPart.text === NO_MATCHES) return nativeResult;
-	const noticeIndex = textPart.text.lastIndexOf("\n\n[");
-	const rowsText = noticeIndex === -1 ? textPart.text : textPart.text.slice(0, noticeIndex);
-	const notice = noticeIndex === -1 ? "" : textPart.text.slice(noticeIndex);
-	const searchPath = (0, _agimon_ai_po_hashline_files.resolveInputPath)(params.path ?? ".", cwd);
-	const searchStats = await filesystem.stat(searchPath);
-	assertNotAborted(signal);
-	const rows = await parseValidatedGrepRows(rowsText, searchPath, searchStats.isDirectory(), signal, filesystem);
-	if (rows.length === 0) return nativeResult;
-	const groups = groupGrepRows(rows, searchPath, searchStats.isDirectory(), cwd);
-	const blocks = [];
-	let taggedFiles = 0;
-	let linesTruncated = nativeResult.details?.linesTruncated ?? false;
-	for (const group of groups.values()) {
-		assertNotAborted(signal);
-		const canEdit = await writable(group.absolutePath);
-		assertNotAborted(signal);
-		if (!canEdit) {
-			blocks.push(group.nativeRows.join("\n"));
-			continue;
-		}
-		let bytes;
-		try {
-			bytes = await filesystem.readFile(group.absolutePath);
-		} catch {
-			blocks.push(group.nativeRows.join("\n"));
-			continue;
-		}
-		assertNotAborted(signal);
-		const lines = (0, _agimon_ai_po_hashline.splitLines)((0, _agimon_ai_po_hashline_files.decodeUtf8)(bytes, group.path));
-		const output = [(0, _agimon_ai_po_hashline.formatFileHeader)(group.path, (0, _agimon_ai_po_hashline_files.computeFileTag)(bytes))];
-		for (const [lineNumber, isMatch] of [...group.rows].sort(([left], [right]) => left - right)) {
-			const line = lines[lineNumber - 1];
-			if (line === void 0) continue;
-			const compact = outputOperations.truncateLine(line);
-			if (compact.wasTruncated) linesTruncated = true;
-			output.push((0, _agimon_ai_po_hashline.formatTaggedLine)(compact.text, lineNumber, isMatch ? ">> " : "   ", line));
-		}
-		if (output.length > 1) {
-			blocks.push(output.join("\n"));
-			taggedFiles++;
-		} else blocks.push(group.nativeRows.join("\n"));
-	}
-	if (blocks.length === 0 || taggedFiles === 0) return nativeResult;
-	const truncation = outputOperations.truncateHead(blocks.join("\n"), { maxLines: Number.MAX_SAFE_INTEGER });
-	const extraNotice = truncation.truncated ? `\n\n[${outputOperations.formatSize(outputOperations.maxBytes)} tagged output limit reached]` : "";
-	const details = {
-		...nativeResult.details,
-		...truncation.truncated ? { truncation } : {},
-		...linesTruncated ? { linesTruncated: true } : {}
-	};
-	assertNotAborted(signal);
-	return {
-		...nativeResult,
-		content: [{
-			type: "text",
-			text: `${truncation.content}${notice}${extraNotice}`
-		}],
-		details: Object.keys(details).length > 0 ? details : void 0
-	};
-}
-function groupGrepRows(rows, searchPath, directory, cwd) {
-	const groups = /* @__PURE__ */ new Map();
-	for (const row of rows) {
-		const absolutePath = directory ? (0, node_path.resolve)(searchPath, row.path) : searchPath;
-		let group = groups.get(absolutePath);
-		if (!group) {
-			group = {
-				path: (0, _agimon_ai_po_hashline_files.displayPath)(absolutePath, cwd),
-				absolutePath,
-				nativeRows: [],
-				rows: /* @__PURE__ */ new Map()
-			};
-			groups.set(absolutePath, group);
-		}
-		if (row.native !== void 0) group.nativeRows.push(row.native);
-		group.rows.set(row.line, row.match || group.rows.get(row.line) === true);
-	}
-	return groups;
-}
-async function parseValidatedGrepRows(rowsText, searchPath, directory, signal, filesystem) {
-	const pathCache = /* @__PURE__ */ new Map();
-	const rows = [];
-	for (const value of rowsText.split("\n")) {
-		assertNotAborted(signal);
-		let resolvedCandidate;
-		for (const candidate of grepRowCandidates(value)) {
-			if (!directory) {
-				if (candidate.path === (0, node_path.basename)(searchPath) || candidate.path === searchPath) {
-					rows.push({
-						...candidate,
-						native: value
-					});
-					break;
-				}
-				continue;
-			}
-			const absolutePath = (0, node_path.resolve)(searchPath, candidate.path);
-			let exists = pathCache.get(absolutePath);
-			if (exists === void 0) {
-				exists = await filesystem.stat(absolutePath).then((value) => value.isFile()).catch(() => false);
-				assertNotAborted(signal);
-				pathCache.set(absolutePath, exists);
-			}
-			if (exists) resolvedCandidate = {
-				...candidate,
-				native: value
-			};
-		}
-		if (resolvedCandidate) rows.push(resolvedCandidate);
-	}
-	return rows;
-}
-function grepRowCandidates(value) {
-	const candidates = [];
-	for (const match of value.matchAll(MATCH_DELIMITER)) candidates.push({
-		index: match.index,
-		row: {
-			path: value.slice(0, match.index),
-			line: Number.parseInt(match[1] ?? "", 10),
-			match: true
-		}
-	});
-	for (const match of value.matchAll(CONTEXT_DELIMITER)) candidates.push({
-		index: match.index,
-		row: {
-			path: value.slice(0, match.index),
-			line: Number.parseInt(match[1] ?? "", 10),
-			match: false
-		}
-	});
-	return candidates.sort((left, right) => left.index - right.index).map(({ row }) => row);
-}
-function assertNotAborted(signal) {
-	if (signal?.aborted) throw new Error("Operation aborted");
-}
-//#endregion
-//#region src/extensions/workspaces/sessions/(backend)/tool/grep.mcp.ts
-var grep_mcp_default = (0, _agimon_ai_po_core_mcpFacet.defineMcpTool)(() => ({
-	...createHeadlessGrepTool(),
-	description: "Search file contents in the Po session's repository on the host machine (ripgrep, regex or literal, code search). Respects .gitignore. Matches include file hashes and line anchors for this server's edit tool."
-}));
-//#endregion
-//#region generated/mcp.ts
-const at = (value, context) => typeof value === "function" ? value(context) : value;
-const via = (identity, value) => value === void 0 ? void 0 : {
-	...identity,
-	...value
-};
-const withWidget = (key, value) => value === void 0 ? value : {
-	...value,
-	_meta: {
-		...value._meta,
-		["po/widget"]: key
-	}
-};
-const mcp = (0, _agimon_ai_po_core_mcpFacet.defineMcpPlugin)({
-	name: "@agimon-ai/po-grep",
-	session: (context) => ({ get tools() {
-		return [withWidget("@agimon-ai/po-grep/grep", via({ name: "grep" }, at(grep_mcp_default, context)))];
-	} })
-});
-//#endregion
-exports.default = mcp;
-exports.mcp = mcp;
-
-//# sourceMappingURL=mcp.cjs.map