@taskforcehq/taskforce 0.3.328 → 0.3.329

package/dist/mcp/documentAssetRegistrar.js

@@ -2,8 +2,16 @@ import { bindDomainTool } from './toolCatalog.js';
 function stringProperty(description, enumValues) {
     return enumValues ? { type: 'string', description, enum: enumValues } : { type: 'string', description };
 }
-function numberProperty(description) {
-    return { type: 'number', description };
+function boundedNumberProperty(description, minimum, maximum) {
+    return { type: 'number', description, minimum, maximum };
+}
+function integerProperty(description, minimum, maximum) {
+    return {
+        type: 'integer',
+        description,
+        ...(minimum === undefined ? {} : { minimum }),
+        ...(maximum === undefined ? {} : { maximum }),
+    };
 }
 function booleanProperty(description) {
     return { type: 'boolean', description };
@@ -17,12 +25,12 @@ function annotatedAttachmentMarkerProperty() {
         properties: {
             type: { type: 'string' },
             kind: { type: 'string' },
-            x: { type: 'number' },
-            y: { type: 'number' },
-            width: { type: 'number' },
-            height: { type: 'number' },
-            x2: { type: 'number' },
-            y2: { type: 'number' },
+            x: { type: 'number', minimum: 0, maximum: 1 },
+            y: { type: 'number', minimum: 0, maximum: 1 },
+            width: { type: 'number', minimum: 0, maximum: 1 },
+            height: { type: 'number', minimum: 0, maximum: 1 },
+            x2: { type: 'number', minimum: 0, maximum: 1 },
+            y2: { type: 'number', minimum: 0, maximum: 1 },
             text: { type: 'string' },
             instruction: { type: 'string' },
             instructionType: { type: 'string' },
@@ -96,11 +104,11 @@ export function registerDocumentAssetTools(registerTool, executeTool) {
         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.'),
                 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. Longer content is truncated with size metadata and a download hint.'),
+                maxChars: integerProperty('Optional max inline character count for readable text attachments. Longer content is truncated with size metadata and a download hint.', 1),
             },
+            required: ['taskId'],
         },
     }));
     register('get_workstream_attachments', (context) => ({
@@ -110,7 +118,7 @@ export function registerDocumentAssetTools(registerTool, executeTool) {
                 id: stringProperty('Workstream ID or workstream reference such as WS-123.'),
                 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. Longer content is truncated with size metadata and a download hint.'),
+                maxChars: integerProperty('Optional max inline character count for readable text attachments. Longer content is truncated with size metadata and a download hint.', 1),
             },
             required: ['id'],
         },
@@ -195,7 +203,7 @@ export function registerDocumentAssetTools(registerTool, executeTool) {
                 id: stringProperty('Initiative ID or initiative reference such as IN-123.'),
                 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. Longer content is truncated with size metadata and a download hint.'),
+                maxChars: integerProperty('Optional max inline character count for readable text attachments. Longer content is truncated with size metadata and a download hint.', 1),
             },
             required: ['id'],
         },
@@ -229,11 +237,12 @@ export function registerDocumentAssetTools(registerTool, executeTool) {
         },
     }));
     register('search_images', (context) => ({
-        description: context.describeTool('Search image assets by keyword, title, filename, caption, or I-123 reference. Use this before get_image when you only know a rough identifier.'),
+        description: context.describeTool('Search image assets by keyword, title, filename, caption, or I-123 reference. Use offset/limit to continue broad searches, then call get_image for the selected result.'),
         inputSchema: {
             properties: {
                 query: stringProperty('Search term for image lookup, including I-123 references.'),
-                limit: numberProperty('Max images to return.'),
+                limit: integerProperty('Page size (default 10; max 50).', 1, 50),
+                offset: integerProperty('Non-negative result offset (default 0).', 0),
             },
             required: ['query'],
         },
@@ -242,17 +251,18 @@ export function registerDocumentAssetTools(registerTool, executeTool) {
         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.'),
-                imageId: stringProperty('Alias for id. Image asset id or image reference such as I-123.'),
+                imageId: stringProperty('Image asset id or image reference such as I-123.'),
             },
+            required: ['imageId'],
         },
     }));
     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.'),
