wolfpack-mcp 1.0.99 → 1.0.101

package/dist/procedureTools.js

@@ -1,274 +1,8 @@
 /**
- * Procedure MCP tool definitions and handlers.
- * Enables agents to list, view, create, update, and delete procedures.
+ * Procedure MCP tool handlers. The tool definitions are declared once, for both
+ * transports, in `toolCatalogue.ts`.
  */
 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'],
-};
-const DEFINITION_DESCRIPTION = 'Workflow definition: { nodes: [{id, type, position: {x, y}, data: {...}}], edges: [{id, source, target}] }. ' +
-    'An activity node needs data.activityType (task, createWorkItem, sendNotification, httpRequest, createCase, ' +
-    'setVariable, createPage, createJournalEntry, llmPrompt, jsonata, agentTask, runContainer), data.label, and ' +
-    "data.config holding that type's settings — the step body belongs in data.config.description, not data.description. " +
-    'Use activityType "task" for a step a person just reads and ticks off.';
-export const PROCEDURE_TOOLS = [
-    {
-        name: 'list_procedures',
-        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: {
-                project_slug: {
-                    type: 'string',
-                    description: 'Project slug (required for multi-project users)',
-                },
-                search: { type: 'string', description: 'Search in name and description' },
-                active_only: { type: 'boolean', description: 'Only return active procedures' },
-                limit: { type: 'number', description: 'Maximum procedures to return' },
-                offset: { type: 'number', description: 'Procedures to skip for pagination' },
-            },
-        },
-    },
-    {
-        name: 'get_procedure',
-        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: {
-                procedure_id: {
-                    type: 'string',
-                    description: 'Procedure UUID or refId number',
-                },
-                project_slug: {
-                    type: 'string',
-                    description: 'Project slug (required when using refId)',
-                },
-            },
-            required: ['procedure_id'],
-        },
-    },
-    {
-        name: 'create_procedure',
-        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}. 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: {
-                name: { type: 'string', description: 'Procedure name (unique per project)' },
-                description: { type: 'string', description: 'Short description' },
-                definition: {
-                    type: 'object',
-                    description: DEFINITION_DESCRIPTION,
-                },
-                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' },
-                    description: 'Tags for categorization',
-                },
-                project_slug: {
-                    type: 'string',
-                    description: 'Project slug (required for multi-project users)',
-                },
-            },
-            required: ['name'],
-        },
-    },
-    {
-        name: 'update_procedure',
-        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',
-            properties: {
-                procedure_id: {
-                    type: 'string',
-                    description: 'Procedure UUID or refId number',
-                },
-                name: { type: 'string', description: 'Updated name' },
-                description: {
-                    type: ['string', 'null'],
-                    description: 'Updated description (null to clear)',
-                },
-                information: {
-                    type: ['string', 'null'],
-                    description: 'Extended documentation/guide (null to clear)',
-                },
-                definition: {
-                    type: 'object',
-                    description: `Updated definition — changes increment version. ${DEFINITION_DESCRIPTION}`,
-                },
-                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',
-                    items: { type: 'string' },
-                    description: 'Updated tags (replaces existing)',
-                },
-                project_slug: {
-                    type: 'string',
-                    description: 'Project slug (required when using refId)',
-                },
-            },
-            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'],
-        },
-    },
-    {
-        name: 'list_cases',
-        description: 'List cases, newest first, optionally filtered to one procedure and/or one status ' +
-            '(running, paused, completed, failed, cancelled). Each case shows the procedure version it ' +
-            'runs and `behind: true` when the procedure has since been edited — a running case that is ' +
-            'behind can be moved on with upgrade_case.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                procedure_id: {
-                    type: 'string',
-                    description: 'Only cases of this procedure (UUID or refId number)',
-                },
-                status: {
-                    type: 'string',
-                    description: 'Only cases in this status, e.g. "running"',
-                },
-                project_slug: {
-                    type: 'string',
-                    description: 'Project slug (required when using a refId, or with access to several projects)',
-                },
-            },
-        },
-    },
-    {
-        name: 'upgrade_case',
-        description: 'Move a running (or paused) case onto the latest version of its procedure. The case resumes ' +
-            'at the node it is waiting at, keeping its variables and earlier activity outputs; nothing ' +
-            'before that node runs again. Refused — with the reason — when the case is not running, is ' +
-            'already on the current version, or its current node id is not in the new version — then pass ' +
-            'resume_node_id to choose the node of the new version it should continue from (see ' +
-            'get_procedure for the node ids), or cancel the case and start the procedure again from the ' +
-            'work item.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                case_id: {
-                    type: 'string',
-                    description: 'Case UUID or refId number',
-                },
-                resume_node_id: {
-                    type: 'string',
-                    description: 'Node id of the new version to resume at. Defaults to the node the case is waiting at; ' +
-                        'required when that node no longer exists in the new version.',
-                },
-                project_slug: {
-                    type: 'string',
-                    description: 'Project slug (required when using refId)',
-                },
-            },
-            required: ['case_id'],
-        },
-    },
-    {
-        name: 'upgrade_procedure_cases',
-        description: 'Upgrade every running case of a procedure that is still on an older version onto the ' +
-            'current one (see upgrade_case). Cases are upgraded one at a time; the result lists the cases ' +
-            'upgraded and, for each case skipped, why.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                procedure_id: {
-                    type: 'string',
-                    description: 'Procedure UUID or refId number',
-                },
-                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);
     switch (name) {
@@ -369,6 +103,7 @@ export async function handleProcedureTool(name, args, client) {
                 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()),
+                work_item_id: z.string().optional(),
                 project_slug: z.string().optional(),
             })
                 .parse(args);
@@ -377,6 +112,7 @@ export async function handleProcedureTool(name, args, client) {
                 priority: parsed.priority,
                 additionalInformation: parsed.additional_information,
                 formValues: parsed.form_values,
+                workItemId: parsed.work_item_id,
                 teamSlug: parsed.project_slug,
             });
             return {