@bluehive/sdk-mcp 0.1.0-alpha.2

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 (139) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +188 -0
  3. package/compat.d.mts +56 -0
  4. package/compat.d.mts.map +1 -0
  5. package/compat.d.ts +56 -0
  6. package/compat.d.ts.map +1 -0
  7. package/compat.js +382 -0
  8. package/compat.js.map +1 -0
  9. package/compat.mjs +373 -0
  10. package/compat.mjs.map +1 -0
  11. package/dynamic-tools.d.mts +12 -0
  12. package/dynamic-tools.d.mts.map +1 -0
  13. package/dynamic-tools.d.ts +12 -0
  14. package/dynamic-tools.d.ts.map +1 -0
  15. package/dynamic-tools.js +135 -0
  16. package/dynamic-tools.js.map +1 -0
  17. package/dynamic-tools.mjs +132 -0
  18. package/dynamic-tools.mjs.map +1 -0
  19. package/index.d.mts +3 -0
  20. package/index.d.mts.map +1 -0
  21. package/index.d.ts +3 -0
  22. package/index.d.ts.map +1 -0
  23. package/index.js +86 -0
  24. package/index.js.map +1 -0
  25. package/index.mjs +84 -0
  26. package/index.mjs.map +1 -0
  27. package/options.d.mts +14 -0
  28. package/options.d.mts.map +1 -0
  29. package/options.d.ts +14 -0
  30. package/options.d.ts.map +1 -0
  31. package/options.js +296 -0
  32. package/options.js.map +1 -0
  33. package/options.mjs +290 -0
  34. package/options.mjs.map +1 -0
  35. package/package.json +121 -0
  36. package/server.d.mts +47 -0
  37. package/server.d.mts.map +1 -0
  38. package/server.d.ts +47 -0
  39. package/server.d.ts.map +1 -0
  40. package/server.js +114 -0
  41. package/server.js.map +1 -0
  42. package/server.mjs +101 -0
  43. package/server.mjs.map +1 -0
  44. package/src/compat.ts +478 -0
  45. package/src/dynamic-tools.ts +153 -0
  46. package/src/index.ts +104 -0
  47. package/src/options.ts +319 -0
  48. package/src/server.ts +145 -0
  49. package/src/tools/database/check-health-database.ts +31 -0
  50. package/src/tools/fax/list-providers-fax.ts +31 -0
  51. package/src/tools/fax/retrieve-status-fax.ts +36 -0
  52. package/src/tools/fax/send-fax.ts +76 -0
  53. package/src/tools/health/check-health.ts +31 -0
  54. package/src/tools/index.ts +83 -0
  55. package/src/tools/providers/lookup-providers.ts +49 -0
  56. package/src/tools/types.ts +103 -0
  57. package/src/tools/version/retrieve-version.ts +31 -0
  58. package/src/tools.ts +1 -0
  59. package/src/tsconfig.json +11 -0
  60. package/tools/database/check-health-database.d.mts +45 -0
  61. package/tools/database/check-health-database.d.mts.map +1 -0
  62. package/tools/database/check-health-database.d.ts +45 -0
  63. package/tools/database/check-health-database.d.ts.map +1 -0
  64. package/tools/database/check-health-database.js +27 -0
  65. package/tools/database/check-health-database.js.map +1 -0
  66. package/tools/database/check-health-database.mjs +23 -0
  67. package/tools/database/check-health-database.mjs.map +1 -0
  68. package/tools/fax/list-providers-fax.d.mts +45 -0
  69. package/tools/fax/list-providers-fax.d.mts.map +1 -0
  70. package/tools/fax/list-providers-fax.d.ts +45 -0
  71. package/tools/fax/list-providers-fax.d.ts.map +1 -0
  72. package/tools/fax/list-providers-fax.js +27 -0
  73. package/tools/fax/list-providers-fax.js.map +1 -0
  74. package/tools/fax/list-providers-fax.mjs +23 -0
  75. package/tools/fax/list-providers-fax.mjs.map +1 -0
  76. package/tools/fax/retrieve-status-fax.d.mts +45 -0
  77. package/tools/fax/retrieve-status-fax.d.mts.map +1 -0
  78. package/tools/fax/retrieve-status-fax.d.ts +45 -0
  79. package/tools/fax/retrieve-status-fax.d.ts.map +1 -0
  80. package/tools/fax/retrieve-status-fax.js +32 -0
  81. package/tools/fax/retrieve-status-fax.js.map +1 -0
  82. package/tools/fax/retrieve-status-fax.mjs +28 -0
  83. package/tools/fax/retrieve-status-fax.mjs.map +1 -0
  84. package/tools/fax/send-fax.d.mts +45 -0
  85. package/tools/fax/send-fax.d.mts.map +1 -0
  86. package/tools/fax/send-fax.d.ts +45 -0
  87. package/tools/fax/send-fax.d.ts.map +1 -0
  88. package/tools/fax/send-fax.js +72 -0
  89. package/tools/fax/send-fax.js.map +1 -0
  90. package/tools/fax/send-fax.mjs +68 -0
  91. package/tools/fax/send-fax.mjs.map +1 -0
  92. package/tools/health/check-health.d.mts +45 -0
  93. package/tools/health/check-health.d.mts.map +1 -0
  94. package/tools/health/check-health.d.ts +45 -0
  95. package/tools/health/check-health.d.ts.map +1 -0
  96. package/tools/health/check-health.js +27 -0
  97. package/tools/health/check-health.js.map +1 -0
  98. package/tools/health/check-health.mjs +23 -0
  99. package/tools/health/check-health.mjs.map +1 -0
  100. package/tools/index.d.mts +10 -0
  101. package/tools/index.d.mts.map +1 -0
  102. package/tools/index.d.ts +10 -0
  103. package/tools/index.d.ts.map +1 -0
  104. package/tools/index.js +67 -0
  105. package/tools/index.js.map +1 -0
  106. package/tools/index.mjs +60 -0
  107. package/tools/index.mjs.map +1 -0
  108. package/tools/providers/lookup-providers.d.mts +45 -0
  109. package/tools/providers/lookup-providers.d.mts.map +1 -0
  110. package/tools/providers/lookup-providers.d.ts +45 -0
  111. package/tools/providers/lookup-providers.d.ts.map +1 -0
  112. package/tools/providers/lookup-providers.js +45 -0
  113. package/tools/providers/lookup-providers.js.map +1 -0
  114. package/tools/providers/lookup-providers.mjs +41 -0
  115. package/tools/providers/lookup-providers.mjs.map +1 -0
  116. package/tools/types.d.mts +51 -0
  117. package/tools/types.d.mts.map +1 -0
  118. package/tools/types.d.ts +51 -0
  119. package/tools/types.d.ts.map +1 -0
  120. package/tools/types.js +46 -0
  121. package/tools/types.js.map +1 -0
  122. package/tools/types.mjs +42 -0
  123. package/tools/types.mjs.map +1 -0
  124. package/tools/version/retrieve-version.d.mts +45 -0
  125. package/tools/version/retrieve-version.d.mts.map +1 -0
  126. package/tools/version/retrieve-version.d.ts +45 -0
  127. package/tools/version/retrieve-version.d.ts.map +1 -0
  128. package/tools/version/retrieve-version.js +27 -0
  129. package/tools/version/retrieve-version.js.map +1 -0
  130. package/tools/version/retrieve-version.mjs +23 -0
  131. package/tools/version/retrieve-version.mjs.map +1 -0
  132. package/tools.d.mts +2 -0
  133. package/tools.d.mts.map +1 -0
  134. package/tools.d.ts +2 -0
  135. package/tools.d.ts.map +1 -0
  136. package/tools.js +18 -0
  137. package/tools.js.map +1 -0
  138. package/tools.mjs +2 -0
  139. package/tools.mjs.map +1 -0
