wolfpack-mcp 1.0.59 → 1.0.61

package/dist/agentBuilderTools.js

@@ -37,16 +37,19 @@ export const AGENT_BUILDER_TOOLS = [
     },
     {
         name: 'create_agent',
-        description: 'Create a new agent from a template. Use list_agent_templates to see available templates.',
+        description: 'Create a new agent from a container image. Use list_container_images to see available images.',
         inputSchema: {
             type: 'object',
             properties: {
-                template_id: { type: 'string', description: 'Template ID to create the agent from' },
+                container_image_id: {
+                    type: 'string',
+                    description: 'Container image ID to create the agent from',
+                },
                 name: { type: 'string', description: 'Display name for the agent' },
                 config: { type: 'object', description: 'Optional agent-specific configuration' },
                 ...ORG_SLUG_PROP,
             },
-            required: ['template_id', 'name'],
+            required: ['container_image_id', 'name'],
         },
     },
     {
@@ -71,7 +74,7 @@ export const AGENT_BUILDER_TOOLS = [
                 },
                 instructions: {
                     type: 'string',
-                    description: 'Agent-specific instructions (supplements template instructions). Set to null to clear.',
+                    description: 'Agent-specific instructions appended to the system prompt. Set to null to clear.',
                 },
                 llm_provider: {
                     type: 'string',
@@ -682,8 +685,8 @@ export const AGENT_BUILDER_TOOLS = [
     },
     // ─── Group 7: Discovery ───────────────────────────────────────────────────
     {
-        name: 'list_agent_templates',
-        description: 'List agent templates available to the organisation. Use template IDs when calling create_agent.',
+        name: 'list_container_images',
+        description: 'List agent-capable container images assigned to the organisation. Use image IDs when calling create_agent.',
         inputSchema: { type: 'object', properties: { ...ORG_SLUG_PROP } },
     },
     {
@@ -735,14 +738,14 @@ export async function handleAgentBuilderTool(name, args, client) {
         case 'create_agent': {
             const parsed = z
                 .object({
-                template_id: z.string(),
+                container_image_id: z.string(),
                 name: z.string(),
                 config: z.record(z.unknown()).optional(),
                 org_slug: orgSlugField,
             })
                 .parse(args);
             const agent = await client.createAgent({
-                templateId: parsed.template_id,
+                containerImageId: parsed.container_image_id,
                 name: parsed.name,
                 config: parsed.config,
             }, resolveOrg(parsed));
@@ -1250,10 +1253,10 @@ export async function handleAgentBuilderTool(name, args, client) {
             return { content: [{ type: 'text', text: `Set secret "${secret.name}"` }] };
         }
         // ─── Discovery ────────────────────────────────────────────────────────────
-        case 'list_agent_templates': {
+        case 'list_container_images': {
             const parsed = z.object({ org_slug: orgSlugField }).parse(args);
-            const templates = await client.listAgentTemplates(resolveOrg(parsed));
-            return { content: [{ type: 'text', text: text(templates) }] };
+            const images = await client.listContainerImages(resolveOrg(parsed));
+            return { content: [{ type: 'text', text: text(images) }] };
         }
         case 'list_llm_models': {
             const parsed = z.object({ org_slug: orgSlugField }).parse(args);

package/dist/agentSelfTools.js

@@ -6,7 +6,7 @@ function text(data) {
 export const AGENT_SELF_TOOLS = [
     {
         name: 'get_self',
-        description: 'Get your own agent profile with full composed context: template system prompt, agent instructions, skills, LLM model, and assigned projects. ' +
+        description: 'Get your own agent profile with full composed context: system prompt, instructions, skills, LLM model, and assigned projects. ' +
             'Use this to understand how you are configured and what capabilities you have. ' +
             'Essential for self-reflection and improvement proposals.',
         inputSchema: { type: 'object', properties: {} },

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.
      */
@@ -767,8 +783,8 @@ export class WolfpackClient {
         }
     }
     // ─── Agent Builder: Discovery ──────────────────────────────────────────────
-    async listAgentTemplates(orgSlug) {
-        return this.api.get(this.withOrgSlug('/agent-builder/templates', orgSlug));
+    async listContainerImages(orgSlug) {
+        return this.api.get(this.withOrgSlug('/agent-builder/container-images', orgSlug));
     }
     async listLlmModels(orgSlug) {
         return this.api.get(this.withOrgSlug('/agent-builder/llm-models', orgSlug));
@@ -826,6 +842,10 @@ export class WolfpackClient {
         await this.api.delete(this.withTeamSlug(`/procedures/${procedureId}`, teamSlug));
         return { success: true };
     }
+    async startCase(procedureId, data) {
+        const { teamSlug, ...body } = data;
+        return this.api.post(this.withTeamSlug(`/procedures/${procedureId}/start`, teamSlug), body);
+    }
     // ─── Agent Self-Introspection ──────────────────────────────────────────────
     async getSelf() {
         return this.api.get('/self');

package/dist/index.js

@@ -11,6 +11,7 @@ import { validateConfig, config } from './config.js';
 import { AGENT_BUILDER_TOOLS, handleAgentBuilderTool } from './agentBuilderTools.js';
 import { PROCEDURE_TOOLS, handleProcedureTool } from './procedureTools.js';
 import { AGENT_SELF_TOOLS, handleAgentSelfTool } from './agentSelfTools.js';
+import { resolveRadarItemId } from './resolveRadarItemId.js';
 // Get current package version
 const require = createRequire(import.meta.url);
 const packageJson = require('../package.json');
@@ -76,7 +77,10 @@ const ListWorkItemsSchema = z.object({
         .string()
         .optional()
         .describe('Filter by priority level (0-4, higher is more important)'),
-    radar_item_id: z.coerce.string().optional().describe('Filter by linked radar/initiative item'),
+    radar_item_id: z.coerce
+        .string()
+        .optional()
+        .describe('Filter by linked radar/initiative item. Accepts refId ("5" or "#r5"), UUID, or "none"/"any"/"all".'),
     created_by_id: z.coerce.string().optional().describe('Filter by creator user ID'),
     updated_by_id: z.coerce.string().optional().describe('Filter by last updater user ID'),
     sort_by: z.coerce
@@ -135,7 +139,7 @@ const UpdateWorkItemSchema = z.object({
         .string()
         .nullable()
         .optional()
-        .describe('Radar/initiative item ID to link to, or null to unlink'),
+        .describe('Link to a radar/initiative item. Accepts refId ("5" or "#r5") or UUID. Use null to unlink.'),
     category_id: z
         .string()
         .nullable()
@@ -162,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()
@@ -288,7 +295,10 @@ const CreateWorkItemSchema = z.object({
         .describe('Size estimate: "S" (small), "M" (medium), "L" (large)'),
     leading_user_id: z.string().optional().describe('User ID to assign as leading user'),
     category_id: z.string().optional().describe('Category ID to organize the work item'),
-    radar_item_id: z.string().optional().describe('Radar/initiative item ID to link to'),
+    radar_item_id: z
+        .string()
+        .optional()
+        .describe('Link to a radar/initiative item. Accepts refId ("5" or "#r5") or UUID.'),
 });
 const CreateIssueSchema = z.object({
     project_slug: z
@@ -481,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({
@@ -498,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
@@ -708,7 +725,8 @@ class WolfpackMCPServer {
                             },
                             radar_item_id: {
                                 type: 'string',
-                                description: 'Filter by linked radar/initiative item ID',
+                                description: 'Filter by linked radar/initiative item. Accepts refId (e.g. "5" or "#r5"), UUID, ' +
+                                    'or one of "none" (no link), "any" (has any link), "all" (no filter).',
                             },
                             sort_by: {
                                 type: 'string',
@@ -740,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: {
@@ -782,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.',
@@ -822,7 +840,7 @@ class WolfpackMCPServer {
                             },
                             radar_item_id: {
                                 type: ['string', 'null'],
-                                description: 'Radar/initiative item ID to link to, or null to unlink',
+                                description: 'Link to a radar/initiative item. Accepts refId (e.g. "5" or "#r5") or UUID. Use null to unlink.',
                             },
                             category_id: {
                                 type: ['string', 'null'],
@@ -849,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'],
@@ -945,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: {
@@ -1078,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: {
@@ -1145,7 +1163,7 @@ class WolfpackMCPServer {
                             },
                             radar_item_id: {
                                 type: 'string',
-                                description: 'Radar/initiative item ID to link to',
+                                description: 'Link to a radar/initiative item. Accepts refId (e.g. "5" or "#r5") or UUID.',
                             },
                         },
                         required: ['title'],
@@ -1263,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: {
@@ -1315,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',
@@ -1356,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: {
@@ -1419,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: {
@@ -1435,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: {
@@ -1555,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.',
@@ -1564,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'],
@@ -1585,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',
@@ -1924,14 +1957,19 @@ class WolfpackMCPServer {
                     // Work Item handlers
                     case 'list_work_items': {
                         const parsed = ListWorkItemsSchema.parse(args);
+                        const teamSlug = parsed.project_slug || this.client.getProjectSlug() || undefined;
+                        const RADAR_FILTER_PASSTHROUGH = new Set(['none', 'any', 'all']);
+                        const radarItemIdFilter = parsed.radar_item_id && !RADAR_FILTER_PASSTHROUGH.has(parsed.radar_item_id)
+                            ? await resolveRadarItemId(this.client, parsed.radar_item_id, teamSlug)
+                            : parsed.radar_item_id;
                         const result = await this.client.listWorkItems({
-                            teamSlug: parsed.project_slug || this.client.getProjectSlug() || undefined,
+                            teamSlug,
                             status: parsed.status,
                             assignedToId: parsed.assigned_to_id,
                             search: parsed.search,
                             categoryId: parsed.category_id,
                             priority: parsed.priority,
-                            radarItemId: parsed.radar_item_id,
+                            radarItemId: radarItemIdFilter,
                             createdById: parsed.created_by_id,
                             updatedById: parsed.updated_by_id,
                             sortBy: parsed.sort_by,
@@ -1999,8 +2037,11 @@ class WolfpackMCPServer {
                             fields.status = parsed.status;
                         if (parsed.leading_user_id !== undefined)
                             fields.leadingUserId = parsed.leading_user_id;
-                        if (parsed.radar_item_id !== undefined)
-                            fields.radarItemId = parsed.radar_item_id;
+                        if (parsed.radar_item_id !== undefined) {
+                            fields.radarItemId = parsed.radar_item_id
+                                ? await resolveRadarItemId(this.client, parsed.radar_item_id, teamSlug)
+                                : null;
+                        }
                         if (parsed.category_id !== undefined)
                             fields.categoryId = parsed.category_id;
                         if (parsed.priority !== undefined)
@@ -2013,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);
@@ -2061,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');
@@ -2222,6 +2263,10 @@ class WolfpackMCPServer {
                     // Create/Update handlers
                     case 'create_work_item': {
                         const parsed = CreateWorkItemSchema.parse(args);
+                        const teamSlug = parsed.project_slug || this.client.getProjectSlug() || undefined;
+                        const radarItemId = parsed.radar_item_id
+                            ? await resolveRadarItemId(this.client, parsed.radar_item_id, teamSlug)
+                            : undefined;
                         const workItem = await this.client.createWorkItem({
                             title: parsed.title,
                             description: parsed.description,
@@ -2230,8 +2275,8 @@ class WolfpackMCPServer {
                             size: parsed.size,
                             leadingUserId: parsed.leading_user_id,
                             categoryId: parsed.category_id,
-                            radarItemId: parsed.radar_item_id,
-                            teamSlug: parsed.project_slug || this.client.getProjectSlug() || undefined,
+                            radarItemId,
+                            teamSlug,
                         });
                         return {
                             content: [
@@ -2537,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));
                         }
@@ -2552,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: [
@@ -2572,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/dist/procedureTools.js

@@ -3,11 +3,37 @@
  * Enables agents to list, view, create, update, and delete procedures.
  */
 import { z } from 'zod';
+const FORM_FIELD_ITEM_SCHEMA = {
+    type: 'object',
+    properties: {
+        name: { type: 'string' },
+        label: { type: 'string' },
+        type: {
+            type: 'string',
+            enum: ['text', 'number', 'boolean', 'choice', 'date', 'json'],
+        },
+        required: { type: 'boolean' },
+        options: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    value: { type: 'string' },
+                    label: { type: 'string' },
+                },
+                required: ['value', 'label'],
+            },
+        },
+        multiline: { type: 'boolean' },
+    },
+    required: ['name', 'label', 'type', 'required'],
+};
 export const PROCEDURE_TOOLS = [
     {
         name: 'list_procedures',
-        description: 'List procedures in a project. Returns name, status, version, tags, and case count. ' +
-            'Use get_procedure to see the full workflow definition.',
+        description: 'List procedures in a project. Returns name, status, version, tags, case count, and hasForm ' +
+            '(true when the procedure declares an input form that must be provided at start_case time). ' +
+            'Use get_procedure to see the full workflow definition and form schema.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -24,10 +50,12 @@ export const PROCEDURE_TOOLS = [
     },
     {
         name: 'get_procedure',
-        description: 'Get full details of a procedure including its workflow definition (nodes and edges). ' +
-            'The definition uses a graph format: nodes have id, type (start/end/activity/decision/loop/parallel/wait), ' +
-            'position, and data; edges connect nodes via source/target IDs. ' +
-            'Accepts UUID or refId (requires project_slug for refId).',
+        description: 'Get full details of a procedure including its workflow definition (nodes and edges) and its ' +
+            'optional input form (formDefinition). The definition uses a graph format: nodes have id, type ' +
+            '(start/end/activity/decision/loop/parallel/wait), position, and data; edges connect nodes via ' +
+            'source/target IDs. The formDefinition lists input fields (name, label, type, required, options, ' +
+            'multiline) validated at start_case time — inspect it before calling start_case so you know which ' +
+            'form_values to supply. Accepts UUID or refId (requires project_slug for refId).',
         inputSchema: {
             type: 'object',
             properties: {
@@ -48,7 +76,8 @@ export const PROCEDURE_TOOLS = [
         description: 'Create a new procedure. If no definition is provided, creates a default start→end workflow. ' +
             'The definition is a graph with nodes and edges. Node types: start, end, activity, decision, loop, parallel, wait. ' +
             'Each node needs id, type, position ({x, y}), and data (type-specific config). ' +
-            'Edges connect nodes: {id, source, target}. The procedure starts as inactive (isActive=false).',
+            'Edges connect nodes: {id, source, target}. Optionally provide form_definition to declare inputs ' +
+            'collected each time the procedure is started. The procedure starts as inactive (isActive=false).',
         inputSchema: {
             type: 'object',
             properties: {
@@ -58,6 +87,11 @@ export const PROCEDURE_TOOLS = [
                     type: 'object',
                     description: 'Workflow definition: { nodes: [{id, type, position: {x, y}, data: {...}}], edges: [{id, source, target}] }',
                 },
+                form_definition: {
+                    type: ['array', 'null'],
+                    description: 'Input form: array of {name, label, type, required, options?, multiline?}. Types: text, number, boolean, choice, date, json. Required fields must be supplied when start_case runs. Scheduled runs ignore the form.',
+                    items: FORM_FIELD_ITEM_SCHEMA,
+                },
                 tags: {
                     type: 'array',
                     items: { type: 'string' },
@@ -76,6 +110,7 @@ export const PROCEDURE_TOOLS = [
         description: 'Update a procedure. Only provide the fields you want to change. ' +
             'Updating the definition auto-increments the version number. ' +
             'Set isActive to true/false to activate/deactivate the procedure. ' +
+            'Pass form_definition to replace the input form (or null to remove it). ' +
             'Accepts UUID or refId (requires project_slug for refId).',
         inputSchema: {
             type: 'object',
@@ -97,6 +132,11 @@ export const PROCEDURE_TOOLS = [
                     type: 'object',
                     description: 'Updated workflow definition: { nodes: [...], edges: [...] }. Changes increment version.',
                 },
+                form_definition: {
+                    type: ['array', 'null'],
+                    description: 'Replace the input form. Same shape as create_procedure.form_definition. Pass null to remove the form entirely.',
+                    items: FORM_FIELD_ITEM_SCHEMA,
+                },
                 is_active: { type: 'boolean', description: 'Activate or deactivate the procedure' },
                 tags: {
                     type: 'array',
@@ -111,6 +151,45 @@ export const PROCEDURE_TOOLS = [
             required: ['procedure_id'],
         },
     },
+    {
+        name: 'start_case',
+        description: 'Start a new case by running an active procedure. If the procedure has a form_definition ' +
+            '(see get_procedure), supply form_values: an object keyed by each field.name. Required fields ' +
+            'must be present; values are type-checked and unknown keys are dropped server-side. Returns the ' +
+            'caseId and refId of the new case. Scheduled procedures cannot be started this way — they fire ' +
+            'on their schedule.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                procedure_id: {
+                    type: 'string',
+                    description: 'Procedure UUID or refId number',
+                },
+                title: {
+                    type: 'string',
+                    description: 'Case title (defaults to the procedure name)',
+                },
+                priority: {
+                    type: 'number',
+                    description: 'Priority: 0 (none), 1 (low), 2 (medium), 3 (high), 4 (urgent)',
+                },
+                additional_information: {
+                    type: 'string',
+                    description: 'Free-text context displayed on the case detail page',
+                },
+                form_values: {
+                    type: 'object',
+                    description: "Input values keyed by field name, matching the procedure's form_definition. Validated server-side: missing required fields → 400; wrong types → 400; unknown keys silently dropped.",
+                    additionalProperties: true,
+                },
+                project_slug: {
+                    type: 'string',
+                    description: 'Project slug (required when using refId)',
+                },
+            },
+            required: ['procedure_id'],
+        },
+    },
 ];
 export async function handleProcedureTool(name, args, client) {
     const text = (t) => JSON.stringify(t, null, 2);
@@ -152,6 +231,7 @@ export async function handleProcedureTool(name, args, client) {
                 name: z.string(),
                 description: z.string().optional(),
                 definition: z.preprocess((v) => (typeof v === 'string' ? JSON.parse(v) : v), z.any().optional()),
+                form_definition: z.preprocess((v) => (typeof v === 'string' ? JSON.parse(v) : v), z.any().optional()),
                 tags: z.array(z.string()).optional(),
                 project_slug: z.string().optional(),
             })
@@ -160,6 +240,7 @@ export async function handleProcedureTool(name, args, client) {
                 name: parsed.name,
                 description: parsed.description,
                 definition: parsed.definition,
+                formDefinition: parsed.form_definition,
                 tags: parsed.tags,
                 teamSlug: parsed.project_slug,
             });
@@ -180,15 +261,18 @@ export async function handleProcedureTool(name, args, client) {
                 description: z.string().nullable().optional(),
                 information: z.string().nullable().optional(),
                 definition: z.preprocess((v) => (typeof v === 'string' ? JSON.parse(v) : v), z.any().optional()),
+                form_definition: z.preprocess((v) => (typeof v === 'string' ? JSON.parse(v) : v), z.any().optional()),
                 is_active: z.preprocess((v) => (typeof v === 'string' ? v === 'true' : v), z.boolean().optional()),
                 tags: z.array(z.string()).optional(),
                 project_slug: z.string().optional(),
             })
                 .parse(args);
-            const { procedure_id, project_slug, is_active, ...rest } = parsed;
+            const { procedure_id, project_slug, is_active, form_definition, ...rest } = parsed;
             const data = { ...rest };
             if (is_active !== undefined)
                 data.isActive = is_active;
+            if (form_definition !== undefined)
+                data.formDefinition = form_definition;
             const procedure = await client.updateProcedure(procedure_id, data, project_slug);
             return {
                 content: [
@@ -199,6 +283,33 @@ export async function handleProcedureTool(name, args, client) {
                 ],
             };
         }
+        case 'start_case': {
+            const parsed = z
+                .object({
+                procedure_id: z.string(),
+                title: z.string().optional(),
+                priority: z.coerce.number().optional(),
+                additional_information: z.string().optional(),
+                form_values: z.preprocess((v) => (typeof v === 'string' ? JSON.parse(v) : v), z.record(z.unknown()).optional()),
+                project_slug: z.string().optional(),
+            })
+                .parse(args);
+            const result = await client.startCase(parsed.procedure_id, {
+                title: parsed.title,
+                priority: parsed.priority,
+                additionalInformation: parsed.additional_information,
+                formValues: parsed.form_values,
+                teamSlug: parsed.project_slug,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Started case #${result.refId} (${result.caseId})\n\n${text(result)}`,
+                    },
+                ],
+            };
+        }
         default:
             return {
                 content: [{ type: 'text', text: `Unknown procedure tool: ${name}` }],

package/dist/resolveRadarItemId.js

@@ -0,0 +1,22 @@
+// UUID format check — hyphenated 36-char hex; version nibble unconstrained to stay tolerant.
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+// Accept "#r5", "#roadmap-5", "#5", or plain "5" — capture the numeric refId.
+const RADAR_REF_PATTERN = /^#?(?:r|roadmap-)?(\d+)$/i;
+// Resolve a user-supplied radar item reference (UUID, refId, or prefixed refId) to a UUID.
+// stripUuids hides internal UUIDs from agents in responses, so agents pass refIds; the
+// work-item create/update/filter endpoints require a UUID, so we translate at the MCP boundary.
+export async function resolveRadarItemId(client, input, teamSlug) {
+    const trimmed = input.trim();
+    if (UUID_PATTERN.test(trimmed))
+        return trimmed;
+    const refMatch = trimmed.match(RADAR_REF_PATTERN);
+    if (!refMatch) {
+        throw new Error(`Invalid radar_item_id "${input}": expected a UUID, refId number, or prefixed refId like "#r5".`);
+    }
+    const refId = refMatch[1];
+    const radarItem = await client.getRadarItem(refId, teamSlug);
+    if (!radarItem) {
+        throw new Error(`Radar/initiative item #r${refId} not found.`);
+    }
+    return radarItem.id;
+}

package/dist/resolveRadarItemId.test.js

@@ -0,0 +1,31 @@
+import { describe, it, expect, vi } from 'vitest';
+import { resolveRadarItemId } from './resolveRadarItemId.js';
+const UUID = '11111111-2222-4333-8444-555555555555';
+function makeClient(item) {
+    return {
+        getRadarItem: vi.fn(async () => item),
+    };
+}
+describe('resolveRadarItemId', () => {
+    it('passes UUIDs through without lookup', async () => {
+        const client = makeClient(null);
+        const result = await resolveRadarItemId(client, UUID);
+        expect(result).toBe(UUID);
+        expect(client.getRadarItem).not.toHaveBeenCalled();
+    });
+    it.each(['5', '#5', '#r5', '#roadmap-5', '  5  '])('resolves refId form %s to UUID via getRadarItem', async (input) => {
+        const client = makeClient({ id: UUID, refId: 5 });
+        const result = await resolveRadarItemId(client, input, 'my-team');
+        expect(result).toBe(UUID);
+        expect(client.getRadarItem).toHaveBeenCalledWith('5', 'my-team');
+    });
+    it('throws when refId cannot be resolved', async () => {
+        const client = makeClient(null);
+        await expect(resolveRadarItemId(client, '#r99')).rejects.toThrow(/#r99 not found/);
+    });
+    it('rejects malformed input', async () => {
+        const client = makeClient(null);
+        await expect(resolveRadarItemId(client, 'not-a-ref')).rejects.toThrow(/Invalid radar_item_id/);
+        expect(client.getRadarItem).not.toHaveBeenCalled();
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wolfpack-mcp",
-  "version": "1.0.59",
+  "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;
-}