+        description: context.describeTool('Search document assets by keyword, title, filename, caption, or D-123 reference. Use offset/limit to continue broad searches, then call get_document for the selected result.'),
         inputSchema: {
             properties: {
                 query: stringProperty('Search term for document lookup, including D-123 references.'),
-                limit: numberProperty('Max documents to return.'),
+                limit: integerProperty('Page size (default 10; max 50).', 1, 50),
+                offset: integerProperty('Non-negative result offset (default 0).', 0),
             },
             required: ['query'],
         },
@@ -264,7 +274,7 @@ export function registerDocumentAssetTools(registerTool, executeTool) {
                 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. Longer content is truncated with size metadata and a download hint.'),
+                maxChars: integerProperty('Optional max inline character count for readable documents. Longer content is truncated with size metadata and a download hint.', 1),
             },
             required: ['documentId'],
         },
@@ -289,7 +299,6 @@ export function registerDocumentAssetTools(registerTool, executeTool) {
         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.'),
             },
@@ -348,16 +357,16 @@ export function registerDocumentAssetTools(registerTool, executeTool) {
                 sessionId: stringProperty('Annotated attachment session id.'),
                 type: stringProperty('Marker type.'),
                 kind: stringProperty('Alias for type. Marker kind: pin, box, arrow, or text-note.'),
-                x: numberProperty('Normalized x coordinate in the 0..1 range.'),
-                y: numberProperty('Normalized y coordinate in the 0..1 range.'),
-                width: numberProperty('Optional normalized width in the 0..1 range.'),
-                height: numberProperty('Optional normalized height in the 0..1 range.'),
+                x: boundedNumberProperty('Normalized x coordinate in the 0..1 range.', 0, 1),
+                y: boundedNumberProperty('Normalized y coordinate in the 0..1 range.', 0, 1),
+                width: boundedNumberProperty('Optional normalized width in the 0..1 range.', 0, 1),
+                height: boundedNumberProperty('Optional normalized height in the 0..1 range.', 0, 1),
                 text: stringProperty('Optional marker text or note.'),
                 instruction: stringProperty('Alias for text. Marker instruction or note.'),
                 instructionType: stringProperty('Optional marker instruction category.'),
                 color: stringProperty('Optional marker color.'),
-                x2: numberProperty('Arrow endpoint normalized x coordinate.'),
-                y2: numberProperty('Arrow endpoint normalized y coordinate.'),
+                x2: boundedNumberProperty('Arrow endpoint normalized x coordinate.', 0, 1),
+                y2: boundedNumberProperty('Arrow endpoint normalized y coordinate.', 0, 1),
             },
             required: ['sessionId'],
         },
