@dobbyai/mcp-external 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (289) hide show
  1. package/README.md +44 -14
  2. package/dist/__tests__/agent-mail-tools.test.js +19 -26
  3. package/dist/__tests__/agent-mail-tools.test.js.map +1 -1
  4. package/dist/__tests__/auth.test.js +50 -5
  5. package/dist/__tests__/auth.test.js.map +1 -1
  6. package/dist/__tests__/doctor.test.d.ts +16 -0
  7. package/dist/__tests__/doctor.test.d.ts.map +1 -0
  8. package/dist/__tests__/doctor.test.js +258 -0
  9. package/dist/__tests__/doctor.test.js.map +1 -0
  10. package/dist/__tests__/external-agents-tools.test.d.ts +11 -0
  11. package/dist/__tests__/external-agents-tools.test.d.ts.map +1 -0
  12. package/dist/__tests__/external-agents-tools.test.js +619 -0
  13. package/dist/__tests__/external-agents-tools.test.js.map +1 -0
  14. package/dist/__tests__/gateway-bearer.test.d.ts +12 -0
  15. package/dist/__tests__/gateway-bearer.test.d.ts.map +1 -0
  16. package/dist/__tests__/gateway-bearer.test.js +112 -0
  17. package/dist/__tests__/gateway-bearer.test.js.map +1 -0
  18. package/dist/__tests__/gateway-key-resolver.test.d.ts +10 -0
  19. package/dist/__tests__/gateway-key-resolver.test.d.ts.map +1 -0
  20. package/dist/__tests__/gateway-key-resolver.test.js +125 -0
  21. package/dist/__tests__/gateway-key-resolver.test.js.map +1 -0
  22. package/dist/__tests__/http-concurrency.test.d.ts +20 -0
  23. package/dist/__tests__/http-concurrency.test.d.ts.map +1 -0
  24. package/dist/__tests__/http-concurrency.test.js +254 -0
  25. package/dist/__tests__/http-concurrency.test.js.map +1 -0
  26. package/dist/__tests__/integration/protocol.test.js +14 -8
  27. package/dist/__tests__/integration/protocol.test.js.map +1 -1
  28. package/dist/__tests__/mcp-integrations.test.js +20 -30
  29. package/dist/__tests__/mcp-integrations.test.js.map +1 -1
  30. package/dist/__tests__/memory-graph-tools.test.js +27 -38
  31. package/dist/__tests__/memory-graph-tools.test.js.map +1 -1
  32. package/dist/__tests__/registry-dispatch.test.d.ts +11 -0
  33. package/dist/__tests__/registry-dispatch.test.d.ts.map +1 -0
  34. package/dist/__tests__/registry-dispatch.test.js +30 -0
  35. package/dist/__tests__/registry-dispatch.test.js.map +1 -0
  36. package/dist/__tests__/registry-listing-parity.test.d.ts +2 -0
  37. package/dist/__tests__/registry-listing-parity.test.d.ts.map +1 -0
  38. package/dist/__tests__/registry-listing-parity.test.js +89 -0
  39. package/dist/__tests__/registry-listing-parity.test.js.map +1 -0
  40. package/dist/__tests__/role-cap.test.d.ts +2 -0
  41. package/dist/__tests__/role-cap.test.d.ts.map +1 -0
  42. package/dist/__tests__/role-cap.test.js +113 -0
  43. package/dist/__tests__/role-cap.test.js.map +1 -0
  44. package/dist/__tests__/schedule-tools.test.js +15 -20
  45. package/dist/__tests__/schedule-tools.test.js.map +1 -1
  46. package/dist/__tests__/server-gateway-key.test.d.ts +18 -0
  47. package/dist/__tests__/server-gateway-key.test.d.ts.map +1 -0
  48. package/dist/__tests__/server-gateway-key.test.js +148 -0
  49. package/dist/__tests__/server-gateway-key.test.js.map +1 -0
  50. package/dist/__tests__/server-user-scoped.test.d.ts +34 -0
  51. package/dist/__tests__/server-user-scoped.test.d.ts.map +1 -0
  52. package/dist/__tests__/server-user-scoped.test.js +577 -0
  53. package/dist/__tests__/server-user-scoped.test.js.map +1 -0
  54. package/dist/__tests__/task-id-pattern.test.d.ts +12 -0
  55. package/dist/__tests__/task-id-pattern.test.d.ts.map +1 -0
  56. package/dist/__tests__/task-id-pattern.test.js +43 -0
  57. package/dist/__tests__/task-id-pattern.test.js.map +1 -0
  58. package/dist/__tests__/tiers.test.js +152 -56
  59. package/dist/__tests__/tiers.test.js.map +1 -1
  60. package/dist/__tests__/tools/hosted-agents.test.d.ts +9 -0
  61. package/dist/__tests__/tools/hosted-agents.test.d.ts.map +1 -0
  62. package/dist/__tests__/tools/hosted-agents.test.js +301 -0
  63. package/dist/__tests__/tools/hosted-agents.test.js.map +1 -0
  64. package/dist/__tests__/tools/llm-providers.test.d.ts +10 -0
  65. package/dist/__tests__/tools/llm-providers.test.d.ts.map +1 -0
  66. package/dist/__tests__/tools/llm-providers.test.js +105 -0
  67. package/dist/__tests__/tools/llm-providers.test.js.map +1 -0
  68. package/dist/__tests__/tools/services.test.js +139 -98
  69. package/dist/__tests__/tools/services.test.js.map +1 -1
  70. package/dist/__tests__/tools.test.js +24 -15
  71. package/dist/__tests__/tools.test.js.map +1 -1
  72. package/dist/__tests__/transport.test.js +365 -23
  73. package/dist/__tests__/transport.test.js.map +1 -1
  74. package/dist/__tests__/validate-credentials.test.d.ts +9 -0
  75. package/dist/__tests__/validate-credentials.test.d.ts.map +1 -0
  76. package/dist/__tests__/validate-credentials.test.js +172 -0
  77. package/dist/__tests__/validate-credentials.test.js.map +1 -0
  78. package/dist/__tests__/web-eval-tools.test.js +21 -32
  79. package/dist/__tests__/web-eval-tools.test.js.map +1 -1
  80. package/dist/__tests__/whoami.test.d.ts +11 -0
  81. package/dist/__tests__/whoami.test.d.ts.map +1 -0
  82. package/dist/__tests__/whoami.test.js +194 -0
  83. package/dist/__tests__/whoami.test.js.map +1 -0
  84. package/dist/__tests__/workflow-tools.test.js +20 -27
  85. package/dist/__tests__/workflow-tools.test.js.map +1 -1
  86. package/dist/__tests__/workloads.test.d.ts +9 -0
  87. package/dist/__tests__/workloads.test.d.ts.map +1 -0
  88. package/dist/__tests__/workloads.test.js +169 -0
  89. package/dist/__tests__/workloads.test.js.map +1 -0
  90. package/dist/auth/token-verifier.d.ts +11 -6
  91. package/dist/auth/token-verifier.d.ts.map +1 -1
  92. package/dist/auth/token-verifier.js +41 -19
  93. package/dist/auth/token-verifier.js.map +1 -1
  94. package/dist/connectors/claude-desktop.d.ts.map +1 -1
  95. package/dist/connectors/claude-desktop.js +3 -2
  96. package/dist/connectors/claude-desktop.js.map +1 -1
  97. package/dist/connectors/cursor.d.ts.map +1 -1
  98. package/dist/connectors/cursor.js +3 -2
  99. package/dist/connectors/cursor.js.map +1 -1
  100. package/dist/connectors/setup.d.ts.map +1 -1
  101. package/dist/connectors/setup.js +2 -1
  102. package/dist/connectors/setup.js.map +1 -1
  103. package/dist/connectors/vscode.d.ts.map +1 -1
  104. package/dist/connectors/vscode.js +3 -2
  105. package/dist/connectors/vscode.js.map +1 -1
  106. package/dist/connectors/windsurf.d.ts.map +1 -1
  107. package/dist/connectors/windsurf.js +3 -2
  108. package/dist/connectors/windsurf.js.map +1 -1
  109. package/dist/doctor.d.ts +34 -0
  110. package/dist/doctor.d.ts.map +1 -0
  111. package/dist/doctor.js +134 -0
  112. package/dist/doctor.js.map +1 -0
  113. package/dist/http-server.d.ts +24 -3
  114. package/dist/http-server.d.ts.map +1 -1
  115. package/dist/http-server.js +342 -62
  116. package/dist/http-server.js.map +1 -1
  117. package/dist/index.d.ts +5 -1
  118. package/dist/index.d.ts.map +1 -1
  119. package/dist/index.js +72 -208
  120. package/dist/index.js.map +1 -1
  121. package/dist/lib/consts.d.ts +21 -0
  122. package/dist/lib/consts.d.ts.map +1 -0
  123. package/dist/lib/consts.js +30 -0
  124. package/dist/lib/consts.js.map +1 -0
  125. package/dist/lib/dobby-client.d.ts +50 -23
  126. package/dist/lib/dobby-client.d.ts.map +1 -1
  127. package/dist/lib/dobby-client.js +105 -54
  128. package/dist/lib/dobby-client.js.map +1 -1
  129. package/dist/lib/gateway-key-resolver.d.ts +38 -0
  130. package/dist/lib/gateway-key-resolver.d.ts.map +1 -0
  131. package/dist/lib/gateway-key-resolver.js +59 -0
  132. package/dist/lib/gateway-key-resolver.js.map +1 -0
  133. package/dist/lib/log.d.ts +25 -0
  134. package/dist/lib/log.d.ts.map +1 -0
  135. package/dist/lib/log.js +36 -0
  136. package/dist/lib/log.js.map +1 -0
  137. package/dist/server.d.ts +175 -0
  138. package/dist/server.d.ts.map +1 -0
  139. package/dist/server.js +1017 -0
  140. package/dist/server.js.map +1 -0
  141. package/dist/tools/agent-mail.d.ts +0 -41
  142. package/dist/tools/agent-mail.d.ts.map +1 -1
  143. package/dist/tools/agent-mail.js +0 -222
  144. package/dist/tools/agent-mail.js.map +1 -1
  145. package/dist/tools/agent-versions.d.ts +93 -0
  146. package/dist/tools/agent-versions.d.ts.map +1 -0
  147. package/dist/tools/agent-versions.js +99 -0
  148. package/dist/tools/agent-versions.js.map +1 -0
  149. package/dist/tools/approvals.d.ts +0 -34
  150. package/dist/tools/approvals.d.ts.map +1 -1
  151. package/dist/tools/approvals.js +0 -81
  152. package/dist/tools/approvals.js.map +1 -1
  153. package/dist/tools/claude-code-sync.d.ts +40 -0
  154. package/dist/tools/claude-code-sync.d.ts.map +1 -0
  155. package/dist/tools/claude-code-sync.js +52 -0
  156. package/dist/tools/claude-code-sync.js.map +1 -0
  157. package/dist/tools/control-plane.d.ts +118 -0
  158. package/dist/tools/control-plane.d.ts.map +1 -0
  159. package/dist/tools/control-plane.js +135 -0
  160. package/dist/tools/control-plane.js.map +1 -0
  161. package/dist/tools/crew-builder.d.ts +0 -66
  162. package/dist/tools/crew-builder.d.ts.map +1 -1
  163. package/dist/tools/crew-builder.js +0 -185
  164. package/dist/tools/crew-builder.js.map +1 -1
  165. package/dist/tools/crewai.d.ts +0 -63
  166. package/dist/tools/crewai.d.ts.map +1 -1
  167. package/dist/tools/crewai.js +0 -145
  168. package/dist/tools/crewai.js.map +1 -1
  169. package/dist/tools/exa.d.ts +0 -35
  170. package/dist/tools/exa.d.ts.map +1 -1
  171. package/dist/tools/exa.js +0 -103
  172. package/dist/tools/exa.js.map +1 -1
  173. package/dist/tools/external-agents.d.ts +440 -0
  174. package/dist/tools/external-agents.d.ts.map +1 -0
  175. package/dist/tools/external-agents.js +386 -0
  176. package/dist/tools/external-agents.js.map +1 -0
  177. package/dist/tools/github-mcp.d.ts +0 -75
  178. package/dist/tools/github-mcp.d.ts.map +1 -1
  179. package/dist/tools/github-mcp.js +0 -162
  180. package/dist/tools/github-mcp.js.map +1 -1
  181. package/dist/tools/governance.d.ts +162 -18
  182. package/dist/tools/governance.d.ts.map +1 -1
  183. package/dist/tools/governance.js +208 -93
  184. package/dist/tools/governance.js.map +1 -1
  185. package/dist/tools/hosted-agents.d.ts +216 -0
  186. package/dist/tools/hosted-agents.d.ts.map +1 -0
  187. package/dist/tools/hosted-agents.js +214 -0
  188. package/dist/tools/hosted-agents.js.map +1 -0
  189. package/dist/tools/index.d.ts +3933 -1219
  190. package/dist/tools/index.d.ts.map +1 -1
  191. package/dist/tools/index.js +412 -393
  192. package/dist/tools/index.js.map +1 -1
  193. package/dist/tools/jira.d.ts +0 -176
  194. package/dist/tools/jira.d.ts.map +1 -1
  195. package/dist/tools/jira.js +0 -365
  196. package/dist/tools/jira.js.map +1 -1
  197. package/dist/tools/llm-providers.d.ts +50 -0
  198. package/dist/tools/llm-providers.d.ts.map +1 -0
  199. package/dist/tools/llm-providers.js +41 -0
  200. package/dist/tools/llm-providers.js.map +1 -0
  201. package/dist/tools/mcp-metrics.d.ts +0 -15
  202. package/dist/tools/mcp-metrics.d.ts.map +1 -1
  203. package/dist/tools/mcp-metrics.js +0 -217
  204. package/dist/tools/mcp-metrics.js.map +1 -1
  205. package/dist/tools/mcp-tools.d.ts +0 -29
  206. package/dist/tools/mcp-tools.d.ts.map +1 -1
  207. package/dist/tools/mcp-tools.js +0 -131
  208. package/dist/tools/mcp-tools.js.map +1 -1
  209. package/dist/tools/mem0.d.ts +0 -41
  210. package/dist/tools/mem0.d.ts.map +1 -1
  211. package/dist/tools/mem0.js +65 -165
  212. package/dist/tools/mem0.js.map +1 -1
  213. package/dist/tools/memory-graph.d.ts +0 -46
  214. package/dist/tools/memory-graph.d.ts.map +1 -1
  215. package/dist/tools/memory-graph.js +0 -386
  216. package/dist/tools/memory-graph.js.map +1 -1
  217. package/dist/tools/memory-stores.d.ts +141 -0
  218. package/dist/tools/memory-stores.d.ts.map +1 -0
  219. package/dist/tools/memory-stores.js +147 -0
  220. package/dist/tools/memory-stores.js.map +1 -0
  221. package/dist/tools/messages.d.ts +0 -20
  222. package/dist/tools/messages.d.ts.map +1 -1
  223. package/dist/tools/messages.js +0 -49
  224. package/dist/tools/messages.js.map +1 -1
  225. package/dist/tools/moltbook.d.ts +0 -236
  226. package/dist/tools/moltbook.d.ts.map +1 -1
  227. package/dist/tools/moltbook.js +0 -458
  228. package/dist/tools/moltbook.js.map +1 -1
  229. package/dist/tools/monitoring-attribution.d.ts +71 -0
  230. package/dist/tools/monitoring-attribution.d.ts.map +1 -0
  231. package/dist/tools/monitoring-attribution.js +74 -0
  232. package/dist/tools/monitoring-attribution.js.map +1 -0
  233. package/dist/tools/ops.d.ts +0 -80
  234. package/dist/tools/ops.d.ts.map +1 -1
  235. package/dist/tools/ops.js +0 -209
  236. package/dist/tools/ops.js.map +1 -1
  237. package/dist/tools/orchestrations.d.ts +109 -0
  238. package/dist/tools/orchestrations.d.ts.map +1 -0
  239. package/dist/tools/orchestrations.js +115 -0
  240. package/dist/tools/orchestrations.js.map +1 -0
  241. package/dist/tools/outcomes.d.ts +138 -0
  242. package/dist/tools/outcomes.d.ts.map +1 -0
  243. package/dist/tools/outcomes.js +136 -0
  244. package/dist/tools/outcomes.js.map +1 -0
  245. package/dist/tools/schedules.d.ts +0 -47
  246. package/dist/tools/schedules.d.ts.map +1 -1
  247. package/dist/tools/schedules.js +0 -109
  248. package/dist/tools/schedules.js.map +1 -1
  249. package/dist/tools/services.d.ts +0 -16
  250. package/dist/tools/services.d.ts.map +1 -1
  251. package/dist/tools/services.js +0 -135
  252. package/dist/tools/services.js.map +1 -1
  253. package/dist/tools/sessions.d.ts +124 -0
  254. package/dist/tools/sessions.d.ts.map +1 -0
  255. package/dist/tools/sessions.js +130 -0
  256. package/dist/tools/sessions.js.map +1 -0
  257. package/dist/tools/setup-status.d.ts +29 -0
  258. package/dist/tools/setup-status.d.ts.map +1 -0
  259. package/dist/tools/setup-status.js +35 -0
  260. package/dist/tools/setup-status.js.map +1 -0
  261. package/dist/tools/tasks.d.ts +0 -57
  262. package/dist/tools/tasks.d.ts.map +1 -1
  263. package/dist/tools/tasks.js +8 -217
  264. package/dist/tools/tasks.js.map +1 -1
  265. package/dist/tools/tiers.d.ts +23 -7
  266. package/dist/tools/tiers.d.ts.map +1 -1
  267. package/dist/tools/tiers.js +180 -79
  268. package/dist/tools/tiers.js.map +1 -1
  269. package/dist/tools/unified-agents.d.ts +0 -19
  270. package/dist/tools/unified-agents.d.ts.map +1 -1
  271. package/dist/tools/unified-agents.js +2 -103
  272. package/dist/tools/unified-agents.js.map +1 -1
  273. package/dist/tools/web-eval.d.ts +0 -43
  274. package/dist/tools/web-eval.d.ts.map +1 -1
  275. package/dist/tools/web-eval.js +0 -211
  276. package/dist/tools/web-eval.js.map +1 -1
  277. package/dist/tools/workflow.d.ts +0 -66
  278. package/dist/tools/workflow.d.ts.map +1 -1
  279. package/dist/tools/workflow.js +2 -409
  280. package/dist/tools/workflow.js.map +1 -1
  281. package/dist/tools/workloads.d.ts +81 -0
  282. package/dist/tools/workloads.d.ts.map +1 -0
  283. package/dist/tools/workloads.js +81 -0
  284. package/dist/tools/workloads.js.map +1 -0
  285. package/package.json +7 -6
  286. package/dist/tools/knowledge-base.d.ts +0 -144
  287. package/dist/tools/knowledge-base.d.ts.map +0 -1
  288. package/dist/tools/knowledge-base.js +0 -179
  289. package/dist/tools/knowledge-base.js.map +0 -1
