@tangle-network/agent-eval 0.126.6 → 0.127.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 (129) hide show
  1. package/CHANGELOG.md +51 -0
  2. package/README.md +2 -2
  3. package/dist/analyst/index.d.ts +52 -40
  4. package/dist/analyst/index.js +4 -4
  5. package/dist/belief-state/index.d.ts +34 -36
  6. package/dist/belief-state/index.js +2 -2
  7. package/dist/benchmarks/index.d.ts +30 -12
  8. package/dist/benchmarks/index.js +12 -10
  9. package/dist/builder-eval/index.js +1 -1
  10. package/dist/campaign/index.d.ts +432 -146
  11. package/dist/campaign/index.js +11 -9
  12. package/dist/{chunk-ARU2PZFM.js → chunk-424XHVKV.js} +43 -23
  13. package/dist/chunk-424XHVKV.js.map +1 -0
  14. package/dist/{chunk-NUKSVU3W.js → chunk-5DTSBUL2.js} +2 -2
  15. package/dist/{chunk-BTACVO2W.js → chunk-65QETEKG.js} +542 -258
  16. package/dist/chunk-65QETEKG.js.map +1 -0
  17. package/dist/{chunk-CGG5SLH3.js → chunk-ARCFIY7U.js} +2 -2
  18. package/dist/{chunk-P22LJ3Y2.js → chunk-CLELFRQG.js} +6 -4
  19. package/dist/chunk-CLELFRQG.js.map +1 -0
  20. package/dist/{chunk-LUNF2SEL.js → chunk-DJKY2TSY.js} +3 -3
  21. package/dist/chunk-DPUHNQLN.js +232 -0
  22. package/dist/chunk-DPUHNQLN.js.map +1 -0
  23. package/dist/{chunk-IPYXE555.js → chunk-EJGRPCO3.js} +36 -13
  24. package/dist/chunk-EJGRPCO3.js.map +1 -0
  25. package/dist/{chunk-K6IAZZ6L.js → chunk-FA3MFYNA.js} +132 -110
  26. package/dist/chunk-FA3MFYNA.js.map +1 -0
  27. package/dist/chunk-IG35YDN3.js +614 -0
  28. package/dist/chunk-IG35YDN3.js.map +1 -0
  29. package/dist/{chunk-DPZAEKA6.js → chunk-IMGJZBFG.js} +84 -56
  30. package/dist/chunk-IMGJZBFG.js.map +1 -0
  31. package/dist/{chunk-H5UD2323.js → chunk-IN455XKS.js} +53 -1
  32. package/dist/chunk-IN455XKS.js.map +1 -0
  33. package/dist/{chunk-PJQFMIOX.js → chunk-MHELPNRP.js} +31 -1
  34. package/dist/chunk-MHELPNRP.js.map +1 -0
  35. package/dist/{chunk-IILEIWGW.js → chunk-NL33OXEP.js} +41 -36
  36. package/dist/chunk-NL33OXEP.js.map +1 -0
  37. package/dist/{chunk-474LBSOX.js → chunk-OD5NQ2CS.js} +41 -16
  38. package/dist/chunk-OD5NQ2CS.js.map +1 -0
  39. package/dist/{chunk-QOTFXW5L.js → chunk-P5W7RQKK.js} +2 -2
  40. package/dist/{chunk-IR3KBHOY.js → chunk-P6FYH6K4.js} +39 -3
  41. package/dist/chunk-P6FYH6K4.js.map +1 -0
  42. package/dist/{chunk-J5SQWP6Y.js → chunk-PBE2LOSS.js} +18 -2
  43. package/dist/chunk-PBE2LOSS.js.map +1 -0
  44. package/dist/{chunk-E3IADPLG.js → chunk-PRB53E3J.js} +50 -224
  45. package/dist/chunk-PRB53E3J.js.map +1 -0
  46. package/dist/{chunk-X4UCIOTZ.js → chunk-S5YLIBFX.js} +2 -2
  47. package/dist/{chunk-7VYEGHWF.js → chunk-SZLVEKMJ.js} +41 -20
  48. package/dist/chunk-SZLVEKMJ.js.map +1 -0
  49. package/dist/{chunk-LKKT3IVV.js → chunk-TSN7JT6D.js} +6 -4
  50. package/dist/{chunk-LKKT3IVV.js.map → chunk-TSN7JT6D.js.map} +1 -1
  51. package/dist/{chunk-M7AH34KV.js → chunk-UTA2TGC4.js} +32 -16
  52. package/dist/chunk-UTA2TGC4.js.map +1 -0
  53. package/dist/{chunk-MAX3TN3C.js → chunk-UWZZKKU7.js} +7 -19
  54. package/dist/chunk-UWZZKKU7.js.map +1 -0
  55. package/dist/{chunk-ZVCHKKOP.js → chunk-WED5KLZQ.js} +39 -15
  56. package/dist/chunk-WED5KLZQ.js.map +1 -0
  57. package/dist/{chunk-OCFJACJU.js → chunk-X6VOPMLD.js} +74 -14
  58. package/dist/chunk-X6VOPMLD.js.map +1 -0
  59. package/dist/{chunk-MOXWMGPC.js → chunk-Y5CYOL42.js} +159 -70
  60. package/dist/chunk-Y5CYOL42.js.map +1 -0
  61. package/dist/{chunk-FO7HEH76.js → chunk-YJBNWCAA.js} +2 -2
  62. package/dist/chunk-ZPUEEM5U.js +179 -0
  63. package/dist/chunk-ZPUEEM5U.js.map +1 -0
  64. package/dist/{chunk-KE2VWPZX.js → chunk-ZUUWPZCV.js} +3 -3
  65. package/dist/cli.js +4 -4
  66. package/dist/contract/index.d.ts +464 -126
  67. package/dist/contract/index.js +425 -211
  68. package/dist/contract/index.js.map +1 -1
  69. package/dist/control.d.ts +34 -32
  70. package/dist/control.js +2 -2
  71. package/dist/hosted/index.d.ts +142 -41
  72. package/dist/hosted/index.js +23 -1
  73. package/dist/index.d.ts +365 -256
  74. package/dist/index.js +315 -226
  75. package/dist/index.js.map +1 -1
  76. package/dist/meta-eval/index.d.ts +32 -32
  77. package/dist/meta-eval/index.js +2 -2
  78. package/dist/multishot/index.d.ts +1 -0
  79. package/dist/openapi.json +1 -1
  80. package/dist/pipelines/index.js +2 -2
  81. package/dist/reporting.d.ts +97 -74
  82. package/dist/reporting.js +5 -4
  83. package/dist/rl.d.ts +177 -131
  84. package/dist/rl.js +232 -126
  85. package/dist/rl.js.map +1 -1
  86. package/dist/rollout/index.d.ts +53 -63
  87. package/dist/rollout/index.js +7 -5
  88. package/dist/{run-campaign-FFRM3RH5.js → run-campaign-3A2EBYBE.js} +4 -3
  89. package/dist/supervisor-run/index.d.ts +7 -15
  90. package/dist/supervisor-run/index.js +2 -2
  91. package/dist/traces.d.ts +66 -41
  92. package/dist/traces.js +9 -5
  93. package/dist/wire/index.d.ts +1 -0
  94. package/dist/wire/index.js +2 -2
  95. package/docs/concepts.md +18 -1
  96. package/docs/hosted-ingest-spec.md +37 -40
  97. package/docs/insight-report.md +57 -7
  98. package/docs/research-report-methodology.md +20 -21
  99. package/docs/rollout.md +13 -8
  100. package/package.json +21 -14
  101. package/dist/chunk-474LBSOX.js.map +0 -1
  102. package/dist/chunk-7VYEGHWF.js.map +0 -1
  103. package/dist/chunk-ARU2PZFM.js.map +0 -1
  104. package/dist/chunk-BTACVO2W.js.map +0 -1
  105. package/dist/chunk-DPZAEKA6.js.map +0 -1
  106. package/dist/chunk-E3IADPLG.js.map +0 -1
  107. package/dist/chunk-H5UD2323.js.map +0 -1
  108. package/dist/chunk-IILEIWGW.js.map +0 -1
  109. package/dist/chunk-IPYXE555.js.map +0 -1
  110. package/dist/chunk-IR3KBHOY.js.map +0 -1
  111. package/dist/chunk-J5SQWP6Y.js.map +0 -1
  112. package/dist/chunk-K6IAZZ6L.js.map +0 -1
  113. package/dist/chunk-M7AH34KV.js.map +0 -1
  114. package/dist/chunk-MAX3TN3C.js.map +0 -1
  115. package/dist/chunk-MOXWMGPC.js.map +0 -1
  116. package/dist/chunk-OCFJACJU.js.map +0 -1
  117. package/dist/chunk-P22LJ3Y2.js.map +0 -1
  118. package/dist/chunk-PJQFMIOX.js.map +0 -1
  119. package/dist/chunk-ZVCHKKOP.js.map +0 -1
  120. package/dist/chunk-ZZUXHH3R.js +0 -99
  121. package/dist/chunk-ZZUXHH3R.js.map +0 -1
  122. /package/dist/{chunk-NUKSVU3W.js.map → chunk-5DTSBUL2.js.map} +0 -0
  123. /package/dist/{chunk-CGG5SLH3.js.map → chunk-ARCFIY7U.js.map} +0 -0
  124. /package/dist/{chunk-LUNF2SEL.js.map → chunk-DJKY2TSY.js.map} +0 -0
  125. /package/dist/{chunk-QOTFXW5L.js.map → chunk-P5W7RQKK.js.map} +0 -0
  126. /package/dist/{chunk-X4UCIOTZ.js.map → chunk-S5YLIBFX.js.map} +0 -0
  127. /package/dist/{chunk-FO7HEH76.js.map → chunk-YJBNWCAA.js.map} +0 -0
  128. /package/dist/{chunk-KE2VWPZX.js.map → chunk-ZUUWPZCV.js.map} +0 -0
  129. /package/dist/{run-campaign-FFRM3RH5.js.map → run-campaign-3A2EBYBE.js.map} +0 -0
