@dobbyai/mcp-external 1.0.4 → 1.2.0

package/dist/tools/sessions.js

@@ -0,0 +1,130 @@
+/**
+ * Session Management Tools
+ *
+ * MCP tools for managing agent sessions.
+ */
+// ============================================
+// Tool Definitions
+// ============================================
+export const sessionTools = {
+    session_list: {
+        name: 'session_list',
+        annotations: {
+            title: 'List Sessions',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'List agent sessions with optional filters (status, type, framework)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                status: {
+                    type: 'string',
+                    enum: ['initializing', 'running', 'idle', 'paused', 'completed', 'failed', 'cancelled'],
+                    description: 'Filter by session status',
+                },
+                session_type: {
+                    type: 'string',
+                    enum: ['interactive', 'scheduled', 'triggered', 'autonomous'],
+                    description: 'Filter by session type',
+                },
+                agent_framework: {
+                    type: 'string',
+                    enum: ['dobby', 'crewai', 'langchain', 'openai', 'claude', 'custom'],
+                    description: 'Filter by agent framework',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of sessions to return (default: 20)',
+                },
+            },
+        },
+    },
+    session_detail: {
+        name: 'session_detail',
+        annotations: {
+            title: 'Get Session Detail',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Get detailed information about a specific session including recent events',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session_id: {
+                    type: 'string',
+                    description: 'The session ID (format: ses_xxxxx)',
+                },
+            },
+            required: ['session_id'],
+        },
+    },
+    session_create: {
+        name: 'session_create',
+        annotations: {
+            title: 'Create Session',
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: 'Start a new agent session',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: {
+                    type: 'string',
+                    description: 'The agent ID to start a session for',
+                },
+                agent_source: {
+                    type: 'string',
+                    enum: ['internal', 'external', 'control_plane'],
+                    description: 'Source of the agent',
+                },
+                title: {
+                    type: 'string',
+                    description: 'Session title',
+                },
+                session_type: {
+                    type: 'string',
+                    enum: ['interactive', 'scheduled', 'triggered', 'autonomous'],
+                    description: 'Type of session (default: interactive)',
+                },
+            },
+            required: ['agent_id', 'agent_source'],
+        },
+    },
+    session_events: {
+        name: 'session_events',
+        annotations: {
+            title: 'Get Session Events',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Get the event timeline for a session (messages, tool calls, status changes)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session_id: {
+                    type: 'string',
+                    description: 'The session ID (format: ses_xxxxx)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of events to return (default: 50)',
+                },
+                event_type: {
+                    type: 'string',
+                    description: 'Filter by event type (e.g., agent.message, agent.tool_use)',
+                },
+            },
+            required: ['session_id'],
+        },
+    },
+};
+// ============================================
+// Handler Functions
+// ============================================
+//# sourceMappingURL=sessions.js.map

package/dist/tools/sessions.js.map

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

package/dist/tools/setup-status.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Setup Status MCP Tool
+ *
+ * Lets a customer's own LLM ask "where am I in Dobby setup, and what's next?".
+ * Reads the redesigned "first value" Setup Guide progress for the current tenant.
+ *   get_setup_status — GET /api/v1/tenants/{tenantId}/setup-progress
+ *
+ * Completion is server-derived from the real primitives (workload connector /
+ * gateway key / workload run / registered agent / compliance scan), so it is
+ * correct whether a milestone was reached via the UI, this MCP, or the SDK.
+ */
+export declare const setupStatusTools: {
+    get_setup_status: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+    };
+};
+//# sourceMappingURL=setup-status.d.ts.map

package/dist/tools/setup-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-status.d.ts","sourceRoot":"","sources":["../../src/tools/setup-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;CAiB5B,CAAC"}

package/dist/tools/setup-status.js

