@xopcai/xopc 0.0.123 → 0.0.125

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

@@ -0,0 +1,3 @@
+import type { AgentSourceContext } from '../agent/source-context/types.js';
+import type { WorkItem } from './types.js';
+export declare function buildWorkItemAgentContext(item: WorkItem): AgentSourceContext;

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

@@ -0,0 +1,39 @@
+//#region src/work-items/agent-context.ts
+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) {
+	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 text = [
+		"You are working inside a project work item. Treat this as the active task context, not as a new user message.",
+		"",
+		contextLine("Work item id", item.id),
+		contextLine("Project id", item.projectId),
+		contextLine("Title", item.title),
+		contextLine("Status", item.status),
+		contextLine("Priority", item.priority),
+		contextLine("Owner agent", item.ownerAgentId),
+		contextLine("Description", item.description),
+		contextLine("Next action", item.nextAction),
+		contextLine("Blocked reason", item.blockedReason),
+		item.dueAt ? contextLine("Due at", new Date(item.dueAt).toISOString()) : null,
+		links ? `Linked executions:\n${links}` : null,
+		attachments ? `Attachments:\n${attachments}` : null,
+		"",
+		"When you answer, keep the work item moving. If the discussion changes scope, call out the suggested work item update explicitly."
+	].filter(Boolean).join("\n");
+	return {
+		kind: "work_item",
+		sourceId: item.id,
+		version: String(item.updatedAt),
+		title: item.title,
+		text
+	};
+}
+//#endregion
+export { buildWorkItemAgentContext };
+
+//# sourceMappingURL=agent-context.js.map

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

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

package/dist/src/work-items/index.d.ts

@@ -0,0 +1,4 @@
+export { WorkItemService, WORK_ITEM_ATTACHMENT_MAX_BYTES, WORK_ITEM_ATTACHMENT_MAX_COUNT, WORK_ITEM_ATTACHMENT_UPLOAD_BODY_MAX_BYTES, } from './work-item-service.js';
+export { WorkItemStore } from './work-item-store.js';
+export { buildWorkItemAgentContext } from './agent-context.js';
+export type * from './types.js';

package/dist/src/work-items/index.js

@@ -0,0 +1,4 @@
+import { WorkItemStore } from "./work-item-store.js";
+import { WORK_ITEM_ATTACHMENT_MAX_BYTES, WORK_ITEM_ATTACHMENT_MAX_COUNT, WORK_ITEM_ATTACHMENT_UPLOAD_BODY_MAX_BYTES, WorkItemService } from "./work-item-service.js";
+import { buildWorkItemAgentContext } from "./agent-context.js";
+export { WORK_ITEM_ATTACHMENT_MAX_BYTES, WORK_ITEM_ATTACHMENT_MAX_COUNT, WORK_ITEM_ATTACHMENT_UPLOAD_BODY_MAX_BYTES, WorkItemService, WorkItemStore, buildWorkItemAgentContext };

package/dist/src/work-items/types.d.ts