@@ -1,9 +1,15 @@
1
1
  import {
2
2
  ROLLOUT_SCHEMA
3
- } from "./chunk-MAX3TN3C.js";
3
+ } from "./chunk-UWZZKKU7.js";
4
4
  import {
5
5
  buildTrajectory
6
6
  } from "./chunk-RZTMDUO7.js";
7
+ import {
8
+ runTaskScore
9
+ } from "./chunk-NL33OXEP.js";
10
+ import {
11
+ ValidationError
12
+ } from "./chunk-ONWEPEDO.js";
7
13
 
8
14
  // src/rollout/mint.ts
9
15
  var asText = (v, scrub) => {
@@ -42,15 +48,21 @@ function finalConversation(spans, scrub) {
42
48
  }
43
49
  return messages;
44
50
  }
45
- function rolloutReward(record) {
51
+ function scoredReward(record) {
52
+ const score = runTaskScore(record);
53
+ if (score === void 0) {
54
+ throw new ValidationError(`Cannot mint rollout for run ${record.runId}: task score is missing`);
55
+ }
46
56
  const gated = record.outcome.realness?.gated === true;
47
- const raw = record.outcome.holdoutScore ?? record.outcome.searchScore ?? 0;
48
- return { reward: gated ? 0 : raw, gated };
57
+ return {
58
+ reward: gated ? 0 : score,
59
+ gated,
60
+ source: record.outcome.holdoutScore !== void 0 ? "run-record/holdout-score" : "run-record/search-score"
61
+ };
49
62
  }
50
- function rewardSource(record) {
51
- if (record.outcome.holdoutScore !== void 0) return "run-record/holdout-score";
52
- if (record.outcome.searchScore !== void 0) return "run-record/search-score";
53
- return "run-record/unscored";
63
+ function rolloutReward(record) {
64
+ const { reward, gated } = scoredReward(record);
65
+ return { reward, gated };
54
66
  }
55
67
  var SPLIT_FROM_TAG = {
56
68
  search: "search",
@@ -58,8 +70,12 @@ var SPLIT_FROM_TAG = {
58
70
  holdout: "holdout"
59
71
  };
60
72
  function mintLine(record, steps, messages, options, capturedAt, gap) {
61
- const { reward, gated } = rolloutReward(record);
62
- const uncaptured = record.costProvenance?.kind === "uncaptured";
73
+ const { reward, gated, source } = scoredReward(record);
74
+ const uncaptured = record.costProvenance.kind === "uncaptured";
75
+ const terminalOutcome = record.terminalOutcome;
76
+ const isCompleted = terminalOutcome === "succeeded" || terminalOutcome === "failed";
77
+ const isTruncated = terminalOutcome === "cancelled" || terminalOutcome === "incomplete";
78
+ const terminalError = terminalOutcome === "failed" || terminalOutcome === "cancelled" || terminalOutcome === "incomplete" ? record.terminalFailureReason ?? `run ended ${terminalOutcome}` : null;
63
79
  return {
64
80
  schema: ROLLOUT_SCHEMA,
65
81
  rollout_id: record.runId,
@@ -72,7 +88,7 @@ function mintLine(record, steps, messages, options, capturedAt, gap) {
72
88
  role: options.role ?? "agent",
73
89
  task: {
74
90
  suite: options.suite ?? record.experimentId,
75
- instance_id: record.scenarioId ?? record.experimentId,
91
+ instance_id: record.scenarioId,
76
92
  split: SPLIT_FROM_TAG[record.splitTag],
77
93
  seed: record.seed,
78
94
  rep: 0
@@ -93,12 +109,12 @@ function mintLine(record, steps, messages, options, capturedAt, gap) {
93
109
  ...steps.length > 0 ? { steps } : {},
94
110
  outcome: {
95
111
  reward,
96
- reward_source: rewardSource(record),
112
+ reward_source: source,
97
113
  verdict: null,
98
114
  metrics: { ...record.outcome.raw },
99
- is_completed: true,
100
- is_truncated: false,
101
- error: null,
115
+ is_completed: isCompleted,
116
+ is_truncated: isTruncated,
117
+ error: terminalError,
102
118
  realness_gated: gated
103
119
  },
104
120
  cost: {
@@ -152,4 +168,4 @@ export {
152
168
  rolloutReward,
153
169
  mintRolloutRows
154
170
  };
155
- //# sourceMappingURL=chunk-M7AH34KV.js.map
171
+ //# sourceMappingURL=chunk-UTA2TGC4.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/rollout/mint.ts"],"sourcesContent":["/**\n * Rollout minting — `tangle.rollout.v1` lines joined from the records the\n * substrate ALREADY keeps. There is no separate rollout store: a rollout\n * is the JOIN of a RunRecord (identity, provenance, cost, outcome) with\n * its trace (spans share `runId`), projected into the canonical line.\n *\n * Composition, not duplication:\n * - identity/provenance → `RunRecord` (candidateId, splitTag, agentProfile, hashes)\n * - step structure → `buildTrajectory` over the shared TraceStore\n * - preference-pair export → `feedbackTrajectoryToOptimizerRow` (feedback-trajectory.ts)\n * - PRM / reward-model → `reward-model-export.ts`\n *\n * Anti-Goodhart invariant: a run whose `outcome.realness.gated` is true\n * is never exported with a positive reward — the gate travels into the\n * training data (`reward` forced to 0, `realness_gated: true`), so a\n * fine-tune cannot learn from gamed successes.\n *\n * Records without spans become labeled GAP LINES (messages: [],\n * provenance.gap) — present in the output AND surfaced in\n * `missingTraces`; a capture gap is a finding, never a silent omission.\n */\n\nimport { ValidationError } from '../errors'\nimport { type RunRecord, runTaskScore } from '../run-record'\nimport type { LlmSpan, Message, Span, ToolSpan } from '../trace/schema'\nimport type { TraceStore } from '../trace/store'\nimport { buildTrajectory } from '../trajectory'\nimport {\n type ChatMessage,\n ROLLOUT_SCHEMA,\n type RolloutLine,\n type RolloutRole,\n type RolloutSplit,\n type RolloutStep,\n} from './schema'\n\n/** Redactor applied to every exported string (secrets, PII). Identity by default. */\nexport type RolloutScrubber = (text: string) => string\n\nexport interface MintRolloutOptions {\n scrub?: RolloutScrubber\n /** Cap steps per line (longest runs first drop middle steps). Default: no cap. */\n maxSteps?: number\n /** Role recorded on every minted line. Default 'agent' (a solo eval run). */\n role?: RolloutRole\n /** Task suite label. Default: the record's `experimentId`. */\n suite?: string\n /** Injected clock for deterministic output. */\n now?: () => Date\n}\n\nexport interface MintRolloutResult {\n rows: RolloutLine[]\n /** runIds that had a RunRecord but no spans — emitted as gap lines AND listed here. */\n missingTraces: string[]\n}\n\nconst asText = (v: unknown, scrub: RolloutScrubber): string => {\n const s = typeof v === 'string' ? v : JSON.stringify(v)\n return scrub(s ?? '')\n}\n\nfunction projectStep(span: Span, scrub: RolloutScrubber): RolloutStep {\n const base: RolloutStep = {\n kind: span.kind,\n name: scrub(span.name),\n status: span.status,\n durationMs: span.endedAt !== undefined ? span.endedAt - span.startedAt : undefined,\n }\n if (span.kind === 'llm') {\n const llm = span as LlmSpan\n const last = llm.messages[llm.messages.length - 1]\n if (last) base.input = scrub(last.content)\n if (llm.output !== undefined) base.output = scrub(llm.output)\n } else if (span.kind === 'tool') {\n const tool = span as ToolSpan\n base.input = asText(tool.args, scrub)\n if (tool.result !== undefined) base.output = asText(tool.result, scrub)\n }\n return base\n}\n\n/** The final llm span's history + output is the completed conversation. */\nfunction finalConversation(spans: Span[], scrub: RolloutScrubber): ChatMessage[] {\n const llms = spans.filter((s): s is LlmSpan => s.kind === 'llm')\n const last = llms[llms.length - 1]\n if (!last) return []\n const messages: ChatMessage[] = last.messages.map((m: Message) => ({\n role: m.role,\n content: scrub(m.content),\n }))\n if (last.output !== undefined && last.output !== '') {\n messages.push({ role: 'assistant', content: scrub(last.output) })\n }\n return messages\n}\n\nfunction scoredReward(record: RunRecord): {\n reward: number\n gated: boolean\n source: 'run-record/holdout-score' | 'run-record/search-score'\n} {\n const score = runTaskScore(record)\n if (score === undefined) {\n throw new ValidationError(`Cannot mint rollout for run ${record.runId}: task score is missing`)\n }\n const gated = record.outcome.realness?.gated === true\n return {\n reward: gated ? 0 : score,\n gated,\n source:\n record.outcome.holdoutScore !== undefined\n ? 'run-record/holdout-score'\n : 'run-record/search-score',\n }\n}\n\nexport function rolloutReward(record: RunRecord): { reward: number; gated: boolean } {\n const { reward, gated } = scoredReward(record)\n return { reward, gated }\n}\n\nconst SPLIT_FROM_TAG: Record<RunRecord['splitTag'], RolloutSplit> = {\n search: 'search',\n dev: 'dev',\n holdout: 'holdout',\n}\n\nfunction mintLine(\n record: RunRecord,\n steps: RolloutStep[],\n messages: ChatMessage[],\n options: MintRolloutOptions,\n capturedAt: string,\n gap?: string,\n): RolloutLine {\n const { reward, gated, source } = scoredReward(record)\n const uncaptured = record.costProvenance.kind === 'uncaptured'\n const terminalOutcome = record.terminalOutcome\n const isCompleted = terminalOutcome === 'succeeded' || terminalOutcome === 'failed'\n const isTruncated = terminalOutcome === 'cancelled' || terminalOutcome === 'incomplete'\n const terminalError =\n terminalOutcome === 'failed' ||\n terminalOutcome === 'cancelled' ||\n terminalOutcome === 'incomplete'\n ? (record.terminalFailureReason ?? `run ended ${terminalOutcome}`)\n : null\n return {\n schema: ROLLOUT_SCHEMA,\n rollout_id: record.runId,\n parent_rollout_id: null,\n run_id: record.runId,\n experiment_id: record.experimentId,\n candidate_id: record.candidateId,\n generation: null,\n candidate_index: null,\n role: options.role ?? 'agent',\n task: {\n suite: options.suite ?? record.experimentId,\n instance_id: record.scenarioId,\n split: SPLIT_FROM_TAG[record.splitTag],\n seed: record.seed,\n rep: 0,\n },\n policy: {\n harness: null,\n harness_version: null,\n model: record.model,\n provider: null,\n profile_commit: record.commitSha,\n prompt_hash: record.promptHash,\n config_hash: record.configHash,\n agent_profile_cell_id: record.agentProfile?.cellId ?? null,\n sampling: null,\n },\n messages,\n tool_defs: [],\n ...(steps.length > 0 ? { steps } : {}),\n outcome: {\n reward,\n reward_source: source,\n verdict: null,\n metrics: { ...record.outcome.raw },\n is_completed: isCompleted,\n is_truncated: isTruncated,\n error: terminalError,\n realness_gated: gated,\n },\n cost: {\n usd: uncaptured ? null : record.costUsd,\n tokens_in: record.tokenUsage.input,\n tokens_out: record.tokenUsage.output,\n tokens_reasoning: record.tokenUsage.reasoning ?? null,\n cache_read: record.tokenUsage.cached ?? null,\n cache_write: record.tokenUsage.cacheWrite ?? null,\n wall_s: Math.round(record.wallMs / 1000),\n },\n artifacts: { patch_path: null, run_dir: null, transcript_ref: null },\n provenance: {\n captured_at: capturedAt,\n capture: 'mint',\n ...(gap !== undefined ? { gap } : {}),\n },\n }\n}\n\n/**\n * Join RunRecords with their traces into canonical rollout lines. Records\n * without spans are emitted as labeled gap lines and reported in\n * `missingTraces`. Execution-only records without a task score are rejected\n * because a missing training label is not a zero reward.\n */\nexport async function mintRolloutRows(\n records: RunRecord[],\n store: TraceStore,\n options: MintRolloutOptions = {},\n): Promise<MintRolloutResult> {\n const scrub = options.scrub ?? ((t) => t)\n const capturedAt = (options.now?.() ?? new Date()).toISOString()\n const rows: RolloutLine[] = []\n const missingTraces: string[] = []\n for (const record of records) {\n const trajectory = await buildTrajectory(store, record.runId)\n if (trajectory.steps.length === 0) {\n missingTraces.push(record.runId)\n rows.push(\n mintLine(record, [], [], options, capturedAt, 'no trace spans recorded for this runId'),\n )\n continue\n }\n let steps = trajectory.steps.map((s) => projectStep(s.span, scrub))\n if (options.maxSteps !== undefined && steps.length > options.maxSteps) {\n // Keep the head and tail — the middle of a long run is the least\n // informative for outcome attribution.\n const head = Math.ceil(options.maxSteps / 2)\n const tail = options.maxSteps - head\n steps = [...steps.slice(0, head), ...steps.slice(steps.length - tail)]\n }\n const conversation = finalConversation(\n trajectory.steps.map((s) => s.span),\n scrub,\n )\n const gap =\n conversation.length === 0 ? 'trace has no llm spans — no conversation to inline' : undefined\n rows.push(mintLine(record, steps, conversation, options, capturedAt, gap))\n }\n return { rows, missingTraces }\n}\n"],"mappings":"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","names":[]}
@@ -1,6 +1,5 @@
1
1
  // src/rollout/schema.ts
2
2
  var ROLLOUT_SCHEMA = "tangle.rollout.v1";
3
- var ROLLOUT_FORMAT = ROLLOUT_SCHEMA;
4
3
  var ROLLOUT_ROLES = [
5
4
  "agent",
6
5
  "supervisor",
@@ -9,14 +8,8 @@ var ROLLOUT_ROLES = [
9
8
  "judge",
10
9
  "analyst"
11
10
  ];
12
- var ROLLOUT_SPLITS = [
13
- "search",
14
- "dev",
15
- "holdout",
16
- "canary",
17
- "train"
18
- ];
19
- var TRAINABLE_SPLITS = ["search", "train"];
11
+ var ROLLOUT_SPLITS = ["search", "dev", "holdout", "canary"];
12
+ var TRAINABLE_SPLITS = ["search"];
20
13
  function isTrainableSplit(split) {
21
14
  return TRAINABLE_SPLITS.includes(split);
22
15
  }
@@ -81,12 +74,8 @@ function validateRolloutLine(value) {
81
74
  errors.push("parent_rollout_id: expected string|null");
82
75
  if (typeof value.run_id !== "string" || value.run_id.length === 0)
83
76
  errors.push("run_id: expected non-empty string");
84
- if (value.experiment_id !== void 0 && !isStringOrNull(value.experiment_id)) {
85
- errors.push("experiment_id: expected string|null when present");
86
- }
87
- if (value.candidate_id !== void 0 && !isStringOrNull(value.candidate_id)) {
88
- errors.push("candidate_id: expected string|null when present");
89
- }
77
+ if (!isStringOrNull(value.experiment_id)) errors.push("experiment_id: expected string|null");
78
+ if (!isStringOrNull(value.candidate_id)) errors.push("candidate_id: expected string|null");
90
79
  if (!isIntegerOrNull(value.generation)) errors.push("generation: expected integer|null");
91
80
  if (!isIntegerOrNull(value.candidate_index)) errors.push("candidate_index: expected integer|null");
92
81
  if (!ROLLOUT_ROLES.includes(value.role))
@@ -167,8 +156,8 @@ function validateRolloutLine(value) {
167
156
  );
168
157
  if (isRecord(value.outcome)) {
169
158
  if (!("verdict" in value.outcome)) errors.push("outcome.verdict: field required (may be null)");
170
- if (value.outcome.realness_gated !== void 0 && typeof value.outcome.realness_gated !== "boolean") {
171
- errors.push("outcome.realness_gated: expected boolean when present");
159
+ if (typeof value.outcome.realness_gated !== "boolean") {
160
+ errors.push("outcome.realness_gated: expected boolean");
172
161
  }
173
162
  }
174
163
  validateSection(
@@ -235,7 +224,6 @@ function isRolloutLine(value) {
235
224
 
236
225
  export {
237
226
  ROLLOUT_SCHEMA,
238
- ROLLOUT_FORMAT,
239
227
  ROLLOUT_ROLES,
240
228
  ROLLOUT_SPLITS,
241
229
  TRAINABLE_SPLITS,
@@ -246,4 +234,4 @@ export {
246
234
  assertRolloutLine,
247
235
  isRolloutLine
248
236
  };
249
- //# sourceMappingURL=chunk-MAX3TN3C.js.map
237
+ //# sourceMappingURL=chunk-UWZZKKU7.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/rollout/schema.ts"],"sourcesContent":["/**\n * `tangle.rollout.v1` — THE canonical rollout serialization, owned by\n * agent-eval. One JSONL line per agent invocation (a solo eval run, a\n * supervisor episode, a worker session, a proposer shot, a judge call, an\n * analyst pass), labeled with its task/split coordinates and a single\n * scalar reward, carrying the FULL message transcript inline.\n *\n * This schema is the reconciliation of two prior producers:\n * - agent-eval's RunRecord-joined rollout rows (PR #410): identity,\n * provenance hashes, the realness gate travelling into the reward,\n * trace-derived steps.\n * - the bench rollout-ledger (agent-runtime PR #591): the wire shape —\n * role, task.split/rep, parent_rollout_id, policy provenance, capture\n * provenance, inline canonical chat-with-tools messages.\n * Where the two conflicted, RunRecord-derived semantics won; the wire\n * field names follow the ledger (snake_case). See `docs/rollout.md` for\n * the field-by-field decision table.\n *\n * Messages are inlined — never referenced — because every harness store a\n * rollout can be recovered from is mutable or garbage-collected. A line\n * must stay a complete training/eval example on its own.\n *\n * `outcome.reward` is THE single scalar (null = no verdict exists — a\n * labeled gap, never 0). `outcome.realness_gated` is the anti-Goodhart\n * flag: a gated line must never export as a positive training example.\n */\n\nexport const ROLLOUT_SCHEMA = 'tangle.rollout.v1'\n\n/** `agent` = a solo evaluation run (no multi-agent topology). */\nexport type RolloutRole = 'agent' | 'supervisor' | 'worker' | 'proposer' | 'judge' | 'analyst'\nexport const ROLLOUT_ROLES: readonly RolloutRole[] = [\n 'agent',\n 'supervisor',\n 'worker',\n 'proposer',\n 'judge',\n 'analyst',\n]\n\n/** Split vocabulary follows `RunRecord.splitTag`, extended with `canary`. */\nexport type RolloutSplit = 'search' | 'dev' | 'holdout' | 'canary'\nexport const ROLLOUT_SPLITS: readonly RolloutSplit[] = ['search', 'dev', 'holdout', 'canary']\n/** Splits that may ship in training exports. Everything else is fail-closed excluded. */\nexport const TRAINABLE_SPLITS: readonly RolloutSplit[] = ['search']\n\nexport function isTrainableSplit(split: RolloutSplit): boolean {\n return TRAINABLE_SPLITS.includes(split)\n}\n\n/** 'mint' = joined live from RunRecord + trace by `mintRolloutRows`. */\nexport type RolloutCapture = 'mint' | 'settle-time' | 'backfill'\nexport const ROLLOUT_CAPTURES: readonly RolloutCapture[] = ['mint', 'settle-time', 'backfill']\n\n// ---------------------------------------------------------------------------\n// Canonical message format — OpenAI chat-with-tools, full fidelity.\n// ---------------------------------------------------------------------------\n\nexport type ChatRole = 'system' | 'user' | 'assistant' | 'tool'\nexport const CHAT_ROLES: readonly ChatRole[] = ['system', 'user', 'assistant', 'tool']\n\nexport interface ChatToolCall {\n id: string\n type: 'function'\n function: {\n name: string\n /** JSON-encoded argument object, exactly as the model emitted it. */\n arguments: string\n }\n}\n\nexport interface ChatMessage {\n role: ChatRole\n content: string | null\n /** Reasoning/thinking channel where the harness captured it (full fidelity). */\n reasoning_content?: string\n tool_calls?: ChatToolCall[]\n /** Required on role:\"tool\" — the ChatToolCall this result answers. */\n tool_call_id?: string\n name?: string\n}\n\nexport interface ToolDef {\n type: 'function'\n function: {\n name: string\n description?: string\n parameters?: Record<string, unknown>\n }\n}\n\n/**\n * Compact trace-span projection (llm/tool step) carried alongside the\n * conversation when the line was minted from a trace. Optional: lines\n * recovered from harness stores have no span structure.\n */\nexport interface RolloutStep {\n kind: string\n name: string\n /** llm: last-message summary · tool: stringified args. Scrubbed. */\n input?: string\n /** llm: output text · tool: stringified result. Scrubbed. */\n output?: string\n status?: 'ok' | 'error'\n durationMs?: number\n}\n\n// ---------------------------------------------------------------------------\n// Ledger line sections.\n// ---------------------------------------------------------------------------\n\nexport interface RolloutTask {\n /** Benchmark/suite id (e.g. \"swe-bench-verified\") or the experiment id. */\n suite: string\n instance_id: string\n split: RolloutSplit\n /** Sampling seed the campaign pinned; null = not recorded. */\n seed: number | null\n /** Replicate index (0-based). */\n rep: number\n}\n\nexport interface RolloutPolicy {\n /** Harness that drove the invocation (e.g. \"opencode\", \"claude\", \"pi-loops\"). */\n harness: string | null\n harness_version: string | null\n model: string | null\n provider: string | null\n /** Commit of the agent profile / candidate under evaluation. */\n profile_commit: string | null\n /** sha256 of the effective prompt (post-steering), when recorded. */\n prompt_hash?: string | null\n /** sha256 of the effective run config, when recorded. */\n config_hash?: string | null\n /** Canonical agent-profile cell identity, when the run carries one. */\n agent_profile_cell_id?: string | null\n /** Sampling params (temperature, top_p, max_tokens…); null = not recorded. */\n sampling: Record<string, unknown> | null\n}\n\nexport interface RolloutOutcome {\n /**\n * THE single scalar training signal — the official verdict.\n * null = no verdict exists for this invocation (a labeled gap, never 0).\n */\n reward: number | null\n /** Where the reward came from (judge id; \"/inherited\" = parent episode's). */\n reward_source: string | null\n /** Raw judge verdict record, verbatim. */\n verdict: unknown\n /** Everything that is NOT the scalar reward. */\n metrics: Record<string, unknown>\n is_completed: boolean\n is_truncated: boolean\n error: string | null\n /**\n * Anti-Goodhart flag from `RunRecord.outcome.realness.gated`: the run\n * faked its success signal. Reward is forced to 0 at mint time and the\n * line never qualifies for SFT.\n */\n realness_gated: boolean\n}\n\nexport interface RolloutCostBlock {\n usd: number | null\n tokens_in: number | null\n tokens_out: number | null\n tokens_reasoning: number | null\n cache_read: number | null\n cache_write: number | null\n wall_s: number | null\n}\n\nexport interface RolloutArtifacts {\n patch_path: string | null\n run_dir: string | null\n /** Source-of-truth transcript pointer (session id / jsonl path) for audit. */\n transcript_ref: string | null\n}\n\nexport interface RolloutProvenance {\n captured_at: string\n capture: RolloutCapture\n /** Present on gap lines: why `messages` could not be recovered. */\n gap?: string\n}\n\nexport interface RolloutLine {\n schema: typeof ROLLOUT_SCHEMA\n rollout_id: string\n /** Spawning invocation within the same episode (worker → supervisor). */\n parent_rollout_id: string | null\n run_id: string\n /** Logical experiment grouping from `RunRecord.experimentId`; null = not recorded. */\n experiment_id: string | null\n /** Stable candidate identity from `RunRecord.candidateId`; null = not recorded. */\n candidate_id: string | null\n /** Improvement-loop generation (-1 = baseline); null = not an improvement loop. */\n generation: number | null\n /** Improvement-loop candidate index (-1 = baseline); null = not an improvement loop. */\n candidate_index: number | null\n role: RolloutRole\n task: RolloutTask\n policy: RolloutPolicy\n /** Full transcript, inline. [] = gap line (see provenance.gap). */\n messages: ChatMessage[]\n tool_defs: ToolDef[]\n /** Trace-span projections, when minted from a trace. */\n steps?: RolloutStep[]\n outcome: RolloutOutcome\n cost: RolloutCostBlock\n artifacts: RolloutArtifacts\n provenance: RolloutProvenance\n}\n\n// ---------------------------------------------------------------------------\n// Validation — pure TS, no runtime schema dependency, mirroring the\n// run-record validator's fail-loud discipline. Returns [] when the value\n// is a valid RolloutLine; otherwise one dotted-path error per defect.\n// ---------------------------------------------------------------------------\n\nconst isRecord = (v: unknown): v is Record<string, unknown> =>\n typeof v === 'object' && v !== null && !Array.isArray(v)\n\nconst isNumberOrNull = (v: unknown): boolean => v === null || typeof v === 'number'\nconst isStringOrNull = (v: unknown): boolean => v === null || typeof v === 'string'\nconst isIntegerOrNull = (v: unknown): boolean => v === null || Number.isInteger(v)\n\nfunction validateChatMessage(value: unknown, path: string, errors: string[]): void {\n if (!isRecord(value)) {\n errors.push(`${path}: not an object`)\n return\n }\n if (!CHAT_ROLES.includes(value.role as ChatRole))\n errors.push(`${path}.role: invalid role ${String(value.role)}`)\n if (!isStringOrNull(value.content)) errors.push(`${path}.content: must be string|null`)\n if (value.reasoning_content !== undefined && typeof value.reasoning_content !== 'string') {\n errors.push(`${path}.reasoning_content: must be string when present`)\n }\n if (value.tool_call_id !== undefined && typeof value.tool_call_id !== 'string') {\n errors.push(`${path}.tool_call_id: must be string when present`)\n }\n if (value.role === 'tool' && typeof value.tool_call_id !== 'string') {\n errors.push(`${path}.tool_call_id: required on role:\"tool\"`)\n }\n if (value.tool_calls !== undefined) {\n if (!Array.isArray(value.tool_calls)) {\n errors.push(`${path}.tool_calls: must be an array when present`)\n } else {\n value.tool_calls.forEach((call, i) => {\n if (!isRecord(call) || typeof call.id !== 'string' || call.type !== 'function') {\n errors.push(`${path}.tool_calls[${i}]: must be {id, type:\"function\", function}`)\n return\n }\n const fn = call.function\n if (!isRecord(fn) || typeof fn.name !== 'string' || typeof fn.arguments !== 'string') {\n errors.push(\n `${path}.tool_calls[${i}].function: must be {name: string, arguments: string}`,\n )\n }\n })\n }\n }\n}\n\nfunction validateSection(\n value: unknown,\n path: string,\n fields: Array<[name: string, check: (v: unknown) => boolean, expect: string]>,\n errors: string[],\n): void {\n if (!isRecord(value)) {\n errors.push(`${path}: not an object`)\n return\n }\n for (const [name, check, expect] of fields) {\n if (!check(value[name])) errors.push(`${path}.${name}: expected ${expect}`)\n }\n}\n\nexport function validateRolloutLine(value: unknown): string[] {\n const errors: string[] = []\n if (!isRecord(value)) return ['line: not an object']\n\n if (value.schema !== ROLLOUT_SCHEMA) errors.push(`schema: expected \"${ROLLOUT_SCHEMA}\"`)\n if (typeof value.rollout_id !== 'string' || value.rollout_id.length === 0)\n errors.push('rollout_id: expected non-empty string')\n if (!isStringOrNull(value.parent_rollout_id))\n errors.push('parent_rollout_id: expected string|null')\n if (typeof value.run_id !== 'string' || value.run_id.length === 0)\n errors.push('run_id: expected non-empty string')\n if (!isStringOrNull(value.experiment_id)) errors.push('experiment_id: expected string|null')\n if (!isStringOrNull(value.candidate_id)) errors.push('candidate_id: expected string|null')\n if (!isIntegerOrNull(value.generation)) errors.push('generation: expected integer|null')\n if (!isIntegerOrNull(value.candidate_index)) errors.push('candidate_index: expected integer|null')\n if (!ROLLOUT_ROLES.includes(value.role as RolloutRole))\n errors.push(`role: invalid role ${String(value.role)}`)\n\n validateSection(\n value.task,\n 'task',\n [\n ['suite', (v) => typeof v === 'string' && v.length > 0, 'non-empty string'],\n ['instance_id', (v) => typeof v === 'string' && v.length > 0, 'non-empty string'],\n [\n 'split',\n (v) => ROLLOUT_SPLITS.includes(v as RolloutSplit),\n `one of ${ROLLOUT_SPLITS.join('|')}`,\n ],\n ['seed', isNumberOrNull, 'number|null'],\n ['rep', (v) => Number.isInteger(v), 'integer'],\n ],\n errors,\n )\n\n validateSection(\n value.policy,\n 'policy',\n [\n ['harness', isStringOrNull, 'string|null'],\n ['harness_version', isStringOrNull, 'string|null'],\n ['model', isStringOrNull, 'string|null'],\n ['provider', isStringOrNull, 'string|null'],\n ['profile_commit', isStringOrNull, 'string|null'],\n ['sampling', (v) => v === null || isRecord(v), 'object|null'],\n ],\n errors,\n )\n if (isRecord(value.policy)) {\n for (const key of ['prompt_hash', 'config_hash', 'agent_profile_cell_id'] as const) {\n if (value.policy[key] !== undefined && !isStringOrNull(value.policy[key])) {\n errors.push(`policy.${key}: expected string|null when present`)\n }\n }\n }\n\n if (!Array.isArray(value.messages)) {\n errors.push('messages: expected array')\n } else {\n for (const [i, m] of value.messages.entries()) validateChatMessage(m, `messages[${i}]`, errors)\n }\n\n if (!Array.isArray(value.tool_defs)) {\n errors.push('tool_defs: expected array')\n } else {\n value.tool_defs.forEach((d, i) => {\n if (\n !isRecord(d) ||\n d.type !== 'function' ||\n !isRecord(d.function) ||\n typeof d.function.name !== 'string'\n ) {\n errors.push(`tool_defs[${i}]: must be {type:\"function\", function:{name}}`)\n }\n })\n }\n\n if (value.steps !== undefined) {\n if (!Array.isArray(value.steps)) {\n errors.push('steps: expected array when present')\n } else {\n value.steps.forEach((s, i) => {\n if (!isRecord(s) || typeof s.kind !== 'string' || typeof s.name !== 'string') {\n errors.push(`steps[${i}]: must be {kind: string, name: string, …}`)\n }\n })\n }\n }\n\n validateSection(\n value.outcome,\n 'outcome',\n [\n ['reward', isNumberOrNull, 'number|null'],\n ['reward_source', isStringOrNull, 'string|null'],\n ['metrics', isRecord, 'object'],\n ['is_completed', (v) => typeof v === 'boolean', 'boolean'],\n ['is_truncated', (v) => typeof v === 'boolean', 'boolean'],\n ['error', isStringOrNull, 'string|null'],\n ],\n errors,\n )\n if (isRecord(value.outcome)) {\n if (!('verdict' in value.outcome)) errors.push('outcome.verdict: field required (may be null)')\n if (typeof value.outcome.realness_gated !== 'boolean') {\n errors.push('outcome.realness_gated: expected boolean')\n }\n }\n\n validateSection(\n value.cost,\n 'cost',\n [\n ['usd', isNumberOrNull, 'number|null'],\n ['tokens_in', isNumberOrNull, 'number|null'],\n ['tokens_out', isNumberOrNull, 'number|null'],\n ['tokens_reasoning', isNumberOrNull, 'number|null'],\n ['cache_read', isNumberOrNull, 'number|null'],\n ['cache_write', isNumberOrNull, 'number|null'],\n ['wall_s', isNumberOrNull, 'number|null'],\n ],\n errors,\n )\n\n validateSection(\n value.artifacts,\n 'artifacts',\n [\n ['patch_path', isStringOrNull, 'string|null'],\n ['run_dir', isStringOrNull, 'string|null'],\n ['transcript_ref', isStringOrNull, 'string|null'],\n ],\n errors,\n )\n\n validateSection(\n value.provenance,\n 'provenance',\n [\n [\n 'captured_at',\n (v) => typeof v === 'string' && !Number.isNaN(Date.parse(v)),\n 'ISO-8601 timestamp',\n ],\n [\n 'capture',\n (v) => ROLLOUT_CAPTURES.includes(v as RolloutCapture),\n `one of ${ROLLOUT_CAPTURES.join('|')}`,\n ],\n ],\n errors,\n )\n if (\n isRecord(value.provenance) &&\n value.provenance.gap !== undefined &&\n typeof value.provenance.gap !== 'string'\n ) {\n errors.push('provenance.gap: must be string when present')\n }\n\n // A gap line must say WHY it is a gap; a full line must not carry a gap note.\n if (Array.isArray(value.messages) && isRecord(value.provenance)) {\n if (value.messages.length === 0 && typeof value.provenance.gap !== 'string') {\n errors.push('provenance.gap: required when messages is empty')\n }\n }\n\n return errors\n}\n\nexport function assertRolloutLine(\n value: unknown,\n context = 'rollout line',\n): asserts value is RolloutLine {\n const errors = validateRolloutLine(value)\n if (errors.length > 0) {\n throw new Error(`invalid ${context}:\\n ${errors.join('\\n ')}`)\n }\n}\n\nexport function isRolloutLine(value: unknown): value is RolloutLine {\n return validateRolloutLine(value).length === 0\n}\n"],"mappings":"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","names":[]}
@@ -1,6 +1,9 @@
1
+ import {
2
+ projectCampaignCellQuality
3
+ } from "./chunk-ZPUEEM5U.js";
1
4
  import {
2
5
  confidenceInterval
3
- } from "./chunk-PJQFMIOX.js";
6
+ } from "./chunk-MHELPNRP.js";
4
7
  import {
5
8
  CostAccountingIncompleteError,
6
9
  CostLedger
@@ -50,10 +53,10 @@ function summarizeBackendUsage(records) {
50
53
  for (const rec of records) {
51
54
  totalInputTokens += rec.inputTokens;
52
55
  totalOutputTokens += rec.outputTokens;
53
- totalCostUsd += rec.costUsd;
56
+ totalCostUsd += rec.costUsd ?? 0;
54
57
  if (rec.inputTokens === 0 && rec.outputTokens === 0) stubRecords++;
55
58
  else realRecords++;
56
- if (rec.outputTokens > 0 && rec.costUsd === 0) uncostedRecords++;
59
+ if (rec.outputTokens > 0 && (rec.costUsd === null || rec.costUsd === 0)) uncostedRecords++;
57
60
  }
58
61
  const verdict = totalRecords === 0 ? "stub" : stubRecords === totalRecords ? "stub" : stubRecords === 0 ? "real" : "mixed";
59
62
  const diagnosis = buildDiagnosis({
@@ -352,6 +355,12 @@ function campaignCoverage(cells, scenarios, reps, requireJudgeScore) {
352
355
  if (scoreEntries.some(([, score]) => score.failed === true)) {
353
356
  reasons.push("judge score marked failed");
354
357
  }
358
+ const failedPanelJudges = [
359
+ ...new Set(scoreEntries.flatMap(([, score]) => score.failedJudges ?? []))
360
+ ].sort();
361
+ if (failedPanelJudges.length > 0) {
362
+ reasons.push(`judge panel incomplete: ${failedPanelJudges.join(", ")}`);
363
+ }
355
364
  if (nonFiniteScores.length > 0) {
356
365
  reasons.push(
357
366
  `non-finite judge score: ${nonFiniteScores.map(([name]) => name).sort().join(", ")}`
@@ -1154,6 +1163,8 @@ async function executeCell(args) {
1154
1163
  durationMs: Date.now() - startMs,
1155
1164
  seed: args.slot.cellSeed,
1156
1165
  cached: false,
1166
+ ...failure ? { errorStage: failure.stage } : {},
1167
+ ...failure?.judge ? { errorJudge: failure.judge } : {},
1157
1168
  error: errorMessage
1158
1169
  };
1159
1170
  if (failure) {
@@ -1455,43 +1466,56 @@ function judgeVersionFor(judge) {
1455
1466
  });
1456
1467
  }
1457
1468
  function computeAggregates(cells, judges, seed, cost) {
1469
+ const cellQuality = cells.map((cell) => ({
1470
+ cell,
1471
+ quality: projectCampaignCellQuality(cell)
1472
+ }));
1458
1473
  const byJudge = {};
1459
1474
  for (const judge of judges) {
1460
1475
  const scores = [];
1461
- for (const cell of cells) {
1462
- const s = cell.judgeScores[judge.name];
1476
+ for (const { quality } of cellQuality) {
1477
+ const s = quality.successfulJudgeScores[judge.name];
1463
1478
  if (s !== void 0) scores.push(s.composite);
1464
1479
  }
1465
- byJudge[judge.name] = aggregate(scores, seed);
1480
+ if (scores.length > 0) byJudge[judge.name] = aggregate(scores, seed);
1466
1481
  }
1467
1482
  const byScenario = {};
1468
1483
  const scenarioGroups = /* @__PURE__ */ new Map();
1469
- for (const cell of cells) {
1470
- const composites = Object.values(cell.judgeScores).map((s) => s.composite);
1471
- if (composites.length === 0) continue;
1472
- const mean = composites.reduce((a, b) => a + b, 0) / composites.length;
1484
+ for (const { cell, quality } of cellQuality) {
1485
+ const score = quality.score;
1486
+ if (score === void 0) continue;
1473
1487
  const arr = scenarioGroups.get(cell.scenarioId) ?? [];
1474
- arr.push(mean);
1488
+ arr.push(score);
1475
1489
  scenarioGroups.set(cell.scenarioId, arr);
1476
1490
  }
1477
1491
  for (const [scenarioId, samples] of scenarioGroups) {
1478
1492
  const ag = aggregate(samples, seed);
1479
1493
  byScenario[scenarioId] = { meanComposite: ag.mean, ci95: ag.ci95, n: ag.n };
1480
1494
  }
1495
+ const dispatchFailures = cells.filter((cell) => cell.errorStage === "dispatch");
1496
+ const judgeFailures = cellQuality.filter(({ cell, quality }) => cell.errorStage === "judge" || quality.failedJudges.length > 0).map(({ cell }) => cell);
1497
+ const unclassifiedFailures = cells.filter(
1498
+ (cell) => Boolean(cell.error) && !cell.error?.startsWith("skipped:") && cell.errorStage === void 0
1499
+ );
1481
1500
  return {
1482
1501
  byJudge,
1483
1502
  byScenario,
1484
1503
  cost,
1485
1504
  totalCostUsd: cost.totalCostUsd,
1486
- cellsExecuted: cells.filter((c) => !c.error).length,
1505
+ cellsExecuted: cells.filter(
1506
+ (cell) => !cell.error?.startsWith("skipped:") && cell.errorStage !== "dispatch" && !(cell.error && cell.errorStage === void 0)
1507
+ ).length,
1487
1508
  cellsSkipped: cells.filter((c) => c.error?.startsWith("skipped:")).length,
1488
1509
  cellsCached: cells.filter((c) => c.cached).length,
1489
- cellsFailed: cells.filter((c) => c.error && !c.error.startsWith("skipped:")).length
1510
+ cellsFailed: (/* @__PURE__ */ new Set([...dispatchFailures, ...judgeFailures, ...unclassifiedFailures])).size,
1511
+ cellsDispatchFailed: dispatchFailures.length,
1512
+ cellsJudgeFailed: judgeFailures.length,
1513
+ cellsUnclassifiedFailed: unclassifiedFailures.length
1490
1514
  };
1491
1515
  }
1492
1516
  function aggregate(samples, seed) {
1493
1517
  const n = samples.length;
1494
- if (n === 0) return { mean: 0, stdev: 0, ci95: [0, 0], n: 0 };
1518
+ if (n === 0) throw new Error("aggregate requires at least one finite score");
1495
1519
  const mean = samples.reduce((a, b) => a + b, 0) / n;
1496
1520
  const variance = samples.reduce((a, b) => a + (b - mean) ** 2, 0) / Math.max(1, n - 1);
1497
1521
  const stdev = Math.sqrt(variance);
@@ -1532,4 +1556,4 @@ export {
1532
1556
  runCampaign,
1533
1557
  planCampaignRun
1534
1558
  };
1535
- //# sourceMappingURL=chunk-ZVCHKKOP.js.map
1559
+ //# sourceMappingURL=chunk-WED5KLZQ.js.map