@axlsdk/eval 0.3.0 → 0.5.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 (2) hide show
  1. package/README.md +10 -6
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -92,6 +92,7 @@ import { runEval } from '@axlsdk/eval';
92
92
 
93
93
  const results = await runEval(
94
94
  {
95
+ workflow: 'my-workflow', // label stored in results for comparison
95
96
  dataset: ds,
96
97
  scorers: [exactMatch, qualityJudge],
97
98
  concurrency: 5,
@@ -103,7 +104,7 @@ const results = await runEval(
103
104
  );
104
105
 
105
106
  console.log(results.summary);
106
- // { exact-match: { mean: 0.85, min: 0, max: 1 }, quality: { mean: 0.92, ... } }
107
+ // { count: 3, failures: 0, scorers: { 'exact-match': { mean: 0.85, min: 0, max: 1, p50: 1, p95: 1 }, ... } }
107
108
  ```
108
109
 
109
110
  ### `evalCompare(baseline, candidate)`
@@ -116,10 +117,10 @@ import { evalCompare } from '@axlsdk/eval';
116
117
  const comparison = evalCompare(baselineResults, candidateResults);
117
118
 
118
119
  console.log(comparison.regressions);
119
- // [{ item: ..., scorer: 'exact-match', baseline: 1, candidate: 0 }]
120
+ // [{ input: ..., scorer: 'exact-match', baselineScore: 1, candidateScore: 0, delta: -1 }]
120
121
 
121
122
  console.log(comparison.improvements);
122
- // [{ item: ..., scorer: 'quality', baseline: 0.5, candidate: 0.9 }]
123
+ // [{ input: ..., scorer: 'quality', baselineScore: 0.5, candidateScore: 0.9, delta: 0.4 }]
123
124
  ```
124
125
 
125
126
  ### `defineEval(config)`
@@ -130,7 +131,7 @@ Register an eval for CLI discovery:
130
131
  import { defineEval } from '@axlsdk/eval';
131
132
 
132
133
  export default defineEval({
133
- name: 'math-eval',
134
+ workflow: 'math-workflow',
134
135
  dataset: ds,
135
136
  scorers: [exactMatch],
136
137
  });
@@ -142,10 +143,13 @@ Run evaluations from the command line:
142
143
 
143
144
  ```bash
144
145
  # Run an eval file
145
- npx axl-eval run ./evals/math.ts
146
+ npx axl eval ./evals/math.ts
147
+
148
+ # Save results to a file
149
+ npx axl eval ./evals/math.ts --output ./results/baseline.json
146
150
 
147
151
  # Compare two results
148
- npx axl-eval compare ./results/baseline.json ./results/candidate.json
152
+ npx axl eval compare ./results/baseline.json ./results/candidate.json
149
153
  ```
150
154
 
151
155
  ## Integration with AxlRuntime
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@axlsdk/eval",
3
- "version": "0.3.0",
3
+ "version": "0.5.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.3.0"
28
+ "@axlsdk/axl": "0.5.0"
29
29
  },
30
30
  "devDependencies": {
31
31
  "@types/node": "^25.2.3",