@botpress/evals 1.19.0-beta.9 → 2.0.0-alpha.1

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 (85) hide show
  1. package/dist/client.d.ts +21 -9
  2. package/dist/client.d.ts.map +1 -1
  3. package/dist/client.js +103 -36
  4. package/dist/client.js.map +4 -4
  5. package/dist/definition.d.ts +9 -2
  6. package/dist/definition.d.ts.map +1 -1
  7. package/dist/definition.js.map +2 -2
  8. package/dist/graders/index.js +21 -74
  9. package/dist/graders/index.js.map +2 -2
  10. package/dist/graders/llm.d.ts +12 -12
  11. package/dist/graders/llm.d.ts.map +1 -1
  12. package/dist/graders/llm.js +30 -75
  13. package/dist/graders/llm.js.map +2 -2
  14. package/dist/graders/response.js +16 -65
  15. package/dist/graders/response.js.map +2 -2
  16. package/dist/index.d.ts +3 -1
  17. package/dist/index.d.ts.map +1 -1
  18. package/dist/index.js +10 -0
  19. package/dist/index.js.map +3 -3
  20. package/dist/loader.js.map +2 -2
  21. package/dist/manifest.d.ts +13 -0
  22. package/dist/manifest.d.ts.map +1 -0
  23. package/dist/runner.d.ts +5 -1
  24. package/dist/runner.d.ts.map +1 -1
  25. package/dist/runner.js +316 -183
  26. package/dist/runner.js.map +4 -4
  27. package/dist/spans/index.d.ts +5 -0
  28. package/dist/spans/index.d.ts.map +1 -0
  29. package/dist/spans/index.js +725 -0
  30. package/dist/spans/index.js.map +7 -0
  31. package/dist/spans/local-span-source.d.ts +19 -0
  32. package/dist/spans/local-span-source.d.ts.map +1 -0
  33. package/dist/spans/local-span-source.js +543 -0
  34. package/dist/spans/local-span-source.js.map +7 -0
  35. package/dist/spans/span-source.d.ts +40 -0
  36. package/dist/spans/span-source.d.ts.map +1 -0
  37. package/dist/spans/span-source.js +1 -0
  38. package/dist/{sse-collector.d.ts → spans/sse-collector.d.ts} +44 -5
  39. package/dist/spans/sse-collector.d.ts.map +1 -0
  40. package/dist/{sse-collector.js → spans/sse-collector.js} +97 -20
  41. package/dist/spans/sse-collector.js.map +7 -0
  42. package/dist/spans/trace.d.ts.map +1 -0
  43. package/dist/spans/trace.js.map +7 -0
  44. package/dist/spans/vortex-span-source.d.ts +42 -0
  45. package/dist/spans/vortex-span-source.d.ts.map +1 -0
  46. package/dist/spans/vortex-span-source.js +184 -0
  47. package/dist/spans/vortex-span-source.js.map +7 -0
  48. package/dist/stores/eval-definition-loader.d.ts +4 -0
  49. package/dist/stores/eval-definition-loader.d.ts.map +1 -0
  50. package/dist/stores/eval-definition-loader.js +142 -0
  51. package/dist/stores/eval-definition-loader.js.map +7 -0
  52. package/dist/stores/eval-store.d.ts +61 -0
  53. package/dist/stores/eval-store.d.ts.map +1 -0
  54. package/dist/stores/eval-store.js +1 -0
  55. package/dist/stores/eval-store.js.map +7 -0
  56. package/dist/stores/index.d.ts +8 -0
  57. package/dist/stores/index.d.ts.map +1 -0
  58. package/dist/stores/index.js +1156 -0
  59. package/dist/stores/index.js.map +7 -0
  60. package/dist/stores/local-eval-store.d.ts +66 -0
  61. package/dist/stores/local-eval-store.d.ts.map +1 -0
  62. package/dist/stores/local-eval-store.js +595 -0
  63. package/dist/stores/local-eval-store.js.map +7 -0
  64. package/dist/stores/vortex-eval-store-entry.d.ts +6 -0
  65. package/dist/stores/vortex-eval-store-entry.d.ts.map +1 -0
  66. package/dist/stores/vortex-eval-store-entry.js +702 -0
  67. package/dist/stores/vortex-eval-store-entry.js.map +7 -0
  68. package/dist/stores/vortex-eval-store.d.ts +78 -0
  69. package/dist/stores/vortex-eval-store.d.ts.map +1 -0
  70. package/dist/stores/vortex-eval-store.js +562 -0
  71. package/dist/stores/vortex-eval-store.js.map +7 -0
  72. package/dist/transformer.d.ts +2 -2
  73. package/dist/transformer.d.ts.map +1 -1
  74. package/dist/transformer.js +1 -1
  75. package/dist/transformer.js.map +2 -2
  76. package/dist/types.d.ts +38 -33
  77. package/dist/types.d.ts.map +1 -1
  78. package/dist/types.js.map +2 -2
  79. package/package.json +66 -6
  80. package/dist/sse-collector.d.ts.map +0 -1
  81. package/dist/sse-collector.js.map +0 -7
  82. package/dist/trace.d.ts.map +0 -1
  83. /package/dist/{trace.js.map → spans/span-source.js.map} +0 -0
  84. /package/dist/{trace.d.ts → spans/trace.d.ts} +0 -0
  85. /package/dist/{trace.js → spans/trace.js} +0 -0
