wolfpack-mcp 1.0.47 → 1.0.49

package/dist/agentBuilderTools.js

@@ -0,0 +1,797 @@
+/**
+ * Agent builder MCP tool definitions and handlers.
+ * Registered only when the API key has the `agent_builder` capability.
+ */
+import { z } from 'zod';
+export const AGENT_BUILDER_TOOLS = [
+    // ─── Group 1: Agent CRUD ─────────────────────────────────────────────────
+    {
+        name: 'list_agents',
+        description: 'List all agents in the organisation. Returns name, status, template, and assigned projects.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'get_agent',
+        description: 'Get full details for an agent including config, instructions, LLM model, and linked skills.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+            },
+            required: ['agent_id'],
+        },
+    },
+    {
+        name: 'create_agent',
+        description: 'Create a new agent from a template. Use list_agent_templates to see available templates.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                template_id: { type: 'string', description: 'Template ID to create the agent from' },
+                name: { type: 'string', description: 'Display name for the agent' },
+                config: { type: 'object', description: 'Optional agent-specific configuration' },
+            },
+            required: ['template_id', 'name'],
+        },
+    },
+    {
+        name: 'update_agent',
+        description: "Update an agent's config, instructions, or LLM model. Omit fields to leave them unchanged.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+                name: { type: 'string', description: 'Updated display name' },
+                instructions: {
+                    type: 'string',
+                    description: 'Agent-specific instructions (supplements template instructions). Set to null to clear.',
+                },
+                llm_provider: {
+                    type: 'string',
+                    description: 'LLM provider ID (e.g. "anthropic"). Set to null for default.',
+                },
+                llm_model: {
+                    type: 'string',
+                    description: 'LLM model ID (e.g. "claude-sonnet-4-6"). Set to null for family auto-select.',
+                },
+                llm_family: {
+                    type: 'string',
+                    description: 'LLM model family (e.g. "sonnet"). Agent auto-upgrades to latest in family.',
+                },
+                scheduling_enabled: { type: 'boolean', description: 'Whether scheduled tasks are enabled' },
+            },
+            required: ['agent_id'],
+        },
+    },
+    // ─── Group 2: Project Assignment ─────────────────────────────────────────
+    {
+        name: 'list_agent_projects',
+        description: 'List projects assigned to an agent.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+            },
+            required: ['agent_id'],
+        },
+    },
+    {
+        name: 'assign_agent_to_project',
+        description: 'Assign an agent to a project by slug.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+                project_slug: { type: 'string', description: 'Project slug to assign the agent to' },
+            },
+            required: ['agent_id', 'project_slug'],
+        },
+    },
+    {
+        name: 'remove_agent_from_project',
+        description: 'Remove an agent from a project.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+                project_slug: { type: 'string', description: 'Project slug to remove the agent from' },
+            },
+            required: ['agent_id', 'project_slug'],
+        },
+    },
+    // ─── Group 3: Sessions ────────────────────────────────────────────────────
+    {
+        name: 'list_agent_sessions',
+        description: 'List sessions for an agent. Filter by status: running, stopped, failed.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+                status: {
+                    type: 'string',
+                    enum: ['pending', 'starting', 'running', 'stopping', 'stopped', 'failed'],
+                    description: 'Filter by session status',
+                },
+                limit: { type: 'number', description: 'Maximum sessions to return' },
+                offset: { type: 'number', description: 'Sessions to skip for pagination' },
+            },
+            required: ['agent_id'],
+        },
+    },
+    {
+        name: 'get_agent_session',
+        description: 'Get session metadata and recent events (last 20). Does NOT include full conversation — use get_agent_session_conversation for that.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+                session_id: { type: 'string', description: 'Session ID' },
+            },
+            required: ['agent_id', 'session_id'],
+        },
+    },
+    {
+        name: 'get_agent_session_conversation',
+        description: 'Get the full conversation history for a session (paginated). Can be large for long-running sessions.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+                session_id: { type: 'string', description: 'Session ID' },
+                limit: { type: 'number', description: 'Turns to return' },
+                offset: { type: 'number', description: 'Turns to skip' },
+            },
+            required: ['agent_id', 'session_id'],
+        },
+    },
+    {
+        name: 'run_agent',
+        description: 'Queue an ad-hoc session with an inline prompt. This is async — it returns a queue entry ID immediately. ' +
+            'Use list_agent_queue or list_agent_sessions to track progress.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+                prompt: { type: 'string', description: 'What the agent should do' },
+                project_slug: { type: 'string', description: 'Project to scope the session to (optional)' },
+            },
+            required: ['agent_id', 'prompt'],
+        },
+    },
+    {
+        name: 'stop_agent_session',
+        description: 'Stop a running agent session.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+                session_id: { type: 'string', description: 'Session ID to stop' },
+            },
+            required: ['agent_id', 'session_id'],
+        },
+    },
+    {
+        name: 'resume_agent_session',
+        description: 'Resume a completed session with a follow-up prompt. The agent continues with full prior context.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+                session_id: { type: 'string', description: 'Completed session ID to resume' },
+                prompt: { type: 'string', description: 'Follow-up prompt for the agent' },
+            },
+            required: ['agent_id', 'session_id', 'prompt'],
+        },
+    },
+    // ─── Group 4: Tasks & Queue ───────────────────────────────────────────────
+    {
+        name: 'list_agent_tasks',
+        description: 'List defined tasks for an agent.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+            },
+            required: ['agent_id'],
+        },
+    },
+    {
+        name: 'get_agent_task',
+        description: 'Get details of a specific agent task.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+                task_id: { type: 'string', description: 'Task ID' },
+            },
+            required: ['agent_id', 'task_id'],
+        },
+    },
+    {
+        name: 'create_agent_task',
+        description: 'Create a new task for an agent.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+                name: { type: 'string', description: 'Task name' },
+                prompt: { type: 'string', description: 'What the agent should do when this task runs' },
+                scheduled_enabled: {
+                    type: 'boolean',
+                    description: 'Whether this task is included in scheduled runs (default false)',
+                },
+                sort_order: {
+                    type: 'number',
+                    description: 'Order within scheduled batch (lower = first)',
+                },
+            },
+            required: ['agent_id', 'name', 'prompt'],
+        },
+    },
+    {
+        name: 'update_agent_task',
+        description: "Update a task's prompt or schedule settings.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+                task_id: { type: 'string', description: 'Task ID' },
+                name: { type: 'string', description: 'Updated task name' },
+                prompt: { type: 'string', description: 'Updated prompt' },
+                scheduled_enabled: { type: 'boolean', description: 'Include in scheduled runs' },
+                sort_order: { type: 'number', description: 'Order within scheduled batch' },
+                is_active: { type: 'boolean', description: 'Whether this task is active' },
+            },
+            required: ['agent_id', 'task_id'],
+        },
+    },
+    {
+        name: 'run_agent_task',
+        description: 'Queue a saved task for immediate execution. Async — returns a queue entry ID. ' +
+            'Use list_agent_queue to track progress.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+                task_id: { type: 'string', description: 'Task ID to run' },
+                project_slug: { type: 'string', description: 'Project to scope the session to (optional)' },
+            },
+            required: ['agent_id', 'task_id'],
+        },
+    },
+    {
+        name: 'list_agent_queue',
+        description: 'List queue entries for an agent. Use this to track progress after run_agent or run_agent_task.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+                status: {
+                    type: 'string',
+                    enum: ['queued', 'running', 'completed', 'failed', 'cancelled'],
+                    description: 'Filter by queue entry status',
+                },
+            },
+            required: ['agent_id'],
+        },
+    },
+    {
+        name: 'cancel_queue_entry',
+        description: 'Cancel a queued (not yet running) queue entry.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+                entry_id: { type: 'string', description: 'Queue entry ID to cancel' },
+            },
+            required: ['agent_id', 'entry_id'],
+        },
+    },
+    // ─── Group 5: Skills (authoring) ─────────────────────────────────────────
+    {
+        name: 'create_skill',
+        description: 'Create a new org-level skill. Skills are reusable capability packs agents can load on demand.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    description: 'Skill name (lowercase letters, numbers, hyphens only, e.g. "deploy-app")',
+                },
+                description: {
+                    type: 'string',
+                    description: 'What the skill does and when to use it (max 1024 chars)',
+                },
+                content: {
+                    type: 'string',
+                    description: 'Instruction body in markdown',
+                },
+            },
+            required: ['name', 'description', 'content'],
+        },
+    },
+    {
+        name: 'update_skill',
+        description: "Update a skill's instructions or description.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                skill_id: { type: 'string', description: 'Skill ID (UUID)' },
+                name: { type: 'string', description: 'Updated skill name' },
+                description: { type: 'string', description: 'Updated description' },
+                content: { type: 'string', description: 'Updated instruction body' },
+            },
+            required: ['skill_id'],
+        },
+    },
+    {
+        name: 'create_skill_resource',
+        description: 'Add a text resource to a skill (script, reference, or asset).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                skill_id: { type: 'string', description: 'Skill ID (UUID)' },
+                type: {
+                    type: 'string',
+                    enum: ['script', 'reference', 'asset'],
+                    description: 'Resource type',
+                },
+                name: { type: 'string', description: 'Resource filename' },
+                content: { type: 'string', description: 'Resource text content' },
+                mime_type: { type: 'string', description: 'MIME type (optional)' },
+            },
+            required: ['skill_id', 'type', 'name', 'content'],
+        },
+    },
+    {
+        name: 'update_skill_resource',
+        description: "Update a skill resource's content.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                skill_id: { type: 'string', description: 'Skill ID (UUID)' },
+                resource_id: { type: 'string', description: 'Resource ID (UUID)' },
+                name: { type: 'string', description: 'Updated filename' },
+                content: { type: 'string', description: 'Updated text content' },
+                mime_type: { type: 'string', description: 'Updated MIME type' },
+            },
+            required: ['skill_id', 'resource_id'],
+        },
+    },
+    {
+        name: 'set_agent_skills',
+        description: 'Replace the full set of skills assigned to an agent. ' +
+            'Use list_org_skills to find skill IDs, then pass all desired skill IDs here.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+                skill_ids: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Array of skill IDs to assign (replaces all current assignments)',
+                },
+            },
+            required: ['agent_id', 'skill_ids'],
+        },
+    },
+    // ─── Group 5b: Skills (reading org library) ──────────────────────────────
+    {
+        name: 'list_org_skills',
+        description: 'List all skills in the org skill library (org-level + system-level). ' +
+            'Returns ID, name, description, and whether the skill is built-in. ' +
+            'Use skill IDs with set_agent_skills to assign skills to an agent.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'get_org_skill',
+        description: 'Get the full content of an org-level skill by name. ' +
+            'Returns instructions, metadata, and a list of attached resources.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                skill_name: {
+                    type: 'string',
+                    description: 'The name of the skill to load (e.g. "deploy-app")',
+                },
+            },
+            required: ['skill_name'],
+        },
+    },
+    // ─── Group 6: Secrets ─────────────────────────────────────────────────────
+    {
+        name: 'list_agent_secrets',
+        description: 'List secret names for an agent. Values are never returned.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+            },
+            required: ['agent_id'],
+        },
+    },
+    {
+        name: 'set_agent_secret',
+        description: 'Create or update a secret for an agent. ' +
+            'Name must be uppercase letters, digits, and underscores (e.g. MY_API_KEY).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent profile ID' },
+                name: { type: 'string', description: 'Secret name (e.g. MY_API_KEY)' },
+                value: { type: 'string', description: 'Secret value (encrypted at rest)' },
+            },
+            required: ['agent_id', 'name', 'value'],
+        },
+    },
+    // ─── Group 7: Discovery ───────────────────────────────────────────────────
+    {
+        name: 'list_agent_templates',
+        description: 'List agent templates available to the organisation. Use template IDs when calling create_agent.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'list_llm_models',
+        description: 'List LLM providers and models available to the organisation. ' +
+            'Use provider and model IDs when calling create_agent or update_agent.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+];
+// Zod schemas for argument parsing
+const AgentIdSchema = z.object({ agent_id: z.string() });
+const AgentSessionSchema = z.object({ agent_id: z.string(), session_id: z.string() });
+const AgentTaskSchema = z.object({ agent_id: z.string(), task_id: z.string() });
+const SkillIdSchema = z.object({ skill_id: z.string() });
+export async function handleAgentBuilderTool(name, args, client) {
+    const text = (t) => JSON.stringify(t, null, 2);
+    switch (name) {
+        // ─── Agent CRUD ────────────────────────────────────────────────────────
+        case 'list_agents': {
+            const agents = await client.listAgents();
+            return { content: [{ type: 'text', text: text(agents) }] };
+        }
+        case 'get_agent': {
+            const { agent_id } = AgentIdSchema.parse(args);
+            const agent = await client.getAgent(agent_id);
+            if (!agent)
+                return { content: [{ type: 'text', text: 'Agent not found' }] };
+            return { content: [{ type: 'text', text: text(agent) }] };
+        }
+        case 'create_agent': {
+            const parsed = z
+                .object({
+                template_id: z.string(),
+                name: z.string(),
+                config: z.record(z.unknown()).optional(),
+            })
+                .parse(args);
+            const agent = await client.createAgent({
+                templateId: parsed.template_id,
+                name: parsed.name,
+                config: parsed.config,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Created agent "${agent.user?.comment || agent.userId}"\n\n${text(agent)}`,
+                    },
+                ],
+            };
+        }
+        case 'update_agent': {
+            const parsed = z
+                .object({
+                agent_id: z.string(),
+                name: z.string().optional(),
+                instructions: z.string().nullable().optional(),
+                llm_provider: z.string().nullable().optional(),
+                llm_model: z.string().nullable().optional(),
+                llm_family: z.string().nullable().optional(),
+                scheduling_enabled: z.boolean().optional(),
+            })
+                .parse(args);
+            const { agent_id, ...rest } = parsed;
+            const fields = {};
+            if (rest.name !== undefined)
+                fields.name = rest.name;
+            if (rest.instructions !== undefined)
+                fields.instructions = rest.instructions;
+            if (rest.llm_provider !== undefined)
+                fields.llmProvider = rest.llm_provider;
+            if (rest.llm_model !== undefined)
+                fields.llmModel = rest.llm_model;
+            if (rest.llm_family !== undefined)
+                fields.llmFamily = rest.llm_family;
+            if (rest.scheduling_enabled !== undefined)
+                fields.schedulingEnabled = rest.scheduling_enabled;
+            const agent = await client.updateAgent(agent_id, fields);
+            return { content: [{ type: 'text', text: `Updated agent\n\n${text(agent)}` }] };
+        }
+        // ─── Project Assignment ─────────────────────────────────────────────────
+        case 'list_agent_projects': {
+            const { agent_id } = AgentIdSchema.parse(args);
+            const projects = await client.listAgentProjects(agent_id);
+            return { content: [{ type: 'text', text: text(projects) }] };
+        }
+        case 'assign_agent_to_project': {
+            const parsed = z.object({ agent_id: z.string(), project_slug: z.string() }).parse(args);
+            await client.assignAgentToProject(parsed.agent_id, parsed.project_slug);
+            return {
+                content: [{ type: 'text', text: `Assigned agent to project "${parsed.project_slug}"` }],
+            };
+        }
+        case 'remove_agent_from_project': {
+            const parsed = z.object({ agent_id: z.string(), project_slug: z.string() }).parse(args);
+            await client.removeAgentFromProject(parsed.agent_id, parsed.project_slug);
+            return {
+                content: [{ type: 'text', text: `Removed agent from project "${parsed.project_slug}"` }],
+            };
+        }
+        // ─── Sessions ───────────────────────────────────────────────────────────
+        case 'list_agent_sessions': {
+            const parsed = z
+                .object({
+                agent_id: z.string(),
+                status: z.string().optional(),
+                limit: z.number().optional(),
+                offset: z.number().optional(),
+            })
+                .parse(args);
+            const sessions = await client.listAgentSessions(parsed.agent_id, {
+                status: parsed.status,
+                limit: parsed.limit,
+                offset: parsed.offset,
+            });
+            return { content: [{ type: 'text', text: text(sessions) }] };
+        }
+        case 'get_agent_session': {
+            const { agent_id, session_id } = AgentSessionSchema.parse(args);
+            const session = await client.getAgentSession(agent_id, session_id);
+            if (!session)
+                return { content: [{ type: 'text', text: 'Session not found' }] };
+            return { content: [{ type: 'text', text: text(session) }] };
+        }
+        case 'get_agent_session_conversation': {
+            const parsed = z
+                .object({
+                agent_id: z.string(),
+                session_id: z.string(),
+                limit: z.number().optional(),
+                offset: z.number().optional(),
+            })
+                .parse(args);
+            const conv = await client.getAgentSessionConversation(parsed.agent_id, parsed.session_id, {
+                limit: parsed.limit,
+                offset: parsed.offset,
+            });
+            return { content: [{ type: 'text', text: text(conv) }] };
+        }
+        case 'run_agent': {
+            const parsed = z
+                .object({ agent_id: z.string(), prompt: z.string(), project_slug: z.string().optional() })
+                .parse(args);
+            const result = await client.runAgent(parsed.agent_id, parsed.prompt, parsed.project_slug);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Queued session (entry ID: ${result.entryId}, position: ${result.position}, executing: ${result.executing})\n\nUse list_agent_queue or list_agent_sessions to track progress.`,
+                    },
+                ],
+            };
+        }
+        case 'stop_agent_session': {
+            const { agent_id, session_id } = AgentSessionSchema.parse(args);
+            const session = await client.stopAgentSession(agent_id, session_id);
+            return {
+                content: [
+                    { type: 'text', text: `Stopped session (status: ${session.status})\n\n${text(session)}` },
+                ],
+            };
+        }
+        case 'resume_agent_session': {
+            const parsed = z
+                .object({ agent_id: z.string(), session_id: z.string(), prompt: z.string() })
+                .parse(args);
+            const session = await client.resumeAgentSession(parsed.agent_id, parsed.session_id, parsed.prompt);
+            return { content: [{ type: 'text', text: `Resumed session\n\n${text(session)}` }] };
+        }
+        // ─── Tasks ──────────────────────────────────────────────────────────────
+        case 'list_agent_tasks': {
+            const { agent_id } = AgentIdSchema.parse(args);
+            const tasks = await client.listAgentTasks(agent_id);
+            return { content: [{ type: 'text', text: text(tasks) }] };
+        }
+        case 'get_agent_task': {
+            const { agent_id, task_id } = AgentTaskSchema.parse(args);
+            const task = await client.getAgentTask(agent_id, task_id);
+            if (!task)
+                return { content: [{ type: 'text', text: 'Task not found' }] };
+            return { content: [{ type: 'text', text: text(task) }] };
+        }
+        case 'create_agent_task': {
+            const parsed = z
+                .object({
+                agent_id: z.string(),
+                name: z.string(),
+                prompt: z.string(),
+                scheduled_enabled: z.boolean().optional(),
+                sort_order: z.number().optional(),
+            })
+                .parse(args);
+            const task = await client.createAgentTask(parsed.agent_id, {
+                name: parsed.name,
+                prompt: parsed.prompt,
+                scheduledEnabled: parsed.scheduled_enabled,
+                sortOrder: parsed.sort_order,
+            });
+            return { content: [{ type: 'text', text: `Created task "${task.name}"\n\n${text(task)}` }] };
+        }
+        case 'update_agent_task': {
+            const parsed = z
+                .object({
+                agent_id: z.string(),
+                task_id: z.string(),
+                name: z.string().optional(),
+                prompt: z.string().optional(),
+                scheduled_enabled: z.boolean().optional(),
+                sort_order: z.number().optional(),
+                is_active: z.boolean().optional(),
+            })
+                .parse(args);
+            const fields = {};
+            if (parsed.name !== undefined)
+                fields.name = parsed.name;
+            if (parsed.prompt !== undefined)
+                fields.prompt = parsed.prompt;
+            if (parsed.scheduled_enabled !== undefined)
+                fields.scheduledEnabled = parsed.scheduled_enabled;
+            if (parsed.sort_order !== undefined)
+                fields.sortOrder = parsed.sort_order;
+            if (parsed.is_active !== undefined)
+                fields.isActive = parsed.is_active;
+            const task = await client.updateAgentTask(parsed.agent_id, parsed.task_id, fields);
+            return { content: [{ type: 'text', text: `Updated task\n\n${text(task)}` }] };
+        }
+        case 'run_agent_task': {
+            const parsed = z
+                .object({ agent_id: z.string(), task_id: z.string(), project_slug: z.string().optional() })
+                .parse(args);
+            const result = await client.runAgentTask(parsed.agent_id, parsed.task_id, parsed.project_slug);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Queued task (entry ID: ${result.entryId}, position: ${result.position}, executing: ${result.executing})\n\nUse list_agent_queue to track progress.`,
+                    },
+                ],
+            };
+        }
+        case 'list_agent_queue': {
+            const parsed = z.object({ agent_id: z.string(), status: z.string().optional() }).parse(args);
+            const entries = await client.listAgentQueue(parsed.agent_id, parsed.status);
+            return { content: [{ type: 'text', text: text(entries) }] };
+        }
+        case 'cancel_queue_entry': {
+            const parsed = z.object({ agent_id: z.string(), entry_id: z.string() }).parse(args);
+            await client.cancelQueueEntry(parsed.agent_id, parsed.entry_id);
+            return { content: [{ type: 'text', text: `Cancelled queue entry ${parsed.entry_id}` }] };
+        }
+        // ─── Skills ─────────────────────────────────────────────────────────────
+        case 'create_skill': {
+            const parsed = z
+                .object({ name: z.string(), description: z.string(), content: z.string() })
+                .parse(args);
+            const skill = await client.createSkill(parsed);
+            return {
+                content: [{ type: 'text', text: `Created skill "${parsed.name}"\n\n${text(skill)}` }],
+            };
+        }
+        case 'update_skill': {
+            const parsed = z
+                .object({
+                skill_id: z.string(),
+                name: z.string().optional(),
+                description: z.string().optional(),
+                content: z.string().optional(),
+            })
+                .parse(args);
+            const { skill_id, ...fields } = parsed;
+            const skill = await client.updateSkill(skill_id, fields);
+            return { content: [{ type: 'text', text: `Updated skill\n\n${text(skill)}` }] };
+        }
+        case 'create_skill_resource': {
+            const parsed = z
+                .object({
+                skill_id: z.string(),
+                type: z.enum(['script', 'reference', 'asset']),
+                name: z.string(),
+                content: z.string(),
+                mime_type: z.string().optional(),
+            })
+                .parse(args);
+            const { skill_id, mime_type, ...rest } = parsed;
+            const resource = await client.createSkillResource(skill_id, { ...rest, mimeType: mime_type });
+            return {
+                content: [{ type: 'text', text: `Created resource "${parsed.name}"\n\n${text(resource)}` }],
+            };
+        }
+        case 'update_skill_resource': {
+            const parsed = z
+                .object({
+                skill_id: z.string(),
+                resource_id: z.string(),
+                name: z.string().optional(),
+                content: z.string().optional(),
+                mime_type: z.string().optional(),
+            })
+                .parse(args);
+            const { skill_id, resource_id, mime_type, ...rest } = parsed;
+            const resource = await client.updateSkillResource(skill_id, resource_id, {
+                ...rest,
+                mimeType: mime_type,
+            });
+            return { content: [{ type: 'text', text: `Updated resource\n\n${text(resource)}` }] };
+        }
+        case 'set_agent_skills': {
+            const parsed = z.object({ agent_id: z.string(), skill_ids: z.array(z.string()) }).parse(args);
+            await client.setAgentSkills(parsed.agent_id, parsed.skill_ids);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Set ${parsed.skill_ids.length} skill(s) on agent ${parsed.agent_id}`,
+                    },
+                ],
+            };
+        }
+        // ─── Skills (reading org library) ────────────────────────────────────────
+        case 'list_org_skills': {
+            const skills = await client.listOrgSkills();
+            return { content: [{ type: 'text', text: text(skills) }] };
+        }
+        case 'get_org_skill': {
+            const parsed = z.object({ skill_name: z.string() }).parse(args);
+            const skill = await client.getOrgSkill(parsed.skill_name);
+            if (!skill) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Skill '${parsed.skill_name}' not found. Use list_org_skills to see available skills.`,
+                        },
+                    ],
+                };
+            }
+            return { content: [{ type: 'text', text: text(skill) }] };
+        }
+        // ─── Secrets ─────────────────────────────────────────────────────────────
+        case 'list_agent_secrets': {
+            const { agent_id } = AgentIdSchema.parse(args);
+            const secrets = await client.listAgentSecrets(agent_id);
+            return { content: [{ type: 'text', text: text(secrets) }] };
+        }
+        case 'set_agent_secret': {
+            const parsed = z
+                .object({ agent_id: z.string(), name: z.string(), value: z.string() })
+                .parse(args);
+            const secret = await client.setAgentSecret(parsed.agent_id, parsed.name, parsed.value);
+            return { content: [{ type: 'text', text: `Set secret "${secret.name}"` }] };
+        }
+        // ─── Discovery ────────────────────────────────────────────────────────────
+        case 'list_agent_templates': {
+            const templates = await client.listAgentTemplates();
+            return { content: [{ type: 'text', text: text(templates) }] };
+        }
+        case 'list_llm_models': {
+            const models = await client.listLlmModels();
+            return { content: [{ type: 'text', text: text(models) }] };
+        }
+        default:
+            return {
+                content: [{ type: 'text', text: `Unknown agent builder tool: ${name}` }],
+                isError: true,
+            };
+    }
+}

package/dist/client.js

@@ -568,6 +568,161 @@ export class WolfpackClient {
             parentCommentId,
         });
     }
+    // ─── Capabilities ─────────────────────────────────────────────────────────
+    async getCapabilities() {
+        return this.api.get('/capabilities');
+    }
+    // ─── Agent Builder: Agent CRUD ─────────────────────────────────────────────
+    async listAgents() {
+        return this.api.get('/agents');
+    }
+    async getAgent(agentId) {
+        try {
+            return await this.api.get(`/agents/${agentId}`);
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && 'status' in error && error.status === 404)
+                return null;
+            throw error;
+        }
+    }
+    async createAgent(body) {
+        return this.api.post('/agents', body);
+    }
+    async updateAgent(agentId, body) {
+        return this.api.patch(`/agents/${agentId}`, body);
+    }
+    // ─── Agent Builder: Project Assignment ────────────────────────────────────
+    async listAgentProjects(agentId) {
+        return this.api.get(`/agents/${agentId}/projects`);
+    }
+    async assignAgentToProject(agentId, teamSlug) {
+        return this.api.post(`/agents/${agentId}/projects/${encodeURIComponent(teamSlug)}`, {});
+    }
+    async removeAgentFromProject(agentId, teamSlug) {
+        return this.api
+            .delete(`/agents/${agentId}/projects/${encodeURIComponent(teamSlug)}`)
+            .then(() => ({ success: true }));
+    }
+    // ─── Agent Builder: Sessions ───────────────────────────────────────────────
+    async listAgentSessions(agentId, options) {
+        const params = new URLSearchParams();
+        if (options?.status)
+            params.append('status', options.status);
+        if (options?.limit !== undefined)
+            params.append('limit', options.limit.toString());
+        if (options?.offset !== undefined)
+            params.append('offset', options.offset.toString());
+        const q = params.toString();
+        return this.api.get(`/agents/${agentId}/sessions${q ? `?${q}` : ''}`);
+    }
+    async getAgentSession(agentId, sessionId) {
+        try {
+            return await this.api.get(`/agents/${agentId}/sessions/${sessionId}`);
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && 'status' in error && error.status === 404)
+                return null;
+            throw error;
+        }
+    }
+    async getAgentSessionConversation(agentId, sessionId, options) {
+        const params = new URLSearchParams();
+        if (options?.limit !== undefined)
+            params.append('limit', options.limit.toString());
+        if (options?.offset !== undefined)
+            params.append('offset', options.offset.toString());
+        const q = params.toString();
+        return this.api.get(`/agents/${agentId}/sessions/${sessionId}/conversation${q ? `?${q}` : ''}`);
+    }
+    async runAgent(agentId, prompt, teamSlug) {
+        return this.api.post(`/agents/${agentId}/run`, { prompt, teamSlug });
+    }
+    async stopAgentSession(agentId, sessionId) {
+        return this.api.post(`/agents/${agentId}/sessions/${sessionId}/stop`, {});
+    }
+    async resumeAgentSession(agentId, sessionId, prompt) {
+        return this.api.post(`/agents/${agentId}/sessions/${sessionId}/resume`, {
+            prompt,
+        });
+    }
+    // ─── Agent Builder: Tasks ──────────────────────────────────────────────────
+    async listAgentTasks(agentId) {
+        return this.api.get(`/agents/${agentId}/tasks`);
+    }
+    async getAgentTask(agentId, taskId) {
+        try {
+            return await this.api.get(`/agents/${agentId}/tasks/${taskId}`);
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && 'status' in error && error.status === 404)
+                return null;
+            throw error;
+        }
+    }
+    async createAgentTask(agentId, body) {
+        return this.api.post(`/agents/${agentId}/tasks`, body);
+    }
+    async updateAgentTask(agentId, taskId, body) {
+        return this.api.patch(`/agents/${agentId}/tasks/${taskId}`, body);
+    }
+    async runAgentTask(agentId, taskId, teamSlug) {
+        return this.api.post(`/agents/${agentId}/tasks/${taskId}/run`, { teamSlug });
+    }
+    // ─── Agent Builder: Queue ──────────────────────────────────────────────────
+    async listAgentQueue(agentId, status) {
+        const q = status ? `?status=${encodeURIComponent(status)}` : '';
+        return this.api.get(`/agents/${agentId}/queue${q}`);
+    }
+    async cancelQueueEntry(agentId, entryId) {
+        return this.api.delete(`/agents/${agentId}/queue/${entryId}`).then(() => ({ success: true }));
+    }
+    // ─── Agent Builder: Secrets ────────────────────────────────────────────────
+    async listAgentSecrets(agentId) {
+        return this.api.get(`/agents/${agentId}/secrets`);
+    }
+    async setAgentSecret(agentId, name, value) {
+        return this.api.post(`/agents/${agentId}/secrets`, { name, value });
+    }
+    // ─── Agent Builder: Skills (write) ────────────────────────────────────────
+    async createSkill(body) {
+        return this.api.post('/skills', body);
+    }
+    async updateSkill(skillId, body) {
+        return this.api.patch(`/skills/${skillId}`, body);
+    }
+    async createSkillResource(skillId, body) {
+        return this.api.post(`/skills/${skillId}/resources`, body);
+    }
+    async updateSkillResource(skillId, resourceId, body) {
+        return this.api.patch(`/skills/${skillId}/resources/${resourceId}`, body);
+    }
+    async setAgentSkills(agentId, skillIds) {
+        return this.api.post(`/skills/agent-assignments/${agentId}`, {
+            skillIds,
+        });
+    }
+    // ─── Agent Builder: Skills (read) ──────────────────────────────────────────
+    async listOrgSkills() {
+        return this.api.get('/skills/org');
+    }
+    async getOrgSkill(name) {
+        try {
+            return await this.api.get(`/skills/org/${encodeURIComponent(name)}`);
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && 'status' in error && error.status === 404)
+                return null;
+            throw error;
+        }
+    }
+    // ─── Agent Builder: Discovery ──────────────────────────────────────────────
+    async listAgentTemplates() {
+        return this.api.get('/agent-builder/templates');
+    }
+    async listLlmModels() {
+        return this.api.get('/agent-builder/llm-models');
+    }
     close() {
         // No cleanup needed for API client
     }

package/dist/index.js

@@ -8,6 +8,7 @@ import { readFile, stat } from 'fs/promises';
 import { basename, extname, resolve } from 'path';
 import { WolfpackClient } from './client.js';
 import { validateConfig, config } from './config.js';
+import { AGENT_BUILDER_TOOLS, handleAgentBuilderTool } from './agentBuilderTools.js';
 // Get current package version
 const require = createRequire(import.meta.url);
 const packageJson = require('../package.json');
@@ -115,6 +116,10 @@ const VALID_STATUSES = [
 const UpdateWorkItemSchema = z.object({
     work_item_id: z.string().describe('The ID of the work item'),
     title: z.string().optional().describe('New title for the work item'),
+    description: z
+        .string()
+        .optional()
+        .describe('Updated description (supports Markdown and @mentions)'),
     status: z.enum(VALID_STATUSES).optional().describe('New status'),
     leading_user_id: z
         .string()
@@ -137,6 +142,27 @@ const UpdateWorkItemSchema = z.object({
         .nullable()
         .optional()
         .describe('Size estimate: "S" (small), "M" (medium), "L" (large), or null to remove'),
+    assisting_user1_id: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('User ID for first assisting user, or null to remove'),
+    assisting_user2_id: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('User ID for second assisting user, or null to remove'),
+    assisting_user3_id: z
+        .string()
+        .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)'),
+    closing_comment: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Comment explaining closure/completion'),
     project_slug: z
         .string()
         .optional()
@@ -590,6 +616,7 @@ function hasPlan(description) {
 class WolfpackMCPServer {
     server;
     client;
+    capabilities = [];
     constructor() {
         this.client = new WolfpackClient();
         this.server = new Server({
@@ -737,8 +764,8 @@ 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, status, leading_user_id (assignee), radar_item_id (initiative), ' +
-                        'category_id, priority (0-4), and size (S/M/L). ' +
+                        '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. ' +
                         '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.',
@@ -753,6 +780,10 @@ class WolfpackMCPServer {
                                 type: 'string',
                                 description: 'New title for the work item',
                             },
+                            description: {
+                                type: 'string',
+                                description: 'Updated description (supports Markdown and @mentions)',
+                            },
                             status: {
                                 type: 'string',
                                 enum: [
@@ -789,6 +820,27 @@ class WolfpackMCPServer {
                                 enum: ['S', 'M', 'L', null],
                                 description: 'Size estimate: "S" (small), "M" (medium), "L" (large), or null to remove',
                             },
+                            assisting_user1_id: {
+                                type: ['string', 'null'],
+                                description: 'User ID for first assisting user, or null to remove',
+                            },
+                            assisting_user2_id: {
+                                type: ['string', 'null'],
+                                description: 'User ID for second assisting user, or null to remove',
+                            },
+                            assisting_user3_id: {
+                                type: ['string', 'null'],
+                                description: 'User ID for third assisting user, or null to remove',
+                            },
+                            tag_ids: {
+                                type: 'array',
+                                items: { type: 'string' },
+                                description: 'Tag IDs to apply (replaces existing tags)',
+                            },
+                            closing_comment: {
+                                type: ['string', 'null'],
+                                description: 'Comment explaining closure/completion',
+                            },
                             project_slug: {
                                 type: 'string',
                                 description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
@@ -1811,6 +1863,7 @@ class WolfpackMCPServer {
                         required: ['discussion_id', 'content'],
                     },
                 },
+                ...(this.capabilities.includes('agent_builder') ? AGENT_BUILDER_TOOLS : []),
             ],
         }));
         this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
@@ -1908,6 +1961,8 @@ class WolfpackMCPServer {
                         const fields = {};
                         if (parsed.title !== undefined)
                             fields.title = parsed.title;
+                        if (parsed.description !== undefined)
+                            fields.description = parsed.description;
                         if (parsed.status !== undefined)
                             fields.status = parsed.status;
                         if (parsed.leading_user_id !== undefined)
@@ -1920,6 +1975,16 @@ class WolfpackMCPServer {
                             fields.priority = parsed.priority;
                         if (parsed.size !== undefined)
                             fields.size = parsed.size;
+                        if (parsed.assisting_user1_id !== undefined)
+                            fields.assistingUser1Id = parsed.assisting_user1_id;
+                        if (parsed.assisting_user2_id !== undefined)
+                            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.closing_comment !== undefined)
+                            fields.closingComment = parsed.closing_comment;
                         const workItem = await this.client.updateWorkItem(parsed.work_item_id, fields, teamSlug);
                         if (workItem) {
                             // Build a summary of what changed
@@ -1928,6 +1993,8 @@ class WolfpackMCPServer {
                                 changes.push(`status → ${parsed.status}`);
                             if (parsed.title !== undefined)
                                 changes.push(`title → "${parsed.title}"`);
+                            if (parsed.description !== undefined)
+                                changes.push('description updated');
                             if (parsed.leading_user_id !== undefined)
                                 changes.push(parsed.leading_user_id
                                     ? `assigned to ${workItem.leadingUser?.name || parsed.leading_user_id}`
@@ -1950,6 +2017,22 @@ class WolfpackMCPServer {
                             }
                             if (parsed.size !== undefined)
                                 changes.push(parsed.size ? `size → ${parsed.size}` : 'size removed');
+                            if (parsed.assisting_user1_id !== undefined)
+                                changes.push(parsed.assisting_user1_id
+                                    ? `assisting user 1 updated`
+                                    : 'assisting user 1 removed');
+                            if (parsed.assisting_user2_id !== undefined)
+                                changes.push(parsed.assisting_user2_id
+                                    ? `assisting user 2 updated`
+                                    : 'assisting user 2 removed');
+                            if (parsed.assisting_user3_id !== undefined)
+                                changes.push(parsed.assisting_user3_id
+                                    ? `assisting user 3 updated`
+                                    : 'assisting user 3 removed');
+                            if (parsed.tag_ids !== undefined)
+                                changes.push('tags updated');
+                            if (parsed.closing_comment !== undefined)
+                                changes.push('closing comment set');
                             const summary = changes.length > 0 ? changes.join(', ') : 'no changes';
                             return {
                                 content: [
@@ -2618,8 +2701,12 @@ class WolfpackMCPServer {
                             content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
                         };
                     }
-                    default:
+                    default: {
+                        if (this.capabilities.includes('agent_builder')) {
+                            return handleAgentBuilderTool(name, args, this.client);
+                        }
                         throw new Error(`Unknown tool: ${name}`);
+                    }
                 }
             }
             catch (error) {
@@ -2657,41 +2744,55 @@ class WolfpackMCPServer {
         return false;
     }
     async start() {
+        // Fetch capabilities to determine which tools to register
+        try {
+            const caps = await this.client.getCapabilities();
+            this.capabilities = caps.capabilities;
+            if (this.capabilities.length > 0) {
+                console.error(`Capabilities: ${this.capabilities.join(', ')}`);
+            }
+        }
+        catch (error) {
+            console.error(`Warning: Could not fetch capabilities: ${error instanceof Error ? error.message : String(error)}`);
+            // Proceed with project tools only (backward compat)
+        }
         // Connect stdio transport FIRST so MCP clients don't deadlock waiting for initialize
         const transport = new StdioServerTransport();
         await this.server.connect(transport);
         console.error(`Wolfpack MCP Server v${CURRENT_VERSION} started`);
-        // Resolve project after transport is connected (non-blocking for MCP handshake)
-        if (config.projectSlug) {
-            // Explicit project slug configured - use it
-            try {
-                await this.client.resolveProjectSlug(config.projectSlug);
-                console.error(`Resolved project: "${config.projectSlug}"`);
-            }
-            catch (error) {
-                console.error(`Failed to resolve project slug: ${error instanceof Error ? error.message : String(error)}`);
-                // Don't exit - project can be specified per tool call
-            }
-        }
-        else {
-            // No project slug configured - try to auto-detect
-            try {
-                const teams = await this.client.listProjects();
-                if (teams.length === 1) {
-                    // Auto-select the only project
-                    this.client.setProjectSlug(teams[0].slug);
-                    console.error(`Auto-selected project: ${teams[0].name} (${teams[0].slug})`);
-                }
-                else if (teams.length === 0) {
-                    console.error('Warning: No projects found for this API key');
+        // Resolve project for project-capable keys
+        if (this.capabilities.includes('project') || this.capabilities.length === 0) {
+            if (config.projectSlug) {
+                // Explicit project slug configured - use it
+                try {
+                    await this.client.resolveProjectSlug(config.projectSlug);
+                    console.error(`Resolved project: "${config.projectSlug}"`);
                 }
-                else {
-                    console.error(`Multiple projects available (${teams.length}). Use list_projects tool to see them, then specify project_slug in tool calls.`);
+                catch (error) {
+                    console.error(`Failed to resolve project slug: ${error instanceof Error ? error.message : String(error)}`);
+                    // Don't exit - project can be specified per tool call
                 }
             }
-            catch (error) {
-                console.error(`Warning: Could not fetch projects: ${error instanceof Error ? error.message : String(error)}`);
-                // Don't exit - let the user use list_projects tool manually
+            else {
+                // No project slug configured - try to auto-detect
+                try {
+                    const teams = await this.client.listProjects();
+                    if (teams.length === 1) {
+                        // Auto-select the only project
+                        this.client.setProjectSlug(teams[0].slug);
+                        console.error(`Auto-selected project: ${teams[0].name} (${teams[0].slug})`);
+                    }
+                    else if (teams.length === 0) {
+                        console.error('Warning: No projects found for this API key');
+                    }
+                    else {
+                        console.error(`Multiple projects available (${teams.length}). Use list_projects tool to see them, then specify project_slug in tool calls.`);
+                    }
+                }
+                catch (error) {
+                    console.error(`Warning: Could not fetch projects: ${error instanceof Error ? error.message : String(error)}`);
+                    // Don't exit - let the user use list_projects tool manually
+                }
             }
         }
         // Check for updates (non-blocking)

package/package.json

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