@dobbyai/mcp-external 1.0.1 → 1.0.2

package/dist/tools/crew-builder.js

@@ -0,0 +1,306 @@
+/**
+ * Crew Builder Tools
+ *
+ * MCP tools for creating and running CrewAI crews from YAML configurations
+ * through the Dobby gateway proxy (managed service: crewai-local).
+ *
+ * These tools work with the Crew AI Service (mcp/crew-ai/) which runs
+ * as an internal Docker container. All requests are proxied through
+ * the gateway at /api/v1/gateway/agents/proxy with provider_id='crewai-local'.
+ *
+ * Tools:
+ *   crew_validate  — Validate YAML configs without running
+ *   crew_kickoff   — Create crew from YAML and start execution
+ *   crew_status    — Check run status and results
+ *   crew_list      — List recent crew runs
+ */
+// ============================================
+// Tool Definitions
+// ============================================
+export const crewBuilderTools = {
+    crew_validate: {
+        name: 'crew_validate',
+        description: 'Validate CrewAI YAML configurations (agents and tasks) without running them. ' +
+            'Use this to check for errors before starting a kickoff. ' +
+            'Returns validation errors or confirms the configuration is valid.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agents_yaml: {
+                    type: 'string',
+                    description: 'YAML content defining agents. Each agent needs: role, goal, backstory. ' +
+                        'Example:\n' +
+                        'researcher:\n' +
+                        '  role: Research Analyst\n' +
+                        '  goal: Find information about {topic}\n' +
+                        '  backstory: You are an expert researcher.',
+                },
+                tasks_yaml: {
+                    type: 'string',
+                    description: 'YAML content defining tasks. Each task needs: description, expected_output, agent. ' +
+                        'Example:\n' +
+                        'research_task:\n' +
+                        '  description: Research {topic}\n' +
+                        '  expected_output: A detailed report\n' +
+                        '  agent: researcher',
+                },
+            },
+            required: ['agents_yaml', 'tasks_yaml'],
+        },
+    },
+    crew_kickoff: {
+        name: 'crew_kickoff',
+        description: 'Create a CrewAI crew from YAML configurations and start execution. ' +
+            'Agents and tasks are defined in YAML with {placeholder} variable substitution. ' +
+            'Returns a run_id to track progress with crew_status. ' +
+            'The crew runs asynchronously — check status to get results.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agents_yaml: {
+                    type: 'string',
+                    description: 'YAML content defining agents (role, goal, backstory per agent)',
+                },
+                tasks_yaml: {
+                    type: 'string',
+                    description: 'YAML content defining tasks (description, expected_output, agent per task)',
+                },
+                variables: {
+                    type: 'object',
+                    description: 'Key-value pairs to substitute {placeholders} in YAML. ' +
+                        'E.g., {"topic": "AI agents"} replaces all {topic} occurrences.',
+                    additionalProperties: { type: 'string' },
+                },
+                process_type: {
+                    type: 'string',
+                    enum: ['sequential', 'hierarchical'],
+                    description: 'Crew process type. Sequential runs tasks in order, hierarchical uses a manager agent. Default: sequential.',
+                },
+            },
+            required: ['agents_yaml', 'tasks_yaml'],
+        },
+    },
+    crew_status: {
+        name: 'crew_status',
+        description: 'Check the status of a local CrewAI crew execution. ' +
+            'Returns the state (pending/running/completed/failed), agent outputs, ' +
+            'result when complete, or error message if failed.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                run_id: {
+                    type: 'string',
+                    description: 'The run ID returned from crew_kickoff.',
+                },
+            },
+            required: ['run_id'],
+        },
+    },
+    crew_list: {
+        name: 'crew_list',
+        description: 'List recent local CrewAI crew runs with their status, timing, and summary info.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of runs to return (default: 10).',
+                },
+                status_filter: {
+                    type: 'string',
+                    enum: ['running', 'completed', 'failed', 'all'],
+                    description: 'Filter by run status (default: all).',
+                },
+            },
+        },
+    },
+};
+async function callCrewBuilderProxy(client, payload) {
+    const url = `${client.apiUrl}/api/v1/gateway/agents/proxy`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${client.apiKey}`,
+            ...(client.tenantId ? { 'X-Tenant-Id': client.tenantId } : {}),
+        },
+        body: JSON.stringify({
+            ...payload,
+            provider_id: 'crewai-local',
+        }),
+    });
+    if (!response.ok) {
+        const errBody = await response.json().catch(() => ({
+            error: `Gateway proxy returned ${response.status}`,
+        }));
+        throw new Error(errBody.error ||
+            errBody.detail ||
+            `Gateway proxy error: HTTP ${response.status}`);
+    }
+    return response.json();
+}
+// ============================================
+// Tool Handlers
+// ============================================
+export async function handleCrewValidate(client, args) {
+    try {
+        const data = await callCrewBuilderProxy(client, {
+            action: 'validate',
+            provider_id: 'crewai-local',
+            agents_yaml: args.agents_yaml,
+            tasks_yaml: args.tasks_yaml,
+        });
+        const resp = data.response || {};
+        let text = `# Crew YAML Validation\n\n`;
+        if (resp.valid) {
+            text += `✅ **Valid** — Configuration is ready to run.\n\n`;
+        }
+        else {
+            text += `❌ **Invalid** — Found ${resp.errors?.length || 0} error(s):\n\n`;
+            for (const error of resp.errors || []) {
+                text += `- ${error}\n`;
+            }
+            text += `\n`;
+        }
+        if (resp.agents?.length > 0) {
+            text += `## Agents (${resp.agents.length})\n\n`;
+            for (const agent of resp.agents) {
+                text += `- **${agent.name}** — ${agent.role} (${agent.goal})\n`;
+            }
+            text += `\n`;
+        }
+        if (resp.tasks?.length > 0) {
+            text += `## Tasks (${resp.tasks.length})\n\n`;
+            for (const task of resp.tasks) {
+                text += `- **${task.name}** → agent: \`${task.agent}\` — ${task.description}\n`;
+            }
+        }
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (error) {
+        return {
+            content: [
+                { type: 'text', text: `Crew validation failed: ${error.message}` },
+            ],
+            isError: true,
+        };
+    }
+}
+export async function handleCrewKickoff(client, args) {
+    try {
+        const data = await callCrewBuilderProxy(client, {
+            action: 'local_kickoff',
+            provider_id: 'crewai-local',
+            agents_yaml: args.agents_yaml,
+            tasks_yaml: args.tasks_yaml,
+            variables: args.variables || {},
+            process_type: args.process_type || 'sequential',
+        });
+        const resp = data.response || {};
+        let text = `# Crew Kickoff Started\n\n`;
+        text += `- **Run ID:** \`${resp.run_id}\`\n`;
+        text += `- **Status:** ${resp.status}\n`;
+        text += `- **Agents:** ${resp.agent_count}\n`;
+        text += `- **Tasks:** ${resp.task_count}\n`;
+        text += `- **Process:** ${resp.process_type}\n`;
+        text += `- **Latency:** ${data.latency_ms}ms\n\n`;
+        text += `Use \`crew_status\` with run_id \`${resp.run_id}\` to check progress.`;
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (error) {
+        return {
+            content: [
+                { type: 'text', text: `Crew kickoff failed: ${error.message}` },
+            ],
+            isError: true,
+        };
+    }
+}
+export async function handleCrewStatus(client, args) {
+    try {
+        const data = await callCrewBuilderProxy(client, {
+            action: 'local_status',
+            provider_id: 'crewai-local',
+            run_id: args.run_id,
+        });
+        const resp = data.response || {};
+        let text = `# Crew Run Status\n\n`;
+        text += `- **Run ID:** \`${resp.run_id}\`\n`;
+        text += `- **Status:** ${resp.status}\n`;
+        text += `- **Process:** ${resp.process_type}\n`;
+        text += `- **Agents:** ${resp.agent_count}\n`;
+        text += `- **Tasks:** ${resp.task_count}\n`;
+        if (resp.started_at) {
+            text += `- **Started:** ${resp.started_at}\n`;
+        }
+        if (resp.completed_at) {
+            text += `- **Completed:** ${resp.completed_at}\n`;
+        }
+        if (resp.duration_ms != null) {
+            text += `- **Duration:** ${resp.duration_ms}ms\n`;
+        }
+        if (resp.error_message) {
+            text += `\n## Error\n\n\`\`\`\n${resp.error_message}\n\`\`\`\n`;
+        }
+        if (resp.agent_outputs?.length > 0) {
+            text += `\n## Agent Outputs\n\n`;
+            for (const output of resp.agent_outputs) {
+                text += `### ${output.task || 'Task'}\n\n${output.output}\n\n`;
+            }
+        }
+        if (resp.result) {
+            text += `\n## Final Result\n\n${resp.result}\n`;
+        }
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (error) {
+        return {
+            content: [
+                { type: 'text', text: `Failed to get crew status: ${error.message}` },
+            ],
+            isError: true,
+        };
+    }
+}
+export async function handleCrewList(client, args) {
+    try {
+        const data = await callCrewBuilderProxy(client, {
+            action: 'list_runs',
+            provider_id: 'crewai-local',
+            limit: args.limit || 10,
+            status: args.status_filter,
+        });
+        const resp = data.response || {};
+        const runs = resp.runs || [];
+        let text = `# Crew Runs (${runs.length})\n\n`;
+        if (runs.length === 0) {
+            text += `_No crew runs found._\n`;
+        }
+        else {
+            for (const run of runs) {
+                const statusIcon = run.status === 'completed' ? '✅' :
+                    run.status === 'running' ? '🔄' :
+                        run.status === 'failed' ? '❌' : '⏳';
+                text += `- ${statusIcon} **${run.run_id}** [${run.status}] — `;
+                text += `${run.agent_count} agents, ${run.task_count} tasks`;
+                if (run.duration_ms != null) {
+                    text += ` (${run.duration_ms}ms)`;
+                }
+                if (run.has_error) {
+                    text += ` ⚠️`;
+                }
+                text += `\n`;
+            }
+        }
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (error) {
+        return {
+            content: [
+                { type: 'text', text: `Failed to list crew runs: ${error.message}` },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=crew-builder.js.map

package/dist/tools/crew-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crew-builder.js","sourceRoot":"","sources":["../../src/tools/crew-builder.ts"],"names":[],"mappings":"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"}

package/dist/tools/crewai.d.ts

@@ -0,0 +1,140 @@
+/**
+ * CrewAI Tools
+ *
+ * MCP tools for interacting with CrewAI agents through the Dobby gateway proxy.
+ * All calls go through /api/v1/gateway/agents/proxy which handles:
+ *  - credential decryption
+ *  - connection lookup
+ *  - request forwarding
+ */
+import { DobbyClient } from '../lib/dobby-client.js';
+export declare const crewaiTools: {
+    crewai_health: {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                connection_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+        };
+    };
+    crewai_inputs: {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                connection_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+        };
+    };
+    crewai_kickoff: {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                inputs: {
+                    type: string;
+                    description: string;
+                    additionalProperties: {
+                        type: string;
+                    };
+                };
+                connection_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    crewai_status: {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                kickoff_id: {
+                    type: string;
+                    description: string;
+                };
+                connection_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+};
+export declare function handleCrewAIHealth(client: DobbyClient, args: {
+    connection_id?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare function handleCrewAIInputs(client: DobbyClient, args: {
+    connection_id?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare function handleCrewAIKickoff(client: DobbyClient, args: {
+    inputs: Record<string, string>;
+    connection_id?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare function handleCrewAIStatus(client: DobbyClient, args: {
+    kickoff_id: string;
+    connection_id?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+//# sourceMappingURL=crewai.d.ts.map

package/dist/tools/crewai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crewai.d.ts","sourceRoot":"","sources":["../../src/tools/crewai.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAMrD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4EvB,CAAC;AAkDF,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GAyBjC;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GAgCjC;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GA4BjE;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GA+CrD"}

package/dist/tools/crewai.js

@@ -0,0 +1,226 @@
+/**
+ * CrewAI Tools
+ *
+ * MCP tools for interacting with CrewAI agents through the Dobby gateway proxy.
+ * All calls go through /api/v1/gateway/agents/proxy which handles:
+ *  - credential decryption
+ *  - connection lookup
+ *  - request forwarding
+ */
+// ============================================
+// Tool Definitions
+// ============================================
+export const crewaiTools = {
+    crewai_health: {
+        name: 'crewai_health',
+        description: 'Check the health status of the connected CrewAI agent. Returns the agent status and connection info.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                connection_id: {
+                    type: 'string',
+                    description: 'Optional: specific connection ID. If omitted, uses the first active CrewAI connection.',
+                },
+            },
+        },
+    },
+    crewai_inputs: {
+        name: 'crewai_inputs',
+        description: 'Get the required input fields for the CrewAI crew. Returns the list of input parameter names needed to start a kickoff.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                connection_id: {
+                    type: 'string',
+                    description: 'Optional: specific connection ID. If omitted, uses the first active CrewAI connection.',
+                },
+            },
+        },
+    },
+    crewai_kickoff: {
+        name: 'crewai_kickoff',
+        description: 'Start a CrewAI crew execution (kickoff). Provide the required inputs and the crew will begin processing. Returns a kickoff_id to track the status.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                inputs: {
+                    type: 'object',
+                    description: 'The input parameters for the crew. Use crewai_inputs first to see which fields are required.',
+                    additionalProperties: { type: 'string' },
+                },
+                connection_id: {
+                    type: 'string',
+                    description: 'Optional: specific connection ID. If omitted, uses the first active CrewAI connection.',
+                },
+            },
+            required: ['inputs'],
+        },
+    },
+    crewai_status: {
+        name: 'crewai_status',
+        description: 'Check the status of a CrewAI crew execution. Provide the kickoff_id from a previous crewai_kickoff call. Returns the state, result, and execution details.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                kickoff_id: {
+                    type: 'string',
+                    description: 'The kickoff ID returned from crewai_kickoff.',
+                },
+                connection_id: {
+                    type: 'string',
+                    description: 'Optional: specific connection ID. If omitted, uses the first active CrewAI connection.',
+                },
+            },
+            required: ['kickoff_id'],
+        },
+    },
+};
+async function callGatewayProxy(client, payload) {
+    const url = `${client.apiUrl}/api/v1/gateway/agents/proxy`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${client.apiKey}`,
+            ...(client.tenantId ? { 'X-Tenant-Id': client.tenantId } : {}),
+        },
+        body: JSON.stringify({
+            ...payload,
+            provider_id: payload.provider_id || 'crewai',
+        }),
+    });
+    if (!response.ok) {
+        const errBody = await response.json().catch(() => ({
+            error: `Gateway proxy returned ${response.status}`,
+        }));
+        throw new Error(errBody.error ||
+            `Gateway proxy error: HTTP ${response.status}`);
+    }
+    return response.json();
+}
+// ============================================
+// Tool Handlers
+// ============================================
+export async function handleCrewAIHealth(client, args) {
+    try {
+        const data = await callGatewayProxy(client, {
+            action: 'health',
+            connection_id: args.connection_id,
+        });
+        const conn = data.connection || {};
+        let text = `# CrewAI Health Check\n\n`;
+        text += `- **Status:** ${data.response?.status || 'unknown'}\n`;
+        text += `- **Connection:** ${conn.display_name || conn.connection_id}\n`;
+        text += `- **Provider:** ${conn.provider_id}\n`;
+        text += `- **Connection Status:** ${conn.status}\n`;
+        text += `- **Latency:** ${data.latency_ms}ms\n`;
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (error) {
+        return {
+            content: [
+                { type: 'text', text: `CrewAI health check failed: ${error.message}` },
+            ],
+            isError: true,
+        };
+    }
+}
+export async function handleCrewAIInputs(client, args) {
+    try {
+        const data = await callGatewayProxy(client, {
+            action: 'inputs',
+            connection_id: args.connection_id,
+        });
+        const inputs = data.response?.inputs || [];
+        const conn = data.connection || {};
+        let text = `# CrewAI Required Inputs\n\n`;
+        text += `**Crew:** ${conn.display_name || 'CrewAI'}\n\n`;
+        if (inputs.length > 0) {
+            text += `The following inputs are required to start a kickoff:\n\n`;
+            for (const input of inputs) {
+                text += `- \`${input}\`\n`;
+            }
+            text += `\nUse \`crewai_kickoff\` with these inputs to start the crew.`;
+        }
+        else {
+            text += `No inputs required. You can call \`crewai_kickoff\` with an empty inputs object.`;
+        }
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (error) {
+        return {
+            content: [
+                { type: 'text', text: `Failed to get CrewAI inputs: ${error.message}` },
+            ],
+            isError: true,
+        };
+    }
+}
+export async function handleCrewAIKickoff(client, args) {
+    try {
+        const data = await callGatewayProxy(client, {
+            action: 'kickoff',
+            inputs: args.inputs,
+            connection_id: args.connection_id,
+        });
+        const kickoffId = data.response?.kickoff_id;
+        const conn = data.connection || {};
+        let text = `# CrewAI Kickoff Started\n\n`;
+        text += `- **Crew:** ${conn.display_name || 'CrewAI'}\n`;
+        text += `- **Kickoff ID:** \`${kickoffId}\`\n`;
+        text += `- **Inputs:** ${JSON.stringify(args.inputs)}\n`;
+        text += `- **Latency:** ${data.latency_ms}ms\n\n`;
+        text += `Use \`crewai_status\` with kickoff_id \`${kickoffId}\` to check progress.`;
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (error) {
+        return {
+            content: [
+                { type: 'text', text: `CrewAI kickoff failed: ${error.message}` },
+            ],
+            isError: true,
+        };
+    }
+}
+export async function handleCrewAIStatus(client, args) {
+    try {
+        const data = await callGatewayProxy(client, {
+            action: 'status',
+            kickoff_id: args.kickoff_id,
+            connection_id: args.connection_id,
+        });
+        const resp = data.response || {};
+        const conn = data.connection || {};
+        let text = `# CrewAI Execution Status\n\n`;
+        text += `- **Crew:** ${conn.display_name || 'CrewAI'}\n`;
+        text += `- **Kickoff ID:** \`${args.kickoff_id}\`\n`;
+        text += `- **State:** ${resp.state || 'unknown'}\n`;
+        text += `- **Status:** ${resp.status || 'unknown'}\n`;
+        if (resp.last_executed_task) {
+            text += `- **Last Task:** ${resp.last_executed_task}\n`;
+        }
+        if (resp.last_step) {
+            text += `- **Last Step:** ${resp.last_step}\n`;
+        }
+        text += `- **Latency:** ${data.latency_ms}ms\n`;
+        if (resp.result) {
+            text += `\n## Result\n\n${resp.result}\n`;
+        }
+        if (resp.result_json) {
+            text += `\n## Result (JSON)\n\n\`\`\`json\n${JSON.stringify(resp.result_json, null, 2)}\n\`\`\`\n`;
+        }
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Failed to get CrewAI status: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=crewai.js.map