@once-agent/sdk 0.1.10 → 0.1.12

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 (166) hide show
  1. package/README.md +76 -1
  2. package/dist/cli.js +50 -1
  3. package/dist/cli.js.map +1 -1
  4. package/dist/connect/identity.d.ts +22 -0
  5. package/dist/connect/identity.d.ts.map +1 -0
  6. package/dist/connect/identity.js +159 -0
  7. package/dist/connect/identity.js.map +1 -0
  8. package/dist/connect/index.d.ts +17 -0
  9. package/dist/connect/index.d.ts.map +1 -0
  10. package/dist/connect/index.js +9 -0
  11. package/dist/connect/index.js.map +1 -0
  12. package/dist/connect/local-agent-tool.d.ts +62 -0
  13. package/dist/connect/local-agent-tool.d.ts.map +1 -0
  14. package/dist/connect/local-agent-tool.js +131 -0
  15. package/dist/connect/local-agent-tool.js.map +1 -0
  16. package/dist/connect/manifest.d.ts +55 -0
  17. package/dist/connect/manifest.d.ts.map +1 -0
  18. package/dist/connect/manifest.js +166 -0
  19. package/dist/connect/manifest.js.map +1 -0
  20. package/dist/connect/openai-function-tools.d.ts +66 -0
  21. package/dist/connect/openai-function-tools.d.ts.map +1 -0
  22. package/dist/connect/openai-function-tools.js +182 -0
  23. package/dist/connect/openai-function-tools.js.map +1 -0
  24. package/dist/connect/payload.d.ts +30 -0
  25. package/dist/connect/payload.d.ts.map +1 -0
  26. package/dist/connect/payload.js +122 -0
  27. package/dist/connect/payload.js.map +1 -0
  28. package/dist/connect/tool-classifier.d.ts +40 -0
  29. package/dist/connect/tool-classifier.d.ts.map +1 -0
  30. package/dist/connect/tool-classifier.js +271 -0
  31. package/dist/connect/tool-classifier.js.map +1 -0
  32. package/dist/connect/toolset.d.ts +42 -0
  33. package/dist/connect/toolset.d.ts.map +1 -0
  34. package/dist/connect/toolset.js +123 -0
  35. package/dist/connect/toolset.js.map +1 -0
  36. package/dist/discovery/index.d.ts +13 -0
  37. package/dist/discovery/index.d.ts.map +1 -0
  38. package/dist/discovery/index.js +8 -0
  39. package/dist/discovery/index.js.map +1 -0
  40. package/dist/execution-observation.d.ts +122 -0
  41. package/dist/execution-observation.d.ts.map +1 -0
  42. package/dist/execution-observation.js +324 -0
  43. package/dist/execution-observation.js.map +1 -0
  44. package/dist/gateway/index.d.ts +9 -0
  45. package/dist/gateway/index.d.ts.map +1 -0
  46. package/dist/gateway/index.js +5 -0
  47. package/dist/gateway/index.js.map +1 -0
  48. package/dist/gateway/local-toolset.d.ts +32 -0
  49. package/dist/gateway/local-toolset.d.ts.map +1 -0
  50. package/dist/gateway/local-toolset.js +79 -0
  51. package/dist/gateway/local-toolset.js.map +1 -0
  52. package/dist/gateway/openai-function-tools.d.ts +28 -0
  53. package/dist/gateway/openai-function-tools.d.ts.map +1 -0
  54. package/dist/gateway/openai-function-tools.js +117 -0
  55. package/dist/gateway/openai-function-tools.js.map +1 -0
  56. package/dist/gateway/planner.d.ts +53 -0
  57. package/dist/gateway/planner.d.ts.map +1 -0
  58. package/dist/gateway/planner.js +155 -0
  59. package/dist/gateway/planner.js.map +1 -0
  60. package/dist/gateway/tool-graph-binding.d.ts +51 -0
  61. package/dist/gateway/tool-graph-binding.d.ts.map +1 -0
  62. package/dist/gateway/tool-graph-binding.js +123 -0
  63. package/dist/gateway/tool-graph-binding.js.map +1 -0
  64. package/dist/index.d.ts +2 -0
  65. package/dist/index.d.ts.map +1 -1
  66. package/dist/index.js +1 -0
  67. package/dist/index.js.map +1 -1
  68. package/dist/langchain-execution-observer.d.ts +22 -0
  69. package/dist/langchain-execution-observer.d.ts.map +1 -0
  70. package/dist/langchain-execution-observer.js +128 -0
  71. package/dist/langchain-execution-observer.js.map +1 -0
  72. package/dist/langchain-runtime-discovery.d.ts +33 -0
  73. package/dist/langchain-runtime-discovery.d.ts.map +1 -0
  74. package/dist/langchain-runtime-discovery.js +214 -0
  75. package/dist/langchain-runtime-discovery.js.map +1 -0
  76. package/dist/mcp-live-discovery.d.ts +71 -0
  77. package/dist/mcp-live-discovery.d.ts.map +1 -0
  78. package/dist/mcp-live-discovery.js +710 -0
  79. package/dist/mcp-live-discovery.js.map +1 -0
  80. package/dist/mcp-live-report.d.ts +3 -0
  81. package/dist/mcp-live-report.d.ts.map +1 -0
  82. package/dist/mcp-live-report.js +50 -0
  83. package/dist/mcp-live-report.js.map +1 -0
  84. package/dist/mcp-tool-refresh-report.d.ts +3 -0
  85. package/dist/mcp-tool-refresh-report.d.ts.map +1 -0
  86. package/dist/mcp-tool-refresh-report.js +44 -0
  87. package/dist/mcp-tool-refresh-report.js.map +1 -0
  88. package/dist/mcp-tool-refresh.d.ts +33 -0
  89. package/dist/mcp-tool-refresh.d.ts.map +1 -0
  90. package/dist/mcp-tool-refresh.js +489 -0
  91. package/dist/mcp-tool-refresh.js.map +1 -0
  92. package/dist/openai-agents-execution-observer.d.ts +24 -0
  93. package/dist/openai-agents-execution-observer.d.ts.map +1 -0
  94. package/dist/openai-agents-execution-observer.js +163 -0
  95. package/dist/openai-agents-execution-observer.js.map +1 -0
  96. package/dist/otel-execution-observer.d.ts +16 -0
  97. package/dist/otel-execution-observer.d.ts.map +1 -0
  98. package/dist/otel-execution-observer.js +129 -0
  99. package/dist/otel-execution-observer.js.map +1 -0
  100. package/dist/runtime-tool-discovery.d.ts +86 -0
  101. package/dist/runtime-tool-discovery.d.ts.map +1 -0
  102. package/dist/runtime-tool-discovery.js +429 -0
  103. package/dist/runtime-tool-discovery.js.map +1 -0
  104. package/dist/tool-discovery.d.ts +51 -0
  105. package/dist/tool-discovery.d.ts.map +1 -0
  106. package/dist/tool-discovery.js +487 -0
  107. package/dist/tool-discovery.js.map +1 -0
  108. package/dist/tool-importance.d.ts +34 -0
  109. package/dist/tool-importance.d.ts.map +1 -0
  110. package/dist/tool-importance.js +269 -0
  111. package/dist/tool-importance.js.map +1 -0
  112. package/dist/tool-report.d.ts +3 -0
  113. package/dist/tool-report.d.ts.map +1 -0
  114. package/dist/tool-report.js +75 -0
  115. package/dist/tool-report.js.map +1 -0
  116. package/dist/vercel-execution-observer.d.ts +12 -0
  117. package/dist/vercel-execution-observer.d.ts.map +1 -0
  118. package/dist/vercel-execution-observer.js +97 -0
  119. package/dist/vercel-execution-observer.js.map +1 -0
  120. package/dist-cjs/connect/identity.js +162 -0
  121. package/dist-cjs/connect/identity.js.map +1 -0
  122. package/dist-cjs/connect/index.js +26 -0
  123. package/dist-cjs/connect/index.js.map +1 -0
  124. package/dist-cjs/connect/local-agent-tool.js +137 -0
  125. package/dist-cjs/connect/local-agent-tool.js.map +1 -0
  126. package/dist-cjs/connect/manifest.js +171 -0
  127. package/dist-cjs/connect/manifest.js.map +1 -0
  128. package/dist-cjs/connect/openai-function-tools.js +187 -0
  129. package/dist-cjs/connect/openai-function-tools.js.map +1 -0
  130. package/dist-cjs/connect/payload.js +125 -0
  131. package/dist-cjs/connect/payload.js.map +1 -0
  132. package/dist-cjs/connect/tool-classifier.js +276 -0
  133. package/dist-cjs/connect/tool-classifier.js.map +1 -0
  134. package/dist-cjs/connect/toolset.js +126 -0
  135. package/dist-cjs/connect/toolset.js.map +1 -0
  136. package/dist-cjs/discovery/index.js +26 -0
  137. package/dist-cjs/discovery/index.js.map +1 -0
  138. package/dist-cjs/execution-observation.js +330 -0
  139. package/dist-cjs/execution-observation.js.map +1 -0
  140. package/dist-cjs/gateway/index.js +16 -0
  141. package/dist-cjs/gateway/index.js.map +1 -0
  142. package/dist-cjs/gateway/local-toolset.js +84 -0
  143. package/dist-cjs/gateway/local-toolset.js.map +1 -0
  144. package/dist-cjs/gateway/openai-function-tools.js +120 -0
  145. package/dist-cjs/gateway/openai-function-tools.js.map +1 -0
  146. package/dist-cjs/gateway/planner.js +160 -0
  147. package/dist-cjs/gateway/planner.js.map +1 -0
  148. package/dist-cjs/gateway/tool-graph-binding.js +126 -0
  149. package/dist-cjs/gateway/tool-graph-binding.js.map +1 -0
  150. package/dist-cjs/index.js +4 -1
  151. package/dist-cjs/index.js.map +1 -1
  152. package/dist-cjs/langchain-execution-observer.js +131 -0
  153. package/dist-cjs/langchain-execution-observer.js.map +1 -0
  154. package/dist-cjs/langchain-runtime-discovery.js +218 -0
  155. package/dist-cjs/langchain-runtime-discovery.js.map +1 -0
  156. package/dist-cjs/openai-agents-execution-observer.js +166 -0
  157. package/dist-cjs/openai-agents-execution-observer.js.map +1 -0
  158. package/dist-cjs/otel-execution-observer.js +132 -0
  159. package/dist-cjs/otel-execution-observer.js.map +1 -0
  160. package/dist-cjs/runtime-tool-discovery.js +436 -0
  161. package/dist-cjs/runtime-tool-discovery.js.map +1 -0
  162. package/dist-cjs/tool-importance.js +272 -0
  163. package/dist-cjs/tool-importance.js.map +1 -0
  164. package/dist-cjs/vercel-execution-observer.js +100 -0
  165. package/dist-cjs/vercel-execution-observer.js.map +1 -0
  166. package/package.json +25 -3
