@dobbyai/mcp-external 1.1.0 → 1.2.0

package/dist/tools/external-agents.d.ts

@@ -0,0 +1,440 @@
+/**
+ * External Agents Tools
+ *
+ * MCP tools for managing external agents (BYOA) through the Dobby gateway.
+ * All calls go to /api/v1/gateway/external-agents/* which use gk_svc_* auth
+ * and require `agents:read` / `agents:manage` / `agents:trigger` scopes.
+ *
+ * Session 3 of the External Agents API + MCP Parity plan:
+ *   Session 1 ✅ — gateway-key CRUD
+ *   Session 2 ✅ — gateway-key trigger/schedule/costs
+ *   Session 3 ⬅︎ THIS — MCP tools wrapping those endpoints
+ *   Session 4 ⏳ — SDK coverage + docs
+ */
+export declare const externalAgentTools: {
+    register_external_agent: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                display_name: {
+                    type: string;
+                    description: string;
+                };
+                description: {
+                    type: string;
+                    description: string;
+                };
+                framework: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                protocol: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                endpoint_url: {
+                    type: string;
+                    description: string;
+                };
+                health_check_url: {
+                    type: string;
+                    description: string;
+                };
+                capabilities: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                tags: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                tenant_id: {
+                    type: string;
+                    description: string;
+                };
+                auth_config: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    list_external_agents: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                tenant_id: {
+                    type: string;
+                    description: string;
+                };
+                status: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+            };
+        };
+    };
+    get_external_agent: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                agent_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    update_external_agent: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                agent_id: {
+                    type: string;
+                    description: string;
+                };
+                display_name: {
+                    type: string;
+                };
+                description: {
+                    type: string;
+                };
+                endpoint_url: {
+                    type: string;
+                };
+                health_check_url: {
+                    type: string;
+                };
+                capabilities: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                tags: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                status: {
+                    type: string;
+                    enum: string[];
+                };
+                auth_config: {
+                    type: string;
+                    description: string;
+                };
+                outbound_credentials: {
+                    type: string;
+                    description: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            provider: {
+                                type: string;
+                                description: string;
+                            };
+                            env_var_name: {
+                                type: string;
+                                description: string;
+                            };
+                            rotation_policy: {
+                                type: string;
+                                description: string;
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+            };
+            required: string[];
+        };
+    };
+    deregister_external_agent: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                agent_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    trigger_external_agent: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                agent_id: {
+                    type: string;
+                    description: string;
+                };
+                inputs: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    get_agent_triggers: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                agent_id: {
+                    type: string;
+                    description: string;
+                };
+                page: {
+                    type: string;
+                    description: string;
+                };
+                page_size: {
+                    type: string;
+                    description: string;
+                };
+                status: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                include_stats: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    create_agent_schedule: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                agent_id: {
+                    type: string;
+                    description: string;
+                };
+                name: {
+                    type: string;
+                    description: string;
+                };
+                description: {
+                    type: string;
+                };
+                task_title: {
+                    type: string;
+                    description: string;
+                };
+                task_description: {
+                    type: string;
+                };
+                schedule_config: {
+                    type: string;
+                    description: string;
+                };
+                trigger_payload: {
+                    type: string;
+                    description: string;
+                };
+                overlap_policy: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    update_agent_schedule: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                agent_id: {
+                    type: string;
+                    description: string;
+                };
+                paused: {
+                    type: string;
+                    description: string;
+                };
+                pause_reason: {
+                    type: string;
+                    description: string;
+                };
+                name: {
+                    type: string;
+                    description: string;
+                };
+                schedule_config: {
+                    type: string;
+                    description: string;
+                };
+                task_title: {
+                    type: string;
+                };
+                task_description: {
+                    type: string;
+                };
+                trigger_payload: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    delete_agent_schedule: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                agent_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    retry_external_agent_trigger: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                agent_id: {
+                    type: string;
+                    description: string;
+                };
+                trigger_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    get_agent_costs: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                agent_id: {
+                    type: string;
+                    description: string;
+                };
+                days: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+};
+//# sourceMappingURL=external-agents.d.ts.map

package/dist/tools/external-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-agents.d.ts","sourceRoot":"","sources":["../../src/tools/external-agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Y9B,CAAC"}