@taskforcehq/taskforce 0.3.324 → 0.3.327

package/dist/sync/workspaceSyncModel.js

@@ -1,7 +1,9 @@
+import { normalizeLegacyPlanningAttachments, normalizePlanningComments, } from './planningCanonicalFields.js';
+import { normalizePersistedModelGatewayMessages } from '../services/modelGateway.js';
 import { parseAiProfileSurfaceType } from '../shared/aiProfileSurfaceType.js';
 import { parseAiProfileSeatScope } from '../shared/aiProfileSeatScope.js';
 import { serializeTaskForSync } from './taskSyncPayload.js';
-import { aiProfileSyncResourceAdapter, taskSyncResourceAdapter, shouldSyncResource, } from './syncResourceAdapters.js';
+import { aiProfileSyncResourceAdapter, getTaskRelationshipSyncChangeKey, getTaxonomySyncChangeKey, taskSyncResourceAdapter, shouldSyncResource, } from './syncResourceAdapters.js';
 import { normalizeSyncSameOriginAssetUrl } from './syncFieldSemantics.js';
 export function toWorkspaceSyncTaskSnapshot(task) {
     return serializeTaskForSync(task);
@@ -29,9 +31,6 @@ function sortTasksForSync(tasks) {
         return leftId.localeCompare(rightId);
     });
 }
-function clonePlanningAttachmentsForSync(value) {
-    return Array.isArray(value) ? value : undefined;
-}
 export function buildWorkspaceSyncPayloadModel(input) {
     const payloadBuiltAt = new Date().toISOString();
     const pendingDeleteIds = new Set(Array.from(input.pendingDeletedTaskIds)
@@ -40,6 +39,21 @@ export function buildWorkspaceSyncPayloadModel(input) {
     const pendingDeleteWatermarks = new Map(Array.from(input.pendingDeletedTaskWatermarks || new Map())
         .map(([taskId, deletedAt]) => [String(taskId || '').trim(), String(deletedAt || '').trim()])
         .filter(([taskId, deletedAt]) => taskId.length > 0 && Number.isFinite(Date.parse(deletedAt))));
+    const deletedTaskById = new Map((input.deletedTasks || []).map((entry) => [String(entry.taskId || '').trim(), entry]));
+    const buildDeleteChange = (taskId) => {
+        const deleted = deletedTaskById.get(taskId);
+        return {
+            op: 'delete',
+            taskId,
+            deletedAt: deleted?.deletedAt || pendingDeleteWatermarks.get(taskId) || payloadBuiltAt,
+            ...(deleted ? {
+                actor: deleted.actor,
+                actorType: deleted.actorType,
+                source: deleted.source,
+                details: deleted.details,
+            } : {}),
+        };
+    };
     const lastWatermarks = input.lastPushedWatermarks;
     const lastTaskChangeKeys = input.lastPushedTaskChangeKeys;
     const isDirty = (task, archived) => {
@@ -100,21 +114,30 @@ export function buildWorkspaceSyncPayloadModel(input) {
     }
     const deleteChanges = Array.from(input.lastPushedTaskIds)
         .filter((taskId) => !currentTaskIds.has(taskId))
-        .map((taskId) => ({
-        op: 'delete',
-        taskId,
-        deletedAt: pendingDeleteWatermarks.get(taskId) || payloadBuiltAt
-    }));
+        .map((taskId) => buildDeleteChange(taskId));
     const queuedDeleteChanges = Array.from(pendingDeleteIds)
-        .map((taskId) => ({
-        op: 'delete',
-        taskId,
-        deletedAt: pendingDeleteWatermarks.get(taskId) || payloadBuiltAt
-    }));
+        .map((taskId) => buildDeleteChange(taskId));
     const deleteTaskIds = new Set([
         ...deleteChanges.map((change) => String(change.taskId)),
         ...queuedDeleteChanges.map((change) => String(change.taskId))
     ]);
+    const previousTaskRelationshipChangeKeys = input.lastPushedTaskRelationshipChangeKeys;
+    const currentTaskRelationshipChangeKeys = new Map();
+    const taskRelationshipChanges = (Array.isArray(input.taskRelationships) ? input.taskRelationships : [])
+        .filter((relationship) => relationship?.id && Number.isFinite(Date.parse(String(relationship.updatedAt || ''))))
+        .map((relationship) => {
+        const relationshipId = String(relationship.id || '').trim();
+        const changeKey = getTaskRelationshipSyncChangeKey(relationship);
+        currentTaskRelationshipChangeKeys.set(relationshipId, changeKey);
+        return {
+            op: relationship.deletedAt ? 'task-relationship-delete' : 'task-relationship-upsert',
+            relationship,
+            relationshipId,
+            changeKey,
+        };
+    })
+        .filter((change) => previousTaskRelationshipChangeKeys?.get(change.relationshipId) !== change.changeKey)
+        .map(({ relationshipId: _relationshipId, changeKey: _changeKey, ...change }) => change);
     const currentInitiativeIds = new Set((Array.isArray(input.initiatives) ? input.initiatives : [])
         .map((initiative) => String(initiative?.id || '').trim())
         .filter((initiativeId) => initiativeId.length > 0));
@@ -142,10 +165,11 @@ export function buildWorkspaceSyncPayloadModel(input) {
             ownerId: typeof initiative?.ownerId === 'string' && initiative.ownerId.trim().length > 0
                 ? initiative.ownerId.trim()
                 : null,
+            comments: normalizePlanningComments(initiative?.comments),
             createdAt: String(initiative?.createdAt || '').trim(),
             updatedAt: String(initiative?.updatedAt || initiative?.createdAt || '').trim(),
             order: Number.isFinite(Number(initiative?.order)) ? Math.floor(Number(initiative.order)) : null,
-            attachments: clonePlanningAttachmentsForSync(initiative?.attachments),
+            attachments: normalizeLegacyPlanningAttachments(initiative?.attachments),
             isArchived: Boolean(initiative?.isArchived)
         }
     }))
@@ -185,10 +209,11 @@ export function buildWorkspaceSyncPayloadModel(input) {
             ownerId: typeof workstream?.ownerId === 'string' && workstream.ownerId.trim().length > 0
                 ? workstream.ownerId.trim()
                 : null,
+            comments: normalizePlanningComments(workstream?.comments),
             createdAt: String(workstream?.createdAt || '').trim(),
             updatedAt: String(workstream?.updatedAt || workstream?.createdAt || '').trim(),
             order: Number.isFinite(Number(workstream?.order)) ? Math.floor(Number(workstream.order)) : null,
-            attachments: clonePlanningAttachmentsForSync(workstream?.attachments),
+            attachments: normalizeLegacyPlanningAttachments(workstream?.attachments),
             isArchived: Boolean(workstream?.isArchived)
         }
     }))
