@taskforcehq/taskforce 0.3.326 → 0.3.327

package/dist/sync/workspaceSyncModel.d.ts

@@ -1,11 +1,26 @@
-import type { AttachmentItem, EntityEvent, InitiativeItem, TaskItem, WorkstreamItem } from '../types';
+import type { AttachmentItem, DeletedTaskDetails, DeletedTaskRecord, DeletedTaskSource, EntityEvent, InitiativeItem, 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 CanonicalPlanningComment } from './planningCanonicalFields.js';
+import type { ModelGatewayMessage, ModelGatewayUsage } from '../services/modelGateway.js';
 import { type AiProfileSurfaceType } from '../shared/aiProfileSurfaceType.js';
 import { type AiProfileSeatScope } from '../shared/aiProfileSeatScope.js';
 import { type TaskSyncPayload } from './taskSyncPayload.js';
+import type { WorkspaceAssetSyncLinkPayload } from './contentSyncPayload.js';
+import type { WorkspaceAssetManifestMetadata, WorkspaceContentManifestEntry, WorkspaceDocumentManifestMetadata } from './workspaceContentManifest.js';
+import type { TaskRelationshipRecord } from '../core/Taskforce.js';
+import type { AgentConfigurationIssue, AgentConfigurationState } from '../shared/taskforceAgentDefinition.js';
 export type WorkspaceSyncTaskSnapshot = TaskSyncPayload;
