@dobbyai/mcp-external 1.0.4 → 1.2.0

package/dist/tools/ops.js

@@ -0,0 +1,151 @@
+/**
+ * Ops Layer MCP Tools
+ *
+ * Internal platform operations tools for monitoring, issue management,
+ * and audit trail. These tools call the FastAPI /ops/* endpoints
+ * using the X-Ops-Key header (NOT gateway keys).
+ *
+ * 5 tools (Phase 1):
+ *   1. get_ops_health_summary  — overall platform health
+ *   2. get_service_status      — detailed per-service status
+ *   3. get_active_issues       — current ops issues
+ *   4. acknowledge_ops_issue   — acknowledge an issue
+ *   5. get_ops_audit_log       — recent ops events
+ */
+// ============================================
+// Tool Definitions
+// ============================================
+export const opsTools = {
+    get_ops_health_summary: {
+        name: 'get_ops_health_summary',
+        annotations: {
+            title: 'Ops Health Summary',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Get aggregated health summary across all Dobby platform services. Returns overall status (operational/degraded/partial_outage/major_outage), per-service status, anomalies detected, and new issues. This is the primary tool for checking platform health.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    get_service_status: {
+        name: 'get_service_status',
+        annotations: {
+            title: 'Service Status',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Get detailed status for a specific platform service including latency, recent events, and active issues. Use this to drill into a specific service after seeing the health summary.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                service_name: {
+                    type: 'string',
+                    description: 'Service name: web_app, python_backend, mcp_external, crew_ai, bigquery, redis_cache',
+                },
+                hours: {
+                    type: 'number',
+                    description: 'History window in hours (default: 24, max: 168)',
+                    default: 24,
+                },
+            },
+            required: ['service_name'],
+        },
+    },
+    get_active_issues: {
+        name: 'get_active_issues',
+        annotations: {
+            title: 'Active Issues',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Get active ops issues detected by the platform monitoring system. Issues are ordered by severity (critical first) and recency. Filter by status or severity.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                status: {
+                    type: 'string',
+                    enum: ['open', 'acknowledged', 'investigating', 'resolved'],
+                    description: 'Filter by issue status (default: all active)',
+                },
+                severity: {
+                    type: 'string',
+                    enum: ['low', 'medium', 'high', 'critical'],
+                    description: 'Filter by severity',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max issues to return (default: 50)',
+                    default: 50,
+                },
+            },
+        },
+    },
+    acknowledge_ops_issue: {
+        name: 'acknowledge_ops_issue',
+        annotations: {
+            title: 'Acknowledge Issue',
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: 'Acknowledge an ops issue, moving it from "open" to "acknowledged" status. This signals that someone is aware of the issue. Add optional notes explaining the acknowledgement.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issue_id: {
+                    type: 'string',
+                    description: 'The ops issue ID (e.g., ops_issue_abc123)',
+                },
+                notes: {
+                    type: 'string',
+                    description: 'Optional acknowledgement notes',
+                },
+            },
+            required: ['issue_id'],
+        },
+    },
+    get_ops_audit_log: {
+        name: 'get_ops_audit_log',
+        annotations: {
+            title: 'Ops Audit Log',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Get the immutable ops audit log showing all platform operations events including health checks, anomaly detections, issue lifecycle changes, and manual actions. Use this for investigation and compliance.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                hours: {
+                    type: 'number',
+                    description: 'Time window in hours (default: 24, max: 720)',
+                    default: 24,
+                },
+                event_type: {
+                    type: 'string',
+                    description: 'Filter by event type: health_check_run, anomaly_detected, issue_created, issue_acknowledged, issue_resolved, ops_alert_sent',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max events to return (default: 100)',
+                    default: 100,
+                },
+            },
+        },
+    },
+};
+// ============================================
+// Internal Helper — Call Ops API
+// ============================================
+// ============================================
+// Tool Handlers
+// ============================================
+// ============================================
+// Formatting Helpers
+// ============================================
+//# sourceMappingURL=ops.js.map

package/dist/tools/ops.js.map

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

