@taskforcehq/taskforce 0.3.328 → 0.3.330

package/dist/mcp/planningAttachmentCommandAdapter.d.ts

@@ -65,7 +65,9 @@ export interface PlanningAttachmentCommandAdapterDependencies {
     activeWorkspaceId: string;
     runtimeMode: 'local' | 'cloud';
     resolveTarget(targetType: PlanningAttachmentTargetType, inputId: unknown): PlanningAttachmentTarget;
-    updateTarget(targetType: PlanningAttachmentTargetType, targetId: string, attachments: Array<string | TaskAttachmentRecord>): unknown;
+    updateTarget(targetType: PlanningAttachmentTargetType, targetId: string, attachments: Array<string | TaskAttachmentRecord>): {
+        attachments?: Array<string | TaskAttachmentRecord> | null;
+    } | null | undefined;
     getPaths(): {
         projectRoot: string;
         basePath: string;

package/dist/mcp/planningAttachmentCommandAdapter.js

@@ -11,9 +11,23 @@ export class PlanningAttachmentCommandError extends Error {
     }
 }
 const attachmentsFor = (target) => (Array.isArray(target.entity.attachments) ? target.entity.attachments : []);
+const matchesSavedAttachment = (candidate, expected) => {
+    if (typeof candidate === 'string') {
+        return candidate === expected.path || candidate === expected.fsPath;
+    }
+    if (expected.assetId && candidate.assetId === expected.assetId)
+        return true;
+    return candidate.path === expected.path || (Boolean(expected.fsPath) && candidate.fsPath === expected.fsPath);
+};
 export function createPlanningAttachmentCommandAdapter(deps) {
     const now = () => (deps.now ? deps.now() : new Date());
     const createError = (message, code, statusCode) => (deps.createError(message, code, statusCode));
+    const assertSavedAttachmentMembership = (updated, targetType, attachment) => {
+        const persistedAttachments = Array.isArray(updated?.attachments) ? updated.attachments : [];
+        if (persistedAttachments.some((item) => matchesSavedAttachment(item, attachment)))
+            return;
+        throw createError(`Attachment content was saved as ${attachment.referenceLabel || attachment.assetId || attachment.fsPath || attachment.path}, but ${targetType} membership was not confirmed. Retry save_${targetType}_attachment with the same filename, or call link_document for the saved document when that tool is available; do not treat this save as complete.`, 'MCP_ATTACHMENT_LINK_NOT_CONFIRMED', 409);
+    };
     const save = async (targetType, input) => {
         const { id: inputId, filename, content, sourcePath, caption, overwrite = false } = input;
         const target = deps.resolveTarget(targetType, inputId);
@@ -119,7 +133,8 @@ export function createPlanningAttachmentCommandAdapter(deps) {
             timestamp,
         };
         if (overwriteTarget) {
-            deps.updateTarget(targetType, target.id, existing.map((item, index) => (index === overwriteTarget.index ? attachment : item)));
+            const updated = deps.updateTarget(targetType, target.id, existing.map((item, index) => (index === overwriteTarget.index ? attachment : item)));
+            assertSavedAttachmentMembership(updated, targetType, attachment);
             return {
                 targetType,
                 targetId: target.id,
@@ -139,7 +154,10 @@ export function createPlanningAttachmentCommandAdapter(deps) {
         if (duplicate) {
             return { targetType, targetId: target.id, target, attachment, status: 'already-attached' };
         }
-        deps.updateTarget(targetType, target.id, [...existing, attachment]);
+        const updated = deps.updateTarget(targetType, target.id, [...existing, attachment]);
+        // A pending local-outbox result proves durable local capture only. Cloud convergence is
+        // established later by normal dispatch; this postcondition must not claim otherwise.
+        assertSavedAttachmentMembership(updated, targetType, attachment);
         return { targetType, targetId: target.id, target, attachment, status: 'attached' };
     };
     const deleteAttachment = async (targetType, input) => {

package/dist/mcp/runtime.d.ts

@@ -1,5 +1,5 @@
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { Server, type CallToolResult, type Tool } from '@modelcontextprotocol/server';
+import { StdioServerTransport } from '@modelcontextprotocol/server/stdio';
 import { McpAccessTokenScope, TaskforceCore } from '../core/Taskforce.js';
 import { type AiProfileBootstrapConfig } from './aiProfileBootstrap.js';
 import { type AiProfileSeatScope } from '../shared/aiProfileSeatScope.js';
@@ -29,6 +29,8 @@ export type McpToolCallTiming = {
     subphases: Record<string, number>;
 };
 export interface TaskforceMcpServerOptions {
+    protocolEra?: 'legacy' | 'modern';
+    resourceSubscriptionMode?: 'disabled' | 'legacy-long-lived';
     projectRoot?: string;
     tenantId?: string;
     workspaceId?: string;
@@ -41,15 +43,8 @@ export interface TaskforceMcpServerOptions {
     localDataOwnerPermit?: LocalDataOwnerPermit;
     toolProfile?: McpToolProfile;
     onAiProfileBound?: (profileId: string) => void;
-    onOperationAccepted?: (operation: {
-        operationId: string;
-        mutationKind: string;
-        payloadFingerprint: string;
-    }) => void;
     onToolCallTiming?: (timing: McpToolCallTiming) => void;
     operationIdentityScope?: {
-        generation: string;
-        sessionId: string;
         connectionInstance: string;
     } | null;
     avatarImageProvider?: AvatarImageProvider;
@@ -137,91 +132,71 @@ export declare function buildBatchToolError(error: unknown, fallbackStatusCode:
     message: string;
     statusCode: number;
 };
-export declare function createTaskforceMcpServer(options?: TaskforceMcpServerOptions): {
-    server: Server<{
-        method: string;
-        params?: {
-            [x: string]: unknown;
-            _meta?: {
-                [x: string]: unknown;
-                progressToken?: string | number | undefined;
-                "io.modelcontextprotocol/related-task"?: {
-                    taskId: string;
-                } | undefined;
-            } | undefined;
-        } | undefined;
-    }, {
-        method: string;
-        params?: {
-            [x: string]: unknown;
-            _meta?: {
-                [x: string]: unknown;
-                progressToken?: string | number | undefined;
-                "io.modelcontextprotocol/related-task"?: {
-                    taskId: string;
-                } | undefined;
-            } | undefined;
-        } | undefined;
-    }, {
-        [x: string]: unknown;
-        _meta?: {
-            [x: string]: unknown;
-            progressToken?: string | number | undefined;
-            "io.modelcontextprotocol/related-task"?: {
-                taskId: string;
-            } | undefined;
-        } | undefined;
+export type McpRuntimeFactory = (options: TaskforceMcpServerOptions) => Pick<ReturnType<typeof createTaskforceMcpServer>, 'server'>;
+export declare function createStatelessTaskforceMcpServer(options?: TaskforceMcpServerOptions, factory?: McpRuntimeFactory): Pick<{
+    server: Server;
+    core: TaskforceCore;
+    projectRoot: string;
+    projectName: string;
+    workspaceId: string;
+    tenantId: string;
+    version: string;
+    toolProfile: "default" | "extended" | "full";
+    listTools: () => Promise<{
+        tools: Tool[];
     }>;
+    callTool: (params: {
+        name: string;
+        arguments?: Record<string, unknown>;
+    }, context?: {
+        requestId?: string | number;
+        sessionId?: string;
+    }) => Promise<CallToolResult>;
+}, "server">;
+export declare function createTaskforceMcpServer(options?: TaskforceMcpServerOptions): {
+    server: Server;
     core: TaskforceCore;
     projectRoot: string;
     projectName: string;
     workspaceId: string;
     tenantId: string;
     version: string;
-    toolProfile: "default" | "full" | "extended";
+    toolProfile: "default" | "extended" | "full";
+    listTools: () => Promise<{
+        tools: Tool[];
+    }>;
+    callTool: (params: {
+        name: string;
+        arguments?: Record<string, unknown>;
+    }, context?: {
+        requestId?: string | number;
+        sessionId?: string;
+    }) => Promise<CallToolResult>;
 };
+export declare function connectMcpRuntimeToStdio(runtime: ReturnType<McpRuntimeFactory>, transport?: StdioServerTransport): Promise<{
+    transport: StdioServerTransport;
+    close: () => Promise<void>;
+    server: Server;
+}>;
 export declare function startTaskforceMcpStdioServer(options?: TaskforceMcpServerOptions): Promise<{
     transport: StdioServerTransport;
     close: () => Promise<void>;
-    server: Server<{
-        method: string;
-        params?: {
-            [x: string]: unknown;
-            _meta?: {
-                [x: string]: unknown;
-                progressToken?: string | number | undefined;
-                "io.modelcontextprotocol/related-task"?: {
-                    taskId: string;
-                } | undefined;
-            } | undefined;
-        } | undefined;
-    }, {
-        method: string;
-        params?: {
-            [x: string]: unknown;
-            _meta?: {
-                [x: string]: unknown;
-                progressToken?: string | number | undefined;
-                "io.modelcontextprotocol/related-task"?: {
-                    taskId: string;
-                } | undefined;
-            } | undefined;
-        } | undefined;
-    }, {
-        [x: string]: unknown;
-        _meta?: {
-            [x: string]: unknown;
-            progressToken?: string | number | undefined;
-            "io.modelcontextprotocol/related-task"?: {
-                taskId: string;
-            } | undefined;
-        } | undefined;
-    }>;
+    server: Server;
     core: TaskforceCore;
     projectRoot: string;
     projectName: string;
     workspaceId: string;
     tenantId: string;
     version: string;
-    toolProfile: "default" | "full" | "extended";
+    toolProfile: "default" | "extended" | "full";
+    listTools: () => Promise<{
+        tools: Tool[];
+    }>;
+    callTool: (params: {
+        name: string;
+        arguments?: Record<string, unknown>;
+    }, context?: {
+        requestId?: string | number;
+        sessionId?: string;
+    }) => Promise<CallToolResult>;
 }>;