@axlsdk/eval 0.15.0 → 0.16.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.
package/README.md CHANGED
@@ -344,7 +344,7 @@ for (const item of results.items) {
344
344
  // Per-item trace events (when run with { captureTraces: true })
345
345
  if (item.traces) {
346
346
  console.log(`${item.traces.length} trace events captured`);
347
- const agentCalls = item.traces.filter(e => e.type === 'agent_call');
347
+ const agentCalls = item.traces.filter(e => e.type === 'agent_call_end');
348
348
  console.log(`${agentCalls.length} LLM turns`);
349
349
  // Failure-path traces are also populated (recovered from axlCapturedTraces
350
350
  // on the thrown error) — captureTraces is especially useful for debugging
@@ -353,6 +353,8 @@ for (const item of results.items) {
353
353
  }
354
354
  ```
355
355
 
356
+ `captureTraces` strips verbose-mode `agent_call_end.data.messages` snapshots and high-volume events (`token`, `partial_object`) from the captured array to keep memory bounded. The structural events you'd want for debugging — `agent_call_start`/`agent_call_end`, `tool_call_*`, gate events, `pipeline`, `verify`, `handoff_*` — are all retained.
357
+
356
358
  ## Comparing Results
357
359
 
358
360
  Compare two runs to detect regressions and improvements. Runs must use the same dataset and scorers.
package/dist/index.d.cts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { TraceEvent, AxlRuntime } from '@axlsdk/axl';
2
+ import { AxlEvent, AxlRuntime } from '@axlsdk/axl';
3
3
 
4
4
  type DatasetItem<TInput, TAnnotations = undefined> = {
5
5
  input: TInput;
@@ -135,9 +135,9 @@ type EvalItem = {
135
135
  metadata?: Record<string, unknown>;
136
136
  /** Trace events captured during this item's execution. Only populated when
137
137
  * `runEval` was called with `{ captureTraces: true }`. Verbose-mode
138
- * `agent_call.data.messages` snapshots are stripped to keep memory bounded;
138
+ * `agent_call_start.data.messages` snapshots are stripped to keep memory bounded;
139
139
  * subscribe to `runtime.on('trace', ...)` directly if you need those. */
140
- traces?: TraceEvent[];
140
+ traces?: AxlEvent[];
141
141
  };
142
142
  type EvalSummary = {
143
143
  count: number;
@@ -238,14 +238,14 @@ type RunEvalOptions = {
238
238
  /** Abort signal — checked before starting each item. */
239
239
  signal?: AbortSignal;
240
240
  /**
241
- * Capture per-item `TraceEvent[]` from the runtime and store them on
241
+ * Capture per-item `AxlEvent[]` from the runtime and store them on
242
242
  * `EvalItem.traces`. Off by default because traces multiply memory with
243
243
  * dataset size × turns × agents. When on, the runner wraps the user-provided
244
244
  * `executeWorkflow` with `runtime.trackExecution({ captureTraces: true })`,
245
245
  * so any `runtime.execute()` / `ctx.ask()` activity inside the callback is
246
246
  * captured and scoped to the current item.
247
247
  *
248
- * Note: verbose-mode `agent_call.data.messages` snapshots are stripped from
248
+ * Note: verbose-mode `agent_call_start.data.messages` snapshots are stripped from
249
249
  * captured traces to keep memory bounded — if you need the full verbose
250
250
  * payload, subscribe to `runtime.on('trace', ...)` directly.
251
251
  */
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { TraceEvent, AxlRuntime } from '@axlsdk/axl';
2
+ import { AxlEvent, AxlRuntime } from '@axlsdk/axl';
3
3
 
4
4
  type DatasetItem<TInput, TAnnotations = undefined> = {
5
5
  input: TInput;
@@ -135,9 +135,9 @@ type EvalItem = {
135
135
  metadata?: Record<string, unknown>;
136
136
  /** Trace events captured during this item's execution. Only populated when
137
137
  * `runEval` was called with `{ captureTraces: true }`. Verbose-mode
138
- * `agent_call.data.messages` snapshots are stripped to keep memory bounded;
138
+ * `agent_call_start.data.messages` snapshots are stripped to keep memory bounded;
139
139
  * subscribe to `runtime.on('trace', ...)` directly if you need those. */
140
- traces?: TraceEvent[];
140
+ traces?: AxlEvent[];
141
141
  };
142
142
  type EvalSummary = {
143
143
  count: number;
@@ -238,14 +238,14 @@ type RunEvalOptions = {
238
238
  /** Abort signal — checked before starting each item. */
239
239
  signal?: AbortSignal;
240
240
  /**
241
- * Capture per-item `TraceEvent[]` from the runtime and store them on
241
+ * Capture per-item `AxlEvent[]` from the runtime and store them on
242
242
  * `EvalItem.traces`. Off by default because traces multiply memory with
243
243
  * dataset size × turns × agents. When on, the runner wraps the user-provided
244
244
  * `executeWorkflow` with `runtime.trackExecution({ captureTraces: true })`,
245
245
  * so any `runtime.execute()` / `ctx.ask()` activity inside the callback is
246
246
  * captured and scoped to the current item.
247
247
  *
248
- * Note: verbose-mode `agent_call.data.messages` snapshots are stripped from
248
+ * Note: verbose-mode `agent_call_start.data.messages` snapshots are stripped from
249
249
  * captured traces to keep memory bounded — if you need the full verbose
250
250
  * payload, subscribe to `runtime.on('trace', ...)` directly.
251
251
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@axlsdk/eval",
3
- "version": "0.15.0",
3
+ "version": "0.16.0",
4
4
  "description": "Evaluation framework for Axl agentic workflows",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",
@@ -25,7 +25,7 @@
25
25
  "dist"
26
26
  ],
27
27
  "dependencies": {
28
- "@axlsdk/axl": "0.15.0"
28
+ "@axlsdk/axl": "0.16.0"
29
29
  },
30
30
  "peerDependencies": {
31
31
  "zod": "^4.0.0"