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

package/dist/extensions/server.cjs

@@ -0,0 +1,26 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_readTool = require("../readTool-DjM6DFYl.cjs");
+let _agimon_ai_po_core_serverFacet = require("@agimon-ai/po-core/serverFacet");
+//#region src/extensions/workspaces/sessions/(backend)/tool/read.server.ts
+var read_server_default = (0, require("@agimon-ai/po-core/extensionFile").defineServerTool)(require_readTool.createHeadlessReadTool);
+//#endregion
+//#region generated/server.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const via = (identity, value) => value === void 0 ? void 0 : {
+	...identity,
+	...value
+};
+const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
+	name: "@agimon-ai/po-read",
+	session: (context) => ({ get tools() {
+		return [via({ name: "read" }, at(read_server_default, context))];
+	} })
+});
+//#endregion
+exports.default = facet;
+exports.facet = facet;
+
+//# sourceMappingURL=server.cjs.map

package/dist/extensions/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.cjs","names":["defineServerTool","createHeadlessReadTool","defineServerPlugin","toolRead"],"sources":["../../src/extensions/workspaces/sessions/(backend)/tool/read.server.ts","../../generated/server.ts"],"sourcesContent":["import { defineServerTool } from '@agimon-ai/po-core/extensionFile';\n\nimport { createHeadlessReadTool } from '../../../../../services/readTool';\n\nexport default defineServerTool(createHeadlessReadTool);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nimport toolRead from '../src/extensions/workspaces/sessions/(backend)/tool/read.server';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nexport const facet = defineServerPlugin({\n  name: '@agimon-ai/po-read',\n  session: (context) => ({\n    get tools(): DoomServerSessionPlugin['tools'] { return [via({ name: 'read' }, at(toolRead, context))]; },\n  }),\n});\n\nexport default facet;\n"],"mappings":";;;;;;;AAIA,IAAA,uBAAA,6CAAeA,CAAAA,CAAAA,iBAAAA,CAAiBC,iBAAAA,sBAAsB;;;ACEtD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AACpE,MAAM,OAAU,UAAmC,UAChD,UAAU,KAAA,IAAY,KAAA,IAAY;CAAE,GAAG;CAAU,GAAI;AAAiB;AAEzE,MAAa,SAAA,GAAQC,+BAAAA,mBAAAA,CAAmB;CACtC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,QAA0C;EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,OAAO,GAAG,GAAGC,qBAAU,OAAO,CAAC,CAAC;CAAG,EACzG;AACF,CAAC"}

package/dist/extensions/server.d.mts

@@ -0,0 +1,5 @@
+//#region generated/server.d.ts
+export declare const facet: import("@agimon-ai/po-core/serverFacet").DoomServerFacet;
+//#endregion
+export { facet as default };
+//# sourceMappingURL=server.d.mts.map

package/dist/extensions/server.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.mts","names":[],"sources":["../../generated/server.ts"],"mappings":";qBAWa,gDAAK"}

package/dist/extensions/server.mjs

@@ -0,0 +1,22 @@
+import { t as createHeadlessReadTool } from "../readTool-epk_n4AS.mjs";
+import { defineServerPlugin } from "@agimon-ai/po-core/serverFacet";
+import { defineServerTool } from "@agimon-ai/po-core/extensionFile";
+//#region src/extensions/workspaces/sessions/(backend)/tool/read.server.ts
+var read_server_default = defineServerTool(createHeadlessReadTool);
+//#endregion
+//#region generated/server.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const via = (identity, value) => value === void 0 ? void 0 : {
+	...identity,
+	...value
+};
+const facet = defineServerPlugin({
+	name: "@agimon-ai/po-read",
+	session: (context) => ({ get tools() {
+		return [via({ name: "read" }, at(read_server_default, context))];
+	} })
+});
+//#endregion
+export { facet as default, facet };
+
+//# sourceMappingURL=server.mjs.map

package/dist/extensions/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.mjs","names":["toolRead"],"sources":["../../src/extensions/workspaces/sessions/(backend)/tool/read.server.ts","../../generated/server.ts"],"sourcesContent":["import { defineServerTool } from '@agimon-ai/po-core/extensionFile';\n\nimport { createHeadlessReadTool } from '../../../../../services/readTool';\n\nexport default defineServerTool(createHeadlessReadTool);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nimport toolRead from '../src/extensions/workspaces/sessions/(backend)/tool/read.server';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nexport const facet = defineServerPlugin({\n  name: '@agimon-ai/po-read',\n  session: (context) => ({\n    get tools(): DoomServerSessionPlugin['tools'] { return [via({ name: 'read' }, at(toolRead, context))]; },\n  }),\n});\n\nexport default facet;\n"],"mappings":";;;;AAIA,IAAA,sBAAe,iBAAiB,sBAAsB;;;ACEtD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AACpE,MAAM,OAAU,UAAmC,UAChD,UAAU,KAAA,IAAY,KAAA,IAAY;CAAE,GAAG;CAAU,GAAI;AAAiB;AAEzE,MAAa,QAAQ,mBAAmB;CACtC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,QAA0C;EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,OAAO,GAAG,GAAGA,qBAAU,OAAO,CAAC,CAAC;CAAG,EACzG;AACF,CAAC"}

package/dist/extensions/web.mjs

