@tangle-network/agent-eval 0.137.0 → 0.139.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 (172) hide show
  1. package/CHANGELOG.md +78 -0
  2. package/README.md +34 -0
  3. package/dist/analyst/index.d.ts +485 -104
  4. package/dist/analyst/index.d.ts.map +1 -1
  5. package/dist/analyst/index.js +10 -607
  6. package/dist/analyst/index.js.map +1 -1
  7. package/dist/{benchmark-YDrpumqB.js → benchmark-CYtcIF2V.js} +299 -159
  8. package/dist/benchmark-CYtcIF2V.js.map +1 -0
  9. package/dist/{benchmark-CHX4orG7.d.ts → benchmark-DDVdWcwA.d.ts} +67 -15
  10. package/dist/benchmark-DDVdWcwA.d.ts.map +1 -0
  11. package/dist/benchmark-command-BKfjOBJ5.js +4537 -0
  12. package/dist/benchmark-command-BKfjOBJ5.js.map +1 -0
  13. package/dist/benchmarks/index.d.ts +1 -1
  14. package/dist/benchmarks/index.js +1 -1
  15. package/dist/{benchmarks-DCLkQOmc.js → benchmarks-zxhy1QV3.js} +4 -3
  16. package/dist/{benchmarks-DCLkQOmc.js.map → benchmarks-zxhy1QV3.js.map} +1 -1
  17. package/dist/campaign/index.d.ts +5 -5
  18. package/dist/campaign/index.js +4 -3
  19. package/dist/{campaign-lgObcHFC.js → campaign-DrS6_hLd.js} +19 -11
  20. package/dist/campaign-DrS6_hLd.js.map +1 -0
  21. package/dist/canonical-D011XM8r.js +86 -0
  22. package/dist/canonical-D011XM8r.js.map +1 -0
  23. package/dist/cli.js +10 -3
  24. package/dist/cli.js.map +1 -1
  25. package/dist/{client-C8L6h6Wf.d.ts → client-BohnDFBq.d.ts} +4 -4
  26. package/dist/{client-C8L6h6Wf.d.ts.map → client-BohnDFBq.d.ts.map} +1 -1
  27. package/dist/{completion-verifier-DSyRNVzU.d.ts → completion-verifier-IPoP4fQO.d.ts} +178 -4
  28. package/dist/completion-verifier-IPoP4fQO.d.ts.map +1 -0
  29. package/dist/contract/index.d.ts +10 -10
  30. package/dist/contract/index.js +9 -8
  31. package/dist/contract/index.js.map +1 -1
  32. package/dist/control.d.ts +2 -2
  33. package/dist/{cost-ledger-D-5_-dhi.js → cost-ledger-CZ9diLxY.js} +90 -45
  34. package/dist/cost-ledger-CZ9diLxY.js.map +1 -0
  35. package/dist/{cost-ledger-D2o6JOrL.d.ts → cost-ledger-DKgyIWRj.d.ts} +6 -2
  36. package/dist/cost-ledger-DKgyIWRj.d.ts.map +1 -0
  37. package/dist/default-registry-B8vf7Rmf.d.ts +118 -0
  38. package/dist/default-registry-B8vf7Rmf.d.ts.map +1 -0
  39. package/dist/default-registry-BgJJItGr.js +2364 -0
  40. package/dist/default-registry-BgJJItGr.js.map +1 -0
  41. package/dist/dspy-rlm-engine-DTkVyDX-.js +344 -0
  42. package/dist/dspy-rlm-engine-DTkVyDX-.js.map +1 -0
  43. package/dist/{eval-campaign-CHqfLnff.js → eval-campaign-BmptJj50.js} +2 -2
  44. package/dist/{eval-campaign-CHqfLnff.js.map → eval-campaign-BmptJj50.js.map} +1 -1
  45. package/dist/exact-types-MaaFcllV.d.ts +234 -0
  46. package/dist/exact-types-MaaFcllV.d.ts.map +1 -0
  47. package/dist/external-optimizer-contracts-BrxY2Sli.d.ts +32 -0
  48. package/dist/external-optimizer-contracts-BrxY2Sli.d.ts.map +1 -0
  49. package/dist/{extract-usage-p-56bh8q.js → extract-usage-DZs601Va.js} +2 -2
  50. package/dist/{extract-usage-p-56bh8q.js.map → extract-usage-DZs601Va.js.map} +1 -1
  51. package/dist/{feedback-trajectory-N_F0PwHz.d.ts → feedback-trajectory-BJUWOkJM.d.ts} +3 -2
  52. package/dist/feedback-trajectory-BJUWOkJM.d.ts.map +1 -0
  53. package/dist/fuzz.d.ts +1 -1
  54. package/dist/fuzz.js +1 -1
  55. package/dist/{hf-dataset-DBJXXoY1.js → hf-dataset-XggBupCr.js} +2 -2
  56. package/dist/{hf-dataset-DBJXXoY1.js.map → hf-dataset-XggBupCr.js.map} +1 -1
  57. package/dist/hosted/index.d.ts +3 -3
  58. package/dist/{index-C-Pr4OWg.d.ts → index-BTm_P9aC.d.ts} +12 -11
  59. package/dist/index-BTm_P9aC.d.ts.map +1 -0
  60. package/dist/{index-U3RHOShi.d.ts → index-CWOPCJiw.d.ts} +2 -2
  61. package/dist/{index-U3RHOShi.d.ts.map → index-CWOPCJiw.d.ts.map} +1 -1
  62. package/dist/{index-DRNl6g_N.d.ts → index-CtR1xh4V.d.ts} +3 -3
  63. package/dist/{index-DRNl6g_N.d.ts.map → index-CtR1xh4V.d.ts.map} +1 -1
  64. package/dist/index-DEb46kc6.d.ts.map +1 -1
  65. package/dist/{index-BnP1QJUv.d.ts → index-_66rVpwN.d.ts} +5 -5
  66. package/dist/{index-BnP1QJUv.d.ts.map → index-_66rVpwN.d.ts.map} +1 -1
  67. package/dist/index.d.ts +35 -55
  68. package/dist/index.d.ts.map +1 -1
  69. package/dist/index.js +55 -514
  70. package/dist/index.js.map +1 -1
  71. package/dist/{insight-report-B9ooYH_g.d.ts → insight-report-Bu5Wi9tG.d.ts} +4 -4
  72. package/dist/{insight-report-B9ooYH_g.d.ts.map → insight-report-Bu5Wi9tG.d.ts.map} +1 -1
  73. package/dist/{integrity-CKxosZ5Z.d.ts → integrity-COTh3DTH.d.ts} +2 -2
  74. package/dist/{integrity-CKxosZ5Z.d.ts.map → integrity-COTh3DTH.d.ts.map} +1 -1
  75. package/dist/kind-factory-CFxA0JQX.js +2133 -0
  76. package/dist/kind-factory-CFxA0JQX.js.map +1 -0
  77. package/dist/ledger-core/index.js +2 -1
  78. package/dist/{ledger-core-t6sItivm.js → ledger-core-Dxz0Rkwa.js} +210 -99
  79. package/dist/ledger-core-Dxz0Rkwa.js.map +1 -0
  80. package/dist/{llm-client-DKB25jV8.js → llm-client-bkztEfIx.js} +5 -5
  81. package/dist/llm-client-bkztEfIx.js.map +1 -0
  82. package/dist/meta-eval/index.d.ts +2 -2
  83. package/dist/multishot/index.d.ts +2 -2
  84. package/dist/openapi.json +1 -1
  85. package/dist/{proposal-findings-DCawte-y.js → proposal-findings-2GIUo1et.js} +2 -68
  86. package/dist/proposal-findings-2GIUo1et.js.map +1 -0
  87. package/dist/{release-report-CofgVNZt.d.ts → release-report-fZarvIm-.d.ts} +3 -3
  88. package/dist/{release-report-CofgVNZt.d.ts.map → release-report-fZarvIm-.d.ts.map} +1 -1
  89. package/dist/{replay-K8FaC0CB.d.ts → replay-DjG4IG60.d.ts} +34 -143
  90. package/dist/replay-DjG4IG60.d.ts.map +1 -0
  91. package/dist/{replay-Bju0T8Ls.js → replay-SA4OB7O7.js} +48 -136
  92. package/dist/replay-SA4OB7O7.js.map +1 -0
  93. package/dist/reporting.d.ts +4 -4
  94. package/dist/{researcher-Da0Wj-bt.d.ts → researcher-BxhtGfKa.d.ts} +5 -5
  95. package/dist/{researcher-Da0Wj-bt.d.ts.map → researcher-BxhtGfKa.d.ts.map} +1 -1
  96. package/dist/{reward-hacking-CQ3hTCO3.d.ts → reward-hacking-CqSLiV51.d.ts} +2 -2
  97. package/dist/{reward-hacking-CQ3hTCO3.d.ts.map → reward-hacking-CqSLiV51.d.ts.map} +1 -1
  98. package/dist/rl.d.ts +5 -5
  99. package/dist/rl.js +1 -1
  100. package/dist/rollout/index.d.ts +1 -1
  101. package/dist/rollout/index.js +2 -2
  102. package/dist/{rollout-DQFl0UXA.js → rollout-8nj3mYvx.js} +2 -2
  103. package/dist/{rollout-DQFl0UXA.js.map → rollout-8nj3mYvx.js.map} +1 -1
  104. package/dist/{rubric-predictive-validity-C4sztLR3.d.ts → rubric-predictive-validity-DQBQj6uV.d.ts} +2 -2
  105. package/dist/{rubric-predictive-validity-C4sztLR3.d.ts.map → rubric-predictive-validity-DQBQj6uV.d.ts.map} +1 -1
  106. package/dist/{run-evidence-BDIircdA.d.ts → run-evidence-C4RcRQT5.d.ts} +3 -3
  107. package/dist/{run-evidence-BDIircdA.d.ts.map → run-evidence-C4RcRQT5.d.ts.map} +1 -1
  108. package/dist/{run-record-BPCa2rQ8.d.ts → run-record-CztDMXVF.d.ts} +2 -2
  109. package/dist/{run-record-BPCa2rQ8.d.ts.map → run-record-CztDMXVF.d.ts.map} +1 -1
  110. package/dist/{semantic-concept-judge-Bz64IckK.js → semantic-concept-judge-BuIJ9IfB.js} +49 -6
  111. package/dist/semantic-concept-judge-BuIJ9IfB.js.map +1 -0
  112. package/dist/{server-KjXZZUDX.js → server-DaCpLfi0.js} +3 -3
  113. package/dist/{server-KjXZZUDX.js.map → server-DaCpLfi0.js.map} +1 -1
  114. package/dist/single-run-lock-BTTtPZ9N.js +989 -0
  115. package/dist/single-run-lock-BTTtPZ9N.js.map +1 -0
  116. package/dist/{skill-usage-CFDLLlhF.d.ts → skill-usage-B-BFS8M2.d.ts} +65 -40
  117. package/dist/skill-usage-B-BFS8M2.d.ts.map +1 -0
  118. package/dist/{skillopt-optimization-method-f4o9sUT4.js → skillopt-optimization-method-BbGnCC53.js} +20 -979
  119. package/dist/skillopt-optimization-method-BbGnCC53.js.map +1 -0
  120. package/dist/{skillopt-optimization-method-BpbnlvAZ.d.ts → skillopt-optimization-method-_s0Tub7Y.d.ts} +11 -39
  121. package/dist/skillopt-optimization-method-_s0Tub7Y.d.ts.map +1 -0
  122. package/dist/{statistics-_7P642CN.d.ts → statistics-B5d0Zd-z.d.ts} +2 -2
  123. package/dist/{statistics-_7P642CN.d.ts.map → statistics-B5d0Zd-z.d.ts.map} +1 -1
  124. package/dist/store-otlp-DX4fGIcf.js +757 -0
  125. package/dist/store-otlp-DX4fGIcf.js.map +1 -0
  126. package/dist/{summary-report-DHipz9Kx.d.ts → summary-report-Cg7BifAM.d.ts} +3 -3
  127. package/dist/{summary-report-DHipz9Kx.d.ts.map → summary-report-Cg7BifAM.d.ts.map} +1 -1
  128. package/dist/tool-groups-CdYq22lX.d.ts +258 -0
  129. package/dist/tool-groups-CdYq22lX.d.ts.map +1 -0
  130. package/dist/traces.d.ts +7 -6
  131. package/dist/traces.js +5 -4
  132. package/dist/{types-CTGbIm57.d.ts → types-BBFNHxSK.d.ts} +5 -5
  133. package/dist/{types-CTGbIm57.d.ts.map → types-BBFNHxSK.d.ts.map} +1 -1
  134. package/dist/{types-CKswbJGO.d.ts → types-DoEYskCd.d.ts} +5 -5
  135. package/dist/{types-CKswbJGO.d.ts.map → types-DoEYskCd.d.ts.map} +1 -1
  136. package/dist/{types-CTvKfr5F.d.ts → types-uPrS6mD-.d.ts} +2 -2
  137. package/dist/{types-CTvKfr5F.d.ts.map → types-uPrS6mD-.d.ts.map} +1 -1
  138. package/dist/usage-receipt-CgxMEBZq.js +134 -0
  139. package/dist/usage-receipt-CgxMEBZq.js.map +1 -0
  140. package/dist/wire/index.d.ts +3 -3
  141. package/dist/wire/index.js +1 -1
  142. package/docs/trace-analysis.md +191 -385
  143. package/package.json +5 -4
  144. package/dist/analyze-runs-PVtnfjvA.d.ts +0 -72
  145. package/dist/analyze-runs-PVtnfjvA.d.ts.map +0 -1
  146. package/dist/benchmark-CHX4orG7.d.ts.map +0 -1
  147. package/dist/benchmark-YDrpumqB.js.map +0 -1
  148. package/dist/campaign-lgObcHFC.js.map +0 -1
  149. package/dist/completion-verifier-DSyRNVzU.d.ts.map +0 -1
  150. package/dist/concurrency-MUjT7VjM.js +0 -109
  151. package/dist/concurrency-MUjT7VjM.js.map +0 -1
  152. package/dist/cost-ledger-D-5_-dhi.js.map +0 -1
  153. package/dist/cost-ledger-D2o6JOrL.d.ts.map +0 -1
  154. package/dist/default-registry-CLXbRt0f.js +0 -2594
  155. package/dist/default-registry-CLXbRt0f.js.map +0 -1
  156. package/dist/default-registry-Dc5D_Loc.d.ts +0 -202
  157. package/dist/default-registry-Dc5D_Loc.d.ts.map +0 -1
  158. package/dist/feedback-trajectory-N_F0PwHz.d.ts.map +0 -1
  159. package/dist/index-C-Pr4OWg.d.ts.map +0 -1
  160. package/dist/ledger-core-t6sItivm.js.map +0 -1
  161. package/dist/llm-client-DKB25jV8.js.map +0 -1
  162. package/dist/proposal-findings-DCawte-y.js.map +0 -1
  163. package/dist/registry-BdM7SuTr.d.ts +0 -124
  164. package/dist/registry-BdM7SuTr.d.ts.map +0 -1
  165. package/dist/replay-Bju0T8Ls.js.map +0 -1
  166. package/dist/replay-K8FaC0CB.d.ts.map +0 -1
  167. package/dist/semantic-concept-judge-Bz64IckK.js.map +0 -1
  168. package/dist/skill-usage-CFDLLlhF.d.ts.map +0 -1
  169. package/dist/skillopt-optimization-method-BpbnlvAZ.d.ts.map +0 -1
  170. package/dist/skillopt-optimization-method-f4o9sUT4.js.map +0 -1
  171. package/dist/tools-DZk2Jn64.js +0 -1876
  172. package/dist/tools-DZk2Jn64.js.map +0 -1
