@agimon-ai/po-file-edit 0.0.0-alpha.1 → 0.0.0-alpha.3

package/dist/apiContracts.cjs

@@ -141,7 +141,7 @@ const apiContracts = (0, _agimon_ai_po_core_apiContracts.defineApiContract)({
 	sockets: ["global", "workspace"].map((scope) => ({
 		id: "files.channel",
 		scope,
-		service: "po.hub.v1",
+		service: "po.hub",
 		member: "file_edits",
 		kind: "channel",
 		direction: "server-to-client",

package/dist/apiContracts.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"apiContracts.cjs","names":["Type","defineApiContract","jsonApiResponses"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses } from '@agimon-ai/po-core/apiContracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst N = Type.Number();\nconst B = Type.Boolean();\nconst O = Type.Optional;\nconst literals = <T extends string>(values: T[]) => Type.Union(values.map((value) => Type.Literal(value)));\nconst Tool = literals(['edit', 'write', 'bash', 'user']);\nconst Hunk = Type.Object({\n  start: N,\n  rows: Type.Array(Type.Object({ marker: literals(['+', '-', ' ']), line: N, content: S })),\n});\nconst Diff = { additions: N, removals: N, hunks: O(Type.Array(Hunk)), note: O(S) };\nconst Working = Type.Object({ content: S, hash: S, unavailable: B, reason: O(S) });\nexport const FileDetailSchema = Type.Object({\n  path: S,\n  relPath: S,\n  versions: Type.Array(Type.Object({ index: N, tool: Tool, at: N, origin: literals(['tool', 'scan']), ...Diff })),\n  cumulative: Type.Object(Diff),\n  working: Working,\n});\nexport const FilesPayloadSchema = Type.Object({\n  items: Type.Array(Type.Object({ path: S, relPath: S, tool: Tool, at: N, count: N, diffable: B })),\n});\nconst query = [{ name: 'path', in: 'query' as const, required: true, schema: Type.String({ minLength: 1 }) }];\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: [],\n  http: [\n    {\n      id: 'files.detail',\n      scope: 'session',\n      basePath: 'file-edits',\n      path: '/detail',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read recorded changes and current file content.',\n      parameters: query,\n      responses: jsonApiResponses(FileDetailSchema),\n    },\n    {\n      id: 'files.preview',\n      scope: 'session',\n      basePath: 'file-edits',\n      path: '/preview',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read a file contained in the session directory.',\n      parameters: query,\n      responses: jsonApiResponses(Type.Object({ path: S, relPath: S, working: Working })),\n    },\n    {\n      id: 'files.save',\n      scope: 'session',\n      basePath: 'file-edits',\n      path: '/content',\n      method: 'PUT',\n      authentication: 'owner',\n      description: 'Save a recorded file if its hash still matches.',\n      body: {\n        required: true,\n        contentType: 'application/json',\n        schema: Type.Object({ path: S, expectedHash: S, content: S }),\n      },\n      responses: jsonApiResponses(Type.Object({ hash: S })),\n    },\n    {\n      id: 'files.delete',\n      scope: 'session',\n      basePath: 'file-edits',\n      path: '/content',\n      method: 'DELETE',\n      authentication: 'owner',\n      description: 'Delete a recorded file.',\n      parameters: query,\n      responses: {\n        '204': { description: 'File deleted or already absent.' },\n        '404': { description: 'Unrecorded file.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Deletion failed.', schema: Type.Object({ error: S }) },\n      },\n    },\n  ],\n  sockets: (['global', 'workspace'] as const).map((scope) => ({\n    id: 'files.channel',\n    scope,\n    service: 'po.hub.v1',\n    member: 'file_edits',\n    kind: 'channel',\n    direction: 'server-to-client',\n    description: 'File edits channel payload in the hub frame payload property.',\n    input: FilesPayloadSchema,\n  })),\n});\nexport default apiContracts;\n"],"mappings":"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"}
+{"version":3,"file":"apiContracts.cjs","names":["Type","defineApiContract","jsonApiResponses"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses } from '@agimon-ai/po-core/apiContracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst N = Type.Number();\nconst B = Type.Boolean();\nconst O = Type.Optional;\nconst literals = <T extends string>(values: T[]) => Type.Union(values.map((value) => Type.Literal(value)));\nconst Tool = literals(['edit', 'write', 'bash', 'user']);\nconst Hunk = Type.Object({\n  start: N,\n  rows: Type.Array(Type.Object({ marker: literals(['+', '-', ' ']), line: N, content: S })),\n});\nconst Diff = { additions: N, removals: N, hunks: O(Type.Array(Hunk)), note: O(S) };\nconst Working = Type.Object({ content: S, hash: S, unavailable: B, reason: O(S) });\nexport const FileDetailSchema = Type.Object({\n  path: S,\n  relPath: S,\n  versions: Type.Array(Type.Object({ index: N, tool: Tool, at: N, origin: literals(['tool', 'scan']), ...Diff })),\n  cumulative: Type.Object(Diff),\n  working: Working,\n});\nexport const FilesPayloadSchema = Type.Object({\n  items: Type.Array(Type.Object({ path: S, relPath: S, tool: Tool, at: N, count: N, diffable: B })),\n});\nconst query = [{ name: 'path', in: 'query' as const, required: true, schema: Type.String({ minLength: 1 }) }];\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: [],\n  http: [\n    {\n      id: 'files.detail',\n      scope: 'session',\n      basePath: 'file-edits',\n      path: '/detail',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read recorded changes and current file content.',\n      parameters: query,\n      responses: jsonApiResponses(FileDetailSchema),\n    },\n    {\n      id: 'files.preview',\n      scope: 'session',\n      basePath: 'file-edits',\n      path: '/preview',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read a file contained in the session directory.',\n      parameters: query,\n      responses: jsonApiResponses(Type.Object({ path: S, relPath: S, working: Working })),\n    },\n    {\n      id: 'files.save',\n      scope: 'session',\n      basePath: 'file-edits',\n      path: '/content',\n      method: 'PUT',\n      authentication: 'owner',\n      description: 'Save a recorded file if its hash still matches.',\n      body: {\n        required: true,\n        contentType: 'application/json',\n        schema: Type.Object({ path: S, expectedHash: S, content: S }),\n      },\n      responses: jsonApiResponses(Type.Object({ hash: S })),\n    },\n    {\n      id: 'files.delete',\n      scope: 'session',\n      basePath: 'file-edits',\n      path: '/content',\n      method: 'DELETE',\n      authentication: 'owner',\n      description: 'Delete a recorded file.',\n      parameters: query,\n      responses: {\n        '204': { description: 'File deleted or already absent.' },\n        '404': { description: 'Unrecorded file.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Deletion failed.', schema: Type.Object({ error: S }) },\n      },\n    },\n  ],\n  sockets: (['global', 'workspace'] as const).map((scope) => ({\n    id: 'files.channel',\n    scope,\n    service: 'po.hub',\n    member: 'file_edits',\n    kind: 'channel',\n    direction: 'server-to-client',\n    description: 'File edits channel payload in the hub frame payload property.',\n    input: FilesPayloadSchema,\n  })),\n});\nexport default apiContracts;\n"],"mappings":"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"}

package/dist/apiContracts.mjs

@@ -137,7 +137,7 @@ const apiContracts = defineApiContract({
 	sockets: ["global", "workspace"].map((scope) => ({
 		id: "files.channel",
 		scope,
-		service: "po.hub.v1",
+		service: "po.hub",
 		member: "file_edits",
 		kind: "channel",
 		direction: "server-to-client",

package/dist/apiContracts.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses } from '@agimon-ai/po-core/apiContracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst N = Type.Number();\nconst B = Type.Boolean();\nconst O = Type.Optional;\nconst literals = <T extends string>(values: T[]) => Type.Union(values.map((value) => Type.Literal(value)));\nconst Tool = literals(['edit', 'write', 'bash', 'user']);\nconst Hunk = Type.Object({\n  start: N,\n  rows: Type.Array(Type.Object({ marker: literals(['+', '-', ' ']), line: N, content: S })),\n});\nconst Diff = { additions: N, removals: N, hunks: O(Type.Array(Hunk)), note: O(S) };\nconst Working = Type.Object({ content: S, hash: S, unavailable: B, reason: O(S) });\nexport const FileDetailSchema = Type.Object({\n  path: S,\n  relPath: S,\n  versions: Type.Array(Type.Object({ index: N, tool: Tool, at: N, origin: literals(['tool', 'scan']), ...Diff })),\n  cumulative: Type.Object(Diff),\n  working: Working,\n});\nexport const FilesPayloadSchema = Type.Object({\n  items: Type.Array(Type.Object({ path: S, relPath: S, tool: Tool, at: N, count: N, diffable: B })),\n});\nconst query = [{ name: 'path', in: 'query' as const, required: true, schema: Type.String({ minLength: 1 }) }];\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: [],\n  http: [\n    {\n      id: 'files.detail',\n      scope: 'session',\n      basePath: 'file-edits',\n      path: '/detail',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read recorded changes and current file content.',\n      parameters: query,\n      responses: jsonApiResponses(FileDetailSchema),\n    },\n    {\n      id: 'files.preview',\n      scope: 'session',\n      basePath: 'file-edits',\n      path: '/preview',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read a file contained in the session directory.',\n      parameters: query,\n      responses: jsonApiResponses(Type.Object({ path: S, relPath: S, working: Working })),\n    },\n    {\n      id: 'files.save',\n      scope: 'session',\n      basePath: 'file-edits',\n      path: '/content',\n      method: 'PUT',\n      authentication: 'owner',\n      description: 'Save a recorded file if its hash still matches.',\n      body: {\n        required: true,\n        contentType: 'application/json',\n        schema: Type.Object({ path: S, expectedHash: S, content: S }),\n      },\n      responses: jsonApiResponses(Type.Object({ hash: S })),\n    },\n    {\n      id: 'files.delete',\n      scope: 'session',\n      basePath: 'file-edits',\n      path: '/content',\n      method: 'DELETE',\n      authentication: 'owner',\n      description: 'Delete a recorded file.',\n      parameters: query,\n      responses: {\n        '204': { description: 'File deleted or already absent.' },\n        '404': { description: 'Unrecorded file.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Deletion failed.', schema: Type.Object({ error: S }) },\n      },\n    },\n  ],\n  sockets: (['global', 'workspace'] as const).map((scope) => ({\n    id: 'files.channel',\n    scope,\n    service: 'po.hub.v1',\n    member: 'file_edits',\n    kind: 'channel',\n    direction: 'server-to-client',\n    description: 'File edits channel payload in the hub frame payload property.',\n    input: FilesPayloadSchema,\n  })),\n});\nexport default apiContracts;\n"],"mappings":"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"}
+{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses } from '@agimon-ai/po-core/apiContracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst N = Type.Number();\nconst B = Type.Boolean();\nconst O = Type.Optional;\nconst literals = <T extends string>(values: T[]) => Type.Union(values.map((value) => Type.Literal(value)));\nconst Tool = literals(['edit', 'write', 'bash', 'user']);\nconst Hunk = Type.Object({\n  start: N,\n  rows: Type.Array(Type.Object({ marker: literals(['+', '-', ' ']), line: N, content: S })),\n});\nconst Diff = { additions: N, removals: N, hunks: O(Type.Array(Hunk)), note: O(S) };\nconst Working = Type.Object({ content: S, hash: S, unavailable: B, reason: O(S) });\nexport const FileDetailSchema = Type.Object({\n  path: S,\n  relPath: S,\n  versions: Type.Array(Type.Object({ index: N, tool: Tool, at: N, origin: literals(['tool', 'scan']), ...Diff })),\n  cumulative: Type.Object(Diff),\n  working: Working,\n});\nexport const FilesPayloadSchema = Type.Object({\n  items: Type.Array(Type.Object({ path: S, relPath: S, tool: Tool, at: N, count: N, diffable: B })),\n});\nconst query = [{ name: 'path', in: 'query' as const, required: true, schema: Type.String({ minLength: 1 }) }];\nexport const apiContracts = defineApiContract({\n  version: 1,\n  dynamic: [],\n  http: [\n    {\n      id: 'files.detail',\n      scope: 'session',\n      basePath: 'file-edits',\n      path: '/detail',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read recorded changes and current file content.',\n      parameters: query,\n      responses: jsonApiResponses(FileDetailSchema),\n    },\n    {\n      id: 'files.preview',\n      scope: 'session',\n      basePath: 'file-edits',\n      path: '/preview',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read a file contained in the session directory.',\n      parameters: query,\n      responses: jsonApiResponses(Type.Object({ path: S, relPath: S, working: Working })),\n    },\n    {\n      id: 'files.save',\n      scope: 'session',\n      basePath: 'file-edits',\n      path: '/content',\n      method: 'PUT',\n      authentication: 'owner',\n      description: 'Save a recorded file if its hash still matches.',\n      body: {\n        required: true,\n        contentType: 'application/json',\n        schema: Type.Object({ path: S, expectedHash: S, content: S }),\n      },\n      responses: jsonApiResponses(Type.Object({ hash: S })),\n    },\n    {\n      id: 'files.delete',\n      scope: 'session',\n      basePath: 'file-edits',\n      path: '/content',\n      method: 'DELETE',\n      authentication: 'owner',\n      description: 'Delete a recorded file.',\n      parameters: query,\n      responses: {\n        '204': { description: 'File deleted or already absent.' },\n        '404': { description: 'Unrecorded file.', schema: Type.Object({ error: S }) },\n        '409': { description: 'Deletion failed.', schema: Type.Object({ error: S }) },\n      },\n    },\n  ],\n  sockets: (['global', 'workspace'] as const).map((scope) => ({\n    id: 'files.channel',\n    scope,\n    service: 'po.hub',\n    member: 'file_edits',\n    kind: 'channel',\n    direction: 'server-to-client',\n    description: 'File edits channel payload in the hub frame payload property.',\n    input: FilesPayloadSchema,\n  })),\n});\nexport default apiContracts;\n"],"mappings":"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"}

package/dist/extensions/native.mjs

@@ -0,0 +1,51 @@
+import { defineChannelFile, defineNativePlugin, defineSessionStore } from "@agimon-ai/po-core/native";
+//#region src/types/webFiles.ts
+/** The frame type the hub publishes and the web plugin claims; declared in the poWeb block too. */
+const filesChannelType = "file_edits";
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/_lib/filesModel.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isItem(value) {
+	return isRecord(value) && typeof value.path === "string" && typeof value.relPath === "string" && typeof value.tool === "string" && typeof value.at === "number" && typeof value.count === "number";
+}
+/** The shared wire gate for browser and native stores. */
+function parseFilesPayload(input) {
+	if (!isRecord(input) || !Array.isArray(input.items)) return null;
+	return { items: input.items.filter(isItem) };
+}
+/** The plugin's session data channel: 'file_edits' payloads into the store. */
+const filesChannel = defineSessionStore({
+	items: [],
+	detail: {},
+	loading: [],
+	errors: {},
+	comments: []
+}).channel({
+	channel: filesChannelType,
+	parse: parseFilesPayload,
+	reduce: (current, { items }) => ({
+		...current,
+		items
+	})
+});
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/channel/file-edits.native.ts
+var file_edits_native_default = defineChannelFile(filesChannel);
+//#endregion
+//#region generated/native.ts
+const via = (identity, value) => value === void 0 ? void 0 : {
+	...identity,
+	...value
+};
+const nativePlugin = defineNativePlugin({
+	id: "files",
+	session: { get channels() {
+		return [via({ channel: "file_edits" }, file_edits_native_default)];
+	} }
+});
+//#endregion
+export { nativePlugin };
+
+//# sourceMappingURL=native.mjs.map

package/dist/extensions/native.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.mjs","names":["channelFileEdits"],"sources":["../../src/types/webFiles.ts","../../src/extensions/workspaces/sessions/(frontend)/_lib/filesModel.ts","../../src/extensions/workspaces/sessions/(frontend)/_lib/filesStore.native.ts","../../src/extensions/workspaces/sessions/(frontend)/channel/file-edits.native.ts","../../generated/native.ts"],"sourcesContent":["import type { FileEditTool } from './domain';\n\n/**\n * View types shared by this package's hub channel and its web plugin. Wire\n * JSON only, no node types, so the cockpit bundle can carry them; the\n * cockpit receives them as 'file_edits' channel payloads.\n *\n * The channel carries the list alone. One file's diffs and content are large\n * and only wanted once a reader opens the file, so those come from the session\n * API instead (see fileEditsApi.ts).\n */\n\n/** One file this session changed, as the activity dock lists it. */\nexport interface FilesItemView {\n  /** Absolute path, and the identity every API route takes back. */\n  path: string;\n  /** Path relative to the session's working directory, which is what a row shows. */\n  relPath: string;\n  /** The tool behind the most recent change. */\n  tool: FileEditTool;\n  /** When that change happened, epoch milliseconds. */\n  at: number;\n  /** How many changes this session recorded for the file. */\n  count: number;\n  /**\n   * Whether any change captured a baseline, so a diff can be shown at all. A\n   * file found by comparing the tree around a bash call has no \"before\", so it\n   * is listed and readable but never diffed.\n   */\n  diffable: boolean;\n}\n\n/** The frame type the hub publishes and the web plugin claims; declared in the poWeb block too. */\nexport const filesChannelType = 'file_edits';\n\n/** Footer status key whose presence shows the activity group; the extension publishes it. */\nexport const filesStatusKey = 'doom-file-edit-files';\n","import type { FilesItemView } from '../../../../../types/webFiles';\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isItem(value: unknown): value is FilesItemView {\n  return (\n    isRecord(value) &&\n    typeof value.path === 'string' &&\n    typeof value.relPath === 'string' &&\n    typeof value.tool === 'string' &&\n    typeof value.at === 'number' &&\n    typeof value.count === 'number'\n  );\n}\n\nexport interface FilesPayload {\n  items: FilesItemView[];\n}\n\n/** The shared wire gate for browser and native stores. */\nexport function parseFilesPayload(input: unknown): FilesPayload | null {\n  if (!isRecord(input) || !Array.isArray(input.items)) return null;\n  return { items: input.items.filter(isItem) };\n}\n","import { defineSessionStore } from '@agimon-ai/po-core/native';\nimport type { ReviewComment } from '@agimon-ai/po-web-components';\n\nimport type { FileEditsDetailView } from '../../../../../types/fileEditsApi';\nimport { filesChannelType, type FilesItemView } from '../../../../../types/webFiles';\nimport { parseFilesPayload, type FilesPayload } from './filesModel';\nexport type { FilesPayload } from './filesModel';\n\n/**\n * One session's record: the hub's last report plus whatever this page does with\n * it. Records are immutable values; the reducer and every action return a new one.\n *\n * Detail is cached per file rather than per open tab, because a reader closes a\n * file and comes back to it, and refetching the same history for the same click\n * is work the session already did.\n */\nexport interface FilesSession {\n  items: FilesItemView[];\n  /** One file's fetched history, keyed by absolute path. */\n  detail: Readonly<Record<string, FileEditsDetailView>>;\n  /** Paths with a detail request in flight, so a panel can say it is loading. */\n  loading: readonly string[];\n  /** What a failed fetch or a refused save reported, keyed by absolute path. */\n  errors: Readonly<Record<string, string>>;\n  /** Review notes waiting to be sent, in the order they were written. */\n  comments: readonly ReviewComment[];\n}\n\nconst empty: FilesSession = { items: [], detail: {}, loading: [], errors: {}, comments: [] };\n\nexport const files = defineSessionStore<FilesSession>(empty);\n\n/** The plugin's session data channel: 'file_edits' payloads into the store. */\nexport const filesChannel = files.channel<FilesPayload>({\n  channel: filesChannelType,\n  parse: parseFilesPayload,\n  // Only the list is replaced. The cached detail and the pending notes belong\n  // to files a reader opened, not to the list: a file the session deletes stops\n  // being listed, and pruning here would blank the tab still open on it and\n  // then refetch it on the next frame.\n  reduce: (current, { items }) => ({ ...current, items }),\n});\n\nexport function markLoading(sessionId: string, filePath: string): void {\n  files.update(sessionId, (current) =>\n    current.loading.includes(filePath)\n      ? current\n      : { ...current, loading: [...current.loading, filePath], errors: withoutKey(current.errors, filePath) },\n  );\n}\n\nexport function storeDetail(sessionId: string, detail: FileEditsDetailView): void {\n  files.update(sessionId, (current) => ({\n    ...current,\n    detail: { ...current.detail, [detail.path]: detail },\n    loading: current.loading.filter((path) => path !== detail.path),\n    errors: withoutKey(current.errors, detail.path),\n  }));\n}\n\nexport function storeError(sessionId: string, filePath: string, message: string): void {\n  files.update(sessionId, (current) => ({\n    ...current,\n    loading: current.loading.filter((path) => path !== filePath),\n    errors: { ...current.errors, [filePath]: message },\n  }));\n}\n\nexport function addComment(sessionId: string, comment: ReviewComment): void {\n  files.update(sessionId, (current) => ({ ...current, comments: [...current.comments, comment] }));\n}\n\nexport function removeComment(sessionId: string, id: string): void {\n  files.update(sessionId, (current) => ({\n    ...current,\n    comments: current.comments.filter((comment) => comment.id !== id),\n  }));\n}\n\nexport function clearComments(sessionId: string, filePath: string): void {\n  files.update(sessionId, (current) => ({\n    ...current,\n    comments: current.comments.filter((comment) => comment.path !== filePath),\n  }));\n}\n\nfunction withoutKey(source: Readonly<Record<string, string>>, key: string): Record<string, string> {\n  return Object.fromEntries(Object.entries(source).filter(([entry]) => entry !== key));\n}\n","import { defineChannelFile } from '@agimon-ai/po-core/native';\n\nimport { filesChannel } from '../_lib/filesStore.native';\nexport default defineChannelFile(filesChannel);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineNativePlugin, type WebPluginContributions } from '@agimon-ai/po-core/native';\n\nimport channelFileEdits from '../src/extensions/workspaces/sessions/(frontend)/channel/file-edits.native';\n\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nexport const nativePlugin = defineNativePlugin({\n  id: 'files',\n  session: {\n    get channels(): WebPluginContributions['channels'] { return [via({ channel: 'file_edits' }, channelFileEdits)]; },\n  },\n});\n"],"mappings":";;;AAiCA,MAAa,mBAAmB;;;AC/BhC,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,OAAO,OAAwC;CACtD,OACE,SAAS,KAAK,KACd,OAAO,MAAM,SAAS,YACtB,OAAO,MAAM,YAAY,YACzB,OAAO,MAAM,SAAS,YACtB,OAAO,MAAM,OAAO,YACpB,OAAO,MAAM,UAAU;AAE3B;;AAOA,SAAgB,kBAAkB,OAAqC;CACrE,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,MAAM,QAAQ,MAAM,KAAK,GAAG,OAAO;CAC5D,OAAO,EAAE,OAAO,MAAM,MAAM,OAAO,MAAM,EAAE;AAC7C;;ACQA,MAAa,eAHQ,mBAAiC;CAFxB,OAAO,CAAC;CAAG,QAAQ,CAAC;CAAG,SAAS,CAAC;CAAG,QAAQ,CAAC;CAAG,UAAU,CAAC;AAEnC,CAG1B,CAAA,CAAM,QAAsB;CACtD,SAAS;CACT,OAAO;CAKP,SAAS,SAAS,EAAE,aAAa;EAAE,GAAG;EAAS;CAAM;AACvD,CAAC;;;ACtCD,IAAA,4BAAe,kBAAkB,YAAY;;;ACE7C,MAAM,OAAU,UAAmC,UAChD,UAAU,KAAA,IAAY,KAAA,IAAY;CAAE,GAAG;CAAU,GAAI;AAAiB;AAEzE,MAAa,eAAe,mBAAmB;CAC7C,IAAI;CACJ,SAAS,EACP,IAAI,WAA+C;EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,aAAa,GAAGA,yBAAgB,CAAC;CAAG,EAClH;AACF,CAAC"}

package/dist/extensions/server.cjs

@@ -26,10 +26,16 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 //#endregion
 let _agimon_ai_po_core_serverFacet = require("@agimon-ai/po-core/serverFacet");
 let _agimon_ai_po_core_extensionFile = require("@agimon-ai/po-core/extensionFile");
-let node_fs = require("node:fs");
-node_fs = __toESM(node_fs, 1);
+let _agimon_ai_po_core_childSession = require("@agimon-ai/po-core/childSession");
+let _agimon_ai_po_core_hubChannel = require("@agimon-ai/po-core/hubChannel");
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = __toESM(node_fs_promises, 1);
 let node_path = require("node:path");
 node_path = __toESM(node_path, 1);
+let _agimon_ai_po_hashline = require("@agimon-ai/po-hashline");
+let _agimon_ai_po_hashline_files = require("@agimon-ai/po-hashline/files");
+let node_fs = require("node:fs");
+node_fs = __toESM(node_fs, 1);
 let _agimon_ai_po_core_childProcess = require("@agimon-ai/po-core/childProcess");
 let _agimon_ai_po_telemetry = require("@agimon-ai/po-telemetry");
 let ignore = require("ignore");
@@ -38,10 +44,193 @@ let node_child_process = require("node:child_process");
 let node_crypto = require("node:crypto");
 let _agimon_ai_po_core_piSettings = require("@agimon-ai/po-core/piSettings");
 let node_util = require("node:util");
-let node_fs_promises = require("node:fs/promises");
-node_fs_promises = __toESM(node_fs_promises, 1);
+let node_os = require("node:os");
+node_os = __toESM(node_os, 1);
+let _agimon_ai_po_config = require("@agimon-ai/po-config");
 let hono = require("hono");
-let _agimon_ai_po_core_web = require("@agimon-ai/po-core/web");
+//#region src/constants/editPresence.ts
+const PRESENCE_NOTE_TITLE = "[Po: other active agents edited files in this result]";
+const PRESENCE_NOTE_GUIDANCE = "Coordinate before editing: intercom send to the session id, or ask the subagent by name if it is on your team. Without intercom, tell the user.";
+//#endregion
+//#region src/services/editPresence/index.ts
+const PATH_TOOLS = /* @__PURE__ */ new Set([
+	"read",
+	"edit",
+	"write"
+]);
+const EDIT_TOOLS = /* @__PURE__ */ new Set(["edit", "write"]);
+const MAX_GREP_FILES = 50;
+const MAX_NOTE_LINES = 10;
+const MINUTE_MS = 6e4;
+const SHORT_ID_LENGTH = 8;
+/** Pi's built-in grep prints match rows as `relative/path:line: text`. */
+const PI_GREP_ROW = /^(.+?):(\d+): /u;
+function forgetPresence(ledger, agentKey) {
+	for (const [file, entries] of ledger) {
+		entries.delete(agentKey);
+		if (entries.size === 0) ledger.delete(file);
+	}
+}
+function stringArg(args, key) {
+	if (typeof args !== "object" || args === null) return void 0;
+	const value = args[key];
+	return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function textOf(content) {
+	return content.map((part) => part.type === "text" && "text" in part && typeof part.text === "string" ? part.text : "").join("\n");
+}
+async function grepFiles(call) {
+	const lines = textOf(call.content).split("\n");
+	const headers = lines.flatMap((line) => {
+		const header = (0, _agimon_ai_po_hashline.parseFileHeader)(line);
+		return header === void 0 ? [] : [(0, _agimon_ai_po_hashline_files.resolveInputPath)(header.path, call.cwd)];
+	});
+	if (headers.length > 0) return [...new Set(headers)].slice(0, MAX_GREP_FILES);
+	const rows = lines.flatMap((line) => {
+		const match = PI_GREP_ROW.exec(line)?.[1];
+		return match === void 0 ? [] : [match];
+	});
+	if (rows.length === 0) return [];
+	const searchPath = (0, _agimon_ai_po_hashline_files.resolveInputPath)(stringArg(call.args, "path") ?? ".", call.cwd);
+	if ((await node_fs_promises.default.stat(searchPath).catch(() => void 0))?.isFile()) return [searchPath];
+	return [...new Set(rows.map((row) => node_path.default.resolve(searchPath, row)))].slice(0, MAX_GREP_FILES);
+}
+async function touchedFiles(call) {
+	if (PATH_TOOLS.has(call.toolName)) {
+		const input = stringArg(call.args, "path");
+		return input === void 0 ? [] : [await (0, _agimon_ai_po_hashline_files.resolveReadInputPath)(input, call.cwd)];
+	}
+	return call.toolName === "grep" ? grepFiles(call) : [];
+}
+function ago(elapsed) {
+	const minutes = Math.floor(elapsed / MINUTE_MS);
+	return minutes < 1 ? "under 1m ago" : `${minutes}m ago`;
+}
+function liveOthers(ledger, file, self) {
+	const entries = ledger.get(file);
+	if (entries === void 0) return [];
+	const live = [];
+	for (const [key, entry] of entries) {
+		if (key === self) continue;
+		if (entry.agent.isLive()) live.push(entry);
+		else entries.delete(key);
+	}
+	return live.sort((left, right) => right.at - left.at);
+}
+function record(ledger, file, agent, tag, at) {
+	const entries = ledger.get(file) ?? /* @__PURE__ */ new Map();
+	entries.set(agent.key, {
+		agent,
+		tag,
+		at
+	});
+	ledger.set(file, entries);
+}
+function renderNote(lines) {
+	const shown = lines.slice(0, MAX_NOTE_LINES);
+	const more = lines.length - shown.length;
+	return [
+		PRESENCE_NOTE_TITLE,
+		...shown,
+		...more > 0 ? [`- and ${more} more`] : [],
+		PRESENCE_NOTE_GUIDANCE
+	].join("\n");
+}
+/**
+* Notes live editors of the files a tool call touched, then records the caller's own successful edit.
+* Returns the content with one note appended, or undefined when there is nothing to add, so callers
+* never rewrite a result needlessly.
+*/
+async function observePresence(ledger, agent, call, now = Date.now()) {
+	const recording = EDIT_TOOLS.has(call.toolName) && !call.isError;
+	if (!recording && ledger.size === 0) return void 0;
+	const lines = [];
+	for (const file of await touchedFiles(call)) {
+		const real = await node_fs_promises.default.realpath(file).catch(() => void 0);
+		if (real === void 0) continue;
+		const others = liveOthers(ledger, real, agent.key);
+		let bytes;
+		if (others.length > 0) {
+			bytes = await node_fs_promises.default.readFile(real).catch(() => void 0);
+			const current = bytes === void 0 ? void 0 : (0, _agimon_ai_po_hashline_files.computeFileTag)(bytes);
+			const shown = (0, _agimon_ai_po_hashline_files.displayPath)(file, call.cwd);
+			for (const entry of others) {
+				const state = entry.tag === current ? "unchanged" : "changed";
+				lines.push(`- ${shown}: ${entry.agent.label()}, ${ago(now - entry.at)}, file ${state} since their edit.`);
+			}
+		}
+		if (recording) {
+			bytes ??= await node_fs_promises.default.readFile(real).catch(() => void 0);
+			if (bytes !== void 0) record(ledger, real, agent, (0, _agimon_ai_po_hashline_files.computeFileTag)(bytes), now);
+		}
+	}
+	if (lines.length === 0) return void 0;
+	return [...call.content, {
+		type: "text",
+		text: renderNote(lines)
+	}];
+}
+/** Edit presence for one hub session and the in-process children it spawns. */
+function createSessionPresence(options) {
+	const { sessionId, ledger } = options;
+	const sessionAgent = {
+		key: `session:${sessionId}`,
+		label: () => `session ${sessionId}${options.workflowStep ? " (workflow step)" : ""}`,
+		contact: sessionId,
+		isLive: options.isLive
+	};
+	const safely = async (work) => {
+		try {
+			return await work();
+		} catch (error) {
+			options.onError?.(error);
+			return;
+		}
+	};
+	return {
+		toolResult: {
+			event: "tool_result",
+			async handle(event, execution) {
+				const toolName = event.toolName;
+				if (execution.sessionId !== sessionId || typeof toolName !== "string" || !Array.isArray(event.content)) return;
+				const content = event.content;
+				const next = await safely(() => observePresence(ledger, sessionAgent, {
+					toolName,
+					args: event.args,
+					content,
+					isError: event.isError === true,
+					cwd: execution.cwd
+				}));
+				return next === void 0 ? void 0 : { content: next };
+			}
+		},
+		childHooks: { bind(scope) {
+			const { runId, parentSessionId, agent } = scope.request;
+			const child = {
+				key: `run:${runId}`,
+				label: () => `${options.labelFor(runId) ?? `${agent} (run ${runId.slice(0, SHORT_ID_LENGTH)})`} (subagent of session ${parentSessionId})`,
+				contact: parentSessionId,
+				isLive: () => !scope.signal.aborted
+			};
+			return {
+				beforeTool: () => void 0,
+				async afterTool(event) {
+					const next = await safely(() => observePresence(ledger, child, {
+						toolName: event.toolName,
+						args: event.args,
+						content: event.content,
+						isError: event.isError,
+						cwd: scope.request.cwd || options.cwd
+					}));
+					return next === void 0 ? void 0 : { content: next };
+				},
+				dispose: async () => forgetPresence(ledger, child.key)
+			};
+		} },
+		dispose: () => forgetPresence(ledger, sessionAgent.key)
+	};
+}
+//#endregion
 //#region src/services/doomIgnore/index.ts
 function matchablePath(relPath) {
 	const normalized = relPath.replace(/\\/gu, "/");
@@ -1128,23 +1317,23 @@ const filesStatusKey = "doom-file-edit-files";
 * This is the one file the routes, the Hono app and the browser all read, so a
 * path cannot move on one side alone.
 */
-var apiRoutes_default = (0, _agimon_ai_po_core_web.defineApiRoutes)({
+const routes = {
 	detail: {
 		method: "GET",
 		path: "/detail",
 		query: ["path"],
-		response: (0, _agimon_ai_po_core_web.apiResponse)()
+		response: void 0
 	},
 	preview: {
 		method: "GET",
 		path: "/preview",
 		query: ["path"],
-		response: (0, _agimon_ai_po_core_web.apiResponse)()
+		response: void 0
 	},
 	save: {
 		method: "PUT",
 		path: "/content",
-		response: (0, _agimon_ai_po_core_web.apiResponse)()
+		response: void 0
 	},
 	/** The same path as `save`; the method is the whole of the difference. */
 	remove: {
@@ -1162,10 +1351,11 @@ var apiRoutes_default = (0, _agimon_ai_po_core_web.defineApiRoutes)({
 	file: {
 		method: "GET",
 		path: "/file",
+		raw: true,
 		query: ["path"],
 		host: true
 	}
-});
+};
 //#endregion
 //#region src/types/fileEditsApi.ts
 /**
@@ -1399,7 +1589,14 @@ function createFileEditsApi(options = {}) {
 		const root = node_path.default.resolve(cwd);
 		return isInside(root, filePath) && await isRealPathInside(root, filePath);
 	};
-	app.get(apiRoutes_default.detail.path, async (context) => {
+	/** The Po-owned folder holding the file, checked the same two ways as the working directory. */
+	const readableRootOf = async (filePath) => {
+		for (const root of options.readableRoots?.() ?? []) {
+			const resolved = node_path.default.resolve(root);
+			if (isInside(resolved, filePath) && await isRealPathInside(resolved, filePath)) return resolved;
+		}
+	};
+	app.get(routes.detail.path, async (context) => {
 		const requested = context.req.query(PATH_QUERY_PARAM);
 		const versions = await recordedVersions(requested);
 		if (versions === void 0 || requested === void 0) return context.json({ error: "This session recorded no changes to that file." }, 404);
@@ -1425,21 +1622,22 @@ function createFileEditsApi(options = {}) {
 	* these routes no working directory has no boundary to enforce and so serves
 	* nothing.
 	*/
-	app.get(apiRoutes_default.preview.path, async (context) => {
+	app.get(routes.preview.path, async (context) => {
 		const requested = context.req.query(PATH_QUERY_PARAM);
 		if (requested === void 0 || requested === "" || requested.includes("\0")) return context.json({ error: "A preview names a path." }, 400);
 		if (cwd === "") return context.json({ error: "This session has no working directory to read from." }, 403);
 		const root = node_path.default.resolve(cwd);
 		const filePath = node_path.default.resolve(root, requested);
-		if (!await isInsideSession(filePath)) return context.json({ error: "The path leaves the session directory." }, 403);
+		const inSession = await isInsideSession(filePath);
+		if (!inSession && await readableRootOf(filePath) === void 0) return context.json({ error: "The path leaves the session directory." }, 403);
 		const body = {
 			path: filePath,
-			relPath: node_path.default.relative(root, filePath),
+			relPath: inSession ? node_path.default.relative(root, filePath) : filePath,
 			working: await readWorking(filePath)
 		};
 		return context.json(body);
 	});
-	app.put(apiRoutes_default.save.path, async (context) => {
+	app.put(routes.save.path, async (context) => {
 		let request;
 		try {
 			request = await context.req.json();
@@ -1460,7 +1658,7 @@ function createFileEditsApi(options = {}) {
 		const body = { hash: hashOf(request.content) };
 		return context.json(body);
 	});
-	app.delete(apiRoutes_default.remove.path, async (context) => {
+	app.delete(routes.remove.path, async (context) => {
 		const requested = context.req.query(PATH_QUERY_PARAM);
 		if (await recordedVersions(requested) === void 0 || requested === void 0) return context.json({ error: "This session recorded no changes to that file." }, 404);
 		const filePath = node_path.default.resolve(cwd, requested);
@@ -1478,10 +1676,15 @@ function createFileEditsApi(options = {}) {
 const api = {
 	basePath: API_BASE_PATH,
 	start(context) {
+		const environment = context.environment ?? process.env;
+		const cwd = context.cwd;
 		const app = createFileEditsApi({
 			paths: new FileEditPaths(context.environment),
 			...context.sessionId === void 0 ? {} : { sessionId: context.sessionId },
-			...context.cwd === void 0 ? {} : { cwd: context.cwd }
+			...cwd === void 0 ? {} : {
+				cwd,
+				readableRoots: () => plansRoots(cwd, environment)
+			}
 		});
 		return {
 			fetch: (request) => app.fetch(request),
@@ -1489,6 +1692,20 @@ const api = {
 		};
 	}
 };
+/**
+* The plans directory Plan mode writes to, resolved the way Plan resolves it, so
+* a plan link in the transcript opens in the file view. A config that cannot be
+* read admits nothing extra rather than failing the preview.
+*/
+function plansRoots(cwd, environment) {
+	const home = environment.HOME ?? node_os.default.homedir();
+	try {
+		const configured = (0, _agimon_ai_po_config.loadDoomConfig)(cwd, home, environment).modes?.planning?.plansDirectory;
+		return [(0, _agimon_ai_po_config.resolvePlanningPlansDirectory)(configured, cwd, home)];
+	} catch {
+		return [];
+	}
+}
 //#endregion
 //#region src/services/sessionStateSweep/index.ts
 /**
@@ -1854,12 +2071,37 @@ function createFileEditSession({ agent, host }) {
 }
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/_lib/serverRoot.ts
+function createPresence({ agent, host, context }) {
+	const ledger = host.context.editPresence;
+	if (!agent || !ledger) return void 0;
+	const execution = agent.context;
+	return createSessionPresence({
+		ledger,
+		sessionId: execution.sessionId,
+		cwd: execution.cwd,
+		workflowStep: execution.sessionContext?.provenance === _agimon_ai_po_core_hubChannel.WORKFLOW_STEP_SESSION_PROVENANCE,
+		isLive: () => host.context.sessionService?.isLive(execution.sessionId) ?? true,
+		labelFor: (runId) => (0, _agimon_ai_po_core_childSession.readDoomChildSessionLabels)(context)?.labelFor(runId),
+		onError: (error) => host.context.onNotice(`Edit presence failed: ${error instanceof Error ? error.message : String(error)}`)
+	});
+}
 const createFileEditServerRoot = (context) => {
 	const runtime = createFileEditSession(context);
+	const presence = createPresence(context);
 	return {
-		value: runtime,
+		value: {
+			...runtime,
+			...presence === void 0 ? {} : { presence }
+		},
 		activities: runtime.activities,
-		onDispose: runtime.onDispose
+		...presence === void 0 ? {} : { services: [(cordis) => cordis.inject([_agimon_ai_po_core_childSession.DOOM_CHILD_SESSION_HOOK_REGISTRY_SERVICE], (registryContext) => {
+			const registration = registryContext.get(_agimon_ai_po_core_childSession.DOOM_CHILD_SESSION_HOOK_REGISTRY_SERVICE).register(presence.childHooks);
+			return () => registration.dispose();
+		})] },
+		onDispose: async (pluginContext) => {
+			presence?.dispose();
+			await runtime.onDispose?.(pluginContext);
+		}
 	};
 };
 //#endregion
@@ -1888,6 +2130,12 @@ var tool_execution_end_server_default = (0, _agimon_ai_po_core_extensionFile.def
 //#region src/extensions/workspaces/sessions/(backend)/hook/tool-execution-start.server.ts
 var tool_execution_start_server_default = (0, _agimon_ai_po_core_extensionFile.defineHook)((context) => context.root.hooks[0]);
 //#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/tool-result.server.ts
+var tool_result_server_default = (0, _agimon_ai_po_core_extensionFile.defineHook)(({ root }) => ({
+	event: "tool_result",
+	handle: async (event, execution) => root.presence?.toolResult.handle(event, execution)
+}));
+//#endregion
 //#region generated/server.ts
 const at = (value, context) => typeof value === "function" ? value(context) : value;
 const via = (identity, value) => value === void 0 ? void 0 : {
@@ -1918,7 +2166,11 @@ const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
 				return [() => via({ frameType: "file_edits" }, fileEdits_server_default())];
 			},
 			get hooks() {
-				return [via({ event: "tool_execution_end" }, at(tool_execution_end_server_default, contextSession)), via({ event: "tool_execution_start" }, at(tool_execution_start_server_default, contextSession))];
+				return [
+					via({ event: "tool_execution_end" }, at(tool_execution_end_server_default, contextSession)),
+					via({ event: "tool_execution_start" }, at(tool_execution_start_server_default, contextSession)),
+					via({ event: "tool_result" }, at(tool_result_server_default, contextSession))
+				];
 			},
 			services: [...scopeSession.services ?? []],
 			get activities() {