@taskforcehq/taskforce 0.3.326 → 0.3.328

package/dist/hooks/useTaskforce.d.ts

@@ -13,8 +13,7 @@
  *   === SECTION: Auth State ===             Line ~426  — isAuthenticated, authBlocked, userId, beta access
  *   === SECTION: Bootstrap State ===        Line ~442  — bootstrapPhase, setupState, runtimeCapabilities
  *   === SECTION: Fetch Intercept ===        Line ~490  — window.fetch patch for cloud API routing
- *   === SECTION: Workflow Templates ===     Line ~577  — fetchWorkflows, fetchInitiativeTemplates
- *   === SECTION: Export State ===           Line ~678  — exportEnvironment, exportWorkflowsPath
+ *   === SECTION: Initiative Templates ===   Line ~577  — fetchInitiativeTemplates
  *   === SECTION: Task State ===             Line ~1065 — tasks, archivedTasks, editingTaskId
  *   === SECTION: Filter & Sort State ===    Line ~1394 — searchQuery, filterCategories, sortBy, sortOrder
  *   === SECTION: UI State ===               Line ~1469 — uiStateReady, persisted UI preferences
@@ -33,13 +32,17 @@
  *   === SECTION: Return Value ===           Line ~4817 — final return object (public API shape)
  */
 import { type Dispatch, type SetStateAction } from 'react';
-import type { TaskforceConfig, TaskforceTheme, Comment, AttachmentItem, CategoryConfig, TaskItem, TaxonomyDefinition, Environment, TaskAssignee, TaskStatus, DeletedTaskRecord, InitiativeItem, WorkstreamItem, ChecklistItem, PlanningBootstrapWorkstreamTaskSummary } from '../types';
+import type { TaskforceConfig, TaskforceTheme, Comment, AttachmentItem, CategoryConfig, TaskItem, TaxonomyDefinition, TaskAssignee, TaskStatus, DeletedTaskRecord, InitiativeItem, WorkstreamItem, ChecklistItem, PlanningBootstrapPayload, PlanningBootstrapWorkstreamTaskSummary, PlanningLoadState } from '../types';
 import { type FirstClassTaxonomyDisplayLabels } from '../shared/taxonomyState.js';
+import type { PlanningIdentityColor, PlanningIdentityIcon } from '../shared/planningIdentity.js';
 import type { UiNotice } from '../utils/uiNotice';
 import type { TaskAssigneeOption } from '../utils/assignees';
+import { type WorkspaceModuleId } from './workspace/workspaceLocalState';
 export interface UseTaskforceProps {
     config?: Partial<TaskforceConfig>;
     initialTaskId?: string;
+    initialActivityEntryId?: string;
+    requestedWorkspaceId?: string;
     onTaskCountChange?: (count: number) => void;
     onClose?: () => void;
 }
@@ -48,7 +51,6 @@ type SetupStateStatus = 'present' | 'missing' | 'unreadable';
 type WorkspaceMode = 'core' | 'operations';
 type BootstrapPhase = 'idle' | 'auth' | 'workspace' | 'config' | 'ready' | 'stalled';
 type TaskScope = 'open' | 'archived' | 'deleted';
