@taskforcehq/taskforce 0.3.305 → 0.3.307

package/dist/sync/workspaceSyncModel.d.ts

@@ -1,20 +1,28 @@
-import type { InitiativeItem, TaskEvent, TaskItem, WorkstreamItem } from '../types';
+import type { AttachmentItem, 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 AiProfileSurfaceType } from '../shared/aiProfileSurfaceType.js';
+import { type AiProfileSeatScope } from '../shared/aiProfileSeatScope.js';
 import { type TaskSyncPayload } from './taskSyncPayload.js';
 export type WorkspaceSyncTaskSnapshot = TaskSyncPayload;
-export interface WorkspaceSyncTaskEventSnapshot {
+export interface WorkspaceSyncEntityEventSnapshot {
     id: string;
-    taskId: string;
     workspaceId: string;
+    entityType: 'task' | 'initiative' | 'workstream';
+    entityId: string;
+    taskId?: string;
     action: string;
     actor: string;
     actorType: 'system' | 'human' | 'ai';
-    details?: TaskEvent['details'];
+    details?: EntityEvent['details'];
     createdAt: string;
 }
+export type WorkspaceSyncTaskEventSnapshot = WorkspaceSyncEntityEventSnapshot & {
+    entityType: 'task';
+    entityId: string;
+    taskId: string;
+};
 export interface WorkspaceSyncAiProfileSnapshot {
     id: string;
     workspaceId: string;
@@ -23,12 +31,22 @@ export interface WorkspaceSyncAiProfileSnapshot {
     username: string;
     icon: string;
     color: string;
+    avatarUrl?: string | null;
+    avatarSourceUrl?: string | null;
+    avatarRevision?: number;
+    avatarUpdatedAt?: string | null;
     description?: string | null;
     role?: string | null;
     provider?: string | null;
     model?: string | null;
     surfaceType?: AiProfileSurfaceType | null;
+    seatScope?: AiProfileSeatScope | null;
     providerMetadata?: Record<string, unknown> | null;
+    archivedAt?: string | null;
+    archivedBy?: string | null;
+    archivedReason?: string | null;
+    mergedIntoProfileId?: string | null;
+    rosterStateUpdatedAt?: string | null;
     createdAt: string;
     updatedAt: string;
     lastActiveAt?: string | null;
@@ -96,6 +114,7 @@ export interface WorkspaceSyncInitiativeSnapshot {
     createdAt: string;
     updatedAt?: string;
     order?: number | null;
+    attachments?: Array<string | AttachmentItem>;
     isArchived?: boolean;
 }
 export interface WorkspaceSyncWorkstreamSnapshot {
@@ -109,6 +128,7 @@ export interface WorkspaceSyncWorkstreamSnapshot {
     createdAt: string;
     updatedAt?: string;
     order?: number | null;
+    attachments?: Array<string | AttachmentItem>;
     isArchived?: boolean;
 }
 export type WorkspaceSyncChange = {
@@ -144,6 +164,8 @@ export type WorkspaceSyncChange = {
     referenceNumber?: number | null;
     version?: number | null;
     taskId?: string | null;
+    linkTargetType?: 'task' | 'initiative' | 'workstream' | null;
+    linkTargetId?: string | null;
     logicalName?: string | null;
     caption?: string | null;
     originalFilename?: string | null;
@@ -163,6 +185,8 @@ export type WorkspaceSyncChange = {
     mimeType: string;
     referenceNumber?: number | null;
     taskId?: string | null;
+    linkTargetType?: 'task' | 'initiative' | 'workstream' | null;
+    linkTargetId?: string | null;
     logicalName?: string | null;
     caption?: string | null;
     originalFilename?: string | null;
@@ -193,6 +217,9 @@ export type WorkspaceSyncChange = {
     op: 'annotated-attachment-session-delete';
     sessionId: string;
     deletedAt?: string;
+} | {
+    op: 'entity-event-upsert';
+    event: WorkspaceSyncEntityEventSnapshot;
 } | {
     op: 'task-event-upsert';
     event: WorkspaceSyncTaskEventSnapshot;
@@ -200,6 +227,8 @@ export type WorkspaceSyncChange = {
 export interface WorkspaceSyncPayload {
     changes: WorkspaceSyncChange[];
     currentTaskIds: Set<string>;
+    currentTaskWatermarks?: Map<string, string>;
+    currentTaskChangeKeys?: Map<string, string>;
     deleteTaskIds: Set<string>;
     currentInitiativeIds: Set<string>;
     currentInitiativeWatermarks: Map<string, string>;
@@ -207,6 +236,7 @@ export interface WorkspaceSyncPayload {
     currentWorkstreamWatermarks: Map<string, string>;
     currentAiProfileIds: Set<string>;
     currentAiProfileWatermarks: Map<string, string>;
+    currentAiProfileChangeKeys?: Map<string, string>;
     currentDocumentPaths: Set<string>;
     deleteDocumentPaths: Set<string>;
     currentDocumentWatermarks: Map<string, string>;
@@ -225,6 +255,34 @@ export interface WorkspaceSyncPayload {
     currentTaskEventWatermarks: Map<string, string>;
     /** Watermarks for every task upsert included in this payload (id → updatedAt|createdAt). */
     pushedWatermarks: Map<string, string>;
+    pushedTaskChangeKeys?: Map<string, string>;
+    deltaDiagnostics?: WorkspaceSyncDeltaDiagnostics;
+}
+export type WorkspaceSyncBaselineResetReason = 'missing-baseline' | 'repair-reset' | 'storage-write-failed';
+export interface WorkspaceSyncDomainDeltaDiagnostics {
+    mode: 'none' | 'delta' | 'send-all';
+    reason: WorkspaceSyncBaselineResetReason | 'full-state-domain' | null;
+    currentCount: number;
+    baselineCount: number;
+    changeCount: number;
+}
+export interface WorkspaceSyncDeltaDiagnostics {
+    totalChanges: number;
+    byOp: Record<string, number>;
+    baselineResetReason: WorkspaceSyncBaselineResetReason | null;
+    domains: {
+        tasks: WorkspaceSyncDomainDeltaDiagnostics;
+        initiatives: WorkspaceSyncDomainDeltaDiagnostics;
+        workstreams: WorkspaceSyncDomainDeltaDiagnostics;
+        aiProfiles: WorkspaceSyncDomainDeltaDiagnostics;
+        documents: WorkspaceSyncDomainDeltaDiagnostics;
+        assets: WorkspaceSyncDomainDeltaDiagnostics;
+        documentReviewSessions: WorkspaceSyncDomainDeltaDiagnostics;
+        documentReviewComments: WorkspaceSyncDomainDeltaDiagnostics;
+        annotatedAttachmentSessions: WorkspaceSyncDomainDeltaDiagnostics;
+        taskEvents: WorkspaceSyncDomainDeltaDiagnostics;
+        taxonomy: WorkspaceSyncDomainDeltaDiagnostics;
+    };
 }
 export declare function toWorkspaceSyncTaskSnapshot(task: TaskItem): WorkspaceSyncTaskSnapshot;
 export interface WorkspaceSyncDocumentSnapshot {
@@ -236,6 +294,8 @@ export interface WorkspaceSyncDocumentSnapshot {
     referenceNumber?: number | null;
     version?: number | null;
     taskId?: string | null;
+    linkTargetType?: 'task' | 'initiative' | 'workstream' | null;
+    linkTargetId?: string | null;
     logicalName?: string | null;
     caption?: string | null;
     originalFilename?: string | null;
@@ -250,6 +310,8 @@ export interface WorkspaceSyncAssetSnapshot {
     mimeType: string;
     referenceNumber?: number | null;
     taskId?: string | null;
+    linkTargetType?: 'task' | 'initiative' | 'workstream' | null;
+    linkTargetId?: string | null;
     logicalName?: string | null;
     caption?: string | null;
     originalFilename?: string | null;
@@ -268,10 +330,12 @@ export declare function buildWorkspaceSyncPayloadModel(input: {
     aiProfiles?: WorkspaceSyncAiProfileSnapshot[];
     documents?: WorkspaceSyncDocumentSnapshot[];
     assets?: WorkspaceSyncAssetSnapshot[];
+    currentDocumentPaths?: Iterable<string>;
+    currentAssetPaths?: Iterable<string>;
     documentReviewSessions?: WorkspaceSyncDocumentReviewSessionSnapshot[];
     documentReviewComments?: WorkspaceSyncDocumentReviewCommentSnapshot[];
     annotatedAttachmentSessions?: WorkspaceSyncAnnotatedAttachmentSessionSnapshot[];
-    taskEvents?: WorkspaceSyncTaskEventSnapshot[];
+    taskEvents?: WorkspaceSyncEntityEventSnapshot[];
     lastPushedInitiativeIds?: Set<string>;
     lastPushedInitiativeWatermarks?: Map<string, string>;
     lastPushedWorkstreamIds?: Set<string>;
@@ -289,6 +353,7 @@ export declare function buildWorkspaceSyncPayloadModel(input: {
     lastPushedAnnotatedAttachmentSessionIds?: Set<string>;
     lastPushedAnnotatedAttachmentSessionWatermarks?: Map<string, string>;
     lastPushedTaskEventWatermarks?: Map<string, string>;
+    baselineResetReason?: WorkspaceSyncBaselineResetReason | null;
     /**
      * Watermark (updatedAt|createdAt) of each task as of its last successful push.
      * When provided, only tasks whose watermark differs from this map are included
@@ -296,6 +361,8 @@ export declare function buildWorkspaceSyncPayloadModel(input: {
      * Absent or empty map = include all tasks (first-push / full-sync behaviour).
      */
     lastPushedWatermarks?: Map<string, string>;
+    lastPushedTaskChangeKeys?: Map<string, string>;
+    lastPushedAiProfileChangeKeys?: Map<string, string>;
 }): WorkspaceSyncPayload;
 export declare function buildWorkspaceSyncSignatureModel(input: {
     workspaceId: string;
@@ -312,5 +379,5 @@ export declare function buildWorkspaceSyncSignatureModel(input: {
     documentReviewSessions?: WorkspaceSyncDocumentReviewSessionSnapshot[];
     documentReviewComments?: WorkspaceSyncDocumentReviewCommentSnapshot[];
     annotatedAttachmentSessions?: WorkspaceSyncAnnotatedAttachmentSessionSnapshot[];
-    taskEvents?: WorkspaceSyncTaskEventSnapshot[];
+    taskEvents?: WorkspaceSyncEntityEventSnapshot[];
 }): string;