@taskforcehq/taskforce 0.3.326 → 0.3.328

package/dist/hooks/sync/orchestratorShared.js

@@ -1,6 +1,8 @@
 import { parseAiProfileSurfaceType } from '../../shared/aiProfileSurfaceType.js';
 import { parseAiProfileSeatScope } from '../../shared/aiProfileSeatScope.js';
 import { normalizeSyncNullableId, normalizeSyncNullableIsoString, normalizeSyncNullableString, normalizeSyncSameOriginAssetUrl, } from '../../sync/syncFieldSemantics.js';
+import { normalizeTaskforceAgentModelKey, normalizeTaskforceAgentProviderKey, } from '../../shared/taskforceAgentModels.js';
+export { flattenTaskEvents } from '../../sync/workspaceSyncSnapshotProjection.js';
 export const USER_GLOBAL_SYNC_META_KEY = 'taskforce.userGlobalSyncMeta.v1';
 export const SYNC_DEBUG_LOG_KEY = 'taskforce.syncDebug.v1';
 export const WORKSPACE_BOOTSTRAP_TIMEOUT_MS = 120_000;
@@ -61,6 +63,59 @@ export function normalizeWorkspaceSyncAiProfileSnapshotEntry(entry) {
         lastActiveAt: normalizeSyncNullableIsoString(entry?.lastActiveAt ?? entry?.last_active_at)
     };
 }
+export function normalizeWorkspaceSyncTaskforceAgentSnapshotEntry(entry) {
+    const tier = String(entry?.modelTier || entry?.model_tier || '').trim().toLowerCase();
+    return {
+        id: String(entry?.id || '').trim(),
+        tenantId: String(entry?.tenantId || entry?.tenant_id || '').trim() || undefined,
+        workspaceId: String(entry?.workspaceId || entry?.workspace_id || '').trim(),
+        name: String(entry?.name || 'Agent').trim() || 'Agent',
+        modelProvider: 'taskforce_hq',
+        providerKey: normalizeTaskforceAgentProviderKey(entry?.providerKey ?? entry?.provider_key),
+        modelKey: normalizeTaskforceAgentModelKey(entry?.modelKey ?? entry?.model_key, entry?.providerKey ?? entry?.provider_key),
+        modelTier: tier === 'fast' || tier === 'advanced' ? tier : 'balanced',
+        systemPrompt: typeof (entry?.systemPrompt ?? entry?.system_prompt) === 'string'
+            ? String(entry?.systemPrompt ?? entry?.system_prompt)
+            : '',
+        enabled: (entry?.enabled ?? true) !== false && Number(entry?.enabled ?? 1) !== 0,
+        createdByUserId: normalizeSyncNullableId(entry?.createdByUserId ?? entry?.created_by_user_id),
+        updatedByUserId: normalizeSyncNullableId(entry?.updatedByUserId ?? entry?.updated_by_user_id),
+        createdAt: String(entry?.createdAt || entry?.created_at || '').trim(),
+        updatedAt: String(entry?.updatedAt || entry?.updated_at || entry?.createdAt || entry?.created_at || '').trim(),
+        deletedAt: normalizeSyncNullableIsoString(entry?.deletedAt ?? entry?.deleted_at),
+    };
+}
+export function normalizeWorkspaceSyncAgentConversationSnapshotEntry(entry) {
+    const messages = Array.isArray(entry?.messages)
+        ? entry.messages
+            .map((message) => ({
+            role: message?.role === 'assistant' ? 'assistant' : 'user',
+            content: String(message?.content || '').trim()
+        }))
+            .filter((message) => message.content.length > 0)
+        : [];
+    const usage = (entry?.usage ?? entry?.usage_json) && typeof (entry?.usage ?? entry?.usage_json) === 'object'
+        ? (entry?.usage ?? entry?.usage_json)
+        : null;
+    return {
+        id: String(entry?.id || '').trim(),
+        tenantId: String(entry?.tenantId || entry?.tenant_id || '').trim() || undefined,
+        workspaceId: String(entry?.workspaceId || entry?.workspace_id || '').trim(),
+        agentId: String(entry?.agentId || entry?.agent_id || '').trim(),
+        taskId: normalizeSyncNullableId(entry?.taskId ?? entry?.task_id),
+        title: String(entry?.title || 'Agent chat').trim() || 'Agent chat',
+        messages,
+        modelProvider: normalizeSyncNullableString(entry?.modelProvider ?? entry?.model_provider),
+        modelId: normalizeSyncNullableString(entry?.modelId ?? entry?.model_id),
+        usage,
+        latencyMs: Number.isFinite(Number(entry?.latencyMs ?? entry?.latency_ms)) ? Number(entry?.latencyMs ?? entry?.latency_ms) : null,
+        createdByUserId: normalizeSyncNullableId(entry?.createdByUserId ?? entry?.created_by_user_id),
+        updatedByUserId: normalizeSyncNullableId(entry?.updatedByUserId ?? entry?.updated_by_user_id),
+        createdAt: String(entry?.createdAt || entry?.created_at || '').trim(),
+        updatedAt: String(entry?.updatedAt || entry?.updated_at || entry?.createdAt || entry?.created_at || '').trim(),
+        deletedAt: normalizeSyncNullableIsoString(entry?.deletedAt ?? entry?.deleted_at),
+    };
+}
 export function readUserGlobalSyncMeta() {
     if (typeof window === 'undefined')
         return {};
@@ -108,6 +163,8 @@ export function flattenDocumentReviewComments(sessions) {
             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,
             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,
@@ -115,115 +172,27 @@ export function flattenDocumentReviewComments(sessions) {
             .filter((comment) => comment.id.length > 0 && comment.sessionId.length > 0);
     });
 }
