@taskforcehq/taskforce 0.3.323 → 0.3.326

package/dist/mcp/documentAssetRegistrar.js

@@ -31,44 +31,27 @@ export function registerDocumentAssetTools(registerTool, executeTool) {
         });
     };
     register('get_task_attachments', (context) => ({
-        description: context.describeTool('List attachment descriptors for one task. This returns metadata only; use read_task_attachment for file contents. For canonical documents, prefer get_document and read_document_content for the document-focused workflow.'),
+        description: context.describeTool('List attachment descriptors for one task. Pass attachmentId when you need one attachment body or download reference. For canonical documents, prefer get_document with includeContent=true for the document-focused workflow.'),
         inputSchema: {
             properties: {
                 taskId: stringProperty('Task ID or task reference such as T-123.'),
                 id: stringProperty('Alias for taskId. Task ID or task reference such as T-123.'),
-            },
-        },
-    }));
-    register('read_task_attachment', (context) => ({
-        description: context.describeTool('Read one task attachment by attachmentId. Prefer this tool over opening attachment path URLs directly. For a canonical document attachment, this response also points toward the document-specific workflow.'),
-        inputSchema: {
-            properties: {
-                taskId: stringProperty('Task ID or task reference such as T-123.'),
-                attachmentId: stringProperty('Attachment descriptor id from get_task_attachments.'),
+                attachmentId: stringProperty('Optional attachment descriptor id to include content for one attachment.'),
+                format: stringProperty('Optional read format when attachmentId is provided. Use metadata for descriptors or download for a download URL.', ['text', 'metadata', 'download']),
                 maxChars: numberProperty('Optional max inline character count for readable text attachments.'),
             },
-            required: ['taskId', 'attachmentId'],
         },
     }));
     register('get_workstream_attachments', (context) => ({
-        description: context.describeTool('List attachment descriptors for one workstream. This returns metadata only; use read_workstream_attachment for file contents.'),
+        description: context.describeTool('List attachment descriptors for one workstream. Pass attachmentId when you need one attachment body or download reference.'),
         inputSchema: {
             properties: {
                 id: stringProperty('Workstream ID or workstream reference such as WS-123.'),
-            },
-            required: ['id'],
-        },
-    }));
-    register('read_workstream_attachment', (context) => ({
-        description: context.describeTool('Read one workstream attachment by attachmentId. Prefer this tool over opening attachment path URLs directly.'),
-        inputSchema: {
-            properties: {
-                workstreamId: stringProperty('Workstream ID or workstream reference such as WS-123.'),
-                attachmentId: stringProperty('Attachment descriptor id from get_workstream_attachments.'),
-                format: stringProperty('Read format. Use metadata for descriptors or download for a download URL.', ['text', 'metadata', 'download']),
+                attachmentId: stringProperty('Optional attachment descriptor id to include content for one attachment.'),
+                format: stringProperty('Optional read format when attachmentId is provided. Use metadata for descriptors or download for a download URL.', ['text', 'metadata', 'download']),
                 maxChars: numberProperty('Optional max inline character count for readable text attachments.'),
             },
-            required: ['workstreamId', 'attachmentId'],
+            required: ['id'],
         },
     }));
     register('save_workstream_attachment', (context) => ({
@@ -96,24 +79,15 @@ export function registerDocumentAssetTools(registerTool, executeTool) {
         },
     }));
     register('get_initiative_attachments', (context) => ({
-        description: context.describeTool('List attachment descriptors for one initiative. This returns metadata only; use read_initiative_attachment for file contents.'),
+        description: context.describeTool('List attachment descriptors for one initiative. Pass attachmentId when you need one attachment body or download reference.'),
         inputSchema: {
             properties: {
                 id: stringProperty('Initiative ID or initiative reference such as IN-123.'),
-            },
-            required: ['id'],
-        },
-    }));
-    register('read_initiative_attachment', (context) => ({
-        description: context.describeTool('Read one initiative attachment by attachmentId. Prefer this tool over opening attachment path URLs directly.'),
-        inputSchema: {
-            properties: {
-                initiativeId: stringProperty('Initiative ID or initiative reference such as IN-123.'),
-                attachmentId: stringProperty('Attachment descriptor id from get_initiative_attachments.'),
-                format: stringProperty('Read format. Use metadata for descriptors or download for a download URL.', ['text', 'metadata', 'download']),
+                attachmentId: stringProperty('Optional attachment descriptor id to include content for one attachment.'),
+                format: stringProperty('Optional read format when attachmentId is provided. Use metadata for descriptors or download for a download URL.', ['text', 'metadata', 'download']),
                 maxChars: numberProperty('Optional max inline character count for readable text attachments.'),
             },
-            required: ['initiativeId', 'attachmentId'],
+            required: ['id'],
         },
     }));
     register('save_initiative_attachment', (context) => ({
@@ -151,7 +125,7 @@ export function registerDocumentAssetTools(registerTool, executeTool) {
         },
     }));
     register('get_image', (context) => ({
-        description: context.describeTool('Get a single image by asset id or image reference such as I-123. Use this first when the user references an image, then use get_annotated_attachment_sessions and read_annotated_attachment_payload for annotation details. When the image is being used for UI, placement, or visual correction feedback, read the saved annotation payload before making changes.'),
+        description: context.describeTool('Get a single image by asset id or image reference such as I-123. Use this first when the user references an image, then use get_image_annotations for saved annotation sessions and payloads. When the image is being used for UI, placement, or visual correction feedback, read the saved annotation payload before making changes.'),
         inputSchema: {
             properties: {
                 id: stringProperty('Image asset id or image reference such as I-123.'),
@@ -160,7 +134,7 @@ export function registerDocumentAssetTools(registerTool, executeTool) {
         },
     }));
     register('search_documents', (context) => ({
-        description: context.describeTool('Search document assets by keyword, title, filename, caption, or D-123 reference. Use this before get_document when you only know a rough identifier. Search results guide the next step into get_document and read_document_content.'),
+        description: context.describeTool('Search document assets by keyword, title, filename, caption, or D-123 reference. Use this before get_document when you only know a rough identifier. Search results guide the next step into get_document.'),
         inputSchema: {
             properties: {
                 query: stringProperty('Search term for document lookup, including D-123 references.'),
@@ -170,40 +144,26 @@ export function registerDocumentAssetTools(registerTool, executeTool) {
         },
     }));
     register('get_document', (context) => ({
-        description: context.describeTool('Get a single canonical document by asset id or document reference such as D-123. Use this first when the user references a document, then call read_document_content to inspect what it is reviewing.'),
+        description: context.describeTool('Get a single canonical document by asset id or document reference such as D-123. Pass includeContent=true when you need the document body for review or analysis.'),
         inputSchema: {
             properties: {
                 id: stringProperty('Document asset id or document reference such as D-123.'),
                 documentId: stringProperty('Alias for id. Document asset id or document reference such as D-123.'),
-            },
-        },
-    }));
-    register('read_document_content', (context) => ({
-        description: context.describeTool('Read the canonical document body for one document. Use this when an AI needs to inspect what it is reviewing before adding review comments.'),
-        inputSchema: {
-            properties: {
-                documentId: stringProperty('Document asset id or document reference such as D-123.'),
+                includeContent: booleanProperty('When true, include bounded inline text content or a download reference for binary documents.'),
+                format: stringProperty('Optional read mode when including content.', ['metadata', 'text', 'content', 'full', 'download']),
                 maxChars: numberProperty('Optional max inline character count for readable documents.'),
             },
-            required: ['documentId'],
         },
     }));
-    register('get_annotated_attachment_sessions', (context) => ({
-        description: context.describeTool('List saved annotation sessions for one image. Use this after get_image when you need the saved annotation sessions before opening one payload. If the user is pointing at a visual target in I-123, do not stop at the screenshot alone; inspect the saved session payload next.'),
+    register('get_image_annotations', (context) => ({
+        description: context.describeTool('List saved annotation sessions for one image or task, and optionally include one session payload. Use this after get_image when an image reference such as I-123 is being used for UI, placement, or visual correction feedback. Pass sessionId when you need the authoritative payload for a specific saved session.'),
         inputSchema: {
             properties: {
                 imageId: stringProperty('Image asset id or image reference such as I-123.'),
+                imageAssetId: stringProperty('Alias for imageId. Image asset id or image reference such as I-123.'),
+                taskId: stringProperty('Optional task ID or task reference such as T-123 to narrow sessions linked to one task.'),
+                sessionId: stringProperty('Optional annotated attachment session id to include the structured payload for one session.'),
             },
-            required: ['imageId'],
-        },
-    }));
-    register('read_annotated_attachment_payload', (context) => ({
-        description: context.describeTool('Read the structured payload for one annotated attachment session, including markers, geometry, and derived crop hints. Use this as the authoritative instruction source when I-123 is being used for UI placement or visual change requests.'),
-        inputSchema: {
-            properties: {
-                sessionId: stringProperty('Annotated attachment session id.'),
-            },
-            required: ['sessionId'],
         },
     }));
     register('create_annotated_attachment_session', (context) => ({
@@ -320,22 +280,14 @@ export function registerDocumentAssetTools(registerTool, executeTool) {
             required: ['sessionId', 'markerId'],
         },
     }));
-    register('get_document_review_sessions', (context) => ({
-        description: context.describeTool('List review sessions for one document such as D-123. Use read_document_content first when you need to inspect the document body before choosing a session.'),
+    register('get_document_reviews', (context) => ({
+        description: context.describeTool('List review sessions for one document such as D-123, or fetch one review session by sessionId. Use get_document with includeContent=true when you need the document body before choosing a session.'),
         inputSchema: {
             properties: {
                 documentId: stringProperty('Document asset id or document reference such as D-123.'),
-            },
-            required: ['documentId'],
-        },
-    }));
-    register('get_document_review_session', (context) => ({
-        description: context.describeTool('Get one document review session with its comments and summary state.'),
-        inputSchema: {
-            properties: {
+                id: stringProperty('Alias for documentId. Document asset id or document reference such as D-123.'),
                 sessionId: stringProperty('Document review session id.'),
             },
-            required: ['sessionId'],
         },
     }));
     register('create_document_review_session', (context) => ({

package/dist/mcp/documentHelpers.d.ts

@@ -47,13 +47,16 @@ export declare function createDocumentHelpers(deps: DocumentHelpersDeps): {
         nextTool: string;
         suggestedArgs: {
             documentId: string;
+            includeContent: boolean;
         };
         guidance: string;
         reviewNext: {
             helperTool: string;
             listTool: string;
-            createTool: string;
-            commentTool: string;
+            extendedTools: {
+                createTool: string;
+                commentTool: string;
+            };
             guidance: string;
         };
         reason?: undefined;
@@ -62,13 +65,16 @@ export declare function createDocumentHelpers(deps: DocumentHelpersDeps): {
         nextTool: string;
         suggestedArgs: {
             documentId: string;
+            includeContent: boolean;
         };
         guidance: string;
         reviewNext: {
             helperTool: string;
             listTool: string;
-            createTool: string;
-            commentTool: string;
+            extendedTools: {
+                createTool: string;
+                commentTool: string;
+            };
             guidance: string;
         };
         reason: string;
@@ -84,6 +90,7 @@ export declare function createDocumentHelpers(deps: DocumentHelpersDeps): {
         preferredWorkflow: string;
         suggestedArgs: {
             documentId: string;
+            includeContent: boolean;
         };
         guidance: string;
     } | null;

package/dist/mcp/documentHelpers.js

@@ -21,29 +21,33 @@ export function createDocumentHelpers(deps) {
         if (readable) {
             return {
                 available: true,
-                nextTool: 'read_document_content',
-                suggestedArgs: { documentId: preferredIdentifier },
-                guidance: 'To read the document body, call read_document_content with this documentId.',
+                nextTool: 'get_document',
+                suggestedArgs: { documentId: preferredIdentifier, includeContent: true },
+                guidance: 'To read the document body, call get_document with includeContent=true.',
                 reviewNext: {
                     helperTool: 'review_document',
-                    listTool: 'get_document_review_sessions',
-                    createTool: 'create_document_review_session',
-                    commentTool: 'add_document_review_comment',
-                    guidance: 'After reading the document body, prefer review_document for a lower-friction review flow, or use get_document_review_sessions/create_document_review_session and add_document_review_comment directly.'
+                    listTool: 'get_document_reviews',
+                    extendedTools: {
+                        createTool: 'create_document_review_session',
+                        commentTool: 'add_document_review_comment',
+                    },
+                    guidance: 'After reading the document body, use review_document for default-profile review comments. Use get_document_reviews to inspect saved sessions; extended-profile clients may manage sessions and comments manually.'
                 }
             };
         }
         return {
             available: false,
-            nextTool: 'read_document_content',
-            suggestedArgs: { documentId: preferredIdentifier },
-            guidance: 'This document is not inline-readable as text. Call read_document_content to get the structured download/reference response.',
+            nextTool: 'get_document',
+            suggestedArgs: { documentId: preferredIdentifier, includeContent: true },
+            guidance: 'This document is not inline-readable as text. Call get_document with includeContent=true to get the structured download/reference response.',
             reviewNext: {
                 helperTool: 'review_document',
-                listTool: 'get_document_review_sessions',
-                createTool: 'create_document_review_session',
-                commentTool: 'add_document_review_comment',
-                guidance: 'After inspecting the document access response, prefer review_document for a lower-friction review flow, or use get_document_review_sessions/create_document_review_session and add_document_review_comment directly.'
+                listTool: 'get_document_reviews',
+                extendedTools: {
+                    createTool: 'create_document_review_session',
+                    commentTool: 'add_document_review_comment',
+                },
+                guidance: 'After inspecting the document access response, use review_document for default-profile review comments. Use get_document_reviews to inspect saved sessions; extended-profile clients may manage sessions and comments manually.'
             },
             reason: 'binary_file',
         };
@@ -60,10 +64,10 @@ export function createDocumentHelpers(deps) {
             documentId: typeof asset.documentId === 'string' && asset.documentId.trim().length > 0 ? asset.documentId.trim() : null,
             preferredNextTool: 'get_document',
             preferredWorkflow: 'canonical_document',
-            suggestedArgs: { documentId: preferredIdentifier },
+            suggestedArgs: { documentId: preferredIdentifier, includeContent: readable },
             guidance: readable
-                ? 'This attachment is a canonical document. Prefer get_document, then read_document_content, for ongoing document work and review.'
-                : 'This attachment is a canonical document. Prefer get_document for metadata and review context, then read_document_content for the structured content/download response.',
+                ? 'This attachment is a canonical document. Prefer get_document with includeContent=true for ongoing document work and review.'
+                : 'This attachment is a canonical document. Prefer get_document for metadata and review context, then use includeContent=true for the structured content/download response.',
         };
     };
     const searchDocumentAssets = (queryRaw, options) => {

package/dist/mcp/runtime.d.ts

@@ -3,6 +3,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { McpAccessTokenScope, TaskforceCore } from '../core/Taskforce.js';
 import { type AiProfileBootstrapConfig } from './aiProfileBootstrap.js';
 import { type AiProfileSeatScope } from '../shared/aiProfileSeatScope.js';
+import { type McpToolProfile } from './toolRegistry.js';
 export interface TaskforceMcpServerOptions {
     projectRoot?: string;
     tenantId?: string;
@@ -12,6 +13,7 @@ export interface TaskforceMcpServerOptions {
     version?: string;
     logStartup?: boolean;
     runtimeMode?: 'local' | 'cloud';
+    toolProfile?: McpToolProfile;
     auth?: {
         scopes?: McpAccessTokenScope[] | null;
         userId?: string | null;
@@ -80,6 +82,7 @@ export declare function createTaskforceMcpServer(options?: TaskforceMcpServerOpt
     workspaceId: string;
     tenantId: string;
     version: string;
+    toolProfile: "default" | "full" | "extended";
 };
 export declare function startTaskforceMcpStdioServer(options?: TaskforceMcpServerOptions): Promise<{
     transport: StdioServerTransport;
@@ -123,4 +126,5 @@ export declare function startTaskforceMcpStdioServer(options?: TaskforceMcpServe
     workspaceId: string;
     tenantId: string;
     version: string;
+    toolProfile: "default" | "full" | "extended";
 }>;