@@ -0,0 +1,489 @@
1
+ import { promises as fs } from "node:fs";
2
+ import os from "node:os";
3
+ import path from "node:path";
4
+ import { discoverLiveMcpTools, } from "./mcp-live-discovery.js";
5
+ const MODERN_PROTOCOL_VERSION = "2026-07-28";
6
+ const DEFAULT_WATCH_MS = 5_000;
7
+ const DEFAULT_MAX_STREAM_BYTES = 1_000_000;
8
+ export class McpToolRefreshError extends Error {
9
+ code;
10
+ constructor(code, message) {
11
+ super(message);
12
+ this.code = code;
13
+ this.name = "McpToolRefreshError";
14
+ }
15
+ }
16
+ function asRecord(value) {
17
+ if (value &&
18
+ typeof value === "object" &&
19
+ !Array.isArray(value)) {
20
+ return value;
21
+ }
22
+ return undefined;
23
+ }
24
+ function stripJsonComments(input) {
25
+ let output = "";
26
+ let inString = false;
27
+ let quote = "";
28
+ let escaped = false;
29
+ let lineComment = false;
30
+ let blockComment = false;
31
+ for (let index = 0; index < input.length; index++) {
32
+ const char = input[index] ?? "";
33
+ const next = input[index + 1] ?? "";
34
+ if (lineComment) {
35
+ if (char === "\n") {
36
+ lineComment = false;
37
+ output += char;
38
+ }
39
+ continue;
40
+ }
41
+ if (blockComment) {
42
+ if (char === "*" && next === "/") {
43
+ blockComment = false;
44
+ index++;
45
+ }
46
+ else if (char === "\n") {
47
+ output += char;
48
+ }
49
+ continue;
50
+ }
51
+ if (inString) {
52
+ output += char;
53
+ if (escaped) {
54
+ escaped = false;
55
+ continue;
56
+ }
57
+ if (char === "\\") {
58
+ escaped = true;
59
+ continue;
60
+ }
61
+ if (char === quote) {
62
+ inString = false;
63
+ quote = "";
64
+ }
65
+ continue;
66
+ }
67
+ if (char === '"' || char === "'") {
68
+ inString = true;
69
+ quote = char;
70
+ output += char;
71
+ continue;
72
+ }
73
+ if (char === "/" && next === "/") {
74
+ lineComment = true;
75
+ index++;
76
+ continue;
77
+ }
78
+ if (char === "/" && next === "*") {
79
+ blockComment = true;
80
+ index++;
81
+ continue;
82
+ }
83
+ output += char;
84
+ }
85
+ return output;
86
+ }
87
+ function serverMapsFromJson(parsed) {
88
+ const root = asRecord(parsed);
89
+ if (!root)
90
+ return [];
91
+ const maps = [];
92
+ for (const key of ["mcpServers", "servers"]) {
93
+ const value = asRecord(root[key]);
94
+ if (value)
95
+ maps.push(value);
96
+ }
97
+ const customizations = asRecord(root.customizations);
98
+ const vscode = asRecord(customizations?.vscode);
99
+ const mcp = asRecord(vscode?.mcp);
100
+ for (const key of ["mcpServers", "servers"]) {
101
+ const value = asRecord(mcp?.[key]);
102
+ if (value)
103
+ maps.push(value);
104
+ }
105
+ return maps;
106
+ }
107
+ function absoluteConfigPath(root, configPath) {
108
+ if (configPath === "~")
109
+ return os.homedir();
110
+ if (configPath.startsWith("~/")) {
111
+ return path.join(os.homedir(), ...configPath.substring(2).split("/"));
112
+ }
113
+ if (path.isAbsolute(configPath))
114
+ return configPath;
115
+ return path.resolve(root, configPath);
116
+ }
117
+ function stringHeaders(value) {
118
+ const record = asRecord(value);
119
+ if (!record)
120
+ return {};
121
+ const headers = {};
122
+ for (const [key, item] of Object.entries(record)) {
123
+ if (typeof item === "string")
124
+ headers[key] = item;
125
+ }
126
+ return headers;
127
+ }
128
+ function parseTomlString(raw) {
129
+ const value = raw.trim();
130
+ const match = value.match(/^(?:"((?:\\.|[^"])*)"|'([^']*)')$/);
131
+ if (!match)
132
+ return undefined;
133
+ const body = match[1] ?? match[2] ?? "";
134
+ return body.replace(/\\"/g, '"').replace(/\\\\/g, "\\");
135
+ }
136
+ async function resolveTarget(root, source) {
137
+ const filePath = absoluteConfigPath(root, source.configPath);
138
+ let raw;
139
+ try {
140
+ raw = await fs.readFile(filePath, "utf8");
141
+ }
142
+ catch {
143
+ return undefined;
144
+ }
145
+ if (source.host === "codex" || source.configPath.endsWith(".toml")) {
146
+ const escapedName = source.name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
147
+ const sectionPattern = new RegExp(`^\\s*\\[mcp_servers\\.(?:${escapedName}|"${escapedName}"|'${escapedName}')\\]\\s*$`, "m");
148
+ const match = sectionPattern.exec(raw);
149
+ if (!match)
150
+ return undefined;
151
+ const sectionStart = (match.index ?? 0) + match[0].length;
152
+ const rest = raw.substring(sectionStart);
153
+ const nextSection = rest.search(/^\s*\[/m);
154
+ const section = nextSection >= 0 ? rest.substring(0, nextSection) : rest;
155
+ const urlMatch = section.match(/^\s*url\s*=\s*(.+?)\s*$/m);
156
+ const url = urlMatch ? parseTomlString(urlMatch[1] ?? "") : undefined;
157
+ return url ? { source, url, headers: {} } : undefined;
158
+ }
159
+ let parsed;
160
+ try {
161
+ parsed = JSON.parse(stripJsonComments(raw.replace(/^\uFEFF/, "")));
162
+ }
163
+ catch {
164
+ return undefined;
165
+ }
166
+ for (const serverMap of serverMapsFromJson(parsed)) {
167
+ const definition = asRecord(serverMap[source.name]);
168
+ if (!definition || typeof definition.url !== "string")
169
+ continue;
170
+ return {
171
+ source,
172
+ url: definition.url,
173
+ headers: stringHeaders(definition.headers),
174
+ };
175
+ }
176
+ return undefined;
177
+ }
178
+ function selectOneSource(sources, selector) {
179
+ const exact = sources.filter(source => source.sourceId === selector ||
180
+ `${source.host}/${source.name}` === selector);
181
+ const matches = exact.length > 0
182
+ ? exact
183
+ : sources.filter(source => source.name === selector);
184
+ if (matches.length === 0) {
185
+ throw new McpToolRefreshError("SELECTOR_NOT_FOUND", `Configured MCP server selector not found: ${selector}`);
186
+ }
187
+ if (matches.length > 1) {
188
+ throw new McpToolRefreshError("SELECTOR_AMBIGUOUS", `Configured MCP server selector is ambiguous; use host/name: ${selector}`);
189
+ }
190
+ return matches[0];
191
+ }
192
+ function modernMeta() {
193
+ return {
194
+ "io.modelcontextprotocol/protocolVersion": MODERN_PROTOCOL_VERSION,
195
+ "io.modelcontextprotocol/clientCapabilities": {},
196
+ "io.modelcontextprotocol/clientInfo": {
197
+ name: "once-tool-discovery",
198
+ version: "phase11b-refresh-v1",
199
+ },
200
+ };
201
+ }
202
+ function namespacedName(tool) {
203
+ return `${tool.origin.host}/${tool.origin.server}/${tool.canonicalName}`;
204
+ }
205
+ function stableToolShape(tool) {
206
+ return JSON.stringify({
207
+ description: tool.description,
208
+ inputSchema: tool.inputSchema,
209
+ annotations: tool.annotations,
210
+ });
211
+ }
212
+ export function diffMcpToolSnapshots(before, after) {
213
+ const beforeMap = new Map(before.map(tool => [namespacedName(tool), tool]));
214
+ const afterMap = new Map(after.map(tool => [namespacedName(tool), tool]));
215
+ const added = [...afterMap.keys()]
216
+ .filter(name => !beforeMap.has(name))
217
+ .sort();
218
+ const removed = [...beforeMap.keys()]
219
+ .filter(name => !afterMap.has(name))
220
+ .sort();
221
+ const changed = [...afterMap.keys()]
222
+ .filter(name => {
223
+ const prior = beforeMap.get(name);
224
+ const current = afterMap.get(name);
225
+ return Boolean(prior && current &&
226
+ stableToolShape(prior) !== stableToolShape(current));
227
+ })
228
+ .sort();
229
+ return { added, removed, changed };
230
+ }
231
+ export function rankMcpSourcePrecedence(sources) {
232
+ return [...sources].sort((left, right) => {
233
+ const leftScope = left.scope === "PROJECT" ? 0 : 1;
234
+ const rightScope = right.scope === "PROJECT" ? 0 : 1;
235
+ return (leftScope - rightScope ||
236
+ left.host.localeCompare(right.host) ||
237
+ left.name.localeCompare(right.name) ||
238
+ left.configPath.localeCompare(right.configPath));
239
+ });
240
+ }
241
+ async function waitForModernToolChange(target, watchMs, maxStreamBytes) {
242
+ let endpoint;
243
+ try {
244
+ endpoint = new URL(target.url);
245
+ }
246
+ catch {
247
+ throw new McpToolRefreshError("INVALID_ENDPOINT", "Configured MCP endpoint is not a valid URL.");
248
+ }
249
+ if (endpoint.protocol !== "http:" && endpoint.protocol !== "https:") {
250
+ throw new McpToolRefreshError("UNSUPPORTED_ENDPOINT_SCHEME", "MCP tool refresh supports HTTP(S) endpoints only.");
251
+ }
252
+ const requestId = `once-tools-listen-${Date.now()}`;
253
+ const controller = new AbortController();
254
+ const timer = setTimeout(() => controller.abort(), watchMs);
255
+ let response;
256
+ try {
257
+ response = await fetch(endpoint, {
258
+ method: "POST",
259
+ redirect: "manual",
260
+ signal: controller.signal,
261
+ headers: {
262
+ ...target.headers,
263
+ "Content-Type": "application/json",
264
+ "Accept": "text/event-stream, application/json",
265
+ "MCP-Protocol-Version": MODERN_PROTOCOL_VERSION,
266
+ "Mcp-Method": "subscriptions/listen",
267
+ },
268
+ body: JSON.stringify({
269
+ jsonrpc: "2.0",
270
+ id: requestId,
271
+ method: "subscriptions/listen",
272
+ params: {
273
+ notifications: {
274
+ toolsListChanged: true,
275
+ },
276
+ _meta: modernMeta(),
277
+ },
278
+ }),
279
+ });
280
+ }
281
+ catch (error) {
282
+ clearTimeout(timer);
283
+ if (error instanceof Error && error.name === "AbortError") {
284
+ return { acknowledged: false, changed: false };
285
+ }
286
+ throw new McpToolRefreshError("NETWORK_ERROR", "MCP subscription endpoint could not be reached.");
287
+ }
288
+ if (response.status >= 300 && response.status < 400) {
289
+ clearTimeout(timer);
290
+ controller.abort();
291
+ throw new McpToolRefreshError("REDIRECT_BLOCKED", "MCP subscription returned a redirect; redirects are not followed.");
292
+ }
293
+ if (!response.ok || !response.body) {
294
+ clearTimeout(timer);
295
+ controller.abort();
296
+ throw new McpToolRefreshError(`HTTP_${response.status}`, `MCP subscription returned HTTP ${response.status}.`);
297
+ }
298
+ const reader = response.body.getReader();
299
+ const decoder = new TextDecoder();
300
+ let buffer = "";
301
+ let totalBytes = 0;
302
+ let acknowledged = false;
303
+ let changed = false;
304
+ try {
305
+ while (true) {
306
+ let item;
307
+ try {
308
+ item = await reader.read();
309
+ }
310
+ catch (error) {
311
+ if (error instanceof Error && error.name === "AbortError")
312
+ break;
313
+ throw error;
314
+ }
315
+ if (item.done)
316
+ break;
317
+ totalBytes += item.value.byteLength;
318
+ if (totalBytes > maxStreamBytes) {
319
+ throw new McpToolRefreshError("STREAM_TOO_LARGE", "MCP subscription exceeded the configured stream-size limit.");
320
+ }
321
+ buffer += decoder.decode(item.value, { stream: true });
322
+ const frames = buffer.split(/\r?\n\r?\n/);
323
+ buffer = frames.pop() ?? "";
324
+ for (const frame of frames) {
325
+ const data = frame
326
+ .split(/\r?\n/)
327
+ .filter(line => line.startsWith("data:"))
328
+ .map(line => line.substring(5).trim())
329
+ .join("\n");
330
+ if (!data)
331
+ continue;
332
+ let parsed;
333
+ try {
334
+ parsed = JSON.parse(data);
335
+ }
336
+ catch {
337
+ continue;
338
+ }
339
+ const event = asRecord(parsed);
340
+ if (!event)
341
+ continue;
342
+ const method = typeof event.method === "string" ? event.method : "";
343
+ const params = asRecord(event.params);
344
+ const meta = asRecord(params?._meta);
345
+ const subscriptionId = meta?.["io.modelcontextprotocol/subscriptionId"];
346
+ if (subscriptionId !== undefined &&
347
+ subscriptionId !== requestId) {
348
+ continue;
349
+ }
350
+ if (method === "notifications/subscriptions/acknowledged") {
351
+ acknowledged = true;
352
+ continue;
353
+ }
354
+ if (method === "notifications/tools/list_changed") {
355
+ if (acknowledged) {
356
+ changed = true;
357
+ return { acknowledged, changed };
358
+ }
359
+ }
360
+ }
361
+ }
362
+ }
363
+ finally {
364
+ clearTimeout(timer);
365
+ controller.abort();
366
+ try {
367
+ await reader.cancel();
368
+ }
369
+ catch {
370
+ // Stream is already closed/aborted.
371
+ }
372
+ }
373
+ return { acknowledged, changed };
374
+ }
375
+ export async function watchMcpToolListOnce(root, configuredSources, selector, initial, options = {}) {
376
+ const source = selectOneSource(configuredSources, selector);
377
+ const sourceLabel = `${source.host}/${source.name}`;
378
+ const namespace = sourceLabel;
379
+ const watchMs = options.watchMs ?? DEFAULT_WATCH_MS;
380
+ const maxStreamBytes = options.maxStreamBytes ?? DEFAULT_MAX_STREAM_BYTES;
381
+ if (!Number.isFinite(watchMs) || watchMs < 50 || watchMs > 60_000) {
382
+ throw new McpToolRefreshError("INVALID_WATCH_WINDOW", "MCP tool watch window must be between 50 and 60000 milliseconds.");
383
+ }
384
+ const initialProbe = initial.probes.find(probe => probe.sourceId === source.sourceId);
385
+ const beforeTools = initial.tools.filter(tool => tool.source.sourceId === source.sourceId);
386
+ if (!initialProbe || initialProbe.status !== "ENUMERATED") {
387
+ return {
388
+ source: sourceLabel,
389
+ status: "FAILED",
390
+ namespace,
391
+ watchMs,
392
+ acknowledged: false,
393
+ changeNotificationReceived: false,
394
+ beforeCount: beforeTools.length,
395
+ afterCount: beforeTools.length,
396
+ diff: { added: [], removed: [], changed: [] },
397
+ errorCode: "INITIAL_ENUMERATION_REQUIRED",
398
+ };
399
+ }
400
+ if (initialProbe.protocolEra !== "MODERN_2026") {
401
+ return {
402
+ source: sourceLabel,
403
+ status: "UNSUPPORTED_LEGACY",
404
+ namespace,
405
+ watchMs,
406
+ acknowledged: false,
407
+ changeNotificationReceived: false,
408
+ beforeCount: beforeTools.length,
409
+ afterCount: beforeTools.length,
410
+ diff: { added: [], removed: [], changed: [] },
411
+ errorCode: "LEGACY_CHANGE_STREAM_NOT_SUPPORTED_IN_11B_V1",
412
+ };
413
+ }
414
+ const target = await resolveTarget(root, source);
415
+ if (!target) {
416
+ return {
417
+ source: sourceLabel,
418
+ status: "FAILED",
419
+ namespace,
420
+ watchMs,
421
+ acknowledged: false,
422
+ changeNotificationReceived: false,
423
+ beforeCount: beforeTools.length,
424
+ afterCount: beforeTools.length,
425
+ diff: { added: [], removed: [], changed: [] },
426
+ errorCode: "REMOTE_ENDPOINT_NOT_RESOLVED",
427
+ };
428
+ }
429
+ try {
430
+ const listen = await waitForModernToolChange(target, watchMs, maxStreamBytes);
431
+ if (!listen.acknowledged) {
432
+ return {
433
+ source: sourceLabel,
434
+ status: "SUBSCRIPTION_NOT_ACKNOWLEDGED",
435
+ namespace,
436
+ watchMs,
437
+ acknowledged: false,
438
+ changeNotificationReceived: false,
439
+ beforeCount: beforeTools.length,
440
+ afterCount: beforeTools.length,
441
+ diff: { added: [], removed: [], changed: [] },
442
+ };
443
+ }
444
+ if (!listen.changed) {
445
+ return {
446
+ source: sourceLabel,
447
+ status: "NO_CHANGE",
448
+ namespace,
449
+ watchMs,
450
+ acknowledged: true,
451
+ changeNotificationReceived: false,
452
+ beforeCount: beforeTools.length,
453
+ afterCount: beforeTools.length,
454
+ diff: { added: [], removed: [], changed: [] },
455
+ };
456
+ }
457
+ const refreshed = await discoverLiveMcpTools(root, configuredSources, [selector]);
458
+ const afterTools = refreshed.tools.filter(tool => tool.source.sourceId === source.sourceId);
459
+ return {
460
+ source: sourceLabel,
461
+ status: "CHANGED",
462
+ namespace,
463
+ watchMs,
464
+ acknowledged: true,
465
+ changeNotificationReceived: true,
466
+ beforeCount: beforeTools.length,
467
+ afterCount: afterTools.length,
468
+ diff: diffMcpToolSnapshots(beforeTools, afterTools),
469
+ refreshed,
470
+ };
471
+ }
472
+ catch (error) {
473
+ return {
474
+ source: sourceLabel,
475
+ status: "FAILED",
476
+ namespace,
477
+ watchMs,
478
+ acknowledged: false,
479
+ changeNotificationReceived: false,
480
+ beforeCount: beforeTools.length,
481
+ afterCount: beforeTools.length,
482
+ diff: { added: [], removed: [], changed: [] },
483
+ errorCode: error instanceof McpToolRefreshError
484
+ ? error.code
485
+ : "UNKNOWN_ERROR",
486
+ };
487
+ }
488
+ }
489
+ //# sourceMappingURL=mcp-tool-refresh.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-tool-refresh.js","sourceRoot":"","sources":["../src/mcp-tool-refresh.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ import { type ToolExecutionObservation } from "./execution-observation.js";
2
+ import { type OpenAIAgentRuntimeSnapshot } from "./runtime-tool-discovery.js";
3
+ export type OpenAIAgentsExecutionObserver = Readonly<{
4
+ snapshot: OpenAIAgentRuntimeSnapshot;
5
+ onToolStart: (...args: unknown[]) => void;
6
+ onToolEnd: (...args: unknown[]) => void;
7
+ events: () => readonly ToolExecutionObservation[];
8
+ drain: () => readonly ToolExecutionObservation[];
9
+ pendingCount: () => number;
10
+ }>;
11
+ /**
12
+ * Build dependency-free OpenAI Agents lifecycle handlers for execution evidence.
13
+ *
14
+ * The returned callbacks are meant to be registered with either an Agent or a
15
+ * Runner `agent_tool_start` / `agent_tool_end` hook. This helper never registers
16
+ * itself, never invokes a tool, and never reads tool arguments/results/context.
17
+ *
18
+ * `agent_tool_end` is proof that the tool lifecycle reached the end hook, so it
19
+ * can establish EXECUTED evidence. The v1 adapter records outcome as UNKNOWN:
20
+ * framework end hooks alone are not treated as authoritative proof that an
21
+ * external side effect succeeded.
22
+ */
23
+ export declare function createOpenAIAgentsExecutionObserver(agent: unknown): OpenAIAgentsExecutionObserver;
24
+ //# sourceMappingURL=openai-agents-execution-observer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openai-agents-execution-observer.d.ts","sourceRoot":"","sources":["../src/openai-agents-execution-observer.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,0BAA0B,EAEhC,MAAM,6BAA6B,CAAC;AAUrC,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC;IACnD,QAAQ,EAAE,0BAA0B,CAAC;IACrC,WAAW,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAC1C,SAAS,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACxC,MAAM,EAAE,MAAM,SAAS,wBAAwB,EAAE,CAAC;IAClD,KAAK,EAAE,MAAM,SAAS,wBAAwB,EAAE,CAAC;IACjD,YAAY,EAAE,MAAM,MAAM,CAAC;CAC5B,CAAC,CAAC;AAyEH;;;;;;;;;;;GAWG;AACH,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,OAAO,GACb,6BAA6B,CAgG/B"}