+export interface WorkspaceSyncTaskDelete {
+    taskId: string;
+    deletedAt?: string;
+    watermark?: string;
+    actor?: string;
+    actorType?: 'human' | 'ai' | 'system';
+    source?: DeletedTaskSource;
+    details?: DeletedTaskDetails;
+}
 export interface WorkspaceSyncEntityEventSnapshot {
     id: string;
     workspaceId: string;
@@ -31,6 +46,8 @@ export interface WorkspaceSyncAiProfileSnapshot {
     username: string;
     icon: string;
     color: string;
+    colorSource?: string | null;
+    colorUpdatedAt?: string | null;
     avatarUrl?: string | null;
     avatarSourceUrl?: string | null;
     avatarRevision?: number;
@@ -86,6 +103,13 @@ export interface WorkspaceSyncDocumentReviewCommentSnapshot {
     anchor: DocumentReviewCommentRecord['anchor'];
     order: number;
     authorActorId: string | null;
+    updatedByActorId: string | null;
+    deletedByActorId: string | null;
+    parentCommentId?: string | null;
+    threadStatus?: DocumentReviewCommentRecord['threadStatus'];
+    threadStatusUpdatedAt?: string | null;
+    resolvedAt?: string | null;
+    resolvedByActorId?: string | null;
     createdAt: string;
     updatedAt: string;
     deletedAt: string | null;
@@ -104,6 +128,93 @@ export interface WorkspaceSyncAnnotatedAttachmentSessionSnapshot {
     updatedAt: string;
     deletedAt: string | null;
 }
+export interface WorkspaceSyncTaskforceAgentSnapshot {
+    id: string;
+    tenantId?: string;
+    workspaceId: string;
+    definition?: unknown;
+    definitionRevision?: number;
+    definitionHash?: string;
+    lifecycleStatus?: string;
+    managedProfileId?: string | null;
+    configurationState?: AgentConfigurationState;
+    configurationIssues?: AgentConfigurationIssue[];
+    name?: string;
+    modelProvider?: 'taskforce_hq';
+    providerKey?: string;
+    modelKey?: string;
+    modelTier?: string;
+    systemPrompt?: string;
+    enabled?: boolean;
+    createdByUserId?: string | null;
+    updatedByUserId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string | null;
+}
+export interface WorkspaceSyncAgentRoleSnapshot {
+    id: string;
+    tenantId?: string;
+    workspaceId: string;
+    lifecycleStatus: 'active' | 'retired';
+    currentRevision: number;
+    currentContentHash: string;
+    definition: unknown;
+    revisions: Array<{
+        roleId: string;
+        revision: number;
+        definition: unknown;
+        contentHash: string;
+        createdByActorId: string | null;
+        createdAt: string;
+    }>;
+    createdByActorId: string | null;
+    updatedByActorId: string | null;
+    createdAt: string;
+    updatedAt: string;
+    retiredAt: string | null;
+    deletedAt: string | null;
+}
+export interface WorkspaceSyncTaskforceAgentSkillSnapshot {
+    id: string;
+    tenantId?: string;
+    workspaceId: string;
+    lifecycleStatus: 'active' | 'retired';
+    definition: unknown;
+    revision: number;
+    contentHash: string;
+    revisions: Array<{
+        revision: number;
+        contentHash: string;
+        definition: unknown;
+        createdByActorId?: string | null;
+        createdAt: string;
+    }>;
+    createdByActorId?: string | null;
+    updatedByActorId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    retiredAt?: string | null;
+    retiredByActorId?: string | null;
+}
+export interface WorkspaceSyncAgentConversationSnapshot {
+    id: string;
+    tenantId?: string;
+    workspaceId: string;
+    agentId: string;
+    taskId?: string | null;
+    title: string;
+    messages: ModelGatewayMessage[];
+    modelProvider?: string | null;
+    modelId?: string | null;
+    usage?: ModelGatewayUsage | null;
+    latencyMs?: number | null;
+    createdByUserId?: string | null;
+    updatedByUserId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string | null;
+}
 export interface WorkspaceSyncInitiativeSnapshot {
     id: string;
     referenceNumber?: number | null;
@@ -111,11 +222,13 @@ export interface WorkspaceSyncInitiativeSnapshot {
     title: string;
     description: string | null;
     ownerId?: string | null;
+    comments?: WorkspaceSyncPlanningComment[];
     createdAt: string;
     updatedAt?: string;
     order?: number | null;
     attachments?: Array<string | AttachmentItem>;
     isArchived?: boolean;
+    durableRevision?: WorkspaceSyncDurablePlanningRevision<'initiative'>;
 }
 export interface WorkspaceSyncWorkstreamSnapshot {
     id: string;
@@ -125,21 +238,62 @@ export interface WorkspaceSyncWorkstreamSnapshot {
     title: string;
     description: string | null;
     ownerId?: string | null;
+    comments?: WorkspaceSyncPlanningComment[];
     createdAt: string;
     updatedAt?: string;
     order?: number | null;
     attachments?: Array<string | AttachmentItem>;
     isArchived?: boolean;
+    durableRevision?: WorkspaceSyncDurablePlanningRevision<'workstream'>;
+}
+export type WorkspaceSyncPlanningComment = CanonicalPlanningComment;
+export type WorkspaceSyncPlanningDomain = 'initiative' | 'workstream';
+export type WorkspaceSyncPlanningMutationKind = 'create' | 'metadata-update' | 'append-comment' | 'archive' | 'unarchive';
+export type WorkspaceSyncDurablePlanningRevision<TDomain extends WorkspaceSyncPlanningDomain = WorkspaceSyncPlanningDomain> = {
+    contractVersion: 3;
+    domain: TDomain;
+    entityId: string;
+    mutationKind: WorkspaceSyncPlanningMutationKind;
+    sequence: string;
+    entityRevision: string;
+    lifecycleRevision: string;
+    canonicalFingerprint: string;
+};
+export interface WorkspaceSyncDurableTaxonomyRevision {
+    contractVersion: 3;
+    domain: 'taxonomy';
+    entityId: '__taxonomy_config__';
+    mutationKind: 'replace-state';
+    sequence: string;
+    entityRevision: string;
+    lifecycleRevision: '0';
+    canonicalFingerprint: string;
+}
+export interface WorkspaceSyncDurableTaskRevision {
+    contractVersion: 3;
+    domain: 'task';
+    entityId: string;
+    mutationKind: 'replicated-state';
+    sequence: string;
+    entityRevision: string;
+    lifecycleRevision: string;
+    canonicalFingerprint: string;
+    payloadFingerprint: string;
+    taxonomyOwned: boolean;
 }
 export type WorkspaceSyncChange = {
     op: 'upsert';
     archived: boolean;
     task: WorkspaceSyncTaskSnapshot;
-} | {
+    durableRevision?: WorkspaceSyncDurableTaskRevision;
+} | ({
     op: 'delete';
-    taskId: string;
-    deletedAt?: string;
-    watermark?: string;
+} & WorkspaceSyncTaskDelete) | {
+    op: 'task-relationship-upsert';
+    relationship: TaskRelationshipRecord;
+} | {
+    op: 'task-relationship-delete';
+    relationship: TaskRelationshipRecord;
 } | {
     op: 'initiative-upsert';
     initiative: WorkspaceSyncInitiativeSnapshot;
@@ -151,6 +305,7 @@ export type WorkspaceSyncChange = {
     taxonomies?: unknown[];
     taxonomyState?: WorkspaceTaxonomyState;
     updatedAt: string;
+    durableRevision?: WorkspaceSyncDurableTaxonomyRevision;
 } | {
     op: 'ai-profile-upsert';
     profile: WorkspaceSyncAiProfileSnapshot;
@@ -170,11 +325,16 @@ export type WorkspaceSyncChange = {
     caption?: string | null;
     originalFilename?: string | null;
     linkRole?: 'attachment' | 'reference';
+    links?: WorkspaceAssetSyncLinkPayload[];
 } | {
     op: 'document-delete';
     path: string;
     assetId?: string;
     deletedAt?: string;
+} | {
+    op: 'document-manifest';
+    manifest: WorkspaceContentManifestEntry;
+    metadata: WorkspaceDocumentManifestMetadata;
 } | {
     op: 'asset-upsert';
     path: string;
@@ -191,11 +351,16 @@ export type WorkspaceSyncChange = {
     caption?: string | null;
     originalFilename?: string | null;
     linkRole?: 'attachment' | 'image' | 'reference';
+    links?: WorkspaceAssetSyncLinkPayload[];
 } | {
     op: 'asset-delete';
     path: string;
     assetId?: string;
     deletedAt?: string;
+} | {
+    op: 'asset-manifest';
+    manifest: WorkspaceContentManifestEntry;
+    metadata: WorkspaceAssetManifestMetadata;
 } | {
     op: 'document-review-session-upsert';
     session: WorkspaceSyncDocumentReviewSessionSnapshot;
@@ -210,6 +375,7 @@ export type WorkspaceSyncChange = {
     op: 'document-review-comment-delete';
     commentId: string;
     deletedAt?: string;
+    deletedByActorId?: string | null;
 } | {
     op: 'annotated-attachment-session-upsert';
     session: WorkspaceSyncAnnotatedAttachmentSessionSnapshot;
@@ -217,6 +383,18 @@ export type WorkspaceSyncChange = {
     op: 'annotated-attachment-session-delete';
     sessionId: string;
     deletedAt?: string;
+} | {
+    op: 'taskforce-agent-upsert';
+    agent: WorkspaceSyncTaskforceAgentSnapshot;
+} | {
+    op: 'agent-role-upsert';
+    role: WorkspaceSyncAgentRoleSnapshot;
+} | {
+    op: 'taskforce-agent-skill-upsert';
+    skill: WorkspaceSyncTaskforceAgentSkillSnapshot;
+} | {
+    op: 'agent-conversation-upsert';
+    conversation: WorkspaceSyncAgentConversationSnapshot;
 } | {
     op: 'entity-event-upsert';
     event: WorkspaceSyncEntityEventSnapshot;
@@ -229,6 +407,8 @@ export interface WorkspaceSyncPayload {
     currentTaskIds: Set<string>;
     currentTaskWatermarks?: Map<string, string>;
     currentTaskChangeKeys?: Map<string, string>;
+    currentTaskRelationshipChangeKeys?: Map<string, string>;
+    currentTaxonomyChangeKey?: string;
     deleteTaskIds: Set<string>;
     currentInitiativeIds: Set<string>;
     currentInitiativeWatermarks: Map<string, string>;
@@ -252,6 +432,12 @@ export interface WorkspaceSyncPayload {
     currentAnnotatedAttachmentSessionIds: Set<string>;
     deleteAnnotatedAttachmentSessionIds: Set<string>;
     currentAnnotatedAttachmentSessionWatermarks: Map<string, string>;
+    currentTaskforceAgentIds?: Set<string>;
+    currentTaskforceAgentWatermarks?: Map<string, string>;
+    currentTaskforceAgentSkillIds?: Set<string>;
+    currentTaskforceAgentSkillWatermarks?: Map<string, string>;
+    currentAgentConversationIds?: Set<string>;
+    currentAgentConversationWatermarks?: Map<string, string>;
     currentTaskEventWatermarks: Map<string, string>;
     /** Watermarks for every task upsert included in this payload (id → updatedAt|createdAt). */
     pushedWatermarks: Map<string, string>;
@@ -272,6 +458,7 @@ export interface WorkspaceSyncDeltaDiagnostics {
     baselineResetReason: WorkspaceSyncBaselineResetReason | null;
     domains: {
         tasks: WorkspaceSyncDomainDeltaDiagnostics;
+        taskRelationships?: WorkspaceSyncDomainDeltaDiagnostics;
         initiatives: WorkspaceSyncDomainDeltaDiagnostics;
         workstreams: WorkspaceSyncDomainDeltaDiagnostics;
         aiProfiles: WorkspaceSyncDomainDeltaDiagnostics;
@@ -280,6 +467,9 @@ export interface WorkspaceSyncDeltaDiagnostics {
         documentReviewSessions: WorkspaceSyncDomainDeltaDiagnostics;
         documentReviewComments: WorkspaceSyncDomainDeltaDiagnostics;
         annotatedAttachmentSessions: WorkspaceSyncDomainDeltaDiagnostics;
+        taskforceAgents?: WorkspaceSyncDomainDeltaDiagnostics;
+        taskforceAgentSkills?: WorkspaceSyncDomainDeltaDiagnostics;
+        agentConversations?: WorkspaceSyncDomainDeltaDiagnostics;
         taskEvents: WorkspaceSyncDomainDeltaDiagnostics;
         taxonomy: WorkspaceSyncDomainDeltaDiagnostics;
     };
@@ -300,6 +490,7 @@ export interface WorkspaceSyncDocumentSnapshot {
     caption?: string | null;
     originalFilename?: string | null;
     linkRole?: 'attachment' | 'reference';
+    links?: WorkspaceAssetSyncLinkPayload[];
 }
 export interface WorkspaceSyncAssetSnapshot {
     path: string;
@@ -316,13 +507,16 @@ export interface WorkspaceSyncAssetSnapshot {
     caption?: string | null;
     originalFilename?: string | null;
     linkRole?: 'attachment' | 'image' | 'reference';
+    links?: WorkspaceAssetSyncLinkPayload[];
 }
 export declare function buildWorkspaceSyncPayloadModel(input: {
     tasks: TaskItem[];
     archivedTasks: TaskItem[];
+    taskRelationships?: TaskRelationshipRecord[];
     lastPushedTaskIds: Set<string>;
     pendingDeletedTaskIds: Set<string>;
     pendingDeletedTaskWatermarks?: Map<string, string>;
+    deletedTasks?: DeletedTaskRecord[];
     initiatives?: InitiativeItem[];
     workstreams?: WorkstreamItem[];
     taxonomies?: unknown[];
@@ -335,6 +529,10 @@ export declare function buildWorkspaceSyncPayloadModel(input: {
     documentReviewSessions?: WorkspaceSyncDocumentReviewSessionSnapshot[];
     documentReviewComments?: WorkspaceSyncDocumentReviewCommentSnapshot[];
     annotatedAttachmentSessions?: WorkspaceSyncAnnotatedAttachmentSessionSnapshot[];
+    taskforceAgents?: WorkspaceSyncTaskforceAgentSnapshot[];
+    agentRoles?: WorkspaceSyncAgentRoleSnapshot[];
+    taskforceAgentSkills?: WorkspaceSyncTaskforceAgentSkillSnapshot[];
+    agentConversations?: WorkspaceSyncAgentConversationSnapshot[];
     taskEvents?: WorkspaceSyncEntityEventSnapshot[];
     lastPushedInitiativeIds?: Set<string>;
     lastPushedInitiativeWatermarks?: Map<string, string>;
@@ -352,6 +550,12 @@ export declare function buildWorkspaceSyncPayloadModel(input: {
     lastPushedDocumentReviewCommentWatermarks?: Map<string, string>;
     lastPushedAnnotatedAttachmentSessionIds?: Set<string>;
     lastPushedAnnotatedAttachmentSessionWatermarks?: Map<string, string>;
+    lastPushedTaskforceAgentIds?: Set<string>;
+    lastPushedTaskforceAgentWatermarks?: Map<string, string>;
+    lastPushedTaskforceAgentSkillIds?: Set<string>;
+    lastPushedTaskforceAgentSkillWatermarks?: Map<string, string>;
+    lastPushedAgentConversationIds?: Set<string>;
+    lastPushedAgentConversationWatermarks?: Map<string, string>;
     lastPushedTaskEventWatermarks?: Map<string, string>;
     baselineResetReason?: WorkspaceSyncBaselineResetReason | null;
     /**
@@ -362,12 +566,15 @@ export declare function buildWorkspaceSyncPayloadModel(input: {
      */
     lastPushedWatermarks?: Map<string, string>;
     lastPushedTaskChangeKeys?: Map<string, string>;
+    lastPushedTaskRelationshipChangeKeys?: Map<string, string>;
+    lastPushedTaxonomyChangeKey?: string;
     lastPushedAiProfileChangeKeys?: Map<string, string>;
 }): WorkspaceSyncPayload;
 export declare function buildWorkspaceSyncSignatureModel(input: {
     workspaceId: string;
     tasks: TaskItem[];
     archivedTasks: TaskItem[];
+    taskRelationships?: TaskRelationshipRecord[];
     pendingDeletedTaskIds?: Set<string>;
     initiatives?: InitiativeItem[];
     workstreams?: WorkstreamItem[];
@@ -379,5 +586,9 @@ export declare function buildWorkspaceSyncSignatureModel(input: {
     documentReviewSessions?: WorkspaceSyncDocumentReviewSessionSnapshot[];
     documentReviewComments?: WorkspaceSyncDocumentReviewCommentSnapshot[];
     annotatedAttachmentSessions?: WorkspaceSyncAnnotatedAttachmentSessionSnapshot[];
+    taskforceAgents?: WorkspaceSyncTaskforceAgentSnapshot[];
+    agentRoles?: WorkspaceSyncAgentRoleSnapshot[];
+    taskforceAgentSkills?: WorkspaceSyncTaskforceAgentSkillSnapshot[];
+    agentConversations?: WorkspaceSyncAgentConversationSnapshot[];
     taskEvents?: WorkspaceSyncEntityEventSnapshot[];
 }): string;