@@ -0,0 +1,543 @@
1
+ // ../analytics/src/errors.ts
2
+ var AdkError = class extends Error {
3
+ /**
4
+ * Marker for cross-module-instance checks — `instanceof` breaks when a
5
+ * package is duplicated in the dependency graph.
6
+ * @internal
7
+ */
8
+ static __IS_ADK_BASE_ERROR = true;
9
+ /**
10
+ * Stable SCREAMING_SNAKE_CASE identifier, e.g. 'BOT_NOT_FOUND'. Subclasses
11
+ * pin `Code` to a literal union (`class EvalRunnerError extends
12
+ * AdkError<EvalErrorCode>`) so typos are compile errors and `code` narrows
13
+ * in switches.
14
+ */
15
+ code;
16
+ /**
17
+ * True for user/environment conditions the developer can fix themselves
18
+ * (validation, auth, connectivity). False for internal bugs. Defaults to
19
+ * false so unclassified errors surface as bugs until someone triages them.
20
+ */
21
+ expected;
22
+ /** Structured context. Sanitized before any telemetry leaves the machine. */
23
+ details;
24
+ /** Actionable next step shown to the user, e.g. "Run 'adk login' first." */
25
+ suggestion;
26
+ constructor(opts) {
27
+ super(opts.message, opts.cause !== void 0 ? { cause: opts.cause } : void 0);
28
+ this.name = this.constructor.name;
29
+ this.code = opts.code;
30
+ this.expected = opts.expected ?? false;
31
+ if (opts.details !== void 0) {
32
+ this.details = opts.details;
33
+ }
34
+ if (opts.suggestion !== void 0) {
35
+ this.suggestion = opts.suggestion;
36
+ }
37
+ }
38
+ };
39
+
40
+ // src/errors.ts
41
+ var EvalRunnerError = class extends AdkError {
42
+ };
43
+
44
+ // src/spans/sse-collector.ts
45
+ function spanKey(span) {
46
+ return `${span.id.trace}:${span.id.span}`;
47
+ }
48
+ function spanData(span) {
49
+ return span.data && typeof span.data === "object" ? span.data : {};
50
+ }
51
+ var TURN_HANDLER_SPAN_NAMES = /* @__PURE__ */ new Set(["handler.conversation", "handler.event"]);
52
+ function isTurnHandlerSpan(span) {
53
+ return TURN_HANDLER_SPAN_NAMES.has(span.name);
54
+ }
55
+ var SSECollector = class _SSECollector {
56
+ devServerUrl;
57
+ headers;
58
+ /** All spans accumulated since connect(), keyed by spanKey for dedup. */
59
+ spanMap = /* @__PURE__ */ new Map();
60
+ /** Index into spanMap insertion order marking where the current turn started. */
61
+ turnStartKeys = /* @__PURE__ */ new Set();
62
+ /** Handler span IDs seen before the current turn (for startTurn filtering). */
63
+ seenHandlerKeys = /* @__PURE__ */ new Set();
64
+ /** Callbacks waiting for span updates. */
65
+ waiters = [];
66
+ /** AbortController for the active SSE connection. */
67
+ abortController = null;
68
+ /** Whether the background loop is running. */
69
+ connected = false;
70
+ /** Error from the SSE stream if it died unexpectedly. */
71
+ streamError = null;
72
+ /** Passive counters used only to explain timeout failures. */
73
+ updateEventCount = 0;
74
+ keepaliveEventCount = 0;
75
+ lastEvent = null;
76
+ /** Set while a settle phase is in flight; called by disconnect() to short-circuit. */
77
+ _cancelSettle = null;
78
+ constructor(devServerUrl, headers = {}) {
79
+ this.devServerUrl = devServerUrl;
80
+ this.headers = headers;
81
+ }
82
+ /**
83
+ * Open a streaming SSE connection filtered by conversationId or workflowId.
84
+ * Starts a background loop that parses SSE events and accumulates spans.
85
+ */
86
+ async connect(filter) {
87
+ const attributeName = "conversationId" in filter ? "conversationId" : "workflowId";
88
+ const attributeValue = "conversationId" in filter ? filter.conversationId : filter.workflowId;
89
+ const url = `${this.devServerUrl}/api/traces/stream?attributeName=${encodeURIComponent(attributeName)}&attributeValue=${encodeURIComponent(attributeValue)}`;
90
+ this.abortController = new AbortController();
91
+ const myController = this.abortController;
92
+ const response = await fetch(url, {
93
+ headers: { ...this.headers, Accept: "text/event-stream" },
94
+ signal: myController.signal
95
+ });
96
+ if (!response.ok) {
97
+ throw new EvalRunnerError({
98
+ code: "SSE_CONNECT_FAILED",
99
+ message: `SSE connection failed: ${response.status} ${response.statusText}`,
100
+ expected: true,
101
+ suggestion: "Make sure the dev server is running (`adk dev`) and reachable."
102
+ });
103
+ }
104
+ if (!response.body) {
105
+ throw new EvalRunnerError({ code: "SSE_NO_BODY", message: "SSE response has no body" });
106
+ }
107
+ this.connected = true;
108
+ this._consumeStream(response.body).catch((err) => {
109
+ if (this.connected && this.abortController === myController) {
110
+ this.streamError = err instanceof Error ? err : new Error(String(err));
111
+ }
112
+ });
113
+ await this._waitForSnapshot();
114
+ }
115
+ /**
116
+ * Re-point at a new conversation, keeping `spanMap` and `seenHandlerKeys` (so
117
+ * the earlier conversation stays visible and its completed handler can't
118
+ * satisfy the next turn). Resets the snapshot latch so connect() awaits the
119
+ * new conversation's snapshot.
120
+ */
121
+ async repoint(filter) {
122
+ this.connected = false;
123
+ this.abortController?.abort();
124
+ this.abortController = null;
125
+ this._cancelSettle?.();
126
+ this._cancelSettle = null;
127
+ this.waiters = [];
128
+ this.snapshotReceived = false;
129
+ this.snapshotResolvers = [];
130
+ this.streamError = null;
131
+ await this.connect(filter);
132
+ }
133
+ /**
134
+ * Mark the beginning of a new turn.
135
+ * Records which turn-handler span IDs (handler.conversation / handler.event)
136
+ * have been seen so far, so waitForTurnComplete() only resolves on NEW
137
+ * handler completions.
138
+ */
139
+ startTurn() {
140
+ this.turnStartKeys = new Set(this.spanMap.keys());
141
+ for (const [key, span] of this.spanMap) {
142
+ if (isTurnHandlerSpan(span)) {
143
+ this.seenHandlerKeys.add(key);
144
+ }
145
+ }
146
+ }
147
+ static SETTLE_MS = 100;
148
+ /**
149
+ * Wait for a turn-handler span (handler.conversation or handler.event) to
150
+ * reach terminal status (ok or error).
151
+ * Only considers spans NOT seen before the last startTurn() call.
152
+ *
153
+ * After the handler closes, waits for a quiet period (no new spans for SETTLE_MS)
154
+ * to ensure all child spans (tool calls, messages, state saves) have arrived.
155
+ * The runtime's HttpSpanExporter fires POSTs without awaiting them, so child
156
+ * spans may arrive slightly after the handler close event.
157
+ */
158
+ async waitForTurnComplete(opts) {
159
+ const accept = opts.acceptSpanNames;
160
+ const settle = { quietMs: opts.settleQuietMs, maxMs: opts.settleMaxMs };
161
+ if (this._hasNewCompletedHandler(accept)) {
162
+ return this._settleAfterHandler(settle);
163
+ }
164
+ if (opts.abortSignal?.aborted) {
165
+ throw new Error("waitForTurnComplete aborted");
166
+ }
167
+ return new Promise((resolve, reject) => {
168
+ const timer = setTimeout(() => {
169
+ this._removeWaiter(waiter);
170
+ opts.abortSignal?.removeEventListener("abort", onAbort);
171
+ const expected = accept ? [...accept].join(" or ") : "handler.conversation or handler.event";
172
+ const reason = this.streamError ? `SSE stream died: ${this.streamError.message}` : `no ${expected} span completed`;
173
+ reject(
174
+ new Error(
175
+ `waitForTurnComplete timed out after ${opts.timeout}ms \u2014 ${reason}; diagnostics: ${this._formatTurnDiagnostics()}`
176
+ )
177
+ );
178
+ }, opts.timeout);
179
+ const onAbort = () => {
180
+ clearTimeout(timer);
181
+ this._removeWaiter(waiter);
182
+ reject(new Error("waitForTurnComplete aborted"));
183
+ };
184
+ opts.abortSignal?.addEventListener("abort", onAbort, { once: true });
185
+ const waiter = (_span) => {
186
+ if (this._hasNewCompletedHandler(accept)) {
187
+ clearTimeout(timer);
188
+ this._removeWaiter(waiter);
189
+ opts.abortSignal?.removeEventListener("abort", onAbort);
190
+ this._settleAfterHandler(settle).then(resolve, reject);
191
+ }
192
+ };
193
+ this.waiters.push(waiter);
194
+ });
195
+ }
196
+ static MAX_SETTLE_MS = 2e3;
197
+ /**
198
+ * After the handler span closes, wait for spans to stop arriving.
199
+ * Resolves when no new spans arrive for SETTLE_MS, or after MAX_SETTLE_MS hard cap.
200
+ *
201
+ * Exposes a cancellation hook via _cancelSettle so disconnect() can short-
202
+ * circuit an in-flight settle phase and avoid leaking timers for up to 2s.
203
+ */
204
+ _settleAfterHandler(settle) {
205
+ const quietMs = settle?.quietMs ?? _SSECollector.SETTLE_MS;
206
+ const maxMs = settle?.maxMs ?? _SSECollector.MAX_SETTLE_MS;
207
+ return new Promise((resolve) => {
208
+ let resolved = false;
209
+ const done = () => {
210
+ if (resolved) return;
211
+ resolved = true;
212
+ clearTimeout(hardCap);
213
+ clearTimeout(settleTimer);
214
+ this._removeWaiter(settleWaiter);
215
+ this._cancelSettle = null;
216
+ resolve();
217
+ };
218
+ const hardCap = setTimeout(done, maxMs);
219
+ let settleTimer = setTimeout(done, quietMs);
220
+ const settleWaiter = () => {
221
+ if (resolved) return;
222
+ clearTimeout(settleTimer);
223
+ settleTimer = setTimeout(done, quietMs);
224
+ };
225
+ this.waiters.push(settleWaiter);
226
+ this._cancelSettle = done;
227
+ });
228
+ }
229
+ /**
230
+ * Wait for a handler.workflow span with matching workflow name.
231
+ * - signal 'entered': resolves when the span appears (any status)
232
+ * - signal 'completed': resolves when the span has status !== 'running'
233
+ */
234
+ async waitForWorkflow(name, opts) {
235
+ if (this._matchesWorkflowCondition(name, opts.signal)) {
236
+ return;
237
+ }
238
+ if (opts.abortSignal?.aborted) {
239
+ throw new Error(`waitForWorkflow("${name}", { signal: "${opts.signal}" }) aborted`);
240
+ }
241
+ return new Promise((resolve, reject) => {
242
+ const timer = setTimeout(() => {
243
+ this._removeWaiter(waiter);
244
+ opts.abortSignal?.removeEventListener("abort", onAbort);
245
+ const reason = this.streamError ? `SSE stream died: ${this.streamError.message}` : "span not found";
246
+ reject(
247
+ new Error(
248
+ `waitForWorkflow("${name}", { signal: "${opts.signal}" }) timed out after ${opts.timeout}ms \u2014 ${reason}`
249
+ )
250
+ );
251
+ }, opts.timeout);
252
+ const onAbort = () => {
253
+ clearTimeout(timer);
254
+ this._removeWaiter(waiter);
255
+ reject(new Error(`waitForWorkflow("${name}", { signal: "${opts.signal}" }) aborted`));
256
+ };
257
+ opts.abortSignal?.addEventListener("abort", onAbort, { once: true });
258
+ const waiter = (_span) => {
259
+ if (this._matchesWorkflowCondition(name, opts.signal)) {
260
+ clearTimeout(timer);
261
+ this._removeWaiter(waiter);
262
+ opts.abortSignal?.removeEventListener("abort", onAbort);
263
+ resolve();
264
+ }
265
+ };
266
+ this.waiters.push(waiter);
267
+ });
268
+ }
269
+ /**
270
+ * Return spans accumulated since the last startTurn() call.
271
+ */
272
+ getTurnSpans() {
273
+ const result = [];
274
+ for (const [key, span] of this.spanMap) {
275
+ if (!this.turnStartKeys.has(key)) {
276
+ result.push(span);
277
+ }
278
+ }
279
+ return result;
280
+ }
281
+ /**
282
+ * Return all spans accumulated since connect().
283
+ */
284
+ getAllSpans() {
285
+ return Array.from(this.spanMap.values());
286
+ }
287
+ /**
288
+ * Close the SSE connection and clean up.
289
+ */
290
+ disconnect() {
291
+ this.connected = false;
292
+ this.abortController?.abort();
293
+ this.abortController = null;
294
+ this._cancelSettle?.();
295
+ this._cancelSettle = null;
296
+ this.waiters = [];
297
+ this.snapshotResolvers = [];
298
+ }
299
+ // ── Private ──────────────────────────────────────────────────
300
+ /** Whether we have received the initial snapshot. */
301
+ snapshotReceived = false;
302
+ snapshotResolvers = [];
303
+ static SNAPSHOT_TIMEOUT_MS = 1e4;
304
+ /**
305
+ * Returns a promise that resolves once the snapshot event has been processed,
306
+ * or rejects after a timeout to prevent connect() from hanging indefinitely.
307
+ */
308
+ _waitForSnapshot() {
309
+ if (this.snapshotReceived) {
310
+ return Promise.resolve();
311
+ }
312
+ return new Promise((resolve, reject) => {
313
+ let settled = false;
314
+ const resolver = () => {
315
+ if (settled) return;
316
+ settled = true;
317
+ clearTimeout(timer);
318
+ resolve();
319
+ };
320
+ const timer = setTimeout(() => {
321
+ if (settled) return;
322
+ settled = true;
323
+ const idx = this.snapshotResolvers.indexOf(resolver);
324
+ if (idx !== -1) this.snapshotResolvers.splice(idx, 1);
325
+ reject(
326
+ new Error(
327
+ `SSE snapshot not received within ${_SSECollector.SNAPSHOT_TIMEOUT_MS}ms \u2014 is the dev server healthy?`
328
+ )
329
+ );
330
+ }, _SSECollector.SNAPSHOT_TIMEOUT_MS);
331
+ this.snapshotResolvers.push(resolver);
332
+ });
333
+ }
334
+ /**
335
+ * Consume the ReadableStream body, parse SSE lines, and dispatch events.
336
+ */
337
+ async _consumeStream(body) {
338
+ const decoder = new TextDecoder();
339
+ let buffer = "";
340
+ const reader = body.getReader();
341
+ try {
342
+ while (this.connected) {
343
+ const { done, value } = await reader.read();
344
+ if (done) break;
345
+ buffer += decoder.decode(value, { stream: true });
346
+ const parts = buffer.split("\n\n");
347
+ buffer = parts.pop() ?? "";
348
+ for (const part of parts) {
349
+ this._parseSSEBlock(part);
350
+ }
351
+ }
352
+ } finally {
353
+ reader.releaseLock();
354
+ }
355
+ }
356
+ /**
357
+ * Parse a single SSE event block (text between \n\n boundaries).
358
+ * Extracts event name and data payload.
359
+ */
360
+ _parseSSEBlock(block) {
361
+ const lines = block.split("\n");
362
+ let eventName = "";
363
+ let dataLine = "";
364
+ for (const line of lines) {
365
+ if (line.startsWith("event:")) {
366
+ eventName = line.slice("event:".length).trim();
367
+ } else if (line.startsWith("data:")) {
368
+ const value = line.slice("data:".length).trim();
369
+ dataLine = dataLine ? `${dataLine}
370
+ ${value}` : value;
371
+ }
372
+ }
373
+ if (!eventName || !dataLine) {
374
+ if (!this.snapshotReceived && block.includes("retry:")) {
375
+ }
376
+ return;
377
+ }
378
+ try {
379
+ const payload = JSON.parse(dataLine);
380
+ this._handleEvent(eventName, payload);
381
+ } catch {
382
+ }
383
+ }
384
+ /**
385
+ * Dispatch a parsed SSE event to the appropriate handler.
386
+ */
387
+ _handleEvent(eventName, payload) {
388
+ this._recordEvent(eventName);
389
+ if (eventName === "snapshot") {
390
+ const data = payload;
391
+ const spans = Array.isArray(data.spans) ? data.spans : [];
392
+ for (const span of spans) {
393
+ this._upsertSpan(span);
394
+ }
395
+ this.snapshotReceived = true;
396
+ for (const resolve of this.snapshotResolvers) {
397
+ resolve();
398
+ }
399
+ this.snapshotResolvers = [];
400
+ } else if (eventName === "update") {
401
+ const data = payload;
402
+ if (data.span) {
403
+ this._upsertSpan(data.span);
404
+ this._notifyWaiters(data.span);
405
+ }
406
+ }
407
+ }
408
+ _recordEvent(eventName) {
409
+ this.lastEvent = { name: eventName, at: Date.now() };
410
+ if (eventName === "update") {
411
+ this.updateEventCount++;
412
+ } else if (eventName === "keepalive") {
413
+ this.keepaliveEventCount++;
414
+ }
415
+ }
416
+ _formatTurnDiagnostics() {
417
+ const turnSpans = this.getTurnSpans();
418
+ const spanNames = /* @__PURE__ */ new Set();
419
+ const handlerStatuses = /* @__PURE__ */ new Set();
420
+ for (const span of turnSpans) {
421
+ spanNames.add(span.name);
422
+ if (isTurnHandlerSpan(span)) {
423
+ handlerStatuses.add(span.status);
424
+ }
425
+ }
426
+ const lastEvent = this.lastEvent ? `${this.lastEvent.name} ${Date.now() - this.lastEvent.at}ms ago` : "none";
427
+ return [
428
+ `snapshotReceived=${this.snapshotReceived}`,
429
+ `totalUpdates=${this.updateEventCount}`,
430
+ `totalKeepalives=${this.keepaliveEventCount}`,
431
+ `lastEvent=${lastEvent}`,
432
+ `totalSpans=${this.spanMap.size}`,
433
+ `turnSpans=${turnSpans.length}`,
434
+ `turnSpanNames=${this._formatSet(spanNames)}`,
435
+ `turnHandlerStatuses=${this._formatSet(handlerStatuses)}`
436
+ ].join(", ");
437
+ }
438
+ _formatSet(values, limit = 12) {
439
+ if (values.size === 0) {
440
+ return "none";
441
+ }
442
+ const items = Array.from(values);
443
+ const suffix = items.length > limit ? `|+${items.length - limit} more` : "";
444
+ return `${items.slice(0, limit).join("|")}${suffix}`;
445
+ }
446
+ /**
447
+ * Insert or replace a span in the map (dedup by trace+span ID).
448
+ */
449
+ _upsertSpan(span) {
450
+ this.spanMap.set(spanKey(span), span);
451
+ }
452
+ /**
453
+ * Notify all waiters that a new span was received.
454
+ */
455
+ _notifyWaiters(span) {
456
+ const current = [...this.waiters];
457
+ for (const waiter of current) {
458
+ waiter(span);
459
+ }
460
+ }
461
+ /**
462
+ * Remove a waiter callback from the list.
463
+ */
464
+ _removeWaiter(fn) {
465
+ const idx = this.waiters.indexOf(fn);
466
+ if (idx !== -1) {
467
+ this.waiters.splice(idx, 1);
468
+ }
469
+ }
470
+ /**
471
+ * Check if there is a turn-handler span (handler.conversation / handler.event) that:
472
+ * 1. Was NOT seen before startTurn()
473
+ * 2. Has terminal status (ok or error)
474
+ *
475
+ * Marks the matched key as consumed so the same handler span cannot
476
+ * satisfy both the current turn's settle phase AND the next turn's
477
+ * waitForTurnComplete check (which would otherwise resolve instantly
478
+ * against stale data instead of waiting for the new turn's handler).
479
+ */
480
+ _hasNewCompletedHandler(acceptSpanNames) {
481
+ for (const [key, span] of this.spanMap) {
482
+ if (isTurnHandlerSpan(span) && (!acceptSpanNames || acceptSpanNames.has(span.name)) && !this.seenHandlerKeys.has(key) && (span.status === "ok" || span.status === "error")) {
483
+ this.seenHandlerKeys.add(key);
484
+ return true;
485
+ }
486
+ }
487
+ return false;
488
+ }
489
+ /**
490
+ * Check if a handler.workflow span matches the given condition.
491
+ */
492
+ _matchesWorkflowCondition(name, signal) {
493
+ for (const span of this.spanMap.values()) {
494
+ if (span.name !== "handler.workflow") continue;
495
+ const d = spanData(span);
496
+ const wfName = d["workflow.name"] || d["workflowName"];
497
+ if (wfName !== name) continue;
498
+ if (signal === "entered") {
499
+ return true;
500
+ }
501
+ if (signal === "completed") {
502
+ return span.status === "ok" || span.status === "error";
503
+ }
504
+ }
505
+ return false;
506
+ }
507
+ };
508
+
509
+ // src/spans/local-span-source.ts
510
+ var LocalSpanSource = class {
511
+ collector;
512
+ constructor(devServerUrl, headers = {}) {
513
+ this.collector = new SSECollector(devServerUrl, headers);
514
+ }
515
+ async connect(filter) {
516
+ await this.collector.connect(filter);
517
+ }
518
+ async repoint(filter) {
519
+ await this.collector.repoint(filter);
520
+ }
521
+ startTurn() {
522
+ this.collector.startTurn();
523
+ }
524
+ async waitForTurnComplete(opts) {
525
+ await this.collector.waitForTurnComplete(opts);
526
+ }
527
+ async waitForWorkflow(name, opts) {
528
+ await this.collector.waitForWorkflow(name, opts);
529
+ }
530
+ getTurnSpans() {
531
+ return this.collector.getTurnSpans();
532
+ }
533
+ getAllSpans() {
534
+ return this.collector.getAllSpans();
535
+ }
536
+ disconnect() {
537
+ this.collector.disconnect();
538
+ }
539
+ };
540
+ export {
541
+ LocalSpanSource
542
+ };
543
+ //# sourceMappingURL=local-span-source.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../analytics/src/errors.ts", "../../src/errors.ts", "../../src/spans/sse-collector.ts", "../../src/spans/local-span-source.ts"],
4
+ "sourcesContent": ["/**\n * Shared base error for ADK packages. Lives in `@botpress/analytics` because\n * it's the dependency-light package every surface already shares (cli, adk,\n * ui) \u2014 so all typed errors can genuinely inherit one base instead of\n * mirroring its shape.\n *\n * The policy lives in docs/ERROR-HANDLING.md. The short version: every error\n * we *intend* to throw should carry a stable `code` (so PostHog error\n * tracking can slice issues by code) and an `expected` flag separating\n * user/environment conditions (bad input, not logged in, network down \u2014 render\n * a friendly message, low alert priority) from internal bugs (invariant\n * violations \u2014 full stack, page someone).\n *\n * The runtime package is out of scope and keeps its own `Errors.AbstractError`\n * hierarchy. The adk typed families (`DependencyError`, `Agent0*Error`) extend\n * this base; new code should start here.\n */\nexport class AdkError<Code extends string = string> extends Error {\n /**\n * Marker for cross-module-instance checks \u2014 `instanceof` breaks when a\n * package is duplicated in the dependency graph.\n * @internal\n */\n public static readonly __IS_ADK_BASE_ERROR = true\n\n /**\n * Stable SCREAMING_SNAKE_CASE identifier, e.g. 'BOT_NOT_FOUND'. Subclasses\n * pin `Code` to a literal union (`class EvalRunnerError extends\n * AdkError<EvalErrorCode>`) so typos are compile errors and `code` narrows\n * in switches.\n */\n readonly code: Code\n /**\n * True for user/environment conditions the developer can fix themselves\n * (validation, auth, connectivity). False for internal bugs. Defaults to\n * false so unclassified errors surface as bugs until someone triages them.\n */\n readonly expected: boolean\n /** Structured context. Sanitized before any telemetry leaves the machine. */\n readonly details?: Record<string, unknown>\n /** Actionable next step shown to the user, e.g. \"Run 'adk login' first.\" */\n readonly suggestion?: string\n\n constructor(opts: {\n code: Code\n message: string\n expected?: boolean\n details?: Record<string, unknown>\n suggestion?: string\n cause?: unknown\n }) {\n super(opts.message, opts.cause !== undefined ? { cause: opts.cause } : undefined)\n this.name = this.constructor.name\n this.code = opts.code\n this.expected = opts.expected ?? false\n // Conditional assignment keeps the optional fields absent-not-undefined,\n // which downstream tsconfigs with exactOptionalPropertyTypes require.\n if (opts.details !== undefined) {\n this.details = opts.details\n }\n if (opts.suggestion !== undefined) {\n this.suggestion = opts.suggestion\n }\n }\n}\n\n/**\n * Duck-typed guard that survives duplicated module instances in the\n * dependency graph, where `instanceof AdkError` returns false for an error\n * constructed from another copy of this module. No manual prototype walking\n * needed: static properties are inherited through the constructor chain, so\n * a subclass's constructor resolves the marker in one lookup.\n */\nexport function isAdkError(error: unknown): error is AdkError {\n if (error instanceof AdkError) return true\n if (!(error instanceof Error)) return false\n return (error.constructor as unknown as Record<string, unknown> | undefined)?.__IS_ADK_BASE_ERROR === true\n}\n", "import { AdkError } from '@botpress/analytics'\n\n/**\n * Stable error codes for the eval engine. Typed as a literal union so a typo'd\n * code is a compile error and PostHog issue-slicing stays consistent.\n * Conventions per docs/ERROR-HANDLING.md.\n */\nexport const EVAL_ERROR_CODES = [\n 'EVAL_LOAD_FAILED',\n 'EVAL_FILE_EMPTY',\n 'EVAL_DUPLICATE_NAME',\n 'EVAL_SEED_NO_CONVERSATION',\n 'EVAL_NO_CONVERSATION_ID',\n 'EVAL_TURN_CONFIG_INVALID',\n 'SSE_CONNECT_FAILED',\n 'SSE_NO_BODY',\n 'CHAT_CLIENT_MISSING',\n 'CHAT_NOT_CONNECTED',\n 'CHAT_INTEGRATION_MISSING',\n 'CHAT_CHANNEL_UNBOUND',\n] as const\n\nexport type EvalErrorCode = (typeof EVAL_ERROR_CODES)[number]\n\n/**\n * Typed error for the eval engine. Named EvalRunnerError (not EvalError) to\n * avoid shadowing the JS built-in `EvalError`.\n */\nexport class EvalRunnerError extends AdkError<EvalErrorCode> {}\n", "/**\n * SSECollector \u2014 connects to the ADK dev server's SSE trace stream,\n * accumulates spans, and provides promise-based wait methods for\n * turn completion and workflow signals.\n *\n * Uses fetch() + async iteration with manual SSE line parsing\n * (Bun does not have native EventSource).\n */\n\nimport type { Span } from './trace'\nimport { EvalRunnerError } from '../errors'\n\ntype SSEFilter = { conversationId: string } | { workflowId: string }\n\ninterface WaitOptions {\n timeout: number\n /**\n * Optional abort signal \u2014 when fired, the wait rejects immediately rather\n * than burning the full timeout. Used by the runner so Stop unblocks\n * pending workflow assertions (otherwise a single negative-result wait\n * can hold the suite hostage for `idleTimeout` per assertion).\n */\n abortSignal?: AbortSignal\n}\n\ninterface WorkflowWaitOptions extends WaitOptions {\n signal: 'entered' | 'completed'\n}\n\ninterface TurnWaitOptions extends WaitOptions {\n /**\n * Which handler span names may complete this turn. A user-message turn\n * completes via `handler.conversation` only \u2014 async noise such as a\n * workflow callback closes a silent `handler.event` span, and counting it\n * releases the runner early, whose next message then interrupts the\n * still-running handler. An event-driven turn completes via\n * `handler.event`. Omitted = any turn-handler span (legacy behavior).\n */\n acceptSpanNames?: ReadonlySet<string>\n /**\n * Quiet window after the handler closes before the turn is considered\n * settled (default 100 ms). The runner raises it so async follow-through\n * the handler scheduled \u2014 a tool-started workflow run and its callback,\n * which only execute AFTER the handler closes \u2014 finishes before the next\n * message is sent. A message sent into that window can be absorbed by the\n * follow-through's transcript save and silently skipped as already\n * processed.\n */\n settleQuietMs?: number\n /** Hard cap on the settle phase (default 2 s; the runner raises it with settleQuietMs). */\n settleMaxMs?: number\n}\n\n/**\n * Unique key for span deduplication.\n */\nfunction spanKey(span: Span): string {\n return `${span.id.trace}:${span.id.span}`\n}\n\n/**\n * Type-safe accessor for span.data fields.\n */\nfunction spanData(span: Span): Record<string, unknown> {\n return span.data && typeof span.data === 'object' ? (span.data as Record<string, unknown>) : {}\n}\n\n/**\n * Span names that mark a Conversation handler reaching the end of a turn.\n *\n * A turn driven by a user message emits `handler.conversation`; a turn driven\n * by an event (a Conversation's `events:` subscription \u2014 e.g. greeting on a\n * conversation-start signal) emits `handler.event`. Both close exactly once\n * per handler invocation, so either is a valid \"turn complete\" signal.\n */\nconst TURN_HANDLER_SPAN_NAMES = new Set(['handler.conversation', 'handler.event'])\n\nfunction isTurnHandlerSpan(span: Span): boolean {\n return TURN_HANDLER_SPAN_NAMES.has(span.name)\n}\n\nexport class SSECollector {\n private devServerUrl: string\n private headers: Record<string, string>\n\n /** All spans accumulated since connect(), keyed by spanKey for dedup. */\n private spanMap = new Map<string, Span>()\n\n /** Index into spanMap insertion order marking where the current turn started. */\n private turnStartKeys = new Set<string>()\n\n /** Handler span IDs seen before the current turn (for startTurn filtering). */\n private seenHandlerKeys = new Set<string>()\n\n /** Callbacks waiting for span updates. */\n private waiters: Array<(span: Span) => void> = []\n\n /** AbortController for the active SSE connection. */\n private abortController: AbortController | null = null\n\n /** Whether the background loop is running. */\n private connected = false\n\n /** Error from the SSE stream if it died unexpectedly. */\n private streamError: Error | null = null\n\n /** Passive counters used only to explain timeout failures. */\n private updateEventCount = 0\n private keepaliveEventCount = 0\n private lastEvent: { name: string; at: number } | null = null\n\n /** Set while a settle phase is in flight; called by disconnect() to short-circuit. */\n private _cancelSettle: (() => void) | null = null\n\n constructor(devServerUrl: string, headers: Record<string, string> = {}) {\n this.devServerUrl = devServerUrl\n this.headers = headers\n }\n\n /**\n * Open a streaming SSE connection filtered by conversationId or workflowId.\n * Starts a background loop that parses SSE events and accumulates spans.\n */\n async connect(filter: SSEFilter): Promise<void> {\n const attributeName = 'conversationId' in filter ? 'conversationId' : 'workflowId'\n const attributeValue = 'conversationId' in filter ? filter.conversationId : filter.workflowId\n\n const url = `${this.devServerUrl}/api/traces/stream?attributeName=${encodeURIComponent(attributeName)}&attributeValue=${encodeURIComponent(attributeValue)}`\n\n this.abortController = new AbortController()\n const myController = this.abortController\n\n const response = await fetch(url, {\n headers: { ...this.headers, Accept: 'text/event-stream' },\n signal: myController.signal,\n })\n\n if (!response.ok) {\n throw new EvalRunnerError({\n code: 'SSE_CONNECT_FAILED',\n message: `SSE connection failed: ${response.status} ${response.statusText}`,\n expected: true,\n suggestion: 'Make sure the dev server is running (`adk dev`) and reachable.',\n })\n }\n\n if (!response.body) {\n throw new EvalRunnerError({ code: 'SSE_NO_BODY', message: 'SSE response has no body' })\n }\n\n this.connected = true\n\n // Start background parsing loop\n this._consumeStream(response.body).catch((err) => {\n // Ignore the deliberate abort from repoint(): only the current stream's failure counts.\n if (this.connected && this.abortController === myController) {\n this.streamError = err instanceof Error ? err : new Error(String(err))\n }\n })\n\n // Wait for the initial snapshot to arrive before returning.\n // This ensures that connect() resolves only after the snapshot\n // has been processed so callers can immediately check spans.\n await this._waitForSnapshot()\n }\n\n /**\n * Re-point at a new conversation, keeping `spanMap` and `seenHandlerKeys` (so\n * the earlier conversation stays visible and its completed handler can't\n * satisfy the next turn). Resets the snapshot latch so connect() awaits the\n * new conversation's snapshot.\n */\n async repoint(filter: SSEFilter): Promise<void> {\n this.connected = false\n this.abortController?.abort()\n this.abortController = null\n this._cancelSettle?.()\n this._cancelSettle = null\n this.waiters = []\n this.snapshotReceived = false\n this.snapshotResolvers = []\n // Clear any prior stream's error so a later timeout reports the new\n // conversation's state, not a dead connection we intentionally closed.\n this.streamError = null\n await this.connect(filter)\n }\n\n /**\n * Mark the beginning of a new turn.\n * Records which turn-handler span IDs (handler.conversation / handler.event)\n * have been seen so far, so waitForTurnComplete() only resolves on NEW\n * handler completions.\n */\n startTurn(): void {\n // Snapshot the current set of span keys as the turn boundary\n this.turnStartKeys = new Set(this.spanMap.keys())\n\n // Record all turn-handler spans seen so far\n for (const [key, span] of this.spanMap) {\n if (isTurnHandlerSpan(span)) {\n this.seenHandlerKeys.add(key)\n }\n }\n }\n\n private static readonly SETTLE_MS = 100\n\n /**\n * Wait for a turn-handler span (handler.conversation or handler.event) to\n * reach terminal status (ok or error).\n * Only considers spans NOT seen before the last startTurn() call.\n *\n * After the handler closes, waits for a quiet period (no new spans for SETTLE_MS)\n * to ensure all child spans (tool calls, messages, state saves) have arrived.\n * The runtime's HttpSpanExporter fires POSTs without awaiting them, so child\n * spans may arrive slightly after the handler close event.\n */\n async waitForTurnComplete(opts: TurnWaitOptions): Promise<void> {\n const accept = opts.acceptSpanNames\n const settle = { quietMs: opts.settleQuietMs, maxMs: opts.settleMaxMs }\n // Check if a completed handler already exists (e.g. from snapshot)\n if (this._hasNewCompletedHandler(accept)) {\n return this._settleAfterHandler(settle)\n }\n if (opts.abortSignal?.aborted) {\n throw new Error('waitForTurnComplete aborted')\n }\n\n return new Promise<void>((resolve, reject) => {\n const timer = setTimeout(() => {\n this._removeWaiter(waiter)\n opts.abortSignal?.removeEventListener('abort', onAbort)\n const expected = accept ? [...accept].join(' or ') : 'handler.conversation or handler.event'\n const reason = this.streamError\n ? `SSE stream died: ${this.streamError.message}`\n : `no ${expected} span completed`\n reject(\n new Error(\n `waitForTurnComplete timed out after ${opts.timeout}ms \u2014 ${reason}; diagnostics: ${this._formatTurnDiagnostics()}`\n )\n )\n }, opts.timeout)\n\n const onAbort = () => {\n clearTimeout(timer)\n this._removeWaiter(waiter)\n reject(new Error('waitForTurnComplete aborted'))\n }\n opts.abortSignal?.addEventListener('abort', onAbort, { once: true })\n\n const waiter = (_span: Span) => {\n if (this._hasNewCompletedHandler(accept)) {\n clearTimeout(timer)\n this._removeWaiter(waiter)\n opts.abortSignal?.removeEventListener('abort', onAbort)\n this._settleAfterHandler(settle).then(resolve, reject)\n }\n }\n\n this.waiters.push(waiter)\n })\n }\n\n private static readonly MAX_SETTLE_MS = 2_000\n\n /**\n * After the handler span closes, wait for spans to stop arriving.\n * Resolves when no new spans arrive for SETTLE_MS, or after MAX_SETTLE_MS hard cap.\n *\n * Exposes a cancellation hook via _cancelSettle so disconnect() can short-\n * circuit an in-flight settle phase and avoid leaking timers for up to 2s.\n */\n private _settleAfterHandler(settle?: { quietMs?: number; maxMs?: number }): Promise<void> {\n const quietMs = settle?.quietMs ?? SSECollector.SETTLE_MS\n const maxMs = settle?.maxMs ?? SSECollector.MAX_SETTLE_MS\n return new Promise<void>((resolve) => {\n let resolved = false\n const done = () => {\n if (resolved) return\n resolved = true\n clearTimeout(hardCap)\n clearTimeout(settleTimer)\n this._removeWaiter(settleWaiter)\n this._cancelSettle = null\n resolve()\n }\n\n const hardCap = setTimeout(done, maxMs)\n\n let settleTimer = setTimeout(done, quietMs)\n\n const settleWaiter = () => {\n if (resolved) return\n clearTimeout(settleTimer)\n settleTimer = setTimeout(done, quietMs)\n }\n\n this.waiters.push(settleWaiter)\n this._cancelSettle = done\n })\n }\n\n /**\n * Wait for a handler.workflow span with matching workflow name.\n * - signal 'entered': resolves when the span appears (any status)\n * - signal 'completed': resolves when the span has status !== 'running'\n */\n async waitForWorkflow(name: string, opts: WorkflowWaitOptions): Promise<void> {\n // Check if condition is already met\n if (this._matchesWorkflowCondition(name, opts.signal)) {\n return\n }\n if (opts.abortSignal?.aborted) {\n throw new Error(`waitForWorkflow(\"${name}\", { signal: \"${opts.signal}\" }) aborted`)\n }\n\n return new Promise<void>((resolve, reject) => {\n const timer = setTimeout(() => {\n this._removeWaiter(waiter)\n opts.abortSignal?.removeEventListener('abort', onAbort)\n const reason = this.streamError ? `SSE stream died: ${this.streamError.message}` : 'span not found'\n reject(\n new Error(\n `waitForWorkflow(\"${name}\", { signal: \"${opts.signal}\" }) timed out after ${opts.timeout}ms \u2014 ${reason}`\n )\n )\n }, opts.timeout)\n\n const onAbort = () => {\n clearTimeout(timer)\n this._removeWaiter(waiter)\n reject(new Error(`waitForWorkflow(\"${name}\", { signal: \"${opts.signal}\" }) aborted`))\n }\n opts.abortSignal?.addEventListener('abort', onAbort, { once: true })\n\n const waiter = (_span: Span) => {\n if (this._matchesWorkflowCondition(name, opts.signal)) {\n clearTimeout(timer)\n this._removeWaiter(waiter)\n opts.abortSignal?.removeEventListener('abort', onAbort)\n resolve()\n }\n }\n\n this.waiters.push(waiter)\n })\n }\n\n /**\n * Return spans accumulated since the last startTurn() call.\n */\n getTurnSpans(): Span[] {\n const result: Span[] = []\n for (const [key, span] of this.spanMap) {\n if (!this.turnStartKeys.has(key)) {\n result.push(span)\n }\n }\n return result\n }\n\n /**\n * Return all spans accumulated since connect().\n */\n getAllSpans(): Span[] {\n return Array.from(this.spanMap.values())\n }\n\n /**\n * Close the SSE connection and clean up.\n */\n disconnect(): void {\n this.connected = false\n this.abortController?.abort()\n this.abortController = null\n // Short-circuit an in-flight settle phase so its hardCap / settleTimer\n // don't fire after disconnect.\n this._cancelSettle?.()\n this._cancelSettle = null\n // Waiters hold setTimeout references that will reject on their own;\n // clearing the array just prevents further notifications.\n this.waiters = []\n this.snapshotResolvers = []\n }\n\n // \u2500\u2500 Private \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n /** Whether we have received the initial snapshot. */\n private snapshotReceived = false\n private snapshotResolvers: Array<() => void> = []\n\n private static readonly SNAPSHOT_TIMEOUT_MS = 10_000\n\n /**\n * Returns a promise that resolves once the snapshot event has been processed,\n * or rejects after a timeout to prevent connect() from hanging indefinitely.\n */\n private _waitForSnapshot(): Promise<void> {\n if (this.snapshotReceived) {\n return Promise.resolve()\n }\n return new Promise<void>((resolve, reject) => {\n let settled = false\n const resolver = () => {\n if (settled) return\n settled = true\n clearTimeout(timer)\n resolve()\n }\n const timer = setTimeout(() => {\n if (settled) return\n settled = true\n const idx = this.snapshotResolvers.indexOf(resolver)\n if (idx !== -1) this.snapshotResolvers.splice(idx, 1)\n reject(\n new Error(\n `SSE snapshot not received within ${SSECollector.SNAPSHOT_TIMEOUT_MS}ms \u2014 is the dev server healthy?`\n )\n )\n }, SSECollector.SNAPSHOT_TIMEOUT_MS)\n this.snapshotResolvers.push(resolver)\n })\n }\n\n /**\n * Consume the ReadableStream body, parse SSE lines, and dispatch events.\n */\n private async _consumeStream(body: ReadableStream<Uint8Array>): Promise<void> {\n const decoder = new TextDecoder()\n let buffer = ''\n\n const reader = body.getReader()\n\n try {\n while (this.connected) {\n const { done, value } = await reader.read()\n if (done) break\n\n buffer += decoder.decode(value, { stream: true })\n\n // Split on double-newline boundaries to get complete SSE events\n const parts = buffer.split('\\n\\n')\n // The last part may be incomplete \u2014 keep it in the buffer\n buffer = parts.pop() ?? ''\n\n for (const part of parts) {\n this._parseSSEBlock(part)\n }\n }\n } finally {\n reader.releaseLock()\n }\n }\n\n /**\n * Parse a single SSE event block (text between \\n\\n boundaries).\n * Extracts event name and data payload.\n */\n private _parseSSEBlock(block: string): void {\n const lines = block.split('\\n')\n let eventName = ''\n let dataLine = ''\n\n for (const line of lines) {\n if (line.startsWith('event:')) {\n eventName = line.slice('event:'.length).trim()\n } else if (line.startsWith('data:')) {\n const value = line.slice('data:'.length).trim()\n dataLine = dataLine ? `${dataLine}\\n${value}` : value\n }\n // id: and retry: lines are ignored\n }\n\n if (!eventName || !dataLine) {\n // Could be a retry: line or empty block \u2014 skip\n if (!this.snapshotReceived && block.includes('retry:')) {\n // The retry line comes before the snapshot; don't resolve yet\n }\n return\n }\n\n try {\n const payload = JSON.parse(dataLine)\n this._handleEvent(eventName, payload)\n } catch {\n // Malformed JSON \u2014 skip\n }\n }\n\n /**\n * Dispatch a parsed SSE event to the appropriate handler.\n */\n private _handleEvent(eventName: string, payload: unknown): void {\n this._recordEvent(eventName)\n\n if (eventName === 'snapshot') {\n const data = payload as { spans: Span[] }\n const spans = Array.isArray(data.spans) ? data.spans : []\n for (const span of spans) {\n this._upsertSpan(span)\n }\n this.snapshotReceived = true\n for (const resolve of this.snapshotResolvers) {\n resolve()\n }\n this.snapshotResolvers = []\n } else if (eventName === 'update') {\n const data = payload as { span: Span }\n if (data.span) {\n this._upsertSpan(data.span)\n this._notifyWaiters(data.span)\n }\n }\n // keepalive events are intentionally ignored\n }\n\n private _recordEvent(eventName: string): void {\n this.lastEvent = { name: eventName, at: Date.now() }\n\n if (eventName === 'update') {\n this.updateEventCount++\n } else if (eventName === 'keepalive') {\n this.keepaliveEventCount++\n }\n }\n\n private _formatTurnDiagnostics(): string {\n const turnSpans = this.getTurnSpans()\n const spanNames = new Set<string>()\n const handlerStatuses = new Set<string>()\n\n for (const span of turnSpans) {\n spanNames.add(span.name)\n // Tracks both handler.conversation and handler.event so an event-driven\n // turn that times out still surfaces its handler status.\n if (isTurnHandlerSpan(span)) {\n handlerStatuses.add(span.status)\n }\n }\n\n const lastEvent = this.lastEvent ? `${this.lastEvent.name} ${Date.now() - this.lastEvent.at}ms ago` : 'none'\n\n return [\n `snapshotReceived=${this.snapshotReceived}`,\n `totalUpdates=${this.updateEventCount}`,\n `totalKeepalives=${this.keepaliveEventCount}`,\n `lastEvent=${lastEvent}`,\n `totalSpans=${this.spanMap.size}`,\n `turnSpans=${turnSpans.length}`,\n `turnSpanNames=${this._formatSet(spanNames)}`,\n `turnHandlerStatuses=${this._formatSet(handlerStatuses)}`,\n ].join(', ')\n }\n\n private _formatSet(values: Set<string>, limit = 12): string {\n if (values.size === 0) {\n return 'none'\n }\n\n const items = Array.from(values)\n const suffix = items.length > limit ? `|+${items.length - limit} more` : ''\n return `${items.slice(0, limit).join('|')}${suffix}`\n }\n\n /**\n * Insert or replace a span in the map (dedup by trace+span ID).\n */\n private _upsertSpan(span: Span): void {\n this.spanMap.set(spanKey(span), span)\n }\n\n /**\n * Notify all waiters that a new span was received.\n */\n private _notifyWaiters(span: Span): void {\n // Copy the array since waiters may remove themselves during iteration\n const current = [...this.waiters]\n for (const waiter of current) {\n waiter(span)\n }\n }\n\n /**\n * Remove a waiter callback from the list.\n */\n private _removeWaiter(fn: (span: Span) => void): void {\n const idx = this.waiters.indexOf(fn)\n if (idx !== -1) {\n this.waiters.splice(idx, 1)\n }\n }\n\n /**\n * Check if there is a turn-handler span (handler.conversation / handler.event) that:\n * 1. Was NOT seen before startTurn()\n * 2. Has terminal status (ok or error)\n *\n * Marks the matched key as consumed so the same handler span cannot\n * satisfy both the current turn's settle phase AND the next turn's\n * waitForTurnComplete check (which would otherwise resolve instantly\n * against stale data instead of waiting for the new turn's handler).\n */\n private _hasNewCompletedHandler(acceptSpanNames?: ReadonlySet<string>): boolean {\n for (const [key, span] of this.spanMap) {\n if (\n isTurnHandlerSpan(span) &&\n (!acceptSpanNames || acceptSpanNames.has(span.name)) &&\n !this.seenHandlerKeys.has(key) &&\n (span.status === 'ok' || span.status === 'error')\n ) {\n this.seenHandlerKeys.add(key)\n return true\n }\n }\n return false\n }\n\n /**\n * Check if a handler.workflow span matches the given condition.\n */\n private _matchesWorkflowCondition(name: string, signal: 'entered' | 'completed'): boolean {\n for (const span of this.spanMap.values()) {\n if (span.name !== 'handler.workflow') continue\n\n const d = spanData(span)\n const wfName = d['workflow.name'] || d['workflowName']\n if (wfName !== name) continue\n\n if (signal === 'entered') {\n // Any status means the workflow was entered\n return true\n }\n\n if (signal === 'completed') {\n return span.status === 'ok' || span.status === 'error'\n }\n }\n return false\n }\n}\n", "import type { SpanSource, TurnWaitOptions, WaitOptions, WorkflowWaitOptions } from './span-source'\nimport type { Span } from './trace'\nimport { SSECollector } from './sse-collector'\n\nexport class LocalSpanSource implements SpanSource {\n private collector: SSECollector\n\n constructor(devServerUrl: string, headers: Record<string, string> = {}) {\n this.collector = new SSECollector(devServerUrl, headers)\n }\n\n async connect(filter: { conversationId: string }): Promise<void> {\n await this.collector.connect(filter)\n }\n\n async repoint(filter: { conversationId: string }): Promise<void> {\n await this.collector.repoint(filter)\n }\n\n startTurn(): void {\n this.collector.startTurn()\n }\n\n async waitForTurnComplete(opts: TurnWaitOptions): Promise<void> {\n await this.collector.waitForTurnComplete(opts)\n }\n\n async waitForWorkflow(name: string, opts: WorkflowWaitOptions): Promise<void> {\n await this.collector.waitForWorkflow(name, opts)\n }\n\n getTurnSpans(): Span[] {\n return this.collector.getTurnSpans()\n }\n\n getAllSpans(): Span[] {\n return this.collector.getAllSpans()\n }\n\n disconnect(): void {\n this.collector.disconnect()\n }\n}\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -0,0 +1,40 @@
1
+ import type { Span } from './trace';
2
+ export interface WaitOptions {
3
+ timeout: number;
4
+ abortSignal?: AbortSignal;
5
+ }
6
+ export interface WorkflowWaitOptions extends WaitOptions {
7
+ signal: 'entered' | 'completed';
8
+ }
9
+ export interface TurnWaitOptions extends WaitOptions {
10
+ /**
11
+ * Which handler span names may complete this turn (e.g. a user-message turn
12
+ * completes via `handler.conversation`, an event-driven turn via
13
+ * `handler.event`). Omitted = any turn-handler span.
14
+ */
15
+ acceptSpanNames?: ReadonlySet<string>;
16
+ /** Quiet window after the handler closes before the turn counts as settled. */
17
+ settleQuietMs?: number;
18
+ /** Hard cap on the settle phase. */
19
+ settleMaxMs?: number;
20
+ }
21
+ export interface SpanSource {
22
+ connect(filter: {
23
+ conversationId: string;
24
+ }): Promise<void>;
25
+ /**
26
+ * Re-point the stream at a new conversation, keeping spans already
27
+ * accumulated (so outcome assertions still see the earlier conversation and
28
+ * its completed handler can't satisfy the next turn).
29
+ */
30
+ repoint(filter: {
31
+ conversationId: string;
32
+ }): Promise<void>;
33
+ startTurn(): void;
34
+ waitForTurnComplete(opts: TurnWaitOptions): Promise<void>;
35
+ waitForWorkflow(name: string, opts: WorkflowWaitOptions): Promise<void>;
36
+ getTurnSpans(): Span[];
37
+ getAllSpans(): Span[];
38
+ disconnect(): void;
39
+ }
40
+ //# sourceMappingURL=span-source.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"span-source.d.ts","sourceRoot":"","sources":["../../src/spans/span-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAEnC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;CAChC;AAED,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD;;;;OAIG;IACH,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACrC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1D;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1D,SAAS,IAAI,IAAI,CAAA;IACjB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzD,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvE,YAAY,IAAI,IAAI,EAAE,CAAA;IACtB,WAAW,IAAI,IAAI,EAAE,CAAA;IACrB,UAAU,IAAI,IAAI,CAAA;CACnB"}