@xopcai/xopc 0.0.125 → 0.0.127

package/dist/src/utils/index.js

@@ -1,8 +1,8 @@
+import { getAsyncLogContext, inboundCorrelationMetadataFromAsyncLogContext, runWithLogContext, updateAsyncLogContext } from "./logger/context.js";
 import { getLogDir, getLoggerConfig } from "./logger/config.js";
 import { getRuntimeLogStats } from "./logger/stats.js";
 import { flushAndClose, isLoggerShuttingDown, setShuttingDown } from "./logger/shutdown.js";
 import { cleanOldLogs, rotateLogs } from "./logger/rotation.js";
-import { getAsyncLogContext, inboundCorrelationMetadataFromAsyncLogContext, runWithLogContext, updateAsyncLogContext } from "./logger/context.js";
 import { isLogRedactionEnabled, redactObject, redactPemBlock, redactSecret, redactSensitiveInfo } from "./logger/redact.js";
 import { exportLog, flushExporters, getExporters, initializeExporters } from "./logger/exporters.js";
 import { configureAuditLog, getAuditConfig, logAuditEvent, logAuthEvent, logConfigChange, logDataAccess, logPermissionChange } from "./logger/audit.js";

package/dist/src/utils/logger/index.js

@@ -1,11 +1,11 @@
 import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
 import { PACKAGE_VERSION, init_package_version } from "../../package-version.js";
+import { getAsyncLogContext, getAsyncLogCorrelationKeys, inboundCorrelationMetadataFromAsyncLogContext, init_context, mergeContext, runWithLogContext, updateAsyncLogContext } from "./context.js";
 import { config, getLogDir, getLoggerConfig, init_config } from "./config.js";
 import { init_streams, initializeStreams } from "./streams.js";
 import { getRuntimeLogStats, incrementStats, init_stats } from "./stats.js";
 import { flushAndClose, init_shutdown, isLoggerShuttingDown, setShuttingDown } from "./shutdown.js";
 import { cleanOldLogs, init_rotation, rotateLogs } from "./rotation.js";
-import { getAsyncLogContext, getAsyncLogCorrelationKeys, inboundCorrelationMetadataFromAsyncLogContext, init_context, mergeContext, runWithLogContext, updateAsyncLogContext } from "./context.js";
 import { init_redact, isLogRedactionEnabled, redactLogRecord, redactObject, redactPemBlock, redactSecret, redactSensitiveInfo } from "./redact.js";
 import { exportLog, flushExporters, getExporters, init_exporters, initializeExporters } from "./exporters.js";
 import { configureAuditLog, getAuditConfig, init_audit, logAuditEvent, logAuthEvent, logConfigChange, logDataAccess, logPermissionChange } from "./audit.js";

package/dist/src/utils/logger/stats.d.ts

