wolfpack-mcp 1.0.60 → 1.0.61

package/dist/client.js

@@ -469,6 +469,14 @@ export class WolfpackClient {
         const query = params.toString();
         return this.api.get(`/categories${query ? `?${query}` : ''}`);
     }
+    // Tag methods
+    async listTags(teamSlug) {
+        const params = new URLSearchParams();
+        if (teamSlug)
+            params.append('teamSlug', teamSlug);
+        const query = params.toString();
+        return this.api.get(`/tags${query ? `?${query}` : ''}`);
+    }
     /**
      * Upload an image and get back a URL that can be used in markdown content.
      */
@@ -483,6 +491,14 @@ export class WolfpackClient {
         const { buffer, contentType } = await this.api.getBuffer(`/images/${team}/${filename}`);
         return { base64: buffer.toString('base64'), mimeType: contentType };
     }
+    /**
+     * Download a stored file (new /api/files/{fileId}/{filename} URL shape) and
+     * return raw base64 + mimeType.
+     */
+    async downloadFile(fileId) {
+        const { buffer, contentType } = await this.api.getBuffer(`/files/${fileId}`);
+        return { base64: buffer.toString('base64'), mimeType: contentType };
+    }
     /**
      * Download an issue attachment image and return raw base64 + mimeType.
      */

package/dist/index.js

