@basicbit/vrchat-mcp 0.1.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 (230) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/LICENSE +21 -0
  3. package/README.md +266 -0
  4. package/assets/logo.svg +39 -0
  5. package/dist/bin/cli.js +4 -0
  6. package/dist/bin/cli.js.map +1 -0
  7. package/dist/package.json +109 -0
  8. package/dist/src/auth/cookieStore.js +136 -0
  9. package/dist/src/auth/cookieStore.js.map +1 -0
  10. package/dist/src/auth/index.js +398 -0
  11. package/dist/src/auth/index.js.map +1 -0
  12. package/dist/src/config/defaults.json +58 -0
  13. package/dist/src/config/index.js +405 -0
  14. package/dist/src/config/index.js.map +1 -0
  15. package/dist/src/core/client.js +262 -0
  16. package/dist/src/core/client.js.map +1 -0
  17. package/dist/src/core/generatedToolOverrides.js +104 -0
  18. package/dist/src/core/generatedToolOverrides.js.map +1 -0
  19. package/dist/src/core/generatedToolSkips.js +28 -0
  20. package/dist/src/core/generatedToolSkips.js.map +1 -0
  21. package/dist/src/core/operationSchemas.js +102 -0
  22. package/dist/src/core/operationSchemas.js.map +1 -0
  23. package/dist/src/core/readToolRegistry.js +93 -0
  24. package/dist/src/core/readToolRegistry.js.map +1 -0
  25. package/dist/src/core/readTools.js +197 -0
  26. package/dist/src/core/readTools.js.map +1 -0
  27. package/dist/src/core/spec.js +137 -0
  28. package/dist/src/core/spec.js.map +1 -0
  29. package/dist/src/core/writeToolRegistry.js +113 -0
  30. package/dist/src/core/writeToolRegistry.js.map +1 -0
  31. package/dist/src/generated/vrchat-schemas.js +3326 -0
  32. package/dist/src/generated/vrchat-schemas.js.map +1 -0
  33. package/dist/src/index.js +31 -0
  34. package/dist/src/index.js.map +1 -0
  35. package/dist/src/infra/logger.js +26 -0
  36. package/dist/src/infra/logger.js.map +1 -0
  37. package/dist/src/models/avatars.js +22 -0
  38. package/dist/src/models/avatars.js.map +1 -0
  39. package/dist/src/models/events.js +115 -0
  40. package/dist/src/models/events.js.map +1 -0
  41. package/dist/src/models/friends.js +148 -0
  42. package/dist/src/models/friends.js.map +1 -0
  43. package/dist/src/models/groups.js +228 -0
  44. package/dist/src/models/groups.js.map +1 -0
  45. package/dist/src/models/instances.js +56 -0
  46. package/dist/src/models/instances.js.map +1 -0
  47. package/dist/src/models/invites.js +34 -0
  48. package/dist/src/models/invites.js.map +1 -0
  49. package/dist/src/models/notifications.js +62 -0
  50. package/dist/src/models/notifications.js.map +1 -0
  51. package/dist/src/models/status.js +50 -0
  52. package/dist/src/models/status.js.map +1 -0
  53. package/dist/src/models/statusPage.js +84 -0
  54. package/dist/src/models/statusPage.js.map +1 -0
  55. package/dist/src/models/users.js +113 -0
  56. package/dist/src/models/users.js.map +1 -0
  57. package/dist/src/models/vrcx.js +144 -0
  58. package/dist/src/models/vrcx.js.map +1 -0
  59. package/dist/src/models/worlds.js +150 -0
  60. package/dist/src/models/worlds.js.map +1 -0
  61. package/dist/src/resources/friendsChanges.js +44 -0
  62. package/dist/src/resources/friendsChanges.js.map +1 -0
  63. package/dist/src/resources/friendsSnapshot.js +69 -0
  64. package/dist/src/resources/friendsSnapshot.js.map +1 -0
  65. package/dist/src/resources/index.js +9 -0
  66. package/dist/src/resources/index.js.map +1 -0
  67. package/dist/src/resources/subscriptions.js +39 -0
  68. package/dist/src/resources/subscriptions.js.map +1 -0
  69. package/dist/src/schemas/auth.js +3 -0
  70. package/dist/src/schemas/auth.js.map +1 -0
  71. package/dist/src/schemas/call.js +13 -0
  72. package/dist/src/schemas/call.js.map +1 -0
  73. package/dist/src/schemas/read.js +58 -0
  74. package/dist/src/schemas/read.js.map +1 -0
  75. package/dist/src/schemas/write.js +18 -0
  76. package/dist/src/schemas/write.js.map +1 -0
  77. package/dist/src/services/api/client.js +66 -0
  78. package/dist/src/services/api/client.js.map +1 -0
  79. package/dist/src/services/api/index.js +2 -0
  80. package/dist/src/services/api/index.js.map +1 -0
  81. package/dist/src/services/avatars/index.js +24 -0
  82. package/dist/src/services/avatars/index.js.map +1 -0
  83. package/dist/src/services/cache.js +158 -0
  84. package/dist/src/services/cache.js.map +1 -0
  85. package/dist/src/services/events/curated.js +229 -0
  86. package/dist/src/services/events/curated.js.map +1 -0
  87. package/dist/src/services/events/index.js +3 -0
  88. package/dist/src/services/events/index.js.map +1 -0
  89. package/dist/src/services/events/utils.js +75 -0
  90. package/dist/src/services/events/utils.js.map +1 -0
  91. package/dist/src/services/friends/changes.js +246 -0
  92. package/dist/src/services/friends/changes.js.map +1 -0
  93. package/dist/src/services/friends/curated.js +497 -0
  94. package/dist/src/services/friends/curated.js.map +1 -0
  95. package/dist/src/services/friends/fetch.js +69 -0
  96. package/dist/src/services/friends/fetch.js.map +1 -0
  97. package/dist/src/services/friends/index.js +5 -0
  98. package/dist/src/services/friends/index.js.map +1 -0
  99. package/dist/src/services/friends/match.js +98 -0
  100. package/dist/src/services/friends/match.js.map +1 -0
  101. package/dist/src/services/groups/allowlist.js +19 -0
  102. package/dist/src/services/groups/allowlist.js.map +1 -0
  103. package/dist/src/services/groups/curated.js +343 -0
  104. package/dist/src/services/groups/curated.js.map +1 -0
  105. package/dist/src/services/groups/index.js +3 -0
  106. package/dist/src/services/groups/index.js.map +1 -0
  107. package/dist/src/services/instances/curated.js +80 -0
  108. package/dist/src/services/instances/curated.js.map +1 -0
  109. package/dist/src/services/instances/index.js +3 -0
  110. package/dist/src/services/instances/index.js.map +1 -0
  111. package/dist/src/services/instances/read.js +14 -0
  112. package/dist/src/services/instances/read.js.map +1 -0
  113. package/dist/src/services/invites/curated.js +90 -0
  114. package/dist/src/services/invites/curated.js.map +1 -0
  115. package/dist/src/services/invites/index.js +2 -0
  116. package/dist/src/services/invites/index.js.map +1 -0
  117. package/dist/src/services/notifications/curated.js +54 -0
  118. package/dist/src/services/notifications/curated.js.map +1 -0
  119. package/dist/src/services/notifications/index.js +2 -0
  120. package/dist/src/services/notifications/index.js.map +1 -0
  121. package/dist/src/services/pipeline/events.js +40 -0
  122. package/dist/src/services/pipeline/events.js.map +1 -0
  123. package/dist/src/services/pipeline/handlers.js +21 -0
  124. package/dist/src/services/pipeline/handlers.js.map +1 -0
  125. package/dist/src/services/pipeline/index.js +4 -0
  126. package/dist/src/services/pipeline/index.js.map +1 -0
  127. package/dist/src/services/pipeline/manager.js +143 -0
  128. package/dist/src/services/pipeline/manager.js.map +1 -0
  129. package/dist/src/services/status/curated.js +53 -0
  130. package/dist/src/services/status/curated.js.map +1 -0
  131. package/dist/src/services/status/index.js +2 -0
  132. package/dist/src/services/status/index.js.map +1 -0
  133. package/dist/src/services/statusPage/curated.js +397 -0
  134. package/dist/src/services/statusPage/curated.js.map +1 -0
  135. package/dist/src/services/statusPage/index.js +2 -0
  136. package/dist/src/services/statusPage/index.js.map +1 -0
  137. package/dist/src/services/users/curated.js +124 -0
  138. package/dist/src/services/users/curated.js.map +1 -0
  139. package/dist/src/services/users/groups.js +54 -0
  140. package/dist/src/services/users/groups.js.map +1 -0
  141. package/dist/src/services/users/index.js +3 -0
  142. package/dist/src/services/users/index.js.map +1 -0
  143. package/dist/src/services/vrcx/db.js +13 -0
  144. package/dist/src/services/vrcx/db.js.map +1 -0
  145. package/dist/src/services/vrcx/gamelog.js +125 -0
  146. package/dist/src/services/vrcx/gamelog.js.map +1 -0
  147. package/dist/src/services/vrcx/index.js +5 -0
  148. package/dist/src/services/vrcx/index.js.map +1 -0
  149. package/dist/src/services/vrcx/memos.js +51 -0
  150. package/dist/src/services/vrcx/memos.js.map +1 -0
  151. package/dist/src/services/vrcx/paths.js +133 -0
  152. package/dist/src/services/vrcx/paths.js.map +1 -0
  153. package/dist/src/services/vrcx/relationships.js +138 -0
  154. package/dist/src/services/vrcx/relationships.js.map +1 -0
  155. package/dist/src/services/vrcx/shared.js +173 -0
  156. package/dist/src/services/vrcx/shared.js.map +1 -0
  157. package/dist/src/services/vrcx/status.js +54 -0
  158. package/dist/src/services/vrcx/status.js.map +1 -0
  159. package/dist/src/services/worlds/index.js +256 -0
  160. package/dist/src/services/worlds/index.js.map +1 -0
  161. package/dist/src/tools/auth.js +44 -0
  162. package/dist/src/tools/auth.js.map +1 -0
  163. package/dist/src/tools/cache.js +61 -0
  164. package/dist/src/tools/cache.js.map +1 -0
  165. package/dist/src/tools/curated/avatars.js +57 -0
  166. package/dist/src/tools/curated/avatars.js.map +1 -0
  167. package/dist/src/tools/curated/events.js +212 -0
  168. package/dist/src/tools/curated/events.js.map +1 -0
  169. package/dist/src/tools/curated/friends.js +168 -0
  170. package/dist/src/tools/curated/friends.js.map +1 -0
  171. package/dist/src/tools/curated/groups.js +368 -0
  172. package/dist/src/tools/curated/groups.js.map +1 -0
  173. package/dist/src/tools/curated/instances.js +35 -0
  174. package/dist/src/tools/curated/instances.js.map +1 -0
  175. package/dist/src/tools/curated/invites.js +78 -0
  176. package/dist/src/tools/curated/invites.js.map +1 -0
  177. package/dist/src/tools/curated/notifications.js +35 -0
  178. package/dist/src/tools/curated/notifications.js.map +1 -0
  179. package/dist/src/tools/curated/status.js +44 -0
  180. package/dist/src/tools/curated/status.js.map +1 -0
  181. package/dist/src/tools/curated/statusPage.js +27 -0
  182. package/dist/src/tools/curated/statusPage.js.map +1 -0
  183. package/dist/src/tools/curated/users.js +201 -0
  184. package/dist/src/tools/curated/users.js.map +1 -0
  185. package/dist/src/tools/curated/vrcx/gamelog.js +80 -0
  186. package/dist/src/tools/curated/vrcx/gamelog.js.map +1 -0
  187. package/dist/src/tools/curated/vrcx/index.js +11 -0
  188. package/dist/src/tools/curated/vrcx/index.js.map +1 -0
  189. package/dist/src/tools/curated/vrcx/memos.js +105 -0
  190. package/dist/src/tools/curated/vrcx/memos.js.map +1 -0
  191. package/dist/src/tools/curated/vrcx/relationships.js +86 -0
  192. package/dist/src/tools/curated/vrcx/relationships.js.map +1 -0
  193. package/dist/src/tools/curated/vrcx/status.js +43 -0
  194. package/dist/src/tools/curated/vrcx/status.js.map +1 -0
  195. package/dist/src/tools/curated/worlds.js +162 -0
  196. package/dist/src/tools/curated/worlds.js.map +1 -0
  197. package/dist/src/tools/generated.js +19 -0
  198. package/dist/src/tools/generated.js.map +1 -0
  199. package/dist/src/tools/raw.js +49 -0
  200. package/dist/src/tools/raw.js.map +1 -0
  201. package/dist/src/tools/read/common.js +58 -0
  202. package/dist/src/tools/read/common.js.map +1 -0
  203. package/dist/src/tools/read/system.js +19 -0
  204. package/dist/src/tools/read/system.js.map +1 -0
  205. package/dist/src/tools/registerAllTools.js +41 -0
  206. package/dist/src/tools/registerAllTools.js.map +1 -0
  207. package/dist/src/tools/write/common.js +10 -0
  208. package/dist/src/tools/write/common.js.map +1 -0
  209. package/dist/src/utils/json.js +53 -0
  210. package/dist/src/utils/json.js.map +1 -0
  211. package/dist/src/utils/schema.js +14 -0
  212. package/dist/src/utils/schema.js.map +1 -0
  213. package/dist/src/utils/stableStringify.js +36 -0
  214. package/dist/src/utils/stableStringify.js.map +1 -0
  215. package/dist/src/utils/strings.js +7 -0
  216. package/dist/src/utils/strings.js.map +1 -0
  217. package/dist/src/utils/toolAnnotations.js +17 -0
  218. package/dist/src/utils/toolAnnotations.js.map +1 -0
  219. package/dist/src/utils/toolNames.js +13 -0
  220. package/dist/src/utils/toolNames.js.map +1 -0
  221. package/dist/src/utils/toolResponses.js +12 -0
  222. package/dist/src/utils/toolResponses.js.map +1 -0
  223. package/docs/architecture.md +46 -0
  224. package/docs/curated-tools.md +132 -0
  225. package/docs/design-notes.md +48 -0
  226. package/docs/evals.md +129 -0
  227. package/docs/tools-guide.md +27 -0
  228. package/docs/tools.md +13849 -0
  229. package/docs/vrcx.md +69 -0
  230. package/package.json +109 -0
