wolfpack-mcp 1.0.28 → 1.0.30

package/README.md

@@ -276,6 +276,18 @@ Update an existing journal entry.
 
 ### Comments
 
+#### `list_work_item_comments`
+
+List all comments on a work item.
+
+- `work_item_id` (required): The work item UUID
+
+#### `list_issue_comments`
+
+List all comments on an issue.
+
+- `issue_id` (required): The issue UUID
+
 #### `create_work_item_comment`
 
 Add a comment to a work item.
@@ -317,4 +329,10 @@ Upload an image file from disk and get back a permanent URL for use in markdown
 - `file_path` (required): Absolute path to an image file (JPEG, PNG, GIF, WebP; max 5MB)
 - `team_id` (optional): Team ID (required for multi-team users)
 
+#### `download_image`
+
+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/...)`. Use this tool with that URL path to view the image.
+
+- `image_url` (required): The image URL path (e.g. `/api/files/images/{team}/{filename}`)
+
 </details>

package/dist/client.js

@@ -411,6 +411,12 @@ export class WolfpackClient {
         return this.api.patch(`/journal-entries/${entryId}`, data);
     }
     // Comment methods
+    async listWorkItemComments(workItemId) {
+        return this.api.get(`/work-items/${workItemId}/comments`);
+    }
+    async listIssueComments(issueId) {
+        return this.api.get(`/issues/${issueId}/comments`);
+    }
     async createWorkItemComment(workItemId, data) {
         return this.api.post(`/work-items/${workItemId}/comments`, data);
     }
@@ -425,22 +431,11 @@ export class WolfpackClient {
         return this.api.postMultipart(`/teams/${teamSlug}/upload-image`, buffer, filename, mimeType);
     }
     /**
-     * Fetch an image from the MCP images endpoint and return it as a base64 data URI.
-     * Returns null if the image is over 1.5MB or on any fetch failure.
+     * Download an image from the MCP images endpoint and return raw base64 + mimeType.
      */
-    async fetchImageAsBase64(team, filename) {
-        try {
-            const { buffer, contentType } = await this.api.getBuffer(`/images/${team}/${filename}`);
-            // Skip images over 1.5MB to prevent response bloat
-            const MAX_IMAGE_SIZE = 1.5 * 1024 * 1024;
-            if (buffer.length > MAX_IMAGE_SIZE) {
-                return null;
-            }
-            return `data:${contentType};base64,${buffer.toString('base64')}`;
-        }
-        catch {
-            return null;
-        }
+    async downloadImage(team, filename) {
+        const { buffer, contentType } = await this.api.getBuffer(`/images/${team}/${filename}`);
+        return { base64: buffer.toString('base64'), mimeType: contentType };
     }
     close() {
         // No cleanup needed for API client

package/dist/index.js

@@ -8,7 +8,6 @@ import { readFile, stat } from 'fs/promises';
 import { basename, extname, resolve } from 'path';
 import { WolfpackClient } from './client.js';
 import { validateConfig, config } from './config.js';
-import { processContentImages } from './imageProcessor.js';
 // Get current package version
 const require = createRequire(import.meta.url);
 const packageJson = require('../package.json');
@@ -272,6 +271,12 @@ const UpdateJournalEntrySchema = z.object({
         .describe('Updated content (markdown). Supports base64-encoded images which will be auto-uploaded.'),
 });
 // Comment schemas
+const ListWorkItemCommentsSchema = z.object({
+    work_item_id: z.string().describe('The work item UUID'),
+});
+const ListIssueCommentsSchema = z.object({
+    issue_id: z.string().describe('The issue UUID'),
+});
 const CreateWorkItemCommentSchema = z.object({
     work_item_id: z.string().describe('The work item UUID'),
     content: z
@@ -295,6 +300,11 @@ const UploadImageSchema = z.object({
         .optional()
         .describe('Team ID (required for multi-team users, use list_teams to get IDs)'),
 });
+const DownloadImageSchema = z.object({
+    image_url: z
+        .string()
+        .describe('The image URL path found in content fields (e.g. "/api/files/images/{team}/{filename}").'),
+});
 // Helper to detect if a work item description contains a plan
 function hasPlan(description) {
     if (!description)
@@ -415,7 +425,8 @@ class WolfpackMCPServer {
                         'Call this before updating to see current content. ' +
                         'WORKFLOW: When asked to work on an item, check its status and follow the required state transitions ' +
                         '(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.',
+                        '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. ' +
+                        'IMAGES: Image references in the description (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -539,7 +550,8 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'get_radar_item',
-                    description: 'Get a specific radar item (initiative) by ID or refId, including its work items and participants.',
+                    description: 'Get a specific radar item (initiative) by ID or refId, 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.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -616,7 +628,8 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'get_issue',
-                    description: 'Get a specific issue by ID or refId, including comment and attachment counts.',
+                    description: 'Get a specific issue by ID or refId, 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.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -751,7 +764,8 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'get_wiki_page',
-                    description: 'Get a specific wiki/documentation page by ID or slug (URL path). Returns full content in markdown.',
+                    description: 'Get a specific wiki/documentation page by ID or 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.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -821,7 +835,8 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'get_journal_entry',
-                    description: 'Get a specific journal/log entry by ID or reference number. Returns full content.',
+                    description: 'Get a specific journal/log entry by ID or 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.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -867,6 +882,30 @@ class WolfpackMCPServer {
                     },
                 },
                 // Comment tools
+                {
+                    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.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            work_item_id: { type: 'string', description: 'The work item UUID' },
+                        },
+                        required: ['work_item_id'],
+                    },
+                },
+                {
+                    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.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            issue_id: { type: 'string', description: 'The issue UUID' },
+                        },
+                        required: ['issue_id'],
+                    },
+                },
                 {
                     name: 'create_work_item_comment',
                     description: 'Add a comment to a work item. Requires mcp:comments:create permission. ' +
@@ -924,6 +963,23 @@ class WolfpackMCPServer {
                         required: ['file_path'],
                     },
                 },
+                {
+                    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/...)`. ' +
+                        'Use this tool with that URL path to download and view the image. ' +
+                        'Requires mcp:images:read permission.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            image_url: {
+                                type: 'string',
+                                description: 'The image URL path found in content fields (e.g. "/api/files/images/{team}/{filename}").',
+                            },
+                        },
+                        required: ['image_url'],
+                    },
+                },
             ],
         }));
         this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
