@dobbyai/mcp-external 1.0.4 → 1.2.0

package/dist/tools/external-agents.js

@@ -0,0 +1,386 @@
+/**
+ * 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
+ */
+// ============================================
+// Tool Definitions
+// ============================================
+export const externalAgentTools = {
+    register_external_agent: {
+        name: "register_external_agent",
+        annotations: {
+            title: "Register External Agent",
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: "Register a new external agent (BYOA). Auto-provisions a gk_svc_* gateway key that the agent uses to call back (events, LLM). The gateway key is returned ONCE — save it immediately. Registering without endpoint_url creates the agent in 'draft' status — not live and excluded from auto-classification until you set endpoint_url and status 'active' via update_external_agent.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                display_name: {
+                    type: "string",
+                    description: "Agent display name (3–100 chars)",
+                },
+                description: { type: "string", description: "Optional description" },
+                framework: {
+                    type: "string",
+                    enum: [
+                        "crewai",
+                        "langchain",
+                        "openai",
+                        "autogen",
+                        "adk",
+                        "claude_code",
+                        "custom",
+                    ],
+                    description: "Agent framework",
+                },
+                protocol: {
+                    type: "string",
+                    enum: ["a2a", "mcp", "rest", "webhook", "local"],
+                    description: "Communication protocol",
+                },
+                endpoint_url: {
+                    type: "string",
+                    description: "URL where the agent is reachable (required for remote protocols)",
+                },
+                health_check_url: {
+                    type: "string",
+                    description: "Optional URL for health checks",
+                },
+                capabilities: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: 'List of capability tags (e.g. ["research","email"])',
+                },
+                tags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "User-defined tags",
+                },
+                tenant_id: {
+                    type: "string",
+                    description: "Optional tenant scope. Inherits from the gateway key when omitted.",
+                },
+                auth_config: {
+                    type: "object",
+                    description: 'Optional auth for calling the agent endpoint. Supported methods: {method:"none"}, {method:"api_key",header,prefix,key}, {method:"custom_headers",headers:{...}}',
+                },
+            },
+            required: ["display_name", "framework", "protocol"],
+        },
+    },
+    list_external_agents: {
+        name: "list_external_agents",
+        annotations: {
+            title: "List External Agents",
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "List external agents for the current org. Optionally filter by tenant or status. A tenant-scoped listing (tenant-scoped key, or the tenant_id filter) also includes org-level agents (tenant_id null — e.g. agents auto-synced from Claude Code), never another tenant's. For the full unified fleet including native agents use list_all_agents.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                tenant_id: { type: "string", description: "Filter by tenant" },
+                status: {
+                    type: "string",
+                    enum: ["draft", "active", "unreachable", "paused", "revoked"],
+                    description: "Filter by lifecycle status",
+                },
+            },
+        },
+    },
+    get_external_agent: {
+        name: "get_external_agent",
+        annotations: {
+            title: "Get External Agent",
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "Fetch a single external agent by ID.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string", description: "Agent ID (ext_...)" },
+            },
+            required: ["agent_id"],
+        },
+    },
+    update_external_agent: {
+        name: "update_external_agent",
+        annotations: {
+            title: "Update External Agent",
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: "Update a registered external agent (display_name, endpoint, capabilities, status=paused|active, auth_config, outbound_credentials).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string", description: "Agent ID (ext_...)" },
+                display_name: { type: "string" },
+                description: { type: "string" },
+                endpoint_url: { type: "string" },
+                health_check_url: { type: "string" },
+                capabilities: { type: "array", items: { type: "string" } },
+                tags: { type: "array", items: { type: "string" } },
+                status: { type: "string", enum: ["active", "paused"] },
+                auth_config: {
+                    type: "object",
+                    description: "Replacement auth config (use null to clear).",
+                },
+                outbound_credentials: {
+                    type: "array",
+                    description: "Declare (attest to) this agent's own OUTBOUND credential dependencies — e.g. its own Gemini API key it needs to call Google. Metadata ONLY: Dobby never stores the secret value, only what it's called and where the agent reads it from, for compliance evidence. Replaces the full list on each call.",
+                    items: {
+                        type: "object",
+                        properties: {
+                            provider: {
+                                type: "string",
+                                description: "e.g. 'google_gemini', 'openai', 'stripe'.",
+                            },
+                            env_var_name: {
+                                type: "string",
+                                description: "The env var name the agent reads it from, e.g. 'GEMINI_API_KEY'.",
+                            },
+                            rotation_policy: {
+                                type: "string",
+                                description: "Optional free-text rotation policy note.",
+                            },
+                        },
+                        required: ["provider", "env_var_name"],
+                    },
+                },
+            },
+            required: ["agent_id"],
+        },
+    },
+    deregister_external_agent: {
+        name: "deregister_external_agent",
+        annotations: {
+            title: "Deregister External Agent",
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: "Deregister an external agent. Revokes its gateway key and sets status to `revoked`. Cannot be undone — register a new one if needed.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string", description: "Agent ID (ext_...)" },
+            },
+            required: ["agent_id"],
+        },
+    },
+    trigger_external_agent: {
+        name: "trigger_external_agent",
+        annotations: {
+            title: "Trigger External Agent",
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: 'Fire an external agent synchronously via its configured endpoint. Inputs are framework-specific (e.g. CrewAI expects `{topic:"..."}`). Returns a trigger_id and status. Long-running triggers are logged and their completion events arrive via the callback webhook.',
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string", description: "Agent ID (ext_...)" },
+                inputs: {
+                    type: "object",
+                    description: "Framework-specific input payload (maps to request body).",
+                },
+            },
+            required: ["agent_id"],
+        },
+    },
+    get_agent_triggers: {
+        name: "get_agent_triggers",
+        annotations: {
+            title: "Get Agent Trigger History",
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "List recent trigger invocations for an external agent, newest first. Supports pagination and optional aggregated stats.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string", description: "Agent ID (ext_...)" },
+                page: {
+                    type: "number",
+                    description: "1-based page number (default 1)",
+                },
+                page_size: {
+                    type: "number",
+                    description: "Page size 1–50 (default 10)",
+                },
+                status: {
+                    type: "string",
+                    enum: [
+                        "pending",
+                        "sent",
+                        "acknowledged",
+                        "completed",
+                        "failed",
+                        "timed_out",
+                    ],
+                    description: "Filter by trigger status",
+                },
+                include_stats: {
+                    type: "boolean",
+                    description: "Also return aggregated stats (total, completed, failed, avg_duration).",
+                },
+            },
+            required: ["agent_id"],
+        },
+    },
+    create_agent_schedule: {
+        name: "create_agent_schedule",
+        annotations: {
+            title: "Create Agent Schedule",
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: "Create a recurring schedule for an external agent (daily/weekly/hourly). One schedule per agent — use update_agent_schedule (PATCH) to modify. Returns the created schedule.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string", description: "Agent ID (ext_...)" },
+                name: { type: "string", description: "Schedule name shown in UI" },
+                description: { type: "string" },
+                task_title: {
+                    type: "string",
+                    description: "Title for the task created on each run",
+                },
+                task_description: { type: "string" },
+                schedule_config: {
+                    type: "object",
+                    description: 'Frequency config: { frequency: "daily"|"hourly"|"weekly"|..., time?: "HH:MM", dayOfWeek?, dayOfMonth? }',
+                },
+                trigger_payload: {
+                    type: "object",
+                    description: "Payload passed to the agent on each run (inputs).",
+                },
+                overlap_policy: {
+                    type: "string",
+                    enum: ["skip", "queue", "allow"],
+                    description: "What to do when previous run is still active (default: skip)",
+                },
+            },
+            required: ["agent_id", "name", "task_title", "schedule_config"],
+        },
+    },
+    update_agent_schedule: {
+        name: "update_agent_schedule",
+        annotations: {
+            title: "Update Agent Schedule",
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: "Update a running schedule for an external agent. Pass `paused: true` to pause runs (with optional `pause_reason`), `paused: false` to resume. Other fields (`name`, `schedule_config`, `task_title`, `task_description`, `trigger_payload`) are updated in place.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string", description: "Agent ID (ext_...)" },
+                paused: {
+                    type: "boolean",
+                    description: "True to pause, false to resume",
+                },
+                pause_reason: {
+                    type: "string",
+                    description: "Audit note stored when pausing (ignored when paused is not true)",
+                },
+                name: { type: "string", description: "New schedule name" },
+                schedule_config: {
+                    type: "object",
+                    description: 'Replacement frequency config, e.g. { frequency: "hourly" }',
+                },
+                task_title: { type: "string" },
+                task_description: { type: "string" },
+                trigger_payload: {
+                    type: "object",
+                    description: "Replacement payload passed on each run",
+                },
+            },
+            required: ["agent_id"],
+        },
+    },
+    delete_agent_schedule: {
+        name: "delete_agent_schedule",
+        annotations: {
+            title: "Delete Agent Schedule",
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: "Disable the schedule for an external agent (soft delete — sets enabled=false).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string", description: "Agent ID (ext_...)" },
+            },
+            required: ["agent_id"],
+        },
+    },
+    retry_external_agent_trigger: {
+        name: "retry_external_agent_trigger",
+        annotations: {
+            title: "Retry External Agent Trigger",
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: "Retry a previously failed or timed-out trigger by reusing its original payload. Returns the new trigger_id and status. 400 if the original trigger is in a non-retryable state (completed/sent/etc.), 404 if the trigger does not exist.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string", description: "Agent ID (ext_...)" },
+                trigger_id: {
+                    type: "string",
+                    description: "Trigger ID to retry (trig_...)",
+                },
+            },
+            required: ["agent_id", "trigger_id"],
+        },
+    },
+    get_agent_costs: {
+        name: "get_agent_costs",
+        annotations: {
+            title: "Get Agent Costs",
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "Get month-to-date LLM cost summary + daily breakdown for an external agent (via the gateway cost log).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string", description: "Agent ID (ext_...)" },
+                days: {
+                    type: "number",
+                    description: "Days of daily breakdown (1–90, default 30)",
+                },
+            },
+            required: ["agent_id"],
+        },
+    },
+};
+// ============================================
+// Handlers
+// ============================================
+//# sourceMappingURL=external-agents.js.map

