@tangle-network/agent-eval 0.220.2 → 0.221.0

package/dist/evaluation-wdGyZ7jV.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation-wdGyZ7jV.js","names":[],"sources":["../src/analyst/evaluation-context.ts","../src/evaluation.ts"],"sourcesContent":["import { CostLedger } from '../cost-ledger'\nimport type { EvaluationContext } from '../evaluation'\nimport type { AnalystContext } from './types'\n\n/** One deadline, spending authority and usage bridge for every evaluation-backed analyst. */\nexport function analystEvaluationContext(\n  context: AnalystContext,\n  actor: string,\n): {\n  evaluation: EvaluationContext\n  analystContext: AnalystContext & { signal: AbortSignal }\n} {\n  const signals = context.signal ? [context.signal] : []\n  if (context.deadlineMs !== undefined) {\n    const remaining = context.deadlineMs - Date.now()\n    if (!Number.isFinite(remaining)) throw new TypeError('Analyst deadline must be finite')\n    if (remaining <= 0) throw new DOMException('Analyst deadline exceeded', 'TimeoutError')\n    signals.push(AbortSignal.timeout(Math.ceil(remaining)))\n  }\n  const signal = AbortSignal.any(signals)\n  signal.throwIfAborted()\n  return {\n    analystContext: { ...context, signal },\n    evaluation: {\n      signal,\n      // No implicit account overrides an evaluator's configured spending authority.\n      costLedger:\n        context.costLedger ??\n        (context.budgetUsd === undefined\n          ? undefined\n          : new CostLedger({ costCeilingUsd: context.budgetUsd })),\n      actor,\n      channel: 'analyst',\n      costPhase: context.costPhase,\n      costTags: { ...context.tags, runId: context.runId, correlationId: context.correlationId },\n      onReceipt: (receipt) =>\n        context.recordUsage?.({\n          calls: 1,\n          tokens: receipt.usageUnknown\n            ? null\n            : { input: receipt.inputTokens, output: receipt.outputTokens },\n          cost: receipt.costUnknown\n            ? { kind: 'uncaptured', usd: null }\n            : {\n                kind: receipt.actualCostUsd === undefined ? 'estimated' : 'observed',\n                usd: receipt.costUsd,\n              },\n        }),\n    },\n  }\n}\n","import { analystEvaluationContext } from './analyst/evaluation-context'\nimport type { Analyst, AnalystContext, AnalystFinding } from './analyst/types'\nimport type { JudgeConfig, JudgeScore, Scenario } from './campaign/types'\nimport type {\n  CostChannel,\n  CostLedgerHandle,\n  CostReceipt,\n  CostReceiptInput,\n  MaximumCharge,\n} from './cost-ledger'\nimport { CostLedger } from './cost-ledger'\n\nexport interface EvaluationResult<T> {\n  value: T\n  receipt: CostReceipt\n  durationMs: number\n}\n\nexport interface EvaluationContext {\n  /** Physical paid-call identity, forwarded through the existing ledger and transport.\n   * Reusing it in one ledger conflicts; it is not an automatic result-replay policy. */\n  callId?: string\n  signal?: AbortSignal\n  costLedger?: CostLedgerHandle\n  actor?: string\n  channel?: CostChannel\n  costPhase?: string\n  costTags?: Record<string, string>\n  maximumCharge?: MaximumCharge\n  /** Awaited after accounting and before validation or result delivery. */\n  onReceipt?: (receipt: CostReceipt) => void | Promise<void>\n}\n\nexport type CostedEvaluator<I, O> = (\n  input: I,\n  context?: EvaluationContext,\n) => Promise<EvaluationResult<O>>\n\nexport interface EvaluatorOptions<I, O> {\n  execute: (input: I, context: { signal: AbortSignal; idempotencyKey: string }) => Promise<O>\n  receipt: (value: O) => CostReceiptInput\n  receiptFromError?: (error: Error) => CostReceiptInput | undefined\n  model?: string | ((input: I) => string)\n  costLedger?: CostLedgerHandle\n  maximumCharge?: MaximumCharge\n  /** Awaited after accounting, so invalid output never erases paid work. */\n  validate?: (value: O, input: I) => void | Promise<void>\n}\n\n/** A metered function, independent of providers, question formats, and application policy. */\nexport function createEvaluator<I, O>(options: EvaluatorOptions<I, O>): CostedEvaluator<I, O> {\n  const defaults = { ...options }\n  const ledger = defaults.costLedger ?? new CostLedger()\n  return async (input, context = {}) => {\n    context.signal?.throwIfAborted()\n    const started = performance.now()\n    const paid = await (context.costLedger ?? ledger).runPaidCall({\n      callId: context.callId,\n      actor: context.actor ?? 'evaluation',\n      channel: context.channel ?? 'evaluation',\n      phase: context.costPhase ?? 'evaluation',\n      tags: context.costTags,\n      model: typeof defaults.model === 'function' ? defaults.model(input) : defaults.model,\n      signal: context.signal,\n      maximumCharge: context.maximumCharge ?? defaults.maximumCharge,\n      execute: (signal, idempotencyKey) => defaults.execute(input, { signal, idempotencyKey }),\n      receipt: defaults.receipt,\n      receiptFromError: defaults.receiptFromError,\n    })\n    if (paid.receipt) await context.onReceipt?.(paid.receipt)\n    if (!paid.succeeded) throw paid.error\n    // A transport can complete after cancellation. Keep its paid receipt, not a live decision.\n    context.signal?.throwIfAborted()\n    await defaults.validate?.(paid.value, input)\n    context.signal?.throwIfAborted()\n    return { value: paid.value, receipt: paid.receipt, durationMs: performance.now() - started }\n  }\n}\n\nexport interface EvaluationJudgeOptions<A, S extends Scenario, O> {\n  name: string\n  version: string\n  dimensions: JudgeConfig<A, S>['dimensions']\n  evaluate: CostedEvaluator<{ artifact: A; scenario: S }, O>\n  map: (value: O, input: { artifact: A; scenario: S }) => JudgeScore | Promise<JudgeScore>\n  /** Persist the complete observation before reducing it to a verdict. */\n  record?: (\n    result: EvaluationResult<O>,\n    input: { artifact: A; scenario: S },\n  ) => void | Promise<void>\n  appliesTo?: (scenario: S) => boolean\n}\n\n/** Return the existing contract. Mapping never performs another inference call. */\nexport function asJudge<A, S extends Scenario, O>(\n  options: EvaluationJudgeOptions<A, S, O>,\n): JudgeConfig<A, S> {\n  // The version describes these callbacks, not later mutations of the caller's options.\n  const config = { ...options, dimensions: structuredClone(options.dimensions) }\n  return {\n    name: config.name,\n    judgeVersion: config.version,\n    dimensions: config.dimensions,\n    appliesTo: config.appliesTo,\n    async score({ artifact, scenario, signal, costLedger, costPhase, costTags }) {\n      signal.throwIfAborted()\n      const input = { artifact, scenario }\n      const result = await config.evaluate(input, {\n        signal,\n        costLedger,\n        actor: config.name,\n        channel: 'judge',\n        costPhase,\n        costTags: { ...costTags, scenarioId: scenario.id },\n      })\n      await config.record?.(result, input)\n      signal.throwIfAborted()\n      const score = await config.map(result.value, input)\n      signal.throwIfAborted()\n      return score\n    },\n  }\n}\n\nexport interface EvaluationAnalystOptions<I, O> {\n  id: string\n  version: string\n  description: string\n  inputKind: Analyst<I>['inputKind']\n  cost: Analyst<I>['cost']\n  evaluate: (\n    input: I,\n    context: EvaluationContext,\n    analystContext: AnalystContext,\n  ) => Promise<EvaluationResult<O>>\n  map: (value: O, input: I, context: AnalystContext) => AnalystFinding[] | Promise<AnalystFinding[]>\n  record?: (result: EvaluationResult<O>, input: I, context: AnalystContext) => void | Promise<void>\n}\n\n/** Registry, graph, and trace consumers keep the same Analyst interface. */\nexport function asAnalyst<I, O>(options: EvaluationAnalystOptions<I, O>): Analyst<I> {\n  const config = { ...options, cost: structuredClone(options.cost) }\n  return {\n    id: config.id,\n    version: config.version,\n    description: config.description,\n    inputKind: config.inputKind,\n    cost: config.cost,\n    async analyze(input, context) {\n      const { evaluation, analystContext } = analystEvaluationContext(context, config.id)\n      const signal = analystContext.signal\n      const result = await config.evaluate(input, evaluation, analystContext)\n      await config.record?.(result, input, analystContext)\n      signal.throwIfAborted()\n      const findings = await config.map(result.value, input, analystContext)\n      signal.throwIfAborted()\n      return findings\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/evaluation.d.ts

@@ -1,2 +1,2 @@
-import { a as EvaluationResult, c as asJudge, i as EvaluationJudgeOptions, l as createEvaluator, n as EvaluationAnalystOptions, o as EvaluatorOptions, r as EvaluationContext, s as asAnalyst, t as CostedEvaluator } from "./evaluation-CBdQt_kr.js";
+import { a as EvaluationResult, c as asJudge, i as EvaluationJudgeOptions, l as createEvaluator, n as EvaluationAnalystOptions, o as EvaluatorOptions, r as EvaluationContext, s as asAnalyst, t as CostedEvaluator } from "./evaluation-D1PGzkPR.js";
 export { CostedEvaluator, EvaluationAnalystOptions, EvaluationContext, EvaluationJudgeOptions, EvaluationResult, EvaluatorOptions, asAnalyst, asJudge, createEvaluator };

package/dist/evaluation.js

@@ -1,137 +1,2 @@
-import { t as CostLedger } from "./cost-ledger-BGZB6yY2.js";
-//#region src/evaluation.ts
-/** A metered function, independent of providers, question formats, and application policy. */
-function createEvaluator(options) {
-	const defaults = { ...options };
-	const ledger = defaults.costLedger ?? new CostLedger();
-	return async (input, context = {}) => {
-		context.signal?.throwIfAborted();
-		const started = performance.now();
-		const paid = await (context.costLedger ?? ledger).runPaidCall({
-			callId: context.callId,
-			actor: context.actor ?? "evaluation",
-			channel: context.channel ?? "evaluation",
-			phase: context.costPhase ?? "evaluation",
-			tags: context.costTags,
-			model: typeof defaults.model === "function" ? defaults.model(input) : defaults.model,
-			signal: context.signal,
-			maximumCharge: context.maximumCharge ?? defaults.maximumCharge,
-			execute: (signal, idempotencyKey) => defaults.execute(input, {
-				signal,
-				idempotencyKey
-			}),
-			receipt: defaults.receipt,
-			receiptFromError: defaults.receiptFromError
-		});
-		if (paid.receipt) await context.onReceipt?.(paid.receipt);
-		if (!paid.succeeded) throw paid.error;
-		context.signal?.throwIfAborted();
-		await defaults.validate?.(paid.value, input);
-		context.signal?.throwIfAborted();
-		return {
-			value: paid.value,
-			receipt: paid.receipt,
-			durationMs: performance.now() - started
-		};
-	};
-}
-/** Return the existing contract. Mapping never performs another inference call. */
-function asJudge(options) {
-	const config = {
-		...options,
-		dimensions: structuredClone(options.dimensions)
-	};
-	return {
-		name: config.name,
-		judgeVersion: config.version,
-		dimensions: config.dimensions,
-		appliesTo: config.appliesTo,
-		async score({ artifact, scenario, signal, costLedger, costPhase, costTags }) {
-			signal.throwIfAborted();
-			const input = {
-				artifact,
-				scenario
-			};
-			const result = await config.evaluate(input, {
-				signal,
-				costLedger,
-				actor: config.name,
-				channel: "judge",
-				costPhase,
-				costTags: {
-					...costTags,
-					scenarioId: scenario.id
-				}
-			});
-			await config.record?.(result, input);
-			signal.throwIfAborted();
-			const score = await config.map(result.value, input);
-			signal.throwIfAborted();
-			return score;
-		}
-	};
-}
-/** Registry, graph, and trace consumers keep the same Analyst interface. */
-function asAnalyst(options) {
-	const config = {
-		...options,
-		cost: structuredClone(options.cost)
-	};
-	return {
-		id: config.id,
-		version: config.version,
-		description: config.description,
-		inputKind: config.inputKind,
-		cost: config.cost,
-		async analyze(input, context) {
-			const signals = context.signal ? [context.signal] : [];
-			if (context.deadlineMs !== void 0) {
-				const remaining = context.deadlineMs - Date.now();
-				if (!Number.isFinite(remaining)) throw new TypeError("Analyst deadline must be finite");
-				if (remaining <= 0) throw new DOMException("Analyst deadline exceeded", "TimeoutError");
-				signals.push(AbortSignal.timeout(Math.ceil(remaining)));
-			}
-			const signal = AbortSignal.any(signals);
-			signal.throwIfAborted();
-			const analystContext = {
-				...context,
-				signal
-			};
-			const result = await config.evaluate(input, {
-				signal,
-				costLedger: context.costLedger ?? (context.budgetUsd === void 0 ? void 0 : new CostLedger({ costCeilingUsd: context.budgetUsd })),
-				actor: config.id,
-				channel: "analyst",
-				costPhase: context.costPhase,
-				costTags: {
-					...context.tags,
-					runId: context.runId,
-					correlationId: context.correlationId
-				},
-				onReceipt: (receipt) => context.recordUsage?.({
-					calls: 1,
-					tokens: receipt.usageUnknown ? null : {
-						input: receipt.inputTokens,
-						output: receipt.outputTokens
-					},
-					cost: receipt.costUnknown ? {
-						kind: "uncaptured",
-						usd: null
-					} : {
-						kind: receipt.actualCostUsd === void 0 ? "estimated" : "observed",
-						usd: receipt.costUsd
-					}
-				})
-			}, analystContext);
-			await config.record?.(result, input, analystContext);
-			signal.throwIfAborted();
-			const findings = await config.map(result.value, input, analystContext);
-			signal.throwIfAborted();
-			return findings;
-		}
-	};
-}
-//#endregion
+import { n as asJudge, r as createEvaluator, t as asAnalyst } from "./evaluation-wdGyZ7jV.js";
 export { asAnalyst, asJudge, createEvaluator };
-
-//# sourceMappingURL=evaluation.js.map

package/dist/{exact-types-BYFmYq44.d.ts → exact-types-CVn1QxFO.d.ts}

@@ -1,4 +1,4 @@
-import { c as AnalystRunEvent, d as AnalystRunSummary, t as Analyst, u as AnalystRunResult } from "./types-8yQzNm8u.js";
+import { c as AnalystRunEvent, d as AnalystRunSummary, t as Analyst, u as AnalystRunResult } from "./types-DGImvHIr.js";
 import { z } from "zod";
 //#region src/analyst/exact-types.d.ts
 /** Analyst metadata required before the exact registry path will execute it. */
@@ -231,4 +231,4 @@ declare const exactExecutionPlanSchema: z.ZodObject<{
 }, z.core.$strict>;
 //#endregion
 export { ExactAnalystRunPolicySnapshot as a, ExactAnalystSnapshot as c, ExactExecutionComponentSnapshot as d, ExactAnalystRunEvent as i, ExactCapableAnalyst as l, ExactAnalystExecutionPlanSnapshot as n, ExactAnalystRunResult as o, ExactAnalystRunCompletion as r, ExactAnalystRunSummary as s, ExactAnalystBudgetSnapshot as t, ExactExecutionComponentIdentity as u };
-//# sourceMappingURL=exact-types-BYFmYq44.d.ts.map
+//# sourceMappingURL=exact-types-CVn1QxFO.d.ts.map

package/dist/{exact-types-BYFmYq44.d.ts.map → exact-types-CVn1QxFO.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"exact-types-BYFmYq44.d.ts","names":[],"sources":["../src/analyst/exact-types.ts"],"mappings":";;;;UAMiB,oBAAoB,0BAA0B,QAAQ;;WAE5D,iBAAiB,SAAS;;KAGhC,aAAa,KAAK,0BAA0B,mBACpC,aAAa,UACtB,+BACc,aAAa,IAAI,aAAa,EAAE,WAC5C;KAEM,uBAAuB,aAAa,EAAE,aAAa;KACnD,6BAA6B,aAAa,EAAE,aAAa;;UAGpD;EACf;EACA;EACA,QAAQ,SAAS;;;UAIF;EACf;EACA;EACA;;KAyBU,gCAAgC,aAAa,EAAE,aAAa;KAC5D,oCAAoC,aAC9C,EAAE,aAAa;KAGL,yBAAyB;;EAEnC;;KAGU;EACN;;EAEA;EACA;IAAS;IAAe;;;UAGb,8BAA8B;EAC7C,aAAa;EACb,gBAAgB;EAChB,YAAY;;;KAIF,wBACP,QAAQ;EAAmB;;EAC1B,gBAAgB;MAEjB,KAAK,QAAQ;EAAmB;;EAC/B,SAAS;KAEX,QAAQ;EAAmB;MAC1B,KAAK,QAAQ;EAAmB;;EAC/B,SAAS;MAEV,KAAK,QAAQ;EAAmB;;EAC/B,QAAQ;;cAwCR,uBAAqB,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAOzB,EAAA,KAAA;cAII,sBAAoB,EAAA,uBAAA,EAAA;;;;;;;;;;;GAaxB,EAAA,KAAA;cAiBI,sBAAoB,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAYxB,EAAA,KAAA;cAEI,0BAAwB,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+E1B,EAAA,KAAA"}
+{"version":3,"file":"exact-types-CVn1QxFO.d.ts","names":[],"sources":["../src/analyst/exact-types.ts"],"mappings":";;;;UAMiB,oBAAoB,0BAA0B,QAAQ;;WAE5D,iBAAiB,SAAS;;KAGhC,aAAa,KAAK,0BAA0B,mBACpC,aAAa,UACtB,+BACc,aAAa,IAAI,aAAa,EAAE,WAC5C;KAEM,uBAAuB,aAAa,EAAE,aAAa;KACnD,6BAA6B,aAAa,EAAE,aAAa;;UAGpD;EACf;EACA;EACA,QAAQ,SAAS;;;UAIF;EACf;EACA;EACA;;KAyBU,gCAAgC,aAAa,EAAE,aAAa;KAC5D,oCAAoC,aAC9C,EAAE,aAAa;KAGL,yBAAyB;;EAEnC;;KAGU;EACN;;EAEA;EACA;IAAS;IAAe;;;UAGb,8BAA8B;EAC7C,aAAa;EACb,gBAAgB;EAChB,YAAY;;;KAIF,wBACP,QAAQ;EAAmB;;EAC1B,gBAAgB;MAEjB,KAAK,QAAQ;EAAmB;;EAC/B,SAAS;KAEX,QAAQ;EAAmB;MAC1B,KAAK,QAAQ;EAAmB;;EAC/B,SAAS;MAEV,KAAK,QAAQ;EAAmB;;EAC/B,QAAQ;;cAwCR,uBAAqB,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAOzB,EAAA,KAAA;cAII,sBAAoB,EAAA,uBAAA,EAAA;;;;;;;;;;;GAaxB,EAAA,KAAA;cAiBI,sBAAoB,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAYxB,EAAA,KAAA;cAEI,0BAAwB,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+E1B,EAAA,KAAA"}

package/dist/experiment/index.d.ts

@@ -1,10 +1,10 @@
 import { n as bonferroni, r as holm, t as benjaminiHochberg } from "../multiplicity-DIWHvysC.js";
-import { At as EProcessStep, B as powerPreflight, Bt as pairedRiskDifferenceScore, C as signManifest, Ct as FinalEvidenceOutcome, Dt as EProcess, E as MatchedPair, Et as openFinalEvidenceLedger, F as comparePairedArms, Ht as wilson, I as pairArms, J as PromotionPolicy, L as pairRunRecords, Lt as mcnemar, O as PairArmsOptions, Ot as EProcessOptions, Pt as ProportionInterval, R as PowerPreflight, Rt as pairedRiskDifference, S as manifestContentDigest, St as FinalEvidenceMeasurement, Tt as FinalEvidenceReservation, W as EvidenceVector, X as paretoPolicy, Y as buildEvidenceVector, Z as paretoSignificanceGate, _ as HypothesisManifest, at as EvidenceAuthority, b as SignedManifestAlgo, bt as FinalEvidenceError, ct as EvidenceReceipt, d as SequentialObservation, dt as isIndependentEvidence, f as SequentialPairedGate, ft as verifyEvidenceReceipt, g as sequentialPairedGate, h as sequentialDecide, i as PairedHoldout, it as CreateEvidenceReceiptInput, j as PairedArmRow, jt as eProcess, k as PairArmsResult, kt as EProcessState, lt as EvidenceReceiptVerification, n as HeldoutSignificance, nt as CampaignEvidenceContext, o as heldoutSignificance, ot as EvidenceAuthorityKind, p as SequentialPairedGateOptions, r as HeldoutSignificanceOptions, rt as createCampaignEvidenceReceipt, s as pairHoldout, st as EvidenceBinding, u as SequentialGateDecision, ut as createEvidenceReceipt, v as HypothesisResult, w as verifyManifest, wt as FinalEvidenceRecord, x as hashJson, xt as FinalEvidenceLedger, y as SignedManifest, yt as FinalEvidenceConflictError, z as PowerPreflightOptions, zt as pairedRiskDifferenceExact } from "../statistical-heldout-3z3I-kJN.js";
+import { $ as paretoPolicy, At as EProcess, B as ArmPopulationSummary, Bt as mcnemar, C as signManifest, Ct as FinalEvidenceError, Dt as FinalEvidenceRecord, E as MatchedPair, Et as FinalEvidenceOutcome, F as comparePairedArms, Gt as wilson, H as PowerPreflightOptions, Ht as pairedRiskDifferenceExact, I as pairArms, L as pairRunRecords, Lt as ProportionInterval, Mt as EProcessState, Nt as EProcessStep, O as PairArmsOptions, Ot as FinalEvidenceReservation, Pt as eProcess, Q as buildEvidenceVector, R as ArmAssignment, S as manifestContentDigest, St as FinalEvidenceConflictError, Tt as FinalEvidenceMeasurement, U as powerPreflight, Ut as pairedRiskDifferenceScore, V as PowerPreflight, Vt as pairedRiskDifference, Z as PromotionPolicy, _ as HypothesisManifest, at as CampaignEvidenceContext, b as SignedManifestAlgo, ct as EvidenceAuthority, d as SequentialObservation, dt as EvidenceReceipt, et as paretoSignificanceGate, f as SequentialPairedGate, ft as EvidenceReceiptVerification, g as sequentialPairedGate, h as sequentialDecide, ht as verifyEvidenceReceipt, i as PairedHoldout, j as PairedArmRow, jt as EProcessOptions, k as PairArmsResult, kt as openFinalEvidenceLedger, lt as EvidenceAuthorityKind, mt as isIndependentEvidence, n as HeldoutSignificance, o as heldoutSignificance, ot as createCampaignEvidenceReceipt, p as SequentialPairedGateOptions, pt as createEvidenceReceipt, q as EvidenceVector, r as HeldoutSignificanceOptions, s as pairHoldout, st as CreateEvidenceReceiptInput, u as SequentialGateDecision, ut as EvidenceBinding, v as HypothesisResult, w as verifyManifest, wt as FinalEvidenceLedger, x as hashJson, y as SignedManifest, z as ArmPopulationReading } from "../statistical-heldout-pD1Yah-0.js";
 import { c as BOOTSTRAP_GATE_MIN_N, l as PairedBootstrapOptions, m as pairedBootstrap, u as PairedBootstrapResult } from "../paired-promotion-decision-CQMJ5xGN.js";
 import { a as requiredPairedSampleSize, i as pairedMde, n as mcnemarPower, o as requiredSampleSize, r as mcnemarRequiredN, t as mulberry32 } from "../random-DGEyr3zG.js";
 import { at as summarizeEvaluationUnits, it as defineEvaluationClaim, nt as EvaluationClaim, rt as EvaluationUnitSummary } from "../search-ledger-types-p2xKfiDJ.js";
-import { a as PairedEvalueStep, i as PairedEvalueSequence, o as SequentialCrossingHorizon, r as PairedEvalueOptions, s as SequentialCrossingHorizonOptions, u as pairedEvalueSequence } from "../sequential-KwGspfeR.js";
 import { a as JsonValue, i as EvidenceRecord, n as IntervalSpec, r as computeInterval, t as ComputedInterval } from "../interval-ohuOJurX.js";
+import { a as PairedEvalueStep, i as PairedEvalueSequence, o as SequentialCrossingHorizon, r as PairedEvalueOptions, s as SequentialCrossingHorizonOptions, u as pairedEvalueSequence } from "../sequential-KwGspfeR.js";
 import { z } from "zod";
 //#region src/experiment/ast/predicate.d.ts
 /**
@@ -985,5 +985,5 @@ interface ProspectiveCanaryJoinInput {
  */
 export declare function joinProspectiveCanaryReceipts(input: ProspectiveCanaryJoinInput): CanaryObservation[];
 //#endregion
-export { type AdmissionExecution, type AdmissionPartition, type AdmissionRule, type AdmissionStage, type ArmRealizedBudget, type ArmSpec, BOOTSTRAP_GATE_MIN_N, type BudgetRule, type CampaignEvidenceContext, type CanaryArm, type CanaryAssignmentReceipt, type CanaryCohortReceipt, type CanaryCohortVerifier, type CanaryObservation, type CanaryRefusal, type ClusteredPowerOptions, type ClusteredPowerPoint, type ClusteredPowerRefusal, type ClusteredPowerResult, type ComputedInterval, type Condition, type CreateEvidenceReceiptInput, type DecisionBranch, type DecisionOutcome, type DecisionRule, type DerivedQuantities, type EProcess, type EProcessOptions, type EProcessState, type EProcessStep, type Estimand, type EstimandResult, type EvaluationClaim, type EvaluationUnitSummary, type EvidenceAuthority, type EvidenceAuthorityKind, type EvidenceBinding, type EvidenceDenominator, type EvidenceReceipt, type EvidenceReceiptVerification, type EvidenceRecord, type EvidenceRegistryRecord, type EvidenceState, type EvidenceVector, type ExperimentFunnel, type ExperimentGateEvidence, type ExperimentSpec, FinalEvidenceConflictError, FinalEvidenceError, type FinalEvidenceLedger, type FinalEvidenceMeasurement, type FinalEvidenceOutcome, type FinalEvidenceRecord, type FinalEvidenceReservation, type FunnelPartitionCount, type FunnelStageCount, type FunnelStageInput, type HaltOutcome, type HaltRule, type HeldoutSignificance, type HeldoutSignificanceOptions, type HypothesisManifest, type HypothesisResult, type IntervalSpec, type JsonValue, type MatchedBudgetRule, type MatchedBudgetVerdict, type MatchedPair, type NLadderProjection, type Obligation, type OutcomeSpec, type PairArmsOptions, type PairArmsResult, type PairedArmRow, type PairedBootstrapOptions, type PairedBootstrapResult, type PairedEvalueOptions, type PairedEvalueSequence, type PairedEvalueStep, type PairedHoldout, type PowerPreflight, type PowerPreflightOptions, type Predicate, type PromotionPolicy, type ProportionInterval, type ProspectiveCanaryAssignment, type ProspectiveCanaryBilling, type ProspectiveCanaryExecution, type ProspectiveCanaryJoinInput, type ProspectiveCanaryOutcome, type RandomizedCanaryDecision, type RandomizedCanaryRule, type RegisteredExperiment, type ReissuePolicy, type ReissueVerdict, type SealAmendment, type SealedExperiment, type SealedRandomizedCanaryRule, type SeedDerivation, type SelectionRule, type SequentialCrossingHorizon, type SequentialCrossingHorizonOptions, type SequentialGateDecision, type SequentialObservation, type SequentialPairedGate, type SequentialPairedGateOptions, type SetExpr, type SignFlipFloor, type SignedManifest, type SignedManifestAlgo, type UniformPassDecision, type UniformPassSchedule, type ValidityGate, type ValidityGateResult, benjaminiHochberg, bonferroni, buildEvidenceVector, comparePairedArms, computeInterval, createCampaignEvidenceReceipt, createEvidenceReceipt, defineEvaluationClaim, eProcess, hashJson, heldoutSignificance, holm, isIndependentEvidence, manifestContentDigest, mcnemar, mcnemarPower, mcnemarRequiredN, mulberry32, openFinalEvidenceLedger, pairArms, pairHoldout, pairRunRecords, pairedBootstrap, pairedEvalueSequence, pairedMde, pairedRiskDifference, pairedRiskDifferenceExact, pairedRiskDifferenceScore, paretoPolicy, paretoSignificanceGate, powerPreflight, requiredPairedSampleSize, requiredSampleSize, sequentialDecide, sequentialPairedGate, signManifest, summarizeEvaluationUnits, verifyEvidenceReceipt, verifyManifest, wilson };
+export { type AdmissionExecution, type AdmissionPartition, type AdmissionRule, type AdmissionStage, type ArmAssignment, type ArmPopulationReading, type ArmPopulationSummary, type ArmRealizedBudget, type ArmSpec, BOOTSTRAP_GATE_MIN_N, type BudgetRule, type CampaignEvidenceContext, type CanaryArm, type CanaryAssignmentReceipt, type CanaryCohortReceipt, type CanaryCohortVerifier, type CanaryObservation, type CanaryRefusal, type ClusteredPowerOptions, type ClusteredPowerPoint, type ClusteredPowerRefusal, type ClusteredPowerResult, type ComputedInterval, type Condition, type CreateEvidenceReceiptInput, type DecisionBranch, type DecisionOutcome, type DecisionRule, type DerivedQuantities, type EProcess, type EProcessOptions, type EProcessState, type EProcessStep, type Estimand, type EstimandResult, type EvaluationClaim, type EvaluationUnitSummary, type EvidenceAuthority, type EvidenceAuthorityKind, type EvidenceBinding, type EvidenceDenominator, type EvidenceReceipt, type EvidenceReceiptVerification, type EvidenceRecord, type EvidenceRegistryRecord, type EvidenceState, type EvidenceVector, type ExperimentFunnel, type ExperimentGateEvidence, type ExperimentSpec, FinalEvidenceConflictError, FinalEvidenceError, type FinalEvidenceLedger, type FinalEvidenceMeasurement, type FinalEvidenceOutcome, type FinalEvidenceRecord, type FinalEvidenceReservation, type FunnelPartitionCount, type FunnelStageCount, type FunnelStageInput, type HaltOutcome, type HaltRule, type HeldoutSignificance, type HeldoutSignificanceOptions, type HypothesisManifest, type HypothesisResult, type IntervalSpec, type JsonValue, type MatchedBudgetRule, type MatchedBudgetVerdict, type MatchedPair, type NLadderProjection, type Obligation, type OutcomeSpec, type PairArmsOptions, type PairArmsResult, type PairedArmRow, type PairedBootstrapOptions, type PairedBootstrapResult, type PairedEvalueOptions, type PairedEvalueSequence, type PairedEvalueStep, type PairedHoldout, type PowerPreflight, type PowerPreflightOptions, type Predicate, type PromotionPolicy, type ProportionInterval, type ProspectiveCanaryAssignment, type ProspectiveCanaryBilling, type ProspectiveCanaryExecution, type ProspectiveCanaryJoinInput, type ProspectiveCanaryOutcome, type RandomizedCanaryDecision, type RandomizedCanaryRule, type RegisteredExperiment, type ReissuePolicy, type ReissueVerdict, type SealAmendment, type SealedExperiment, type SealedRandomizedCanaryRule, type SeedDerivation, type SelectionRule, type SequentialCrossingHorizon, type SequentialCrossingHorizonOptions, type SequentialGateDecision, type SequentialObservation, type SequentialPairedGate, type SequentialPairedGateOptions, type SetExpr, type SignFlipFloor, type SignedManifest, type SignedManifestAlgo, type UniformPassDecision, type UniformPassSchedule, type ValidityGate, type ValidityGateResult, benjaminiHochberg, bonferroni, buildEvidenceVector, comparePairedArms, computeInterval, createCampaignEvidenceReceipt, createEvidenceReceipt, defineEvaluationClaim, eProcess, hashJson, heldoutSignificance, holm, isIndependentEvidence, manifestContentDigest, mcnemar, mcnemarPower, mcnemarRequiredN, mulberry32, openFinalEvidenceLedger, pairArms, pairHoldout, pairRunRecords, pairedBootstrap, pairedEvalueSequence, pairedMde, pairedRiskDifference, pairedRiskDifferenceExact, pairedRiskDifferenceScore, paretoPolicy, paretoSignificanceGate, powerPreflight, requiredPairedSampleSize, requiredSampleSize, sequentialDecide, sequentialPairedGate, signManifest, summarizeEvaluationUnits, verifyEvidenceReceipt, verifyManifest, wilson };
 //# sourceMappingURL=index.d.ts.map

package/dist/experiment/index.js

@@ -1,12 +1,12 @@
 import { n as CaptureIntegrityError, s as ValidationError } from "../errors-BcOs5MKW.js";
 import { a as hashCanonical, t as LEDGER_HASH_PATTERN } from "../canonical-Dq2hOQ8L.js";
 import { d as signManifest, f as verifyManifest, l as hashJson, u as manifestContentDigest } from "../agent-profile-cell-B1V1gUZs.js";
+import { n as pairArms, r as pairRunRecords, t as comparePairedArms } from "../paired-arms-B2ttLc0_.js";
 import { t as mulberry32 } from "../random-DDDcC7YU.js";
-import { n as pairArms, r as pairRunRecords, t as comparePairedArms } from "../paired-arms-Ct4LTKc1.js";
 import { n as bonferroni, r as holm, t as benjaminiHochberg } from "../multiplicity-Sg0U7h8j.js";
 import { a as pairedRiskDifferenceScore, i as pairedRiskDifferenceExact, r as pairedRiskDifference, s as wilson, t as mcnemar } from "../paired-binary-B_nejA44.js";
 import { c as studentTCdf, i as pairedBootstrap, l as studentTQuantile, n as BOOTSTRAP_GATE_MIN_N } from "../mean-BbA_JCzW.js";
-import { a as requiredSampleSize, i as requiredPairedSampleSize, n as mcnemarRequiredN, r as pairedMde, t as mcnemarPower } from "../power-and-mde-N5nU4_Ly.js";
+import { a as requiredSampleSize, i as requiredPairedSampleSize, n as mcnemarRequiredN, r as pairedMde, t as mcnemarPower } from "../power-and-mde-CQX-0weG.js";
 import { t as eProcess } from "../sequential-eprocess-DodI6RoF.js";
 import { a as heldoutSignificance, o as pairHoldout } from "../statistical-heldout-Bksv92Th.js";
 import { S as openFinalEvidenceLedger, b as FinalEvidenceConflictError, i as verifyEvidenceReceipt, n as createEvidenceReceipt, r as isIndependentEvidence, t as createCampaignEvidenceReceipt, x as FinalEvidenceError, y as powerPreflight } from "../campaign-evidence-DunzcJGv.js";

package/dist/{external-optimizer-process-wOLfzsCC.js → external-optimizer-process-E5yY2SYS.js}

@@ -1,5 +1,5 @@
 import { n as contentHash } from "./verdict-cache-CL_7tePD.js";
-import { _ as resolveExternalOptimizerCallbackLimits, a as closeServer, c as waitForActiveHandlers, h as isExternalTextCandidate, o as listenLocal, s as sendJsonIfOpen } from "./external-optimizer-subprocess-D670Oxf2.js";
+import { _ as resolveExternalOptimizerCallbackLimits, a as closeServer, c as waitForActiveHandlers, h as isExternalTextCandidate, o as listenLocal, s as sendJsonIfOpen } from "./external-optimizer-subprocess-DA02c_L6.js";
 import { n as isRecord } from "./json-BhdsJaOQ.js";
 import { createServer } from "node:http";
 //#region src/campaign/external-optimizer-callback.ts
@@ -233,4 +233,4 @@ function cloneCandidate(candidate) {
 //#endregion
 export { startExternalOptimizerCallback as t };
 
-//# sourceMappingURL=external-optimizer-process-wOLfzsCC.js.map
+//# sourceMappingURL=external-optimizer-process-E5yY2SYS.js.map

package/dist/{external-optimizer-process-wOLfzsCC.js.map → external-optimizer-process-E5yY2SYS.js.map}

@@ -1 +1 @@
-{"version":3,"file":"external-optimizer-process-wOLfzsCC.js","names":[],"sources":["../src/campaign/external-optimizer-callback.ts"],"sourcesContent":["import { createServer, type IncomingMessage, type ServerResponse } from 'node:http'\nimport { contentHash } from '../verdict-cache'\nimport {\n  type ExternalOptimizerCallback,\n  type ExternalOptimizerCallbackLimits,\n  type ExternalOptimizerEvaluationObservation,\n  type ExternalTextCandidate,\n  type ExternalTextEvaluationRequest,\n  isExternalTextCandidate,\n  resolveExternalOptimizerCallbackLimits,\n} from './external-optimizer-contracts'\nimport { isRecord } from '../llm-client/json'\nimport {\n  closeServer,\n  listenLocal,\n  sendJsonIfOpen,\n  waitForActiveHandlers,\n} from './external-optimizer-http'\n\ntype UnsequencedObservation = ExternalOptimizerEvaluationObservation extends infer T\n  ? T extends ExternalOptimizerEvaluationObservation\n    ? Omit<T, 'sequence'>\n    : never\n  : never\n\nexport async function startExternalOptimizerCallback<TResponse>(args: {\n  token: string\n  maxEvaluations: number\n  acceptEvaluation?: () => number | undefined\n  evaluate: (request: ExternalTextEvaluationRequest, signal: AbortSignal) => Promise<TResponse>\n  observe?: (observation: ExternalOptimizerEvaluationObservation) => void\n  /** Loopback JSON byte limits. Omitted fields use finite defaults. */\n  limits?: Partial<ExternalOptimizerCallbackLimits>\n  signal?: AbortSignal\n}): Promise<ExternalOptimizerCallback> {\n  assertCallbackConfig(args)\n  const limits = resolveExternalOptimizerCallbackLimits(args.limits)\n  args.signal?.throwIfAborted()\n  let evaluations = 0\n  let accepting = true\n  let closePromise: Promise<void> | undefined\n  const activeControllers = new Set<AbortController>()\n  const activeHandlers = new Set<Promise<void>>()\n  const proposedCandidateHashes = new Set<string>()\n  let observationSequence = 0\n  const server = createServer((request, response) => {\n    if (!accepting) {\n      sendJsonIfOpen(response, 503, { error: 'external optimizer callback is closing' })\n      return\n    }\n\n    const controller = new AbortController()\n    const abortRequest = (): void => {\n      request.destroy()\n      response.destroy()\n    }\n    activeControllers.add(controller)\n    controller.signal.addEventListener('abort', abortRequest, { once: true })\n\n    let handler!: Promise<void>\n    handler = handleCallback(\n      request,\n      response,\n      controller.signal,\n      args,\n      limits,\n      () => {\n        const accepted = args.acceptEvaluation ? args.acceptEvaluation() : evaluations + 1\n        if (accepted === undefined) return undefined\n        if (!Number.isSafeInteger(accepted) || accepted <= 0) {\n          throw new Error('external optimizer callback: invalid accepted evaluation count')\n        }\n        if (accepted > args.maxEvaluations) return undefined\n        evaluations += 1\n        return accepted\n      },\n      (observation) => {\n        if (!args.observe) return\n        args.observe({ ...observation, sequence: ++observationSequence })\n      },\n      proposedCandidateHashes,\n    ).finally(() => {\n      controller.signal.removeEventListener('abort', abortRequest)\n      activeControllers.delete(controller)\n      activeHandlers.delete(handler)\n    })\n    activeHandlers.add(handler)\n    void handler.catch(() => undefined)\n  })\n  const port = await listenLocal(server)\n  const close = (): Promise<void> => {\n    closePromise ??= closeCallbackServer()\n    return closePromise\n  }\n  const onAbort = (): void => {\n    void close().catch(() => undefined)\n  }\n  args.signal?.addEventListener('abort', onAbort, { once: true })\n  if (args.signal?.aborted) onAbort()\n  return {\n    url: `http://127.0.0.1:${port}/evaluate`,\n    token: args.token,\n    evaluations: () => evaluations,\n    close,\n  }\n\n  async function closeCallbackServer(): Promise<void> {\n    args.signal?.removeEventListener('abort', onAbort)\n    accepting = false\n    const closingServer = closeServer(server)\n    server.closeIdleConnections?.()\n    for (const controller of activeControllers) controller.abort()\n    const [serverResult] = await Promise.allSettled([\n      closingServer,\n      waitForActiveHandlers(activeHandlers),\n    ])\n    if (activeControllers.size !== 0 || activeHandlers.size !== 0) {\n      throw new Error('external optimizer callback closed with active request work')\n    }\n    if (serverResult?.status === 'rejected') throw serverResult.reason\n  }\n}\n\nasync function handleCallback<TResponse>(\n  request: IncomingMessage,\n  response: ServerResponse,\n  signal: AbortSignal,\n  args: {\n    token: string\n    maxEvaluations: number\n    acceptEvaluation?: () => number | undefined\n    evaluate: (request: ExternalTextEvaluationRequest, signal: AbortSignal) => Promise<TResponse>\n    observe?: (observation: ExternalOptimizerEvaluationObservation) => void\n  },\n  limits: ExternalOptimizerCallbackLimits,\n  nextEvaluation: () => number | undefined,\n  observe: (observation: UnsequencedObservation) => void,\n  proposedCandidateHashes: Set<string>,\n): Promise<void> {\n  try {\n    if (request.method !== 'POST' || request.url !== '/evaluate') {\n      sendJsonIfOpen(response, 404, { error: 'not found' })\n      return\n    }\n    if (request.headers.authorization !== `Bearer ${args.token}`) {\n      sendJsonIfOpen(response, 401, { error: 'unauthorized' })\n      return\n    }\n    let body: unknown\n    try {\n      body = await readJson(request, limits.maxRequestBytes)\n    } catch {\n      observe({ kind: 'refusal', reason: 'invalid-request' })\n      sendJsonIfOpen(response, 400, { error: 'request body must be bounded valid JSON' })\n      return\n    }\n    if (\n      !isRecord(body) ||\n      !isExternalTextCandidate(body.candidate) ||\n      typeof body.exampleId !== 'string'\n    ) {\n      observe({ kind: 'refusal', reason: 'invalid-request' })\n      sendJsonIfOpen(response, 400, { error: 'candidate and exampleId are required strings' })\n      return\n    }\n    const candidate = cloneCandidate(body.candidate)\n    const candidateHash = contentHash({ kind: 'external-text-candidate', candidate })\n    if (!proposedCandidateHashes.has(candidateHash)) {\n      observe({ kind: 'proposal', candidate, candidateHash })\n      proposedCandidateHashes.add(candidateHash)\n    }\n    const count = nextEvaluation()\n    if (count === undefined) {\n      observe({\n        kind: 'refusal',\n        reason: 'evaluation-limit',\n        candidate,\n        candidateHash,\n        exampleId: body.exampleId,\n      })\n      sendJsonIfOpen(response, 429, { error: 'evaluation limit reached' })\n      return\n    }\n    let result: TResponse\n    try {\n      result = await args.evaluate({ candidate, exampleId: body.exampleId }, signal)\n    } catch (error) {\n      observe({\n        kind: 'refusal',\n        reason: 'evaluation-failed',\n        candidate,\n        candidateHash,\n        exampleId: body.exampleId,\n      })\n      // The thrown detail is the only diagnostic for a failed evaluation —\n      // an opaque 500 costs the caller a blind debugging round.\n      sendJsonIfOpen(response, 500, {\n        error: `evaluation failed: ${String(error).slice(0, 400)}`,\n      })\n      return\n    }\n    let encoded: string\n    try {\n      encoded = encodeJsonResponse(result)\n    } catch {\n      observe({\n        kind: 'refusal',\n        reason: 'evaluation-failed',\n        candidate,\n        candidateHash,\n        exampleId: body.exampleId,\n      })\n      sendJsonIfOpen(response, 500, { error: 'evaluation response must be valid JSON' })\n      return\n    }\n    if (Buffer.byteLength(encoded) > limits.maxResponseBytes) {\n      observe({\n        kind: 'refusal',\n        reason: 'evaluation-failed',\n        candidate,\n        candidateHash,\n        exampleId: body.exampleId,\n      })\n      sendJsonIfOpen(response, 413, { error: 'evaluation response too large' })\n      return\n    }\n    observe({\n      kind: 'evaluation',\n      candidate,\n      candidateHash,\n      exampleId: body.exampleId,\n      evaluationNumber: count,\n      response: structuredClone(result),\n    })\n    sendEncodedJsonIfOpen(response, 200, encoded)\n  } catch {\n    sendJsonIfOpen(response, 500, { error: 'evaluation failed' })\n  }\n}\n\nfunction readJson(request: IncomingMessage, maxRequestBytes: number): Promise<unknown> {\n  return new Promise((resolvePromise, reject) => {\n    let size = 0\n    const chunks: Buffer[] = []\n    request.on('data', (chunk: Buffer) => {\n      size += chunk.length\n      if (size > maxRequestBytes) {\n        reject(new Error('callback body too large'))\n        request.destroy()\n        return\n      }\n      chunks.push(chunk)\n    })\n    request.on('error', reject)\n    request.on('end', () => {\n      try {\n        resolvePromise(JSON.parse(Buffer.concat(chunks).toString('utf8')))\n      } catch (error) {\n        reject(error)\n      }\n    })\n  })\n}\n\nfunction encodeJsonResponse(value: unknown): string {\n  const encoded = JSON.stringify(value)\n  if (encoded === undefined) throw new Error('evaluation response must be JSON-serializable')\n  return encoded\n}\n\nfunction sendEncodedJsonIfOpen(response: ServerResponse, status: number, encoded: string): void {\n  if (response.destroyed || response.writableEnded) return\n  response.writeHead(status, {\n    'content-type': 'application/json; charset=utf-8',\n    'content-length': String(Buffer.byteLength(encoded)),\n  })\n  response.end(encoded)\n}\n\nfunction assertCallbackConfig(args: {\n  token: string\n  maxEvaluations: number\n  acceptEvaluation?: () => number | undefined\n  evaluate: (request: ExternalTextEvaluationRequest, signal: AbortSignal) => Promise<unknown>\n  observe?: (observation: ExternalOptimizerEvaluationObservation) => void\n  limits?: Partial<ExternalOptimizerCallbackLimits>\n  signal?: AbortSignal\n}): void {\n  if (typeof args.token !== 'string' || !args.token.trim()) {\n    throw new Error('external optimizer callback: token must be non-empty')\n  }\n  if (!Number.isSafeInteger(args.maxEvaluations) || args.maxEvaluations <= 0) {\n    throw new Error('external optimizer callback: maxEvaluations must be a positive safe integer')\n  }\n  if (args.acceptEvaluation !== undefined && typeof args.acceptEvaluation !== 'function') {\n    throw new Error('external optimizer callback: acceptEvaluation must be a function')\n  }\n  if (typeof args.evaluate !== 'function') {\n    throw new Error('external optimizer callback: evaluate must be a function')\n  }\n  if (args.observe !== undefined && typeof args.observe !== 'function') {\n    throw new Error('external optimizer callback: observe must be a function')\n  }\n}\n\nfunction cloneCandidate(candidate: ExternalTextCandidate): ExternalTextCandidate {\n  return typeof candidate === 'string' ? candidate : { ...candidate }\n}\n"],"mappings":"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"}
+{"version":3,"file":"external-optimizer-process-E5yY2SYS.js","names":[],"sources":["../src/campaign/external-optimizer-callback.ts"],"sourcesContent":["import { createServer, type IncomingMessage, type ServerResponse } from 'node:http'\nimport { contentHash } from '../verdict-cache'\nimport {\n  type ExternalOptimizerCallback,\n  type ExternalOptimizerCallbackLimits,\n  type ExternalOptimizerEvaluationObservation,\n  type ExternalTextCandidate,\n  type ExternalTextEvaluationRequest,\n  isExternalTextCandidate,\n  resolveExternalOptimizerCallbackLimits,\n} from './external-optimizer-contracts'\nimport { isRecord } from '../llm-client/json'\nimport {\n  closeServer,\n  listenLocal,\n  sendJsonIfOpen,\n  waitForActiveHandlers,\n} from './external-optimizer-http'\n\ntype UnsequencedObservation = ExternalOptimizerEvaluationObservation extends infer T\n  ? T extends ExternalOptimizerEvaluationObservation\n    ? Omit<T, 'sequence'>\n    : never\n  : never\n\nexport async function startExternalOptimizerCallback<TResponse>(args: {\n  token: string\n  maxEvaluations: number\n  acceptEvaluation?: () => number | undefined\n  evaluate: (request: ExternalTextEvaluationRequest, signal: AbortSignal) => Promise<TResponse>\n  observe?: (observation: ExternalOptimizerEvaluationObservation) => void\n  /** Loopback JSON byte limits. Omitted fields use finite defaults. */\n  limits?: Partial<ExternalOptimizerCallbackLimits>\n  signal?: AbortSignal\n}): Promise<ExternalOptimizerCallback> {\n  assertCallbackConfig(args)\n  const limits = resolveExternalOptimizerCallbackLimits(args.limits)\n  args.signal?.throwIfAborted()\n  let evaluations = 0\n  let accepting = true\n  let closePromise: Promise<void> | undefined\n  const activeControllers = new Set<AbortController>()\n  const activeHandlers = new Set<Promise<void>>()\n  const proposedCandidateHashes = new Set<string>()\n  let observationSequence = 0\n  const server = createServer((request, response) => {\n    if (!accepting) {\n      sendJsonIfOpen(response, 503, { error: 'external optimizer callback is closing' })\n      return\n    }\n\n    const controller = new AbortController()\n    const abortRequest = (): void => {\n      request.destroy()\n      response.destroy()\n    }\n    activeControllers.add(controller)\n    controller.signal.addEventListener('abort', abortRequest, { once: true })\n\n    let handler!: Promise<void>\n    handler = handleCallback(\n      request,\n      response,\n      controller.signal,\n      args,\n      limits,\n      () => {\n        const accepted = args.acceptEvaluation ? args.acceptEvaluation() : evaluations + 1\n        if (accepted === undefined) return undefined\n        if (!Number.isSafeInteger(accepted) || accepted <= 0) {\n          throw new Error('external optimizer callback: invalid accepted evaluation count')\n        }\n        if (accepted > args.maxEvaluations) return undefined\n        evaluations += 1\n        return accepted\n      },\n      (observation) => {\n        if (!args.observe) return\n        args.observe({ ...observation, sequence: ++observationSequence })\n      },\n      proposedCandidateHashes,\n    ).finally(() => {\n      controller.signal.removeEventListener('abort', abortRequest)\n      activeControllers.delete(controller)\n      activeHandlers.delete(handler)\n    })\n    activeHandlers.add(handler)\n    void handler.catch(() => undefined)\n  })\n  const port = await listenLocal(server)\n  const close = (): Promise<void> => {\n    closePromise ??= closeCallbackServer()\n    return closePromise\n  }\n  const onAbort = (): void => {\n    void close().catch(() => undefined)\n  }\n  args.signal?.addEventListener('abort', onAbort, { once: true })\n  if (args.signal?.aborted) onAbort()\n  return {\n    url: `http://127.0.0.1:${port}/evaluate`,\n    token: args.token,\n    evaluations: () => evaluations,\n    close,\n  }\n\n  async function closeCallbackServer(): Promise<void> {\n    args.signal?.removeEventListener('abort', onAbort)\n    accepting = false\n    const closingServer = closeServer(server)\n    server.closeIdleConnections?.()\n    for (const controller of activeControllers) controller.abort()\n    const [serverResult] = await Promise.allSettled([\n      closingServer,\n      waitForActiveHandlers(activeHandlers),\n    ])\n    if (activeControllers.size !== 0 || activeHandlers.size !== 0) {\n      throw new Error('external optimizer callback closed with active request work')\n    }\n    if (serverResult?.status === 'rejected') throw serverResult.reason\n  }\n}\n\nasync function handleCallback<TResponse>(\n  request: IncomingMessage,\n  response: ServerResponse,\n  signal: AbortSignal,\n  args: {\n    token: string\n    maxEvaluations: number\n    acceptEvaluation?: () => number | undefined\n    evaluate: (request: ExternalTextEvaluationRequest, signal: AbortSignal) => Promise<TResponse>\n    observe?: (observation: ExternalOptimizerEvaluationObservation) => void\n  },\n  limits: ExternalOptimizerCallbackLimits,\n  nextEvaluation: () => number | undefined,\n  observe: (observation: UnsequencedObservation) => void,\n  proposedCandidateHashes: Set<string>,\n): Promise<void> {\n  try {\n    if (request.method !== 'POST' || request.url !== '/evaluate') {\n      sendJsonIfOpen(response, 404, { error: 'not found' })\n      return\n    }\n    if (request.headers.authorization !== `Bearer ${args.token}`) {\n      sendJsonIfOpen(response, 401, { error: 'unauthorized' })\n      return\n    }\n    let body: unknown\n    try {\n      body = await readJson(request, limits.maxRequestBytes)\n    } catch {\n      observe({ kind: 'refusal', reason: 'invalid-request' })\n      sendJsonIfOpen(response, 400, { error: 'request body must be bounded valid JSON' })\n      return\n    }\n    if (\n      !isRecord(body) ||\n      !isExternalTextCandidate(body.candidate) ||\n      typeof body.exampleId !== 'string'\n    ) {\n      observe({ kind: 'refusal', reason: 'invalid-request' })\n      sendJsonIfOpen(response, 400, { error: 'candidate and exampleId are required strings' })\n      return\n    }\n    const candidate = cloneCandidate(body.candidate)\n    const candidateHash = contentHash({ kind: 'external-text-candidate', candidate })\n    if (!proposedCandidateHashes.has(candidateHash)) {\n      observe({ kind: 'proposal', candidate, candidateHash })\n      proposedCandidateHashes.add(candidateHash)\n    }\n    const count = nextEvaluation()\n    if (count === undefined) {\n      observe({\n        kind: 'refusal',\n        reason: 'evaluation-limit',\n        candidate,\n        candidateHash,\n        exampleId: body.exampleId,\n      })\n      sendJsonIfOpen(response, 429, { error: 'evaluation limit reached' })\n      return\n    }\n    let result: TResponse\n    try {\n      result = await args.evaluate({ candidate, exampleId: body.exampleId }, signal)\n    } catch (error) {\n      observe({\n        kind: 'refusal',\n        reason: 'evaluation-failed',\n        candidate,\n        candidateHash,\n        exampleId: body.exampleId,\n      })\n      // The thrown detail is the only diagnostic for a failed evaluation —\n      // an opaque 500 costs the caller a blind debugging round.\n      sendJsonIfOpen(response, 500, {\n        error: `evaluation failed: ${String(error).slice(0, 400)}`,\n      })\n      return\n    }\n    let encoded: string\n    try {\n      encoded = encodeJsonResponse(result)\n    } catch {\n      observe({\n        kind: 'refusal',\n        reason: 'evaluation-failed',\n        candidate,\n        candidateHash,\n        exampleId: body.exampleId,\n      })\n      sendJsonIfOpen(response, 500, { error: 'evaluation response must be valid JSON' })\n      return\n    }\n    if (Buffer.byteLength(encoded) > limits.maxResponseBytes) {\n      observe({\n        kind: 'refusal',\n        reason: 'evaluation-failed',\n        candidate,\n        candidateHash,\n        exampleId: body.exampleId,\n      })\n      sendJsonIfOpen(response, 413, { error: 'evaluation response too large' })\n      return\n    }\n    observe({\n      kind: 'evaluation',\n      candidate,\n      candidateHash,\n      exampleId: body.exampleId,\n      evaluationNumber: count,\n      response: structuredClone(result),\n    })\n    sendEncodedJsonIfOpen(response, 200, encoded)\n  } catch {\n    sendJsonIfOpen(response, 500, { error: 'evaluation failed' })\n  }\n}\n\nfunction readJson(request: IncomingMessage, maxRequestBytes: number): Promise<unknown> {\n  return new Promise((resolvePromise, reject) => {\n    let size = 0\n    const chunks: Buffer[] = []\n    request.on('data', (chunk: Buffer) => {\n      size += chunk.length\n      if (size > maxRequestBytes) {\n        reject(new Error('callback body too large'))\n        request.destroy()\n        return\n      }\n      chunks.push(chunk)\n    })\n    request.on('error', reject)\n    request.on('end', () => {\n      try {\n        resolvePromise(JSON.parse(Buffer.concat(chunks).toString('utf8')))\n      } catch (error) {\n        reject(error)\n      }\n    })\n  })\n}\n\nfunction encodeJsonResponse(value: unknown): string {\n  const encoded = JSON.stringify(value)\n  if (encoded === undefined) throw new Error('evaluation response must be JSON-serializable')\n  return encoded\n}\n\nfunction sendEncodedJsonIfOpen(response: ServerResponse, status: number, encoded: string): void {\n  if (response.destroyed || response.writableEnded) return\n  response.writeHead(status, {\n    'content-type': 'application/json; charset=utf-8',\n    'content-length': String(Buffer.byteLength(encoded)),\n  })\n  response.end(encoded)\n}\n\nfunction assertCallbackConfig(args: {\n  token: string\n  maxEvaluations: number\n  acceptEvaluation?: () => number | undefined\n  evaluate: (request: ExternalTextEvaluationRequest, signal: AbortSignal) => Promise<unknown>\n  observe?: (observation: ExternalOptimizerEvaluationObservation) => void\n  limits?: Partial<ExternalOptimizerCallbackLimits>\n  signal?: AbortSignal\n}): void {\n  if (typeof args.token !== 'string' || !args.token.trim()) {\n    throw new Error('external optimizer callback: token must be non-empty')\n  }\n  if (!Number.isSafeInteger(args.maxEvaluations) || args.maxEvaluations <= 0) {\n    throw new Error('external optimizer callback: maxEvaluations must be a positive safe integer')\n  }\n  if (args.acceptEvaluation !== undefined && typeof args.acceptEvaluation !== 'function') {\n    throw new Error('external optimizer callback: acceptEvaluation must be a function')\n  }\n  if (typeof args.evaluate !== 'function') {\n    throw new Error('external optimizer callback: evaluate must be a function')\n  }\n  if (args.observe !== undefined && typeof args.observe !== 'function') {\n    throw new Error('external optimizer callback: observe must be a function')\n  }\n}\n\nfunction cloneCandidate(candidate: ExternalTextCandidate): ExternalTextCandidate {\n  return typeof candidate === 'string' ? candidate : { ...candidate }\n}\n"],"mappings":"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"}

package/dist/{external-optimizer-subprocess-D670Oxf2.js → external-optimizer-subprocess-DA02c_L6.js}

@@ -1,9 +1,10 @@
 import { c as errorMessage } from "./errors-BcOs5MKW.js";
+import { a as findingTreatmentSchema, c as findingEvidenceRefSchema, i as findingConditionsSchema, s as findingCalibrationSchema } from "./finding-composition-8n0fFgVI.js";
 import { t as canonicalJson } from "./verdict-cache-CL_7tePD.js";
 import { c as costForTokenPricing, t as CostLedger } from "./cost-ledger-BGZB6yY2.js";
 import { t as deepFreezeCanonicalJson } from "./deep-freeze-CurcOQg3.js";
 import { n as appendSearchLedgerLine, r as tryWithSearchLedgerFileLock } from "./search-ledger-file-Bd5Tioq6.js";
-import { n as FINDING_SCOPE_FIELDS, t as ANALYST_SEVERITIES } from "./types-DqFMNTgK.js";
+import { n as FINDING_SCOPE_FIELDS, t as ANALYST_SEVERITIES } from "./types-CnWmj8NW.js";
 import { n as isRecord } from "./json-BhdsJaOQ.js";
 import { c as ModelSubstitutionError, d as assertServedModelPolicy, u as assertServedModel } from "./llm-client-DXuOTseU.js";
 import { t as isNonnegativeFiniteNumber } from "./nonnegative-number-DvdMxg_f.js";
@@ -183,11 +184,7 @@ const methodSchema = z.object({
 	]),
 	name: nonEmpty,
 	version: nonEmpty,
-	calibration: z.object({
-		gold_n: z.number().int().positive(),
-		agreement: unitRate,
-		kappa: finite.refine((value) => value >= -1 && value <= 1, { message: "must be in [-1,1]" })
-	}).strict().optional()
+	calibration: findingCalibrationSchema.optional()
 }).strict();
 const measureSchema = z.object({
 	name: nonEmpty,
@@ -210,17 +207,7 @@ const findingObject = z.object({
 	area: nonEmpty,
 	claim: nonEmpty,
 	rationale: z.string().optional(),
-	evidence_refs: z.array(z.object({
-		kind: z.enum([
-			"span",
-			"event",
-			"artifact",
-			"finding",
-			"metric"
-		]),
-		uri: nonEmpty,
-		excerpt: z.string().optional()
-	}).strict()),
+	evidence_refs: z.array(findingEvidenceRefSchema),
 	recommended_action: z.string().optional(),
 	validation_plan: z.string().optional(),
 	confidence: unitRate,
@@ -234,7 +221,9 @@ const findingObject = z.object({
 	confounders: z.array(nonEmpty).optional(),
 	valid_for: nonEmpty.optional(),
 	claim_id: nonEmpty.optional(),
-	evidence_units: z.array(evidenceUnitSchema).min(1).optional()
+	evidence_units: z.array(evidenceUnitSchema).min(1).optional(),
+	treatment: z.array(findingTreatmentSchema).optional(),
+	conditions: z.array(findingConditionsSchema).optional()
 }).strict();
 function checkFinding(finding, context) {
 	const issue = (path, message) => context.addIssue({
@@ -258,6 +247,10 @@ function checkFinding(finding, context) {
 	if (measure?.interval && measure.interval[0] > measure.interval[1]) issue(["measure", "interval"], "interval lower bound exceeds its upper bound");
 	if (measure?.level !== void 0 && measure.interval === void 0) issue(["measure", "level"], "level describes an interval; none is present");
 	if (finding.method?.kind !== "judged" && finding.method?.calibration !== void 0) issue(["method", "calibration"], "only judged findings carry a calibration");
+	for (const field of ["treatment", "conditions"]) {
+		const values = finding[field];
+		if (values && new Set(values.map((value) => value.id)).size !== values.length) issue([field], "composition ids must be unique");
+	}
 	if (!units) return;
 	const ids = units.map((unit) => unit.id);
 	if (new Set(ids).size !== ids.length) issue(["evidence_units"], "unit ids must be unique");
@@ -2160,4 +2153,4 @@ function summarizeProcessOutput(capture, max = 4e3) {
 //#endregion
 export { spanningWindow as A, UNKNOWN_LINEAGE as C, mostSevere as D, mergeEvidenceUnits as E, fsCampaignStorage as M, inMemoryCampaignStorage as N, parseAnalystFinding as O, ProposalFindingSchema as S, lineageRoots as T, resolveExternalOptimizerCallbackLimits as _, closeServer as a, AnalystFindingSchema as b, waitForActiveHandlers as c, assertExternalOptimizerModelBudget as d, assertJsonValue as f, removeCredentialEnvironment as g, isExternalTextCandidate as h, startExternalOptimizerModelProxy as i, createRunCostLedger as j, readFindingScope as k, DEFAULT_EXTERNAL_OPTIMIZER_CALLBACK_LIMITS as l, isCandidateText as m, closeExternalOptimizerResources as n, listenLocal as o, assertNoCredentialValues as p, runWithCleanup as r, sendJsonIfOpen as s, runExternalOptimizerProcess as t, DEFAULT_EXTERNAL_OPTIMIZER_PROCESS_LIMITS as u, resolveExternalOptimizerProcessLimits as v, independentUnitCount as w, FINDING_LAYERS as x, safePathComponent as y };
 
-//# sourceMappingURL=external-optimizer-subprocess-D670Oxf2.js.map
+//# sourceMappingURL=external-optimizer-subprocess-DA02c_L6.js.map