@@ -1,12 +1,14 @@
1
1
  import { a as MultiLayerVerifier, l as VerifyOptions, o as Severity } from "../multi-layer-verifier-BHY1gWAc.js";
2
- import { A as parseFindingSubject, B as SemanticConceptJudgeInput, C as FINDING_SUBJECT_KINDS, D as FindingSubjectStringSchema, E as FindingSubjectKind, G as RunCritic, M as CreateAnalystAiConfig, N as createAnalystAi, O as KIND_EXPECTED_SUBJECTS, S as FINDING_SUBJECT_GRAMMAR_PROMPT, T as FindingSubject, V as SemanticConceptJudgeOptions, _ as FindingsDiff, a as SkillUsageScanConfig, b as defaultIsMaterial, c as DEFAULT_TRACE_ANALYST_KINDS, d as IMPROVEMENT_KIND_SPEC, f as FAILURE_MODE_KIND_SPEC, g as DiffPolicy, h as emitControlIntegrityFindings, i as SkillUsageReport, j as renderFindingSubject, k as findingSubjectGrammarPromptFor, l as KNOWLEDGE_POISONING_KIND_SPEC, m as ControlIntegrityAnalyst, n as SkillUsageAnalyst, o as buildSkillUsageReport, p as CONTROL_INTEGRITY_ANALYST, q as RunTrace, r as SkillUsageRecord, s as emitSkillUsageFindings, t as SKILL_USAGE_ANALYST, u as KNOWLEDGE_GAP_KIND_SPEC, v as FindingsStore, w as FINDING_SUBJECT_SYNTAX, x as diffFindings, y as PersistedFinding } from "../skill-usage-CFDLLlhF.js";
3
- import { c as CostLedgerHandle } from "../cost-ledger-D2o6JOrL.js";
4
- import { A as ChatClient, B as SandboxSdkTransportOpts, F as CreateChatClientOpts, I as CustomTransportOpts, L as DirectProviderTransportOpts, M as ChatResponse, N as ChatTransport, P as CliBridgeTransportOpts, R as MockTransportOpts, V as createChatClient, j as ChatRequest, k as ChatCallOpts, m as JudgeInput, p as JudgeFn, q as LlmClientOptions, z as RouterTransportOpts } from "../types-CTvKfr5F.js";
5
- import { _ as makeFinding, a as AnalystInputKind, c as AnalystRunInputs, d as AnalystSeverity, f as AnalystUsageReceipt, g as computeFindingId, h as ProposalFindingOrigin, i as AnalystFinding, l as AnalystRunResult, m as ProposalFinding, n as AnalystContext, o as AnalystRequirements, p as EvidenceRef, r as AnalystCost, s as AnalystRunEvent, t as Analyst, u as AnalystRunSummary, v as makeProposalFinding, x as TraceAnalysisStore } from "../types-CKswbJGO.js";
6
- import { _ as behavioralAnalyst, a as createTraceAnalystKind, c as ANALYST_SEVERITIES, d as RawAnalystEvidenceSchema, f as RawAnalystFinding, g as BehavioralAnalystOptions, h as parseRawFinding, i as TraceAnalystKindSpec, l as RAW_FINDING_SCHEMA_PROMPT, m as evidenceRefsFromRawFinding, n as buildDefaultAnalystRegistry, o as renderPriorFindings, p as RawAnalystFindingSchema, r as CreateTraceAnalystKindOpts, s as renderUpstreamFindings, t as DefaultAnalystRegistryOptions, u as RawAnalystEvidence, v as deriveEfficiencyFindings } from "../default-registry-Dc5D_Loc.js";
7
- import { a as RegistryRunOpts, i as BudgetPolicy, n as AnalystRegistry, r as AnalystRegistryOptions, t as AnalystHooks } from "../registry-BdM7SuTr.js";
8
- import { _ as RunAnalystBenchmarkOptions, a as AnalystBenchmarkOutput, b as scoreAnalystFindings, c as AnalystBenchmarkRunner, d as AnalystEvidenceResolution, f as AnalystEvidenceResolutionError, g as AnalystLatencyDistribution, h as AnalystIssueExpectation, i as AnalystBenchmarkObservation, l as AnalystBenchmarkSummary, m as AnalystFindingScore, n as AnalystBenchmarkDatasetRef, o as AnalystBenchmarkProvenance, p as AnalystEvidenceResolver, r as AnalystBenchmarkDescriptor, s as AnalystBenchmarkResult, t as AnalystBenchmarkCase, u as AnalystEvidenceExpectation, v as registryBenchmarkRunner, x as traceStoreEvidenceResolver, y as runAnalystBenchmark } from "../benchmark-CHX4orG7.js";
9
- import { AxFunction } from "@ax-llm/ax";
2
+ import { A as parseFindingSubject, C as FINDING_SUBJECT_KINDS, D as FindingSubjectStringSchema, E as FindingSubjectKind, F as DefineExactCustomAnalystOptions, G as SemanticConceptJudgeOptions, I as defineCustomAnalyst, L as defineTraceAnalyst, M as DspyRlmTraceEngineOptions, N as createDspyRlmTraceEngine, O as KIND_EXPECTED_SUBJECTS, P as DefineCustomAnalystOptions, S as FINDING_SUBJECT_GRAMMAR_PROMPT, T as FindingSubject, W as SemanticConceptJudgeInput, Y as RunCritic, Z as RunTrace, _ as FindingsDiff, a as SkillUsageScanConfig, b as defaultIsMaterial, c as DEFAULT_TRACE_ANALYST_KINDS, d as IMPROVEMENT_KIND_SPEC, f as FAILURE_MODE_KIND_SPEC, g as DiffPolicy, h as emitControlIntegrityFindings, i as SkillUsageReport, j as renderFindingSubject, k as findingSubjectGrammarPromptFor, l as KNOWLEDGE_POISONING_KIND_SPEC, m as ControlIntegrityAnalyst, n as SkillUsageAnalyst, o as buildSkillUsageReport, p as CONTROL_INTEGRITY_ANALYST, r as SkillUsageRecord, s as emitSkillUsageFindings, t as SKILL_USAGE_ANALYST, u as KNOWLEDGE_GAP_KIND_SPEC, v as FindingsStore, w as FINDING_SUBJECT_SYNTAX, x as diffFindings, y as PersistedFinding } from "../skill-usage-B-BFS8M2.js";
3
+ import { b as CustomTokenPricing, c as CostLedgerHandle } from "../cost-ledger-DKgyIWRj.js";
4
+ import { A as ChatClient, B as SandboxSdkTransportOpts, F as CreateChatClientOpts, I as CustomTransportOpts, L as DirectProviderTransportOpts, M as ChatResponse, N as ChatTransport, P as CliBridgeTransportOpts, R as MockTransportOpts, V as createChatClient, j as ChatRequest, k as ChatCallOpts, m as JudgeInput, p as JudgeFn, z as RouterTransportOpts } from "../types-uPrS6mD-.js";
5
+ import { _ as makeFinding, a as AnalystInputKind, c as AnalystRunInputs, d as AnalystSeverity, f as AnalystUsageReceipt, g as computeFindingId, h as ProposalFindingOrigin, i as AnalystFinding, l as AnalystRunResult, m as ProposalFinding, n as AnalystContext, o as AnalystRequirements, p as EvidenceRef, r as AnalystCost, s as AnalystRunEvent, t as Analyst, u as AnalystRunSummary, v as makeProposalFinding } from "../types-DoEYskCd.js";
6
+ import { a as createTraceAnalyst, c as runTraceAnalyst, d as deriveEfficiencyFindings, i as TraceAnalystDefinition, l as BehavioralAnalystOptions, n as buildDefaultAnalystRegistry, o as renderPriorFindings, r as CreateTraceAnalystOptions, s as renderUpstreamFindings, t as DefaultAnalystRegistryOptions, u as behavioralAnalyst } from "../default-registry-B8vf7Rmf.js";
7
+ import { a as ExactAnalystRunPolicySnapshot, c as ExactAnalystSnapshot, d as ExactExecutionComponentSnapshot, i as ExactAnalystRunEvent, l as ExactCapableAnalyst, n as ExactAnalystExecutionPlanSnapshot, o as ExactAnalystRunResult, r as ExactAnalystRunCompletion, s as ExactAnalystRunSummary, t as ExactAnalystBudgetSnapshot, u as ExactExecutionComponentIdentity } from "../exact-types-MaaFcllV.js";
8
+ import { A as ExactAnalystRunExecutionError, D as AnalystRegistryOptions, E as AnalystRegistry, M as RegistryRunOpts, N as assertExactRegistryRunOpts, O as BudgetPolicy, T as AnalystHooks, j as ExactRegistryRunOpts, k as ExactAnalystBudgetPolicy } from "../completion-verifier-IPoP4fQO.js";
9
+ import { C as scoreAnalystFindings, S as traceStoreEvidenceResolver, _ as AnalystIssueExpectation, a as AnalystBenchmarkLabelState, b as registryBenchmarkRunner, c as AnalystBenchmarkProvenance, d as AnalystBenchmarkSummary, f as AnalystEvidenceExpectation, g as AnalystFindingScore, h as AnalystEvidenceResolver, i as AnalystBenchmarkError, l as AnalystBenchmarkResult, m as AnalystEvidenceResolutionError, n as AnalystBenchmarkDatasetRef, o as AnalystBenchmarkObservation, p as AnalystEvidenceResolution, r as AnalystBenchmarkDescriptor, s as AnalystBenchmarkOutput, t as AnalystBenchmarkCase, u as AnalystBenchmarkRunner, v as AnalystLatencyDistribution, x as runAnalystBenchmark, y as RunAnalystBenchmarkOptions } from "../benchmark-DDVdWcwA.js";
10
+ import { r as ExternalOptimizerRunnerCommand } from "../external-optimizer-contracts-BrxY2Sli.js";
11
+ import { a as TraceAnalysisEngineRequest, c as resolveTraceAnalystLimits, d as RawAnalystEvidence, f as RawAnalystEvidenceSchema, g as parseRawFinding, h as evidenceRefsFromRawFinding, i as TraceAnalysisEngine, l as ANALYST_SEVERITIES, m as RawAnalystFindingSchema, n as buildTraceToolsForGroup, o as TraceAnalysisEngineResult, p as RawAnalystFinding, r as DEFAULT_TRACE_ANALYST_LIMITS, s as TraceAnalystLimits, t as TraceToolGroupName, u as RAW_FINDING_SCHEMA_PROMPT } from "../tool-groups-CdYq22lX.js";
10
12
  //#region src/analyst/adapters.d.ts