@@ -0,0 +1,134 @@
+import { defineToolRenderer, defineWebPlugin } from "@agimon-ai/po-core/web";
+import { HashlineLines, MessageItem, MessageItemBody, MessageItemHeader, MessageItemStatus, ToolPathLink, compactDetails, hashlineBody, resultTextLines, toolTone } from "@agimon-ai/po-web-components";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+//#region src/extensions/workspaces/sessions/(frontend)/tool/_lib/readToolView.ts
+function optionalNumber(value) {
+	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+/** What the read call heading shows: the path, then the offset and limit when given. */
+function readCallView(args) {
+	const offset = optionalNumber(args.offset);
+	const limit = optionalNumber(args.limit);
+	return {
+		path: typeof args.path === "string" ? args.path : "",
+		details: compactDetails([offset === void 0 ? void 0 : `from ${offset}`, limit === void 0 ? void 0 : `${limit} lines`])
+	};
+}
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/tool/_components/ReadToolMessage.tsx
+const IMAGE_MIME_TYPES = /* @__PURE__ */ new Set([
+	"image/png",
+	"image/jpeg",
+	"image/gif",
+	"image/webp"
+]);
+function resultImages(content) {
+	return content.flatMap((block) => {
+		if (typeof block !== "object" || block === null || Array.isArray(block)) return [];
+		const value = block;
+		return value.type === "image" && typeof value.data === "string" && typeof value.mimeType === "string" && IMAGE_MIME_TYPES.has(value.mimeType) ? [{
+			data: value.data,
+			mimeType: value.mimeType
+		}] : [];
+	});
+}
+/**
+* The read tool's timeline item, the web half of its renderCall and
+* renderResult: the call summary in the header and, when expanded, the
+* anchored lines with a line-number gutter in the body. A failure shows the
+* tool's message in red inside the expanded body instead.
+*/
+function ReadToolMessage({ args, result, output, running, isError, fileTabFor, openTransientTab }) {
+	const view = readCallView(args);
+	const images = resultImages(result?.content ?? []);
+	const tab = fileTabFor(view.path);
+	const body = result === null || isError ? null : hashlineBody(result, output, "read", true);
+	return /* @__PURE__ */ jsx(MessageItem, {
+		tone: toolTone({
+			running,
+			isError
+		}),
+		expandable: true,
+		defaultExpanded: false,
+		children: ({ expanded }) => {
+			return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(MessageItemHeader, {
+				title: "read",
+				children: /* @__PURE__ */ jsxs("span", {
+					"data-testid": "tool-call-read",
+					className: "flex min-w-0 flex-1 items-center gap-2",
+					children: [/* @__PURE__ */ jsx(ToolPathLink, {
+						path: view.path,
+						...tab === void 0 ? {} : { onOpen: () => openTransientTab(tab) }
+					}), view.details.length > 0 ? /* @__PURE__ */ jsxs("span", {
+						className: "shrink-0 text-doom-faint",
+						children: ["· ", view.details.join(" · ")]
+					}) : null]
+				})
+			}), expanded ? isError ? /* @__PURE__ */ jsxs(MessageItemBody, {
+				"data-testid": "tool-result-read",
+				className: "flex flex-col",
+				children: [/* @__PURE__ */ jsx(MessageItemStatus, {
+					tone: "error",
+					children: "failed"
+				}), resultTextLines(result, output).map((line, index) => /* @__PURE__ */ jsx("span", {
+					className: "whitespace-pre-wrap break-words text-doom-red",
+					children: line
+				}, `${String(index)}-${line}`))]
+			}) : body === null ? running ? /* @__PURE__ */ jsx(MessageItemBody, {
+				"data-testid": "tool-result-read",
+				children: /* @__PURE__ */ jsx(MessageItemStatus, {
+					tone: "running",
+					children: "running"
+				})
+			}) : null : body.shown.length === 0 && body.notice === void 0 && images.length === 0 ? null : /* @__PURE__ */ jsxs(MessageItemBody, {
+				"data-testid": "tool-result-read",
+				className: "flex flex-col gap-1",
+				children: [
+					/* @__PURE__ */ jsx(HashlineLines, {
+						lines: body.shown,
+						gutter: body.gutter,
+						path: view.path
+					}),
+					images.map((image, index) => {
+						const url = `data:${image.mimeType};base64,${image.data}`;
+						return /* @__PURE__ */ jsx("a", {
+							href: url,
+							target: "_blank",
+							rel: "noreferrer",
+							className: "self-start",
+							children: /* @__PURE__ */ jsx("img", {
+								src: url,
+								alt: `Read result ${String(index + 1)}`,
+								"data-testid": "tool-result-read-image",
+								className: "h-auto max-h-96 max-w-full rounded-md border border-doom-border-soft object-contain"
+							})
+						}, `${image.mimeType}:${String(index)}`);
+					}),
+					body.notice !== void 0 ? /* @__PURE__ */ jsx("span", {
+						className: "text-doom-faint",
+						children: body.notice
+					}) : null
+				]
+			}) : null] });
+		}
+	});
+}
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/tool/read.web.tsx
+var read_web_default = defineToolRenderer({ message: ReadToolMessage });
+//#endregion
+//#region generated/web.ts
+const via = (identity, value) => value === void 0 ? void 0 : {
+	...identity,
+	...value
+};
+const webPlugin = defineWebPlugin({
+	id: "read",
+	session: { get toolRenderers() {
+		return [via({ tools: ["read"] }, read_web_default)];
+	} }
+});
+//#endregion
+export { webPlugin };
+
+//# sourceMappingURL=web.mjs.map