@@ -0,0 +1,112 @@
+export type WorkItemStatus = 'backlog' | 'todo' | 'in_progress' | 'blocked' | 'needs_input' | 'in_review' | 'done' | 'cancelled';
+export type WorkItemPriority = 'urgent' | 'high' | 'normal' | 'low';
+export type WorkItemLinkKind = 'chat' | 'goal' | 'workflow_run' | 'automation' | 'note';
+export type WorkItemEventType = 'created' | 'updated' | 'status_changed' | 'archived' | 'attachment_added' | 'attachment_removed' | 'chat_started' | 'goal_created' | 'workflow_started' | 'automation_added' | 'link_added' | 'progress_note_added' | 'update_suggestion_created' | 'update_suggestion_applied' | 'update_suggestion_dismissed';
+export type WorkItemUpdateSuggestionStatus = 'pending' | 'applied' | 'dismissed';
+export type WorkItemUpdateSuggestionSourceKind = 'chat' | 'goal' | 'workflow_run' | 'automation';
+export interface WorkItem {
+    id: string;
+    projectId: string;
+    title: string;
+    description?: string;
+    status: WorkItemStatus;
+    priority: WorkItemPriority;
+    ownerAgentId?: string;
+    nextAction?: string;
+    blockedReason?: string;
+    dueAt?: number;
+    completedAt?: number;
+    archivedAt?: number;
+    createdAt: number;
+    updatedAt: number;
+    links?: WorkItemLink[];
+    attachments?: WorkItemAttachment[];
+}
+export interface WorkItemAttachment {
+    id: string;
+    workItemId: string;
+    mediaUri: string;
+    mediaId: string;
+    bucket: string;
+    type: 'image' | 'audio' | 'video' | 'file';
+    mimeType: string;
+    fileName: string;
+    size: number;
+    createdAt: number;
+}
+export interface WorkItemLink {
+    id: string;
+    workItemId: string;
+    kind: WorkItemLinkKind;
+    targetId: string;
+    title?: string;
+    statusSnapshot?: string;
+    createdAt: number;
+}
+export interface WorkItemEvent {
+    id: string;
+    workItemId: string;
+    type: WorkItemEventType;
+    payload?: unknown;
+    createdAt: number;
+}
+export interface WorkItemUpdateSuggestion {
+    id: string;
+    workItemId: string;
+    sourceKind: WorkItemUpdateSuggestionSourceKind;
+    sourceId: string;
+    status: WorkItemUpdateSuggestionStatus;
+    patch: Pick<UpdateWorkItemInput, 'status' | 'nextAction' | 'blockedReason'>;
+    progressNote?: string;
+    rationale?: string;
+    confidence?: number;
+    createdAt: number;
+    appliedAt?: number;
+    dismissedAt?: number;
+}
+export interface CreateWorkItemUpdateSuggestionInput {
+    sourceKind: WorkItemUpdateSuggestionSourceKind;
+    sourceId: string;
+    patch?: Pick<UpdateWorkItemInput, 'status' | 'nextAction' | 'blockedReason'>;
+    progressNote?: string;
+    rationale?: string;
+    confidence?: number;
+}
+export interface WorkItemListQuery {
+    status?: WorkItemStatus | WorkItemStatus[];
+    priority?: WorkItemPriority | WorkItemPriority[];
+    includeArchived?: boolean;
+    search?: string;
+    sortBy?: 'updatedAt' | 'createdAt' | 'priority' | 'status';
+    sortOrder?: 'asc' | 'desc';
+    limit?: number;
+    offset?: number;
+}
+export interface WorkItemListResult {
+    items: WorkItem[];
+    total: number;
+    limit: number;
+    offset: number;
+    hasMore: boolean;
+}
+export interface CreateWorkItemInput {
+    title: string;
+    description?: string;
+    status?: WorkItemStatus;
+    priority?: WorkItemPriority;
+    ownerAgentId?: string;
+    nextAction?: string;
+    blockedReason?: string;
+    dueAt?: number;
+}
+export interface UpdateWorkItemInput {
+    title?: string;
+    description?: string | null;
+    status?: WorkItemStatus;
+    priority?: WorkItemPriority;
+    ownerAgentId?: string | null;
+    nextAction?: string | null;
+    blockedReason?: string | null;
+    dueAt?: number | null;
+    archivedAt?: number | null;
+}

package/dist/src/work-items/types.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,33 @@
+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;
+export declare const WORK_ITEM_ATTACHMENT_MAX_COUNT = 10;
+export declare const WORK_ITEM_ATTACHMENT_UPLOAD_BODY_MAX_BYTES: number;
+export declare class WorkItemService {
+    private readonly store;
+    constructor(store?: WorkItemStore);
+    listProjectWorkItems(projectId: string, query?: WorkItemListQuery): WorkItemListResult;
+    createProjectWorkItem(projectId: string, input: CreateWorkItemInput): WorkItem;
+    getWorkItem(id: string): WorkItem | null;
+    updateWorkItem(id: string, patch: UpdateWorkItemInput): WorkItem | null;
+    addLink(workItemId: string, input: Omit<WorkItemLink, 'id' | 'workItemId' | 'createdAt'>, eventType?: Parameters<WorkItemStore['addEvent']>[1]): WorkItemLink | null;
+    listEvents(workItemId: string): WorkItemEvent[];
+    listAttachments(workItemId: string): WorkItemAttachment[] | null;
+    addAttachment(workItemId: string, file: {
+        name: string;
+        buffer: Buffer;
+        mimeType: string;
+    }): Promise<WorkItemAttachment | null>;
+    readAttachment(workItemId: string, attachmentId: string): Promise<{
+        attachment: WorkItemAttachment;
+        buffer: Buffer;
+    } | null>;
+    removeAttachment(workItemId: string, attachmentId: string): Promise<WorkItemAttachment | null>;
+    createUpdateSuggestion(workItemId: string, input: CreateWorkItemUpdateSuggestionInput): WorkItemUpdateSuggestion | null;
+    listUpdateSuggestions(workItemId: string, status?: WorkItemUpdateSuggestionStatus): WorkItemUpdateSuggestion[];
+    applyUpdateSuggestion(id: string): {
+        item: WorkItem;
+        suggestion: WorkItemUpdateSuggestion;
+    } | null;
+    dismissUpdateSuggestion(id: string): WorkItemUpdateSuggestion | null;
+}

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

