@taskforcehq/taskforce 0.3.303 → 0.3.304

package/dist/sync/workspacePullFeed.js

@@ -148,6 +148,14 @@ export async function buildWorkspacePullFeed(input) {
         sessionId: String(session.id || '').trim()
     }))
         .filter((entry) => Number.isFinite(Date.parse(entry.watermark)) && entry.sessionId.length > 0);
+    const taskEventEntries = collaborationSyncState.listWorkspaceSyncTaskEventsSnapshot(workspaceId)
+        .map((event) => ({
+        kind: 'task-event',
+        watermark: String(event.createdAt || '').trim(),
+        sortId: `task-event:${String(event.id || '').trim()}`,
+        event
+    }))
+        .filter((entry) => Number.isFinite(Date.parse(entry.watermark)) && entry.event.id.length > 0 && entry.event.taskId.length > 0);
     const assetIndex = await contentSyncState.listWorkspaceSyncBinaryAssetIndex(workspaceId);
     const assetEntries = assetIndex
         .map((asset) => ({
@@ -190,6 +198,7 @@ export async function buildWorkspacePullFeed(input) {
         ...documentReviewCommentDeleteEntries,
         ...annotatedAttachmentSessionEntries,
         ...annotatedAttachmentSessionDeleteEntries,
+        ...taskEventEntries,
         ...assetEntries,
         ...assetDeleteEntries
     ];
@@ -238,16 +247,11 @@ export async function buildWorkspacePullFeed(input) {
         }
     }));
     const hydrationMs = Date.now() - hydrationStartedAtMs;
-    const effectivePage = [];
-    for (const entry of page) {
-        if (entry.kind === 'document' && !hydratedDocuments.get(entry.path))
-            break;
-        if (entry.kind === 'asset' && !hydratedAssets.get(entry.path))
-            break;
-        effectivePage.push(entry);
-    }
-    const hasMore = afterCursor.length > effectivePage.length;
-    const last = effectivePage.length > 0 ? effectivePage[effectivePage.length - 1] : null;
+    const skippedHydrationEntries = page.filter((entry) => ((entry.kind === 'document' && !hydratedDocuments.get(entry.path))
+        || (entry.kind === 'asset' && !hydratedAssets.get(entry.path)))).length;
+    const effectivePage = page;
+    const hasMore = afterCursor.length > page.length;
+    const last = page.length > 0 ? page[page.length - 1] : null;
     const nextCursor = encodeWorkspaceSyncCursor(last
         ? { u: last.watermark, id: String(last.sortId || '') }
         : cursor);