-type WorkspaceModuleId = 'tasks' | 'docs' | 'annotate' | 'workflows' | 'agents';
 interface SetupStateSnapshot {
     globalSetupState: SetupStateStatus;
     workspaceSetupState: SetupStateStatus;
@@ -102,7 +104,8 @@ interface WorkspaceSummary {
     status: string;
     betaAccess: boolean;
 }
-export declare function useTaskforce({ config, initialTaskId, onTaskCountChange, onClose }: UseTaskforceProps): {
+export declare function sanitizePlanningBootstrapPayload(input: unknown): PlanningBootstrapPayload;
+export declare function useTaskforce({ config, initialTaskId, initialActivityEntryId, requestedWorkspaceId, onTaskCountChange, onClose }: UseTaskforceProps): {
     config: {
         cloudEnvironment: any;
         apiBaseUrl: string | undefined;
@@ -123,12 +126,6 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
             color?: string;
             icon?: string;
         }>;
-        approaches: Array<{
-            value: string;
-            label: string;
-            color?: string;
-            icon?: string;
-        }>;
         taxonomies: TaxonomyDefinition[];
         apiEndpoint: string;
         cloudMcpBaseUrl?: string;
@@ -164,8 +161,8 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     setManualComplexityEnabled: Dispatch<SetStateAction<boolean>>;
     mcpHostRoot: string;
     setMcpHostRoot: Dispatch<SetStateAction<string>>;
-    settingsSection: "mcp" | "categories" | "types" | "general" | "agents" | "taxonomy" | "documents" | "appearance-application" | "appearance-task-cards" | "appearance-task-forms" | "commands" | "workflow-editor" | "integrations" | "resources" | null;
-    setSettingsSection: Dispatch<SetStateAction<"mcp" | "categories" | "types" | "general" | "agents" | "taxonomy" | "documents" | "appearance-application" | "appearance-task-cards" | "appearance-task-forms" | "commands" | "workflow-editor" | "integrations" | "resources" | null>>;
+    settingsSection: "mcp" | "categories" | "types" | "general" | "agents" | "taxonomy" | "documents" | "appearance-application" | "appearance-task-cards" | "appearance-task-forms" | "integrations" | null;
+    setSettingsSection: Dispatch<SetStateAction<"mcp" | "categories" | "types" | "general" | "agents" | "taxonomy" | "documents" | "appearance-application" | "appearance-task-cards" | "appearance-task-forms" | "integrations" | null>>;
     runtimeMode: "local" | "cloud";
     workspaceMode: "single-local" | "multi-cloud";
     workspaceSwitchingEnabled: boolean;
@@ -192,6 +189,12 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     workspaceSyncRecommendedAction: string;
     workspaceSyncBusy: boolean;
     workspaceSyncPendingChanges: number;
+    localCoordinatorStatus: {
+        phase: import("./sync/useLocalSyncCoordinatorSnapshot").LocalSyncCoordinatorSnapshotPhase;
+        snapshot: import("../sync/coordinator/localSyncCoordinatorBrowserClient").LocalSyncCoordinatorStatusResponse | null;
+        errorMessage: string | null;
+    } | null;
+    transferLocalCoordinatorOwnership: (targetMode: "server" | "browser-gateway") => Promise<boolean>;
     retryUserGlobalSettingsSync: () => Promise<void>;
     retryWorkspaceCloudSync: () => Promise<boolean>;
     resetWorkspaceSyncCursorAndPull: () => Promise<void>;
@@ -226,9 +229,16 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         documentReviewSessionSnapshotFingerprint: string;
         annotatedAttachmentSessionSnapshotCount: number;
         annotatedAttachmentSessionSnapshotFingerprint: string;
+        taskforceAgentSnapshotCount: number;
+        taskforceAgentSnapshotFingerprint: string;
         lastPushedAiProfileCount: number;
         lastPushedAiProfileWatermarkCount: number;
+        lastPushedTaskforceAgentCount: number;
+        lastPushedTaskforceAgentWatermarkCount: number;
+        lastPushedAgentConversationCount: number;
+        lastPushedAgentConversationWatermarkCount: number;
         forceFullAiProfilePushQueued: boolean;
+        durableOutbox: import("../sync/v3/localOutboxDrainClient").WorkspaceSyncV3LocalOutboxStatus | null;
     };
     hasBetaAccess: boolean;
     realtimeSyncEnabled: boolean;
@@ -330,6 +340,11 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         error?: string;
         code?: string;
     }>;
+    changePassword: (currentPassword: string, newPassword: string) => Promise<{
+        success: boolean;
+        error?: string;
+        code?: string;
+    }>;
     beginOAuthLink: (provider: string, returnTo?: string) => void;
     registerWithCredentials: (email: string, password: string, options?: {
         displayName?: string | null;
@@ -431,8 +446,8 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         type: "category";
         value: string;
     } | null>>;
-    groupBy: "category" | "type" | "priority" | "status" | "complexity" | "approach" | "assignee" | "schedule";
-    setGroupBy: Dispatch<SetStateAction<"category" | "type" | "priority" | "status" | "complexity" | "approach" | "assignee" | "schedule">>;
+    groupBy: "category" | "type" | "priority" | "status" | "complexity" | "assignee" | "schedule";
+    setGroupBy: Dispatch<SetStateAction<"category" | "type" | "priority" | "status" | "complexity" | "assignee" | "schedule">>;
     activeWorkspaceModule: WorkspaceModuleId;
     setActiveWorkspaceModule: Dispatch<SetStateAction<WorkspaceModuleId>>;
     emptyColumnMode: "show" | "collapse" | "hide";
@@ -445,9 +460,12 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     tasks: TaskItem[];
     loadingTasks: boolean;
     archivedTasks: TaskItem[];
+    archiveHydratedWorkspaceId: string | null;
     initiatives: InitiativeItem[];
     workstreams: WorkstreamItem[];
     planningBootstrapTaskSummaries: PlanningBootstrapWorkstreamTaskSummary[];
+    planningLoadState: PlanningLoadState;
+    workspaceTaskRelationships: import("../core/Taskforce").TaskRelationshipRecord[];
     deletedTasks: DeletedTaskRecord[];
     activeCategories: CategoryConfig[];
     activeTypes: {
@@ -465,12 +483,6 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         icon?: string;
     }[];
     taxonomyDisplayLabels: FirstClassTaxonomyDisplayLabels;
-    approaches: {
-        value: string;
-        label: string;
-        color?: string;
-        icon?: string;
-    }[];
     taxonomies: TaxonomyDefinition[];
     searchQuery: string;
     setSearchQuery: Dispatch<SetStateAction<string>>;
@@ -496,6 +508,8 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     setShowArchive: Dispatch<SetStateAction<boolean>>;
     taskScope: TaskScope;
     setTaskScope: Dispatch<SetStateAction<TaskScope>>;
+    compressedCards: boolean;
+    setCompressedCards: Dispatch<SetStateAction<boolean>>;
     clearFilters: () => void;
     filteredTasks: TaskItem[];
     searchAgnosticTasks: TaskItem[];
@@ -505,28 +519,38 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     setCollapsedCategories: Dispatch<SetStateAction<Record<string, boolean>>>;
     fetchTasks: (isSilent?: boolean, options?: {
         ignoreAuthGuard?: boolean;
+        highlightChangedTaskIds?: readonly string[];
     }) => Promise<void>;
     fetchArchive: (isSilent?: boolean, options?: {
         ignoreAuthGuard?: boolean;
-    }) => Promise<void>;
+    }) => Promise<boolean>;
+    ensureArchiveHydrated: (isSilent?: boolean, options?: {
+        ignoreAuthGuard?: boolean;
+    }) => Promise<boolean>;
     fetchDeletedTasks: (isSilent?: boolean, options?: {
         ignoreAuthGuard?: boolean;
-    }) => Promise<void>;
+    }) => Promise<boolean>;
     fetchPlanningEntities: (options?: {
         ignoreAuthGuard?: boolean;
     }) => Promise<void>;
