@dobbyai/mcp-external 1.0.4 → 1.2.0

package/dist/tools/approvals.js

@@ -10,6 +10,12 @@ export const approvalTools = {
     // Get pending approvals
     get_pending_approvals: {
         name: 'get_pending_approvals',
+        annotations: {
+            title: 'Get Pending Approvals',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
         description: 'Get all pending approval requests that need your attention',
         inputSchema: {
             type: 'object',
@@ -19,6 +25,12 @@ export const approvalTools = {
     // Approve a task/request (triggers automatic PR merge)
     approve_task: {
         name: 'approve_task',
+        annotations: {
+            title: 'Approve Task',
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
         description: 'Approve a pending approval request. The agent will automatically merge the PR and complete the task.',
         inputSchema: {
             type: 'object',
@@ -38,6 +50,12 @@ export const approvalTools = {
     // Reject a task/request (triggers automatic retry with feedback)
     reject_task: {
         name: 'reject_task',
+        annotations: {
+            title: 'Reject Task',
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
         description: 'Reject a pending approval request. The agent will automatically retry and address your feedback.',
         inputSchema: {
             type: 'object',
@@ -57,6 +75,12 @@ export const approvalTools = {
     // Request changes
     request_changes: {
         name: 'request_changes',
+        annotations: {
+            title: 'Request Changes',
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
         description: 'Request changes to a pending approval (PR needs modifications)',
         inputSchema: {
             type: 'object',
@@ -77,88 +101,7 @@ export const approvalTools = {
 // ============================================
 // Tool Handlers
 // ============================================
-export async function handleGetPendingApprovals(client) {
-    const approvals = await client.getPendingApprovals();
-    if (approvals.length === 0) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: '✨ No pending approvals! All caught up.',
-                },
-            ],
-        };
-    }
-    const approvalList = approvals
-        .map((approval, i) => {
-        const typeEmoji = {
-            pr_create: '📝',
-            pr_merge: '🔀',
-            deploy: '🚀',
-            destructive: '⚠️',
-        }[approval.approval_type] || '❓';
-        const timeSince = getTimeSince(new Date(approval.created_at));
-        return `${i + 1}. ${typeEmoji} **${approval.approval_type.replace('_', ' ').toUpperCase()}**
-   ID: \`${approval.id}\`
-   Task: \`${approval.task_id}\`
-   ${approval.description}
-   ⏰ Waiting: ${timeSince}`;
-    })
-        .join('\n\n');
-    return {
-        content: [
-            {
-                type: 'text',
-                text: `# 🔔 Pending Approvals (${approvals.length})\n\n${approvalList}\n\n---\nUse \`approve_task\` or \`reject_task\` to respond.`,
-            },
-        ],
-    };
-}
-export async function handleApproveTask(client, args) {
-    const result = await client.approveTask(args.approval_id, args.note);
-    return {
-        content: [
-            {
-                type: 'text',
-                text: `✅ **Approved!** ${args.approval_id}${args.note ? `\n\nNote: "${args.note}"` : ''}\n\n🔀 The agent is now merging the PR automatically. Use \`get_task_timeline\` to track progress.`,
-            },
-        ],
-    };
-}
-export async function handleRejectTask(client, args) {
-    const result = await client.rejectTask(args.approval_id, args.reason);
-    return {
-        content: [
-            {
-                type: 'text',
-                text: `❌ **Rejected!** ${args.approval_id}${args.reason ? `\n\n💬 Feedback: "${args.reason}"` : ''}\n\n🔁 The agent is now retrying and will address your feedback. Use \`get_task_timeline\` to track progress.`,
-            },
-        ],
-    };
-}
-export async function handleRequestChanges(client, args) {
-    // For now, this is implemented as a rejection with feedback
-    await client.rejectTask(args.approval_id, `Changes requested: ${args.changes}`);
-    return {
-        content: [
-            {
-                type: 'text',
-                text: `📝 Changes requested for: ${args.approval_id}\n\n"${args.changes}"\n\nThe agent will make the requested modifications.`,
-            },
-        ],
-    };
-}
 // ============================================
 // Helpers
 // ============================================
-function getTimeSince(date) {
-    const seconds = Math.floor((Date.now() - date.getTime()) / 1000);
-    if (seconds < 60)
-        return `${seconds} seconds ago`;
-    if (seconds < 3600)
-        return `${Math.floor(seconds / 60)} minutes ago`;
-    if (seconds < 86400)
-        return `${Math.floor(seconds / 3600)} hours ago`;
-    return `${Math.floor(seconds / 86400)} days ago`;
-}
 //# sourceMappingURL=approvals.js.map

package/dist/tools/approvals.js.map

@@ -1 +1 @@
-{"version":3,"file":"approvals.js","sourceRoot":"","sources":["../../src/tools/approvals.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"approvals.js","sourceRoot":"","sources":["../../src/tools/approvals.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAE/C,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,wBAAwB;IACxB,qBAAqB,EAAE;QACrB,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE;YACX,KAAK,EAAE,uBAAuB;YAC9B,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EAAE,4DAA4D;QACzE,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE,EAAE;SACf;KACF;IAED,uDAAuD;IACvD,YAAY,EAAE;QACZ,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE;YACX,KAAK,EAAE,cAAc;YACrB,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EAAE,sGAAsG;QACnH,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4BAA4B;iBAC1C;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;iBAC1D;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,CAAC;SAC1B;KACF;IAED,iEAAiE;IACjE,WAAW,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE;YACX,KAAK,EAAE,aAAa;YACpB,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EAAE,kGAAkG;QAC/G,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2BAA2B;iBACzC;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kFAAkF;iBAChG;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,CAAC;SAC1B;KACF;IAED,kBAAkB;IAClB,eAAe,EAAE;QACf,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE;YACX,KAAK,EAAE,iBAAiB;YACxB,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EAAE,gEAAgE;QAC7E,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iBAAiB;iBAC/B;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mCAAmC;iBACjD;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,EAAE,SAAS,CAAC;SACrC;KACF;CACF,CAAC;AAEF,+CAA+C;AAC/C,gBAAgB;AAChB,+CAA+C;AAC/C,+CAA+C;AAC/C,UAAU;AACV,+CAA+C"}

package/dist/tools/claude-code-sync.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Claude Code Sync Tool
+ *
+ * Syncs local Claude Code scheduled tasks with the Dobby platform.
+ * Reads SKILL.md files from ~/.claude/scheduled-tasks/ and registers them
+ * as external agents with framework='claude_code'.
+ *
+ * Bi-directional: pushes local state to Dobby, pulls Dobby-side changes back.
+ */
+export declare const claudeCodeSyncTools: {
+    sync_claude_code_agents: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                direction: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                dry_run: {
+                    type: string;
+                    description: string;
+                };
+                task_filter: {
+                    type: string;
+                    description: string;
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=claude-code-sync.d.ts.map

package/dist/tools/claude-code-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-sync.d.ts","sourceRoot":"","sources":["../../src/tools/claude-code-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC/B,CAAC"}

package/dist/tools/claude-code-sync.js

@@ -0,0 +1,52 @@
+/**
+ * Claude Code Sync Tool
+ *
+ * Syncs local Claude Code scheduled tasks with the Dobby platform.
+ * Reads SKILL.md files from ~/.claude/scheduled-tasks/ and registers them
+ * as external agents with framework='claude_code'.
+ *
+ * Bi-directional: pushes local state to Dobby, pulls Dobby-side changes back.
+ */
+// ============================================
+// Tool Definitions
+// ============================================
+export const claudeCodeSyncTools = {
+    sync_claude_code_agents: {
+        name: 'sync_claude_code_agents',
+        annotations: {
+            title: 'Sync Claude Code Agents',
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Sync local Claude Code scheduled tasks with the Dobby platform. ' +
+            'Registers new tasks as managed agents, updates existing ones, and ' +
+            'returns any changes made in the Dobby dashboard for pull-back.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                direction: {
+                    type: 'string',
+                    enum: ['push', 'pull', 'both'],
+                    description: 'Sync direction. "push" sends local state to Dobby. ' +
+                        '"pull" fetches Dobby changes. "both" (default) does bidirectional sync.',
+                },
+                dry_run: {
+                    type: 'boolean',
+                    description: 'If true, only report what would change without making modifications.',
+                },
+                task_filter: {
+                    type: 'string',
+                    description: 'Optional task ID to sync only a specific task (e.g., "morning-briefing").',
+                },
+            },
+        },
+    },
+};
+// ============================================
+// SKILL.md Parser
+// ============================================
+// ============================================
+// Handler
+// ============================================
+//# sourceMappingURL=claude-code-sync.js.map

package/dist/tools/claude-code-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-sync.js","sourceRoot":"","sources":["../../src/tools/claude-code-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAE/C,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,uBAAuB,EAAE;QACvB,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE;YACX,KAAK,EAAE,yBAAyB;YAChC,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,kEAAkE;YAClE,oEAAoE;YACpE,gEAAgE;QAClE,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;oBAC9B,WAAW,EACT,qDAAqD;wBACrD,yEAAyE;iBAC5E;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,sEAAsE;iBACpF;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2EAA2E;iBACzF;aACF;SACF;KACF;CACF,CAAC;AAKF,+CAA+C;AAC/C,kBAAkB;AAClB,+CAA+C;AAI/C,+CAA+C;AAC/C,UAAU;AACV,+CAA+C"}

package/dist/tools/control-plane.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Control Plane MCP Tools
+ *
+ * Exposes Control Plane Agents functionality via MCP for Claude Desktop/Cursor/VS Code.
+ * 5 tools:
+ *   1. list_cp_reports    — List CP agent reports (maps to GET /control-plane/reports)
+ *   2. run_cp_scan        — Trigger on-demand scan (maps to POST /control-plane/run)
+ *   3. get_cp_config      — Get CP agent config (maps to GET /control-plane/config)
+ *   4. verify_audit_seal  — Verify a run's tamper-evident seal (maps to GET
+ *                           /workloads/runs/{run_id}/integrity?verify=1)
+ *   5. get_data_handling  — Tenant PII storage-mode posture (maps to GET
+ *                           /tenants/{tenant_id}/data-handling)
+ */
+export declare const controlPlaneTools: {
+    list_cp_reports: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                agent_type: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                limit: {
+                    type: string;
+                    description: string;
+                    default: number;
+                };
+                offset: {
+                    type: string;
+                    description: string;
+                    default: number;
+                };
+            };
+            required: never[];
+        };
+    };
+    run_cp_scan: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                agent_type: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    get_cp_config: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+    };
+    verify_audit_seal: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                run_id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    get_data_handling: {
+        name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+    };
+};
+//# sourceMappingURL=control-plane.d.ts.map

package/dist/tools/control-plane.d.ts.map

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

package/dist/tools/control-plane.js

@@ -0,0 +1,135 @@
+/**
+ * Control Plane MCP Tools
+ *
+ * Exposes Control Plane Agents functionality via MCP for Claude Desktop/Cursor/VS Code.
+ * 5 tools:
+ *   1. list_cp_reports    — List CP agent reports (maps to GET /control-plane/reports)
+ *   2. run_cp_scan        — Trigger on-demand scan (maps to POST /control-plane/run)
+ *   3. get_cp_config      — Get CP agent config (maps to GET /control-plane/config)
+ *   4. verify_audit_seal  — Verify a run's tamper-evident seal (maps to GET
+ *                           /workloads/runs/{run_id}/integrity?verify=1)
+ *   5. get_data_handling  — Tenant PII storage-mode posture (maps to GET
+ *                           /tenants/{tenant_id}/data-handling)
+ */
+// ============================================
+// Tool Definitions
+// ============================================
+export const controlPlaneTools = {
+    list_cp_reports: {
+        name: "list_cp_reports",
+        annotations: {
+            title: "List CP Reports",
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "List Control Plane agent reports for the current tenant. Returns automated security, cost, compliance, and health scan results. Supports filtering by agent type and pagination.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_type: {
+                    type: "string",
+                    enum: [
+                        "security_auditor",
+                        "finops_advisor",
+                        "policy_compliance",
+                        "health_monitor",
+                    ],
+                    description: "Filter by agent type (optional — omit for all)",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max reports to return (default: 10)",
+                    default: 10,
+                },
+                offset: {
+                    type: "number",
+                    description: "Offset for pagination (default: 0)",
+                    default: 0,
+                },
+            },
+            required: [],
+        },
+    },
+    run_cp_scan: {
+        name: "run_cp_scan",
+        annotations: {
+            title: "Run CP Scan",
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Trigger an on-demand Control Plane agent scan. Runs the specified agent (security_auditor, finops_advisor, policy_compliance, health_monitor) and returns the report ID. Use "all" to run all agents.',
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_type: {
+                    type: "string",
+                    enum: [
+                        "security_auditor",
+                        "finops_advisor",
+                        "policy_compliance",
+                        "health_monitor",
+                        "all",
+                    ],
+                    description: 'Which agent to run (or "all" to run all)',
+                },
+            },
+            required: ["agent_type"],
+        },
+    },
+    get_cp_config: {
+        name: "get_cp_config",
+        annotations: {
+            title: "Get CP Config",
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "Get Control Plane agent configuration for the current tenant. Returns enable/disable state, schedule, and notification settings for all 4 CP agents.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    verify_audit_seal: {
+        name: "verify_audit_seal",
+        annotations: {
+            title: "Verify Audit Seal",
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "Verify a workload run's tamper-evident audit seal. Returns the run's hash-chain seal (and its compliance scan's seal), re-projects the live source rows, and reports whether the sealed content hashes still match — cryptographic proof the evidence was not altered since sealing.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                run_id: {
+                    type: "string",
+                    description: "The workload run id (wr_...) to verify",
+                },
+            },
+            required: ["run_id"],
+        },
+    },
+    get_data_handling: {
+        name: "get_data_handling",
+        annotations: {
+            title: "Get Data Handling",
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "Return the current tenant's PII data-handling posture: the effective storage mode (minimize / redact_then_store / process_and_retain), its recorded legal basis (if any), the platform default, and each active connector's content-capture opt-in. Read-only.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+};
+// ============================================
+// Tool Handlers
+// ============================================
+//# sourceMappingURL=control-plane.js.map

package/dist/tools/control-plane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-plane.js","sourceRoot":"","sources":["../../src/tools/control-plane.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,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,kLAAkL;QACpL,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE;wBACJ,kBAAkB;wBAClB,gBAAgB;wBAChB,mBAAmB;wBACnB,gBAAgB;qBACjB;oBACD,WAAW,EAAE,gDAAgD;iBAC9D;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qCAAqC;oBAClD,OAAO,EAAE,EAAE;iBACZ;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oCAAoC;oBACjD,OAAO,EAAE,CAAC;iBACX;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IAED,WAAW,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE;YACX,KAAK,EAAE,aAAa;YACpB,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,uMAAuM;QACzM,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE;wBACJ,kBAAkB;wBAClB,gBAAgB;wBAChB,mBAAmB;wBACnB,gBAAgB;wBAChB,KAAK;qBACN;oBACD,WAAW,EAAE,0CAA0C;iBACxD;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;SACzB;KACF;IAED,aAAa,EAAE;QACb,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE;YACX,KAAK,EAAE,eAAe;YACtB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,sJAAsJ;QACxJ,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb;KACF;IAED,iBAAiB,EAAE;QACjB,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE;YACX,KAAK,EAAE,mBAAmB;YAC1B,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,sRAAsR;QACxR,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wCAAwC;iBACtD;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;IAED,iBAAiB,EAAE;QACjB,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE;YACX,KAAK,EAAE,mBAAmB;YAC1B,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,gQAAgQ;QAClQ,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb;KACF;CACF,CAAC;AAEF,+CAA+C;AAC/C,gBAAgB;AAChB,+CAA+C"}

package/dist/tools/crew-builder.d.ts

@@ -14,10 +14,15 @@
  *   crew_status    — Check run status and results
  *   crew_list      — List recent crew runs
  */
-import { DobbyClient } from '../lib/dobby-client.js';
 export declare const crewBuilderTools: {
     crew_validate: {
         name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
         description: string;
         inputSchema: {
             type: "object";
@@ -36,6 +41,12 @@ export declare const crewBuilderTools: {
     };
     crew_kickoff: {
         name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
         description: string;
         inputSchema: {
             type: "object";
@@ -66,6 +77,12 @@ export declare const crewBuilderTools: {
     };
     crew_status: {
         name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
         description: string;
         inputSchema: {
             type: "object";
@@ -80,6 +97,12 @@ export declare const crewBuilderTools: {
     };
     crew_list: {
         name: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
         description: string;
         inputSchema: {
             type: "object";
@@ -97,69 +120,4 @@ export declare const crewBuilderTools: {
         };
     };
 };
-export declare function handleCrewValidate(client: DobbyClient, args: {
-    agents_yaml: string;
-    tasks_yaml: string;
-}): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    isError: boolean;
-}>;
-export declare function handleCrewKickoff(client: DobbyClient, args: {
-    agents_yaml: string;
-    tasks_yaml: string;
-    variables?: Record<string, string>;
-    process_type?: string;
-}): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    isError: boolean;
-}>;
-export declare function handleCrewStatus(client: DobbyClient, args: {
-    run_id: string;
-}): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    isError: boolean;
-}>;
-export declare function handleCrewList(client: DobbyClient, args: {
-    limit?: number;
-    status_filter?: string;
-}): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    isError: boolean;
-}>;
 //# sourceMappingURL=crew-builder.d.ts.map

package/dist/tools/crew-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crew-builder.d.ts","sourceRoot":"","sources":["../../src/tools/crew-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAMrD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6G5B,CAAC;AAuDF,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GA+ClD;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IACJ,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;;;;;;;;;;;;GAgCF;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GAoDzB;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GA6CjD"}
+{"version":3,"file":"crew-builder.d.ts","sourceRoot":"","sources":["../../src/tools/crew-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqI5B,CAAC"}