@@ -981,9 +1037,6 @@ class WolfpackMCPServer {
                         const parsed = GetWorkItemSchema.parse(args);
                         const workItem = await this.client.getWorkItem(parsed.work_item_id, parsed.team_id || this.client.getTeamId() || undefined);
                         if (workItem) {
-                            workItem.description =
-                                (await processContentImages(workItem.description, this.client)) ??
-                                    workItem.description;
                             let text = JSON.stringify(workItem, null, 2);
                             // Add hint if no plan detected in description
                             if (!hasPlan(workItem.description)) {
@@ -1096,11 +1149,6 @@ class WolfpackMCPServer {
                         const parsed = GetRadarItemSchema.parse(args);
                         const radarItem = await this.client.getRadarItem(parsed.item_id, parsed.team_id);
                         if (radarItem) {
-                            radarItem.description =
-                                (await processContentImages(radarItem.description, this.client)) ??
-                                    radarItem.description;
-                            radarItem.notes =
-                                (await processContentImages(radarItem.notes, this.client)) ?? radarItem.notes;
                             return {
                                 content: [{ type: 'text', text: JSON.stringify(radarItem, null, 2) }],
                             };
@@ -1138,8 +1186,6 @@ class WolfpackMCPServer {
                         const parsed = GetIssueSchema.parse(args);
                         const issue = await this.client.getIssue(parsed.issue_id, parsed.team_id);
                         if (issue) {
-                            issue.description =
-                                (await processContentImages(issue.description, this.client)) ?? issue.description;
                             return {
                                 content: [{ type: 'text', text: JSON.stringify(issue, null, 2) }],
                             };
@@ -1234,8 +1280,6 @@ class WolfpackMCPServer {
                         const parsed = GetWikiPageSchema.parse(args);
                         const page = await this.client.getWikiPage(parsed.page_id);
                         if (page) {
-                            page.content =
-                                (await processContentImages(page.content, this.client)) ?? page.content;
                             return {
                                 content: [{ type: 'text', text: JSON.stringify(page, null, 2) }],
                             };
@@ -1297,8 +1341,6 @@ class WolfpackMCPServer {
                         const parsed = GetJournalEntrySchema.parse(args);
                         const entry = await this.client.getJournalEntry(parsed.entry_id, parsed.team_id);
                         if (entry) {
-                            entry.content =
-                                (await processContentImages(entry.content, this.client)) ?? entry.content;
                             return {
                                 content: [{ type: 'text', text: JSON.stringify(entry, null, 2) }],
                             };
@@ -1339,6 +1381,20 @@ class WolfpackMCPServer {
                         };
                     }
                     // Comment handlers
+                    case 'list_work_item_comments': {
+                        const parsed = ListWorkItemCommentsSchema.parse(args);
+                        const comments = await this.client.listWorkItemComments(parsed.work_item_id);
+                        return {
+                            content: [{ type: 'text', text: JSON.stringify(comments, null, 2) }],
+                        };
+                    }
+                    case 'list_issue_comments': {
+                        const parsed = ListIssueCommentsSchema.parse(args);
+                        const comments = await this.client.listIssueComments(parsed.issue_id);
+                        return {
+                            content: [{ type: 'text', text: JSON.stringify(comments, null, 2) }],
+                        };
+                    }
                     case 'create_work_item_comment': {
                         const parsed = CreateWorkItemCommentSchema.parse(args);
                         const comment = await this.client.createWorkItemComment(parsed.work_item_id, {
@@ -1406,6 +1462,24 @@ class WolfpackMCPServer {
                             ],
                         };
                     }
+                    case 'download_image': {
+                        const parsed = DownloadImageSchema.parse(args);
+                        const match = parsed.image_url.match(/\/api\/files\/images\/([^/]+)\/(.+)$/);
+                        if (!match) {
+                            throw new Error('Invalid image URL. Expected format: /api/files/images/{team}/{filename}');
+                        }
+                        const [, team, filename] = match;
+                        const { base64, mimeType } = await this.client.downloadImage(team, filename);
+                        return {
+                            content: [
+                                {
+                                    type: 'image',
+                                    data: base64,
+                                    mimeType,
+                                },
+                            ],
+                        };
+                    }
                     default:
                         throw new Error(`Unknown tool: ${name}`);
                 }

package/package.json

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