@taskforcehq/taskforce 0.3.328 → 0.3.330

package/dist/core/Taskforce.d.ts

@@ -5,6 +5,7 @@ import type { DurableTaskStatusMutationPayload } from './TaskDurableStatusMutati
 import { WorkspaceAssetStore } from '../storage/workspaceAssetStore.js';
 import { resolveAdminAuditRetentionPolicy, type AdminAuditRetentionDiagnostics, type AdminAuditRetentionRun } from './AdminAuditRetentionService.js';
 import type { WorkspaceSyncV3TaskAttachmentLink } from '../sync/v3/workspaceSyncV3NestedTaskCodecs.js';
+import { type InternalUserFeatureKey } from '../shared/userFeatureGrants.js';
 import type { TaskRestoreDestination } from '../shared/taskRestoreDestination.js';
 import { type SyncEventInput } from './SyncReconciliationService.js';
 import { type FirstClassTaxonomyDisplayLabels, type NormalizedWorkspaceTaxonomyState, type WorkspaceTaxonomyState } from '../shared/taxonomyState.js';
@@ -95,6 +96,17 @@ export interface AuditActivityItem {
     event: TaskEvent;
 }
 export type TaskActivityItem = CommentActivityItem | AuditActivityItem;
+export type TaskActivitySummaryItem = {
+    id: string;
+    type: 'comment';
+    timestamp: string;
+    comment: Pick<Comment, 'text' | 'author' | 'actor'>;
+} | {
+    id: string;
+    type: 'event';
+    timestamp: string;
+    event: Pick<TaskEvent, 'action' | 'details' | 'actor' | 'actorType' | 'actorProfile'>;
+};
 export interface EntityAuditActivityItem {
     id: string;
     type: 'event';
@@ -153,6 +165,7 @@ export interface TaskItem {
     taskEvents?: TaskEvent[];
     attachments?: AttachmentItem[];
     cardCoverAssetId?: string | null;
+    cardCoverAttachment?: Exclude<AttachmentItem, string> | null;
     /** @deprecated Use status='done'. Safe to remove after v0.4.x migration gate. */
     completed?: boolean;
     /** @deprecated Use status='cancelled'. Safe to remove after v0.4.x migration gate. */
@@ -171,7 +184,27 @@ export interface TaskItem {
     workstreamOrder?: number | null;
     workstreamId?: string | null;
     checklistItems?: ChecklistItem[];
-}
+    /** True when this object came from a collection read and omits the full task graph. */
+    isSummary?: boolean;
+    commentCount?: number;
+    checklistCount?: number;
+    completedChecklistCount?: number;
+    attachmentCount?: number;
+    relationshipCount?: number;
+    /** Compact newest comment or audit event carried by lightweight collection reads. */
+    latestActivity?: TaskActivitySummaryItem | null;
+    detailRevision?: string;
+}
+export type TaskSummary = Omit<TaskItem, 'description' | 'comments' | 'activity' | 'taskEvents' | 'attachments' | 'checklistItems'> & {
+    isSummary: true;
+    commentCount: number;
+    checklistCount: number;
+    completedChecklistCount: number;
+    attachmentCount: number;
+    relationshipCount: number;
+    latestActivity: TaskActivitySummaryItem | null;
+    detailRevision: string;
+};
 export type AttachmentItem = string | {
     path: string;
     fsPath?: string;
@@ -351,12 +384,23 @@ export interface TaskFile {
         manualComplexityEnabled?: boolean;
         checklistDropdownEnabled?: boolean;
         showTaskCardStatusLabel?: boolean;
+        showTaskCardDescription?: boolean;
+        showTaskCardAttachments?: boolean;
+        showTaskCardChecklistProgress?: boolean;
+        showTaskCardLatestActivity?: boolean;
+        tintTaskCardActivityBackground?: boolean;
         taxonomies?: any[];
     };
 }
 export interface ArchiveFile {
     archived: TaskItem[];
 }
+export interface TaskSummaryFile {
+    tasks: TaskSummary[];
+}
+export interface ArchiveSummaryFile {
+    archived: TaskSummary[];
+}
 export interface BulkCreateTaskError {
     index: number;
     message: string;
@@ -415,6 +459,7 @@ export type SystemRole = 'system_admin' | 'user';
 type PermissionMode = 'read-only' | 'read-write';
 type AuthTokenPurpose = 'email_verification' | 'password_reset' | 'invite_accept';
 export type McpAccessTokenScope = 'tasks:read' | 'tasks:write' | 'workspace:read';
+export type McpCloudToolProfile = 'default' | 'extended';
 type McpAccessTokenStatus = 'active' | 'revoked' | 'expired';
 export type McpOAuthProvider = 'chatgpt' | 'claude' | 'grok' | 'gemini' | 'mistral' | 'perplexity';
 type McpOAuthClientStatus = 'active' | 'revoked';
@@ -543,6 +588,7 @@ interface SystemUserRecord {
     systemRole: SystemRole;
     betaAccess: boolean;
     disabled: boolean;
+    internalFeatureGrants: InternalUserFeatureKey[];
     planId?: string | null;
     planName?: string | null;
     planVersionId?: string | null;
@@ -565,6 +611,7 @@ export interface PurgedSystemUserSummary {
     deletedMcpOauthConnectorGrantCount: number;
     deletedUiStateCount: number;
     deletedUserPreferenceCount: number;
+    deletedUserFeatureGrantCount: number;
     deletedEntitlementCount: number;
     deletedUserBillingCount: number;
     deletedUserCount: number;
@@ -729,6 +776,7 @@ export interface McpAccessTokenRecord {
     userEmail?: string | null;
     name: string;
     scopes: McpAccessTokenScope[];
+    toolProfile: McpCloudToolProfile;
     tokenPrefix: string;
     status: McpAccessTokenStatus;
     lastUsedAt?: string | null;
@@ -756,6 +804,7 @@ export interface McpAccessTokenAuthResult {
     workspaceId: string;
     userId: string;
     scopes: McpAccessTokenScope[];
+    toolProfile?: McpCloudToolProfile;
     status: McpAccessTokenStatus;
 }
 export interface McpAccessTokenInspectionResult {
@@ -765,6 +814,7 @@ export interface McpAccessTokenInspectionResult {
     userId: string;
     name: string;
     scopes: McpAccessTokenScope[];
+    toolProfile: McpCloudToolProfile;
     status: McpAccessTokenStatus;
 }
 export interface McpOAuthClientRecord {
@@ -786,6 +836,7 @@ export interface McpOAuthConnectorGrantRecord {
     workspaceId: string;
     userId: string;
     scopes: McpAccessTokenScope[];
+    toolProfile: McpCloudToolProfile;
     tokenPrefix: string;
     status: McpOAuthGrantStatus;
     lastUsedAt?: string | null;
@@ -808,6 +859,7 @@ export interface McpOAuthAccessTokenAuthResult {
     provider: McpOAuthProvider;
     productClientId?: string | null;
     scopes: McpAccessTokenScope[];
+    toolProfile?: McpCloudToolProfile;
     status: McpOAuthGrantStatus;
     aiProfileId?: string | null;
     aiProfileToken?: string | null;
@@ -997,6 +1049,7 @@ export interface TaskforceSyncCapable {
         repairLegacyBinding?: boolean;
     }): AiProfileRecord | null;
     resolveWorkspaceActor(workspaceId: string, actorRef: unknown): TaskActor | null;
+    resolveWorkspaceActors(workspaceId: string, actorRefs: unknown[]): Map<string, TaskActor | null>;
 }
 export type TaskRelationshipInputType = 'depends_on' | 'blocks' | 'related_to' | 'supersedes';
 export type TaskRelationshipKind = 'dependency' | 'related' | 'supersedes';
@@ -1146,6 +1199,7 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
         requireDispatchReady?: boolean;
         adoptAuthoritativeReferenceNumber?: boolean;
         ignoreAssetMetadataSnapshots?: boolean;
+        restoreDeletedExternalAssetForAuthoritativeSync?: boolean;
     }): AttachmentItem[];
     private normalizeEntitlementState;
     private upsertCanonicalEntitlementRecord;
@@ -1445,6 +1499,16 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
     private getSyncReconciliationServiceDeps;
     private getWorkspaceLifecycleServiceDeps;
     listTasks(workspaceId?: string): TaskFile;
+    private listTaskSummaries;
+    listActiveTaskSummaries(workspaceId?: string): TaskSummaryFile;
+    listArchiveSummaries(workspaceId?: string): ArchiveSummaryFile;
+    getTaskDetailRevision(id: string, workspaceId?: string): string | null;
+    getTaskDetailSnapshot(id: string, workspaceId?: string): TaskItem | null;
+    updateTaskIfDetailRevisionMatches(id: string, expectedDetailRevision: string, updates: Partial<TaskItem>, workspaceId?: string, options?: {
+        actorRef?: string;
+        saveSource?: 'manual' | 'autosave';
+    }): TaskItem | null;
+    assertTaskDetailRevisionForUpdate(id: string, expectedDetailRevision: string, workspaceId?: string): void;
     /**
      * Filter-pushdown listing used by read-only surfaces that don't need the
      * full task graph (MCP list_tasks, CLI summaries). Avoids the per-task
@@ -1480,7 +1544,10 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
         title: string;
         status: TaskStatus;
     }>;
-    searchTaskSummaries(query: string, scope?: 'all' | 'active' | 'archive', workspaceId?: string): Array<Record<string, unknown>>;
+    searchTaskSummaries(query: string, scope?: 'all' | 'active' | 'archive', workspaceId?: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Array<Record<string, unknown>>;
     getDataVersion(): number;
     getDatabaseProvider(): DatabaseProvider;
     isDatabaseHealthy(): boolean;
@@ -1575,6 +1642,9 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
     setSystemRole(userId: string, role: SystemRole): boolean;
     setUserDisabledGlobal(userId: string, disabled: boolean): boolean;
     setUserBetaAccessGlobal(userId: string, enabled: boolean): boolean;
+    hasUserFeatureGrant(userId: string, featureKey: unknown): boolean;
+    listUserFeatureGrants(userId: string): InternalUserFeatureKey[];
+    setUserFeatureGrant(userId: string, featureKey: unknown, enabled: boolean, updatedBy?: string | null): boolean;
     markUserEmailVerified(userId: string): {
         emailVerifiedAt: string;
     } | null;
@@ -1805,7 +1875,9 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
         sessionId: string;
     }): boolean;
     private getAiProfileServiceDeps;
+    private buildUnresolvedWorkspaceActor;
     resolveWorkspaceActor(workspaceId: string, actorRef: unknown): TaskActor | null;
+    resolveWorkspaceActors(workspaceId: string, actorRefs: unknown[]): Map<string, TaskActor | null>;
     listAssignableActors(workspaceId: string): TaskActor[];
     addAdminAuditLog(input: {
         action: string;
@@ -2148,6 +2220,15 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
         tokenId: string;
         createdByIp?: string | null;
     }): McpAccessTokenIssueResult;
+    updateMcpAccessTokenToolProfile(input: {
+        actorUserId: string;
+        workspaceId: string;
+        tokenId: string;
+        toolProfile: unknown;
+    }): {
+        record: McpAccessTokenRecord;
+        previousToolProfile: McpCloudToolProfile;
+    };
     authenticateMcpAccessToken(token: string, workspaceId?: string): McpAccessTokenAuthResult | null;
     inspectMcpAccessToken(token: string): McpAccessTokenInspectionResult | null;
     recordMcpAccessTokenUsage(input: {
@@ -2193,6 +2274,15 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
         workspaceId: string;
         grantId: string;
     }): McpOAuthConnectorGrantRecord;
+    updateMcpOAuthConnectorGrantToolProfile(input: {
+        actorUserId: string;
+        workspaceId: string;
+        grantId: string;
+        toolProfile: unknown;
+    }): {
+        record: McpOAuthConnectorGrantRecord;
+        previousToolProfile: McpCloudToolProfile;
+    };
     authenticateMcpOAuthAccessToken(token: string, workspaceId?: string): McpOAuthAccessTokenAuthResult | null;
     bindMcpOAuthConnectorGrantAiProfile(input: {
         grantId: string;
@@ -2407,8 +2497,10 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
     notifyDurableTaskMetadataCommitted(workspaceId: string, taskId: string): void;
     addComment(id: string, text: string, author: string, workspaceId?: string, options?: {
         persistBackup?: boolean;
+        emitRealtime?: boolean;
         actorRef?: string;
         skipTaskEvents?: boolean;
+        commentId?: string;
     }): TaskItem | null;
     private addPlanningEntityComment;
     addInitiativeComment(id: string, text: string, author: string, workspaceId?: string, options?: {