@@ -280,55 +284,57 @@ export async function buildWorkspacePullFeed(input) {
                                             ? [{ op: 'annotated-attachment-session-upsert', session: entry.session, watermark: entry.watermark }]
                                             : entry.kind === 'annotated-attachment-session-delete'
                                                 ? [{ op: 'annotated-attachment-session-delete', sessionId: entry.sessionId, deletedAt: entry.watermark, watermark: entry.watermark }]
-                                                : entry.kind === 'document'
-                                                    ? (() => {
-                                                        const payload = hydratedDocuments.get(entry.path);
-                                                        if (!payload)
-                                                            return [];
-                                                        return [{
-                                                                op: 'document-upsert',
-                                                                path: entry.path,
-                                                                updatedAt: entry.watermark,
-                                                                content: payload.content,
-                                                                assetId: payload.assetId,
-                                                                documentId: payload.documentId,
-                                                                referenceNumber: payload.referenceNumber,
-                                                                version: payload.version,
-                                                                taskId: payload.taskId,
-                                                                logicalName: payload.logicalName,
-                                                                caption: payload.caption,
-                                                                originalFilename: payload.originalFilename,
-                                                                linkRole: payload.linkRole === 'reference' ? 'reference' : 'attachment',
-                                                                watermark: entry.watermark
-                                                            }];
-                                                    })()
-                                                    : entry.kind === 'document-delete'
-                                                        ? [{ op: 'document-delete', path: entry.path, assetId: entry.assetId, deletedAt: entry.watermark, watermark: entry.watermark }]
-                                                        : entry.kind === 'asset'
-                                                            ? (() => {
-                                                                const payload = hydratedAssets.get(entry.path);
-                                                                if (!payload)
-                                                                    return [];
-                                                                return [{
-                                                                        op: 'asset-upsert',
-                                                                        path: entry.path,
-                                                                        updatedAt: entry.watermark,
-                                                                        contentBase64: payload.contentBase64,
-                                                                        assetId: payload.assetId,
-                                                                        kind: payload.kind,
-                                                                        mimeType: payload.mimeType,
-                                                                        referenceNumber: payload.referenceNumber,
-                                                                        taskId: payload.taskId,
-                                                                        logicalName: payload.logicalName,
-                                                                        caption: payload.caption,
-                                                                        originalFilename: payload.originalFilename,
-                                                                        linkRole: payload.linkRole,
-                                                                        watermark: entry.watermark
-                                                                    }];
-                                                            })()
-                                                            : entry.kind === 'asset-delete'
-                                                                ? [{ op: 'asset-delete', path: entry.path, assetId: entry.assetId, deletedAt: entry.watermark, watermark: entry.watermark }]
-                                                                : [{ op: 'upsert', task: entry.task, archived: Boolean(entry.archived), watermark: entry.watermark }]));
+                                                : entry.kind === 'task-event'
+                                                    ? [{ op: 'task-event-upsert', event: entry.event, watermark: entry.watermark }]
+                                                    : entry.kind === 'document'
+                                                        ? (() => {
+                                                            const payload = hydratedDocuments.get(entry.path);
+                                                            if (!payload)
+                                                                return [];
+                                                            return [{
+                                                                    op: 'document-upsert',
+                                                                    path: entry.path,
+                                                                    updatedAt: entry.watermark,
+                                                                    content: payload.content,
+                                                                    assetId: payload.assetId,
+                                                                    documentId: payload.documentId,
+                                                                    referenceNumber: payload.referenceNumber,
+                                                                    version: payload.version,
+                                                                    taskId: payload.taskId,
+                                                                    logicalName: payload.logicalName,
+                                                                    caption: payload.caption,
+                                                                    originalFilename: payload.originalFilename,
+                                                                    linkRole: payload.linkRole === 'reference' ? 'reference' : 'attachment',
+                                                                    watermark: entry.watermark
+                                                                }];
+                                                        })()
+                                                        : entry.kind === 'document-delete'
+                                                            ? [{ op: 'document-delete', path: entry.path, assetId: entry.assetId, deletedAt: entry.watermark, watermark: entry.watermark }]
+                                                            : entry.kind === 'asset'
+                                                                ? (() => {
+                                                                    const payload = hydratedAssets.get(entry.path);
+                                                                    if (!payload)
+                                                                        return [];
+                                                                    return [{
+                                                                            op: 'asset-upsert',
+                                                                            path: entry.path,
+                                                                            updatedAt: entry.watermark,
+                                                                            contentBase64: payload.contentBase64,
+                                                                            assetId: payload.assetId,
+                                                                            kind: payload.kind,
+                                                                            mimeType: payload.mimeType,
+                                                                            referenceNumber: payload.referenceNumber,
+                                                                            taskId: payload.taskId,
+                                                                            logicalName: payload.logicalName,
+                                                                            caption: payload.caption,
+                                                                            originalFilename: payload.originalFilename,
+                                                                            linkRole: payload.linkRole,
+                                                                            watermark: entry.watermark
+                                                                        }];
+                                                                })()
+                                                                : entry.kind === 'asset-delete'
+                                                                    ? [{ op: 'asset-delete', path: entry.path, assetId: entry.assetId, deletedAt: entry.watermark, watermark: entry.watermark }]
+                                                                    : [{ op: 'upsert', task: entry.task, archived: Boolean(entry.archived), watermark: entry.watermark }]));
     const encodeMs = Date.now() - encodeStartedAtMs;
     return {
         workspaceMembers,
@@ -338,6 +344,7 @@ export async function buildWorkspacePullFeed(input) {
         diagnostics: {
             totalEntries: all.length,
             pageEntries: page.length,
+            skippedHydrationEntries,
             documentIndexCount: documentIndex.length,
             assetIndexCount: assetIndex.length,
             indexMs,

package/dist/sync/workspacePullFeed.test.js

@@ -29,6 +29,7 @@ function createCollaborationSyncStateMock() {
         listWorkspaceSyncDocumentReviewSessionsSnapshot: () => [],
         listWorkspaceSyncDocumentReviewCommentsSnapshot: () => [],
         listWorkspaceSyncAnnotatedAttachmentSessionsSnapshot: () => [],
+        listWorkspaceSyncTaskEventsSnapshot: () => [],
     };
 }
 function encodeCursor(cursor) {
@@ -234,9 +235,22 @@ describe('workspacePullFeed', () => {
         expect(loadedDocs).toEqual(['docs/a.md']);
         expect(loadedAssets).toEqual(['workspaces/ws/assets/images/a.png']);
     });
-    it('does not advance the cursor past a hydration miss', async () => {
+    it('skips hydration misses without blocking later feed progress', async () => {
         const core = createCoreMock();
         const content = createContentSyncStateMock();
+        core.listTasksForSync = () => [
+            {
+                archived: false,
+                task: {
+                    id: 'task-after-miss',
+                    title: 'Task after miss',
+                    status: 'task',
+                    category: 'general',
+                    type: 'task',
+                    createdAt: '2026-04-12T10:00:00.000Z',
+                }
+            }
+        ];
         content.listWorkspaceSyncDocumentIndex = async () => [
             {
                 path: 'docs/a.md',
@@ -260,7 +274,7 @@ describe('workspacePullFeed', () => {
             core,
             workspaceId: 'workspace-4',
             cursor: null,
-            pageSize: 2,
+            pageSize: 3,
             encodeWorkspaceSyncCursor: encodeCursor,
             contentSyncState: content,
             collaborationSyncState: createCollaborationSyncStateMock(),
@@ -270,9 +284,63 @@ describe('workspacePullFeed', () => {
                 op: 'document-upsert',
                 path: 'docs/a.md',
                 content: 'content:docs/a.md'
+            }),
+            expect.objectContaining({
+                op: 'upsert',
+                task: expect.objectContaining({
+                    id: 'task-after-miss'
+                })
+            })
+        ]);
+        expect(result.nextCursor).toBe('2026-04-12T10:00:00.000Z|task-after-miss');
+        expect(result.hasMore).toBe(false);
+        expect(result.diagnostics.skippedHydrationEntries).toBe(1);
+    });
+    it('includes task-event upserts in the pull feed ordered by event watermark', async () => {
+        const core = createCoreMock();
+        const collaboration = createCollaborationSyncStateMock();
+        collaboration.listWorkspaceSyncTaskEventsSnapshot = () => [
+            {
+                id: 'task-event-2',
+                taskId: 'task-2',
+                workspaceId: 'workspace-5',
+                action: 'task-archived',
+                actor: 'ai-profile-2',
+                actorType: 'ai',
+                createdAt: '2026-04-12T10:06:00.000Z',
+                details: {}
+            },
+            {
+                id: 'task-event-1',
+                taskId: 'task-1',
+                workspaceId: 'workspace-5',
+                action: 'task-status-changed',
+                actor: 'ai-profile-1',
+                actorType: 'ai',
+                createdAt: '2026-04-12T10:05:00.000Z',
+                details: {}
+            }
+        ];
+        const result = await buildWorkspacePullFeed({
+            core,
+            workspaceId: 'workspace-5',
+            cursor: null,
+            pageSize: 5,
+            encodeWorkspaceSyncCursor: encodeCursor,
+            contentSyncState: createContentSyncStateMock(),
+            collaborationSyncState: collaboration,
+        });
+        expect(result.changes).toEqual([
+            expect.objectContaining({
+                op: 'task-event-upsert',
+                watermark: '2026-04-12T10:05:00.000Z',
+                event: expect.objectContaining({ id: 'task-event-1' })
+            }),
+            expect.objectContaining({
+                op: 'task-event-upsert',
+                watermark: '2026-04-12T10:06:00.000Z',
+                event: expect.objectContaining({ id: 'task-event-2' })
             })
         ]);
-        expect(result.nextCursor).toBe('2026-04-10T10:00:00.000Z|doc:docs/a.md');
-        expect(result.hasMore).toBe(true);
     });
 });

package/dist/sync/workspaceSyncModel.d.ts

@@ -1,10 +1,20 @@
-import type { InitiativeItem, TaskItem, WorkstreamItem } from '../types';
+import type { InitiativeItem, TaskEvent, TaskItem, WorkstreamItem } from '../types';
 import type { DocumentReviewCommentRecord, DocumentReviewSessionStatus } from '../documentReviews/types.js';
 import type { AnnotatedAttachmentAnnotation } from '../annotatedAttachments/types.js';
 import type { WorkspaceTaxonomyState } from '../shared/taxonomyState.js';
 import { type AiProfileSurfaceType } from '../shared/aiProfileSurfaceType.js';
 import { type TaskSyncPayload } from './taskSyncPayload.js';
 export type WorkspaceSyncTaskSnapshot = TaskSyncPayload;
+export interface WorkspaceSyncTaskEventSnapshot {
+    id: string;
+    taskId: string;
+    workspaceId: string;
+    action: string;
+    actor: string;
+    actorType: 'system' | 'human' | 'ai';
+    details?: TaskEvent['details'];
+    createdAt: string;
+}
 export interface WorkspaceSyncAiProfileSnapshot {
     id: string;
     workspaceId: string;
@@ -13,6 +23,10 @@ export interface WorkspaceSyncAiProfileSnapshot {
     username: string;
     icon: string;
     color: string;
+    description?: string | null;
+    role?: string | null;
+    provider?: string | null;
+    model?: string | null;
     surfaceType?: AiProfileSurfaceType | null;
     providerMetadata?: Record<string, unknown> | null;
     createdAt: string;
@@ -177,6 +191,9 @@ export type WorkspaceSyncChange = {
     op: 'annotated-attachment-session-delete';
     sessionId: string;
     deletedAt?: string;
+} | {
+    op: 'task-event-upsert';
+    event: WorkspaceSyncTaskEventSnapshot;
 };
 export interface WorkspaceSyncPayload {
     changes: WorkspaceSyncChange[];
@@ -203,6 +220,7 @@ export interface WorkspaceSyncPayload {
     currentAnnotatedAttachmentSessionIds: Set<string>;
     deleteAnnotatedAttachmentSessionIds: Set<string>;
     currentAnnotatedAttachmentSessionWatermarks: Map<string, string>;
+    currentTaskEventWatermarks: Map<string, string>;
     /** Watermarks for every task upsert included in this payload (id → updatedAt|createdAt). */
     pushedWatermarks: Map<string, string>;
 }
@@ -250,6 +268,7 @@ export declare function buildWorkspaceSyncPayloadModel(input: {
     documentReviewSessions?: WorkspaceSyncDocumentReviewSessionSnapshot[];
     documentReviewComments?: WorkspaceSyncDocumentReviewCommentSnapshot[];
     annotatedAttachmentSessions?: WorkspaceSyncAnnotatedAttachmentSessionSnapshot[];
+    taskEvents?: WorkspaceSyncTaskEventSnapshot[];
     lastPushedInitiativeIds?: Set<string>;
     lastPushedInitiativeWatermarks?: Map<string, string>;
     lastPushedWorkstreamIds?: Set<string>;
@@ -266,6 +285,7 @@ export declare function buildWorkspaceSyncPayloadModel(input: {
     lastPushedDocumentReviewCommentWatermarks?: Map<string, string>;
     lastPushedAnnotatedAttachmentSessionIds?: Set<string>;
     lastPushedAnnotatedAttachmentSessionWatermarks?: Map<string, string>;
+    lastPushedTaskEventWatermarks?: Map<string, string>;
     /**
      * Watermark (updatedAt|createdAt) of each task as of its last successful push.
      * When provided, only tasks whose watermark differs from this map are included
@@ -289,4 +309,5 @@ export declare function buildWorkspaceSyncSignatureModel(input: {
     documentReviewSessions?: WorkspaceSyncDocumentReviewSessionSnapshot[];
     documentReviewComments?: WorkspaceSyncDocumentReviewCommentSnapshot[];
     annotatedAttachmentSessions?: WorkspaceSyncAnnotatedAttachmentSessionSnapshot[];
+    taskEvents?: WorkspaceSyncTaskEventSnapshot[];
 }): string;

package/dist/sync/workspaceSyncModel.js

@@ -3,6 +3,16 @@ import { serializeTaskForSync } from './taskSyncPayload.js';
 export function toWorkspaceSyncTaskSnapshot(task) {
     return serializeTaskForSync(task);
 }
+function sortTaskEventsForSync(taskEvents) {
+    return [...taskEvents].sort((left, right) => {
+        const leftCreatedAt = String(left?.createdAt || '').trim();
+        const rightCreatedAt = String(right?.createdAt || '').trim();
+        const watermarkDelta = leftCreatedAt.localeCompare(rightCreatedAt);
+        if (watermarkDelta !== 0)
+            return watermarkDelta;
+        return String(left?.id || '').trim().localeCompare(String(right?.id || '').trim());
+    });
+}
 function sortTasksForSync(tasks) {
     return [...tasks].sort((left, right) => {
         const leftId = String(left?.id || '').trim();
@@ -175,6 +185,10 @@ export function buildWorkspaceSyncPayloadModel(input) {
             username: String(profile.username || '').trim(),
             icon: String(profile.icon || 'Bot').trim() || 'Bot',
             color: String(profile.color || '#8b5cf6').trim() || '#8b5cf6',
+            description: typeof profile.description === 'string' ? profile.description.trim() || null : null,
+            role: typeof profile.role === 'string' ? profile.role.trim() || null : null,
+            provider: typeof profile.provider === 'string' ? profile.provider.trim() || null : null,
+            model: typeof profile.model === 'string' ? profile.model.trim() || null : null,
             surfaceType: parseAiProfileSurfaceType(profile.surfaceType),
             providerMetadata: profile.providerMetadata && typeof profile.providerMetadata === 'object' && !Array.isArray(profile.providerMetadata)
                 ? profile.providerMetadata
@@ -391,6 +405,40 @@ export function buildWorkspaceSyncPayloadModel(input) {
             return true;
         return previousAnnotatedAttachmentSessionWatermarks.get(change.session.id) !== change.session.updatedAt;
     });
+    const taskEvents = sortTaskEventsForSync(Array.isArray(input.taskEvents) ? input.taskEvents : []);
+    const currentTaskEventWatermarks = new Map(taskEvents
+        .map((event) => [String(event?.id || '').trim(), String(event?.createdAt || '').trim()])
+        .filter(([id]) => id.length > 0));
+    const previousTaskEventWatermarks = input.lastPushedTaskEventWatermarks;
+    const shouldSendAllTaskEvents = !previousTaskEventWatermarks || previousTaskEventWatermarks.size === 0;
+    const taskEventUpsertChanges = taskEvents
+        .map((event) => ({
+        op: 'task-event-upsert',
+        event: {
+            id: String(event.id || '').trim(),
+            taskId: String(event.taskId || '').trim(),
+            workspaceId: String(event.workspaceId || '').trim(),
+            action: String(event.action || '').trim(),
+            actor: String(event.actor || 'system').trim() || 'system',
+            actorType: event.actorType === 'ai' || event.actorType === 'human' || event.actorType === 'system'
+                ? event.actorType
+                : 'system',
+            details: event.details && typeof event.details === 'object' && !Array.isArray(event.details)
+                ? event.details
+                : {},
+            createdAt: String(event.createdAt || '').trim(),
+        }
+    }))
+        .filter((change) => (change.event.id.length > 0
+        && change.event.taskId.length > 0
+        && change.event.workspaceId.length > 0
+        && change.event.action.length > 0
+        && Number.isFinite(Date.parse(change.event.createdAt))))
+        .filter((change) => {
+        if (shouldSendAllTaskEvents)
+            return true;
+        return previousTaskEventWatermarks.get(change.event.id) !== change.event.createdAt;
+    });
     const changes = [
         ...initiativeUpsertChanges,
         ...workstreamUpsertChanges,
@@ -438,6 +486,7 @@ export function buildWorkspaceSyncPayloadModel(input) {
             sessionId,
             deletedAt: payloadBuiltAt
         })),
+        ...taskEventUpsertChanges,
         ...activeChanges,
         ...archivedChanges,
         ...Array.from(deleteTaskIds).map((taskId) => ({ op: 'delete', taskId }))
@@ -467,6 +516,7 @@ export function buildWorkspaceSyncPayloadModel(input) {
         currentAnnotatedAttachmentSessionIds,
         deleteAnnotatedAttachmentSessionIds,
         currentAnnotatedAttachmentSessionWatermarks,
+        currentTaskEventWatermarks,
         pushedWatermarks
     };
 }
@@ -516,6 +566,21 @@ export function buildWorkspaceSyncSignatureModel(input) {
                 .filter((profile) => profile.id.length > 0)
                 .sort((a, b) => a.id.localeCompare(b.id))
             : [],
+        taskEvents: Array.isArray(input.taskEvents)
+            ? input.taskEvents
+                .map((event) => ({
+                id: String(event.id || '').trim(),
+                taskId: String(event.taskId || '').trim(),
+                action: String(event.action || '').trim(),
+                actor: String(event.actor || '').trim(),
+                actorType: event.actorType === 'ai' || event.actorType === 'human' || event.actorType === 'system'
+                    ? event.actorType
+                    : 'system',
+                createdAt: String(event.createdAt || '').trim()
+            }))
+                .filter((event) => event.id.length > 0 && event.taskId.length > 0)
+                .sort((a, b) => a.id.localeCompare(b.id))
+            : [],
         documents: Array.isArray(input.documents)
             ? input.documents
                 .map((doc) => ({

package/dist/sync/workspaceSyncModel.test.js

@@ -20,6 +20,82 @@ describe('workspaceSyncModel', () => {
                 expect.objectContaining({ op: 'document-delete', path: 'docs/remove.md' })
             ]));
         });
+        it('emits task-event-upsert changes for new activity events and tracks event watermarks', () => {
+            const payload = buildWorkspaceSyncPayloadModel({
+                tasks: [],
+                archivedTasks: [],
+                taskEvents: [
+                    {
+                        id: 'task-event-1',
+                        taskId: 'task-1',
+                        workspaceId: 'workspace-a',
+                        action: 'task-status-changed',
+                        actor: 'ai-profile-1',
+                        actorType: 'ai',
+                        createdAt: '2026-04-13T10:05:00.000Z',
+                        details: {
+                            changes: {
+                                status: {
+                                    from: 'in-progress',
+                                    to: 'done'
+                                }
+                            }
+                        }
+                    }
+                ],
+                lastPushedTaskIds: new Set(),
+                pendingDeletedTaskIds: new Set(),
+                lastPushedTaskEventWatermarks: new Map()
+            });
+            expect(payload.changes).toEqual(expect.arrayContaining([
+                expect.objectContaining({
+                    op: 'task-event-upsert',
+                    event: expect.objectContaining({
+                        id: 'task-event-1',
+                        taskId: 'task-1',
+                        workspaceId: 'workspace-a',
+                        action: 'task-status-changed',
+                        createdAt: '2026-04-13T10:05:00.000Z'
+                    })
+                })
+            ]));
+            expect(payload.currentTaskEventWatermarks.get('task-event-1')).toBe('2026-04-13T10:05:00.000Z');
+        });
+        it('does not resend unchanged task events when prior task-event watermarks exist', () => {
+            const payload = buildWorkspaceSyncPayloadModel({
+                tasks: [],
+                archivedTasks: [],
+                taskEvents: [
+                    {
+                        id: 'task-event-keep',
+                        taskId: 'task-1',
+                        workspaceId: 'workspace-a',
+                        action: 'task-status-changed',
+                        actor: 'ai-profile-1',
+                        actorType: 'ai',
+                        createdAt: '2026-04-13T10:05:00.000Z'
+                    },
+                    {
+                        id: 'task-event-new',
+                        taskId: 'task-2',
+                        workspaceId: 'workspace-a',
+                        action: 'task-archived',
+                        actor: 'ai-profile-1',
+                        actorType: 'ai',
+                        createdAt: '2026-04-13T10:06:00.000Z'
+                    }
+                ],
+                lastPushedTaskIds: new Set(),
+                pendingDeletedTaskIds: new Set(),
+                lastPushedTaskEventWatermarks: new Map([
+                    ['task-event-keep', '2026-04-13T10:05:00.000Z']
+                ])
+            });
+            const taskEventIds = payload.changes
+                .filter((change) => change.op === 'task-event-upsert')
+                .map((change) => change.event.id);
+            expect(taskEventIds).toEqual(['task-event-new']);
+        });
         it('sends only changed/new document upserts when prior document watermarks exist', () => {
             const payload = buildWorkspaceSyncPayloadModel({
                 tasks: [],
@@ -162,6 +238,10 @@ describe('workspaceSyncModel', () => {
                         username: 'codex',
                         icon: 'Bot',
                         color: '#0ea5e9',
+                        description: 'Terminal-first coding agent',
+                        role: 'Implementer',
+                        provider: 'OpenAI',
+                        model: 'gpt-5.4',
                         surfaceType: 'coding_tool',
                         createdAt: '2026-03-22T10:00:00.000Z',
                         updatedAt: '2026-03-22T10:05:00.000Z',
@@ -175,6 +255,10 @@ describe('workspaceSyncModel', () => {
                     profile: expect.objectContaining({
                         id: 'ai-profile-1',
                         name: 'Codex',
+                        description: 'Terminal-first coding agent',
+                        role: 'Implementer',
+                        provider: 'OpenAI',
+                        model: 'gpt-5.4',
                         surfaceType: 'coding_tool'
                     })
                 })
@@ -197,6 +281,10 @@ describe('workspaceSyncModel', () => {
                         username: 'codex',
                         icon: 'Bot',
                         color: '#0ea5e9',
+                        description: 'Terminal-first coding agent',
+                        role: 'Implementer',
+                        provider: 'OpenAI',
+                        model: 'gpt-5.4',
                         surfaceType: 'coding_tool',
                         createdAt: '2026-03-22T10:00:00.000Z',
                         updatedAt: '2026-03-22T10:05:00.000Z',
@@ -681,6 +769,37 @@ describe('workspaceSyncModel', () => {
             });
             expect(changedSignature).not.toEqual(baseSignature);
         });
+        it('changes when task activity changes', () => {
+            const baseSignature = buildWorkspaceSyncSignatureModel({
+                workspaceId: 'ws-1',
+                tasks: [],
+                archivedTasks: [],
+                taskEvents: [{
+                        id: 'task-event-1',
+                        taskId: 'task-1',
+                        workspaceId: 'ws-1',
+                        action: 'task-status-changed',
+                        actor: 'ai-profile-1',
+                        actorType: 'ai',
+                        createdAt: '2026-04-13T10:05:00.000Z'
+                    }]
+            });
+            const changedSignature = buildWorkspaceSyncSignatureModel({
+                workspaceId: 'ws-1',
+                tasks: [],
+                archivedTasks: [],
+                taskEvents: [{
+                        id: 'task-event-1',
+                        taskId: 'task-1',
+                        workspaceId: 'ws-1',
+                        action: 'task-status-changed',
+                        actor: 'ai-profile-1',
+                        actorType: 'ai',
+                        createdAt: '2026-04-13T10:06:00.000Z'
+                    }]
+            });
+            expect(changedSignature).not.toEqual(baseSignature);
+        });
     });
     describe('dirty task watermarks', () => {
         it('emits an upsert when a status-only server-confirmed update changes updatedAt', () => {

package/dist/types.d.ts

@@ -4,23 +4,15 @@
  * A decoupled, reusable collaborative task manager.
  */
 export type { TaskforceTheme } from './utils/theme';
+export type { TaskActor } from './shared/taskActor.js';
 import type { TaskforceTheme } from './utils/theme';
+import type { TaskActor } from './shared/taskActor.js';
 export interface Environment {
     id: string;
     name: string;
     icon?: string;
     directory: string;
 }
-export interface TaskActor {
-    id: string;
-    kind: 'human' | 'ai';
-    label: string;
-    username: string;
-    icon: string;
-    color: string;
-    isNamed: boolean;
-    meta?: Record<string, unknown>;
-}
 export interface Comment {
     id: string;
     author: 'user' | 'ai' | string;

package/dist/ui/assets/AgentsModule-BLWVbuKP.js

@@ -0,0 +1 @@
+import{r as n,j as e}from"./vendor-react-CKJs5o3c.js";import{p as T,u as C,v as w,w as S,t as s,x as M}from"./index-DXUdtH1B.js";import{h as L,B as A,k as I,aa as B,aI as H,aJ as D,b as R}from"./vendor-icons-I7ZwG1z_.js";import"./vendor-markdown-BUxTU7dS.js";import"./vendor-dnd-DRzYolkg.js";import"./vendor-router-BbWMxlnO.js";function F({workspaceId:h}){const[x,k]=n.useState([]),[j,y]=n.useState(!1),[c,P]=n.useState(null),[p,m]=n.useState(null),[d,g]=n.useState(null),N=n.useCallback(async()=>{if(h){y(!0);try{const a=await(await fetch(`/api/taskforce/workspace/assignee-options?workspaceId=${encodeURIComponent(h)}`,{credentials:"include"})).json().catch(()=>({})),t=Array.isArray(a?.assignees)?a.assignees.filter(i=>i.kind==="agent").map(i=>({id:String(i.value||""),name:String(i.label||i.value||"Unknown Agent"),username:String(i.username||i.value||""),icon:String(i.icon||"Bot"),color:String(i.color||"#6B7280"),kind:String(i.kind||"agent"),description:typeof i.description=="string"?i.description:null,role:typeof i.role=="string"?i.role:null,provider:typeof i.provider=="string"?i.provider:null,model:typeof i.model=="string"?i.model:null,surfaceType:T(i.surfaceType),createdAt:String(i.createdAt||""),updatedAt:String(i.updatedAt||i.createdAt||""),lastActiveAt:typeof i.lastActiveAt=="string"?i.lastActiveAt:null})):[];k(t)}finally{y(!1)}}},[h]);n.useEffect(()=>{N()},[N]);const f=n.useMemo(()=>{const r=new Map;for(const a of x){const t=C(a.surfaceType);r.has(t)||r.set(t,new Map);const i=r.get(t),v=a.name.toLowerCase();i.has(v)||i.set(v,[]),i.get(v).push(a)}return w.map(a=>({section:a,label:S(a),groups:Array.from(r.get(a)?.entries()||[]).map(([t,i])=>({groupId:`${a}:${t}`,section:a,sectionLabel:S(a),profiles:i,primaryProfile:i[0]}))})).filter(a=>a.groups.length>0)},[x]),o=n.useMemo(()=>f.flatMap(r=>r.groups),[f]),l=n.useMemo(()=>o.find(r=>r.groupId===d)||o[0]||null,[o,d]);n.useEffect(()=>{if(!o.length){d!==null&&g(null);return}(!d||!o.some(r=>r.groupId===d))&&g(o[0].groupId)},[o,d]);const b=async(r,a)=>{m(null);try{const t=await fetch("/api/taskforce/workspace/ai-profiles/merge",{method:"POST",credentials:"include",headers:{"Content-Type":"application/json"},body:JSON.stringify({keepId:r,mergeId:a})}),i=await t.json().catch(()=>({}));if(!t.ok){m({type:"error",message:String(i?.error||"Failed to merge AI profiles.")});return}P(null),m({type:"success",message:"AI profiles merged."}),await N()}catch{m({type:"error",message:"Failed to merge AI profiles."})}},u=r=>{const a=String(r||"").trim();if(!a)return"Unknown";const t=Date.parse(a);return Number.isFinite(t)?new Date(t).toLocaleString(void 0,{dateStyle:"medium",timeStyle:"short"}):a};return e.jsx("div",{className:`${s.standalonePage} ${s.standaloneContent}`,style:{overflow:"auto"},children:e.jsx("div",{className:s.settingsContent,style:{maxWidth:1080,margin:"0 auto",width:"100%"},children:e.jsx("div",{className:s.settingGroup,children:e.jsxs("div",{children:[e.jsx("h4",{className:s.settingSubTitle,children:"Registered AI Profiles"}),e.jsx("p",{className:`${s.settingsHint} ${s.marginBottom12}`,children:"AI agents register profiles when connecting via MCP. Merge duplicates created when a token was lost."}),j&&e.jsxs("div",{className:s.settingsHint,children:[e.jsx(L,{size:13,className:s.spinner})," Loading profiles…"]}),!j&&x.length===0&&e.jsx("div",{className:s.settingsHint,children:"No AI profiles registered yet."}),!j&&f.length>0&&e.jsxs("div",{className:s.aiProfilesExplorer,children:[e.jsx("div",{className:s.aiProfilesListPane,children:e.jsx("div",{className:s.aiProfilesList,children:f.map(r=>e.jsxs("div",{className:s.aiProfilesSection,children:[e.jsx("div",{className:s.aiProfilesSectionHeader,children:r.label}),r.groups.map(a=>{const t=l?.groupId===a.groupId,i=a.primaryProfile;return e.jsxs("button",{type:"button",className:`${s.aiProfileGroup} ${a.profiles.length>1?s.aiProfileGroupDuplicate:""} ${t?s.aiProfileGroupSelected:""}`,onClick:()=>g(a.groupId),"aria-pressed":t,children:[e.jsxs("div",{className:s.aiProfileGroupHeader,children:[e.jsx(A,{size:13,style:{color:i.color}}),e.jsx("span",{className:s.aiProfileName,children:i.name}),a.profiles.length>1&&e.jsxs("span",{className:s.aiProfileDuplicateBadge,children:[e.jsx(I,{size:11})," ",a.profiles.length," duplicates"]})]}),e.jsxs("div",{className:s.settingsHint,style:{marginTop:6},children:["@",i.username]}),(i.surfaceType||i.role||i.provider||i.model)&&e.jsxs("div",{className:s.aiProfileMetaRow,children:[i.surfaceType&&e.jsx("span",{className:s.aiProfileSurfaceBadge,children:M(i.surfaceType)}),i.role&&e.jsx("span",{children:i.role}),i.provider&&e.jsx("span",{children:i.provider}),i.model&&e.jsx("span",{children:i.model})]}),i.description&&e.jsx("div",{className:s.settingsHint,style:{marginTop:4},children:i.description})]},a.groupId)})]},r.section))})}),l&&e.jsx("div",{className:s.aiProfileDetailPane,children:e.jsxs("div",{className:s.aiProfileDetailCard,children:[e.jsxs("div",{className:s.aiProfileDetailHero,children:[e.jsx("div",{className:s.aiProfileDetailIcon,style:{color:l.primaryProfile.color},children:e.jsx(A,{size:18})}),e.jsxs("div",{className:s.aiProfileDetailHeading,children:[e.jsx("div",{className:s.aiProfileDetailTitleRow,children:e.jsx("h5",{className:s.aiProfileDetailTitle,children:l.primaryProfile.name})}),e.jsxs("div",{className:s.aiProfileDetailMetaRow,children:[e.jsxs("span",{className:s.aiProfileDetailHandle,children:["@",l.primaryProfile.username]}),e.jsx("span",{className:s.aiProfileDetailSectionBadge,children:l.sectionLabel}),l.profiles.length>1&&e.jsxs("span",{className:s.aiProfileDetailLinkedCount,children:[l.profiles.length," linked"]})]})]})]}),l.primaryProfile.description&&e.jsx("div",{className:s.aiProfileDetailDescription,children:l.primaryProfile.description}),e.jsxs("div",{className:s.aiProfileDetailGrid,children:[e.jsxs("div",{className:s.aiProfileDetailStat,children:[e.jsxs("span",{className:s.aiProfileDetailStatLabel,children:[e.jsx(B,{size:12})," Role"]}),e.jsx("span",{className:s.aiProfileDetailStatValue,children:l.primaryProfile.role||"Not set"})]}),e.jsxs("div",{className:s.aiProfileDetailStat,children:[e.jsxs("span",{className:s.aiProfileDetailStatLabel,children:[e.jsx(H,{size:12})," Provider"]}),e.jsx("span",{className:s.aiProfileDetailStatValue,children:[l.primaryProfile.provider,l.primaryProfile.model].filter(Boolean).join(" · ")||"Not set"})]}),e.jsxs("div",{className:s.aiProfileDetailStat,children:[e.jsxs("span",{className:s.aiProfileDetailStatLabel,children:[e.jsx(D,{size:12})," Last active"]}),e.jsx("span",{className:s.aiProfileDetailStatValue,children:u(l.primaryProfile.lastActiveAt)})]}),e.jsxs("div",{className:s.aiProfileDetailStat,children:[e.jsxs("span",{className:s.aiProfileDetailStatLabel,children:[e.jsx(D,{size:12})," Updated"]}),e.jsx("span",{className:s.aiProfileDetailStatValue,children:u(l.primaryProfile.updatedAt)})]})]}),e.jsxs("div",{className:s.aiProfileInstanceSection,children:[e.jsxs("div",{className:s.aiProfileInstanceSectionHeader,children:[e.jsx("span",{children:"Profile instances"}),e.jsx("span",{className:s.settingsHint,children:"Choose a keeper here if duplicates need to be merged."})]}),e.jsx("div",{className:s.aiProfileInstanceList,children:l.profiles.map(r=>e.jsxs("div",{className:s.aiProfileInstanceCard,children:[e.jsxs("div",{className:s.aiProfileInstanceTopRow,children:[e.jsxs("div",{children:[e.jsxs("div",{className:s.aiProfileInstanceName,children:["@",r.username]}),e.jsx("div",{className:s.aiProfileIdChip,children:r.id})]}),l.profiles.length>1&&c?.keepId===r.id&&e.jsx("span",{className:s.aiProfileKeepBadge,children:"Keeping"})]}),e.jsxs("div",{className:s.aiProfileInstanceMeta,children:[e.jsxs("span",{children:["Created ",u(r.createdAt)]}),e.jsxs("span",{children:["Updated ",u(r.updatedAt)]})]}),l.profiles.length>1&&c?.keepId!==r.id&&e.jsx("button",{className:s.secondaryHeaderBtn,title:"Keep this profile, merge others into it",onClick:()=>{const a=l.profiles.find(t=>t.id!==r.id)?.id;a&&P({keepId:r.id,mergeId:a})},children:"Keep this"})]},r.id))}),c&&l.profiles.some(r=>r.id===c.keepId)&&e.jsxs("div",{className:s.aiProfileMergeActions,children:[e.jsx("button",{className:s.dangerBtn,onClick:()=>{b(c.keepId,c.mergeId)},children:"Merge duplicates"}),e.jsx("button",{className:s.secondaryHeaderBtn,onClick:()=>P(null),children:"Cancel"})]})]})]})})]}),p&&e.jsxs("div",{className:`${p.type==="success"?s.successMessage:s.errorMessage} ${s.marginTop12}`,children:[p.type==="success"?e.jsx(R,{size:14}):e.jsx(I,{size:14}),p.message]})]})})})})}export{F as AgentsModule};