@@ -0,0 +1,180 @@
+import { deleteMediaBuffer, mimeTypeFromMediaPath, saveMediaBuffer } from "../media/store.js";
+import { readMediaReference } from "../media/media-reference.js";
+import { WorkItemStore } from "./work-item-store.js";
+//#region src/work-items/work-item-service.ts
+const WORK_ITEM_ATTACHMENT_MAX_BYTES = 25 * 1024 * 1024;
+const WORK_ITEM_ATTACHMENT_MAX_COUNT = 10;
+const WORK_ITEM_ATTACHMENT_UPLOAD_BODY_MAX_BYTES = WORK_ITEM_ATTACHMENT_MAX_BYTES * 10 + 1024 * 1024;
+function inferAttachmentType(mimeType) {
+	if (mimeType.startsWith("image/")) return "image";
+	if (mimeType.startsWith("audio/")) return "audio";
+	if (mimeType.startsWith("video/")) return "video";
+	return "file";
+}
+var WorkItemService = class {
+	constructor(store = new WorkItemStore()) {
+		this.store = store;
+	}
+	listProjectWorkItems(projectId, query = {}) {
+		return this.store.list(projectId, query);
+	}
+	createProjectWorkItem(projectId, input) {
+		const item = this.store.create(projectId, input);
+		this.store.addEvent(item.id, "created", {
+			title: item.title,
+			status: item.status,
+			priority: item.priority
+		});
+		return {
+			...item,
+			links: []
+		};
+	}
+	getWorkItem(id) {
+		return this.store.get(id);
+	}
+	updateWorkItem(id, patch) {
+		const before = this.store.get(id);
+		if (!before) return null;
+		const after = this.store.update(id, patch);
+		if (!after) return null;
+		if (before.status !== after.status) this.store.addEvent(id, "status_changed", {
+			from: before.status,
+			to: after.status
+		});
+		else this.store.addEvent(id, "updated", patch);
+		if (!before.archivedAt && after.archivedAt) this.store.addEvent(id, "archived", { archivedAt: after.archivedAt });
+		return after;
+	}
+	addLink(workItemId, input, eventType = "link_added") {
+		if (!this.store.get(workItemId)) return null;
+		const link = this.store.addLink({
+			...input,
+			workItemId
+		});
+		this.store.addEvent(workItemId, eventType, {
+			kind: link.kind,
+			targetId: link.targetId,
+			title: link.title,
+			statusSnapshot: link.statusSnapshot
+		});
+		return link;
+	}
+	listEvents(workItemId) {
+		return this.store.listEvents(workItemId);
+	}
+	listAttachments(workItemId) {
+		if (!this.store.get(workItemId)) return null;
+		return this.store.listAttachments(workItemId);
+	}
+	async addAttachment(workItemId, file) {
+		if (!this.store.get(workItemId)) return null;
+		const saved = await saveMediaBuffer(file.buffer, {
+			bucket: "work-item",
+			contentType: file.mimeType,
+			maxBytes: WORK_ITEM_ATTACHMENT_MAX_BYTES,
+			originalFilename: file.name
+		});
+		const mimeType = saved.contentType || file.mimeType || mimeTypeFromMediaPath(saved.path);
+		const attachment = this.store.addAttachment({
+			workItemId,
+			mediaUri: saved.uri,
+			mediaId: saved.id,
+			bucket: saved.bucket,
+			type: inferAttachmentType(mimeType),
+			mimeType,
+			fileName: file.name.trim() || saved.id,
+			size: saved.size
+		});
+		this.store.addEvent(workItemId, "attachment_added", {
+			attachmentId: attachment.id,
+			fileName: attachment.fileName,
+			mimeType: attachment.mimeType,
+			size: attachment.size
+		});
+		return attachment;
+	}
+	async readAttachment(workItemId, attachmentId) {
+		const attachment = this.store.getAttachment(workItemId, attachmentId);
+		if (!attachment) return null;
+		const { buffer } = await readMediaReference(attachment.mediaUri, WORK_ITEM_ATTACHMENT_MAX_BYTES);
+		return {
+			attachment,
+			buffer
+		};
+	}
+	async removeAttachment(workItemId, attachmentId) {
+		const attachment = this.store.removeAttachment(workItemId, attachmentId);
+		if (!attachment) return null;
+		await deleteMediaBuffer(attachment.mediaId, "work-item");
+		this.store.addEvent(workItemId, "attachment_removed", {
+			attachmentId: attachment.id,
+			fileName: attachment.fileName,
+			mimeType: attachment.mimeType,
+			size: attachment.size
+		});
+		return attachment;
+	}
+	createUpdateSuggestion(workItemId, input) {
+		const suggestion = this.store.createUpdateSuggestion(workItemId, input);
+		if (!suggestion) return null;
+		this.store.addEvent(workItemId, "update_suggestion_created", {
+			suggestionId: suggestion.id,
+			sourceKind: suggestion.sourceKind,
+			sourceId: suggestion.sourceId,
+			patch: suggestion.patch,
+			hasProgressNote: Boolean(suggestion.progressNote)
+		});
+		return suggestion;
+	}
+	listUpdateSuggestions(workItemId, status) {
+		return this.store.listUpdateSuggestions(workItemId, status);
+	}
+	applyUpdateSuggestion(id) {
+		const suggestion = this.store.getUpdateSuggestion(id);
+		if (!suggestion || suggestion.status !== "pending") return null;
+		const before = this.store.get(suggestion.workItemId);
+		if (!before) return null;
+		const patch = {};
+		if (suggestion.patch.status !== void 0) patch.status = suggestion.patch.status;
+		if (suggestion.patch.nextAction !== void 0) patch.nextAction = suggestion.patch.nextAction;
+		if (suggestion.patch.blockedReason !== void 0) patch.blockedReason = suggestion.patch.blockedReason;
+		const item = Object.keys(patch).length > 0 ? this.updateWorkItem(suggestion.workItemId, patch) : before;
+		if (!item) return null;
+		if (suggestion.progressNote) this.store.addEvent(suggestion.workItemId, "progress_note_added", {
+			sourceKind: suggestion.sourceKind,
+			sourceId: suggestion.sourceId,
+			suggestionId: suggestion.id,
+			text: suggestion.progressNote
+		});
+		const marked = this.store.markUpdateSuggestion(id, "applied");
+		if (!marked) return null;
+		this.store.addEvent(suggestion.workItemId, "update_suggestion_applied", {
+			suggestionId: suggestion.id,
+			sourceKind: suggestion.sourceKind,
+			sourceId: suggestion.sourceId,
+			patch,
+			previousStatus: before.status,
+			nextStatus: item.status
+		});
+		return {
+			item,
+			suggestion: marked
+		};
+	}
+	dismissUpdateSuggestion(id) {
+		const suggestion = this.store.getUpdateSuggestion(id);
+		if (!suggestion || suggestion.status !== "pending") return null;
+		const marked = this.store.markUpdateSuggestion(id, "dismissed");
+		if (marked) this.store.addEvent(marked.workItemId, "update_suggestion_dismissed", {
+			suggestionId: marked.id,
+			sourceKind: marked.sourceKind,
+			sourceId: marked.sourceId
+		});
+		return marked;
+	}
+};
+//#endregion
+export { WORK_ITEM_ATTACHMENT_MAX_BYTES, WORK_ITEM_ATTACHMENT_MAX_COUNT, WORK_ITEM_ATTACHMENT_UPLOAD_BODY_MAX_BYTES, WorkItemService };
+
+//# sourceMappingURL=work-item-service.js.map

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

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

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