11
13
  declare function liftSeverity(s: Severity): AnalystSeverity;
12
14
  interface VerifierAdapterOpts<Env> {
@@ -50,36 +52,40 @@ interface SemanticConceptJudgeAdapterOpts {
50
52
  }
51
53
  declare function createSemanticConceptJudgeAdapter(opts?: SemanticConceptJudgeAdapterOpts): Analyst<SemanticConceptJudgeInput>;
52
54
  //#endregion
53
- //#region src/analyst/benchmark-comparison.d.ts
54
- type AnalystComparisonMetric = 'completion' | 'issueRecall' | 'findingPrecision' | 'f1' | 'criticalStepAccuracy' | 'citationCoverage' | 'citationLabelAgreement' | 'citationResolution' | 'cleanAccuracy' | 'latencyMs' | 'calls' | 'inputTokens' | 'outputTokens' | 'reasoningTokens' | 'cachedTokens' | 'cacheWriteTokens' | 'costUsd';
55
- interface AnalystMetricComparison {
56
- metric: AnalystComparisonMetric;
57
- direction: 'higher' | 'lower';
58
- pairedCases: number;
59
- pairedObservations: number;
60
- baselineMean: number;
61
- candidateMean: number;
62
- meanDelta: number;
63
- intervalLow: number;
64
- intervalHigh: number;
65
- confidence: number;
66
- resamples: number;
67
- enoughCasesForInference: boolean;
55
+ //#region src/analyst/benchmark-agentrx-calibration.d.ts
56
+ declare const AGENT_RX_UPSTREAM_REVISION = "f228165bfec60a801fd5fedd9d8ffe0f9de0c69d";
57
+ interface AgentRxCalibrationRunnerSummary {
58
+ runnerId: string;
59
+ selectedRuns: number;
60
+ completedRuns: number;
61
+ failedRuns: number;
62
+ predictedRuns: number;
63
+ missingPredictionRuns: number;
64
+ exactStepAccuracy: number | null;
65
+ stepAccuracyWithin1: number | null;
66
+ stepAccuracyWithin2: number | null;
67
+ stepAccuracyWithin3: number | null;
68
+ stepAccuracyWithin4: number | null;
69
+ stepAccuracyWithin5: number | null;
70
+ meanStepDistance: number | null;
71
+ normalizedMeanStepDistance: number | null;
72
+ normalizedDistanceRuns: number;
73
+ normalizedDistanceUnknownRuns: number;
74
+ rootCauseCategoryAccuracy: number | null;
75
+ anyFailureCategoryAccuracy: number | null;
76
+ earliestFailureCategoryAccuracy: number | null;
77
+ terminalFailureCategoryAccuracy: number | null;
68
78
  }
69
- interface AnalystRunnerComparison {
70
- baselineRunnerId: string;
71
- candidateRunnerId: string;
72
- metrics: AnalystMetricComparison[];
79
+ interface AgentRxCalibrationSummary {
80
+ protocol: 'official-agentrx-root-cause';
81
+ upstreamRevision: string;
82
+ rationale: string;
83
+ runners: AgentRxCalibrationRunnerSummary[];
73
84
  }
74
- declare function compareAnalystRunners(result: AnalystBenchmarkResult, options: {
75
- baselineRunnerId: string;
76
- candidateRunnerId: string;
77
- confidence?: number;
78
- resamples?: number;
79
- seed?: number;
80
- }): AnalystRunnerComparison;
85
+ declare function summarizeAgentRxCalibration(result: AnalystBenchmarkResult, upstreamRevision: string): AgentRxCalibrationSummary;
86
+ declare function renderAgentRxCalibrationMarkdown(summary: AgentRxCalibrationSummary): string;
81
87
  //#endregion
82
- //#region src/analyst/benchmark-datasets.d.ts
88
+ //#region src/analyst/benchmark-dataset-types.d.ts
83
89
  type ExternalId = string | number;
84
90
  interface AgentRxFailure {
85
91
  failure_id: ExternalId;
@@ -123,11 +129,31 @@ interface CodeTraceStageAnnotation {
123
129
  unuseful_step_ids?: readonly number[];
124
130
  reasoning?: string;
125
131
  }
132
+ interface CodeTracerStepLabel {
133
+ step_id: number;
134
+ stage?: string | number;
135
+ stage_name?: string | number;
136
+ stage_id?: string | number;
137
+ label: 'incorrect' | 'unuseful';
138
+ rationale?: string;
139
+ reason?: string;
140
+ note?: string;
141
+ comment?: string;
142
+ }
143
+ interface CodeTracerLabelGroup {
144
+ stage?: string | number;
145
+ stage_name?: string | number;
146
+ stage_id?: string | number;
147
+ labels: readonly CodeTracerStepLabel[];
148
+ }
149
+ type CodeTracerPredictions = string | readonly CodeTraceStageAnnotation[] | readonly CodeTracerStepLabel[] | readonly CodeTracerLabelGroup[];
126
150
  interface CodeTraceBenchRow {
127
151
  traj_id: string;
128
152
  agent: string;
129
153
  model: string;
130
154
  task_name: string;
155
+ /** Native artifact extraction path in the public CodeTraceBench manifest. */
156
+ source_relpath?: string;
131
157
  difficulty?: string;
132
158
  category?: string;
133
159
  tags?: string | readonly string[];
@@ -160,30 +186,438 @@ interface UpstreamPredictionAdapterOptions extends StepLabelAdapterOptions {
160
186
  stepCount?: number;
161
187
  }
162
188
  interface CodeTracerPredictionAdapterOptions extends UpstreamPredictionAdapterOptions, CodeTraceBenchLabelOptions {}
189
+ //#endregion
190
+ //#region src/analyst/benchmark-dataset-agentrx.d.ts
163
191
  declare function agentRxBenchmarkCase<TInput>(row: AgentRxRow, input: TInput, options?: AgentRxBenchmarkCaseOptions): AnalystBenchmarkCase<TInput>;
164
- declare function codeTraceBenchCase<TInput>(row: CodeTraceBenchRow, input: TInput, options?: CodeTraceBenchCaseOptions): AnalystBenchmarkCase<TInput>;
165
192
  /** Translate AgentRx `Report.to_dict()` output or its `failures` array into findings. */
166
193
  declare function agentRxPredictionsToFindings(trajectoryIdValue: ExternalId, output: unknown, options?: UpstreamPredictionAdapterOptions): AnalystFinding[];
194
+ declare function normalizeAgentRxCategory(value: string): string;
195
+ /** Match Python's round() behavior used by AgentRx for consensus steps. */
196
+ declare function roundAgentRxStep(value: number): number;
197
+ //#endregion
198
+ //#region src/analyst/benchmark-dataset-codetrace.d.ts
199
+ declare function codeTraceBenchCase<TInput>(row: CodeTraceBenchRow, input: TInput, options?: CodeTraceBenchCaseOptions): AnalystBenchmarkCase<TInput>;
167
200
  /** Translate CodeTracer's `codetracer_labels.json` into shared findings. */
168
- declare function codeTracerPredictionsToFindings(trajectoryIdValue: string, predictions: string | readonly CodeTraceStageAnnotation[], options?: CodeTracerPredictionAdapterOptions): AnalystFinding[];
201
+ declare function codeTracerPredictionsToFindings(trajectoryIdValue: string, predictions: CodeTracerPredictions, options?: CodeTracerPredictionAdapterOptions): AnalystFinding[];
202
+ //#endregion
203
+ //#region src/analyst/benchmark-dataset-utils.d.ts
169
204
  declare function normalizeBenchmarkLabel(value: string): string;
170
- declare function normalizeAgentRxCategory(value: string): string;
205
+ //#endregion
206
+ //#region src/analyst/benchmark-verification-outcome.d.ts
207
+ type VerificationOutcomeStatus = 'passed' | 'failed' | 'unavailable';
208
+ interface VerificationOutcomeSource {
209
+ path: string;
210
+ format: 'terminal-bench' | 'swe-bench' | 'swe-multi';
211
+ status: VerificationOutcomeStatus;
212
+ }
213
+ interface VerificationOutcome {
214
+ status: VerificationOutcomeStatus;
215
+ reason?: 'missing-result' | 'result-output-unavailable' | 'result-parse-error' | 'result-label-disagreement';
216
+ parseError?: {
217
+ class: string;
218
+ message: string;
219
+ };
220
+ sources: VerificationOutcomeSource[];
221
+ passedCheckCount: number;
222
+ failedCheckCount: number;
223
+ passedChecks: string[];
224
+ failedChecks: string[];
225
+ }
226
+ interface VerificationResultFile {
227
+ relativePath: string;
228
+ content: string;
229
+ }
230
+ declare function parseVerificationOutcome(files: readonly VerificationResultFile[]): VerificationOutcome;
231
+ //#endregion
232
+ //#region src/analyst/benchmark-verification-artifacts.d.ts
233
+ declare const DEFAULT_MAX_VERIFICATION_ARTIFACT_BYTES: number;
234
+ type VerificationArtifactRole = 'final-test-output' | 'final-result' | 'final-metrics';
235
+ interface VerificationArtifactFile {
236
+ role: VerificationArtifactRole;
237
+ path: string;
238
+ relativePath: string;
239
+ sha256: string;
240
+ bytes: number;
241
+ spanId: string;
242
+ }
243
+ interface VerificationArtifactManifest {
244
+ traceId: string;
245
+ status: 'present' | 'missing';
246
+ outcome: VerificationOutcome;
247
+ outcomeSpanId: string;
248
+ caseDirectory: string;
249
+ caseDirectoriesSearched: string[];
250
+ totalBytes: number;
251
+ maxBytes: number;
252
+ files: VerificationArtifactFile[];
253
+ missingRoles: VerificationArtifactRole[];
254
+ searched: Record<VerificationArtifactRole, string[]>;
255
+ }
256
+ interface LoadedVerificationArtifacts {
257
+ manifest: VerificationArtifactManifest;
258
+ outcome: VerificationOutcome;
259
+ files: Array<VerificationArtifactFile & {
260
+ content: string;
261
+ }>;
262
+ }
263
+ declare function loadCodeTraceVerificationArtifacts(options: {
264
+ artifactDir: string;
265
+ row: CodeTraceBenchRow;
266
+ maxBytes?: number;
267
+ }): Promise<LoadedVerificationArtifacts>;
268
+ declare function appendVerificationArtifactsToOtlp(otlpText: string, traceId: string, artifacts: LoadedVerificationArtifacts, afterTimestamp: string): string;
269
+ //#endregion
270
+ //#region src/analyst/benchmark-public-types.d.ts
271
+ type PublicAnalystBenchmarkDataset = 'agentrx' | 'codetracebench';
272
+ interface PublicAnalystBenchmarkModelConfig {
273
+ baseUrl: string;
274
+ apiKey: string;
275
+ model: string;
276
+ maxOutputTokens: number;
277
+ timeoutMs: number;
278
+ /** Required when the model is absent from agent-eval's pricing table. */
279
+ pricing?: CustomTokenPricing;
280
+ /** Independent per-case recursive-engine spend limit. Default: 1 USD. */
281
+ maxCostUsdPerAnalysis?: number;
282
+ dspyRlm?: {
283
+ runner?: ExternalOptimizerRunnerCommand;
284
+ maxIterations?: number;
285
+ maxLlmCalls?: number;
286
+ maxToolCalls?: number;
287
+ maxOutputChars?: number;
288
+ };
289
+ costLedger?: CostLedgerHandle;
290
+ durability?: {
291
+ runIdentitySha256: string;
292
+ responseCacheDir: string;
293
+ };
294
+ /** Test-only transport injection. */
295
+ fetchImpl?: typeof fetch;
296
+ }
297
+ interface PreparedPublicAnalystBenchmark {
298
+ cases: AnalystBenchmarkCase<AnalystRunInputs>[];
299
+ sourceRowCount: number;
300
+ selectedCaseIds: string[];
301
+ labelsSha256: string;
302
+ traceFiles: Array<{
303
+ traceId: string;
304
+ relativePath: string;
305
+ sha256: string;
306
+ }>;
307
+ verificationArtifacts: VerificationArtifactManifest[];
308
+ selection: PublicBenchmarkSelectionReport;
309
+ }
310
+ interface PublicBenchmarkValueDistribution {
311
+ total: number;
312
+ missing: number;
313
+ counts: Record<string, number>;
314
+ }
315
+ interface PublicBenchmarkDistributions {
316
+ class: PublicBenchmarkValueDistribution;
317
+ agent: PublicBenchmarkValueDistribution;
318
+ model: PublicBenchmarkValueDistribution;
319
+ difficulty: PublicBenchmarkValueDistribution;
320
+ solved: PublicBenchmarkValueDistribution;
321
+ }
322
+ interface PublicBenchmarkSelectionReport {
323
+ method: 'census' | 'deterministic-hash';
324
+ seed: number;
325
+ sourceCount: number;
326
+ selectedCount: number;
327
+ stratified: false;
328
+ representativeOfInput: boolean;
329
+ source: PublicBenchmarkDistributions;
330
+ selected: PublicBenchmarkDistributions;
331
+ }
332
+ //#endregion
333
+ //#region src/analyst/benchmark-public-adapters.d.ts
334
+ declare function emptyPublicBenchmarkRunner(): AnalystBenchmarkRunner<AnalystRunInputs>;
335
+ declare function adaptPublicBenchmarkFindings(dataset: PublicAnalystBenchmarkDataset, trajectoryId: string, findings: readonly AnalystFinding[], analystId: string): AnalystFinding[];
336
+ //#endregion
337
+ //#region src/analyst/benchmark-public-data.d.ts
338
+ declare function loadPublicBenchmarkRows(path: string): Promise<Array<Record<string, unknown>>>;
339
+ declare function selectPublicBenchmarkRows(dataset: PublicAnalystBenchmarkDataset, rows: readonly Record<string, unknown>[], options: {
340
+ limit: number;
341
+ seed: number;
342
+ }): Array<Record<string, unknown>>;
343
+ declare function publicBenchmarkDistributions(dataset: PublicAnalystBenchmarkDataset, rows: readonly Record<string, unknown>[]): PublicBenchmarkDistributions;
344
+ declare function publicBenchmarkSelectionReport(dataset: PublicAnalystBenchmarkDataset, source: readonly Record<string, unknown>[], selected: readonly Record<string, unknown>[], seed: number): PublicBenchmarkSelectionReport;
345
+ declare function preparePublicAnalystBenchmark(options: {
346
+ dataset: PublicAnalystBenchmarkDataset;
347
+ labelsPath: string;
348
+ traceDir: string;
349
+ artifactDir?: string;
350
+ maxArtifactBytes?: number;
351
+ limit: number;
352
+ seed: number;
353
+ }): Promise<PreparedPublicAnalystBenchmark>;
354
+ //#endregion
355
+ //#region src/analyst/benchmark-public-model.d.ts
356
+ /** One-shot JSON baseline. This is not a recursive trace analyst. */
357
+ declare function createPublicBenchmarkDirectRunner(dataset: PublicAnalystBenchmarkDataset, config: PublicAnalystBenchmarkModelConfig): AnalystBenchmarkRunner<AnalystRunInputs>;
358
+ declare function publicBenchmarkProtocolSha256(dataset: PublicAnalystBenchmarkDataset): string;
359
+ declare const CODE_TRACE_BENCH_ANALYST_PROMPT = "Analyze exactly one coding-agent trajectory and its attached final verification.\nYour task is the CodeTraceBench incorrect-step task: identify every wrong state-changing action, bad hypothesis that drives an action, and regression.\nAn incorrect step remains incorrect when the agent later recovers or the final verification passes.\nInspect the complete supplied trace data.\nUse the final-verification outcome as evidence about the final state, not as a rule for whether earlier steps were incorrect.\nFor each candidate, inspect the assistant action and its following observation.\nLabel a failed command when the assistant caused it through a wrong action or unsupported hypothesis.\nLabel the later corrective action only when that action is itself wrong.\nDo not label a diagnostic probe merely because it exposes an earlier defect.\nDo not label a redundant but correct read or search; CodeTraceBench scores unuseful steps separately, and this run scores incorrect steps only.\nDo not label a step solely because final verification failed.\nWhen final verification is unavailable, use only directly observed trajectory evidence.\nEmit one finding per incorrect assistant step.\nEach finding's step MUST be the positive integer n from an existing assistant LLM span named step-<n>.\nNever select an EVALUATOR, TOOL, CHAIN, final-verification, benchmark-verification, or message-<n> span.\nBefore emitting a finding, inspect its candidate span's attributes.content and describe only the action shown there.\nWhen the trajectory has no incorrect steps, return an empty findings array.";
360
+ //#endregion
361
+ //#region src/analyst/benchmark-public-rlm.d.ts
362
+ /** Public benchmark candidate that runs the actual recursive trace analyst. */
363
+ declare function createPublicBenchmarkRlmRunner(dataset: PublicAnalystBenchmarkDataset, config: PublicAnalystBenchmarkModelConfig): AnalystBenchmarkRunner<AnalystRunInputs>;
364
+ //#endregion
365
+ //#region src/analyst/benchmark-comparison.d.ts
366
+ type AnalystComparisonMetric = 'completion' | 'issueRecall' | 'findingPrecision' | 'f1' | 'criticalStepAccuracy' | 'citationCoverage' | 'citationExcerptCoverage' | 'citationLabelAgreement' | 'citationResolution' | 'trustedNegativeAccuracy' | 'latencyMs' | 'calls' | 'inputTokens' | 'outputTokens' | 'reasoningTokens' | 'cachedTokens' | 'cacheWriteTokens' | 'costUsd';
367
+ interface AnalystMetricComparison {
368
+ metric: AnalystComparisonMetric;
369
+ direction: 'higher' | 'lower';
370
+ /** Trajectories with at least one complete pair for this metric. */
371
+ pairedCases: number;
372
+ /** Independent task or incident groups resampled by the interval. */
373
+ pairedClusters: number;
374
+ /** Same-run pairs where this metric applies before missing values are removed. */
375
+ eligibleObservations: number;
376
+ pairedObservations: number;
377
+ baselineMissingObservations: number;
378
+ candidateMissingObservations: number;
379
+ asymmetricMissingObservations: number;
380
+ survivorOnly: boolean;
381
+ baselineMean: number | null;
382
+ candidateMean: number | null;
383
+ meanDelta: number | null;
384
+ intervalLow: number | null;
385
+ intervalHigh: number | null;
386
+ confidence: number;
387
+ resamples: number;
388
+ minimumSampleMet: boolean;
389
+ populationInferenceEligible: boolean;
390
+ inferenceLimitations: string[];
391
+ }
392
+ interface AnalystRunnerComparison {
393
+ baselineRunnerId: string;
394
+ candidateRunnerId: string;
395
+ metrics: AnalystMetricComparison[];
396
+ }
397
+ declare function compareAnalystRunners(result: AnalystBenchmarkResult, options: {
398
+ baselineRunnerId: string;
399
+ candidateRunnerId: string;
400
+ confidence?: number;
401
+ resamples?: number;
402
+ seed?: number;
403
+ }): AnalystRunnerComparison;
404
+ //#endregion
405
+ //#region src/analyst/benchmark-public-calibration.d.ts
406
+ interface CodeTraceCalibrationRunnerSummary {
407
+ runnerId: string;
408
+ selectedRuns: number;
409
+ positiveRuns: number;
410
+ trustedNegativeRuns: number;
411
+ unlabeledRuns: number;
412
+ failedLabelEmptyRuns: number;
413
+ unknownLabelEmptyRuns: number;
414
+ completedRuns: number;
415
+ failedRuns: number;
416
+ expectedIncorrectSteps: number;
417
+ predictedIncorrectSteps: number;
418
+ matchedIncorrectSteps: number;
419
+ /** CodeTraceBench's published mean per-row incorrect-step F1 over every row. */
420
+ officialAllRowF1: number | null;
421
+ officialAllRowRuns: number;
422
+ precision: number | null;
423
+ recall: number | null;
424
+ f1: number | null;
425
+ trustedNegativeFalsePositiveRate: number | null;
426
+ trustedNegativeFailureRate: number | null;
427
+ unlabeledPredictionRate: number | null;
428
+ unlabeledFailureRate: number | null;
429
+ }
430
+ interface CodeTraceCalibrationSummary {
431
+ protocol: 'labeled-positive-and-solved-negative';
432
+ rationale: string;
433
+ runners: CodeTraceCalibrationRunnerSummary[];
434
+ }
435
+ declare function summarizeCodeTraceCalibration(result: AnalystBenchmarkResult): CodeTraceCalibrationSummary;
436
+ declare function renderCodeTraceCalibrationMarkdown(summary: CodeTraceCalibrationSummary): string;
437
+ //#endregion
438
+ //#region src/analyst/benchmark-command-artifact.d.ts
439
+ interface AnalystBenchmarkArtifact {
440
+ kind: 'agent-eval/analyst-benchmark-result';
441
+ runIdentitySha256: string;
442
+ inputs: {
443
+ dataset: PublicAnalystBenchmarkDataset;
444
+ datasetRevision: string;
445
+ datasetSplit: string;
446
+ labelsSha256: string;
447
+ sourceRowCount: number;
448
+ traceFiles: Array<{
449
+ traceId: string;
450
+ relativePath: string;
451
+ sha256: string;
452
+ }>;
453
+ verificationArtifacts: VerificationArtifactManifest[];
454
+ verificationAvailability: VerificationAvailabilitySummary;
455
+ selection: {
456
+ limit: number;
457
+ seed: number;
458
+ selectedCaseIds: string[];
459
+ report: PublicBenchmarkSelectionReport;
460
+ };
461
+ execution: {
462
+ repetitions: number;
463
+ concurrency: number;
464
+ model: string;
465
+ maxOutputTokens: number;
466
+ timeoutMs: number;
467
+ maxCostUsd: number;
468
+ maxArtifactBytes: number;
469
+ analystProtocolSha256: string;
470
+ implementationSha256: string;
471
+ dependencyLockSha256: string;
472
+ };
473
+ };
474
+ result: AnalystBenchmarkResult;
475
+ comparisons: AnalystRunnerComparison[];
476
+ codeTraceCalibration?: CodeTraceCalibrationSummary;
477
+ agentRxCalibration?: AgentRxCalibrationSummary;
478
+ }
479
+ interface VerificationAvailabilitySummary {
480
+ cases: number;
481
+ resultFilesPresent: number;
482
+ resultFilesMissing: number;
483
+ outcomes: {
484
+ passed: number;
485
+ failed: number;
486
+ unavailable: number;
487
+ };
488
+ }
489
+ interface AnalystBenchmarkRunIdentity {
490
+ config: {
491
+ dataset: PublicAnalystBenchmarkDataset;
492
+ datasetRevision: string;
493
+ datasetSplit: string;
494
+ model: {
495
+ id: string;
496
+ maxOutputTokens: number;
497
+ timeoutMs: number;
498
+ };
499
+ limit: number;
500
+ seed: number;
501
+ concurrency: number;
502
+ repetitions: number;
503
+ maxCostUsd: number;
504
+ maxArtifactBytes: number;
505
+ analystProtocolSha256: string;
506
+ implementationSha256: string;
507
+ dependencyLockSha256: string;
508
+ runnerIds: readonly ['empty', 'dspy-rlm'];
509
+ };
510
+ inputs: {
511
+ labelsSha256: string;
512
+ sourceRowCount: number;
513
+ selectedCaseIds: string[];
514
+ traceFiles: Array<{
515
+ traceId: string;
516
+ relativePath: string;
517
+ sha256: string;
518
+ }>;
519
+ verificationArtifactsSha256: string;
520
+ caseDefinitionsSha256: string;
521
+ };
522
+ }
523
+ interface AnalystBenchmarkRunManifest {
524
+ kind: 'agent-eval/analyst-benchmark-run';
525
+ createdAt: string;
526
+ identitySha256: string;
527
+ localIdentitySha256: string;
528
+ identity: AnalystBenchmarkRunIdentity;
529
+ }
530
+ interface AnalystBenchmarkLocalRunReceipt {
531
+ kind: 'agent-eval/analyst-benchmark-local-run';
532
+ runIdentitySha256: string;
533
+ localIdentitySha256: string;
534
+ local: {
535
+ labelsPath: string;
536
+ traceDir: string;
537
+ artifactDir?: string;
538
+ outputDir: string;
539
+ baseUrl: string;
540
+ apiKeyEnvironment: string;
541
+ };
542
+ command: string;
543
+ environment: {
544
+ node: string;
545
+ platform: string;
546
+ arch: string;
547
+ };
548
+ files: {
549
+ manifest: string;
550
+ observations: string;
551
+ costLedger: string;
552
+ modelResponses: string;
553
+ result: string;
554
+ report: string;
555
+ };
556
+ }
557
+ interface AnalystBenchmarkProgressRow {
558
+ sequence: number;
559
+ runIdentitySha256: string;
560
+ previousRowSha256: string | null;
561
+ observation: AnalystBenchmarkObservation;
562
+ rowSha256: string;
563
+ }
564
+ declare const ANALYST_BENCHMARK_MANIFEST_FILE = "manifest.json";
565
+ declare const ANALYST_BENCHMARK_OBSERVATIONS_FILE = "observations.jsonl";
566
+ declare const ANALYST_BENCHMARK_LOCAL_RECEIPT_FILE = "run.local.json";
567
+ declare const ANALYST_BENCHMARK_COST_LEDGER_FILE = "cost-ledger.jsonl";
568
+ //#endregion
569
+ //#region src/analyst/benchmark-command-result.d.ts
570
+ declare function readAnalystBenchmarkArtifact(path: string): Promise<AnalystBenchmarkArtifact>;
571
+ //#endregion
572
+ //#region src/analyst/benchmark-command.d.ts
573
+ interface AnalystBenchmarkCommandDependencies {
574
+ createAnalystRunner?: (dataset: PublicAnalystBenchmarkDataset, config: PublicAnalystBenchmarkModelConfig) => AnalystBenchmarkRunner<AnalystRunInputs>;
575
+ }
576
+ interface AnalystBenchmarkCommandConfig {
577
+ dataset: PublicAnalystBenchmarkDataset;
578
+ labelsPath: string;
579
+ traceDir: string;
580
+ artifactDir?: string;
581
+ outDir: string;
582
+ revision: string;
583
+ split: string;
584
+ model: PublicAnalystBenchmarkModelConfig;
585
+ limit: number;
586
+ seed: number;
587
+ concurrency: number;
588
+ repetitions: number;
589
+ maxCostUsd: number;
590
+ maxArtifactBytes: number;
591
+ apiKeyEnv: string;
592
+ command: string;
593
+ resume: boolean;
594
+ }
595
+ declare function runAnalystBenchmarkCommand(argv: readonly string[], env?: NodeJS.ProcessEnv, dependencies?: AnalystBenchmarkCommandDependencies): Promise<number>;
596
+ declare const ANALYST_BENCHMARK_HELP = "agent-eval analyst-benchmark\n\nRun the recursive DSPy trace analyst against public AgentRx or CodeTraceBench labels.\n\nRequired:\n --dataset agentrx|codetracebench\n --labels <dataset.json|dataset.jsonl>\n --trace-dir <one-trace-per-file OTLP JSONL directory>\n --artifact-dir <extracted artifact root> Required for CodeTraceBench\n --out <new output directory>\n --revision <full 40- or 64-character hex digest>\n --split <dataset split>\n --base-url <OpenAI-compatible /v1 URL>\n --api-key-env <environment variable containing the bearer>\n --model <provider model id>\n --limit <positive case count>\n\nControls:\n --resume Continue an interrupted run in --out\n --seed <integer> Case-selection and comparison seed. Default: 0\n --concurrency <positive integer> Parallel benchmark jobs. Default: 1\n --repetitions <positive integer> Runs per case and runner. Default: 1\n --max-output-tokens <positive> Model output limit per call. Default: 4096\n --python <executable> Python with agent-eval-rpc[dspy]. Default: python\n --timeout-ms <positive> Model analyst deadline per case. Default: 300000\n --max-cost-usd <positive> Run-wide spend limit. Default: 5\n --max-artifact-bytes <positive> Final evidence bytes per case. Default: 8388608\n\nWrites result.json with every observation, metric, usage field, error, comparison,\ninput digest, artifact digest, case distribution, selected case id, and explicit\nunknown cost. Limited deterministic-hash subsets are marked non-representative.\nCompleted observations are fsynced to observations.jsonl. Shareable output is in\nresult.json and report.md. Machine-local paths, endpoint, and command are isolated\nin run.local.json.\nThe key is read from the named environment variable and is never written.";
597
+ //#endregion
598
+ //#region src/analyst/benchmark-implementation.d.ts
599
+ declare const ANALYST_BENCHMARK_IMPLEMENTATION_DIGEST_ALGORITHM = "sha256-canonical-source-manifest";
600
+ declare const ANALYST_BENCHMARK_DEPENDENCY_LOCK_DIGEST_ALGORITHM = "sha256-canonical-file-manifest";
601
+ declare const ANALYST_BENCHMARK_DEPENDENCY_LOCK_FILES: readonly string[];
602
+ declare const ANALYST_BENCHMARK_DEPENDENCY_LOCK_SHA256 = "6f3dc59755ff2a26fba4c2c1ad670f436cdd183faf252a5b9c2d50e6b190b460";
603
+ /** The published benchmark evidence was produced at this package version, by
604
+ * the retired one-shot direct runner, before trace analysts moved to the
605
+ * recursive DSPy RLM engine. Both evidence digests below are historical facts
606
+ * about that artifact: the current implementation and dependency manifest have
607
+ * since changed, so they cannot describe the current engine. A fresh certified
608
+ * run must replace the published evidence before any accuracy number is
609
+ * attributed to the engine that ships today. */
610
+ declare const ANALYST_BENCHMARK_EVIDENCE_PACKAGE_VERSION = "0.137.0";
611
+ declare const ANALYST_BENCHMARK_EVIDENCE_DEPENDENCY_LOCK_SHA256 = "1e03f2daed356d60316aabefb407ec1e437ac94d408d61eea4ae096e9c6fbb5b";
612
+ declare const ANALYST_BENCHMARK_EVIDENCE_IMPLEMENTATION_SHA256 = "4dba263b6256a30d56c7fdb2d992d3a953c0035d731f359b704db806f68f75ac";
613
+ declare const ANALYST_BENCHMARK_IMPLEMENTATION_FILES: readonly string[];
614
+ declare const ANALYST_BENCHMARK_IMPLEMENTATION_SHA256 = "5e47fc9d9f49c468d3ef06c5d552925e6a026f9e22a75056a9c8c5a2879744c0";
615
+ declare function analystBenchmarkImplementationDigest(): string;
616
+ declare function analystBenchmarkDependencyLockDigest(): string;
171
617
  //#endregion
172
618
  //#region src/analyst/benchmark-report.d.ts
173
619
  declare function renderAnalystBenchmarkMarkdown(result: AnalystBenchmarkResult, comparisons?: readonly AnalystRunnerComparison[]): string;
174
620
  //#endregion
175
- //#region src/analyst/define.d.ts
176
- interface DefineTraceAnalystOptions {
177
- id: string;
178
- description: string;
179
- version?: string;
180
- cost: AnalystCost;
181
- analyze: Analyst<TraceAnalysisStore>['analyze'];
182
- }
183
- /** Define a custom trace analyst without repeating fixed registry fields. */
184
- declare function defineTraceAnalyst(options: DefineTraceAnalystOptions): Analyst<TraceAnalysisStore>;
185
- type TraceAnalystAnalyze = (store: TraceAnalysisStore, context: Parameters<Analyst<TraceAnalysisStore>['analyze']>[1]) => Promise<AnalystFinding[]>;
186
- //#endregion
187
621
  //#region src/analyst/parse-tolerant.d.ts
188
622
  /**
189
623
  * Forgiving pre-parse for analyst findings. Weak models routinely emit
@@ -221,58 +655,5 @@ declare function isProposalFinding(finding: unknown): finding is ProposalFinding
221
655
  */
222
656
  declare function assertProposalFindings(findings: unknown, context?: string): ReadonlyArray<ProposalFinding>;
223
657
  //#endregion
224
- //#region src/analyst/structure-findings.d.ts
225
- interface StructureFindingsOptions {
226
- /** The actor's free-form diagnosis prose. */
227
- report: string;
228
- analystId: string;
229
- /** Coarse classification stamped on every extracted finding. */
230
- area: string;
231
- model: string;
232
- baseUrl: string;
233
- apiKey?: string;
234
- /** Optional ledger for direct use. */
235
- costLedger?: CostLedgerHandle;
236
- costPhase?: string;
237
- costTags?: Record<string, string>;
238
- maxTokens?: number;
239
- signal?: AbortSignal;
240
- /** Max reask attempts after a zero/invalid extraction. Default 1. */
241
- maxReasks?: number;
242
- /** Apply the caller's normal finding rules before a recovered row is lifted. */
243
- processRow?: (row: RawAnalystFinding) => RawAnalystFinding | null;
244
- /** Provenance copied onto every recovered finding. */
245
- findingMetadata?: Record<string, unknown>;
246
- /** Test seam: inject a fetch (no network in unit tests). */
247
- fetchImpl?: LlmClientOptions['fetch'];
248
- }
249
- interface StructureFindingsResult {
250
- findings: AnalystFinding[];
251
- outcome: 'ok' | 'extraction_failed';
252
- }
253
- declare function structureFindings(opts: StructureFindingsOptions): Promise<StructureFindingsResult>;
254
- //#endregion
255
- //#region src/analyst/tool-groups.d.ts
256
- /** Named tool sets. Kinds pass `tools: TRACE_TOOL_GROUPS.failureForensics` etc. */
257
- type TraceToolGroupName =
258
- /** All seven tools. Use for open-ended discovery kinds. */
259
- 'all' |
260
- /** Overview + paginated query + count. No deep reads. Cheap. */
261
- 'discovery' |
262
- /** Discovery + viewTrace + viewSpans. Deep-read but no regex search. */
263
- 'discoveryAndRead' |
264
- /** Discovery + search tools. For pattern-matching across many traces. */
265
- 'discoveryAndSearch' |
266
- /** Discovery + viewSpans + searchSpan. Targeted-span work after another kind narrows down. */
267
- 'targeted';
268
- /**
269
- * Build the tool set for a named group bound to a specific trace store.
270
- *
271
- * `all` returns every tool. Other groups filter `buildTraceAnalystTools`
272
- * by name to the documented subset. An unrecognised group name throws —
273
- * silently returning all tools would defeat the cost-control point.
274
- */
275
- declare function buildTraceToolsForGroup(group: TraceToolGroupName, store: TraceAnalysisStore): AxFunction[];
276
- //#endregion
277
- export { ANALYST_SEVERITIES, type AgentRxBenchmarkCaseOptions, type AgentRxFailure, type AgentRxPrediction, type AgentRxPredictionReport, type AgentRxRow, type Analyst, type AnalystBenchmarkCase, type AnalystBenchmarkDatasetRef, type AnalystBenchmarkDescriptor, type AnalystBenchmarkObservation, type AnalystBenchmarkOutput, type AnalystBenchmarkProvenance, type AnalystBenchmarkResult, type AnalystBenchmarkRunner, type AnalystBenchmarkSummary, type AnalystComparisonMetric, type AnalystContext, type AnalystCost, type AnalystEvidenceExpectation, type AnalystEvidenceResolution, type AnalystEvidenceResolutionError, type AnalystEvidenceResolver, type AnalystFinding, type AnalystFindingScore, type AnalystHooks, type AnalystInputKind, type AnalystIssueExpectation, type AnalystLatencyDistribution, type AnalystMetricComparison, AnalystRegistry, type AnalystRegistryOptions, type AnalystRequirements, type AnalystRunEvent, type AnalystRunInputs, type AnalystRunResult, type AnalystRunSummary, type AnalystRunnerComparison, type AnalystSeverity, type AnalystUsageReceipt, type BehavioralAnalystOptions, type BudgetPolicy, CONTROL_INTEGRITY_ANALYST, type ChatCallOpts, type ChatClient, type ChatRequest, type ChatResponse, type ChatTransport, type CliBridgeTransportOpts, type CodeTraceBenchCaseOptions, type CodeTraceBenchLabelOptions, type CodeTraceBenchLabelSet, type CodeTraceBenchRow, type CodeTraceStageAnnotation, type CodeTracerPredictionAdapterOptions, ControlIntegrityAnalyst, type CreateAnalystAiConfig, type CreateChatClientOpts, type CreateTraceAnalystKindOpts, type CustomTransportOpts, DEFAULT_TRACE_ANALYST_KINDS, type DefaultAnalystRegistryOptions, type DefineTraceAnalystOptions, type DiffPolicy, type DirectProviderTransportOpts, type EvidenceRef, FAILURE_MODE_KIND_SPEC, FINDING_SUBJECT_GRAMMAR_PROMPT, FINDING_SUBJECT_KINDS, FINDING_SUBJECT_SYNTAX, type FindingSubject, type FindingSubjectKind, FindingSubjectStringSchema, type FindingsDiff, FindingsStore, IMPROVEMENT_KIND_SPEC, type JudgeAdapterOpts, KIND_EXPECTED_SUBJECTS, KNOWLEDGE_GAP_KIND_SPEC, KNOWLEDGE_POISONING_KIND_SPEC, type MockTransportOpts, type PersistedFinding, type ProposalFinding, type ProposalFindingOrigin, RAW_FINDING_SCHEMA_PROMPT, type RawAnalystEvidence, RawAnalystEvidenceSchema, type RawAnalystFinding, RawAnalystFindingSchema, type RegistryRunOpts, type RouterTransportOpts, type RunAnalystBenchmarkOptions, type RunCriticAdapterOpts, SKILL_USAGE_ANALYST, type SandboxSdkTransportOpts, type SemanticConceptJudgeAdapterOpts, SkillUsageAnalyst, type SkillUsageRecord, type SkillUsageReport, type SkillUsageScanConfig, type StepLabelAdapterOptions, type StructureFindingsOptions, type StructureFindingsResult, type TraceAnalystAnalyze, type TraceAnalystKindSpec, type TraceToolGroupName, type UpstreamPredictionAdapterOptions, type VerifierAdapterOpts, agentRxBenchmarkCase, agentRxPredictionsToFindings, assertProposalFindings, behavioralAnalyst, buildDefaultAnalystRegistry, buildSkillUsageReport, buildTraceToolsForGroup, codeTraceBenchCase, codeTracerPredictionsToFindings, coerceJson, coerceToFindingRows, compareAnalystRunners, computeFindingId, createAnalystAi, createChatClient, createJudgeAdapter, createRunCriticAdapter, createSemanticConceptJudgeAdapter, createTraceAnalystKind, createVerifierAdapter, defaultIsMaterial, defineTraceAnalyst, deriveEfficiencyFindings, diffFindings, emitControlIntegrityFindings, emitSkillUsageFindings, evidenceRefsFromRawFinding, findingSubjectGrammarPromptFor, isProposalFinding, liftSeverity, makeFinding, makeProposalFinding, normalizeAgentRxCategory, normalizeBenchmarkLabel, parseFindingSubject, parseRawFinding, registryBenchmarkRunner, renderAnalystBenchmarkMarkdown, renderFindingSubject, renderPriorFindings, renderUpstreamFindings, runAnalystBenchmark, scoreAnalystFindings, stripCodeFences, structureFindings, traceStoreEvidenceResolver };
658
+ export { AGENT_RX_UPSTREAM_REVISION, ANALYST_BENCHMARK_COST_LEDGER_FILE, ANALYST_BENCHMARK_DEPENDENCY_LOCK_DIGEST_ALGORITHM, ANALYST_BENCHMARK_DEPENDENCY_LOCK_FILES, ANALYST_BENCHMARK_DEPENDENCY_LOCK_SHA256, ANALYST_BENCHMARK_EVIDENCE_DEPENDENCY_LOCK_SHA256, ANALYST_BENCHMARK_EVIDENCE_IMPLEMENTATION_SHA256, ANALYST_BENCHMARK_EVIDENCE_PACKAGE_VERSION, ANALYST_BENCHMARK_HELP, ANALYST_BENCHMARK_IMPLEMENTATION_DIGEST_ALGORITHM, ANALYST_BENCHMARK_IMPLEMENTATION_FILES, ANALYST_BENCHMARK_IMPLEMENTATION_SHA256, ANALYST_BENCHMARK_LOCAL_RECEIPT_FILE, ANALYST_BENCHMARK_MANIFEST_FILE, ANALYST_BENCHMARK_OBSERVATIONS_FILE, ANALYST_SEVERITIES, type AgentRxBenchmarkCaseOptions, type AgentRxCalibrationRunnerSummary, type AgentRxCalibrationSummary, type AgentRxFailure, type AgentRxPrediction, type AgentRxPredictionReport, type AgentRxRow, type Analyst, type AnalystBenchmarkArtifact, type AnalystBenchmarkCase, type AnalystBenchmarkCommandConfig, type AnalystBenchmarkCommandDependencies, type AnalystBenchmarkDatasetRef, type AnalystBenchmarkDescriptor, type AnalystBenchmarkError, type AnalystBenchmarkLabelState, type AnalystBenchmarkLocalRunReceipt, type AnalystBenchmarkObservation, type AnalystBenchmarkOutput, type AnalystBenchmarkProgressRow, type AnalystBenchmarkProvenance, type AnalystBenchmarkResult, type AnalystBenchmarkRunIdentity, type AnalystBenchmarkRunManifest, type AnalystBenchmarkRunner, type AnalystBenchmarkSummary, type AnalystComparisonMetric, type AnalystContext, type AnalystCost, type AnalystEvidenceExpectation, type AnalystEvidenceResolution, type AnalystEvidenceResolutionError, type AnalystEvidenceResolver, type AnalystFinding, type AnalystFindingScore, type AnalystHooks, type AnalystInputKind, type AnalystIssueExpectation, type AnalystLatencyDistribution, type AnalystMetricComparison, AnalystRegistry, type AnalystRegistryOptions, type AnalystRequirements, type AnalystRunEvent, type AnalystRunInputs, type AnalystRunResult, type AnalystRunSummary, type AnalystRunnerComparison, type AnalystSeverity, type AnalystUsageReceipt, type BehavioralAnalystOptions, type BudgetPolicy, CODE_TRACE_BENCH_ANALYST_PROMPT, CONTROL_INTEGRITY_ANALYST, type ChatCallOpts, type ChatClient, type ChatRequest, type ChatResponse, type ChatTransport, type CliBridgeTransportOpts, type CodeTraceBenchCaseOptions, type CodeTraceBenchLabelOptions, type CodeTraceBenchLabelSet, type CodeTraceBenchRow, type CodeTraceCalibrationRunnerSummary, type CodeTraceCalibrationSummary, type CodeTraceStageAnnotation, type CodeTracerLabelGroup, type CodeTracerPredictionAdapterOptions, type CodeTracerPredictions, type CodeTracerStepLabel, ControlIntegrityAnalyst, type CreateChatClientOpts, type CreateTraceAnalystOptions, type CustomTransportOpts, DEFAULT_MAX_VERIFICATION_ARTIFACT_BYTES, DEFAULT_TRACE_ANALYST_KINDS, DEFAULT_TRACE_ANALYST_LIMITS, type DefaultAnalystRegistryOptions, type DefineCustomAnalystOptions, type DefineExactCustomAnalystOptions, type DiffPolicy, type DirectProviderTransportOpts, type DspyRlmTraceEngineOptions, type EvidenceRef, type ExactAnalystBudgetPolicy, type ExactAnalystBudgetSnapshot, type ExactAnalystExecutionPlanSnapshot, type ExactAnalystRunCompletion, type ExactAnalystRunEvent, ExactAnalystRunExecutionError, type ExactAnalystRunPolicySnapshot, type ExactAnalystRunResult, type ExactAnalystRunSummary, type ExactAnalystSnapshot, type ExactCapableAnalyst, type ExactExecutionComponentIdentity, type ExactExecutionComponentSnapshot, type ExactRegistryRunOpts, FAILURE_MODE_KIND_SPEC, FINDING_SUBJECT_GRAMMAR_PROMPT, FINDING_SUBJECT_KINDS, FINDING_SUBJECT_SYNTAX, type FindingSubject, type FindingSubjectKind, FindingSubjectStringSchema, type FindingsDiff, FindingsStore, IMPROVEMENT_KIND_SPEC, type JudgeAdapterOpts, KIND_EXPECTED_SUBJECTS, KNOWLEDGE_GAP_KIND_SPEC, KNOWLEDGE_POISONING_KIND_SPEC, type LoadedVerificationArtifacts, type MockTransportOpts, type PersistedFinding, type PreparedPublicAnalystBenchmark, type ProposalFinding, type ProposalFindingOrigin, type PublicAnalystBenchmarkDataset, type PublicAnalystBenchmarkModelConfig, type PublicBenchmarkDistributions, type PublicBenchmarkSelectionReport, type PublicBenchmarkValueDistribution, RAW_FINDING_SCHEMA_PROMPT, type RawAnalystEvidence, RawAnalystEvidenceSchema, type RawAnalystFinding, RawAnalystFindingSchema, type RegistryRunOpts, type RouterTransportOpts, type RunAnalystBenchmarkOptions, type RunCriticAdapterOpts, SKILL_USAGE_ANALYST, type SandboxSdkTransportOpts, type SemanticConceptJudgeAdapterOpts, SkillUsageAnalyst, type SkillUsageRecord, type SkillUsageReport, type SkillUsageScanConfig, type StepLabelAdapterOptions, type TraceAnalysisEngine, type TraceAnalysisEngineRequest, type TraceAnalysisEngineResult, type TraceAnalystDefinition, type TraceAnalystLimits, type TraceToolGroupName, type UpstreamPredictionAdapterOptions, type VerificationArtifactFile, type VerificationArtifactManifest, type VerificationArtifactRole, type VerificationAvailabilitySummary, type VerificationOutcome, type VerificationOutcomeSource, type VerificationOutcomeStatus, type VerificationResultFile, type VerifierAdapterOpts, adaptPublicBenchmarkFindings, agentRxBenchmarkCase, agentRxPredictionsToFindings, analystBenchmarkDependencyLockDigest, analystBenchmarkImplementationDigest, appendVerificationArtifactsToOtlp, assertExactRegistryRunOpts, assertProposalFindings, behavioralAnalyst, buildDefaultAnalystRegistry, buildSkillUsageReport, buildTraceToolsForGroup, codeTraceBenchCase, codeTracerPredictionsToFindings, coerceJson, coerceToFindingRows, compareAnalystRunners, computeFindingId, createChatClient, createDspyRlmTraceEngine, createJudgeAdapter, createPublicBenchmarkDirectRunner, createPublicBenchmarkRlmRunner, createRunCriticAdapter, createSemanticConceptJudgeAdapter, createTraceAnalyst, createVerifierAdapter, defaultIsMaterial, defineCustomAnalyst, defineTraceAnalyst, deriveEfficiencyFindings, diffFindings, emitControlIntegrityFindings, emitSkillUsageFindings, emptyPublicBenchmarkRunner, evidenceRefsFromRawFinding, findingSubjectGrammarPromptFor, isProposalFinding, liftSeverity, loadCodeTraceVerificationArtifacts, loadPublicBenchmarkRows, makeFinding, makeProposalFinding, normalizeAgentRxCategory, normalizeBenchmarkLabel, parseFindingSubject, parseRawFinding, parseVerificationOutcome, preparePublicAnalystBenchmark, publicBenchmarkDistributions, publicBenchmarkProtocolSha256, publicBenchmarkSelectionReport, readAnalystBenchmarkArtifact, registryBenchmarkRunner, renderAgentRxCalibrationMarkdown, renderAnalystBenchmarkMarkdown, renderCodeTraceCalibrationMarkdown, renderFindingSubject, renderPriorFindings, renderUpstreamFindings, resolveTraceAnalystLimits, roundAgentRxStep, runAnalystBenchmark, runAnalystBenchmarkCommand, runTraceAnalyst, scoreAnalystFindings, selectPublicBenchmarkRows, stripCodeFences, summarizeAgentRxCalibration, summarizeCodeTraceCalibration, traceStoreEvidenceResolver };
278
659
  //# sourceMappingURL=index.d.ts.map