package/dist/tools/external-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-agents.js","sourceRoot":"","sources":["../../src/tools/external-agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAE/C,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,uBAAuB,EAAE;QACvB,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE;YACX,KAAK,EAAE,yBAAyB;YAChC,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,sXAAsX;QACxX,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kCAAkC;iBAChD;gBACD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;gBACpE,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE;wBACJ,QAAQ;wBACR,WAAW;wBACX,QAAQ;wBACR,SAAS;wBACT,KAAK;wBACL,aAAa;wBACb,QAAQ;qBACT;oBACD,WAAW,EAAE,iBAAiB;iBAC/B;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;oBAChD,WAAW,EAAE,wBAAwB;iBACtC;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,kEAAkE;iBACrE;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gCAAgC;iBAC9C;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,qDAAqD;iBACnE;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,mBAAmB;iBACjC;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,oEAAoE;iBACvE;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,iKAAiK;iBACpK;aACF;YACD,QAAQ,EAAE,CAAC,cAAc,EAAE,WAAW,EAAE,UAAU,CAAC;SACpD;KACF;IAED,oBAAoB,EAAE;QACpB,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE;YACX,KAAK,EAAE,sBAAsB;YAC7B,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,mVAAmV;QACrV,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;gBAC9D,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,CAAC;oBAC7D,WAAW,EAAE,4BAA4B;iBAC1C;aACF;SACF;KACF;IAED,kBAAkB,EAAE;QAClB,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE;YACX,KAAK,EAAE,oBAAoB;YAC3B,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EAAE,sCAAsC;QACnD,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;aAChE;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;KACF;IAED,qBAAqB,EAAE;QACrB,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE;YACX,KAAK,EAAE,uBAAuB;YAC9B,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,qIAAqI;QACvI,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;gBAC/D,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAChC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC/B,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAChC,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACpC,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;gBAC1D,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;gBAClD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE;gBACtD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8CAA8C;iBAC5D;gBACD,oBAAoB,EAAE;oBACpB,IAAI,EAAE,OAAO;oBACb,WAAW,EACT,ySAAyS;oBAC3S,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,QAAQ,EAAE;gCACR,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,2CAA2C;6BACzD;4BACD,YAAY,EAAE;gCACZ,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,kEAAkE;6BACrE;4BACD,eAAe,EAAE;gCACf,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,0CAA0C;6BACxD;yBACF;wBACD,QAAQ,EAAE,CAAC,UAAU,EAAE,cAAc,CAAC;qBACvC;iBACF;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;KACF;IAED,yBAAyB,EAAE;QACzB,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE;YACX,KAAK,EAAE,2BAA2B;YAClC,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,sIAAsI;QACxI,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;aAChE;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;KACF;IAED,sBAAsB,EAAE;QACtB,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE;YACX,KAAK,EAAE,wBAAwB;YAC/B,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,uQAAuQ;QACzQ,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;gBAC/D,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,0DAA0D;iBAC7D;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;KACF;IAED,kBAAkB,EAAE;QAClB,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE;YACX,KAAK,EAAE,2BAA2B;YAClC,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,yHAAyH;QAC3H,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;gBAC/D,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iCAAiC;iBAC/C;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6BAA6B;iBAC3C;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE;wBACJ,SAAS;wBACT,MAAM;wBACN,cAAc;wBACd,WAAW;wBACX,QAAQ;wBACR,WAAW;qBACZ;oBACD,WAAW,EAAE,0BAA0B;iBACxC;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,wEAAwE;iBAC3E;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;KACF;IAED,qBAAqB,EAAE;QACrB,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE;YACX,KAAK,EAAE,uBAAuB;YAC9B,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,8KAA8K;QAChL,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;gBAC/D,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;gBAClE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC/B,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wCAAwC;iBACtD;gBACD,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACpC,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,yGAAyG;iBAC5G;gBACD,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mDAAmD;iBACjE;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;oBAChC,WAAW,EACT,8DAA8D;iBACjE;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,CAAC;SAChE;KACF;IAED,qBAAqB,EAAE;QACrB,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE;YACX,KAAK,EAAE,uBAAuB;YAC9B,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,mQAAmQ;QACrQ,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;gBAC/D,MAAM,EAAE;oBACN,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,gCAAgC;iBAC9C;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,kEAAkE;iBACrE;gBACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;gBAC1D,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,4DAA4D;iBAC/D;gBACD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC9B,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACpC,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wCAAwC;iBACtD;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;KACF;IAED,qBAAqB,EAAE;QACrB,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE;YACX,KAAK,EAAE,uBAAuB;YAC9B,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,gFAAgF;QAClF,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;aAChE;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;KACF;IAED,4BAA4B,EAAE;QAC5B,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE;YACX,KAAK,EAAE,8BAA8B;YACrC,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,0OAA0O;QAC5O,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;gBAC/D,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gCAAgC;iBAC9C;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;SACrC;KACF;IAED,eAAe,EAAE;QACf,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE;YACX,KAAK,EAAE,iBAAiB;YACxB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,wGAAwG;QAC1G,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;gBAC/D,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;iBAC1D;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;KACF;CACF,CAAC;AAEF,+CAA+C;AAC/C,WAAW;AACX,+CAA+C"}