@@ -221,6 +246,8 @@ export function buildWorkspaceSyncPayloadModel(input) {
             username: String(profile.username || '').trim(),
             icon: String(profile.icon || 'Bot').trim() || 'Bot',
             color: String(profile.color || '#8b5cf6').trim() || '#8b5cf6',
+            colorSource: typeof profile.colorSource === 'string' ? profile.colorSource : null,
+            colorUpdatedAt: typeof profile.colorUpdatedAt === 'string' ? profile.colorUpdatedAt : null,
             avatarUrl: normalizeSyncSameOriginAssetUrl(profile.avatarUrl),
             avatarSourceUrl: normalizeSyncSameOriginAssetUrl(profile.avatarSourceUrl),
             avatarRevision: Number.isFinite(Number(profile.avatarRevision)) ? Math.max(0, Math.floor(Number(profile.avatarRevision))) : 0,
@@ -293,7 +320,8 @@ export function buildWorkspaceSyncPayloadModel(input) {
         logicalName: typeof doc.logicalName === 'string' && doc.logicalName.trim().length > 0 ? doc.logicalName.trim() : null,
         caption: typeof doc.caption === 'string' && doc.caption.trim().length > 0 ? doc.caption.trim() : null,
         originalFilename: typeof doc.originalFilename === 'string' && doc.originalFilename.trim().length > 0 ? doc.originalFilename.trim() : null,
-        linkRole: (doc.linkRole === 'reference' ? 'reference' : 'attachment')
+        linkRole: (doc.linkRole === 'reference' ? 'reference' : 'attachment'),
+        ...(doc.links ? { links: doc.links } : {}),
     }))
         .filter((doc) => doc.path.length > 0)
         .filter((doc) => {
@@ -333,7 +361,8 @@ export function buildWorkspaceSyncPayloadModel(input) {
             ? 'reference'
             : asset.linkRole === 'image'
                 ? 'image'
-                : 'attachment')
+                : 'attachment'),
+        ...(asset.links ? { links: asset.links } : {}),
     }))
         .filter((asset) => asset.path.length > 0 && asset.contentBase64.length > 0)
         .filter((asset) => {
@@ -420,7 +449,11 @@ export function buildWorkspaceSyncPayloadModel(input) {
     const currentDocumentReviewCommentWatermarks = new Map(reviewComments
         .map((comment) => [
         String(comment?.id || '').trim(),
-        String(comment?.deletedAt || comment?.updatedAt || comment?.createdAt || '').trim()
+        [comment?.deletedAt, comment?.threadStatusUpdatedAt, comment?.updatedAt, comment?.createdAt]
+            .map((value) => String(value || '').trim())
+            .filter((value) => Number.isFinite(Date.parse(value)))
+            .sort()
+            .at(-1) || ''
     ])
         .filter(([commentId]) => commentId.length > 0));
     const previousDocumentReviewCommentWatermarks = input.lastPushedDocumentReviewCommentWatermarks;
@@ -435,6 +468,23 @@ export function buildWorkspaceSyncPayloadModel(input) {
             anchor: comment.anchor ?? null,
             order: Number.isFinite(Number(comment.order)) ? Math.max(0, Math.floor(Number(comment.order))) : 0,
             authorActorId: typeof comment.authorActorId === 'string' && comment.authorActorId.trim().length > 0 ? comment.authorActorId.trim() : null,
+            updatedByActorId: typeof comment.updatedByActorId === 'string' && comment.updatedByActorId.trim().length > 0 ? comment.updatedByActorId.trim() : null,
+            deletedByActorId: typeof comment.deletedByActorId === 'string' && comment.deletedByActorId.trim().length > 0 ? comment.deletedByActorId.trim() : null,
+            parentCommentId: typeof comment.parentCommentId === 'string' && comment.parentCommentId.trim().length > 0
+                ? comment.parentCommentId.trim()
+                : null,
+            threadStatus: comment.parentCommentId
+                ? null
+                : (comment.threadStatus === 'resolved' ? 'resolved' : 'open'),
+            threadStatusUpdatedAt: typeof comment.threadStatusUpdatedAt === 'string' && comment.threadStatusUpdatedAt.trim().length > 0
+                ? comment.threadStatusUpdatedAt.trim()
+                : null,
+            resolvedAt: typeof comment.resolvedAt === 'string' && comment.resolvedAt.trim().length > 0
+                ? comment.resolvedAt.trim()
+                : null,
+            resolvedByActorId: typeof comment.resolvedByActorId === 'string' && comment.resolvedByActorId.trim().length > 0
+                ? comment.resolvedByActorId.trim()
+                : null,
             createdAt: String(comment.createdAt || '').trim(),
             updatedAt: String(comment.updatedAt || comment.createdAt || '').trim(),
             deletedAt: typeof comment.deletedAt === 'string' && comment.deletedAt.trim().length > 0 ? comment.deletedAt.trim() : null,
@@ -444,13 +494,20 @@ export function buildWorkspaceSyncPayloadModel(input) {
         .filter((change) => {
         if (shouldSendAllDocumentReviewComments)
             return true;
-        return previousDocumentReviewCommentWatermarks.get(change.comment.id) !== change.comment.updatedAt;
+        return previousDocumentReviewCommentWatermarks.get(change.comment.id)
+            !== ([change.comment.threadStatusUpdatedAt, change.comment.updatedAt]
+                .filter((value) => typeof value === 'string' && Number.isFinite(Date.parse(value)))
+                .sort()
+                .at(-1) || change.comment.updatedAt);
     });
     const deletedReviewCommentChanges = reviewComments
         .filter((comment) => String(comment?.deletedAt || '').trim().length > 0)
         .map((comment) => ({
         commentId: String(comment?.id || '').trim(),
-        deletedAt: String(comment?.deletedAt || comment?.updatedAt || comment?.createdAt || payloadBuiltAt).trim() || payloadBuiltAt
+        deletedAt: String(comment?.deletedAt || comment?.updatedAt || comment?.createdAt || payloadBuiltAt).trim() || payloadBuiltAt,
+        deletedByActorId: typeof comment?.deletedByActorId === 'string' && comment.deletedByActorId.trim().length > 0
+            ? comment.deletedByActorId.trim()
+            : null,
     }))
         .filter((change) => change.commentId.length > 0)
         .filter((change) => {
@@ -464,7 +521,8 @@ export function buildWorkspaceSyncPayloadModel(input) {
     const documentReviewCommentDeleteChanges = [
         ...missingDocumentReviewCommentDeleteIds.map((commentId) => ({
             commentId,
-            deletedAt: payloadBuiltAt
+            deletedAt: payloadBuiltAt,
+            deletedByActorId: null,
         })),
         ...deletedReviewCommentChanges
     ];
@@ -542,6 +600,176 @@ export function buildWorkspaceSyncPayloadModel(input) {
         ...missingAnnotatedAttachmentSessionDeleteIds,
         ...deletedAnnotatedAttachmentSessionChanges.map((change) => change.sessionId)
     ]);
+    const taskforceAgents = Array.isArray(input.taskforceAgents) ? input.taskforceAgents : [];
+    const currentTaskforceAgentIds = new Set(taskforceAgents
+        .filter((agent) => String(agent?.deletedAt || '').trim().length === 0)
+        .map((agent) => String(agent?.id || '').trim())
+        .filter((agentId) => agentId.length > 0));
+    const currentTaskforceAgentWatermarks = new Map(taskforceAgents
+        .map((agent) => [
+        String(agent?.id || '').trim(),
+        String(agent?.deletedAt || agent?.updatedAt || agent?.createdAt || '').trim()
+    ])
+        .filter(([agentId]) => agentId.length > 0));
+    const previousTaskforceAgentWatermarks = input.lastPushedTaskforceAgentWatermarks;
+    const shouldSendAllTaskforceAgents = !previousTaskforceAgentWatermarks || previousTaskforceAgentWatermarks.size === 0;
+    const taskforceAgentUpsertChanges = taskforceAgents
+        .map((agent) => ({
+        op: 'taskforce-agent-upsert',
+        agent: {
+            id: String(agent.id || '').trim(),
+            tenantId: String(agent.tenantId || '').trim() || undefined,
+            workspaceId: String(agent.workspaceId || '').trim(),
+            ...(Object.prototype.hasOwnProperty.call(agent, 'definition') ? {
+                definition: agent.definition,
+                definitionRevision: Number(agent.definitionRevision) || 0,
+                definitionHash: String(agent.definitionHash || '').trim(),
+                lifecycleStatus: String(agent.lifecycleStatus || '').trim(),
+                managedProfileId: typeof agent.managedProfileId === 'string'
+                    ? agent.managedProfileId.trim() || null
+                    : null,
+                configurationState: agent.configurationState,
+                configurationIssues: Array.isArray(agent.configurationIssues)
+                    ? agent.configurationIssues
+                    : [],
+            } : {}),
+            name: String(agent.name || '').trim() || 'Agent',
+            modelProvider: 'taskforce_hq',
+            providerKey: String(agent.providerKey || '').trim(),
+            modelKey: String(agent.modelKey || '').trim(),
+            modelTier: String(agent.modelTier || '').trim(),
+            systemPrompt: typeof agent.systemPrompt === 'string' ? agent.systemPrompt : '',
+            enabled: agent.enabled !== false,
+            createdByUserId: typeof agent.createdByUserId === 'string' && agent.createdByUserId.trim().length > 0 ? agent.createdByUserId.trim() : null,
+            updatedByUserId: typeof agent.updatedByUserId === 'string' && agent.updatedByUserId.trim().length > 0 ? agent.updatedByUserId.trim() : null,
+            createdAt: String(agent.createdAt || '').trim(),
+            updatedAt: String(agent.updatedAt || agent.createdAt || '').trim(),
+            deletedAt: typeof agent.deletedAt === 'string' && agent.deletedAt.trim().length > 0 ? agent.deletedAt.trim() : null,
+        }
+    }))
+        .filter((change) => change.agent.id.length > 0 && change.agent.workspaceId.length > 0)
+        .filter((change) => {
+        if (shouldSendAllTaskforceAgents)
+            return true;
+        return previousTaskforceAgentWatermarks.get(change.agent.id) !== (change.agent.deletedAt || change.agent.updatedAt);
+    });
+    const agentRoles = Array.isArray(input.agentRoles) ? input.agentRoles : [];
+    agentRoles.forEach((role) => {
+        const id = String(role?.id || '').trim();
+        if (!id)
+            return;
+        const key = `agent-role:${id}`;
+        if (!String(role?.deletedAt || '').trim())
+            currentTaskforceAgentIds.add(key);
+        currentTaskforceAgentWatermarks.set(key, String(role?.deletedAt || role?.updatedAt || role?.createdAt || '').trim());
+    });
+    const agentRoleUpsertChanges = agentRoles
+        .map((role) => ({
+        op: 'agent-role-upsert',
+        role: {
+            id: String(role.id || '').trim(),
+            tenantId: String(role.tenantId || '').trim() || undefined,
+            workspaceId: String(role.workspaceId || '').trim(),
+            lifecycleStatus: role.lifecycleStatus === 'retired' ? 'retired' : 'active',
+            currentRevision: Number(role.currentRevision) || 0,
+            currentContentHash: String(role.currentContentHash || '').trim(),
+            definition: role.definition,
+            revisions: Array.isArray(role.revisions) ? role.revisions : [],
+            createdByActorId: typeof role.createdByActorId === 'string' ? role.createdByActorId.trim() || null : null,
+            updatedByActorId: typeof role.updatedByActorId === 'string' ? role.updatedByActorId.trim() || null : null,
+            createdAt: String(role.createdAt || '').trim(),
+            updatedAt: String(role.updatedAt || role.createdAt || '').trim(),
+            retiredAt: typeof role.retiredAt === 'string' ? role.retiredAt.trim() || null : null,
+            deletedAt: typeof role.deletedAt === 'string' ? role.deletedAt.trim() || null : null,
+        },
+    }))
+        .filter((change) => (change.role.id.length > 0
+        && change.role.workspaceId.length > 0
+        && change.role.currentRevision > 0
+        && change.role.currentContentHash.length > 0))
+        .filter((change) => {
+        if (shouldSendAllTaskforceAgents)
+            return true;
+        const key = `agent-role:${change.role.id}`;
+        return previousTaskforceAgentWatermarks.get(key) !== (change.role.deletedAt || change.role.updatedAt);
+    });
+    const taskforceAgentSkills = Array.isArray(input.taskforceAgentSkills) ? input.taskforceAgentSkills : [];
+    const currentTaskforceAgentSkillIds = new Set(taskforceAgentSkills
+        .map((skill) => String(skill?.id || '').trim())
+        .filter((skillId) => skillId.length > 0));
+    const currentTaskforceAgentSkillWatermarks = new Map(taskforceAgentSkills
+        .map((skill) => [
+        String(skill?.id || '').trim(),
+        String(skill?.updatedAt || skill?.createdAt || '').trim()
+    ])
+        .filter(([skillId]) => skillId.length > 0));
+    const previousTaskforceAgentSkillWatermarks = input.lastPushedTaskforceAgentSkillWatermarks;
+    const shouldSendAllTaskforceAgentSkills = (!previousTaskforceAgentSkillWatermarks
+        || previousTaskforceAgentSkillWatermarks.size === 0);
+    const taskforceAgentSkillUpsertChanges = taskforceAgentSkills
+        .map((skill) => ({
+        op: 'taskforce-agent-skill-upsert',
+        skill: {
+            ...skill,
+            id: String(skill.id || '').trim(),
+            tenantId: String(skill.tenantId || '').trim() || undefined,
+            workspaceId: String(skill.workspaceId || '').trim(),
+            revision: Number(skill.revision),
+            contentHash: String(skill.contentHash || '').trim(),
+            createdAt: String(skill.createdAt || '').trim(),
+            updatedAt: String(skill.updatedAt || skill.createdAt || '').trim(),
+        }
+    }))
+        .filter((change) => (change.skill.id.length > 0
+        && change.skill.workspaceId.length > 0
+        && Number.isInteger(change.skill.revision)
+        && change.skill.revision > 0))
+        .filter((change) => {
+        if (shouldSendAllTaskforceAgentSkills)
+            return true;
+        return previousTaskforceAgentSkillWatermarks.get(change.skill.id) !== change.skill.updatedAt;
+    });
+    const agentConversations = Array.isArray(input.agentConversations) ? input.agentConversations : [];
+    const currentAgentConversationIds = new Set(agentConversations
+        .filter((conversation) => String(conversation?.deletedAt || '').trim().length === 0)
+        .map((conversation) => String(conversation?.id || '').trim())
+        .filter((conversationId) => conversationId.length > 0));
+    const currentAgentConversationWatermarks = new Map(agentConversations
+        .map((conversation) => [
+        String(conversation?.id || '').trim(),
+        String(conversation?.deletedAt || conversation?.updatedAt || conversation?.createdAt || '').trim()
+    ])
+        .filter(([conversationId]) => conversationId.length > 0));
+    const previousAgentConversationWatermarks = input.lastPushedAgentConversationWatermarks;
+    const shouldSendAllAgentConversations = !previousAgentConversationWatermarks || previousAgentConversationWatermarks.size === 0;
+    const agentConversationUpsertChanges = agentConversations
+        .map((conversation) => ({
+        op: 'agent-conversation-upsert',
+        conversation: {
+            id: String(conversation.id || '').trim(),
+            tenantId: String(conversation.tenantId || '').trim() || undefined,
+            workspaceId: String(conversation.workspaceId || '').trim(),
+            agentId: String(conversation.agentId || '').trim(),
+            taskId: typeof conversation.taskId === 'string' && conversation.taskId.trim().length > 0 ? conversation.taskId.trim() : null,
+            title: String(conversation.title || 'Agent chat').trim() || 'Agent chat',
+            messages: normalizePersistedModelGatewayMessages(conversation.messages),
+            modelProvider: typeof conversation.modelProvider === 'string' && conversation.modelProvider.trim().length > 0 ? conversation.modelProvider.trim() : null,
+            modelId: typeof conversation.modelId === 'string' && conversation.modelId.trim().length > 0 ? conversation.modelId.trim() : null,
+            usage: conversation.usage && typeof conversation.usage === 'object' ? conversation.usage : null,
+            latencyMs: Number.isFinite(Number(conversation.latencyMs)) ? Number(conversation.latencyMs) : null,
+            createdByUserId: typeof conversation.createdByUserId === 'string' && conversation.createdByUserId.trim().length > 0 ? conversation.createdByUserId.trim() : null,
+            updatedByUserId: typeof conversation.updatedByUserId === 'string' && conversation.updatedByUserId.trim().length > 0 ? conversation.updatedByUserId.trim() : null,
+            createdAt: String(conversation.createdAt || '').trim(),
+            updatedAt: String(conversation.updatedAt || conversation.createdAt || '').trim(),
+            deletedAt: typeof conversation.deletedAt === 'string' && conversation.deletedAt.trim().length > 0 ? conversation.deletedAt.trim() : null,
+        }
+    }))
+        .filter((change) => change.conversation.id.length > 0 && change.conversation.workspaceId.length > 0 && change.conversation.agentId.length > 0)
+        .filter((change) => {
+        if (shouldSendAllAgentConversations)
+            return true;
+        return previousAgentConversationWatermarks.get(change.conversation.id) !== (change.conversation.deletedAt || change.conversation.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()])
@@ -599,16 +827,22 @@ export function buildWorkspaceSyncPayloadModel(input) {
             return true;
         return previousTaskEventWatermarks.get(change.event.id) !== change.event.createdAt;
     });
+    const currentTaxonomyChangeKey = getTaxonomySyncChangeKey({
+        taxonomyState: input.taxonomyState,
+        taxonomies: input.taxonomies,
+    });
+    const taxonomyChanged = currentTaxonomyChangeKey.length > 0
+        && input.lastPushedTaxonomyChangeKey !== currentTaxonomyChangeKey;
     const changes = [
         ...initiativeUpsertChanges,
         ...workstreamUpsertChanges,
-        ...((input.taxonomyState && typeof input.taxonomyState === 'object')
+        ...(taxonomyChanged && input.taxonomyState && typeof input.taxonomyState === 'object'
             ? [{
                     op: 'taxonomy-upsert',
                     taxonomyState: input.taxonomyState,
                     updatedAt: payloadBuiltAt
                 }]
-            : Array.isArray(input.taxonomies)
+            : taxonomyChanged && Array.isArray(input.taxonomies)
                 ? [{
                         op: 'taxonomy-upsert',
                         taxonomies: input.taxonomies,
@@ -638,7 +872,8 @@ export function buildWorkspaceSyncPayloadModel(input) {
         ...documentReviewCommentDeleteChanges.map((change) => ({
             op: 'document-review-comment-delete',
             commentId: change.commentId,
-            deletedAt: change.deletedAt
+            deletedAt: change.deletedAt,
+            deletedByActorId: change.deletedByActorId,
         })),
         ...annotatedAttachmentSessionUpsertChanges,
         ...annotatedAttachmentSessionDeleteChanges.map((change) => ({
@@ -646,14 +881,16 @@ export function buildWorkspaceSyncPayloadModel(input) {
             sessionId: change.sessionId,
             deletedAt: change.deletedAt
         })),
+        ...taskforceAgentUpsertChanges,
+        ...agentRoleUpsertChanges,
+        ...taskforceAgentSkillUpsertChanges,
+        ...agentConversationUpsertChanges,
         ...taskEventUpsertChanges,
         ...activeChanges,
         ...archivedChanges,
-        ...Array.from(deleteTaskIds).map((taskId) => ({
-            op: 'delete',
-            taskId,
-            deletedAt: pendingDeleteWatermarks.get(taskId) || payloadBuiltAt
-        }))
+        ...taskRelationshipChanges.filter((change) => !change.relationship.deletedAt),
+        ...taskRelationshipChanges.filter((change) => Boolean(change.relationship.deletedAt)),
+        ...Array.from(deleteTaskIds).map((taskId) => buildDeleteChange(taskId))
     ];
     const baselineResetReason = input.baselineResetReason ?? null;
     const resolveDomainDeltaDiagnostics = (args) => {
@@ -695,6 +932,8 @@ export function buildWorkspaceSyncPayloadModel(input) {
         currentTaskIds: new Set(Array.from(currentTaskIds).filter((taskId) => !pendingDeleteIds.has(taskId))),
         currentTaskWatermarks: new Map(Array.from(currentTaskWatermarks.entries()).filter(([taskId]) => !pendingDeleteIds.has(taskId))),
         currentTaskChangeKeys: new Map(Array.from(currentTaskChangeKeys.entries()).filter(([taskId]) => !pendingDeleteIds.has(taskId))),
+        currentTaskRelationshipChangeKeys,
+        currentTaxonomyChangeKey,
         deleteTaskIds,
         currentInitiativeIds,
         currentInitiativeWatermarks,
@@ -718,6 +957,12 @@ export function buildWorkspaceSyncPayloadModel(input) {
         currentAnnotatedAttachmentSessionIds,
         deleteAnnotatedAttachmentSessionIds,
         currentAnnotatedAttachmentSessionWatermarks,
+        currentTaskforceAgentIds,
+        currentTaskforceAgentWatermarks,
+        currentTaskforceAgentSkillIds,
+        currentTaskforceAgentSkillWatermarks,
+        currentAgentConversationIds,
+        currentAgentConversationWatermarks,
         currentTaskEventWatermarks,
         pushedWatermarks,
         pushedTaskChangeKeys,
@@ -732,6 +977,12 @@ export function buildWorkspaceSyncPayloadModel(input) {
                     upsertCount: activeChanges.length + archivedChanges.length,
                     deleteCount: deleteTaskIds.size
                 }),
+                taskRelationships: resolveDomainDeltaDiagnostics({
+                    currentCount: currentTaskRelationshipChangeKeys.size,
+                    baselineCount: previousTaskRelationshipChangeKeys?.size || 0,
+                    upsertCount: byOp['task-relationship-upsert'] || 0,
+                    deleteCount: byOp['task-relationship-delete'] || 0
+                }),
                 initiatives: resolveDomainDeltaDiagnostics({
                     currentCount: currentInitiativeIds.size,
                     baselineCount: previousInitiativeWatermarks?.size || 0,
@@ -777,6 +1028,21 @@ export function buildWorkspaceSyncPayloadModel(input) {
                     upsertCount: annotatedAttachmentSessionUpsertChanges.length,
                     deleteCount: deleteAnnotatedAttachmentSessionIds.size
                 }),
+                taskforceAgents: resolveDomainDeltaDiagnostics({
+                    currentCount: currentTaskforceAgentIds.size,
+                    baselineCount: previousTaskforceAgentWatermarks?.size || 0,
+                    upsertCount: taskforceAgentUpsertChanges.length + agentRoleUpsertChanges.length
+                }),
+                taskforceAgentSkills: resolveDomainDeltaDiagnostics({
+                    currentCount: currentTaskforceAgentSkillIds.size,
+                    baselineCount: previousTaskforceAgentSkillWatermarks?.size || 0,
+                    upsertCount: taskforceAgentSkillUpsertChanges.length
+                }),
+                agentConversations: resolveDomainDeltaDiagnostics({
+                    currentCount: currentAgentConversationIds.size,
+                    baselineCount: previousAgentConversationWatermarks?.size || 0,
+                    upsertCount: agentConversationUpsertChanges.length
+                }),
                 taskEvents: resolveDomainDeltaDiagnostics({
                     currentCount: currentTaskEventWatermarks.size,
                     baselineCount: previousTaskEventWatermarks?.size || 0,
@@ -784,9 +1050,8 @@ export function buildWorkspaceSyncPayloadModel(input) {
                 }),
                 taxonomy: resolveDomainDeltaDiagnostics({
                     currentCount: (input.taxonomyState && typeof input.taxonomyState === 'object') || Array.isArray(input.taxonomies) ? 1 : 0,
-                    baselineCount: 0,
-                    upsertCount: byOp['taxonomy-upsert'] || 0,
-                    alwaysFull: true
+                    baselineCount: input.lastPushedTaxonomyChangeKey ? 1 : 0,
+                    upsertCount: byOp['taxonomy-upsert'] || 0
                 })
             }
         }
@@ -800,13 +1065,22 @@ export function buildWorkspaceSyncSignatureModel(input) {
         .map((task) => `${task.id}:${task.updatedAt || task.createdAt || ''}:${task.status}`)
         .sort();
     const pendingDeletes = input.pendingDeletedTaskIds ? Array.from(input.pendingDeletedTaskIds).sort() : [];
+    const taskRelationships = (input.taskRelationships || [])
+        .filter((relationship) => (String(relationship?.id || '').trim().length > 0
+        && Number.isFinite(Date.parse(String(relationship?.updatedAt || '')))))
+        .map((relationship) => ({
+        id: String(relationship.id || '').trim(),
+        changeKey: getTaskRelationshipSyncChangeKey(relationship)
+    }))
+        .sort((a, b) => a.id.localeCompare(b.id) || a.changeKey.localeCompare(b.changeKey));
     const initiatives = (input.initiatives || [])
         .map((initiative) => ({
         id: String(initiative.id || '').trim(),
         updatedAt: String(initiative.updatedAt || initiative.createdAt || '').trim(),
         title: String(initiative.title || '').trim(),
         ownerId: typeof initiative.ownerId === 'string' ? initiative.ownerId.trim() : '',
-        attachments: clonePlanningAttachmentsForSync(initiative.attachments) || [],
+        comments: normalizePlanningComments(initiative.comments) || [],
+        attachments: normalizeLegacyPlanningAttachments(initiative.attachments) || [],
         isArchived: Boolean(initiative.isArchived)
     }))
         .filter((initiative) => initiative.id.length > 0)
@@ -818,7 +1092,8 @@ export function buildWorkspaceSyncSignatureModel(input) {
         initiativeId: typeof workstream.initiativeId === 'string' ? workstream.initiativeId.trim() : '',
         title: String(workstream.title || '').trim(),
         ownerId: typeof workstream.ownerId === 'string' ? workstream.ownerId.trim() : '',
-        attachments: clonePlanningAttachmentsForSync(workstream.attachments) || [],
+        comments: normalizePlanningComments(workstream.comments) || [],
+        attachments: normalizeLegacyPlanningAttachments(workstream.attachments) || [],
         isArchived: Boolean(workstream.isArchived)
     }))
         .filter((workstream) => workstream.id.length > 0)
@@ -827,6 +1102,7 @@ export function buildWorkspaceSyncSignatureModel(input) {
         workspaceId: input.workspaceId,
         initiatives,
         workstreams,
+        taskRelationships,
         taxonomyState: input.taxonomyState && typeof input.taxonomyState === 'object' ? input.taxonomyState : null,
         taxonomies: Array.isArray(input.taxonomies) ? input.taxonomies : [],
         aiProfiles: Array.isArray(input.aiProfiles)
@@ -918,6 +1194,66 @@ export function buildWorkspaceSyncSignatureModel(input) {
                 .filter((session) => session.id.length > 0)
                 .sort((a, b) => a.id.localeCompare(b.id))
             : [],
+        taskforceAgents: Array.isArray(input.taskforceAgents)
+            ? input.taskforceAgents
+                .map((agent) => ({
+                id: String(agent.id || '').trim(),
+                updatedAt: String(agent.updatedAt || agent.createdAt || '').trim(),
+                deletedAt: String(agent.deletedAt || '').trim(),
+                definitionRevision: Number(agent.definitionRevision) || 0,
+                definitionHash: String(agent.definitionHash || '').trim(),
+                lifecycleStatus: String(agent.lifecycleStatus || '').trim(),
+                managedProfileId: String(agent.managedProfileId || '').trim(),
+                name: String(agent.name || '').trim(),
+                modelTier: String(agent.modelTier || '').trim(),
+                providerKey: String(agent.providerKey || '').trim(),
+                modelKey: String(agent.modelKey || '').trim(),
+                enabled: agent.enabled !== false
+            }))
+                .filter((agent) => agent.id.length > 0)
+                .sort((a, b) => a.id.localeCompare(b.id))
+            : [],
+        agentRoles: Array.isArray(input.agentRoles)
+            ? input.agentRoles
+                .map((role) => ({
+                id: String(role.id || '').trim(),
+                updatedAt: String(role.updatedAt || role.createdAt || '').trim(),
+                deletedAt: String(role.deletedAt || '').trim(),
+                lifecycleStatus: role.lifecycleStatus,
+                currentRevision: Number(role.currentRevision) || 0,
+                currentContentHash: String(role.currentContentHash || '').trim(),
+                revisionCount: Array.isArray(role.revisions) ? role.revisions.length : 0,
+            }))
+                .filter((role) => role.id.length > 0)
+                .sort((a, b) => a.id.localeCompare(b.id))
+            : [],
+        taskforceAgentSkills: Array.isArray(input.taskforceAgentSkills)
+            ? input.taskforceAgentSkills
+                .map((skill) => ({
+                id: String(skill.id || '').trim(),
+                updatedAt: String(skill.updatedAt || skill.createdAt || '').trim(),
+                revision: Number(skill.revision) || 0,
+                contentHash: String(skill.contentHash || '').trim(),
+                lifecycleStatus: String(skill.lifecycleStatus || '').trim(),
+                revisionCount: Array.isArray(skill.revisions) ? skill.revisions.length : 0,
+            }))
+                .filter((skill) => skill.id.length > 0)
+                .sort((a, b) => a.id.localeCompare(b.id))
+            : [],
+        agentConversations: Array.isArray(input.agentConversations)
+            ? input.agentConversations
+                .map((conversation) => ({
+                id: String(conversation.id || '').trim(),
+                agentId: String(conversation.agentId || '').trim(),
+                taskId: String(conversation.taskId || '').trim(),
+                updatedAt: String(conversation.updatedAt || conversation.createdAt || '').trim(),
+                deletedAt: String(conversation.deletedAt || '').trim(),
+                messageCount: Array.isArray(conversation.messages) ? conversation.messages.length : 0,
+                modelId: String(conversation.modelId || '').trim()
+            }))
+                .filter((conversation) => conversation.id.length > 0)
+                .sort((a, b) => a.id.localeCompare(b.id))
+            : [],
         active,
         archived,
         pendingDeletes

package/dist/sync/workspaceSyncSnapshotProjection.d.ts

@@ -0,0 +1,11 @@
+import type { InitiativeItem, TaskItem, WorkstreamItem } from '../types.js';
+import type { WorkspaceSyncEntityEventSnapshot } from './workspaceSyncModel.js';
+/**
+ * Projects the entity-event history embedded in the browser's hydrated task and
+ * planning collections into the legacy v2 snapshot contract.
+ *
+ * Keep this projection shared by browser and server-owned snapshot builders:
+ * reading the standalone entity-event feed instead would subtly change v2
+ * payload and signature behavior.
+ */
+export declare function flattenTaskEvents(tasks: readonly TaskItem[], archivedTasks: readonly TaskItem[], initiatives?: readonly InitiativeItem[], workstreams?: readonly WorkstreamItem[]): WorkspaceSyncEntityEventSnapshot[];