+    fetchPlanningEntityDetail: (entityType: "initiative" | "workstream", id: string) => Promise<InitiativeItem | WorkstreamItem>;
     fetchAssigneeOptions: () => Promise<{
         success: boolean;
         error?: string;
     }>;
     createInitiative: (payload: Partial<InitiativeItem>) => Promise<InitiativeItem>;
     updateInitiative: (id: string, payload: Partial<InitiativeItem>) => Promise<InitiativeItem>;
+    updatePlanningIdentity: (entityType: "initiative" | "workstream", id: string, patch: {
+        icon?: PlanningIdentityIcon | null;
+        color?: PlanningIdentityColor | null;
+    }) => Promise<InitiativeItem | WorkstreamItem>;
     archiveInitiative: (id: string) => Promise<InitiativeItem>;
     unarchiveInitiative: (id: string) => Promise<InitiativeItem>;
     createWorkstream: (payload: Partial<WorkstreamItem>) => Promise<WorkstreamItem>;
     updateWorkstream: (id: string, payload: Partial<WorkstreamItem>) => Promise<WorkstreamItem>;
     archiveWorkstream: (id: string) => Promise<WorkstreamItem>;
     unarchiveWorkstream: (id: string) => Promise<WorkstreamItem>;
+    reorderWorkstreamTasks: (workstreamId: string, taskIds: string[]) => Promise<void>;
     handleEdit: (task: TaskItem, options?: {
         preserveReturnTrail?: boolean;
     }) => void;
@@ -538,20 +562,28 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     handleToggleCancel: (task: TaskItem) => Promise<void>;
     handleToggleInProgress: (task: TaskItem) => Promise<void>;
     handleToggleReview: (task: TaskItem) => Promise<void>;
-    handleArchiveTask: (task: TaskItem) => Promise<void>;
+    handleArchiveTask: (task: TaskItem) => Promise<boolean>;
     handleBulkArchive: () => Promise<void>;
     handleUnarchive: (id: string) => Promise<void>;
