@dobbyai/mcp-external 1.0.4 → 1.2.0

package/dist/tools/exa.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Exa Semantic Search Tools
+ *
+ * Phase 1, Task 1.3: Neural/semantic search for research and code context.
+ * Uses Exa API for embeddings-based search (not keyword-based).
+ * Agents can research docs, find code patterns, and gather context.
+ */
+export declare const exaTools: {
+    exa_web_search: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                query: {
+                    type: string;
+                    description: string;
+                };
+                num_results: {
+                    type: string;
+                    description: string;
+                };
+                search_type: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                include_domains: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                exclude_domains: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                start_published_date: {
+                    type: string;
+                    description: string;
+                };
+                use_autoprompt: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    exa_find_similar: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                url: {
+                    type: string;
+                    description: string;
+                };
+                num_results: {
+                    type: string;
+                    description: string;
+                };
+                include_domains: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                exclude_domains: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    exa_get_contents: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                urls: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                max_characters: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+};
+//# sourceMappingURL=exa.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exa.d.ts","sourceRoot":"","sources":["../../src/tools/exa.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6GpB,CAAC"}

package/dist/tools/exa.js

@@ -0,0 +1,125 @@
+/**
+ * Exa Semantic Search Tools
+ *
+ * Phase 1, Task 1.3: Neural/semantic search for research and code context.
+ * Uses Exa API for embeddings-based search (not keyword-based).
+ * Agents can research docs, find code patterns, and gather context.
+ */
+// ============================================
+// Tool Definitions
+// ============================================
+export const exaTools = {
+    exa_web_search: {
+        name: 'exa_web_search',
+        annotations: {
+            title: 'Web Search',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+        description: 'Search the web using Exa neural/semantic search. Returns results based on meaning, not keywords. Use for researching best practices, documentation, and technical topics.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Natural language search query (e.g., "best practices for microservices authentication")',
+                },
+                num_results: {
+                    type: 'number',
+                    description: 'Number of results to return (default: 5, max: 20)',
+                },
+                search_type: {
+                    type: 'string',
+                    enum: ['neural', 'keyword', 'auto'],
+                    description: 'Search type: neural (semantic, default), keyword (traditional), or auto',
+                },
+                include_domains: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional: Only include results from these domains (e.g., ["github.com", "stackoverflow.com"])',
+                },
+                exclude_domains: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional: Exclude results from these domains',
+                },
+                start_published_date: {
+                    type: 'string',
+                    description: 'Optional: Only include results published after this date (ISO format, e.g., "2024-01-01")',
+                },
+                use_autoprompt: {
+                    type: 'boolean',
+                    description: 'Let Exa optimize the query for better results (default: true)',
+                },
+            },
+            required: ['query'],
+        },
+    },
+    exa_find_similar: {
+        name: 'exa_find_similar',
+        annotations: {
+            title: 'Find Similar Pages',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+        description: 'Find web pages similar to a given URL. Useful for discovering related documentation, alternative libraries, or similar projects.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: {
+                    type: 'string',
+                    description: 'The URL to find similar pages for (e.g., "https://github.com/anthropics/claude-code")',
+                },
+                num_results: {
+                    type: 'number',
+                    description: 'Number of results to return (default: 5, max: 20)',
+                },
+                include_domains: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional: Only include results from these domains',
+                },
+                exclude_domains: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional: Exclude results from these domains',
+                },
+            },
+            required: ['url'],
+        },
+    },
+    exa_get_contents: {
+        name: 'exa_get_contents',
+        annotations: {
+            title: 'Get Page Contents',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+        description: 'Get the full text content of web pages by their URLs. Use after exa_web_search to read the full content of interesting results.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                urls: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'URLs to fetch content from (max 10)',
+                },
+                max_characters: {
+                    type: 'number',
+                    description: 'Maximum characters to return per page (default: 3000)',
+                },
+            },
+            required: ['urls'],
+        },
+    },
+};
+// ============================================
+// Exa API Helper
+// ============================================
+// ============================================
+// Tool Handlers
+// ============================================
+//# sourceMappingURL=exa.js.map

package/dist/tools/exa.js.map

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

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"}