package/dist/tools/orchestrations.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Multi-Agent Orchestration Tools
+ *
+ * MCP tools for managing orchestration configs, sessions, and threads.
+ */
+export declare const orchestrationTools: {
+    orchestration_config_list: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                status: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+            };
+        };
+    };
+    orchestration_start: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                config_id: {
+                    type: string;
+                    description: string;
+                };
+                title: {
+                    type: string;
+                    description: string;
+                };
+                initial_message: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    orchestration_threads: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                session_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    orchestration_thread_message: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                session_id: {
+                    type: string;
+                    description: string;
+                };
+                thread_id: {
+                    type: string;
+                    description: string;
+                };
+                message_type: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                content: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+};
+//# sourceMappingURL=orchestrations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrations.d.ts","sourceRoot":"","sources":["../../src/tools/orchestrations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyG9B,CAAC"}

package/dist/tools/orchestrations.js

@@ -0,0 +1,115 @@
+/**
+ * Multi-Agent Orchestration Tools
+ *
+ * MCP tools for managing orchestration configs, sessions, and threads.
+ */
+// ============================================
+// Tool Definitions
+// ============================================
+export const orchestrationTools = {
+    orchestration_config_list: {
+        name: 'orchestration_config_list',
+        annotations: {
+            title: 'List Orchestration Configs',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'List multi-agent orchestration configs for the organization',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                status: {
+                    type: 'string',
+                    enum: ['active', 'archived'],
+                    description: 'Filter by config status',
+                },
+            },
+        },
+    },
+    orchestration_start: {
+        name: 'orchestration_start',
+        annotations: {
+            title: 'Start Orchestrated Session',
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: 'Start a new orchestrated session with coordinator + callable agents',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                config_id: {
+                    type: 'string',
+                    description: 'The orchestration config ID (format: orch_xxxxx)',
+                },
+                title: {
+                    type: 'string',
+                    description: 'Title for the orchestrated session',
+                },
+                initial_message: {
+                    type: 'string',
+                    description: 'The initial task/message to send to the coordinator',
+                },
+            },
+            required: ['config_id', 'title', 'initial_message'],
+        },
+    },
+    orchestration_threads: {
+        name: 'orchestration_threads',
+        annotations: {
+            title: 'List Session Threads',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'List all threads in an orchestrated session with stats',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session_id: {
+                    type: 'string',
+                    description: 'The session ID (format: ses_xxxxx)',
+                },
+            },
+            required: ['session_id'],
+        },
+    },
+    orchestration_thread_message: {
+        name: 'orchestration_thread_message',
+        annotations: {
+            title: 'Send Thread Message',
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Send a message to a specific thread in an orchestrated session',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session_id: {
+                    type: 'string',
+                    description: 'The session ID (format: ses_xxxxx)',
+                },
+                thread_id: {
+                    type: 'string',
+                    description: 'The thread ID to send message to (format: thr_xxxxx)',
+                },
+                message_type: {
+                    type: 'string',
+                    enum: ['delegation', 'result', 'question', 'update', 'interrupt'],
+                    description: 'Type of message',
+                },
+                content: {
+                    type: 'string',
+                    description: 'Message content',
+                },
+            },
+            required: ['session_id', 'thread_id', 'message_type', 'content'],
+        },
+    },
+};
+// ============================================
+// Handler Functions
+// ============================================
+//# sourceMappingURL=orchestrations.js.map

package/dist/tools/orchestrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrations.js","sourceRoot":"","sources":["../../src/tools/orchestrations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAE/C,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,yBAAyB,EAAE;QACzB,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE;YACX,KAAK,EAAE,4BAA4B;YACnC,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EAAE,6DAA6D;QAC1E,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;oBAC5B,WAAW,EAAE,yBAAyB;iBACvC;aACF;SACF;KACF;IAED,mBAAmB,EAAE;QACnB,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE;YACX,KAAK,EAAE,4BAA4B;YACnC,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EAAE,qEAAqE;QAClF,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kDAAkD;iBAChE;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oCAAoC;iBAClD;gBACD,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qDAAqD;iBACnE;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,iBAAiB,CAAC;SACpD;KACF;IAED,qBAAqB,EAAE;QACrB,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE;YACX,KAAK,EAAE,sBAAsB;YAC7B,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EAAE,wDAAwD;QACrE,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oCAAoC;iBAClD;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;SACzB;KACF;IAED,4BAA4B,EAAE;QAC5B,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE;YACX,KAAK,EAAE,qBAAqB;YAC5B,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EAAE,gEAAgE;QAC7E,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oCAAoC;iBAClD;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sDAAsD;iBACpE;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC;oBACjE,WAAW,EAAE,iBAAiB;iBAC/B;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iBAAiB;iBAC/B;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,CAAC;SACjE;KACF;CACF,CAAC;AAEF,+CAA+C;AAC/C,oBAAoB;AACpB,+CAA+C"}