package/dist/extensions/web.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.mjs","names":["toolRead"],"sources":["../../src/extensions/workspaces/sessions/(frontend)/tool/_lib/readToolView.ts","../../src/extensions/workspaces/sessions/(frontend)/tool/_components/ReadToolMessage.tsx","../../src/extensions/workspaces/sessions/(frontend)/tool/read.web.tsx","../../generated/web.ts"],"sourcesContent":["import { compactDetails } from '@agimon-ai/po-web-components';\n\nexport interface ReadCallView {\n  readonly path: string;\n  /** `from N` and `N lines`, as the TUI's call heading lists them. */\n  readonly details: readonly string[];\n}\n\nfunction optionalNumber(value: unknown): number | undefined {\n  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;\n}\n\n/** What the read call heading shows: the path, then the offset and limit when given. */\nexport function readCallView(args: Readonly<Record<string, unknown>>): ReadCallView {\n  const offset = optionalNumber(args.offset);\n  const limit = optionalNumber(args.limit);\n  return {\n    path: typeof args.path === 'string' ? args.path : '',\n    details: compactDetails([\n      offset === undefined ? undefined : `from ${offset}`,\n      limit === undefined ? undefined : `${limit} lines`,\n    ]),\n  };\n}\n","import type { ToolMessageRenderProps } from '@agimon-ai/po-core/web';\nimport {\n  HashlineLines,\n  hashlineBody,\n  MessageItem,\n  MessageItemBody,\n  MessageItemHeader,\n  MessageItemStatus,\n  resultTextLines,\n  ToolPathLink,\n  toolTone,\n} from '@agimon-ai/po-web-components';\n\nimport { readCallView } from '../_lib/readToolView';\n\nconst IMAGE_MIME_TYPES = new Set(['image/png', 'image/jpeg', 'image/gif', 'image/webp']);\n\nfunction resultImages(content: readonly unknown[]): Array<{ data: string; mimeType: string }> {\n  return content.flatMap((block) => {\n    if (typeof block !== 'object' || block === null || Array.isArray(block)) return [];\n    const value = block as Record<string, unknown>;\n    return value.type === 'image' &&\n      typeof value.data === 'string' &&\n      typeof value.mimeType === 'string' &&\n      IMAGE_MIME_TYPES.has(value.mimeType)\n      ? [{ data: value.data, mimeType: value.mimeType }]\n      : [];\n  });\n}\n/**\n * The read tool's timeline item, the web half of its renderCall and\n * renderResult: the call summary in the header and, when expanded, the\n * anchored lines with a line-number gutter in the body. A failure shows the\n * tool's message in red inside the expanded body instead.\n */\nexport function ReadToolMessage({\n  args,\n  result,\n  output,\n  running,\n  isError,\n  fileTabFor,\n  openTransientTab,\n}: ToolMessageRenderProps) {\n  const view = readCallView(args);\n  const images = resultImages(result?.content ?? []);\n  // A read is the one call whose file the session usually has not changed, so\n  // this is the link that opens it read-only rather than in its history.\n  const tab = fileTabFor(view.path);\n  const body = result === null || isError ? null : hashlineBody(result, output, 'read', true);\n  return (\n    <MessageItem tone={toolTone({ running, isError })} expandable defaultExpanded={false}>\n      {({ expanded }) => {\n        return (\n          <>\n            <MessageItemHeader title=\"read\">\n              <span data-testid=\"tool-call-read\" className=\"flex min-w-0 flex-1 items-center gap-2\">\n                <ToolPathLink\n                  path={view.path}\n                  {...(tab === undefined ? {} : { onOpen: () => openTransientTab(tab) })}\n                />\n                {view.details.length > 0 ? (\n                  <span className=\"shrink-0 text-doom-faint\">· {view.details.join(' · ')}</span>\n                ) : null}\n              </span>\n            </MessageItemHeader>\n            {expanded ? (\n              isError ? (\n                <MessageItemBody data-testid=\"tool-result-read\" className=\"flex flex-col\">\n                  <MessageItemStatus tone=\"error\">failed</MessageItemStatus>\n                  {resultTextLines(result, output).map((line, index) => (\n                    <span key={`${String(index)}-${line}`} className=\"whitespace-pre-wrap break-words text-doom-red\">\n                      {line}\n                    </span>\n                  ))}\n                </MessageItemBody>\n              ) : body === null ? (\n                running ? (\n                  <MessageItemBody data-testid=\"tool-result-read\">\n                    <MessageItemStatus tone=\"running\">running</MessageItemStatus>\n                  </MessageItemBody>\n                ) : null\n              ) : body.shown.length === 0 && body.notice === undefined && images.length === 0 ? null : (\n                <MessageItemBody data-testid=\"tool-result-read\" className=\"flex flex-col gap-1\">\n                  {/* A read body is one file with no heading of its own, so the\n                      call's path is what names the grammar for it. */}\n                  <HashlineLines lines={body.shown} gutter={body.gutter} path={view.path} />\n                  {images.map((image, index) => {\n                    const url = `data:${image.mimeType};base64,${image.data}`;\n                    return (\n                      <a\n                        key={`${image.mimeType}:${String(index)}`}\n                        href={url}\n                        target=\"_blank\"\n                        rel=\"noreferrer\"\n                        className=\"self-start\"\n                      >\n                        <img\n                          src={url}\n                          alt={`Read result ${String(index + 1)}`}\n                          data-testid=\"tool-result-read-image\"\n                          className=\"h-auto max-h-96 max-w-full rounded-md border border-doom-border-soft object-contain\"\n                        />\n                      </a>\n                    );\n                  })}\n                  {body.notice !== undefined ? <span className=\"text-doom-faint\">{body.notice}</span> : null}\n                </MessageItemBody>\n              )\n            ) : null}\n          </>\n        );\n      }}\n    </MessageItem>\n  );\n}\n","import { defineToolRenderer } from '@agimon-ai/po-core/web';\n\nimport { ReadToolMessage } from './_components/ReadToolMessage';\n\nexport default defineToolRenderer({ message: ReadToolMessage });\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineWebPlugin, type WebPluginContributions } from '@agimon-ai/po-core/web';\n\nimport toolRead from '../src/extensions/workspaces/sessions/(frontend)/tool/read.web';\n\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nexport const webPlugin = defineWebPlugin({\n  id: 'read',\n  session: {\n    get toolRenderers(): WebPluginContributions['toolRenderers'] { return [via({ tools: ['read'] }, toolRead)]; },\n  },\n});\n"],"mappings":"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"}

package/dist/index.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_readTool = require("./readTool-DjM6DFYl.cjs");
+exports.ReadParamsSchema = require_readTool.ReadParamsSchema;
+exports.createHeadlessReadTool = require_readTool.createHeadlessReadTool;
+exports.executeHeadlessRead = require_readTool.executeHeadlessRead;

package/dist/index.d.mts

@@ -0,0 +1,34 @@
+import { ReadToolDetails } from "@earendil-works/pi-coding-agent";
+import { Static, Type } from "typebox";
+import "@agimon-ai/po-config/piConfig";
+import { DoomHeadlessTool } from "@agimon-ai/po-core/headless";
+//#region src/schemas/readTool.d.ts
+export declare const ReadParamsSchema: Type.TObject<{
+  path: Type.TString;
+  offset: Type.TOptional<Type.TInteger>;
+  limit: Type.TOptional<Type.TInteger>;
+}>;
+type ReadParams = Static<typeof ReadParamsSchema>;
+//#endregion
+//#region src/services/readImage/index.d.ts
+interface ReadTextPart {
+  type: 'text';
+  text: string;
+}
+interface ReadImagePart {
+  type: 'image';
+  data: string;
+  mimeType: string;
+}
+type ReadContentPart = ReadTextPart | ReadImagePart;
+//#endregion
+//#region src/services/readTool/index.d.ts
+interface ReadToolResult {
+  content: ReadContentPart[];
+  details?: ReadToolDetails;
+}
+export declare function executeHeadlessRead(params: ReadParams, cwd: string, signal: AbortSignal | undefined): Promise<ReadToolResult>;
+export declare function createHeadlessReadTool(): DoomHeadlessTool<typeof ReadParamsSchema>;
+//#endregion
+export type { ReadParams };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/schemas/readTool.ts","../src/services/readImage/index.ts","../src/services/readTool/index.ts"],"mappings":";;;;;qBAEa,kBAAgB,KAAA;;;;;KAMjB,aAAa,cAAc;;;UCJtB;EACf;EACA;;UAGe;EACf;EACA;EACA;;KAGU,kBAAkB,eAAe;;;UCwB5B;EACf,SAAS;EACT,UAAU;;wBA0BU,oBACpB,QAAQ,YACR,aACA,QAAQ,0BACP,QAAQ;wBAkEK,0BAA0B,wBAAwB"}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { n as executeHeadlessRead, r as ReadParamsSchema, t as createHeadlessReadTool } from "./readTool-epk_n4AS.mjs";
+export { ReadParamsSchema, createHeadlessReadTool, executeHeadlessRead };

package/dist/readTool-DjM6DFYl.cjs

@@ -0,0 +1,169 @@
+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");
+let _agimon_ai_po_config_piConfig = require("@agimon-ai/po-config/piConfig");
+//#region src/schemas/readTool.ts
+const ReadParamsSchema = typebox.Type.Object({
+	path: typebox.Type.String({ description: "Path to the file to read." }),
+	offset: typebox.Type.Optional(typebox.Type.Integer({
+		minimum: 1,
+		description: "One-based line offset."
+	})),
+	limit: typebox.Type.Optional(typebox.Type.Integer({
+		minimum: 1,
+		description: "Maximum number of lines to return."
+	}))
+});
+//#endregion
+//#region src/services/readImage/index.ts
+const OMITTED_NOTE = "[Image omitted: could not be resized below the inline image size limit.]";
+function imageLimits() {
+	return (0, _agimon_ai_po_config_piConfig.loadPiImageSettings)();
+}
+async function applyImageLimits(content, limits, operations) {
+	if (!limits.autoResize || !content.some((part) => part.type === "image")) return content;
+	const resolved = [];
+	for (const part of content) {
+		if (part.type !== "image") {
+			resolved.push(part);
+			continue;
+		}
+		const resized = await operations.resize(Buffer.from(part.data, "base64"), part.mimeType, {
+			maxWidth: limits.maxDimension,
+			maxHeight: limits.maxDimension
+		});
+		if (!resized) {
+			resolved.push({
+				type: "text",
+				text: OMITTED_NOTE
+			});
+			continue;
+		}
+		resolved.push({
+			type: "image",
+			data: resized.data,
+			mimeType: resized.mimeType
+		});
+		const note = operations.formatDimensionNote(resized);
+		if (note) resolved.push({
+			type: "text",
+			text: note
+		});
+	}
+	return resolved;
+}
+//#endregion
+//#region src/services/readTool/index.ts
+const resizeOperations = {
+	resize: _earendil_works_pi_coding_agent.resizeImage,
+	formatDimensionNote: (result) => (0, _earendil_works_pi_coding_agent.formatDimensionNote)(result)
+};
+function assertNotAborted(signal) {
+	if (signal?.aborted) throw new Error("Operation aborted");
+}
+function isImagePath(filePath) {
+	const extension = filePath.toLowerCase().match(/\.([a-z0-9]+)$/u)?.[1];
+	if (!extension) return void 0;
+	return {
+		avif: "image/avif",
+		gif: "image/gif",
+		jpeg: "image/jpeg",
+		jpg: "image/jpeg",
+		png: "image/png",
+		webp: "image/webp"
+	}[extension];
+}
+async function executeHeadlessRead(params, cwd, signal) {
+	assertNotAborted(signal);
+	const absolutePath = await (0, _agimon_ai_po_hashline_files.resolveReadInputPath)(params.path, cwd);
+	const bytes = await (0, node_fs_promises.readFile)(absolutePath);
+	assertNotAborted(signal);
+	const mimeType = isImagePath(absolutePath);
+	if (mimeType) return { content: await applyImageLimits([{
+		type: "text",
+		text: `Read image file ${(0, _agimon_ai_po_hashline_files.displayPath)(absolutePath, cwd)} [${mimeType}]`
+	}, {
+		type: "image",
+		data: bytes.toString("base64"),
+		mimeType
+	}], imageLimits(), resizeOperations) };
+	if (!await (0, _agimon_ai_po_hashline_files.isWritableFile)(absolutePath)) return { content: [{
+		type: "text",
+		text: (0, _agimon_ai_po_hashline_files.decodeUtf8)(bytes, (0, _agimon_ai_po_hashline_files.displayPath)(absolutePath, cwd))
+	}] };
+	return createTaggedReadResult(bytes, (0, _agimon_ai_po_hashline_files.displayPath)(absolutePath, cwd), params);
+}
+function createTaggedReadResult(bytes, path, params) {
+	const lines = (0, _agimon_ai_po_hashline.splitLines)((0, _agimon_ai_po_hashline_files.decodeUtf8)(bytes, path));
+	const startIndex = params.offset === void 0 ? 0 : params.offset - 1;
+	if (startIndex >= lines.length) throw new Error(`Offset ${params.offset} is beyond end of file (${lines.length} lines total).`);
+	const endIndex = params.limit === void 0 ? lines.length : Math.min(lines.length, startIndex + params.limit);
+	const selected = lines.slice(startIndex, endIndex);
+	const header = (0, _agimon_ai_po_hashline.formatFileHeader)(path, (0, _agimon_ai_po_hashline_files.computeFileTag)(bytes));
+	const compactedLines = [];
+	const headerBytes = Buffer.byteLength(header, "utf8") + 1;
+	const tagged = selected.map((line, index) => {
+		const lineNumber = startIndex + index + 1;
+		const full = (0, _agimon_ai_po_hashline.formatTaggedLine)(line, lineNumber);
+		if (Buffer.byteLength(full, "utf8") <= _earendil_works_pi_coding_agent.DEFAULT_MAX_BYTES - headerBytes) return full;
+		compactedLines.push(lineNumber);
+		return (0, _agimon_ai_po_hashline.formatTaggedLine)((0, _earendil_works_pi_coding_agent.truncateLine)(line).text, lineNumber, "", line);
+	});
+	const truncation = (0, _earendil_works_pi_coding_agent.truncateHead)([header, ...tagged].join("\n"));
+	let text = truncation.content;
+	let details;
+	if (truncation.truncated) {
+		const shownLines = Math.max(0, truncation.outputLines - 1);
+		const nextOffset = startIndex + shownLines + 1;
+		const reason = truncation.truncatedBy === "bytes" ? `, ${(0, _earendil_works_pi_coding_agent.formatSize)(_earendil_works_pi_coding_agent.DEFAULT_MAX_BYTES)} limit` : "";
+		text += `\n\n[Showing ${shownLines} anchored lines${reason}. Use offset=${nextOffset} to continue.]`;
+		details = { truncation };
+	} else {
+		const notices = [];
+		if (compactedLines.length > 0) notices.push(`Lines ${compactedLines.join(", ")} shown compactly. Their anchors hash the full original lines`);
+		if (endIndex < lines.length) notices.push(`${lines.length - endIndex} more lines in file. Use offset=${endIndex + 1} to continue`);
+		if (notices.length > 0) text += `\n\n[${notices.join(". ")}.]`;
+	}
+	return {
+		content: [{
+			type: "text",
+			text
+		}],
+		details
+	};
+}
+function createHeadlessReadTool() {
+	return {
+		name: "read",
+		label: "read",
+		description: "Read a writable text file with an exact-byte file tag and stable line anchors. Non-writable files and images return native-compatible content. Text is truncated to 50.0KB.",
+		promptSnippet: "Read file contents with snapshot-bound line anchors",
+		promptGuidelines: ["Use read before edit. When hashline metadata is present, preserve the @file hash and anchors such as 5#abc exactly.", "Continue large reads with offset until the required anchored lines are visible."],
+		parameters: ReadParamsSchema,
+		executionMode: "parallel",
+		execute: async (_toolCallId, params, signal, _onUpdate, context) => executeHeadlessRead(params, context.cwd, signal)
+	};
+}
+//#endregion
+Object.defineProperty(exports, "ReadParamsSchema", {
+	enumerable: true,
+	get: function() {
+		return ReadParamsSchema;
+	}
+});
+Object.defineProperty(exports, "createHeadlessReadTool", {
+	enumerable: true,
+	get: function() {
+		return createHeadlessReadTool;
+	}
+});
+Object.defineProperty(exports, "executeHeadlessRead", {
+	enumerable: true,
+	get: function() {
+		return executeHeadlessRead;
+	}
+});
+
+//# sourceMappingURL=readTool-DjM6DFYl.cjs.map

package/dist/readTool-DjM6DFYl.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"readTool-DjM6DFYl.cjs","names":["Type","loadPiImageSettings","resizeImage","formatDimensionNote","resolveReadInputPath","readFile","displayPath","isWritableFile","decodeUtf8","splitLines","formatFileHeader","computeFileTag","formatTaggedLine","DEFAULT_MAX_BYTES","truncateLine","truncateHead","formatSize"],"sources":["../src/schemas/readTool.ts","../src/services/readImage/index.ts","../src/services/readTool/index.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const ReadParamsSchema = Type.Object({\n  path: Type.String({ description: 'Path to the file to read.' }),\n  offset: Type.Optional(Type.Integer({ minimum: 1, description: 'One-based line offset.' })),\n  limit: Type.Optional(Type.Integer({ minimum: 1, description: 'Maximum number of lines to return.' })),\n});\n\nexport type ReadParams = Static<typeof ReadParamsSchema>;\n","import { loadPiImageSettings, type PiImageSettings } from '@agimon-ai/po-config/piConfig';\n\nconst OMITTED_NOTE = '[Image omitted: could not be resized below the inline image size limit.]';\n\nexport interface ReadTextPart {\n  type: 'text';\n  text: string;\n}\n\nexport interface ReadImagePart {\n  type: 'image';\n  data: string;\n  mimeType: string;\n}\n\nexport type ReadContentPart = ReadTextPart | ReadImagePart;\n\nexport interface ReadImageResizeResult {\n  readonly data: string;\n  readonly mimeType: string;\n  readonly originalWidth: number;\n  readonly originalHeight: number;\n  readonly width: number;\n  readonly height: number;\n  readonly wasResized: boolean;\n}\n\nexport interface ReadImageResizeOperations {\n  resize(\n    inputBytes: Uint8Array,\n    mimeType: string,\n    options: { readonly maxWidth: number; readonly maxHeight: number },\n  ): Promise<ReadImageResizeResult | null>;\n  formatDimensionNote(result: ReadImageResizeResult): string | undefined;\n}\n\nexport function imageLimits(): PiImageSettings {\n  return loadPiImageSettings();\n}\n\nexport async function applyImageLimits(\n  content: ReadContentPart[],\n  limits: PiImageSettings,\n  operations: ReadImageResizeOperations,\n): Promise<ReadContentPart[]> {\n  if (!limits.autoResize || !content.some((part) => part.type === 'image')) return content;\n  const resolved: ReadContentPart[] = [];\n  for (const part of content) {\n    if (part.type !== 'image') {\n      resolved.push(part);\n      continue;\n    }\n    const resized = await operations.resize(Buffer.from(part.data, 'base64'), part.mimeType, {\n      maxWidth: limits.maxDimension,\n      maxHeight: limits.maxDimension,\n    });\n    if (!resized) {\n      resolved.push({ type: 'text', text: OMITTED_NOTE });\n      continue;\n    }\n    resolved.push({ type: 'image', data: resized.data, mimeType: resized.mimeType });\n    const note = operations.formatDimensionNote(resized);\n    if (note) resolved.push({ type: 'text', text: note });\n  }\n  return resolved;\n}\n","import { readFile } from 'node:fs/promises';\n\nimport type {\n  DoomHeadlessExecutionContext,\n  DoomHeadlessTool,\n  DoomHeadlessToolResult,\n} from '@agimon-ai/po-core/headless';\nimport { formatFileHeader, formatTaggedLine, splitLines } from '@agimon-ai/po-hashline';\nimport {\n  computeFileTag,\n  decodeUtf8,\n  displayPath,\n  isWritableFile,\n  resolveReadInputPath,\n} from '@agimon-ai/po-hashline/files';\nimport {\n  DEFAULT_MAX_BYTES,\n  formatDimensionNote,\n  formatSize,\n  resizeImage,\n  truncateHead,\n  truncateLine,\n  type ReadToolDetails,\n} from '@earendil-works/pi-coding-agent';\n\nimport { ReadParamsSchema, type ReadParams } from '../../schemas/readTool';\nimport {\n  applyImageLimits,\n  imageLimits,\n  type ReadContentPart,\n  type ReadImageResizeOperations,\n  type ReadTextPart,\n} from '../readImage';\n\nconst resizeOperations: ReadImageResizeOperations = {\n  resize: resizeImage,\n  formatDimensionNote: (result) => formatDimensionNote(result),\n};\n\nexport interface ReadToolResult {\n  content: ReadContentPart[];\n  details?: ReadToolDetails;\n}\n\ninterface ReadTextToolResult {\n  content: ReadTextPart[];\n  details?: ReadToolDetails;\n}\n\nexport function assertNotAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw new Error('Operation aborted');\n}\n\nexport function isImagePath(filePath: string): string | undefined {\n  const extension = filePath.toLowerCase().match(/\\.([a-z0-9]+)$/u)?.[1];\n  if (!extension) return undefined;\n  const mimeTypes: Record<string, string> = {\n    avif: 'image/avif',\n    gif: 'image/gif',\n    jpeg: 'image/jpeg',\n    jpg: 'image/jpeg',\n    png: 'image/png',\n    webp: 'image/webp',\n  };\n  return mimeTypes[extension];\n}\n\nexport async function executeHeadlessRead(\n  params: ReadParams,\n  cwd: string,\n  signal: AbortSignal | undefined,\n): Promise<ReadToolResult> {\n  assertNotAborted(signal);\n  const absolutePath = await resolveReadInputPath(params.path, cwd);\n  const bytes = await readFile(absolutePath);\n  assertNotAborted(signal);\n  const mimeType = isImagePath(absolutePath);\n  if (mimeType) {\n    const content: ReadContentPart[] = [\n      { type: 'text', text: `Read image file ${displayPath(absolutePath, cwd)} [${mimeType}]` },\n      { type: 'image', data: bytes.toString('base64'), mimeType },\n    ];\n    return { content: await applyImageLimits(content, imageLimits(), resizeOperations) };\n  }\n  if (!(await isWritableFile(absolutePath))) {\n    return { content: [{ type: 'text', text: decodeUtf8(bytes, displayPath(absolutePath, cwd)) }] };\n  }\n  return createTaggedReadResult(bytes, displayPath(absolutePath, cwd), params);\n}\n\nexport function createTaggedReadResult(bytes: Buffer, path: string, params: ReadParams): ReadTextToolResult {\n  const lines = splitLines(decodeUtf8(bytes, path));\n  const startIndex = params.offset === undefined ? 0 : params.offset - 1;\n  if (startIndex >= lines.length) {\n    throw new Error(`Offset ${params.offset} is beyond end of file (${lines.length} lines total).`);\n  }\n\n  const endIndex = params.limit === undefined ? lines.length : Math.min(lines.length, startIndex + params.limit);\n  const selected = lines.slice(startIndex, endIndex);\n  const header = formatFileHeader(path, computeFileTag(bytes));\n  const compactedLines: number[] = [];\n  const headerBytes = Buffer.byteLength(header, 'utf8') + 1;\n  const tagged = selected.map((line, index) => {\n    const lineNumber = startIndex + index + 1;\n    const full = formatTaggedLine(line, lineNumber);\n    if (Buffer.byteLength(full, 'utf8') <= DEFAULT_MAX_BYTES - headerBytes) return full;\n    compactedLines.push(lineNumber);\n    return formatTaggedLine(truncateLine(line).text, lineNumber, '', line);\n  });\n  const truncation = truncateHead([header, ...tagged].join('\\n'));\n  let text = truncation.content;\n  let details: ReadToolDetails | undefined;\n\n  if (truncation.truncated) {\n    const shownLines = Math.max(0, truncation.outputLines - 1);\n    const nextOffset = startIndex + shownLines + 1;\n    const reason = truncation.truncatedBy === 'bytes' ? `, ${formatSize(DEFAULT_MAX_BYTES)} limit` : '';\n    text += `\\n\\n[Showing ${shownLines} anchored lines${reason}. Use offset=${nextOffset} to continue.]`;\n    details = { truncation };\n  } else {\n    const notices: string[] = [];\n    if (compactedLines.length > 0) {\n      notices.push(`Lines ${compactedLines.join(', ')} shown compactly. Their anchors hash the full original lines`);\n    }\n    if (endIndex < lines.length) {\n      notices.push(`${lines.length - endIndex} more lines in file. Use offset=${endIndex + 1} to continue`);\n    }\n    if (notices.length > 0) text += `\\n\\n[${notices.join('. ')}.]`;\n  }\n\n  return { content: [{ type: 'text', text }], details };\n}\n\nexport function isImageRead(content: readonly { readonly type: string; readonly text?: string }[]): boolean {\n  return content.some((part) => part.type === 'image' || part.text?.startsWith('Read image file') === true);\n}\n\nexport function createHeadlessReadTool(): DoomHeadlessTool<typeof ReadParamsSchema> {\n  return {\n    name: 'read',\n    label: 'read',\n    description:\n      'Read a writable text file with an exact-byte file tag and stable line anchors. Non-writable files and images return native-compatible content. Text is truncated to 50.0KB.',\n    promptSnippet: 'Read file contents with snapshot-bound line anchors',\n    promptGuidelines: [\n      'Use read before edit. When hashline metadata is present, preserve the @file hash and anchors such as 5#abc exactly.',\n      'Continue large reads with offset until the required anchored lines are visible.',\n    ],\n    parameters: ReadParamsSchema,\n    executionMode: 'parallel',\n    execute: async (\n      _toolCallId: string,\n      params: ReadParams,\n      signal: AbortSignal | undefined,\n      _onUpdate: ((result: DoomHeadlessToolResult) => void) | undefined,\n      context: DoomHeadlessExecutionContext,\n    ) => executeHeadlessRead(params, context.cwd, signal),\n  };\n}\n"],"mappings":"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"}