@@ -378,12 +387,12 @@ export function registerDocumentAssetTools(registerTool, executeTool) {
             properties: {
                 sessionId: stringProperty('Annotated attachment session id.'),
                 markerId: stringProperty('Marker id within the session.'),
-                x: numberProperty('Updated normalized x coordinate.'),
-                y: numberProperty('Updated normalized y coordinate.'),
-                width: numberProperty('Updated normalized width.'),
-                height: numberProperty('Updated normalized height.'),
-                x2: numberProperty('Updated arrow endpoint normalized x coordinate.'),
-                y2: numberProperty('Updated arrow endpoint normalized y coordinate.'),
+                x: boundedNumberProperty('Updated normalized x coordinate.', 0, 1),
+                y: boundedNumberProperty('Updated normalized y coordinate.', 0, 1),
+                width: boundedNumberProperty('Updated normalized width.', 0, 1),
+                height: boundedNumberProperty('Updated normalized height.', 0, 1),
+                x2: boundedNumberProperty('Updated arrow endpoint normalized x coordinate.', 0, 1),
+                y2: boundedNumberProperty('Updated arrow endpoint normalized y coordinate.', 0, 1),
                 instruction: stringProperty('Updated marker instruction.'),
                 instructionType: stringProperty('Updated marker instruction category.'),
                 color: stringProperty('Updated marker color.'),
@@ -397,7 +406,7 @@ export function registerDocumentAssetTools(registerTool, executeTool) {
             properties: {
                 sessionId: stringProperty('Annotated attachment session id.'),
                 markerId: stringProperty('Marker id within the session.'),
-                toIndex: numberProperty('Target zero-based review order.'),
+                toIndex: integerProperty('Target zero-based review order.', 0),
             },
             required: ['sessionId', 'markerId', 'toIndex'],
         },
@@ -541,9 +550,9 @@ export function registerDocumentAssetTools(registerTool, executeTool) {
                     uploadedPath: stringProperty('Finalize a previously staged remote upload by passing the uploaded Taskforce storage path returned by save_task_attachment init mode.'),
                     uploadDraftId: stringProperty('Finalize a previously staged remote upload by passing the uploadDraftId returned by save_task_attachment init mode.'),
                     mimeType: stringProperty('Mime type for staged remote uploads such as image/png or image/jpeg. Provide this with sizeBytes to start a staged upload.'),
-                    sizeBytes: numberProperty('File size in bytes for staged remote uploads. Provide this with mimeType to start a staged upload.'),
+                    sizeBytes: integerProperty('File size in bytes for staged remote uploads. Provide this with mimeType to start a staged upload.', 0),
                 }),
-                expectedSizeBytes: numberProperty('Optional exact byte count for integrity verification. The save is rejected before attachment when the persisted bytes would differ.'),
+                expectedSizeBytes: integerProperty('Optional exact byte count for integrity verification. The save is rejected before attachment when the persisted bytes would differ.', 0),
                 expectedSha256: stringProperty('Optional lowercase or uppercase SHA-256 hex digest for integrity verification. The save is rejected before attachment when the persisted bytes would differ.'),
                 displayName: stringProperty('Optional attachment display name. Defaults to filename and is independent from caption.'),
                 caption: stringProperty('Optional attachment caption.'),

package/dist/mcp/documentHelpers.d.ts

@@ -43,6 +43,7 @@ export declare function createDocumentHelpers(deps: DocumentHelpersDeps): {
     } | null;
     searchDocumentAssets: (queryRaw: unknown, options?: {
         limit?: unknown;
+        offset?: unknown;
     }) => Array<{
         asset: WorkspaceDocumentEntry;
         matchedOn: string[];

package/dist/mcp/documentHelpers.js

@@ -51,8 +51,10 @@ export function createDocumentHelpers(deps) {
         }
         const requestedLimit = Number(options?.limit);
         const limit = Number.isFinite(requestedLimit)
-            ? Math.max(1, Math.min(50, Math.trunc(requestedLimit)))
+            ? Math.max(1, Math.min(51, Math.trunc(requestedLimit)))
             : 10;
+        const requestedOffset = Number(options?.offset);
+        const offset = Number.isFinite(requestedOffset) ? Math.max(0, Math.trunc(requestedOffset)) : 0;
         const normalize = (value) => typeof value === 'string' ? value.trim().toLowerCase() : '';
         const tokenize = (value) => normalize(value).split(/[^a-z0-9]+/i).filter(Boolean);
         const allDocuments = deps.workspaceAssetStore.listDocumentsByWorkspace(deps.activeWorkspaceId);
@@ -103,8 +105,10 @@ export function createDocumentHelpers(deps) {
             return [{ asset, matchedOn: Array.from(matchedOn), score }];
         });
         return scoredMatches
-            .sort((a, b) => b.score - a.score || String(b.asset.updatedAt || '').localeCompare(String(a.asset.updatedAt || '')))
-            .slice(0, limit);
+            .sort((a, b) => b.score - a.score
+            || String(b.asset.updatedAt || '').localeCompare(String(a.asset.updatedAt || ''))
+            || a.asset.assetId.localeCompare(b.asset.assetId))
+            .slice(offset, offset + limit);
     };
     const resolveDocumentAssetByIdentifierOrThrow = (documentIdentifier, options) => {
         const normalizedValue = typeof documentIdentifier === 'string' ? documentIdentifier.trim() : '';