-    handleRestoreDeletedTask: (id: string) => Promise<TaskItem | null>;
+    handleRestoreDeletedTask: (id: string, expectedTaskId?: string, options?: {
+        silent?: boolean;
+        restoreDestination?: import("../shared/taskRestoreDestination").TaskRestoreDestination;
+    }) => Promise<TaskItem | null>;
+    handleRestoreSelectedDeletedTasks: (records: DeletedTaskRecord[], restoreDestination?: import("../shared/taskRestoreDestination").TaskRestoreDestination, onProgress?: (result: import("./useTaskMutations").DeletedTaskRestoreBatchResult) => void) => Promise<import("./useTaskMutations").DeletedTaskRestoreBatchResult>;
     handlePermanentlyDeleteDeletedTask: (id: string) => Promise<boolean>;
     handleEmptyDeletedTasks: () => Promise<number | null>;
-    handleUpdateTask: (id: string, updates: Partial<TaskItem>) => Promise<void>;
+    handleUpdateTask: (id: string, updates: Partial<TaskItem>) => Promise<boolean | undefined>;
+    handleSetStatus: (task: TaskItem, status: import("../core/TaskDurableStatusMutationService").DurableTaskTargetStatus, updates?: Partial<TaskItem>) => Promise<void>;
     editingTaskId: string | null;
     loading: boolean;
     error: string;
+    clearTaskError: () => void;
     title: string;
     setTitle: Dispatch<SetStateAction<string>>;
+    setTitleDraft: (value: string) => void;
     description: string;
     setDescription: Dispatch<SetStateAction<string>>;
+    setDescriptionDraft: (value: string) => void;
     checklistItems: ChecklistItem[];
     setChecklistItems: Dispatch<SetStateAction<ChecklistItem[]>>;
     category: string;
@@ -564,8 +596,6 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     setComplexity: Dispatch<SetStateAction<string | number>>;
     status: TaskStatus;
     setStatus: Dispatch<SetStateAction<TaskStatus>>;
-    approach: string;
-    setApproach: Dispatch<SetStateAction<string>>;
     assignee: string;
     setAssignee: Dispatch<SetStateAction<string>>;
     scheduledDate: string;
@@ -583,18 +613,18 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     setAttachments: Dispatch<SetStateAction<(string | AttachmentItem)[]>>;
     attachmentsDirty: boolean;
     setAttachmentsDirty: Dispatch<SetStateAction<boolean>>;
+    descriptionImageUploadPending: boolean;
+    descriptionImageDraftId: string;
+    registerDescriptionImageUpload: (upload: Promise<void>) => void;
     descriptionFocused: boolean;
     setDescriptionFocused: Dispatch<SetStateAction<boolean>>;
     showMarkdownHelp: boolean;
     setShowMarkdownHelp: Dispatch<SetStateAction<boolean>>;
-    showChecklist: boolean;
-    setShowChecklist: Dispatch<SetStateAction<boolean>>;
-    showComments: boolean;
-    setShowComments: Dispatch<SetStateAction<boolean>>;
     isCapturingScreenshot: boolean;
     setIsCapturingScreenshot: Dispatch<SetStateAction<boolean>>;
     handleSubmit: (event: React.FormEvent) => Promise<void>;
     resetForm: () => void;
+    discardDescriptionImageDraft: () => Promise<void>;
     handleAddComment: (text: string) => Promise<void>;
     handleSetWorkstreamForCurrentTask: (workstreamIdOverride?: string | null) => Promise<void>;
     handleOpenTaskById: (taskId: string) => void;
@@ -603,10 +633,14 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     unsavedModalOpen: boolean;
     setUnsavedModalOpen: Dispatch<SetStateAction<boolean>>;
     pendingNavigation: (() => void) | null;
-    handleNavigation: (action: () => void) => void;
+    handleNavigation: (action: () => void) => Promise<void>;
     handleClose: () => void;
     uiNotice: UiNotice | null;