package/dist/tools/outcomes.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Outcomes & Grading Tools
+ *
+ * MCP tools for managing rubrics, outcomes, and evaluations.
+ */
+export declare const outcomeTools: {
+    rubric_list: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                status: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+            };
+        };
+    };
+    rubric_create: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                name: {
+                    type: string;
+                    description: string;
+                };
+                description: {
+                    type: string;
+                    description: string;
+                };
+                rubric_content: {
+                    type: string;
+                    description: string;
+                };
+                criteria: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            id: {
+                                type: string;
+                            };
+                            name: {
+                                type: string;
+                            };
+                            description: {
+                                type: string;
+                            };
+                            weight: {
+                                type: string;
+                            };
+                        };
+                        required: string[];
+                    };
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    outcome_define: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                description: {
+                    type: string;
+                    description: string;
+                };
+                rubric_id: {
+                    type: string;
+                    description: string;
+                };
+                max_iterations: {
+                    type: string;
+                    description: string;
+                };
+                session_id: {
+                    type: string;
+                    description: string;
+                };
+                task_id: {
+                    type: string;
+                    description: string;
+                };
+                agent_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    outcome_status: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                outcome_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+};
+//# sourceMappingURL=outcomes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outcomes.d.ts","sourceRoot":"","sources":["../../src/tools/outcomes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8HxB,CAAC"}

package/dist/tools/outcomes.js

@@ -0,0 +1,136 @@
+/**
+ * Outcomes & Grading Tools
+ *
+ * MCP tools for managing rubrics, outcomes, and evaluations.
+ */
+// ============================================
+// Tool Definitions
+// ============================================
+export const outcomeTools = {
+    rubric_list: {
+        name: 'rubric_list',
+        annotations: {
+            title: 'List Rubrics',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'List outcome rubrics for the organization. Rubrics define success criteria for agent work.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                status: {
+                    type: 'string',
+                    enum: ['active', 'archived'],
+                    description: 'Filter by status (default: all)',
+                },
+            },
+        },
+    },
+    rubric_create: {
+        name: 'rubric_create',
+        annotations: {
+            title: 'Create Rubric',
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Create a new outcome rubric with criteria for evaluating agent output quality.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    description: 'Rubric name (e.g., "Code Review Quality")',
+                },
+                description: {
+                    type: 'string',
+                    description: 'What this rubric evaluates',
+                },
+                rubric_content: {
+                    type: 'string',
+                    description: 'Markdown rubric text with criteria sections',
+                },
+                criteria: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            id: { type: 'string' },
+                            name: { type: 'string' },
+                            description: { type: 'string' },
+                            weight: { type: 'number' },
+                        },
+                        required: ['id', 'name'],
+                    },
+                    description: 'Structured criteria list (1-50 items)',
+                },
+            },
+            required: ['name', 'rubric_content', 'criteria'],
+        },
+    },
+    outcome_define: {
+        name: 'outcome_define',
+        annotations: {
+            title: 'Define Outcome',
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Define a success outcome for an agent task. Links to a rubric and sets up auto-grading.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                description: {
+                    type: 'string',
+                    description: 'What the agent should achieve (e.g., "Build analysis report")',
+                },
+                rubric_id: {
+                    type: 'string',
+                    description: 'Rubric ID to use for grading (format: rub_xxxxx)',
+                },
+                max_iterations: {
+                    type: 'number',
+                    description: 'Max evaluation iterations (1-20, default: 3)',
+                },
+                session_id: {
+                    type: 'string',
+                    description: 'Session ID to link to (format: ses_xxxxx)',
+                },
+                task_id: {
+                    type: 'string',
+                    description: 'Task ID to link to',
+                },
+                agent_id: {
+                    type: 'string',
+                    description: 'Agent working on this outcome',
+                },
+            },
+            required: ['description'],
+        },
+    },
+    outcome_status: {
+        name: 'outcome_status',
+        annotations: {
+            title: 'Check Outcome Status',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Check the status of an outcome including evaluation history and scores.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                outcome_id: {
+                    type: 'string',
+                    description: 'Outcome ID (format: out_xxxxx)',
+                },
+            },
+            required: ['outcome_id'],
+        },
+    },
+};
+// ============================================
+// Handler Functions
+// ============================================
+//# sourceMappingURL=outcomes.js.map

package/dist/tools/outcomes.js.map

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