wolfpack-mcp 1.0.46 → 1.0.48

package/dist/agentBuilderTools.js

@@ -0,0 +1,754 @@
+/**
+ * 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_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 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}`,
+                    },
+                ],
+            };
+        }
+        // ─── 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,
+            };
+    }
+}