@@ -0,0 +1,35 @@
+/**
+ * Setup Status MCP Tool
+ *
+ * Lets a customer's own LLM ask "where am I in Dobby setup, and what's next?".
+ * Reads the redesigned "first value" Setup Guide progress for the current tenant.
+ *   get_setup_status — GET /api/v1/tenants/{tenantId}/setup-progress
+ *
+ * Completion is server-derived from the real primitives (workload connector /
+ * gateway key / workload run / registered agent / compliance scan), so it is
+ * correct whether a milestone was reached via the UI, this MCP, or the SDK.
+ */
+export const setupStatusTools = {
+    get_setup_status: {
+        name: "get_setup_status",
+        annotations: {
+            title: "Get Setup Status",
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "For the current tenant, report onboarding progress toward the first monitored run: the ordered setup milestones (connect a workload, capture a run, register an agent, first compliance scan), which are done, the overall percent, and the single next step to take. Use this to guide a user through initial setup.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+};
+// The get_setup_status handler is now served from the shared Capability
+// Registry (@dobbyai/capability-core, ADR-019 Phase 1). The registry returns a
+// protocol-neutral CapabilityResult; toMcpResult wraps it into the exact
+// {content:[{type:'text'}]} envelope this tool emitted before (byte-identical).
+// The local SetupProgressResponse type above is retained only for the
+// definition block; the handler logic lives in the registry.
+//# sourceMappingURL=setup-status.js.map

package/dist/tools/setup-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-status.js","sourceRoot":"","sources":["../../src/tools/setup-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,gBAAgB,EAAE;QAChB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE;YACX,KAAK,EAAE,kBAAkB;YACzB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,uTAAuT;QACzT,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb;KACF;CACF,CAAC;AAIF,wEAAwE;AACxE,+EAA+E;AAC/E,yEAAyE;AACzE,gFAAgF;AAChF,sEAAsE;AACtE,6DAA6D"}

package/dist/tools/tasks.d.ts

@@ -3,10 +3,15 @@
  *
  * MCP tools for managing Dobby tasks.
  */
-import { DobbyClient } from '../lib/dobby-client.js';
 export declare const taskTools: {
     create_task: {
         name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
         description: string;
         inputSchema: {
             type: "object";
@@ -34,6 +39,12 @@ export declare const taskTools: {
     };
     list_tasks: {
         name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
         description: string;
         inputSchema: {
             type: "object";
@@ -48,6 +59,10 @@ export declare const taskTools: {
                     enum: string[];
                     description: string;
                 };
+                assigned_to: {
+                    type: string;
+                    description: string;
+                };
                 limit: {
                     type: string;
                     description: string;
@@ -57,6 +72,12 @@ export declare const taskTools: {
     };
     get_task: {
         name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
         description: string;
         inputSchema: {
             type: "object";
@@ -64,6 +85,7 @@ export declare const taskTools: {
                 task_id: {
                     type: string;
                     description: string;
+                    pattern: string;
                 };
             };
             required: string[];
@@ -71,6 +93,12 @@ export declare const taskTools: {
     };
     update_task: {
         name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
         description: string;
         inputSchema: {
             type: "object";
@@ -78,6 +106,7 @@ export declare const taskTools: {
                 task_id: {
                     type: string;
                     description: string;
+                    pattern: string;
                 };
                 status: {
                     type: string;
@@ -95,6 +124,12 @@ export declare const taskTools: {
     };
     get_task_timeline: {
         name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
         description: string;
         inputSchema: {
             type: "object";
@@ -102,6 +137,7 @@ export declare const taskTools: {
                 task_id: {
                     type: string;
                     description: string;
+                    pattern: string;
                 };
             };
             required: string[];
@@ -109,6 +145,12 @@ export declare const taskTools: {
     };
     cancel_task: {
         name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
         description: string;
         inputSchema: {
             type: "object";
@@ -116,65 +158,11 @@ export declare const taskTools: {
                 task_id: {
                     type: string;
                     description: string;
+                    pattern: string;
                 };
             };
             required: string[];
         };
     };
 };
-export declare function handleCreateTask(client: DobbyClient, args: {
-    title: string;
-    description?: string;
-    priority?: 'high' | 'medium' | 'low';
-    link_to_task_id?: string;
-}): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;
-export declare function handleListTasks(client: DobbyClient, args: {
-    status?: string;
-    priority?: string;
-    limit?: number;
-}): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;
-export declare function handleGetTask(client: DobbyClient, args: {
-    task_id: string;
-}): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;
-export declare function handleUpdateTask(client: DobbyClient, args: {
-    task_id: string;
-    status?: string;
-    priority?: string;
-}): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;
-export declare function handleGetTaskTimeline(client: DobbyClient, args: {
-    task_id: string;
-}): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;
-export declare function handleCancelTask(client: DobbyClient, args: {
-    task_id: string;
-}): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-}>;
 //# sourceMappingURL=tasks.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAMrD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgIrB,CAAC;AAMF,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IACJ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;;;;;GAiBF;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IACJ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;;;;;GA+CF;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE;;;;;GAsD1B;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IACJ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;;;;;GAmBF;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE;;;;;GAgE1B;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE;;;;;GAuB1B"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4KrB,CAAC"}