package/dist/readTool-epk_n4AS.mjs

@@ -0,0 +1,152 @@
+import { readFile } from "node:fs/promises";
+import { formatFileHeader, formatTaggedLine, splitLines } from "@agimon-ai/po-hashline";
+import { computeFileTag, decodeUtf8, displayPath, isWritableFile, resolveReadInputPath } from "@agimon-ai/po-hashline/files";
+import { DEFAULT_MAX_BYTES, formatDimensionNote, formatSize, resizeImage, truncateHead, truncateLine } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+import { loadPiImageSettings } from "@agimon-ai/po-config/piConfig";
+//#region src/schemas/readTool.ts
+const ReadParamsSchema = Type.Object({
+	path: Type.String({ description: "Path to the file to read." }),
+	offset: Type.Optional(Type.Integer({
+		minimum: 1,
+		description: "One-based line offset."
+	})),
+	limit: Type.Optional(Type.Integer({
+		minimum: 1,
+		description: "Maximum number of lines to return."
+	}))
+});
+//#endregion
+//#region src/services/readImage/index.ts
+const OMITTED_NOTE = "[Image omitted: could not be resized below the inline image size limit.]";
+function imageLimits() {
+	return loadPiImageSettings();
+}
+async function applyImageLimits(content, limits, operations) {
+	if (!limits.autoResize || !content.some((part) => part.type === "image")) return content;
+	const resolved = [];
+	for (const part of content) {
+		if (part.type !== "image") {
+			resolved.push(part);
+			continue;
+		}
+		const resized = await operations.resize(Buffer.from(part.data, "base64"), part.mimeType, {
+			maxWidth: limits.maxDimension,
+			maxHeight: limits.maxDimension
+		});
+		if (!resized) {
+			resolved.push({
+				type: "text",
+				text: OMITTED_NOTE
+			});
+			continue;
+		}
+		resolved.push({
+			type: "image",
+			data: resized.data,
+			mimeType: resized.mimeType
+		});
+		const note = operations.formatDimensionNote(resized);
+		if (note) resolved.push({
+			type: "text",
+			text: note
+		});
+	}
+	return resolved;
+}
+//#endregion
+//#region src/services/readTool/index.ts
+const resizeOperations = {
+	resize: resizeImage,
+	formatDimensionNote: (result) => formatDimensionNote(result)
+};
+function assertNotAborted(signal) {
+	if (signal?.aborted) throw new Error("Operation aborted");
+}
+function isImagePath(filePath) {
+	const extension = filePath.toLowerCase().match(/\.([a-z0-9]+)$/u)?.[1];
+	if (!extension) return void 0;
+	return {
+		avif: "image/avif",
+		gif: "image/gif",
+		jpeg: "image/jpeg",
+		jpg: "image/jpeg",
+		png: "image/png",
+		webp: "image/webp"
+	}[extension];
+}
+async function executeHeadlessRead(params, cwd, signal) {
+	assertNotAborted(signal);
+	const absolutePath = await resolveReadInputPath(params.path, cwd);
+	const bytes = await readFile(absolutePath);
+	assertNotAborted(signal);
+	const mimeType = isImagePath(absolutePath);
+	if (mimeType) return { content: await applyImageLimits([{
+		type: "text",
+		text: `Read image file ${displayPath(absolutePath, cwd)} [${mimeType}]`
+	}, {
+		type: "image",
+		data: bytes.toString("base64"),
+		mimeType
+	}], imageLimits(), resizeOperations) };
+	if (!await isWritableFile(absolutePath)) return { content: [{
+		type: "text",
+		text: decodeUtf8(bytes, displayPath(absolutePath, cwd))
+	}] };
+	return createTaggedReadResult(bytes, displayPath(absolutePath, cwd), params);
+}
+function createTaggedReadResult(bytes, path, params) {
+	const lines = splitLines(decodeUtf8(bytes, path));
+	const startIndex = params.offset === void 0 ? 0 : params.offset - 1;
+	if (startIndex >= lines.length) throw new Error(`Offset ${params.offset} is beyond end of file (${lines.length} lines total).`);
+	const endIndex = params.limit === void 0 ? lines.length : Math.min(lines.length, startIndex + params.limit);
+	const selected = lines.slice(startIndex, endIndex);
+	const header = formatFileHeader(path, computeFileTag(bytes));
+	const compactedLines = [];
+	const headerBytes = Buffer.byteLength(header, "utf8") + 1;
+	const tagged = selected.map((line, index) => {
+		const lineNumber = startIndex + index + 1;
+		const full = formatTaggedLine(line, lineNumber);
+		if (Buffer.byteLength(full, "utf8") <= DEFAULT_MAX_BYTES - headerBytes) return full;
+		compactedLines.push(lineNumber);
+		return formatTaggedLine(truncateLine(line).text, lineNumber, "", line);
+	});
+	const truncation = truncateHead([header, ...tagged].join("\n"));
+	let text = truncation.content;
+	let details;
+	if (truncation.truncated) {
+		const shownLines = Math.max(0, truncation.outputLines - 1);
+		const nextOffset = startIndex + shownLines + 1;
+		const reason = truncation.truncatedBy === "bytes" ? `, ${formatSize(DEFAULT_MAX_BYTES)} limit` : "";
+		text += `\n\n[Showing ${shownLines} anchored lines${reason}. Use offset=${nextOffset} to continue.]`;
+		details = { truncation };
+	} else {
+		const notices = [];
+		if (compactedLines.length > 0) notices.push(`Lines ${compactedLines.join(", ")} shown compactly. Their anchors hash the full original lines`);
+		if (endIndex < lines.length) notices.push(`${lines.length - endIndex} more lines in file. Use offset=${endIndex + 1} to continue`);
+		if (notices.length > 0) text += `\n\n[${notices.join(". ")}.]`;
+	}
+	return {
+		content: [{
+			type: "text",
+			text
+		}],
+		details
+	};
+}
+function createHeadlessReadTool() {
+	return {
+		name: "read",
+		label: "read",
+		description: "Read a writable text file with an exact-byte file tag and stable line anchors. Non-writable files and images return native-compatible content. Text is truncated to 50.0KB.",
+		promptSnippet: "Read file contents with snapshot-bound line anchors",
+		promptGuidelines: ["Use read before edit. When hashline metadata is present, preserve the @file hash and anchors such as 5#abc exactly.", "Continue large reads with offset until the required anchored lines are visible."],
+		parameters: ReadParamsSchema,
+		executionMode: "parallel",
+		execute: async (_toolCallId, params, signal, _onUpdate, context) => executeHeadlessRead(params, context.cwd, signal)
+	};
+}
+//#endregion
+export { executeHeadlessRead as n, ReadParamsSchema as r, createHeadlessReadTool as t };
+
+//# sourceMappingURL=readTool-epk_n4AS.mjs.map