wolfpack-mcp 1.0.59 → 1.0.60

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

@@ -767,8 +767,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 +826,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()
@@ -288,7 +292,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
@@ -708,7 +715,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',
@@ -822,7 +830,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'],
@@ -1145,7 +1153,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'],
@@ -1924,14 +1932,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 +2012,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)
@@ -2222,6 +2238,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 +2250,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: [

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.60",
   "description": "MCP server for Wolfpack AI-enhanced software delivery tools",
   "main": "dist/index.js",
   "type": "module",