@@ -0,0 +1,137 @@
1
+ import { fetch } from 'undici';
2
+ import YAML from 'yaml';
3
+ import { getConfig } from '../config/index.js';
4
+ import { readFile } from 'node:fs/promises';
5
+ function getSpecUrl() {
6
+ return getConfig().spec.url;
7
+ }
8
+ let cachedIndex = null;
9
+ async function fetchSpec(specUrl) {
10
+ // Support file paths for tests/offline usage
11
+ const isFilePath = specUrl.startsWith('file:') || /^[A-Za-z]:/.test(specUrl) || specUrl.startsWith('./') || specUrl.startsWith('../') || specUrl.startsWith('/');
12
+ if (isFilePath) {
13
+ const filePath = specUrl.startsWith('file:') ? new URL(specUrl) : specUrl;
14
+ const file = await readFile(filePath, 'utf8');
15
+ return YAML.parse(file);
16
+ }
17
+ const res = await fetch(specUrl);
18
+ if (!res.ok) {
19
+ throw new Error(`Failed to fetch OpenAPI spec (${res.status}) from ${specUrl}`);
20
+ }
21
+ const text = await res.text();
22
+ return YAML.parse(text);
23
+ }
24
+ function derefParameter(param, componentsParams) {
25
+ if (!param)
26
+ return null;
27
+ if (param.$ref && componentsParams) {
28
+ const key = String(param.$ref).split('/').pop() ?? '';
29
+ return componentsParams[key] ?? param;
30
+ }
31
+ return param;
32
+ }
33
+ function extractParamSchema(param) {
34
+ if (!param || typeof param !== 'object')
35
+ return undefined;
36
+ if (param.schema)
37
+ return param.schema;
38
+ const content = param.content;
39
+ if (content && typeof content === 'object') {
40
+ const json = content['application/json'] ??
41
+ Object.values(content)[0];
42
+ if (json && typeof json === 'object' && 'schema' in json) {
43
+ return json.schema;
44
+ }
45
+ }
46
+ return undefined;
47
+ }
48
+ function collectParameters(op, pathItem, componentsParams) {
49
+ const params = [];
50
+ const seen = new Set();
51
+ const add = (list) => {
52
+ (list ?? []).forEach((p) => {
53
+ const rp = derefParameter(p, componentsParams);
54
+ if (!rp || !rp.name || !rp.in)
55
+ return;
56
+ const key = `${rp.in}:${rp.name}`;
57
+ if (seen.has(key))
58
+ return;
59
+ seen.add(key);
60
+ const required = rp.in === 'path' ? true : Boolean(rp.required);
61
+ params.push({
62
+ name: rp.name,
63
+ in: rp.in,
64
+ required,
65
+ description: typeof rp.description === 'string' ? rp.description : undefined,
66
+ schema: extractParamSchema(rp),
67
+ });
68
+ });
69
+ };
70
+ add(pathItem?.parameters);
71
+ add(op?.parameters);
72
+ return params;
73
+ }
74
+ function derefRequestBody(requestBody, componentsBodies) {
75
+ if (!requestBody)
76
+ return null;
77
+ if (requestBody.$ref && componentsBodies) {
78
+ const key = String(requestBody.$ref).split('/').pop() ?? '';
79
+ return componentsBodies[key] ?? requestBody;
80
+ }
81
+ return requestBody;
82
+ }
83
+ function extractRequestBody(requestBody, componentsBodies) {
84
+ const body = derefRequestBody(requestBody, componentsBodies);
85
+ if (!body || typeof body !== 'object')
86
+ return { required: false };
87
+ const required = Boolean(body.required);
88
+ const descriptionValue = body.description;
89
+ const description = typeof descriptionValue === 'string' ? descriptionValue : undefined;
90
+ const content = body.content ?? {};
91
+ const json = content['application/json'] ?? Object.values(content)[0];
92
+ const schema = json && typeof json === 'object' && 'schema' in json
93
+ ? json.schema
94
+ : undefined;
95
+ return { schema, required, description };
96
+ }
97
+ function buildIndex(spec) {
98
+ const operations = new Map();
99
+ const paths = spec?.paths ?? {};
100
+ const componentsParams = spec?.components?.parameters ?? undefined;
101
+ const componentsBodies = spec?.components?.requestBodies ?? undefined;
102
+ for (const [pathKey, pathItem] of Object.entries(paths)) {
103
+ for (const [method, op] of Object.entries(pathItem)) {
104
+ const m = method.toLowerCase();
105
+ if (!['get', 'post', 'put', 'delete', 'patch'].includes(m))
106
+ continue;
107
+ const operationId = typeof op.operationId === 'string' ? op.operationId : undefined;
108
+ if (!operationId)
109
+ continue;
110
+ const parameters = collectParameters(op, pathItem, componentsParams);
111
+ const requestBody = extractRequestBody(op.requestBody, componentsBodies);
112
+ const hasRequestBody = Boolean(op.requestBody);
113
+ operations.set(operationId, {
114
+ operationId,
115
+ method: m.toUpperCase(),
116
+ path: pathKey,
117
+ parameters,
118
+ hasRequestBody,
119
+ requestBodySchema: requestBody.schema,
120
+ requestBodyRequired: requestBody.required,
121
+ requestBodyDescription: requestBody.description,
122
+ });
123
+ }
124
+ }
125
+ return { operations, raw: spec };
126
+ }
127
+ export async function getSpecIndex() {
128
+ if (cachedIndex)
129
+ return cachedIndex;
130
+ const spec = await fetchSpec(getSpecUrl());
131
+ cachedIndex = buildIndex(spec);
132
+ return cachedIndex;
133
+ }
134
+ export function clearSpecCache() {
135
+ cachedIndex = null;
136
+ }
137
+ //# sourceMappingURL=spec.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../src/core/spec.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,113 @@
1
+ import { z } from 'zod';
2
+ import { getConfig } from '../config/index.js';
3
+ import { getSpecIndex } from './spec.js';
4
+ import { callOperation, CallError } from './client.js';
5
+ import { buildParamsSchema, buildRequestBodySchema } from './operationSchemas.js';
6
+ import { writeToolName } from '../utils/toolNames.js';
7
+ import { toolError } from '../utils/toolResponses.js';
8
+ import { annotationsForWriteMethod } from '../utils/toolAnnotations.js';
9
+ import { getCuratedWriteToolName, getGeneratedWriteToolDescription, } from './generatedToolOverrides.js';
10
+ import { GENERATED_WRITE_SKIP_IDS } from './generatedToolSkips.js';
11
+ const WRITE_METHODS = new Set(['post', 'put', 'patch', 'delete']);
12
+ function isPlainObject(value) {
13
+ return Boolean(value && typeof value === 'object' && !Array.isArray(value));
14
+ }
15
+ function getWriteOperationInfo(method, opValue, skipOperationIds) {
16
+ if (!WRITE_METHODS.has(method))
17
+ return null;
18
+ if (!isPlainObject(opValue))
19
+ return null;
20
+ const op = opValue;
21
+ const operationId = typeof op.operationId === 'string' ? op.operationId : undefined;
22
+ if (!operationId)
23
+ return null;
24
+ if (skipOperationIds.has(operationId))
25
+ return null;
26
+ return { operationId, op };
27
+ }
28
+ function buildGeneratedWriteToolDescription(operationId, op) {
29
+ const summary = (typeof op.summary === 'string' ? op.summary : undefined) ??
30
+ (typeof op.description === 'string' ? op.description : undefined) ??
31
+ '';
32
+ const summaryLine = String(summary).split('\n')[0].trim();
33
+ const curated = getCuratedWriteToolName(operationId);
34
+ const override = getGeneratedWriteToolDescription(operationId);
35
+ if (override)
36
+ return override;
37
+ const fallback = summaryLine
38
+ ? `Auto-generated write tool. ${summaryLine}`
39
+ : `Auto-generated write tool for ${operationId}.`;
40
+ if (curated)
41
+ return `${fallback} Prefer curated tool: ${curated}.`;
42
+ return `${fallback} Prefer curated tools when available.`;
43
+ }
44
+ function buildGeneratedWriteToolInputSchema(input) {
45
+ const opDef = input.index.operations.get(input.operationId);
46
+ const paramsInfo = buildParamsSchema(opDef?.parameters ?? [], input.componentsSchemas);
47
+ const bodyInfo = buildRequestBodySchema(opDef, input.componentsSchemas);
48
+ const shape = {};
49
+ if (paramsInfo.schema) {
50
+ shape.params = paramsInfo.required ? paramsInfo.schema : paramsInfo.schema.optional();
51
+ }
52
+ if (bodyInfo.schema) {
53
+ shape.body = bodyInfo.required ? bodyInfo.schema : bodyInfo.schema.optional();
54
+ }
55
+ return z.object(shape).merge(input.writeOptionsSchema).passthrough();
56
+ }
57
+ export async function registerGeneratedWriteTools(server, options) {
58
+ const config = getConfig();
59
+ if (config.generatedWriteTools.disable)
60
+ return 0;
61
+ const skipOperationIds = new Set(GENERATED_WRITE_SKIP_IDS);
62
+ const index = await getSpecIndex();
63
+ const spec = index.raw;
64
+ const paths = spec?.paths ?? {};
65
+ const componentsSchemas = spec?.components?.schemas;
66
+ let count = 0;
67
+ for (const pathItem of Object.values(paths)) {
68
+ if (!isPlainObject(pathItem))
69
+ continue;
70
+ for (const [method, opValue] of Object.entries(pathItem)) {
71
+ const info = getWriteOperationInfo(method, opValue, skipOperationIds);
72
+ if (!info)
73
+ continue;
74
+ const { operationId, op } = info;
75
+ const toolName = writeToolName(operationId);
76
+ const description = buildGeneratedWriteToolDescription(operationId, op);
77
+ const inputSchema = buildGeneratedWriteToolInputSchema({
78
+ operationId,
79
+ index,
80
+ componentsSchemas,
81
+ writeOptionsSchema: options.writeOptionsSchema,
82
+ });
83
+ server.registerTool(toolName, {
84
+ description,
85
+ inputSchema,
86
+ outputSchema: options.writeOutputSchema,
87
+ annotations: annotationsForWriteMethod(method),
88
+ }, async (args) => {
89
+ try {
90
+ const input = (args ?? {});
91
+ const { params = {}, body, options: callOptions, includeMeta } = input;
92
+ const result = await callOperation({
93
+ operationId,
94
+ params,
95
+ body,
96
+ options: callOptions,
97
+ });
98
+ return options.respond(result, includeMeta);
99
+ }
100
+ catch (err) {
101
+ if (err instanceof CallError && err.payload) {
102
+ return toolError(err.message, err.payload);
103
+ }
104
+ const message = err instanceof Error ? err.message : 'Unknown error';
105
+ return toolError(message);
106
+ }
107
+ });
108
+ count += 1;
109
+ }
110
+ }
111
+ return count;
112
+ }
113
+ //# sourceMappingURL=writeToolRegistry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"writeToolRegistry.js","sourceRoot":"","sources":["../../../src/core/writeToolRegistry.ts"],"names":[],"mappings":"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"}