@@ -0,0 +1,301 @@
1
+ /**
2
+ * Managed Agents tools — write tools (P0a, one-prompt hosted-agent flow).
3
+ *
4
+ * Dispatch goes through the capability registry (ADR-019); these exercise each
5
+ * handler with a mocked client, asserting the underlying REST call + rendered
6
+ * output + tier/role-cap parity with the mcp/external tool definitions.
7
+ */
8
+ import { describe, it, expect, vi, beforeEach } from "vitest";
9
+ import { createRegistry, toMcpResult } from "@dobbyai/capability-core";
10
+ import { hostedAgentsTools } from "../../tools/hosted-agents.js";
11
+ import { minRoleForTool } from "../../tools/index.js";
12
+ const mockClient = {
13
+ apiUrl: "http://localhost:3000",
14
+ apiKey: "sk_live_test",
15
+ tenantId: "tenant_test",
16
+ get: vi.fn(),
17
+ post: vi.fn(),
18
+ delete: vi.fn(),
19
+ };
20
+ const registry = createRegistry();
21
+ const callCap = async (id, client, args) => toMcpResult(await registry.get(id).handler({ client: client }, args));
22
+ beforeEach(() => {
23
+ vi.resetAllMocks();
24
+ });
25
+ const WRITE_TOOLS = [
26
+ "host_sample_agent",
27
+ "create_hosted_agent",
28
+ "deploy_hosted_agent",
29
+ "run_hosted_agent",
30
+ "get_agent_results",
31
+ "delete_hosted_agent",
32
+ ];
33
+ describe("hostedAgentsTools — definitions + registry parity", () => {
34
+ it("all 6 new tools are registered and byte-identical to the capability", () => {
35
+ for (const name of WRITE_TOOLS) {
36
+ const cap = registry.get(name);
37
+ expect(cap).toBeTruthy();
38
+ expect(cap.tier).toBe("mvp");
39
+ expect(cap.description).toBe(hostedAgentsTools[name].description);
40
+ expect(cap.annotations).toEqual(hostedAgentsTools[name].annotations);
41
+ // Legacy minRoleForTool (mcp/external/index.ts) must stay in parity with
42
+ // the capability's own minRole — the ONE gating rule.
43
+ expect(minRoleForTool(name)).toBe(cap.minRole);
44
+ }
45
+ });
46
+ it("the 4 mutation-chain tools require developer", () => {
47
+ for (const name of [
48
+ "host_sample_agent",
49
+ "create_hosted_agent",
50
+ "deploy_hosted_agent",
51
+ "run_hosted_agent",
52
+ ]) {
53
+ expect(registry.get(name).minRole).toBe("developer");
54
+ }
55
+ });
56
+ it("get_agent_results is read-only, member-gated", () => {
57
+ const cap = registry.get("get_agent_results");
58
+ expect(cap.readOnly).toBe(true);
59
+ expect(cap.minRole).toBe("member");
60
+ });
61
+ it("delete_hosted_agent is destructive, tenant_admin-gated", () => {
62
+ const cap = registry.get("delete_hosted_agent");
63
+ expect(cap.annotations?.destructiveHint).toBe(true);
64
+ expect(cap.minRole).toBe("tenant_admin");
65
+ });
66
+ });
67
+ describe("host_sample_agent", () => {
68
+ it("POSTs to the host-sample composite route and chains to get_agent_results", async () => {
69
+ mockClient.post.mockResolvedValue({
70
+ agent_id: "ha_1",
71
+ status: "deployed",
72
+ connector_id: "wc_1",
73
+ execution_id: "exec_1",
74
+ execution_status: "queued",
75
+ watch_url: "/tenant_test/dashboard/hosted-agents/ha_1",
76
+ });
77
+ const r = await callCap("host_sample_agent", mockClient, { name: "Demo" });
78
+ expect(mockClient.post).toHaveBeenCalledWith("/api/v1/tenants/tenant_test/hosted-agents/host-sample", { name: "Demo" });
79
+ const text = r.content[0].text;
80
+ expect(text).toContain("ha_1");
81
+ expect(text).toContain("get_agent_results");
82
+ expect(r.isError).toBeUndefined();
83
+ });
84
+ it("returns isError on failure", async () => {
85
+ mockClient.post.mockResolvedValue({
86
+ error: "ENTITLEMENT_DISABLED",
87
+ message: "not entitled",
88
+ });
89
+ const r = await callCap("host_sample_agent", mockClient, {});
90
+ expect(r.isError).toBe(true);
91
+ expect(r.content[0].text).toContain("not entitled");
92
+ });
93
+ });
94
+ describe("create_hosted_agent", () => {
95
+ it("POSTs name/region/existing_connector_id and surfaces one-time tokens", async () => {
96
+ mockClient.post.mockResolvedValue({
97
+ agent_id: "ha_2",
98
+ status: "created",
99
+ connector_id: "wc_2",
100
+ sdk_token: "dsdk_secret",
101
+ registry: {
102
+ repo_path: "repo/path",
103
+ push_token: "push_secret",
104
+ push_token_expires_at: "t",
105
+ },
106
+ });
107
+ const r = await callCap("create_hosted_agent", mockClient, {
108
+ name: "My Agent",
109
+ region: "eu",
110
+ existing_connector_id: "wc_9",
111
+ });
112
+ expect(mockClient.post).toHaveBeenCalledWith("/api/v1/tenants/tenant_test/hosted-agents", {
113
+ name: "My Agent",
114
+ region: "eu",
115
+ existing_connector_id: "wc_9",
116
+ });
117
+ const text = r.content[0].text;
118
+ expect(text).toContain("dsdk_secret");
119
+ expect(text).toContain("push_secret");
120
+ expect(text).toContain("deploy_hosted_agent");
121
+ });
122
+ it("returns isError on failure", async () => {
123
+ mockClient.post.mockResolvedValue({
124
+ error: "QUOTA_EXCEEDED",
125
+ message: "too many agents",
126
+ });
127
+ const r = await callCap("create_hosted_agent", mockClient, { name: "X" });
128
+ expect(r.isError).toBe(true);
129
+ });
130
+ });
131
+ describe("deploy_hosted_agent", () => {
132
+ it("POSTs image_tag and names the next step", async () => {
133
+ mockClient.post.mockResolvedValue({
134
+ deployment_id: "dep_1",
135
+ status: "deployed",
136
+ image_tag: "v2",
137
+ digest: "sha256:abc",
138
+ });
139
+ const r = await callCap("deploy_hosted_agent", mockClient, {
140
+ agent_id: "ha_1",
141
+ image_tag: "v2",
142
+ });
143
+ expect(mockClient.post).toHaveBeenCalledWith("/api/v1/tenants/tenant_test/hosted-agents/ha_1/deploy", { image_tag: "v2" });
144
+ const text = r.content[0].text;
145
+ expect(text).toContain("sha256:abc");
146
+ expect(text).toContain("run_hosted_agent");
147
+ });
148
+ it("surfaces a structured preflight failure with fix_hint", async () => {
149
+ mockClient.post.mockResolvedValue({
150
+ code: "PREFLIGHT_CRITICAL",
151
+ message: "Preflight refused the deploy.",
152
+ fix_hint: "Remove the baked-in secret and rebuild.",
153
+ });
154
+ const r = await callCap("deploy_hosted_agent", mockClient, {
155
+ agent_id: "ha_1",
156
+ });
157
+ expect(r.isError).toBe(true);
158
+ expect(r.content[0].text).toContain("PREFLIGHT_CRITICAL");
159
+ expect(r.content[0].text).toContain("Remove the baked-in secret");
160
+ });
161
+ });
162
+ describe("run_hosted_agent", () => {
163
+ it("POSTs to invoke and points at get_agent_results", async () => {
164
+ mockClient.post.mockResolvedValue({
165
+ execution_id: "exec_9",
166
+ status: "queued",
167
+ });
168
+ const r = await callCap("run_hosted_agent", mockClient, {
169
+ agent_id: "ha_1",
170
+ });
171
+ expect(mockClient.post).toHaveBeenCalledWith("/api/v1/tenants/tenant_test/hosted-agents/ha_1/invoke", {});
172
+ expect(r.content[0].text).toContain("exec_9");
173
+ expect(r.content[0].text).toContain("get_agent_results");
174
+ });
175
+ it("surfaces EXECUTION_START_FAILED with fix_hint", async () => {
176
+ mockClient.post.mockResolvedValue({
177
+ code: "EXECUTION_START_FAILED",
178
+ message: "Agent is 'created', not 'deployed'.",
179
+ fix_hint: "Deploy an image before invoking.",
180
+ });
181
+ const r = await callCap("run_hosted_agent", mockClient, {
182
+ agent_id: "ha_1",
183
+ });
184
+ expect(r.isError).toBe(true);
185
+ expect(r.content[0].text).toContain("Deploy an image before invoking");
186
+ });
187
+ });
188
+ describe("get_agent_results", () => {
189
+ it("composes agent detail + executions + governance verdict + log tail", async () => {
190
+ mockClient.get.mockImplementation(async (path) => {
191
+ if (path.endsWith("/hosted-agents/ha_1")) {
192
+ return {
193
+ agent: { agent_id: "ha_1", status: "deployed", connector_id: "wc_1" },
194
+ };
195
+ }
196
+ if (path.includes("/executions?limit=1")) {
197
+ return {
198
+ executions: [
199
+ {
200
+ execution_id: "exec_1",
201
+ status: "succeeded",
202
+ started_at: "t1",
203
+ ended_at: "t2",
204
+ exit_code: 0,
205
+ },
206
+ ],
207
+ };
208
+ }
209
+ if (path.includes("/workloads/runs")) {
210
+ return {
211
+ runs: [
212
+ {
213
+ run_id: "run_1",
214
+ status: "success",
215
+ scan_count: 1,
216
+ latest_scan: {
217
+ scan_id: "scan_1",
218
+ overall_status: "compliant",
219
+ violations_count: 0,
220
+ },
221
+ },
222
+ ],
223
+ };
224
+ }
225
+ if (path.includes("/logs")) {
226
+ return { lines: [{ text: "weather lookup ok" }] };
227
+ }
228
+ throw new Error(`unexpected path ${path}`);
229
+ });
230
+ const r = await callCap("get_agent_results", mockClient, {
231
+ agent_id: "ha_1",
232
+ });
233
+ const text = r.content[0].text;
234
+ expect(text).toContain("succeeded");
235
+ expect(text).toContain("compliant");
236
+ expect(text).toContain("scans/scan_1");
237
+ expect(text).toContain("weather lookup ok");
238
+ expect(r.isError).toBeUndefined();
239
+ });
240
+ it("tells the caller to keep polling while the run is still queued/running", async () => {
241
+ mockClient.get.mockImplementation(async (path) => {
242
+ if (path.endsWith("/hosted-agents/ha_1")) {
243
+ return {
244
+ agent: { agent_id: "ha_1", status: "deployed", connector_id: null },
245
+ };
246
+ }
247
+ if (path.includes("/executions?limit=1")) {
248
+ return {
249
+ executions: [
250
+ {
251
+ execution_id: "exec_2",
252
+ status: "running",
253
+ started_at: "t1",
254
+ ended_at: null,
255
+ exit_code: null,
256
+ },
257
+ ],
258
+ };
259
+ }
260
+ return { lines: [] };
261
+ });
262
+ const r = await callCap("get_agent_results", mockClient, {
263
+ agent_id: "ha_1",
264
+ });
265
+ expect(r.content[0].text).toContain("poll get_agent_results again in ~10s");
266
+ });
267
+ it("returns isError when the agent is not found", async () => {
268
+ mockClient.get.mockResolvedValue({
269
+ error: "AGENT_NOT_FOUND",
270
+ message: "no such agent",
271
+ });
272
+ const r = await callCap("get_agent_results", mockClient, {
273
+ agent_id: "ha_missing",
274
+ });
275
+ expect(r.isError).toBe(true);
276
+ });
277
+ });
278
+ describe("delete_hosted_agent", () => {
279
+ it("DELETEs the agent and confirms", async () => {
280
+ mockClient.delete.mockResolvedValue({
281
+ agent_id: "ha_1",
282
+ status: "deleted",
283
+ });
284
+ const r = await callCap("delete_hosted_agent", mockClient, {
285
+ agent_id: "ha_1",
286
+ });
287
+ expect(mockClient.delete).toHaveBeenCalledWith("/api/v1/tenants/tenant_test/hosted-agents/ha_1");
288
+ expect(r.content[0].text).toContain("Deleted ha_1");
289
+ });
290
+ it("returns isError on failure", async () => {
291
+ mockClient.delete.mockResolvedValue({
292
+ error: "AGENT_NOT_FOUND",
293
+ message: "gone",
294
+ });
295
+ const r = await callCap("delete_hosted_agent", mockClient, {
296
+ agent_id: "ha_x",
297
+ });
298
+ expect(r.isError).toBe(true);
299
+ });
300
+ });
301
+ //# sourceMappingURL=hosted-agents.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hosted-agents.test.js","sourceRoot":"","sources":["../../../src/__tests__/tools/hosted-agents.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * LLM Provider tools — connect_llm_provider.
3
+ *
4
+ * Dispatch goes through the capability registry (ADR-019); these exercise the
5
+ * handler with a mocked client, asserting the
6
+ * /api/v1/tenants/{tenantId}/llm-providers contract (X-API-Key path via
7
+ * client.post) and the rendered output. The API key must never be echoed back.
8
+ */
9
+ export {};
10
+ //# sourceMappingURL=llm-providers.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"llm-providers.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/tools/llm-providers.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}
@@ -0,0 +1,105 @@
1
+ /**
2
+ * LLM Provider tools — connect_llm_provider.
3
+ *
4
+ * Dispatch goes through the capability registry (ADR-019); these exercise the
5
+ * handler with a mocked client, asserting the
6
+ * /api/v1/tenants/{tenantId}/llm-providers contract (X-API-Key path via
7
+ * client.post) and the rendered output. The API key must never be echoed back.
8
+ */
9
+ import { describe, it, expect, vi, beforeEach } from 'vitest';
10
+ import { createRegistry, toMcpResult } from '@dobbyai/capability-core';
11
+ import { llmProviderTools } from '../../tools/llm-providers.js';
12
+ const mockClient = {
13
+ apiUrl: 'http://localhost:3000',
14
+ apiKey: 'sk_live_test',
15
+ tenantId: 'tenant_test',
16
+ post: vi.fn(),
17
+ };
18
+ const registry = createRegistry();
19
+ const callCap = async (id, client, args) => toMcpResult(await registry.get(id).handler({ client: client }, args));
20
+ beforeEach(() => {
21
+ vi.resetAllMocks();
22
+ });
23
+ describe('llmProviderTools — definitions', () => {
24
+ it('exposes connect_llm_provider as a write tool requiring provider + api_key', () => {
25
+ expect(llmProviderTools.connect_llm_provider.annotations.readOnlyHint).toBe(false);
26
+ expect(llmProviderTools.connect_llm_provider.inputSchema.required).toEqual(['provider', 'api_key']);
27
+ });
28
+ it('is registered as a dispatchable capability, tenant_admin-gated, pro tier', () => {
29
+ const cap = registry.get('connect_llm_provider');
30
+ expect(cap).toBeTruthy();
31
+ expect(cap.minRole).toBe('tenant_admin');
32
+ expect(cap.tier).toBe('pro');
33
+ expect(cap.readOnly).toBe(false);
34
+ // The listing def (mcp/external) must stay byte-identical to the capability.
35
+ expect(cap.description).toBe(llmProviderTools.connect_llm_provider.description);
36
+ expect(cap.annotations).toEqual(llmProviderTools.connect_llm_provider.annotations);
37
+ });
38
+ });
39
+ describe('connect_llm_provider', () => {
40
+ it('POSTs the provider + api_key to the tenant route and confirms without echoing the key', async () => {
41
+ mockClient.post.mockResolvedValue({
42
+ success: true,
43
+ provider: {
44
+ id: 'llm_1',
45
+ provider: 'gemini',
46
+ display_name: 'Google Gemini',
47
+ default_model: 'gemini-2.5-pro',
48
+ is_active: true,
49
+ is_default: true,
50
+ },
51
+ });
52
+ const r = await callCap('connect_llm_provider', mockClient, {
53
+ provider: 'gemini',
54
+ api_key: 'AIzaSy-super-secret-key',
55
+ is_default: true,
56
+ });
57
+ expect(mockClient.post).toHaveBeenCalledWith('/api/v1/tenants/tenant_test/llm-providers', {
58
+ provider: 'gemini',
59
+ api_key: 'AIzaSy-super-secret-key',
60
+ is_default: true,
61
+ });
62
+ const text = r.content[0].text;
63
+ expect(text).toContain('Connected Google Gemini (gemini)');
64
+ expect(text).toContain('gemini-2.5-pro');
65
+ expect(text).not.toContain('AIzaSy-super-secret-key');
66
+ expect(r.isError).toBeUndefined();
67
+ });
68
+ it('forwards optional display_name/default_model/base_url when provided', async () => {
69
+ mockClient.post.mockResolvedValue({ provider: { id: 'llm_2', provider: 'openai' } });
70
+ await callCap('connect_llm_provider', mockClient, {
71
+ provider: 'openai',
72
+ api_key: 'sk-test',
73
+ display_name: 'My OpenAI',
74
+ default_model: 'gpt-4o',
75
+ base_url: 'https://proxy.example.com',
76
+ });
77
+ expect(mockClient.post).toHaveBeenCalledWith('/api/v1/tenants/tenant_test/llm-providers', {
78
+ provider: 'openai',
79
+ api_key: 'sk-test',
80
+ display_name: 'My OpenAI',
81
+ default_model: 'gpt-4o',
82
+ base_url: 'https://proxy.example.com',
83
+ });
84
+ });
85
+ it('returns isError with the API error message on failure, without leaking the key', async () => {
86
+ mockClient.post.mockResolvedValue({ error: 'VALIDATION_ERROR', message: 'Invalid request body' });
87
+ const r = await callCap('connect_llm_provider', mockClient, {
88
+ provider: 'claude',
89
+ api_key: 'sk-ant-secret',
90
+ });
91
+ expect(r.isError).toBe(true);
92
+ expect(r.content[0].text).toContain('VALIDATION_ERROR');
93
+ expect(r.content[0].text).not.toContain('sk-ant-secret');
94
+ });
95
+ it('returns isError when the client throws', async () => {
96
+ mockClient.post.mockRejectedValue(new Error('network timeout'));
97
+ const r = await callCap('connect_llm_provider', mockClient, {
98
+ provider: 'mistral',
99
+ api_key: 'secret',
100
+ });
101
+ expect(r.isError).toBe(true);
102
+ expect(r.content[0].text).toContain('network timeout');
103
+ });
104
+ });
105
+ //# sourceMappingURL=llm-providers.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"llm-providers.test.js","sourceRoot":"","sources":["../../../src/__tests__/tools/llm-providers.test.ts"],"names":[],"mappings":"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"}