@@ -166,7 +166,10 @@ const UpdateWorkItemSchema = z.object({
         .nullable()
         .optional()
         .describe('User ID for third assisting user, or null to remove'),
-    tag_ids: z.array(z.string()).optional().describe('Tag IDs to apply (replaces existing tags)'),
+    tags: z
+        .array(z.string())
+        .optional()
+        .describe('Tag names to apply (replaces existing tags). Use list_tags to see available tags.'),
     closing_comment: z
         .string()
         .nullable()
@@ -488,7 +491,7 @@ const UploadImageSchema = z.object({
 const DownloadImageSchema = z.object({
     image_url: z
         .string()
-        .describe('The image URL path found in content fields (e.g. "/api/files/images/{team}/{filename}").'),
+        .describe('The image URL path found in content fields (e.g. "/api/files/{fileId}/{filename}" or legacy "/api/files/images/{team}/{filename}").'),
 });
 // Skill schemas
 const GetSkillSchema = z.object({
@@ -505,6 +508,13 @@ const ListCategoriesSchema = z.object({
         .optional()
         .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
 });
+// Tag schemas
+const ListTagsSchema = z.object({
+    project_slug: z
+        .string()
+        .optional()
+        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+});
 // Team member schemas
 const ListTeamMembersSchema = z.object({
     project_slug: z
@@ -748,7 +758,7 @@ class WolfpackMCPServer {
                         '(pending→pull first, new→doing, blocked/ready/completed/closed→new→doing, then review when done). ' +
                         'PLANNING: Check if the description contains a plan (markdown checklist). If not, APPEND one using update_work_progress - preserve all original description text and add your plan below a "---" separator. ' +
                         'FORMS: Procedure-created work items may include formDefinition (field definitions with name, label, type, required, options) and formValues (current values). Use submit_work_item_form to fill in form values. ' +
-                        'IMAGES: Image references in the description (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
+                        'IMAGES: Image references in the description (e.g. `![alt](/api/files/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -790,7 +800,7 @@ class WolfpackMCPServer {
                     name: 'update_work_item',
                     description: 'Update one or more fields on a work item. Only provide the fields you want to change. ' +
                         'Supports: title, description, status, leading_user_id (assignee), assisting_user1/2/3_id, ' +
-                        'radar_item_id (initiative), category_id, priority (0-4), size (S/M/L), tag_ids, and closing_comment. ' +
+                        'radar_item_id (initiative), category_id, priority (0-4), size (S/M/L), tags, and closing_comment. ' +
                         'STATUS WORKFLOW: "pending" (backlog) → "new" (to do) → "doing" (in progress) → "review" (work done) → "ready" (awaiting deployment) → "completed" (deployed). ' +
                         'Use "blocked" when work cannot proceed. For "pending" items use pull_work_item first. ' +
                         'When moving to "review", add a completion comment. When moving to "blocked", add a comment explaining the blocker.',
@@ -857,10 +867,10 @@ class WolfpackMCPServer {
                                 type: ['string', 'null'],
                                 description: 'User ID for third assisting user, or null to remove',
                             },
-                            tag_ids: {
+                            tags: {
                                 type: 'array',
                                 items: { type: 'string' },
-                                description: 'Tag IDs to apply (replaces existing tags)',
+                                description: 'Tag names to apply (replaces existing tags). Use list_tags to see available tags.',
                             },
                             closing_comment: {
                                 type: ['string', 'null'],
@@ -953,7 +963,7 @@ class WolfpackMCPServer {
                 {
                     name: 'get_radar_item',
                     description: 'Get a specific radar item (initiative) by reference number, including its work items and participants. ' +
-                        'IMAGES: Image references in the description (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
+                        'IMAGES: Image references in the description (e.g. `![alt](/api/files/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -1086,7 +1096,7 @@ class WolfpackMCPServer {
                     description: 'Get a specific issue by its PREFIXED reference #iN (e.g. #i5). ' +
                         'IMPORTANT: A bare #N (without prefix) is ALWAYS a work item, NOT an issue. Only use this tool when the user explicitly says "issue" or uses the #i prefix. ' +
                         'Returns full details including comment and attachment counts. ' +
-                        'IMAGES: Image references in the description (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
+                        'IMAGES: Image references in the description (e.g. `![alt](/api/files/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -1271,7 +1281,7 @@ class WolfpackMCPServer {
                 {
                     name: 'get_wiki_page',
                     description: 'Get a specific wiki/documentation page by slug (URL path). Returns full content in markdown. ' +
-                        'IMAGES: Image references in the content (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
+                        'IMAGES: Image references in the content (e.g. `![alt](/api/files/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -1323,7 +1333,7 @@ class WolfpackMCPServer {
                             tag_ids: {
                                 type: 'array',
                                 items: { type: 'string' },
-                                description: 'Tag IDs to apply to the page (replaces existing tags). Use list tags endpoint to get available tag IDs.',
+                                description: 'Tag IDs to apply to the page (replaces existing tags)',
                             },
                             project_slug: {
                                 type: 'string',
@@ -1364,7 +1374,7 @@ class WolfpackMCPServer {
                 {
                     name: 'get_journal_entry',
                     description: 'Get a specific journal/log entry by reference number. Returns full content. ' +
-                        'IMAGES: Image references in the content (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
+                        'IMAGES: Image references in the content (e.g. `![alt](/api/files/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -1427,7 +1437,7 @@ class WolfpackMCPServer {
                 {
                     name: 'list_work_item_comments',
                     description: 'List all comments on a work item. Returns comments in chronological order. Requires mcp:comments:read permission. ' +
-                        'IMAGES: Image references in comments (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
+                        'IMAGES: Image references in comments (e.g. `![alt](/api/files/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -1443,7 +1453,7 @@ class WolfpackMCPServer {
                 {
                     name: 'list_issue_comments',
                     description: 'List all comments on an issue. Returns comments in chronological order. Requires mcp:comments:read permission. ' +
-                        'IMAGES: Image references in comments (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
+                        'IMAGES: Image references in comments (e.g. `![alt](/api/files/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -1563,7 +1573,7 @@ class WolfpackMCPServer {
                 {
                     name: 'download_image',
                     description: 'Download and view an image referenced in content fields. ' +
-                        'Content from work items, issues, wiki pages, journal entries, and comments may contain image references like `![alt](/api/files/images/...)`. ' +
+                        'Content from work items, issues, wiki pages, journal entries, and comments may contain image references like `![alt](/api/files/{fileId}/...)` or the legacy `![alt](/api/files/images/...)`. ' +
                         'Issues may also have attachment images with URLs like `/api/teams/{team}/issues/{refId}/attachments/{id}`. ' +
                         'Use this tool with that URL path to download and view the image. ' +
                         'Requires mcp:images:read permission.',
@@ -1572,7 +1582,7 @@ class WolfpackMCPServer {
                         properties: {
                             image_url: {
                                 type: 'string',
-                                description: 'The image URL path found in content fields (e.g. "/api/files/images/{team}/{filename}" or "/api/teams/{team}/issues/{refId}/attachments/{id}").',
+                                description: 'The image URL path found in content fields (e.g. "/api/files/{fileId}/{filename}", legacy "/api/files/images/{team}/{filename}", or "/api/teams/{team}/issues/{refId}/attachments/{id}").',
                             },
                         },
                         required: ['image_url'],
@@ -1593,6 +1603,21 @@ class WolfpackMCPServer {
                         },
                     },
                 },
+                // Tag tools
+                {
+                    name: 'list_tags',
+                    description: 'List all tags available in a project. Returns tag names and colours. ' +
+                        'Work items are tagged by name via update_work_item.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            project_slug: {
+                                type: 'string',
+                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                            },
+                        },
+                    },
+                },
                 // Team member tools
                 {
                     name: 'list_team_members',
@@ -2029,8 +2054,8 @@ class WolfpackMCPServer {
                             fields.assistingUser2Id = parsed.assisting_user2_id;
                         if (parsed.assisting_user3_id !== undefined)
                             fields.assistingUser3Id = parsed.assisting_user3_id;
-                        if (parsed.tag_ids !== undefined)
-                            fields.tagIds = parsed.tag_ids;
+                        if (parsed.tags !== undefined)
+                            fields.tags = parsed.tags;
                         if (parsed.closing_comment !== undefined)
                             fields.closingComment = parsed.closing_comment;
                         const workItem = await this.client.updateWorkItem(parsed.work_item_id, fields, teamSlug);
@@ -2077,7 +2102,7 @@ class WolfpackMCPServer {
                                 changes.push(parsed.assisting_user3_id
                                     ? `assisting user 3 updated`
                                     : 'assisting user 3 removed');
-                            if (parsed.tag_ids !== undefined)
+                            if (parsed.tags !== undefined)
                                 changes.push('tags updated');
                             if (parsed.closing_comment !== undefined)
                                 changes.push('closing comment set');
@@ -2557,13 +2582,18 @@ class WolfpackMCPServer {
                     }
                     case 'download_image': {
                         const parsed = DownloadImageSchema.parse(args);
-                        // Try S3-stored image pattern: /api/files/images/{team}/{filename}
+                        // Try stored-file pattern (#1439): /api/files/{fileId}/{filename}
+                        const storedFileMatch = parsed.image_url.match(/\/api\/files\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})(?:\/|$)/i);
+                        // Try legacy S3-stored image pattern: /api/files/images/{team}/{filename}
                         const s3Match = parsed.image_url.match(/\/api\/files\/images\/([^/]+)\/(.+)$/);
                         // Try issue attachment pattern: /api/teams/{team}/issues/{refId}/attachments/{id}
                         const attachmentMatch = parsed.image_url.match(/\/api\/teams\/([^/]+)\/issues\/(\d+)\/attachments\/([^/]+)$/);
                         let base64;
                         let mimeType;
-                        if (s3Match) {
+                        if (storedFileMatch) {
+                            ({ base64, mimeType } = await this.client.downloadFile(storedFileMatch[1]));
+                        }
+                        else if (s3Match) {
                             const [, team, filename] = s3Match;
                             ({ base64, mimeType } = await this.client.downloadImage(team, filename));
                         }
@@ -2572,7 +2602,7 @@ class WolfpackMCPServer {
                             ({ base64, mimeType } = await this.client.downloadIssueAttachment(team, refId, attachmentId));
                         }
                         else {
-                            throw new Error('Invalid image URL. Expected format: /api/files/images/{team}/{filename} or /api/teams/{team}/issues/{refId}/attachments/{id}');
+                            throw new Error('Invalid image URL. Expected format: /api/files/{fileId}/{filename}, /api/files/images/{team}/{filename} or /api/teams/{team}/issues/{refId}/attachments/{id}');
                         }
                         return {
                             content: [
@@ -2592,6 +2622,14 @@ class WolfpackMCPServer {
                             content: [{ type: 'text', text: JSON.stringify(categories, null, 2) }],
                         };
                     }
+                    // Tag handlers
+                    case 'list_tags': {
+                        const parsed = ListTagsSchema.parse(args);
+                        const tags = await this.client.listTags(parsed.project_slug || this.client.getProjectSlug() || undefined);
+                        return {
+                            content: [{ type: 'text', text: JSON.stringify(tags, null, 2) }],
+                        };
+                    }
                     // Team member handlers
                     case 'list_team_members': {
                         const parsed = ListTeamMembersSchema.parse(args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wolfpack-mcp",
-  "version": "1.0.60",
+  "version": "1.0.61",
   "description": "MCP server for Wolfpack AI-enhanced software delivery tools",
   "main": "dist/index.js",
   "type": "module",

package/dist/imageProcessor.js

@@ -1,21 +0,0 @@
-const IMAGE_URL_REGEX = /!\[([^\]]*)\]\(\/api\/files\/images\/([^/]+)\/([^)]+)\)/g;
-/**
- * Processes markdown content to replace image URLs with base64 data URIs.
- * Failed fetches or oversized images leave the original URL intact.
- */
-export async function processContentImages(content, client) {
-    if (!content)
-        return content;
-    const matches = [...content.matchAll(IMAGE_URL_REGEX)];
-    if (matches.length === 0)
-        return content;
-    let result = content;
-    for (const match of matches) {
-        const [fullMatch, alt, team, filename] = match;
-        const dataUri = await client.fetchImageAsBase64(team, filename);
-        if (dataUri) {
-            result = result.replace(fullMatch, `![${alt}](${dataUri})`);
-        }
-    }
-    return result;
-}