-    pushNotice: (message: string, tone?: UiNotice["tone"], ttlMs?: number) => void;
+    pushNotice: (message: string, tone?: UiNotice["tone"], ttlMs?: number, action?: {
+        label: string;
+        onAction: () => void;
+        ownerKey?: string;
+    }) => void;
     clearNotice: () => void;
     successBanner: {
         message: string;
@@ -624,15 +658,13 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     cancelScheduleWarning: () => void;
     tasksScrollRef: import("react").RefObject<HTMLDivElement | null>;
     setTasksScrollPos: Dispatch<SetStateAction<number>>;
-    exportEnvironment: string;
-    setExportEnvironment: Dispatch<SetStateAction<string>>;
-    exportWorkflowsPath: string;
-    setExportWorkflowsPath: Dispatch<SetStateAction<string>>;
-    exportResult: {
-        type: "success" | "error";
-        message: string;
-    } | null;
-    exportingResource: "workflows" | null;
+    taskforceAgentId: string;
+    setTaskforceAgentId: Dispatch<SetStateAction<string>>;
+    taskforceAgentConversationId: string;
+    setTaskforceAgentConversationId: Dispatch<SetStateAction<string>>;
+    taskforceAgentConversationByAgentId: Record<string, string>;
+    setTaskforceAgentConversationByAgentId: Dispatch<SetStateAction<Record<string, string>>>;
+    uiStateReady: boolean;
     handleUpdateCategory: (updatedCat: CategoryConfig, oldLabel?: string) => Promise<void>;
     handleRemoveCategory: (catValue: string) => Promise<void>;
     handleSaveCategory: (newCategoryName: string) => Promise<void>;
@@ -671,10 +703,7 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     currentTask: TaskItem | undefined;
     currentTaskWorkstream: WorkstreamItem | undefined;
     currentTaskInitiative: InitiativeItem | undefined;
-    availableWorkflows: string[];
-    initiativeTemplates: import("./ui/useWorkflowTemplates").InitiativeTemplate[];
-    availableEnvironments: Environment[];
-    fetchWorkflows: () => Promise<void>;
+    initiativeTemplates: import("./ui/useInitiativeTemplates").InitiativeTemplate[];
     fetchInitiativeTemplates: () => Promise<any>;
     createInitiativeFromTemplate: (payload: {
         templateId: string;
@@ -683,25 +712,15 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         category?: string;
         type?: string;
         priority?: number;
-        approach?: string;
     }) => Promise<{
         success: boolean;
         error?: string;
         result?: any;
     }>;
-    fetchWorkflowTemplate: (name: string) => Promise<any>;
-    fetchWorkflowOverrideNames: () => Promise<string[]>;
-    saveWorkflowTemplateDraft: (name: string, draft: any) => Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-    resetWorkflowTemplateDraft: (name: string) => Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-    onExportWorkflows: (environment: string, selected: string[]) => Promise<void>;
     settingsModel: {
         fetchCloudAuthApi: (path: string, init?: RequestInit) => Promise<Response>;
+        checkLocalMcpCliHealth: () => Promise<import("../mcp/localCliHealth").LocalCliHealthResult>;
+        getLocalUpdateStatus: () => Promise<import("../update/uiUpdateService").UiUpdateOverview>;
         currentTheme: any;
         configLoaded: boolean;
         globalTheme: any;
@@ -716,12 +735,8 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         manualComplexityEnabled: boolean;
         checklistDropdownEnabled: boolean;
         showTaskCardStatusLabel: boolean;
-        exportWorkflowsPath: string;
-        exportingResource: any;
-        exportResult: any;
         pathSaved: boolean;
-        initialSection: "mcp" | "categories" | "types" | "priorities" | "general" | "agents" | "taxonomy" | "initiatives" | "documents" | "appearance-application" | "appearance-task-cards" | "appearance-task-forms" | "commands" | "workflow-editor" | "integrations" | "resources" | null;
-        exportEnvironment: string;
+        initialSection: "mcp" | "categories" | "types" | "priorities" | "general" | "agents" | "taxonomy" | "initiatives" | "documents" | "appearance-application" | "appearance-task-cards" | "appearance-task-forms" | "integrations" | null;
         setupState: any;
         buildInfo: any;
         onSaveSetupMode: (...args: any[]) => any;
@@ -739,19 +754,9 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         onShowTaskCardStatusLabelChange: (...args: any[]) => any;
         onResetProjectToGlobal: (...args: any[]) => any;
         onSaveSettings: (...args: any[]) => any;
-        onExportWorkflowsPathChange: (value: string) => void;
-        onExportEnvironmentChange: (value: string) => void;
-        availableWorkflows: any[];
         initiativeTemplates: any[];
-        availableEnvironments: any[];
-        onRefreshWorkflows: (...args: any[]) => any;
         onRefreshInitiativeTemplates: (...args: any[]) => any;
         onCreateInitiativeFromTemplate: (...args: any[]) => any;
-        onFetchWorkflowTemplate: (...args: any[]) => any;
-        onFetchWorkflowOverrideNames: (...args: any[]) => any;
-        onSaveWorkflowTemplateDraft: (...args: any[]) => any;
-        onResetWorkflowTemplateDraft: (...args: any[]) => any;
-        onExportWorkflows: (...args: any[]) => any;
         onShowFolderBrowserChange: (value: boolean) => void;
         onBrowserTargetChange: (value: any) => void;
         onFetchFolders: (...args: any[]) => any;