@@ -0,0 +1,21 @@
+import type { CreateWorkItemUpdateSuggestionInput, CreateWorkItemInput, UpdateWorkItemInput, WorkItem, WorkItemAttachment, WorkItemEvent, WorkItemEventType, WorkItemLink, WorkItemListQuery, WorkItemListResult, WorkItemUpdateSuggestion, WorkItemUpdateSuggestionStatus } from './types.js';
+export declare class WorkItemStore {
+    create(projectId: string, input: CreateWorkItemInput): WorkItem;
+    get(id: string): WorkItem | null;
+    list(projectId: string, query?: WorkItemListQuery): WorkItemListResult;
+    update(id: string, patch: UpdateWorkItemInput): WorkItem | null;
+    addLink(input: Omit<WorkItemLink, 'id' | 'createdAt'>): WorkItemLink;
+    listLinks(workItemId: string): WorkItemLink[];
+    listLinksForItems(workItemIds: string[]): Map<string, WorkItemLink[]>;
+    addAttachment(input: Omit<WorkItemAttachment, 'id' | 'createdAt'>): WorkItemAttachment;
+    getAttachment(workItemId: string, attachmentId: string): WorkItemAttachment | null;
+    listAttachments(workItemId: string): WorkItemAttachment[];
+    listAttachmentsForItems(workItemIds: string[]): Map<string, WorkItemAttachment[]>;
+    removeAttachment(workItemId: string, attachmentId: string): WorkItemAttachment | null;
+    addEvent(workItemId: string, type: WorkItemEventType, payload?: unknown): WorkItemEvent;
+    listEvents(workItemId: string): WorkItemEvent[];
+    createUpdateSuggestion(workItemId: string, input: CreateWorkItemUpdateSuggestionInput): WorkItemUpdateSuggestion | null;
+    getUpdateSuggestion(id: string): WorkItemUpdateSuggestion | null;
+    listUpdateSuggestions(workItemId: string, status?: WorkItemUpdateSuggestionStatus): WorkItemUpdateSuggestion[];
+    markUpdateSuggestion(id: string, status: Extract<WorkItemUpdateSuggestionStatus, 'applied' | 'dismissed'>): WorkItemUpdateSuggestion | null;
+}