package/compat.mjs ADDED
@@ -0,0 +1,373 @@
1
+ export const defaultClientCapabilities = {
2
+ topLevelUnions: true,
3
+ validJson: true,
4
+ refs: true,
5
+ unions: true,
6
+ formats: true,
7
+ toolNameLength: undefined,
8
+ };
9
+ // Client presets for compatibility
10
+ // Note that these could change over time as models get better, so this is
11
+ // a best effort.
12
+ export const knownClients = {
13
+ 'openai-agents': {
14
+ topLevelUnions: false,
15
+ validJson: true,
16
+ refs: true,
17
+ unions: true,
18
+ formats: true,
19
+ toolNameLength: undefined,
20
+ },
21
+ claude: {
22
+ topLevelUnions: true,
23
+ validJson: false,
24
+ refs: true,
25
+ unions: true,
26
+ formats: true,
27
+ toolNameLength: undefined,
28
+ },
29
+ 'claude-code': {
30
+ topLevelUnions: false,
31
+ validJson: true,
32
+ refs: true,
33
+ unions: true,
34
+ formats: true,
35
+ toolNameLength: undefined,
36
+ },
37
+ cursor: {
38
+ topLevelUnions: false,
39
+ validJson: true,
40
+ refs: false,
41
+ unions: false,
42
+ formats: false,
43
+ toolNameLength: 50,
44
+ },
45
+ };
46
+ /**
47
+ * Attempts to parse strings into JSON objects
48
+ */
49
+ export function parseEmbeddedJSON(args, schema) {
50
+ let updated = false;
51
+ const newArgs = Object.assign({}, args);
52
+ for (const [key, value] of Object.entries(newArgs)) {
53
+ if (typeof value === 'string') {
54
+ try {
55
+ const parsed = JSON.parse(value);
56
+ newArgs[key] = parsed;
57
+ updated = true;
58
+ }
59
+ catch (e) {
60
+ // Not valid JSON, leave as is
61
+ }
62
+ }
63
+ }
64
+ if (updated) {
65
+ return newArgs;
66
+ }
67
+ return args;
68
+ }
69
+ /**
70
+ * Truncates tool names to the specified length while ensuring uniqueness.
71
+ * If truncation would cause duplicate names, appends a number to make them unique.
72
+ */
73
+ export function truncateToolNames(names, maxLength) {
74
+ if (maxLength <= 0) {
75
+ return new Map();
76
+ }
77
+ const renameMap = new Map();
78
+ const usedNames = new Set();
79
+ const toTruncate = names.filter((name) => name.length > maxLength);
80
+ if (toTruncate.length === 0) {
81
+ return renameMap;
82
+ }
83
+ const willCollide = new Set(toTruncate.map((name) => name.slice(0, maxLength - 1))).size < toTruncate.length;
84
+ if (!willCollide) {
85
+ for (const name of toTruncate) {
86
+ const truncatedName = name.slice(0, maxLength);
87
+ renameMap.set(name, truncatedName);
88
+ }
89
+ }
90
+ else {
91
+ const baseLength = maxLength - 1;
92
+ for (const name of toTruncate) {
93
+ const baseName = name.slice(0, baseLength);
94
+ let counter = 1;
95
+ while (usedNames.has(baseName + counter)) {
96
+ counter++;
97
+ }
98
+ const finalName = baseName + counter;
99
+ renameMap.set(name, finalName);
100
+ usedNames.add(finalName);
101
+ }
102
+ }
103
+ return renameMap;
104
+ }
105
+ /**
106
+ * Removes top-level unions from a tool by splitting it into multiple tools,
107
+ * one for each variant in the union.
108
+ */
109
+ export function removeTopLevelUnions(tool) {
110
+ const inputSchema = tool.inputSchema;
111
+ const variants = inputSchema.anyOf;
112
+ if (!variants || !Array.isArray(variants) || variants.length === 0) {
113
+ return [tool];
114
+ }
115
+ const defs = inputSchema.$defs || {};
116
+ return variants.map((variant, index) => {
117
+ const variantSchema = {
118
+ ...inputSchema,
119
+ ...variant,
120
+ type: 'object',
121
+ properties: {
122
+ ...(inputSchema.properties || {}),
123
+ ...(variant.properties || {}),
124
+ },
125
+ };
126
+ delete variantSchema.anyOf;
127
+ if (!variantSchema['description']) {
128
+ variantSchema['description'] = tool.description;
129
+ }
130
+ const usedDefs = findUsedDefs(variant, defs);
131
+ if (Object.keys(usedDefs).length > 0) {
132
+ variantSchema.$defs = usedDefs;
133
+ }
134
+ else {
135
+ delete variantSchema.$defs;
136
+ }
137
+ return {
138
+ ...tool,
139
+ name: `${tool.name}_${toSnakeCase(variant['title'] || `variant${index + 1}`)}`,
140
+ description: variant['description'] || tool.description,
141
+ inputSchema: variantSchema,
142
+ };
143
+ });
144
+ }
145
+ function findUsedDefs(schema, defs, visited = new Set()) {
146
+ const usedDefs = {};
147
+ if (typeof schema !== 'object' || schema === null) {
148
+ return usedDefs;
149
+ }
150
+ if (schema.$ref) {
151
+ const refParts = schema.$ref.split('/');
152
+ if (refParts[0] === '#' && refParts[1] === '$defs' && refParts[2]) {
153
+ const defName = refParts[2];
154
+ const def = defs[defName];
155
+ if (def && !visited.has(schema.$ref)) {
156
+ usedDefs[defName] = def;
157
+ visited.add(schema.$ref);
158
+ Object.assign(usedDefs, findUsedDefs(def, defs, visited));
159
+ visited.delete(schema.$ref);
160
+ }
161
+ }
162
+ return usedDefs;
163
+ }
164
+ for (const key in schema) {
165
+ if (key !== '$defs' && typeof schema[key] === 'object' && schema[key] !== null) {
166
+ Object.assign(usedDefs, findUsedDefs(schema[key], defs, visited));
167
+ }
168
+ }
169
+ return usedDefs;
170
+ }
171
+ // Export for testing
172
+ export { findUsedDefs };
173
+ /**
174
+ * Inlines all $refs in a schema, eliminating $defs.
175
+ * If a circular reference is detected, the circular property is removed.
176
+ */
177
+ export function inlineRefs(schema) {
178
+ if (!schema || typeof schema !== 'object') {
179
+ return schema;
180
+ }
181
+ const clonedSchema = { ...schema };
182
+ const defs = schema.$defs || {};
183
+ delete clonedSchema.$defs;
184
+ const result = inlineRefsRecursive(clonedSchema, defs, new Set());
185
+ // The top level can never be null
186
+ return result === null ? {} : result;
187
+ }
188
+ function inlineRefsRecursive(schema, defs, refPath) {
189
+ if (!schema || typeof schema !== 'object') {
190
+ return schema;
191
+ }
192
+ if (Array.isArray(schema)) {
193
+ return schema.map((item) => {
194
+ const processed = inlineRefsRecursive(item, defs, refPath);
195
+ return processed === null ? {} : processed;
196
+ });
197
+ }
198
+ const result = { ...schema };
199
+ if ('$ref' in result && typeof result.$ref === 'string') {
200
+ if (result.$ref.startsWith('#/$defs/')) {
201
+ const refName = result.$ref.split('/').pop();
202
+ const def = defs[refName];
203
+ // If we've already seen this ref in our path, we have a circular reference
204
+ if (refPath.has(result.$ref)) {
205
+ // For circular references, we completely remove the property
206
+ // by returning null. The parent will remove it.
207
+ return null;
208
+ }
209
+ if (def) {
210
+ const newRefPath = new Set(refPath);
211
+ newRefPath.add(result.$ref);
212
+ const inlinedDef = inlineRefsRecursive({ ...def }, defs, newRefPath);
213
+ if (inlinedDef === null) {
214
+ return { ...result };
215
+ }
216
+ // Merge the inlined definition with the original schema's properties
217
+ // but preserve things like description, etc.
218
+ const { $ref, ...rest } = result;
219
+ return { ...inlinedDef, ...rest };
220
+ }
221
+ }
222
+ // Keep external refs as-is
223
+ return result;
224
+ }
225
+ for (const key in result) {
226
+ if (result[key] && typeof result[key] === 'object') {
227
+ const processed = inlineRefsRecursive(result[key], defs, refPath);
228
+ if (processed === null) {
229
+ // Remove properties that would cause circular references
230
+ delete result[key];
231
+ }
232
+ else {
233
+ result[key] = processed;
234
+ }
235
+ }
236
+ }
237
+ return result;
238
+ }
239
+ /**
240
+ * Removes anyOf fields from a schema, using only the first variant.
241
+ */
242
+ export function removeAnyOf(schema) {
243
+ if (!schema || typeof schema !== 'object') {
244
+ return schema;
245
+ }
246
+ if (Array.isArray(schema)) {
247
+ return schema.map((item) => removeAnyOf(item));
248
+ }
249
+ const result = { ...schema };
250
+ if ('anyOf' in result && Array.isArray(result.anyOf) && result.anyOf.length > 0) {
251
+ const firstVariant = result.anyOf[0];
252
+ if (firstVariant && typeof firstVariant === 'object') {
253
+ // Special handling for properties to ensure deep merge
254
+ if (firstVariant.properties && result.properties) {
255
+ result.properties = {
256
+ ...result.properties,
257
+ ...firstVariant.properties,
258
+ };
259
+ }
260
+ else if (firstVariant.properties) {
261
+ result.properties = { ...firstVariant.properties };
262
+ }
263
+ for (const key in firstVariant) {
264
+ if (key !== 'properties') {
265
+ result[key] = firstVariant[key];
266
+ }
267
+ }
268
+ }
269
+ delete result.anyOf;
270
+ }
271
+ for (const key in result) {
272
+ if (result[key] && typeof result[key] === 'object') {
273
+ result[key] = removeAnyOf(result[key]);
274
+ }
275
+ }
276
+ return result;
277
+ }
278
+ /**
279
+ * Removes format fields from a schema and appends them to the description.
280
+ */
281
+ export function removeFormats(schema, formatsCapability) {
282
+ if (formatsCapability) {
283
+ return schema;
284
+ }
285
+ if (!schema || typeof schema !== 'object') {
286
+ return schema;
287
+ }
288
+ if (Array.isArray(schema)) {
289
+ return schema.map((item) => removeFormats(item, formatsCapability));
290
+ }
291
+ const result = { ...schema };
292
+ if ('format' in result && typeof result['format'] === 'string') {
293
+ const formatStr = `(format: "${result['format']}")`;
294
+ if ('description' in result && typeof result['description'] === 'string') {
295
+ result['description'] = `${result['description']} ${formatStr}`;
296
+ }
297
+ else {
298
+ result['description'] = formatStr;
299
+ }
300
+ delete result['format'];
301
+ }
302
+ for (const key in result) {
303
+ if (result[key] && typeof result[key] === 'object') {
304
+ result[key] = removeFormats(result[key], formatsCapability);
305
+ }
306
+ }
307
+ return result;
308
+ }
309
+ /**
310
+ * Applies all compatibility transformations to the endpoints based on the provided capabilities.
311
+ */
312
+ export function applyCompatibilityTransformations(endpoints, capabilities) {
313
+ let transformedEndpoints = [...endpoints];
314
+ // Handle top-level unions first as this changes tool names
315
+ if (!capabilities.topLevelUnions) {
316
+ const newEndpoints = [];
317
+ for (const endpoint of transformedEndpoints) {
318
+ const variantTools = removeTopLevelUnions(endpoint.tool);
319
+ if (variantTools.length === 1) {
320
+ newEndpoints.push(endpoint);
321
+ }
322
+ else {
323
+ for (const variantTool of variantTools) {
324
+ newEndpoints.push({
325
+ ...endpoint,
326
+ tool: variantTool,
327
+ });
328
+ }
329
+ }
330
+ }
331
+ transformedEndpoints = newEndpoints;
332
+ }
333
+ if (capabilities.toolNameLength) {
334
+ const toolNames = transformedEndpoints.map((endpoint) => endpoint.tool.name);
335
+ const renameMap = truncateToolNames(toolNames, capabilities.toolNameLength);
336
+ transformedEndpoints = transformedEndpoints.map((endpoint) => ({
337
+ ...endpoint,
338
+ tool: {
339
+ ...endpoint.tool,
340
+ name: renameMap.get(endpoint.tool.name) ?? endpoint.tool.name,
341
+ },
342
+ }));
343
+ }
344
+ if (!capabilities.refs || !capabilities.unions || !capabilities.formats) {
345
+ transformedEndpoints = transformedEndpoints.map((endpoint) => {
346
+ let schema = endpoint.tool.inputSchema;
347
+ if (!capabilities.refs) {
348
+ schema = inlineRefs(schema);
349
+ }
350
+ if (!capabilities.unions) {
351
+ schema = removeAnyOf(schema);
352
+ }
353
+ if (!capabilities.formats) {
354
+ schema = removeFormats(schema, capabilities.formats);
355
+ }
356
+ return {
357
+ ...endpoint,
358
+ tool: {
359
+ ...endpoint.tool,
360
+ inputSchema: schema,
361
+ },
362
+ };
363
+ });
364
+ }
365
+ return transformedEndpoints;
366
+ }
367
+ function toSnakeCase(str) {
368
+ return str
369
+ .replace(/\s+/g, '_')
370
+ .replace(/([a-z])([A-Z])/g, '$1_$2')
371
+ .toLowerCase();
372
+ }
373
+ //# sourceMappingURL=compat.mjs.map
package/compat.mjs.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compat.mjs","sourceRoot":"","sources":["src/compat.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import { Endpoint } from "./tools/types.mjs";
2
+ /**
3
+ * A list of tools that expose all the endpoints in the API dynamically.
4
+ *
5
+ * Instead of exposing every endpoint as it's own tool, which uses up too many tokens for LLMs to use at once,
6
+ * we expose a single tool that can be used to search for endpoints by name, resource, operation, or tag, and then
7
+ * a generic endpoint that can be used to invoke any endpoint with the provided arguments.
8
+ *
9
+ * @param endpoints - The endpoints to include in the list.
10
+ */
11
+ export declare function dynamicTools(endpoints: Endpoint[]): Endpoint[];
12
+ //# sourceMappingURL=dynamic-tools.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dynamic-tools.d.mts","sourceRoot":"","sources":["src/dynamic-tools.ts"],"names":[],"mappings":"OACO,EAAE,QAAQ,EAAuC;AAYxD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAkI9D"}
@@ -0,0 +1,12 @@
1
+ import { Endpoint } from "./tools/types.js";
2
+ /**
3
+ * A list of tools that expose all the endpoints in the API dynamically.
4
+ *
5
+ * Instead of exposing every endpoint as it's own tool, which uses up too many tokens for LLMs to use at once,
6
+ * we expose a single tool that can be used to search for endpoints by name, resource, operation, or tag, and then
7
+ * a generic endpoint that can be used to invoke any endpoint with the provided arguments.
8
+ *
9
+ * @param endpoints - The endpoints to include in the list.
10
+ */
11
+ export declare function dynamicTools(endpoints: Endpoint[]): Endpoint[];
12
+ //# sourceMappingURL=dynamic-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dynamic-tools.d.ts","sourceRoot":"","sources":["src/dynamic-tools.ts"],"names":[],"mappings":"OACO,EAAE,QAAQ,EAAuC;AAYxD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAkI9D"}
@@ -0,0 +1,135 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.dynamicTools = dynamicTools;
4
+ const types_1 = require("./tools/types.js");
5
+ const zod_to_json_schema_1 = require("zod-to-json-schema");
6
+ const zod_1 = require("zod");
7
+ const cabidela_1 = require("@cloudflare/cabidela");
8
+ function zodToInputSchema(schema) {
9
+ return {
10
+ type: 'object',
11
+ ...(0, zod_to_json_schema_1.zodToJsonSchema)(schema),
12
+ };
13
+ }
14
+ /**
15
+ * A list of tools that expose all the endpoints in the API dynamically.
16
+ *
17
+ * Instead of exposing every endpoint as it's own tool, which uses up too many tokens for LLMs to use at once,
18
+ * we expose a single tool that can be used to search for endpoints by name, resource, operation, or tag, and then
19
+ * a generic endpoint that can be used to invoke any endpoint with the provided arguments.
20
+ *
21
+ * @param endpoints - The endpoints to include in the list.
22
+ */
23
+ function dynamicTools(endpoints) {
24
+ const listEndpointsSchema = zod_1.z.object({
25
+ search_query: zod_1.z
26
+ .string()
27
+ .optional()
28
+ .describe('An optional search query to filter the endpoints by. Provide a partial name, resource, operation, or tag to filter the endpoints returned.'),
29
+ });
30
+ const listEndpointsTool = {
31
+ metadata: {
32
+ resource: 'dynamic_tools',
33
+ operation: 'read',
34
+ tags: [],
35
+ },
36
+ tool: {
37
+ name: 'list_api_endpoints',
38
+ description: 'List or search for all endpoints in the BlueHive TypeScript API',
39
+ inputSchema: zodToInputSchema(listEndpointsSchema),
40
+ },
41
+ handler: async (client, args) => {
42
+ const query = args && listEndpointsSchema.parse(args).search_query?.trim();
43
+ const filteredEndpoints = query && query.length > 0 ?
44
+ endpoints.filter((endpoint) => {
45
+ const fieldsToMatch = [
46
+ endpoint.tool.name,
47
+ endpoint.tool.description,
48
+ endpoint.metadata.resource,
49
+ endpoint.metadata.operation,
50
+ ...endpoint.metadata.tags,
51
+ ];
52
+ return fieldsToMatch.some((field) => field && field.toLowerCase().includes(query.toLowerCase()));
53
+ })
54
+ : endpoints;
55
+ return (0, types_1.asTextContentResult)({
56
+ tools: filteredEndpoints.map(({ tool, metadata }) => ({
57
+ name: tool.name,
58
+ description: tool.description,
59
+ resource: metadata.resource,
60
+ operation: metadata.operation,
61
+ tags: metadata.tags,
62
+ })),
63
+ });
64
+ },
65
+ };
66
+ const getEndpointSchema = zod_1.z.object({
67
+ endpoint: zod_1.z.string().describe('The name of the endpoint to get the schema for.'),
68
+ });
69
+ const getEndpointTool = {
70
+ metadata: {
71
+ resource: 'dynamic_tools',
72
+ operation: 'read',
73
+ tags: [],
74
+ },
75
+ tool: {
76
+ name: 'get_api_endpoint_schema',
77
+ description: 'Get the schema for an endpoint in the BlueHive TypeScript API. You can use the schema returned by this tool to invoke an endpoint with the `invoke_api_endpoint` tool.',
78
+ inputSchema: zodToInputSchema(getEndpointSchema),
79
+ },
80
+ handler: async (client, args) => {
81
+ if (!args) {
82
+ throw new Error('No endpoint provided');
83
+ }
84
+ const endpointName = getEndpointSchema.parse(args).endpoint;
85
+ const endpoint = endpoints.find((e) => e.tool.name === endpointName);
86
+ if (!endpoint) {
87
+ throw new Error(`Endpoint ${endpointName} not found`);
88
+ }
89
+ return (0, types_1.asTextContentResult)(endpoint.tool);
90
+ },
91
+ };
92
+ const invokeEndpointSchema = zod_1.z.object({
93
+ endpoint_name: zod_1.z.string().describe('The name of the endpoint to invoke.'),
94
+ args: zod_1.z
95
+ .record(zod_1.z.string(), zod_1.z.any())
96
+ .describe('The arguments to pass to the endpoint. This must match the schema returned by the `get_api_endpoint_schema` tool.'),
97
+ });
98
+ const invokeEndpointTool = {
99
+ metadata: {
100
+ resource: 'dynamic_tools',
101
+ operation: 'write',
102
+ tags: [],
103
+ },
104
+ tool: {
105
+ name: 'invoke_api_endpoint',
106
+ description: 'Invoke an endpoint in the BlueHive TypeScript API. Note: use the `list_api_endpoints` tool to get the list of endpoints and `get_api_endpoint_schema` tool to get the schema for an endpoint.',
107
+ inputSchema: zodToInputSchema(invokeEndpointSchema),
108
+ },
109
+ handler: async (client, args) => {
110
+ if (!args) {
111
+ throw new Error('No endpoint provided');
112
+ }
113
+ const { success, data, error } = invokeEndpointSchema.safeParse(args);
114
+ if (!success) {
115
+ throw new Error(`Invalid arguments for endpoint. ${error?.format()}`);
116
+ }
117
+ const { endpoint_name, args: endpointArgs } = data;
118
+ const endpoint = endpoints.find((e) => e.tool.name === endpoint_name);
119
+ if (!endpoint) {
120
+ throw new Error(`Endpoint ${endpoint_name} not found. Use the \`list_api_endpoints\` tool to get the list of available endpoints.`);
121
+ }
122
+ try {
123
+ // Try to validate the arguments for a better error message
124
+ const cabidela = new cabidela_1.Cabidela(endpoint.tool.inputSchema, { fullErrors: true });
125
+ cabidela.validate(endpointArgs);
126
+ }
127
+ catch (error) {
128
+ throw new Error(`Invalid arguments for endpoint ${endpoint_name}:\n${error}`);
129
+ }
130
+ return await endpoint.handler(client, endpointArgs);
131
+ },
132
+ };
133
+ return [getEndpointTool, listEndpointsTool, invokeEndpointTool];
134
+ }
135
+ //# sourceMappingURL=dynamic-tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dynamic-tools.js","sourceRoot":"","sources":["src/dynamic-tools.ts"],"names":[],"mappings":"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"}