@@ -12,13 +12,13 @@ export declare function incrementStats(level: LogLevel, module?: string): void;
  */
 export declare function getRuntimeLogStats(): {
     byLevel: {
-        error: number;
-        debug: number;
-        silent: number;
         trace: number;
+        debug: number;
         info: number;
         warn: number;
+        error: number;
         fatal: number;
+        silent: number;
     };
     byModule: {
         [k: string]: number;

package/dist/src/utils/logger.js

@@ -1,9 +1,9 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { getAsyncLogContext, inboundCorrelationMetadataFromAsyncLogContext, runWithLogContext, updateAsyncLogContext } from "./logger/context.js";
 import { getLogDir, getLoggerConfig } from "./logger/config.js";
 import { getRuntimeLogStats } from "./logger/stats.js";
 import { flushAndClose, isLoggerShuttingDown, setShuttingDown } from "./logger/shutdown.js";
 import { cleanOldLogs, rotateLogs } from "./logger/rotation.js";
-import { getAsyncLogContext, inboundCorrelationMetadataFromAsyncLogContext, runWithLogContext, updateAsyncLogContext } from "./logger/context.js";
 import { isLogRedactionEnabled, redactObject, redactPemBlock, redactSecret, redactSensitiveInfo } from "./logger/redact.js";
 import { exportLog, flushExporters, getExporters, initializeExporters } from "./logger/exporters.js";
 import { configureAuditLog, getAuditConfig, logAuditEvent, logAuthEvent, logConfigChange, logDataAccess, logPermissionChange } from "./logger/audit.js";

package/dist/src/work-items/agent-context.d.ts

@@ -1,3 +1,7 @@
 import type { AgentSourceContext } from '../agent/source-context/types.js';
+import type { MediaRef } from '../media/types.js';
 import type { WorkItem } from './types.js';
-export declare function buildWorkItemAgentContext(item: WorkItem): AgentSourceContext;
+export declare function buildWorkItemAgentContext(item: WorkItem, opts?: {
+    attachments?: readonly MediaRef[];
+    includeImages?: boolean;
+}): Promise<AgentSourceContext>;

package/dist/src/work-items/agent-context.js

@@ -1,12 +1,47 @@
+import { readMediaReferenceBase64 } from "../media/media-reference.js";
 //#region src/work-items/agent-context.ts
+const MAX_NATIVE_VISION_IMAGES = 6;
+const MAX_NATIVE_VISION_IMAGE_BYTES = 2 * 1024 * 1024;
 function contextLine(label, value) {
 	if (value === void 0 || value === null) return null;
 	const text = String(value).trim();
 	return text ? `${label}: ${text}` : null;
 }
-function buildWorkItemAgentContext(item) {
+async function loadWorkItemNativeVisionImages(item) {
+	const images = [];
+	for (const attachment of item.attachments ?? []) {
+		if (attachment.type !== "image") continue;
+		if (!attachment.mimeType.toLowerCase().startsWith("image/")) continue;
+		if (attachment.size > MAX_NATIVE_VISION_IMAGE_BYTES) continue;
+		try {
+			const loaded = await readMediaReferenceBase64(attachment.mediaUri, MAX_NATIVE_VISION_IMAGE_BYTES);
+			images.push({
+				type: "image",
+				data: loaded.data,
+				mimeType: attachment.mimeType || loaded.mimeType
+			});
+			if (images.length >= MAX_NATIVE_VISION_IMAGES) break;
+		} catch {
+			continue;
+		}
+	}
+	return images;
+}
+function renderAttachmentLines(item, refs) {
+	if (!item.attachments?.length) return "";
+	return item.attachments.slice(0, 12).map((attachment, index) => {
+		const ref = refs?.[index];
+		return [
+			`- ${ref?.name ?? attachment.fileName} (${ref?.mimeType ?? attachment.mimeType}, ${ref?.size ?? attachment.size} bytes)`,
+			`  xopc-media-uri:${ref?.uri ?? attachment.mediaUri}`,
+			"  Use the read_media tool with the xopc-media-uri value when you need to inspect this attachment."
+		].join("\n");
+	}).join("\n");
+}
+async function buildWorkItemAgentContext(item, opts = {}) {
 	const links = item.links?.length ? item.links.slice(0, 12).map((link) => `- ${link.kind}: ${link.title || link.targetId}${link.statusSnapshot ? ` (${link.statusSnapshot})` : ""}`).join("\n") : "";
-	const attachments = item.attachments?.length ? item.attachments.slice(0, 12).map((attachment) => `- ${attachment.fileName} (${attachment.mimeType}, ${attachment.size} bytes)`).join("\n") : "";
+	const attachments = renderAttachmentLines(item, opts.attachments);
+	const images = opts.includeImages === false ? [] : await loadWorkItemNativeVisionImages(item);
 	const text = [
 		"You are working inside a project work item. Treat this as the active task context, not as a new user message.",
 		"",
@@ -30,7 +65,8 @@ function buildWorkItemAgentContext(item) {
 		sourceId: item.id,
 		version: String(item.updatedAt),
 		title: item.title,
-		text
+		text,
+		...images.length ? { images } : {}
 	};
 }
 //#endregion

package/dist/src/work-items/agent-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-context.js","names":[],"sources":["../../../src/work-items/agent-context.ts"],"sourcesContent":["import type { AgentSourceContext } from '../agent/source-context/types.js';\n\nimport type { WorkItem } from './types.js';\n\nfunction contextLine(label: string, value: string | number | undefined | null): string | null {\n  if (value === undefined || value === null) return null;\n  const text = String(value).trim();\n  return text ? `${label}: ${text}` : null;\n}\n\nexport function buildWorkItemAgentContext(item: WorkItem): AgentSourceContext {\n  const links = item.links?.length\n    ? item.links\n      .slice(0, 12)\n      .map((link) => `- ${link.kind}: ${link.title || link.targetId}${link.statusSnapshot ? ` (${link.statusSnapshot})` : ''}`)\n      .join('\\n')\n    : '';\n  const attachments = item.attachments?.length\n    ? item.attachments\n      .slice(0, 12)\n      .map((attachment) => `- ${attachment.fileName} (${attachment.mimeType}, ${attachment.size} bytes)`)\n      .join('\\n')\n    : '';\n  const text = [\n    'You are working inside a project work item. Treat this as the active task context, not as a new user message.',\n    '',\n    contextLine('Work item id', item.id),\n    contextLine('Project id', item.projectId),\n    contextLine('Title', item.title),\n    contextLine('Status', item.status),\n    contextLine('Priority', item.priority),\n    contextLine('Owner agent', item.ownerAgentId),\n    contextLine('Description', item.description),\n    contextLine('Next action', item.nextAction),\n    contextLine('Blocked reason', item.blockedReason),\n    item.dueAt ? contextLine('Due at', new Date(item.dueAt).toISOString()) : null,\n    links ? `Linked executions:\\n${links}` : null,\n    attachments ? `Attachments:\\n${attachments}` : null,\n    '',\n    'When you answer, keep the work item moving. If the discussion changes scope, call out the suggested work item update explicitly.',\n  ].filter(Boolean).join('\\n');\n\n  return {\n    kind: 'work_item',\n    sourceId: item.id,\n    version: String(item.updatedAt),\n    title: item.title,\n    text,\n  };\n}\n"],"mappings":";AAIA,SAAS,YAAY,OAAe,OAA0D;AAC5F,KAAI,UAAU,KAAA,KAAa,UAAU,KAAM,QAAO;CAClD,MAAM,OAAO,OAAO,MAAM,CAAC,MAAM;AACjC,QAAO,OAAO,GAAG,MAAM,IAAI,SAAS;;AAGtC,SAAgB,0BAA0B,MAAoC;CAC5E,MAAM,QAAQ,KAAK,OAAO,SACtB,KAAK,MACJ,MAAM,GAAG,GAAG,CACZ,KAAK,SAAS,KAAK,KAAK,KAAK,IAAI,KAAK,SAAS,KAAK,WAAW,KAAK,iBAAiB,KAAK,KAAK,eAAe,KAAK,KAAK,CACxH,KAAK,KAAK,GACX;CACJ,MAAM,cAAc,KAAK,aAAa,SAClC,KAAK,YACJ,MAAM,GAAG,GAAG,CACZ,KAAK,eAAe,KAAK,WAAW,SAAS,IAAI,WAAW,SAAS,IAAI,WAAW,KAAK,SAAS,CAClG,KAAK,KAAK,GACX;CACJ,MAAM,OAAO;EACX;EACA;EACA,YAAY,gBAAgB,KAAK,GAAG;EACpC,YAAY,cAAc,KAAK,UAAU;EACzC,YAAY,SAAS,KAAK,MAAM;EAChC,YAAY,UAAU,KAAK,OAAO;EAClC,YAAY,YAAY,KAAK,SAAS;EACtC,YAAY,eAAe,KAAK,aAAa;EAC7C,YAAY,eAAe,KAAK,YAAY;EAC5C,YAAY,eAAe,KAAK,WAAW;EAC3C,YAAY,kBAAkB,KAAK,cAAc;EACjD,KAAK,QAAQ,YAAY,UAAU,IAAI,KAAK,KAAK,MAAM,CAAC,aAAa,CAAC,GAAG;EACzE,QAAQ,uBAAuB,UAAU;EACzC,cAAc,iBAAiB,gBAAgB;EAC/C;EACA;EACD,CAAC,OAAO,QAAQ,CAAC,KAAK,KAAK;AAE5B,QAAO;EACL,MAAM;EACN,UAAU,KAAK;EACf,SAAS,OAAO,KAAK,UAAU;EAC/B,OAAO,KAAK;EACZ;EACD"}
+{"version":3,"file":"agent-context.js","names":[],"sources":["../../../src/work-items/agent-context.ts"],"sourcesContent":["import type { ImageContent } from '@earendil-works/pi-ai';\n\nimport type { AgentSourceContext } from '../agent/source-context/types.js';\nimport { readMediaReferenceBase64 } from '../media/media-reference.js';\nimport type { MediaRef } from '../media/types.js';\n\nimport type { WorkItem } from './types.js';\n\nconst MAX_NATIVE_VISION_IMAGES = 6;\nconst MAX_NATIVE_VISION_IMAGE_BYTES = 2 * 1024 * 1024;\n\nfunction contextLine(label: string, value: string | number | undefined | null): string | null {\n  if (value === undefined || value === null) return null;\n  const text = String(value).trim();\n  return text ? `${label}: ${text}` : null;\n}\n\nasync function loadWorkItemNativeVisionImages(item: WorkItem): Promise<ImageContent[]> {\n  const images: ImageContent[] = [];\n  for (const attachment of item.attachments ?? []) {\n    if (attachment.type !== 'image') continue;\n    if (!attachment.mimeType.toLowerCase().startsWith('image/')) continue;\n    if (attachment.size > MAX_NATIVE_VISION_IMAGE_BYTES) continue;\n    try {\n      const loaded = await readMediaReferenceBase64(attachment.mediaUri, MAX_NATIVE_VISION_IMAGE_BYTES);\n      images.push({ type: 'image', data: loaded.data, mimeType: attachment.mimeType || loaded.mimeType });\n      if (images.length >= MAX_NATIVE_VISION_IMAGES) break;\n    } catch {\n      continue;\n    }\n  }\n  return images;\n}\n\nfunction renderAttachmentLines(item: WorkItem, refs?: readonly MediaRef[]): string {\n  if (!item.attachments?.length) return '';\n  return item.attachments\n    .slice(0, 12)\n    .map((attachment, index) => {\n      const ref = refs?.[index];\n      return [\n        `- ${ref?.name ?? attachment.fileName} (${ref?.mimeType ?? attachment.mimeType}, ${ref?.size ?? attachment.size} bytes)`,\n        `  xopc-media-uri:${ref?.uri ?? attachment.mediaUri}`,\n        '  Use the read_media tool with the xopc-media-uri value when you need to inspect this attachment.',\n      ].join('\\n');\n    })\n    .join('\\n');\n}\n\nexport async function buildWorkItemAgentContext(\n  item: WorkItem,\n  opts: { attachments?: readonly MediaRef[]; includeImages?: boolean } = {},\n): Promise<AgentSourceContext> {\n  const links = item.links?.length\n    ? item.links\n      .slice(0, 12)\n      .map((link) => `- ${link.kind}: ${link.title || link.targetId}${link.statusSnapshot ? ` (${link.statusSnapshot})` : ''}`)\n      .join('\\n')\n    : '';\n  const attachments = renderAttachmentLines(item, opts.attachments);\n  const images = opts.includeImages === false ? [] : await loadWorkItemNativeVisionImages(item);\n  const text = [\n    'You are working inside a project work item. Treat this as the active task context, not as a new user message.',\n    '',\n    contextLine('Work item id', item.id),\n    contextLine('Project id', item.projectId),\n    contextLine('Title', item.title),\n    contextLine('Status', item.status),\n    contextLine('Priority', item.priority),\n    contextLine('Owner agent', item.ownerAgentId),\n    contextLine('Description', item.description),\n    contextLine('Next action', item.nextAction),\n    contextLine('Blocked reason', item.blockedReason),\n    item.dueAt ? contextLine('Due at', new Date(item.dueAt).toISOString()) : null,\n    links ? `Linked executions:\\n${links}` : null,\n    attachments ? `Attachments:\\n${attachments}` : null,\n    '',\n    'When you answer, keep the work item moving. If the discussion changes scope, call out the suggested work item update explicitly.',\n  ].filter(Boolean).join('\\n');\n\n  return {\n    kind: 'work_item',\n    sourceId: item.id,\n    version: String(item.updatedAt),\n    title: item.title,\n    text,\n    ...(images.length ? { images } : {}),\n  };\n}\n"],"mappings":";;AAQA,MAAM,2BAA2B;AACjC,MAAM,gCAAgC,IAAI,OAAO;AAEjD,SAAS,YAAY,OAAe,OAA0D;AAC5F,KAAI,UAAU,KAAA,KAAa,UAAU,KAAM,QAAO;CAClD,MAAM,OAAO,OAAO,MAAM,CAAC,MAAM;AACjC,QAAO,OAAO,GAAG,MAAM,IAAI,SAAS;;AAGtC,eAAe,+BAA+B,MAAyC;CACrF,MAAM,SAAyB,EAAE;AACjC,MAAK,MAAM,cAAc,KAAK,eAAe,EAAE,EAAE;AAC/C,MAAI,WAAW,SAAS,QAAS;AACjC,MAAI,CAAC,WAAW,SAAS,aAAa,CAAC,WAAW,SAAS,CAAE;AAC7D,MAAI,WAAW,OAAO,8BAA+B;AACrD,MAAI;GACF,MAAM,SAAS,MAAM,yBAAyB,WAAW,UAAU,8BAA8B;AACjG,UAAO,KAAK;IAAE,MAAM;IAAS,MAAM,OAAO;IAAM,UAAU,WAAW,YAAY,OAAO;IAAU,CAAC;AACnG,OAAI,OAAO,UAAU,yBAA0B;UACzC;AACN;;;AAGJ,QAAO;;AAGT,SAAS,sBAAsB,MAAgB,MAAoC;AACjF,KAAI,CAAC,KAAK,aAAa,OAAQ,QAAO;AACtC,QAAO,KAAK,YACT,MAAM,GAAG,GAAG,CACZ,KAAK,YAAY,UAAU;EAC1B,MAAM,MAAM,OAAO;AACnB,SAAO;GACL,KAAK,KAAK,QAAQ,WAAW,SAAS,IAAI,KAAK,YAAY,WAAW,SAAS,IAAI,KAAK,QAAQ,WAAW,KAAK;GAChH,oBAAoB,KAAK,OAAO,WAAW;GAC3C;GACD,CAAC,KAAK,KAAK;GACZ,CACD,KAAK,KAAK;;AAGf,eAAsB,0BACpB,MACA,OAAuE,EAAE,EAC5C;CAC7B,MAAM,QAAQ,KAAK,OAAO,SACtB,KAAK,MACJ,MAAM,GAAG,GAAG,CACZ,KAAK,SAAS,KAAK,KAAK,KAAK,IAAI,KAAK,SAAS,KAAK,WAAW,KAAK,iBAAiB,KAAK,KAAK,eAAe,KAAK,KAAK,CACxH,KAAK,KAAK,GACX;CACJ,MAAM,cAAc,sBAAsB,MAAM,KAAK,YAAY;CACjE,MAAM,SAAS,KAAK,kBAAkB,QAAQ,EAAE,GAAG,MAAM,+BAA+B,KAAK;CAC7F,MAAM,OAAO;EACX;EACA;EACA,YAAY,gBAAgB,KAAK,GAAG;EACpC,YAAY,cAAc,KAAK,UAAU;EACzC,YAAY,SAAS,KAAK,MAAM;EAChC,YAAY,UAAU,KAAK,OAAO;EAClC,YAAY,YAAY,KAAK,SAAS;EACtC,YAAY,eAAe,KAAK,aAAa;EAC7C,YAAY,eAAe,KAAK,YAAY;EAC5C,YAAY,eAAe,KAAK,WAAW;EAC3C,YAAY,kBAAkB,KAAK,cAAc;EACjD,KAAK,QAAQ,YAAY,UAAU,IAAI,KAAK,KAAK,MAAM,CAAC,aAAa,CAAC,GAAG;EACzE,QAAQ,uBAAuB,UAAU;EACzC,cAAc,iBAAiB,gBAAgB;EAC/C;EACA;EACD,CAAC,OAAO,QAAQ,CAAC,KAAK,KAAK;AAE5B,QAAO;EACL,MAAM;EACN,UAAU,KAAK;EACf,SAAS,OAAO,KAAK,UAAU;EAC/B,OAAO,KAAK;EACZ;EACA,GAAI,OAAO,SAAS,EAAE,QAAQ,GAAG,EAAE;EACpC"}

package/dist/src/work-items/work-item-service.d.ts

@@ -1,3 +1,4 @@
+import type { MediaRef } from '../media/types.js';
 import { WorkItemStore } from './work-item-store.js';
 import type { CreateWorkItemUpdateSuggestionInput, CreateWorkItemInput, UpdateWorkItemInput, WorkItem, WorkItemAttachment, WorkItemEvent, WorkItemLink, WorkItemListQuery, WorkItemListResult, WorkItemUpdateSuggestion, WorkItemUpdateSuggestionStatus } from './types.js';
 export declare const WORK_ITEM_ATTACHMENT_MAX_BYTES: number;
@@ -23,6 +24,7 @@ export declare class WorkItemService {
         buffer: Buffer;
     } | null>;
     removeAttachment(workItemId: string, attachmentId: string): Promise<WorkItemAttachment | null>;
+    snapshotAttachmentsForGoal(workItemId: string): Promise<MediaRef[] | null>;
     createUpdateSuggestion(workItemId: string, input: CreateWorkItemUpdateSuggestionInput): WorkItemUpdateSuggestion | null;
     listUpdateSuggestions(workItemId: string, status?: WorkItemUpdateSuggestionStatus): WorkItemUpdateSuggestion[];
     applyUpdateSuggestion(id: string): {

package/dist/src/work-items/work-item-service.js

@@ -1,3 +1,4 @@
+import { changedFieldsFromPatch, emitActivity, systemActivityActor, systemActivitySource } from "../activity/emitter.js";
 import { deleteMediaBuffer, mimeTypeFromMediaPath, saveMediaBuffer } from "../media/store.js";
 import { readMediaReference } from "../media/media-reference.js";
 import { WorkItemStore } from "./work-item-store.js";
@@ -11,6 +12,9 @@ function inferAttachmentType(mimeType) {
 	if (mimeType.startsWith("video/")) return "video";
 	return "file";
 }
+function attachmentTypeForMediaRef(attachment) {
+	return attachment.type === "file" ? "document" : attachment.type;
+}
 var WorkItemService = class {
 	constructor(store = new WorkItemStore()) {
 		this.store = store;
@@ -25,6 +29,27 @@ var WorkItemService = class {
 			status: item.status,
 			priority: item.priority
 		});
+		emitActivity({
+			type: "work_item.created",
+			primaryObject: {
+				kind: "work_item",
+				id: item.id,
+				title: item.title
+			},
+			actor: systemActivityActor(),
+			source: systemActivitySource(),
+			payload: {
+				title: item.title,
+				status: item.status,
+				priority: item.priority
+			},
+			scopes: [{
+				scopeKind: "project",
+				scopeId: projectId,
+				reason: "object_owner"
+			}],
+			nowMs: item.createdAt
+		});
 		return {
 			...item,
 			links: []
@@ -44,6 +69,31 @@ var WorkItemService = class {
 		});
 		else this.store.addEvent(id, "updated", patch);
 		if (!before.archivedAt && after.archivedAt) this.store.addEvent(id, "archived", { archivedAt: after.archivedAt });
+		const type = !before.archivedAt && after.archivedAt ? "work_item.archived" : before.status !== after.status ? "work_item.status_changed" : "work_item.updated";
+		emitActivity({
+			type,
+			primaryObject: {
+				kind: "work_item",
+				id: after.id,
+				title: after.title
+			},
+			actor: systemActivityActor(),
+			source: systemActivitySource(),
+			payload: {
+				changes: changedFieldsFromPatch(patch),
+				...type === "work_item.status_changed" ? {
+					from: before.status,
+					to: after.status
+				} : {},
+				...type === "work_item.archived" ? { archivedAt: after.archivedAt } : {}
+			},
+			scopes: [{
+				scopeKind: "project",
+				scopeId: after.projectId,
+				reason: "object_owner"
+			}],
+			nowMs: after.updatedAt
+		});
 		return after;
 	}
 	addLink(workItemId, input, eventType = "link_added") {
@@ -58,6 +108,28 @@ var WorkItemService = class {
 			title: link.title,
 			statusSnapshot: link.statusSnapshot
 		});
+		const item = this.store.get(workItemId);
+		if (item) emitActivity({
+			type: "work_item.link_added",
+			primaryObject: {
+				kind: "work_item",
+				id: item.id,
+				title: item.title
+			},
+			actor: systemActivityActor(),
+			source: systemActivitySource(),
+			payload: { target: {
+				kind: link.kind,
+				id: link.targetId,
+				title: link.title
+			} },
+			scopes: [{
+				scopeKind: "project",
+				scopeId: item.projectId,
+				reason: "object_owner"
+			}],
+			nowMs: link.createdAt
+		});
 		return link;
 	}
 	listEvents(workItemId) {
@@ -115,6 +187,31 @@ var WorkItemService = class {
 		});
 		return attachment;
 	}
+	async snapshotAttachmentsForGoal(workItemId) {
+		const item = this.store.get(workItemId);
+		if (!item) return null;
+		const refs = [];
+		for (const attachment of item.attachments ?? []) {
+			const { buffer } = await readMediaReference(attachment.mediaUri, WORK_ITEM_ATTACHMENT_MAX_BYTES);
+			const saved = await saveMediaBuffer(buffer, {
+				bucket: "inbound",
+				contentType: attachment.mimeType,
+				maxBytes: WORK_ITEM_ATTACHMENT_MAX_BYTES,
+				originalFilename: attachment.fileName
+			});
+			refs.push({
+				id: saved.id,
+				bucket: saved.bucket,
+				type: attachmentTypeForMediaRef(attachment),
+				mimeType: saved.contentType || attachment.mimeType,
+				name: attachment.fileName,
+				size: saved.size,
+				uri: saved.uri,
+				path: saved.path
+			});
+		}
+		return refs;
+	}
 	createUpdateSuggestion(workItemId, input) {
 		const suggestion = this.store.createUpdateSuggestion(workItemId, input);
 		if (!suggestion) return null;

package/dist/src/work-items/work-item-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"work-item-service.js","names":[],"sources":["../../../src/work-items/work-item-service.ts"],"sourcesContent":["import { deleteMediaBuffer, mimeTypeFromMediaPath, saveMediaBuffer } from '../media/store.js';\nimport { readMediaReference } from '../media/media-reference.js';\nimport { WorkItemStore } from './work-item-store.js';\nimport type {\n  CreateWorkItemUpdateSuggestionInput,\n  CreateWorkItemInput,\n  UpdateWorkItemInput,\n  WorkItem,\n  WorkItemAttachment,\n  WorkItemEvent,\n  WorkItemLink,\n  WorkItemListQuery,\n  WorkItemListResult,\n  WorkItemUpdateSuggestion,\n  WorkItemUpdateSuggestionStatus,\n} from './types.js';\n\nexport const WORK_ITEM_ATTACHMENT_MAX_BYTES = 25 * 1024 * 1024;\nexport const WORK_ITEM_ATTACHMENT_MAX_COUNT = 10;\nexport const WORK_ITEM_ATTACHMENT_UPLOAD_BODY_MAX_BYTES =\n  WORK_ITEM_ATTACHMENT_MAX_BYTES * WORK_ITEM_ATTACHMENT_MAX_COUNT + 1024 * 1024;\n\nfunction inferAttachmentType(mimeType: string): WorkItemAttachment['type'] {\n  if (mimeType.startsWith('image/')) return 'image';\n  if (mimeType.startsWith('audio/')) return 'audio';\n  if (mimeType.startsWith('video/')) return 'video';\n  return 'file';\n}\n\nexport class WorkItemService {\n  constructor(private readonly store = new WorkItemStore()) {}\n\n  listProjectWorkItems(projectId: string, query: WorkItemListQuery = {}): WorkItemListResult {\n    return this.store.list(projectId, query);\n  }\n\n  createProjectWorkItem(projectId: string, input: CreateWorkItemInput): WorkItem {\n    const item = this.store.create(projectId, input);\n    this.store.addEvent(item.id, 'created', { title: item.title, status: item.status, priority: item.priority });\n    return { ...item, links: [] };\n  }\n\n  getWorkItem(id: string): WorkItem | null {\n    return this.store.get(id);\n  }\n\n  updateWorkItem(id: string, patch: UpdateWorkItemInput): WorkItem | null {\n    const before = this.store.get(id);\n    if (!before) return null;\n    const after = this.store.update(id, patch);\n    if (!after) return null;\n    if (before.status !== after.status) {\n      this.store.addEvent(id, 'status_changed', { from: before.status, to: after.status });\n    } else {\n      this.store.addEvent(id, 'updated', patch);\n    }\n    if (!before.archivedAt && after.archivedAt) {\n      this.store.addEvent(id, 'archived', { archivedAt: after.archivedAt });\n    }\n    return after;\n  }\n\n  addLink(workItemId: string, input: Omit<WorkItemLink, 'id' | 'workItemId' | 'createdAt'>, eventType: Parameters<WorkItemStore['addEvent']>[1] = 'link_added'): WorkItemLink | null {\n    if (!this.store.get(workItemId)) return null;\n    const link = this.store.addLink({ ...input, workItemId });\n    this.store.addEvent(workItemId, eventType, { kind: link.kind, targetId: link.targetId, title: link.title, statusSnapshot: link.statusSnapshot });\n    return link;\n  }\n\n  listEvents(workItemId: string): WorkItemEvent[] {\n    return this.store.listEvents(workItemId);\n  }\n\n  listAttachments(workItemId: string): WorkItemAttachment[] | null {\n    if (!this.store.get(workItemId)) return null;\n    return this.store.listAttachments(workItemId);\n  }\n\n  async addAttachment(\n    workItemId: string,\n    file: { name: string; buffer: Buffer; mimeType: string },\n  ): Promise<WorkItemAttachment | null> {\n    if (!this.store.get(workItemId)) return null;\n    const saved = await saveMediaBuffer(file.buffer, {\n      bucket: 'work-item',\n      contentType: file.mimeType,\n      maxBytes: WORK_ITEM_ATTACHMENT_MAX_BYTES,\n      originalFilename: file.name,\n    });\n    const mimeType = saved.contentType || file.mimeType || mimeTypeFromMediaPath(saved.path);\n    const attachment = this.store.addAttachment({\n      workItemId,\n      mediaUri: saved.uri,\n      mediaId: saved.id,\n      bucket: saved.bucket,\n      type: inferAttachmentType(mimeType),\n      mimeType,\n      fileName: file.name.trim() || saved.id,\n      size: saved.size,\n    });\n    this.store.addEvent(workItemId, 'attachment_added', {\n      attachmentId: attachment.id,\n      fileName: attachment.fileName,\n      mimeType: attachment.mimeType,\n      size: attachment.size,\n    });\n    return attachment;\n  }\n\n  async readAttachment(\n    workItemId: string,\n    attachmentId: string,\n  ): Promise<{ attachment: WorkItemAttachment; buffer: Buffer } | null> {\n    const attachment = this.store.getAttachment(workItemId, attachmentId);\n    if (!attachment) return null;\n    const { buffer } = await readMediaReference(attachment.mediaUri, WORK_ITEM_ATTACHMENT_MAX_BYTES);\n    return { attachment, buffer };\n  }\n\n  async removeAttachment(workItemId: string, attachmentId: string): Promise<WorkItemAttachment | null> {\n    const attachment = this.store.removeAttachment(workItemId, attachmentId);\n    if (!attachment) return null;\n    await deleteMediaBuffer(attachment.mediaId, 'work-item');\n    this.store.addEvent(workItemId, 'attachment_removed', {\n      attachmentId: attachment.id,\n      fileName: attachment.fileName,\n      mimeType: attachment.mimeType,\n      size: attachment.size,\n    });\n    return attachment;\n  }\n\n  createUpdateSuggestion(workItemId: string, input: CreateWorkItemUpdateSuggestionInput): WorkItemUpdateSuggestion | null {\n    const suggestion = this.store.createUpdateSuggestion(workItemId, input);\n    if (!suggestion) return null;\n    this.store.addEvent(workItemId, 'update_suggestion_created', {\n      suggestionId: suggestion.id,\n      sourceKind: suggestion.sourceKind,\n      sourceId: suggestion.sourceId,\n      patch: suggestion.patch,\n      hasProgressNote: Boolean(suggestion.progressNote),\n    });\n    return suggestion;\n  }\n\n  listUpdateSuggestions(workItemId: string, status?: WorkItemUpdateSuggestionStatus): WorkItemUpdateSuggestion[] {\n    return this.store.listUpdateSuggestions(workItemId, status);\n  }\n\n  applyUpdateSuggestion(id: string): { item: WorkItem; suggestion: WorkItemUpdateSuggestion } | null {\n    const suggestion = this.store.getUpdateSuggestion(id);\n    if (!suggestion || suggestion.status !== 'pending') return null;\n    const before = this.store.get(suggestion.workItemId);\n    if (!before) return null;\n    const patch: UpdateWorkItemInput = {};\n    if (suggestion.patch.status !== undefined) patch.status = suggestion.patch.status;\n    if (suggestion.patch.nextAction !== undefined) patch.nextAction = suggestion.patch.nextAction;\n    if (suggestion.patch.blockedReason !== undefined) patch.blockedReason = suggestion.patch.blockedReason;\n    const item = Object.keys(patch).length > 0\n      ? this.updateWorkItem(suggestion.workItemId, patch)\n      : before;\n    if (!item) return null;\n    if (suggestion.progressNote) {\n      this.store.addEvent(suggestion.workItemId, 'progress_note_added', {\n        sourceKind: suggestion.sourceKind,\n        sourceId: suggestion.sourceId,\n        suggestionId: suggestion.id,\n        text: suggestion.progressNote,\n      });\n    }\n    const marked = this.store.markUpdateSuggestion(id, 'applied');\n    if (!marked) return null;\n    this.store.addEvent(suggestion.workItemId, 'update_suggestion_applied', {\n      suggestionId: suggestion.id,\n      sourceKind: suggestion.sourceKind,\n      sourceId: suggestion.sourceId,\n      patch,\n      previousStatus: before.status,\n      nextStatus: item.status,\n    });\n    return { item, suggestion: marked };\n  }\n\n  dismissUpdateSuggestion(id: string): WorkItemUpdateSuggestion | null {\n    const suggestion = this.store.getUpdateSuggestion(id);\n    if (!suggestion || suggestion.status !== 'pending') return null;\n    const marked = this.store.markUpdateSuggestion(id, 'dismissed');\n    if (marked) {\n      this.store.addEvent(marked.workItemId, 'update_suggestion_dismissed', {\n        suggestionId: marked.id,\n        sourceKind: marked.sourceKind,\n        sourceId: marked.sourceId,\n      });\n    }\n    return marked;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"work-item-service.js","names":[],"sources":["../../../src/work-items/work-item-service.ts"],"sourcesContent":["import { changedFieldsFromPatch, emitActivity, systemActivityActor, systemActivitySource } from '../activity/emitter.js';\nimport { deleteMediaBuffer, mimeTypeFromMediaPath, saveMediaBuffer } from '../media/store.js';\nimport { readMediaReference } from '../media/media-reference.js';\nimport type { MediaRef } from '../media/types.js';\nimport { WorkItemStore } from './work-item-store.js';\nimport type {\n  CreateWorkItemUpdateSuggestionInput,\n  CreateWorkItemInput,\n  UpdateWorkItemInput,\n  WorkItem,\n  WorkItemAttachment,\n  WorkItemEvent,\n  WorkItemLink,\n  WorkItemListQuery,\n  WorkItemListResult,\n  WorkItemUpdateSuggestion,\n  WorkItemUpdateSuggestionStatus,\n} from './types.js';\n\nexport const WORK_ITEM_ATTACHMENT_MAX_BYTES = 25 * 1024 * 1024;\nexport const WORK_ITEM_ATTACHMENT_MAX_COUNT = 10;\nexport const WORK_ITEM_ATTACHMENT_UPLOAD_BODY_MAX_BYTES =\n  WORK_ITEM_ATTACHMENT_MAX_BYTES * WORK_ITEM_ATTACHMENT_MAX_COUNT + 1024 * 1024;\n\nfunction inferAttachmentType(mimeType: string): WorkItemAttachment['type'] {\n  if (mimeType.startsWith('image/')) return 'image';\n  if (mimeType.startsWith('audio/')) return 'audio';\n  if (mimeType.startsWith('video/')) return 'video';\n  return 'file';\n}\n\nfunction attachmentTypeForMediaRef(attachment: WorkItemAttachment): string {\n  return attachment.type === 'file' ? 'document' : attachment.type;\n}\n\nexport class WorkItemService {\n  constructor(private readonly store = new WorkItemStore()) {}\n\n  listProjectWorkItems(projectId: string, query: WorkItemListQuery = {}): WorkItemListResult {\n    return this.store.list(projectId, query);\n  }\n\n  createProjectWorkItem(projectId: string, input: CreateWorkItemInput): WorkItem {\n    const item = this.store.create(projectId, input);\n    this.store.addEvent(item.id, 'created', { title: item.title, status: item.status, priority: item.priority });\n    emitActivity({\n      type: 'work_item.created',\n      primaryObject: { kind: 'work_item', id: item.id, title: item.title },\n      actor: systemActivityActor(),\n      source: systemActivitySource(),\n      payload: { title: item.title, status: item.status, priority: item.priority },\n      scopes: [{ scopeKind: 'project', scopeId: projectId, reason: 'object_owner' }],\n      nowMs: item.createdAt,\n    });\n    return { ...item, links: [] };\n  }\n\n  getWorkItem(id: string): WorkItem | null {\n    return this.store.get(id);\n  }\n\n  updateWorkItem(id: string, patch: UpdateWorkItemInput): WorkItem | null {\n    const before = this.store.get(id);\n    if (!before) return null;\n    const after = this.store.update(id, patch);\n    if (!after) return null;\n    if (before.status !== after.status) {\n      this.store.addEvent(id, 'status_changed', { from: before.status, to: after.status });\n    } else {\n      this.store.addEvent(id, 'updated', patch);\n    }\n    if (!before.archivedAt && after.archivedAt) {\n      this.store.addEvent(id, 'archived', { archivedAt: after.archivedAt });\n    }\n    const type = !before.archivedAt && after.archivedAt\n      ? 'work_item.archived'\n      : before.status !== after.status\n        ? 'work_item.status_changed'\n        : 'work_item.updated';\n    emitActivity({\n      type,\n      primaryObject: { kind: 'work_item', id: after.id, title: after.title },\n      actor: systemActivityActor(),\n      source: systemActivitySource(),\n      payload: {\n        changes: changedFieldsFromPatch(patch as Record<string, unknown>),\n        ...(type === 'work_item.status_changed' ? { from: before.status, to: after.status } : {}),\n        ...(type === 'work_item.archived' ? { archivedAt: after.archivedAt } : {}),\n      },\n      scopes: [{ scopeKind: 'project', scopeId: after.projectId, reason: 'object_owner' }],\n      nowMs: after.updatedAt,\n    });\n    return after;\n  }\n\n  addLink(workItemId: string, input: Omit<WorkItemLink, 'id' | 'workItemId' | 'createdAt'>, eventType: Parameters<WorkItemStore['addEvent']>[1] = 'link_added'): WorkItemLink | null {\n    if (!this.store.get(workItemId)) return null;\n    const link = this.store.addLink({ ...input, workItemId });\n    this.store.addEvent(workItemId, eventType, { kind: link.kind, targetId: link.targetId, title: link.title, statusSnapshot: link.statusSnapshot });\n    const item = this.store.get(workItemId);\n    if (item) {\n      emitActivity({\n        type: 'work_item.link_added',\n        primaryObject: { kind: 'work_item', id: item.id, title: item.title },\n        actor: systemActivityActor(),\n        source: systemActivitySource(),\n        payload: { target: { kind: link.kind, id: link.targetId, title: link.title } },\n        scopes: [{ scopeKind: 'project', scopeId: item.projectId, reason: 'object_owner' }],\n        nowMs: link.createdAt,\n      });\n    }\n    return link;\n  }\n\n  listEvents(workItemId: string): WorkItemEvent[] {\n    return this.store.listEvents(workItemId);\n  }\n\n  listAttachments(workItemId: string): WorkItemAttachment[] | null {\n    if (!this.store.get(workItemId)) return null;\n    return this.store.listAttachments(workItemId);\n  }\n\n  async addAttachment(\n    workItemId: string,\n    file: { name: string; buffer: Buffer; mimeType: string },\n  ): Promise<WorkItemAttachment | null> {\n    if (!this.store.get(workItemId)) return null;\n    const saved = await saveMediaBuffer(file.buffer, {\n      bucket: 'work-item',\n      contentType: file.mimeType,\n      maxBytes: WORK_ITEM_ATTACHMENT_MAX_BYTES,\n      originalFilename: file.name,\n    });\n    const mimeType = saved.contentType || file.mimeType || mimeTypeFromMediaPath(saved.path);\n    const attachment = this.store.addAttachment({\n      workItemId,\n      mediaUri: saved.uri,\n      mediaId: saved.id,\n      bucket: saved.bucket,\n      type: inferAttachmentType(mimeType),\n      mimeType,\n      fileName: file.name.trim() || saved.id,\n      size: saved.size,\n    });\n    this.store.addEvent(workItemId, 'attachment_added', {\n      attachmentId: attachment.id,\n      fileName: attachment.fileName,\n      mimeType: attachment.mimeType,\n      size: attachment.size,\n    });\n    return attachment;\n  }\n\n  async readAttachment(\n    workItemId: string,\n    attachmentId: string,\n  ): Promise<{ attachment: WorkItemAttachment; buffer: Buffer } | null> {\n    const attachment = this.store.getAttachment(workItemId, attachmentId);\n    if (!attachment) return null;\n    const { buffer } = await readMediaReference(attachment.mediaUri, WORK_ITEM_ATTACHMENT_MAX_BYTES);\n    return { attachment, buffer };\n  }\n\n  async removeAttachment(workItemId: string, attachmentId: string): Promise<WorkItemAttachment | null> {\n    const attachment = this.store.removeAttachment(workItemId, attachmentId);\n    if (!attachment) return null;\n    await deleteMediaBuffer(attachment.mediaId, 'work-item');\n    this.store.addEvent(workItemId, 'attachment_removed', {\n      attachmentId: attachment.id,\n      fileName: attachment.fileName,\n      mimeType: attachment.mimeType,\n      size: attachment.size,\n    });\n    return attachment;\n  }\n\n  async snapshotAttachmentsForGoal(workItemId: string): Promise<MediaRef[] | null> {\n    const item = this.store.get(workItemId);\n    if (!item) return null;\n    const refs: MediaRef[] = [];\n    for (const attachment of item.attachments ?? []) {\n      const { buffer } = await readMediaReference(attachment.mediaUri, WORK_ITEM_ATTACHMENT_MAX_BYTES);\n      const saved = await saveMediaBuffer(buffer, {\n        bucket: 'inbound',\n        contentType: attachment.mimeType,\n        maxBytes: WORK_ITEM_ATTACHMENT_MAX_BYTES,\n        originalFilename: attachment.fileName,\n      });\n      refs.push({\n        id: saved.id,\n        bucket: saved.bucket,\n        type: attachmentTypeForMediaRef(attachment),\n        mimeType: saved.contentType || attachment.mimeType,\n        name: attachment.fileName,\n        size: saved.size,\n        uri: saved.uri,\n        path: saved.path,\n      });\n    }\n    return refs;\n  }\n\n  createUpdateSuggestion(workItemId: string, input: CreateWorkItemUpdateSuggestionInput): WorkItemUpdateSuggestion | null {\n    const suggestion = this.store.createUpdateSuggestion(workItemId, input);\n    if (!suggestion) return null;\n    this.store.addEvent(workItemId, 'update_suggestion_created', {\n      suggestionId: suggestion.id,\n      sourceKind: suggestion.sourceKind,\n      sourceId: suggestion.sourceId,\n      patch: suggestion.patch,\n      hasProgressNote: Boolean(suggestion.progressNote),\n    });\n    return suggestion;\n  }\n\n  listUpdateSuggestions(workItemId: string, status?: WorkItemUpdateSuggestionStatus): WorkItemUpdateSuggestion[] {\n    return this.store.listUpdateSuggestions(workItemId, status);\n  }\n\n  applyUpdateSuggestion(id: string): { item: WorkItem; suggestion: WorkItemUpdateSuggestion } | null {\n    const suggestion = this.store.getUpdateSuggestion(id);\n    if (!suggestion || suggestion.status !== 'pending') return null;\n    const before = this.store.get(suggestion.workItemId);\n    if (!before) return null;\n    const patch: UpdateWorkItemInput = {};\n    if (suggestion.patch.status !== undefined) patch.status = suggestion.patch.status;\n    if (suggestion.patch.nextAction !== undefined) patch.nextAction = suggestion.patch.nextAction;\n    if (suggestion.patch.blockedReason !== undefined) patch.blockedReason = suggestion.patch.blockedReason;\n    const item = Object.keys(patch).length > 0\n      ? this.updateWorkItem(suggestion.workItemId, patch)\n      : before;\n    if (!item) return null;\n    if (suggestion.progressNote) {\n      this.store.addEvent(suggestion.workItemId, 'progress_note_added', {\n        sourceKind: suggestion.sourceKind,\n        sourceId: suggestion.sourceId,\n        suggestionId: suggestion.id,\n        text: suggestion.progressNote,\n      });\n    }\n    const marked = this.store.markUpdateSuggestion(id, 'applied');\n    if (!marked) return null;\n    this.store.addEvent(suggestion.workItemId, 'update_suggestion_applied', {\n      suggestionId: suggestion.id,\n      sourceKind: suggestion.sourceKind,\n      sourceId: suggestion.sourceId,\n      patch,\n      previousStatus: before.status,\n      nextStatus: item.status,\n    });\n    return { item, suggestion: marked };\n  }\n\n  dismissUpdateSuggestion(id: string): WorkItemUpdateSuggestion | null {\n    const suggestion = this.store.getUpdateSuggestion(id);\n    if (!suggestion || suggestion.status !== 'pending') return null;\n    const marked = this.store.markUpdateSuggestion(id, 'dismissed');\n    if (marked) {\n      this.store.addEvent(marked.workItemId, 'update_suggestion_dismissed', {\n        suggestionId: marked.id,\n        sourceKind: marked.sourceKind,\n        sourceId: marked.sourceId,\n      });\n    }\n    return marked;\n  }\n}\n"],"mappings":";;;;;AAmBA,MAAa,iCAAiC,KAAK,OAAO;AAC1D,MAAa,iCAAiC;AAC9C,MAAa,6CACX,iCAAA,KAAkE,OAAO;AAE3E,SAAS,oBAAoB,UAA8C;AACzE,KAAI,SAAS,WAAW,SAAS,CAAE,QAAO;AAC1C,KAAI,SAAS,WAAW,SAAS,CAAE,QAAO;AAC1C,KAAI,SAAS,WAAW,SAAS,CAAE,QAAO;AAC1C,QAAO;;AAGT,SAAS,0BAA0B,YAAwC;AACzE,QAAO,WAAW,SAAS,SAAS,aAAa,WAAW;;AAG9D,IAAa,kBAAb,MAA6B;CAC3B,YAAY,QAAyB,IAAI,eAAe,EAAE;AAA7B,OAAA,QAAA;;CAE7B,qBAAqB,WAAmB,QAA2B,EAAE,EAAsB;AACzF,SAAO,KAAK,MAAM,KAAK,WAAW,MAAM;;CAG1C,sBAAsB,WAAmB,OAAsC;EAC7E,MAAM,OAAO,KAAK,MAAM,OAAO,WAAW,MAAM;AAChD,OAAK,MAAM,SAAS,KAAK,IAAI,WAAW;GAAE,OAAO,KAAK;GAAO,QAAQ,KAAK;GAAQ,UAAU,KAAK;GAAU,CAAC;AAC5G,eAAa;GACX,MAAM;GACN,eAAe;IAAE,MAAM;IAAa,IAAI,KAAK;IAAI,OAAO,KAAK;IAAO;GACpE,OAAO,qBAAqB;GAC5B,QAAQ,sBAAsB;GAC9B,SAAS;IAAE,OAAO,KAAK;IAAO,QAAQ,KAAK;IAAQ,UAAU,KAAK;IAAU;GAC5E,QAAQ,CAAC;IAAE,WAAW;IAAW,SAAS;IAAW,QAAQ;IAAgB,CAAC;GAC9E,OAAO,KAAK;GACb,CAAC;AACF,SAAO;GAAE,GAAG;GAAM,OAAO,EAAE;GAAE;;CAG/B,YAAY,IAA6B;AACvC,SAAO,KAAK,MAAM,IAAI,GAAG;;CAG3B,eAAe,IAAY,OAA6C;EACtE,MAAM,SAAS,KAAK,MAAM,IAAI,GAAG;AACjC,MAAI,CAAC,OAAQ,QAAO;EACpB,MAAM,QAAQ,KAAK,MAAM,OAAO,IAAI,MAAM;AAC1C,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI,OAAO,WAAW,MAAM,OAC1B,MAAK,MAAM,SAAS,IAAI,kBAAkB;GAAE,MAAM,OAAO;GAAQ,IAAI,MAAM;GAAQ,CAAC;MAEpF,MAAK,MAAM,SAAS,IAAI,WAAW,MAAM;AAE3C,MAAI,CAAC,OAAO,cAAc,MAAM,WAC9B,MAAK,MAAM,SAAS,IAAI,YAAY,EAAE,YAAY,MAAM,YAAY,CAAC;EAEvE,MAAM,OAAO,CAAC,OAAO,cAAc,MAAM,aACrC,uBACA,OAAO,WAAW,MAAM,SACtB,6BACA;AACN,eAAa;GACX;GACA,eAAe;IAAE,MAAM;IAAa,IAAI,MAAM;IAAI,OAAO,MAAM;IAAO;GACtE,OAAO,qBAAqB;GAC5B,QAAQ,sBAAsB;GAC9B,SAAS;IACP,SAAS,uBAAuB,MAAiC;IACjE,GAAI,SAAS,6BAA6B;KAAE,MAAM,OAAO;KAAQ,IAAI,MAAM;KAAQ,GAAG,EAAE;IACxF,GAAI,SAAS,uBAAuB,EAAE,YAAY,MAAM,YAAY,GAAG,EAAE;IAC1E;GACD,QAAQ,CAAC;IAAE,WAAW;IAAW,SAAS,MAAM;IAAW,QAAQ;IAAgB,CAAC;GACpF,OAAO,MAAM;GACd,CAAC;AACF,SAAO;;CAGT,QAAQ,YAAoB,OAA8D,YAAsD,cAAmC;AACjL,MAAI,CAAC,KAAK,MAAM,IAAI,WAAW,CAAE,QAAO;EACxC,MAAM,OAAO,KAAK,MAAM,QAAQ;GAAE,GAAG;GAAO;GAAY,CAAC;AACzD,OAAK,MAAM,SAAS,YAAY,WAAW;GAAE,MAAM,KAAK;GAAM,UAAU,KAAK;GAAU,OAAO,KAAK;GAAO,gBAAgB,KAAK;GAAgB,CAAC;EAChJ,MAAM,OAAO,KAAK,MAAM,IAAI,WAAW;AACvC,MAAI,KACF,cAAa;GACX,MAAM;GACN,eAAe;IAAE,MAAM;IAAa,IAAI,KAAK;IAAI,OAAO,KAAK;IAAO;GACpE,OAAO,qBAAqB;GAC5B,QAAQ,sBAAsB;GAC9B,SAAS,EAAE,QAAQ;IAAE,MAAM,KAAK;IAAM,IAAI,KAAK;IAAU,OAAO,KAAK;IAAO,EAAE;GAC9E,QAAQ,CAAC;IAAE,WAAW;IAAW,SAAS,KAAK;IAAW,QAAQ;IAAgB,CAAC;GACnF,OAAO,KAAK;GACb,CAAC;AAEJ,SAAO;;CAGT,WAAW,YAAqC;AAC9C,SAAO,KAAK,MAAM,WAAW,WAAW;;CAG1C,gBAAgB,YAAiD;AAC/D,MAAI,CAAC,KAAK,MAAM,IAAI,WAAW,CAAE,QAAO;AACxC,SAAO,KAAK,MAAM,gBAAgB,WAAW;;CAG/C,MAAM,cACJ,YACA,MACoC;AACpC,MAAI,CAAC,KAAK,MAAM,IAAI,WAAW,CAAE,QAAO;EACxC,MAAM,QAAQ,MAAM,gBAAgB,KAAK,QAAQ;GAC/C,QAAQ;GACR,aAAa,KAAK;GAClB,UAAU;GACV,kBAAkB,KAAK;GACxB,CAAC;EACF,MAAM,WAAW,MAAM,eAAe,KAAK,YAAY,sBAAsB,MAAM,KAAK;EACxF,MAAM,aAAa,KAAK,MAAM,cAAc;GAC1C;GACA,UAAU,MAAM;GAChB,SAAS,MAAM;GACf,QAAQ,MAAM;GACd,MAAM,oBAAoB,SAAS;GACnC;GACA,UAAU,KAAK,KAAK,MAAM,IAAI,MAAM;GACpC,MAAM,MAAM;GACb,CAAC;AACF,OAAK,MAAM,SAAS,YAAY,oBAAoB;GAClD,cAAc,WAAW;GACzB,UAAU,WAAW;GACrB,UAAU,WAAW;GACrB,MAAM,WAAW;GAClB,CAAC;AACF,SAAO;;CAGT,MAAM,eACJ,YACA,cACoE;EACpE,MAAM,aAAa,KAAK,MAAM,cAAc,YAAY,aAAa;AACrE,MAAI,CAAC,WAAY,QAAO;EACxB,MAAM,EAAE,WAAW,MAAM,mBAAmB,WAAW,UAAU,+BAA+B;AAChG,SAAO;GAAE;GAAY;GAAQ;;CAG/B,MAAM,iBAAiB,YAAoB,cAA0D;EACnG,MAAM,aAAa,KAAK,MAAM,iBAAiB,YAAY,aAAa;AACxE,MAAI,CAAC,WAAY,QAAO;AACxB,QAAM,kBAAkB,WAAW,SAAS,YAAY;AACxD,OAAK,MAAM,SAAS,YAAY,sBAAsB;GACpD,cAAc,WAAW;GACzB,UAAU,WAAW;GACrB,UAAU,WAAW;GACrB,MAAM,WAAW;GAClB,CAAC;AACF,SAAO;;CAGT,MAAM,2BAA2B,YAAgD;EAC/E,MAAM,OAAO,KAAK,MAAM,IAAI,WAAW;AACvC,MAAI,CAAC,KAAM,QAAO;EAClB,MAAM,OAAmB,EAAE;AAC3B,OAAK,MAAM,cAAc,KAAK,eAAe,EAAE,EAAE;GAC/C,MAAM,EAAE,WAAW,MAAM,mBAAmB,WAAW,UAAU,+BAA+B;GAChG,MAAM,QAAQ,MAAM,gBAAgB,QAAQ;IAC1C,QAAQ;IACR,aAAa,WAAW;IACxB,UAAU;IACV,kBAAkB,WAAW;IAC9B,CAAC;AACF,QAAK,KAAK;IACR,IAAI,MAAM;IACV,QAAQ,MAAM;IACd,MAAM,0BAA0B,WAAW;IAC3C,UAAU,MAAM,eAAe,WAAW;IAC1C,MAAM,WAAW;IACjB,MAAM,MAAM;IACZ,KAAK,MAAM;IACX,MAAM,MAAM;IACb,CAAC;;AAEJ,SAAO;;CAGT,uBAAuB,YAAoB,OAA6E;EACtH,MAAM,aAAa,KAAK,MAAM,uBAAuB,YAAY,MAAM;AACvE,MAAI,CAAC,WAAY,QAAO;AACxB,OAAK,MAAM,SAAS,YAAY,6BAA6B;GAC3D,cAAc,WAAW;GACzB,YAAY,WAAW;GACvB,UAAU,WAAW;GACrB,OAAO,WAAW;GAClB,iBAAiB,QAAQ,WAAW,aAAa;GAClD,CAAC;AACF,SAAO;;CAGT,sBAAsB,YAAoB,QAAqE;AAC7G,SAAO,KAAK,MAAM,sBAAsB,YAAY,OAAO;;CAG7D,sBAAsB,IAA6E;EACjG,MAAM,aAAa,KAAK,MAAM,oBAAoB,GAAG;AACrD,MAAI,CAAC,cAAc,WAAW,WAAW,UAAW,QAAO;EAC3D,MAAM,SAAS,KAAK,MAAM,IAAI,WAAW,WAAW;AACpD,MAAI,CAAC,OAAQ,QAAO;EACpB,MAAM,QAA6B,EAAE;AACrC,MAAI,WAAW,MAAM,WAAW,KAAA,EAAW,OAAM,SAAS,WAAW,MAAM;AAC3E,MAAI,WAAW,MAAM,eAAe,KAAA,EAAW,OAAM,aAAa,WAAW,MAAM;AACnF,MAAI,WAAW,MAAM,kBAAkB,KAAA,EAAW,OAAM,gBAAgB,WAAW,MAAM;EACzF,MAAM,OAAO,OAAO,KAAK,MAAM,CAAC,SAAS,IACrC,KAAK,eAAe,WAAW,YAAY,MAAM,GACjD;AACJ,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI,WAAW,aACb,MAAK,MAAM,SAAS,WAAW,YAAY,uBAAuB;GAChE,YAAY,WAAW;GACvB,UAAU,WAAW;GACrB,cAAc,WAAW;GACzB,MAAM,WAAW;GAClB,CAAC;EAEJ,MAAM,SAAS,KAAK,MAAM,qBAAqB,IAAI,UAAU;AAC7D,MAAI,CAAC,OAAQ,QAAO;AACpB,OAAK,MAAM,SAAS,WAAW,YAAY,6BAA6B;GACtE,cAAc,WAAW;GACzB,YAAY,WAAW;GACvB,UAAU,WAAW;GACrB;GACA,gBAAgB,OAAO;GACvB,YAAY,KAAK;GAClB,CAAC;AACF,SAAO;GAAE;GAAM,YAAY;GAAQ;;CAGrC,wBAAwB,IAA6C;EACnE,MAAM,aAAa,KAAK,MAAM,oBAAoB,GAAG;AACrD,MAAI,CAAC,cAAc,WAAW,WAAW,UAAW,QAAO;EAC3D,MAAM,SAAS,KAAK,MAAM,qBAAqB,IAAI,YAAY;AAC/D,MAAI,OACF,MAAK,MAAM,SAAS,OAAO,YAAY,+BAA+B;GACpE,cAAc,OAAO;GACrB,YAAY,OAAO;GACnB,UAAU,OAAO;GAClB,CAAC;AAEJ,SAAO"}

package/dist/src/workflows/draft/workflow-draft-service.js

@@ -1,6 +1,6 @@
-import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../../providers/index.js";
 import { resolveModelRef } from "../../config/agent-typed-models.js";
 import { buildWorkflowDraftPrompt, buildWorkflowDraftRepairPrompt } from "./workflow-draft-prompt.js";

package/dist/src/workflows/service/workflow-session-bridge.js

@@ -1,8 +1,8 @@
+import "../../session/types.js";
 import { renderWorkflowText } from "../../agent/workflow/snapshot.js";
 import { runViewToSnapshot } from "./run-view-to-snapshot.js";
 import { GoalWorkflowJudge } from "../../goals/goal-workflow-judge.js";
 import "../../goals/index.js";
-import "../../session/types.js";
 import { isTerminalWorkflowRunStatus } from "../domain/run.js";
 import "../domain/index.js";
 import { buildWorkflowRunSessionKey } from "./workflow-session-key.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.125",
+  "version": "0.0.127",
   "description": "Local-first AI system that remembers context, coordinates AI, and sustains long-term progress.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -65,10 +65,10 @@
     "node": ">=22.19.0"
   },
   "dependencies": {
-    "@earendil-works/pi-agent-core": "^0.80.3",
-    "@earendil-works/pi-ai": "^0.80.3",
-    "@earendil-works/pi-coding-agent": "^0.80.3",
-    "@earendil-works/pi-tui": "^0.80.3",
+    "@earendil-works/pi-agent-core": "^0.80.6",
+    "@earendil-works/pi-ai": "^0.80.6",
+    "@earendil-works/pi-coding-agent": "^0.80.6",
+    "@earendil-works/pi-tui": "^0.80.6",
     "@grammyjs/runner": "^2.0.3",
     "@hono/node-server": "^2.0.4",
     "@inquirer/prompts": "^8.5.0",

package/skills/creative/hatch-pet/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: hatch-pet
+description: Create and install a custom animated xopc desktop pet from a user description.
+metadata:
+  xopc:
+    activates_capabilities:
+      - desktop-pet-authoring
+---
+
+# Hatch Pet
+
+Use this skill when the user wants to create, customize, refine, or install an xopc desktop pet.
+
+## Conversation flow
+
+Do not jump straight to `create_desktop_pet` when the pet idea is vague. First guide the user with `clarify` so the final pet has a clear visual identity, personality, and action set.
+
+Use at most 3 concise `clarify` calls before creating or updating the pet. Each call should ask one short question. Provide `choices` when useful, set a sensible `default`, and write the question so the user knows they can type their own custom answer instead of picking a listed option.
+
+Recommended questions for a new pet:
+
+1. Base character: ask what kind of pet it should be.
+   - Choices: `Tiny robot companion`, `Cute animal mascot`, `Plant or object spirit`, `Describe my own`
+   - Default: `Tiny robot companion`
+2. Visual mood: ask what style or vibe it should have.
+   - Choices: `Soft and cute`, `Techy and energetic`, `Calm and focused`, `Describe my own`
+   - Default: `Soft and cute`
+3. Signature work behavior: ask which behavior should be most recognizable.
+   - Choices: `Typing at a laptop`, `Searching a toolbox`, `Celebrating completed work`, `Describe my own`
+   - Default: `Typing at a laptop`
+
+For an existing pet update, ask only what is missing for the requested refinement:
+
+1. Refinement target: ask what should change.
+   - Choices: `Appearance`, `Personality and dialogue`, `Animations and work actions`, `Everything`
+   - Default: `Animations and work actions`
+2. Update behavior: overwrite the same custom pet by default. Ask about renaming or creating a variant only if the user explicitly requests a separate version.
+
+Skip clarification when the user already supplied enough detail, or when they explicitly asked you to choose. In that case, choose a coherent cute desktop-helper design and proceed.
+
+## Prompt assembly
+
+After clarification, synthesize one complete `prompt` for `create_desktop_pet`. Include:
+
+- The pet's base form, silhouette, colors, face/expression, and visual style.
+- Personality and short dialogue tone.
+- Required desktop-helper animation ideas: idle, greeting, thinking, typing at a laptop, searching through a toolbox, reading/searching, file or terminal work, success celebration, and error/blocked reaction.
+- Any user-requested refinements, constraints, or brand cues.
+- A note that the pet should read clearly at small desktop size and feel cute, lively, and polished.
+
+Do not expose implementation details to the user unless they ask.
+
+## Tool call
+
+Once the pet concept is clear, call `create_desktop_pet` with:
+
+- `mode`: use `create` for a new pet; use `update` when the user is refining an existing custom pet.
+- `petId`: required for `update`; pass the id from Settings, including the `custom:` prefix if present.
+- `name`: a short display name when the user provides or implies one.
+- `prompt`: the full visual and personality description, including all requested refinements.
+- `description`: a concise one-line description for Settings.
+
+When updating an existing pet, keep the same name unless the user explicitly asks to rename it. After the tool succeeds, tell the user the pet was installed under `~/.xopc/pets` and can be selected from Settings > Pet.