-export function flattenTaskEvents(tasks, archivedTasks, initiatives = [], workstreams = []) {
-    const deduped = new Map();
-    for (const task of [...(tasks || []), ...(archivedTasks || [])]) {
-        const taskEvents = Array.isArray(task?.taskEvents) ? task.taskEvents : [];
-        for (const event of taskEvents) {
-            const id = String(event?.id || '').trim();
-            const taskId = String(event?.taskId || task?.id || '').trim();
-            const workspaceId = String(event?.workspaceId || '').trim();
-            const createdAt = String(event?.createdAt || '').trim();
-            if (!id || !taskId || !workspaceId || !createdAt)
-                continue;
-            const nextEvent = {
-                id,
-                workspaceId,
-                entityType: 'task',
-                entityId: taskId,
-                taskId,
-                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,
-                createdAt,
-            };
-            const existing = deduped.get(id);
-            if (!existing || nextEvent.createdAt > existing.createdAt) {
-                deduped.set(id, nextEvent);
-            }
-        }
-    }
-    for (const initiative of initiatives || []) {
-        const entityEvents = Array.isArray(initiative?.entityEvents) ? initiative.entityEvents : [];
-        for (const event of entityEvents) {
-            const id = String(event?.id || '').trim();
-            const entityId = String(event?.entityId || initiative?.id || '').trim();
-            const workspaceId = String(event?.workspaceId || '').trim();
-            const createdAt = String(event?.createdAt || '').trim();
-            if (!id || !entityId || !workspaceId || !createdAt)
-                continue;
-            const nextEvent = {
-                id,
-                workspaceId,
-                entityType: 'initiative',
-                entityId,
-                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,
-                createdAt,
-            };
-            const existing = deduped.get(id);
-            if (!existing || nextEvent.createdAt > existing.createdAt) {
-                deduped.set(id, nextEvent);
-            }
-        }
-    }
-    for (const workstream of workstreams || []) {
-        const entityEvents = Array.isArray(workstream?.entityEvents) ? workstream.entityEvents : [];
-        for (const event of entityEvents) {
-            const id = String(event?.id || '').trim();
-            const entityId = String(event?.entityId || workstream?.id || '').trim();
-            const workspaceId = String(event?.workspaceId || '').trim();
-            const createdAt = String(event?.createdAt || '').trim();
-            if (!id || !entityId || !workspaceId || !createdAt)
-                continue;
-            const nextEvent = {
-                id,
-                workspaceId,
-                entityType: 'workstream',
-                entityId,
-                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,
-                createdAt,
-            };
-            const existing = deduped.get(id);
-            if (!existing || nextEvent.createdAt > existing.createdAt) {
-                deduped.set(id, nextEvent);
-            }
-        }
-    }
-    return Array.from(deduped.values()).sort((left, right) => {
-        if (left.createdAt !== right.createdAt)
-            return left.createdAt.localeCompare(right.createdAt);
-        return left.id.localeCompare(right.id);
-    });
-}
 export function buildPersistedSyncWatermarksSnapshot(data) {
     return {
         taskIds: Array.from(data.taskIds.values()),
         taskWatermarks: Array.from(data.taskWatermarks.entries()),
         taskChangeKeys: Array.from((data.taskChangeKeys || new Map()).entries()),
+        taskRelationshipChangeKeys: Array.from((data.taskRelationshipChangeKeys || new Map()).entries()),
         initiativeWatermarks: Array.from(data.initiativeWatermarks.entries()),
         workstreamWatermarks: Array.from(data.workstreamWatermarks.entries()),
         aiProfileWatermarks: Array.from(data.aiProfileWatermarks.entries()),
         aiProfileChangeKeys: Array.from((data.aiProfileChangeKeys || new Map()).entries()),
+        taskforceAgentWatermarks: Array.from((data.taskforceAgentWatermarks || new Map()).entries()),
+        taskforceAgentSkillWatermarks: Array.from((data.taskforceAgentSkillWatermarks || new Map()).entries()),
+        agentConversationWatermarks: Array.from((data.agentConversationWatermarks || new Map()).entries()),
         documentWatermarks: Array.from(data.documentWatermarks.entries()),
         assetWatermarks: Array.from(data.assetWatermarks.entries()),
         documentReviewSessionWatermarks: Array.from(data.documentReviewSessionWatermarks.entries()),
         documentReviewCommentWatermarks: Array.from(data.documentReviewCommentWatermarks.entries()),
         annotatedAttachmentSessionWatermarks: Array.from(data.annotatedAttachmentSessionWatermarks.entries()),
         taskEventWatermarks: Array.from(data.taskEventWatermarks.entries()),
-        taxonomyStateFingerprint: typeof data.taxonomyStateFingerprint === 'string' ? data.taxonomyStateFingerprint : ''
+        taxonomyStateFingerprint: typeof data.taxonomyStateFingerprint === 'string' ? data.taxonomyStateFingerprint : '',
+        taxonomyChangeKey: typeof data.taxonomyChangeKey === 'string' ? data.taxonomyChangeKey : ''
     };
 }
 export function parsePersistedSyncWatermarksSnapshot(snapshot, taxonomyStateFingerprint) {
@@ -242,16 +211,21 @@ export function parsePersistedSyncWatermarksSnapshot(snapshot, taxonomyStateFing
         taskIds,
         taskWatermarks,
         taskChangeKeys: new Map(Array.isArray(snapshot.taskChangeKeys) ? snapshot.taskChangeKeys : []),
+        taskRelationshipChangeKeys: new Map(Array.isArray(snapshot.taskRelationshipChangeKeys) ? snapshot.taskRelationshipChangeKeys : []),
         initiativeWatermarks: new Map(Array.isArray(snapshot.initiativeWatermarks) ? snapshot.initiativeWatermarks : []),
         workstreamWatermarks: new Map(Array.isArray(snapshot.workstreamWatermarks) ? snapshot.workstreamWatermarks : []),
         aiProfileWatermarks: new Map(Array.isArray(snapshot.aiProfileWatermarks) ? snapshot.aiProfileWatermarks : []),
         aiProfileChangeKeys: new Map(Array.isArray(snapshot.aiProfileChangeKeys) ? snapshot.aiProfileChangeKeys : []),
+        taskforceAgentWatermarks: new Map(Array.isArray(snapshot.taskforceAgentWatermarks) ? snapshot.taskforceAgentWatermarks : []),
+        taskforceAgentSkillWatermarks: new Map(Array.isArray(snapshot.taskforceAgentSkillWatermarks) ? snapshot.taskforceAgentSkillWatermarks : []),
+        agentConversationWatermarks: new Map(Array.isArray(snapshot.agentConversationWatermarks) ? snapshot.agentConversationWatermarks : []),
         documentWatermarks: new Map(Array.isArray(snapshot.documentWatermarks) ? snapshot.documentWatermarks : []),
         assetWatermarks: new Map(Array.isArray(snapshot.assetWatermarks) ? snapshot.assetWatermarks : []),
         documentReviewSessionWatermarks: new Map(Array.isArray(snapshot.documentReviewSessionWatermarks) ? snapshot.documentReviewSessionWatermarks : []),
         documentReviewCommentWatermarks: new Map(Array.isArray(snapshot.documentReviewCommentWatermarks) ? snapshot.documentReviewCommentWatermarks : []),
         annotatedAttachmentSessionWatermarks: new Map(Array.isArray(snapshot.annotatedAttachmentSessionWatermarks) ? snapshot.annotatedAttachmentSessionWatermarks : []),
         taskEventWatermarks: new Map(Array.isArray(snapshot.taskEventWatermarks) ? snapshot.taskEventWatermarks : []),
+        taxonomyChangeKey: typeof snapshot.taxonomyChangeKey === 'string' ? snapshot.taxonomyChangeKey : '',
     };
 }
 export function readPersistedSyncWatermarks(workspaceId, taxonomyStateFingerprint) {
@@ -263,7 +237,7 @@ export function readPersistedSyncWatermarks(workspaceId, taxonomyStateFingerprin
         if (!raw)
             return null;
         const parsed = JSON.parse(raw);
-        if (!parsed || (parsed.v !== 2 && parsed.v !== 3 && parsed.v !== 4 && parsed.v !== 5 && parsed.v !== 6 && parsed.v !== 7 && parsed.v !== 8 && parsed.v !== 9 && parsed.v !== 10 && parsed.v !== 11))
+        if (!parsed || (parsed.v !== 2 && parsed.v !== 3 && parsed.v !== 4 && parsed.v !== 5 && parsed.v !== 6 && parsed.v !== 7 && parsed.v !== 8 && parsed.v !== 9 && parsed.v !== 10 && parsed.v !== 11 && parsed.v !== 12))
             return null;
         return parsePersistedSyncWatermarksSnapshot(parsed, taxonomyStateFingerprint);
     }
@@ -277,7 +251,7 @@ export function savePersistedSyncWatermarks(workspaceId, data) {
     try {
         const key = `${WORKSPACE_SYNC_WATERMARKS_KEY_PREFIX}.${workspaceId}`;
         window.localStorage.setItem(key, JSON.stringify({
-            v: 11,
+            v: 12,
             savedAt: new Date().toISOString(),
             ...buildPersistedSyncWatermarksSnapshot(data)
         }));

package/dist/hooks/sync/pullLifecycle.d.ts

@@ -1,31 +1 @@
-import type { WorkspaceSyncPhase } from '../../sync/workspaceSyncState';
-export interface WorkspacePullRequestPlan {
-    bootstrap: boolean;
-    cursor: string | null;
-    successEventType: 'bootstrap' | 'pull';
-}
-interface ResolveWorkspacePullRequestPlanArgs {
-    workspaceSyncPhase: WorkspaceSyncPhase;
-    forceCursorNull?: boolean;
-    currentCursor: string | null;
-}
-interface ResolveWorkspacePullSuccessPlanArgs {
-    workspaceSyncPhase: WorkspaceSyncPhase;
-    forceCursorNull?: boolean;
-    startupFullReconcileRan: boolean;
-    pendingSignature: string;
-    fallbackSignature: string;
-    lastPushedSignature: string;
-}
-export interface WorkspacePullSuccessPlan {
-    successEventType: 'bootstrap' | 'pull';
-    shouldCaptureAttachBootstrapBaseline: boolean;
-    shouldClearPendingSignature: boolean;
-    shouldRefreshReferenceSnapshots: boolean;
-    shouldSeedWorkspaceSnapshotPushBaseline: boolean;
-    shouldScheduleStartupFullReconcile: boolean;
-    deferredPushSignature: string | null;
-}
-export declare function resolveWorkspacePullRequestPlan({ workspaceSyncPhase, forceCursorNull, currentCursor }: ResolveWorkspacePullRequestPlanArgs): WorkspacePullRequestPlan;
-export declare function resolveWorkspacePullSuccessPlan({ workspaceSyncPhase, forceCursorNull, startupFullReconcileRan, pendingSignature, fallbackSignature, lastPushedSignature }: ResolveWorkspacePullSuccessPlanArgs): WorkspacePullSuccessPlan;
-export {};
+export * from '../../sync/engine/workspaceSyncEnginePullPolicy.js';

package/dist/hooks/sync/pullLifecycle.js

@@ -1,24 +1 @@
-export function resolveWorkspacePullRequestPlan({ workspaceSyncPhase, forceCursorNull, currentCursor }) {
-    const bootstrap = workspaceSyncPhase === 'attach-cloud';
-    return {
-        bootstrap,
-        cursor: bootstrap || forceCursorNull === true ? null : currentCursor,
-        successEventType: bootstrap ? 'bootstrap' : 'pull'
-    };
-}
-export function resolveWorkspacePullSuccessPlan({ workspaceSyncPhase, forceCursorNull, startupFullReconcileRan, pendingSignature, fallbackSignature, lastPushedSignature }) {
-    const bootstrap = workspaceSyncPhase === 'attach-cloud';
-    const nextSignature = pendingSignature || fallbackSignature;
-    const deferredPushSignature = (!bootstrap
-        && nextSignature
-        && nextSignature !== lastPushedSignature) ? nextSignature : null;
-    return {
-        successEventType: bootstrap ? 'bootstrap' : 'pull',
-        shouldCaptureAttachBootstrapBaseline: bootstrap,
-        shouldClearPendingSignature: bootstrap || deferredPushSignature !== null,
-        shouldRefreshReferenceSnapshots: bootstrap,
-        shouldSeedWorkspaceSnapshotPushBaseline: bootstrap,
-        shouldScheduleStartupFullReconcile: !forceCursorNull && !bootstrap && !startupFullReconcileRan,
-        deferredPushSignature
-    };
-}
+export * from '../../sync/engine/workspaceSyncEnginePullPolicy.js';

package/dist/hooks/sync/realtime.d.ts

@@ -11,9 +11,12 @@ interface CreateRealtimeSyncBridgeArgs {
     realtimeSuppressedEventIdsRef: MutableRefObject<Set<string>>;
     clearWorkspaceRetry: () => void;
     isWorkspaceRetryPending: () => boolean;
+    isExecutionAuthorized?: () => boolean;
+    isServerOwned?: () => boolean;
+    signalServerWake?: (eventIds: string[]) => Promise<boolean>;
     pullWorkspaceChangesFromCloud: () => Promise<boolean>;
 }
-export declare function createRealtimeSyncBridge({ cloudAuthConfigured, runtimeMode, workspaceCloudSyncEnabled, workspaceSyncPhase, workspacePullInFlightRef, realtimePullDebounceRef, realtimeSuppressedEventIdsRef, clearWorkspaceRetry, isWorkspaceRetryPending, pullWorkspaceChangesFromCloud }: CreateRealtimeSyncBridgeArgs): {
+export declare function createRealtimeSyncBridge({ cloudAuthConfigured, runtimeMode, workspaceCloudSyncEnabled, workspaceSyncPhase, workspacePullInFlightRef, realtimePullDebounceRef, realtimeSuppressedEventIdsRef, clearWorkspaceRetry, isWorkspaceRetryPending, isExecutionAuthorized, isServerOwned, signalServerWake, pullWorkspaceChangesFromCloud }: CreateRealtimeSyncBridgeArgs): {
     handleRealtimeSignal: (signal: RealtimeSyncSignal) => void;
     recordSuppressedEventIds: (eventIds: Iterable<string>, options?: {
         queueRef?: MutableRefObject<string[]>;

package/dist/hooks/sync/realtime.js

@@ -1,11 +1,105 @@
-export function createRealtimeSyncBridge({ cloudAuthConfigured, runtimeMode, workspaceCloudSyncEnabled, workspaceSyncPhase, workspacePullInFlightRef, realtimePullDebounceRef, realtimeSuppressedEventIdsRef, clearWorkspaceRetry, isWorkspaceRetryPending, pullWorkspaceChangesFromCloud }) {
+const MAX_SERVER_WAKE_EVENT_IDS = 512;
+export function createRealtimeSyncBridge({ cloudAuthConfigured, runtimeMode, workspaceCloudSyncEnabled, workspaceSyncPhase, workspacePullInFlightRef, realtimePullDebounceRef, realtimeSuppressedEventIdsRef, clearWorkspaceRetry, isWorkspaceRetryPending, isExecutionAuthorized = () => true, isServerOwned = () => false, signalServerWake, pullWorkspaceChangesFromCloud }) {
+    const pendingServerWakeEventIds = new Set();
+    let pendingServerWakeHasIdentityFreeSignal = false;
+    let serverWakeInFlight = false;
+    let queuedServerWakeEventIds = null;
+    let serverWakeVerificationPending = false;
+    const dispatchNextServerWake = () => {
+        if (serverWakeInFlight || !isServerOwned())
+            return;
+        const eventIds = serverWakeVerificationPending
+            ? []
+            : queuedServerWakeEventIds;
+        if (!eventIds)
+            return;
+        serverWakeVerificationPending = false;
+        queuedServerWakeEventIds = null;
+        serverWakeInFlight = true;
+        void signalServerWake?.(eventIds).catch(() => {
+            // The server's periodic inspection remains the correctness backstop.
+        }).finally(() => {
+            serverWakeInFlight = false;
+            dispatchNextServerWake();
+        });
+    };
+    const enqueueServerWake = (eventIds) => {
+        if (serverWakeVerificationPending)
+            return;
+        if (!serverWakeInFlight && queuedServerWakeEventIds === null) {
+            queuedServerWakeEventIds = eventIds;
+            dispatchNextServerWake();
+            return;
+        }
+        if (queuedServerWakeEventIds === null) {
+            queuedServerWakeEventIds = eventIds;
+            return;
+        }
+        queuedServerWakeEventIds = null;
+        serverWakeVerificationPending = true;
+    };
+    const enqueueServerVerificationWake = () => {
+        queuedServerWakeEventIds = null;
+        serverWakeVerificationPending = true;
+        dispatchNextServerWake();
+    };
+    const flushServerWake = () => {
+        if (!pendingServerWakeHasIdentityFreeSignal
+            && pendingServerWakeEventIds.size === 0) {
+            return;
+        }
+        const wakeEventIds = pendingServerWakeHasIdentityFreeSignal
+            ? []
+            : Array.from(pendingServerWakeEventIds);
+        pendingServerWakeEventIds.clear();
+        pendingServerWakeHasIdentityFreeSignal = false;
+        if (wakeEventIds.length === 0) {
+            enqueueServerVerificationWake();
+        }
+        else {
+            enqueueServerWake(wakeEventIds);
+        }
+    };
     const handleRealtimeSignal = (signal) => {
         if (!cloudAuthConfigured || runtimeMode !== 'local' || !workspaceCloudSyncEnabled)
             return;
         if (workspaceSyncPhase === 'provision-local')
             return;
-        const eventId = String(signal?.eventId || '').trim();
-        if (eventId && realtimeSuppressedEventIdsRef.current.delete(eventId))
+        const eventIds = Array.from(new Set([
+            ...(signal?.eventIds || []),
+            ...(signal?.eventId ? [signal.eventId] : []),
+        ].map((eventId) => String(eventId || '').trim()).filter(Boolean)));
+        let hasUnsuppressedEvent = eventIds.length === 0;
+        for (const eventId of eventIds) {
+            if (!realtimeSuppressedEventIdsRef.current.delete(eventId)) {
+                hasUnsuppressedEvent = true;
+            }
+        }
+        if (!hasUnsuppressedEvent)
+            return;
+        if (isServerOwned()) {
+            if (eventIds.length === 0) {
+                pendingServerWakeHasIdentityFreeSignal = true;
+            }
+            else if (!pendingServerWakeHasIdentityFreeSignal) {
+                for (const eventId of eventIds) {
+                    pendingServerWakeEventIds.add(eventId);
+                    if (pendingServerWakeEventIds.size >= MAX_SERVER_WAKE_EVENT_IDS) {
+                        enqueueServerWake(Array.from(pendingServerWakeEventIds));
+                        pendingServerWakeEventIds.clear();
+                    }
+                }
+            }
+            if (realtimePullDebounceRef.current !== null) {
+                window.clearTimeout(realtimePullDebounceRef.current);
+            }
+            realtimePullDebounceRef.current = window.setTimeout(() => {
+                realtimePullDebounceRef.current = null;
+                flushServerWake();
+            }, 180);
+            return;
+        }
+        if (!isExecutionAuthorized())
             return;
         if (workspacePullInFlightRef.current)
             return;
@@ -17,6 +111,8 @@ export function createRealtimeSyncBridge({ cloudAuthConfigured, runtimeMode, wor
         }
         realtimePullDebounceRef.current = window.setTimeout(() => {
             realtimePullDebounceRef.current = null;
+            if (!isExecutionAuthorized())
+                return;
             void pullWorkspaceChangesFromCloud();
         }, 180);
     };
@@ -51,6 +147,10 @@ export function createRealtimeSyncBridge({ cloudAuthConfigured, runtimeMode, wor
             window.clearTimeout(realtimePullDebounceRef.current);
             realtimePullDebounceRef.current = null;
         }
+        pendingServerWakeEventIds.clear();
+        pendingServerWakeHasIdentityFreeSignal = false;
+        queuedServerWakeEventIds = null;
+        serverWakeVerificationPending = false;
     };
     return {
         handleRealtimeSignal,

package/dist/hooks/sync/recovery.d.ts

@@ -1,84 +1 @@
-import type { MutableRefObject } from 'react';
-import type { WorkspaceSyncBaselineResetReason } from '../../sync/workspaceSyncModel';
-import type { WorkspaceSyncPhase } from '../../sync/workspaceSyncState';
-type SyncEventType = 'pull' | 'handshake' | 'bootstrap' | 'apply' | 'push';
-interface CreateSyncRecoveryCoordinatorArgs {
-    currentWorkspaceId: string;
-    workspaceCloudSyncEnabled: boolean;
-    workspaceSyncPhase: WorkspaceSyncPhase;
-    workspaceLastPullAt: string | null;
-    lastBootstrapPhaseRef: MutableRefObject<WorkspaceSyncPhase>;
-    workspaceRepairModeRef: MutableRefObject<boolean>;
-    workspaceForceFullAiProfilePushRef: MutableRefObject<boolean>;
-    workspaceStartupRepairRanRef: MutableRefObject<boolean>;
-    workspaceStartupFullReconcileRanRef: MutableRefObject<boolean>;
-    workspaceFullReconcileInFlightRef: MutableRefObject<boolean>;
-    workspacePullCursorRef: MutableRefObject<string | null>;
-    workspaceAttachBootstrapBaselineSignatureRef: MutableRefObject<string>;
-    workspaceCaptureAttachBootstrapBaselineRef: MutableRefObject<boolean>;
-    workspacePendingSignatureRef: MutableRefObject<string>;
-    workspaceLastPushedSignatureRef: MutableRefObject<string>;
-    workspaceLastPushedWatermarksRef: MutableRefObject<Map<string, string>>;
-    workspaceLastPushedTaskChangeKeysRef: MutableRefObject<Map<string, string>>;
-    workspaceLastPushedInitiativeIdsRef: MutableRefObject<Set<string>>;
-    workspaceLastPushedInitiativeWatermarksRef: MutableRefObject<Map<string, string>>;
-    workspaceLastPushedWorkstreamIdsRef: MutableRefObject<Set<string>>;
-    workspaceLastPushedWorkstreamWatermarksRef: MutableRefObject<Map<string, string>>;
-    workspaceLastPushedAiProfileIdsRef: MutableRefObject<Set<string>>;
-    workspaceLastPushedAiProfileWatermarksRef: MutableRefObject<Map<string, string>>;
-    workspaceLastPushedAiProfileChangeKeysRef: MutableRefObject<Map<string, string>>;
-    workspaceLastPushedDocumentPathsRef: MutableRefObject<Set<string>>;
-    workspaceLastPushedDocumentWatermarksRef: MutableRefObject<Map<string, string>>;
-    workspaceLastPushedAssetPathsRef: MutableRefObject<Set<string>>;
-    workspaceLastPushedAssetWatermarksRef: MutableRefObject<Map<string, string>>;
-    workspaceLastPushedDocumentReviewSessionIdsRef: MutableRefObject<Set<string>>;
-    workspaceLastPushedDocumentReviewSessionWatermarksRef: MutableRefObject<Map<string, string>>;
-    workspaceLastPushedDocumentReviewCommentIdsRef: MutableRefObject<Set<string>>;
-    workspaceLastPushedDocumentReviewCommentWatermarksRef: MutableRefObject<Map<string, string>>;
-    workspaceLastPushedAnnotatedAttachmentSessionIdsRef: MutableRefObject<Set<string>>;
-    workspaceLastPushedAnnotatedAttachmentSessionWatermarksRef: MutableRefObject<Map<string, string>>;
-    workspaceLastPushedTaskEventWatermarksRef: MutableRefObject<Map<string, string>>;
-    workspaceBaselineResetReasonRef: MutableRefObject<WorkspaceSyncBaselineResetReason | null>;
-    bootstrapPhaseStartedAtRef: MutableRefObject<number | null>;
-    bootstrapLastProgressAtRef: MutableRefObject<number | null>;
-    acquireWorkspaceSyncLease: (workspaceId: string, owner: 'pull' | 'push' | 'repair') => Promise<boolean>;
-    releaseWorkspaceSyncLease: (workspaceId: string) => void;
-    forceClearWorkspaceSyncLease: (workspaceId: string) => void;
-    clearWorkspaceRetry: () => void;
-    clearWorkspaceIssue: () => void;
-    reportWorkspaceWindowContention: (operation: 'pull' | 'push' | 'repair') => void;
-    reportSyncEvent: (workspaceId: string, event: {
-        eventType: SyncEventType;
-        status: 'success' | 'error';
-        statusCode?: number;
-        errorMessage?: string;
-        changeCount?: number;
-        requestMs?: number;
-        details?: Record<string, unknown>;
-    }) => void;
-    persistWorkspaceSyncPatch: (patch: {
-        phase: WorkspaceSyncPhase;
-        pullCursor: null;
-        startupFullReconcileCompletedAt: null;
-        lastErrorMessage: null;
-    }) => Promise<unknown>;
-    persistWorkspaceSyncWatermarksSnapshotBestEffort: () => boolean;
-    buildWorkspaceSyncSignature: () => string;
-    pullWorkspaceChangesFromCloud: (options?: {
-        repairMode?: boolean;
-        forceCursorNull?: boolean;
-    }) => Promise<boolean>;
-    pushWorkspaceChangesToCloud: (signature: string, options?: {
-        forceAllAiProfiles?: boolean;
-        repairMode?: boolean;
-    }) => Promise<boolean>;
-    cloudAuthConfigured: boolean;
-    runtimeMode: 'local' | 'cloud';
-    isAuthenticated: boolean;
-    checkAuthSession: () => Promise<boolean>;
-}
-export declare function createSyncRecoveryCoordinator({ currentWorkspaceId, workspaceCloudSyncEnabled, workspaceSyncPhase, workspaceLastPullAt, lastBootstrapPhaseRef, workspaceRepairModeRef, workspaceForceFullAiProfilePushRef, workspaceStartupRepairRanRef, workspaceStartupFullReconcileRanRef, workspaceFullReconcileInFlightRef, workspacePullCursorRef, workspaceAttachBootstrapBaselineSignatureRef, workspaceCaptureAttachBootstrapBaselineRef, workspacePendingSignatureRef, workspaceLastPushedSignatureRef, workspaceLastPushedWatermarksRef, workspaceLastPushedTaskChangeKeysRef, workspaceLastPushedInitiativeIdsRef, workspaceLastPushedInitiativeWatermarksRef, workspaceLastPushedWorkstreamIdsRef, workspaceLastPushedWorkstreamWatermarksRef, workspaceLastPushedAiProfileIdsRef, workspaceLastPushedAiProfileWatermarksRef, workspaceLastPushedAiProfileChangeKeysRef, workspaceLastPushedDocumentPathsRef, workspaceLastPushedDocumentWatermarksRef, workspaceLastPushedAssetPathsRef, workspaceLastPushedAssetWatermarksRef, workspaceLastPushedDocumentReviewSessionIdsRef, workspaceLastPushedDocumentReviewSessionWatermarksRef, workspaceLastPushedDocumentReviewCommentIdsRef, workspaceLastPushedDocumentReviewCommentWatermarksRef, workspaceLastPushedAnnotatedAttachmentSessionIdsRef, workspaceLastPushedAnnotatedAttachmentSessionWatermarksRef, workspaceLastPushedTaskEventWatermarksRef, workspaceBaselineResetReasonRef, bootstrapPhaseStartedAtRef, bootstrapLastProgressAtRef, acquireWorkspaceSyncLease, releaseWorkspaceSyncLease, forceClearWorkspaceSyncLease, clearWorkspaceRetry, clearWorkspaceIssue, reportWorkspaceWindowContention, reportSyncEvent, persistWorkspaceSyncPatch, persistWorkspaceSyncWatermarksSnapshotBestEffort, buildWorkspaceSyncSignature, pullWorkspaceChangesFromCloud, pushWorkspaceChangesToCloud, cloudAuthConfigured, runtimeMode, isAuthenticated, checkAuthSession }: CreateSyncRecoveryCoordinatorArgs): {
-    retryWorkspaceCloudSync: () => Promise<boolean>;
-    resetWorkspaceSyncCursorAndPull: () => Promise<void>;
-};
-export {};
+export * from '../../sync/engine/workspaceSyncEngineRecovery.js';