package/dist/tools/github-mcp.d.ts

@@ -0,0 +1,228 @@
+/**
+ * GitHub MCP Integration Tools
+ *
+ * Phase 1, Task 1.1: Connect GitHub MCP Server to Dobby.
+ * Provides tools for code management, PR automation, and CI/CD monitoring
+ * through the official GitHub MCP Server (ghcr.io/github/github-mcp-server).
+ */
+export declare const githubMcpTools: {
+    github_search_code: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                query: {
+                    type: string;
+                    description: string;
+                };
+                repo: {
+                    type: string;
+                    description: string;
+                };
+                language: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    github_get_file: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                repo: {
+                    type: string;
+                    description: string;
+                };
+                path: {
+                    type: string;
+                    description: string;
+                };
+                branch: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    github_create_pr: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                repo: {
+                    type: string;
+                    description: string;
+                };
+                title: {
+                    type: string;
+                    description: string;
+                };
+                body: {
+                    type: string;
+                    description: string;
+                };
+                head: {
+                    type: string;
+                    description: string;
+                };
+                base: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    github_list_prs: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                repo: {
+                    type: string;
+                    description: string;
+                };
+                state: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                limit: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    github_list_issues: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                repo: {
+                    type: string;
+                    description: string;
+                };
+                state: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                labels: {
+                    type: string;
+                    description: string;
+                };
+                limit: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    github_create_issue: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                repo: {
+                    type: string;
+                    description: string;
+                };
+                title: {
+                    type: string;
+                    description: string;
+                };
+                body: {
+                    type: string;
+                    description: string;
+                };
+                labels: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    github_get_workflow_runs: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                repo: {
+                    type: string;
+                    description: string;
+                };
+                status: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                limit: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+};
+//# sourceMappingURL=github-mcp.d.ts.map

package/dist/tools/github-mcp.d.ts.map

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