@tangle-network/agent-eval 0.216.0 → 0.216.1

package/dist/cost-ledger-BP8V4kUQ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-ledger-BP8V4kUQ.js","names":[],"sources":["../src/cost-ledger/validation.ts","../src/cost-ledger/pricing.ts","../src/cost-ledger/receipts.ts","../src/cost-ledger/errors.ts","../src/cost-ledger/journal.ts","../src/cost-ledger/summary.ts","../src/cost-ledger.ts"],"sourcesContent":["/** Validate cost and usage primitives without admitting work or consulting pricing. */\nimport { z } from 'zod'\nimport { ValidationError } from '../errors'\nimport type { CostUsage } from './contract'\n\nexport function toError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value))\n}\n\nexport function validationMessage(cause: unknown): string {\n  return cause instanceof z.ZodError ? z.prettifyError(cause) : toError(cause).message\n}\n\nexport function assertUsage(usage: CostUsage): void {\n  assertTokenCount(usage.inputTokens, 'inputTokens')\n  assertTokenCount(usage.outputTokens, 'outputTokens')\n  if (usage.reasoningTokens !== undefined) {\n    assertTokenCount(usage.reasoningTokens, 'reasoningTokens')\n    if (usage.reasoningTokens > usage.outputTokens) {\n      throw new ValidationError('CostLedger: reasoningTokens must not exceed outputTokens')\n    }\n  }\n  if (usage.cachedTokens !== undefined) assertTokenCount(usage.cachedTokens, 'cachedTokens')\n  if (usage.cacheWriteTokens !== undefined) {\n    assertTokenCount(usage.cacheWriteTokens, 'cacheWriteTokens')\n  }\n}\n\nexport function assertTokenCount(value: unknown, name: string): asserts value is number {\n  if (typeof value !== 'number' || !Number.isInteger(value) || value < 0) {\n    throw new ValidationError(\n      `CostLedger: ${name} must be a non-negative integer, got ${String(value)}`,\n    )\n  }\n}\n\nexport function assertNonNegative(value: unknown, name: string): asserts value is number {\n  if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {\n    throw new ValidationError(\n      `CostLedger: ${name} must be a non-negative finite number, got ${String(value)}`,\n    )\n  }\n}\n\nexport function assertTimeout(value: unknown, name: string): asserts value is number {\n  if (\n    typeof value !== 'number' ||\n    !Number.isSafeInteger(value) ||\n    value < 0 ||\n    value > 2_147_483_647\n  ) {\n    throw new ValidationError(\n      `CostLedger: ${name} must be a non-negative safe integer no greater than 2147483647, got ${String(value)}`,\n    )\n  }\n}\n\nexport function assertString(value: unknown, name: string): asserts value is string {\n  if (typeof value !== 'string' || value.trim().length === 0) {\n    throw new ValidationError(`CostLedger: ${name} must be a non-empty string`)\n  }\n}\n","/** Model-price lookup and caller-supplied token pricing, including receipt snapshots. */\nimport { estimateCost, isModelPriced, resolveModelPricing } from '../metrics'\nimport type { CostReceipt, CostUsage, CustomTokenPricing } from './contract'\nimport { assertNonNegative, assertTokenCount, assertUsage } from './validation'\n\n/** Return the canonical pricing-table key, or null when the model is unpriced. */\nexport function modelPriceKey(model: string): string | null {\n  return isModelPriced(model) ? model : null\n}\n\nexport interface CostResult {\n  costUsd: number\n  costUnknown: boolean\n}\n\nexport function costForUsage(model: string, usage: CostUsage): CostResult {\n  assertUsage(usage)\n  if (!resolveModelPricing(model)) return { costUsd: 0, costUnknown: true }\n  return {\n    costUsd: estimateCost(\n      usage.inputTokens + (usage.cachedTokens ?? 0) + (usage.cacheWriteTokens ?? 0),\n      usage.outputTokens,\n      model,\n    ),\n    costUnknown: false,\n  }\n}\n\n/** Price token counts with caller-supplied per-million rates. */\nexport function costForTokenPricing(\n  pricing: CustomTokenPricing,\n  usage: Pick<CostUsage, 'inputTokens' | 'outputTokens' | 'cachedTokens' | 'cacheWriteTokens'>,\n): number {\n  assertTokenCount(usage.inputTokens, 'usage.inputTokens')\n  assertTokenCount(usage.outputTokens, 'usage.outputTokens')\n  if (usage.cachedTokens !== undefined) {\n    assertTokenCount(usage.cachedTokens, 'usage.cachedTokens')\n  }\n  if (usage.cacheWriteTokens !== undefined) {\n    assertTokenCount(usage.cacheWriteTokens, 'usage.cacheWriteTokens')\n  }\n  assertNonNegative(pricing.inputUsdPerMillion, 'pricing.inputUsdPerMillion')\n  if (pricing.cachedInputUsdPerMillion !== undefined) {\n    assertNonNegative(pricing.cachedInputUsdPerMillion, 'pricing.cachedInputUsdPerMillion')\n  }\n  if (pricing.cacheWriteUsdPerMillion !== undefined) {\n    assertNonNegative(pricing.cacheWriteUsdPerMillion, 'pricing.cacheWriteUsdPerMillion')\n  }\n  assertNonNegative(pricing.outputUsdPerMillion, 'pricing.outputUsdPerMillion')\n  const cachedInputRate = pricing.cachedInputUsdPerMillion ?? pricing.inputUsdPerMillion\n  const cacheWriteRate = pricing.cacheWriteUsdPerMillion ?? pricing.inputUsdPerMillion\n  return (\n    (usage.inputTokens / 1_000_000) * pricing.inputUsdPerMillion +\n    ((usage.cachedTokens ?? 0) / 1_000_000) * cachedInputRate +\n    ((usage.cacheWriteTokens ?? 0) / 1_000_000) * cacheWriteRate +\n    (usage.outputTokens / 1_000_000) * pricing.outputUsdPerMillion\n  )\n}\n\nexport function costFromPricing(\n  usage: CostUsage,\n  pricing: NonNullable<CostReceipt['pricing']>,\n): number {\n  const cachedInputRate = pricing.cachedInputUsdPerThousand ?? pricing.inputUsdPerThousand\n  const cacheWriteRate = pricing.cacheWriteUsdPerThousand ?? pricing.inputUsdPerThousand\n  return (\n    (usage.inputTokens / 1000) * pricing.inputUsdPerThousand +\n    ((usage.cachedTokens ?? 0) / 1000) * cachedInputRate +\n    ((usage.cacheWriteTokens ?? 0) / 1000) * cacheWriteRate +\n    (usage.outputTokens / 1000) * pricing.outputUsdPerThousand\n  )\n}\n\nexport function pricingSnapshot(pricing: CustomTokenPricing): NonNullable<CostReceipt['pricing']> {\n  costForTokenPricing(pricing, { inputTokens: 0, outputTokens: 0 })\n  return {\n    inputUsdPerThousand: pricing.inputUsdPerMillion / 1000,\n    ...(pricing.cachedInputUsdPerMillion === undefined\n      ? {}\n      : { cachedInputUsdPerThousand: pricing.cachedInputUsdPerMillion / 1000 }),\n    ...(pricing.cacheWriteUsdPerMillion === undefined\n      ? {}\n      : { cacheWriteUsdPerThousand: pricing.cacheWriteUsdPerMillion / 1000 }),\n    outputUsdPerThousand: pricing.outputUsdPerMillion / 1000,\n  }\n}\n","/** Create, validate, filter, and detach the receipts stored by a cost ledger. */\nimport { z } from 'zod'\nimport { ValidationError } from '../errors'\nimport { resolveModelPricing } from '../metrics'\nimport type {\n  CostCallBase,\n  CostLedgerFilter,\n  CostLedgerRecord,\n  CostReceipt,\n  CostReceiptInput,\n  CostUsage,\n  PendingCostCall,\n  RunPaidCallInput,\n} from './contract'\nimport { costForUsage, costFromPricing, pricingSnapshot } from './pricing'\nimport { assertNonNegative, assertString, assertUsage, validationMessage } from './validation'\n\nconst NonEmptyString = z.string().refine((value) => value.trim().length > 0, 'must be non-empty')\nexport const TokenCount = z.number().int().nonnegative().finite()\nexport const NonNegative = z.number().nonnegative().finite()\nconst Tags = z.record(NonEmptyString, z.string())\nconst CostPricingSchema = z.strictObject({\n  inputUsdPerThousand: NonNegative,\n  cachedInputUsdPerThousand: NonNegative.optional(),\n  cacheWriteUsdPerThousand: NonNegative.optional(),\n  outputUsdPerThousand: NonNegative,\n})\nconst CostCallBaseShape = {\n  callId: NonEmptyString,\n  channel: NonEmptyString,\n  phase: NonEmptyString,\n  actor: NonEmptyString,\n  model: NonEmptyString,\n  maximumCostUsd: NonNegative.optional(),\n  tags: Tags.optional(),\n  timestamp: NonNegative,\n}\nexport const PendingCostCallSchema = z.strictObject({\n  status: z.literal('pending'),\n  ...CostCallBaseShape,\n})\nconst CostReceiptBaseShape = {\n  status: z.literal('settled'),\n  ...CostCallBaseShape,\n  inputTokens: TokenCount,\n  outputTokens: TokenCount,\n  cachedTokens: TokenCount.optional(),\n  costUsd: NonNegative,\n  costUnknown: z.boolean(),\n  usageUnknown: z.boolean().default(false),\n  pricing: CostPricingSchema.optional(),\n  actualCostUsd: NonNegative.optional(),\n  estimatedCostUsd: NonNegative.optional(),\n  error: NonEmptyString.optional(),\n}\nexport const CostReceiptSchema = z\n  .strictObject({\n    ...CostReceiptBaseShape,\n    reasoningTokens: TokenCount.optional(),\n    cacheWriteTokens: TokenCount.optional(),\n  })\n  .superRefine((receipt, ctx) => validateCostReceipt(receipt, ctx))\n\nfunction validateCostReceipt(\n  receipt: CostUsage & {\n    costUsd: number\n    costUnknown: boolean\n    usageUnknown: boolean\n    pricing?: NonNullable<CostReceipt['pricing']>\n    actualCostUsd?: number\n    estimatedCostUsd?: number\n  },\n  ctx: z.RefinementCtx,\n): void {\n  if (receipt.reasoningTokens !== undefined && receipt.reasoningTokens > receipt.outputTokens) {\n    ctx.addIssue({ code: 'custom', message: 'reasoningTokens must not exceed outputTokens' })\n  }\n\n  if (receipt.actualCostUsd !== undefined && receipt.estimatedCostUsd !== undefined) {\n    ctx.addIssue({\n      code: 'custom',\n      message: 'actual and external estimated costs cannot both be present',\n    })\n  }\n\n  if (receipt.actualCostUsd !== undefined) {\n    if (receipt.costUnknown || receipt.costUsd !== receipt.actualCostUsd) {\n      ctx.addIssue({ code: 'custom', message: 'actual cost must be known and equal costUsd' })\n    }\n    if (receipt.pricing !== undefined) {\n      ctx.addIssue({ code: 'custom', message: 'actual cost must not include estimated pricing' })\n    }\n    return\n  }\n\n  if (receipt.estimatedCostUsd !== undefined) {\n    if (receipt.costUnknown || receipt.costUsd !== receipt.estimatedCostUsd) {\n      ctx.addIssue({ code: 'custom', message: 'external estimate must be known and equal costUsd' })\n    }\n    if (receipt.pricing !== undefined) {\n      ctx.addIssue({ code: 'custom', message: 'external estimate must not include token pricing' })\n    }\n    return\n  }\n\n  if (receipt.costUnknown) {\n    if (receipt.costUsd !== 0) {\n      ctx.addIssue({ code: 'custom', message: 'unknown cost must have costUsd 0' })\n    }\n    if (receipt.pricing !== undefined) {\n      ctx.addIssue({ code: 'custom', message: 'unknown cost must not include estimated pricing' })\n    }\n    return\n  }\n\n  if (receipt.usageUnknown) {\n    ctx.addIssue({ code: 'custom', message: 'known estimated cost requires known usage' })\n  }\n  if (!receipt.pricing) {\n    ctx.addIssue({ code: 'custom', message: 'known estimated cost requires a pricing snapshot' })\n    return\n  }\n\n  const expected = costFromPricing(receipt, receipt.pricing)\n  if (!costAmountsMatch(receipt.costUsd, expected)) {\n    ctx.addIssue({\n      code: 'custom',\n      message: `estimated cost ${receipt.costUsd} does not match pricing snapshot ${expected}`,\n    })\n  }\n}\n\nfunction costAmountsMatch(left: number, right: number): boolean {\n  const scale = Math.max(1, Math.abs(left), Math.abs(right))\n  return Math.abs(left - right) <= Number.EPSILON * scale * 8\n}\n\nexport function buildReceipt(\n  pending: PendingCostCall,\n  observed: CostReceiptInput,\n  failed = false,\n  error?: string,\n): CostReceipt {\n  assertUsage(observed)\n  assertString(observed.model, 'receipt.model')\n  const suppliedAmounts = [\n    observed.actualCostUsd,\n    observed.estimatedCostUsd,\n    observed.customTokenPricing,\n  ].filter((value) => value !== undefined)\n  if (suppliedAmounts.length > 1) {\n    throw new ValidationError(\n      'CostLedger: a receipt can have only one of actualCostUsd, estimatedCostUsd, or customTokenPricing',\n    )\n  }\n  const customPricingSnapshot =\n    observed.customTokenPricing === undefined\n      ? undefined\n      : pricingSnapshot(observed.customTokenPricing)\n  const estimated = customPricingSnapshot\n    ? {\n        costUsd: costFromPricing(observed, customPricingSnapshot),\n        costUnknown: false,\n      }\n    : costForUsage(observed.model, observed)\n  const hasActual = observed.actualCostUsd !== undefined\n  const hasExternalEstimate = observed.estimatedCostUsd !== undefined\n  if (hasActual && observed.costUnknown === true) {\n    throw new ValidationError(\n      'CostLedger: a receipt cannot have both actualCostUsd and costUnknown=true',\n    )\n  }\n  if (hasActual) assertNonNegative(observed.actualCostUsd!, 'actualCostUsd')\n  if (hasExternalEstimate) assertNonNegative(observed.estimatedCostUsd!, 'estimatedCostUsd')\n  if (hasExternalEstimate && observed.costUnknown === true) {\n    throw new ValidationError(\n      'CostLedger: a receipt cannot have both estimatedCostUsd and costUnknown=true',\n    )\n  }\n  const usageUnknown = observed.usageUnknown === true\n  const costUnknown =\n    observed.costUnknown === true ||\n    (!hasActual && !hasExternalEstimate && (usageUnknown || estimated.costUnknown))\n  const resolvedModelPricing =\n    !customPricingSnapshot && !hasActual && !hasExternalEstimate && !costUnknown\n      ? resolveModelPricing(observed.model)\n      : null\n  const receiptPricing =\n    !hasActual && !hasExternalEstimate && !costUnknown\n      ? (customPricingSnapshot ??\n        (resolvedModelPricing\n          ? {\n              inputUsdPerThousand: resolvedModelPricing.input,\n              outputUsdPerThousand: resolvedModelPricing.output,\n            }\n          : undefined))\n      : undefined\n  return parseReceipt(\n    {\n      status: 'settled',\n      callId: pending.callId,\n      channel: pending.channel,\n      phase: pending.phase,\n      actor: pending.actor,\n      model: observed.model,\n      inputTokens: observed.inputTokens,\n      outputTokens: observed.outputTokens,\n      ...(observed.reasoningTokens === undefined\n        ? {}\n        : { reasoningTokens: observed.reasoningTokens }),\n      ...(observed.cachedTokens === undefined ? {} : { cachedTokens: observed.cachedTokens }),\n      ...(observed.cacheWriteTokens === undefined\n        ? {}\n        : { cacheWriteTokens: observed.cacheWriteTokens }),\n      costUsd: costUnknown\n        ? 0\n        : hasActual\n          ? observed.actualCostUsd!\n          : hasExternalEstimate\n            ? observed.estimatedCostUsd!\n            : estimated.costUsd,\n      costUnknown,\n      usageUnknown,\n      ...(receiptPricing ? { pricing: receiptPricing } : {}),\n      ...(hasActual ? { actualCostUsd: observed.actualCostUsd } : {}),\n      ...(hasExternalEstimate ? { estimatedCostUsd: observed.estimatedCostUsd } : {}),\n      ...(pending.maximumCostUsd === undefined ? {} : { maximumCostUsd: pending.maximumCostUsd }),\n      ...(failed ? { error: error ?? 'paid-call-failed' } : {}),\n      ...(pending.tags ? { tags: { ...pending.tags } } : {}),\n      timestamp: pending.timestamp,\n    },\n    'provider receipt',\n  )\n}\n\nexport function parseReceipt(value: unknown, path: string): CostReceipt {\n  try {\n    return CostReceiptSchema.parse(value) as CostReceipt\n  } catch (cause) {\n    throw new ValidationError(`CostLedger: invalid ${path}: ${validationMessage(cause)}`, { cause })\n  }\n}\n\nexport function parseImportedReceipt(value: unknown, path: string): CostReceipt {\n  if (typeof value !== 'object' || value === null) return parseReceipt(value, path)\n  const candidate = { ...value } as Record<string, unknown>\n  if (\n    candidate.status === 'settled' &&\n    candidate.actualCostUsd === undefined &&\n    candidate.estimatedCostUsd === undefined &&\n    candidate.costUnknown === false &&\n    candidate.pricing === undefined &&\n    typeof candidate.model === 'string'\n  ) {\n    const pricing = resolveModelPricing(candidate.model)\n    if (pricing) {\n      candidate.pricing = {\n        inputUsdPerThousand: pricing.input,\n        outputUsdPerThousand: pricing.output,\n      }\n    }\n  }\n  return parseReceipt(candidate, path)\n}\n\nexport function validateAttribution(\n  input: Pick<RunPaidCallInput<unknown>, 'channel' | 'phase' | 'actor' | 'model' | 'tags'>,\n): void {\n  assertString(input.channel, 'channel')\n  assertString(input.phase, 'phase')\n  assertString(input.actor, 'actor')\n  if (input.model !== undefined) assertString(input.model, 'model')\n  if (input.tags !== undefined) {\n    const parsed = Tags.safeParse(input.tags)\n    if (!parsed.success)\n      throw new ValidationError(`CostLedger: invalid tags: ${parsed.error.message}`)\n  }\n}\n\nexport function matches(record: CostCallBase, filter: CostLedgerFilter | undefined): boolean {\n  if (!filter) return true\n  if (filter.channel !== undefined && record.channel !== filter.channel) return false\n  if (filter.phase !== undefined && record.phase !== filter.phase) return false\n  return Object.entries(filter.tags ?? {}).every(([key, value]) => record.tags?.[key] === value)\n}\n\nexport function cloneRecord(record: CostLedgerRecord): CostLedgerRecord {\n  if (record.status === 'settled') return cloneReceipt(record)\n  return clonePendingCall(record)\n}\n\nexport function clonePendingCall(record: PendingCostCall): PendingCostCall {\n  const { tags, ...rest } = record\n  return { ...rest, ...(tags ? { tags: { ...tags } } : {}) }\n}\n\nexport function cloneReceipt(receipt: CostReceipt): CostReceipt {\n  const { pricing, tags, ...rest } = receipt\n  return {\n    ...rest,\n    ...(tags ? { tags: { ...tags } } : {}),\n    ...(pricing ? { pricing: { ...pricing } } : {}),\n  }\n}\n","/** Typed cost-accounting failures retain detached receipt evidence. */\nimport { ValidationError } from '../errors'\nimport type { CostReceipt } from './contract'\nimport { cloneReceipt } from './receipts'\nimport { toError } from './validation'\n\nexport class CostCeilingReachedError extends ValidationError {\n  constructor(\n    ceilingUsd: number,\n    committedUsd: number,\n    requestedUsd: number,\n    phase: string,\n    actor: string,\n  ) {\n    super(\n      `CostLedger: reserving ${requestedUsd} for '${actor}' during '${phase}' would exceed ceiling ${ceilingUsd} with ${committedUsd} already committed`,\n    )\n  }\n}\n\nexport class CostAccountingIncompleteError extends ValidationError {}\n\nexport class CostReservationExceededError extends ValidationError {\n  constructor(actor: string, actualUsd: number, maximumUsd: number) {\n    super(\n      `CostLedger: '${actor}' charged ${actualUsd}, exceeding its enforced maximum ${maximumUsd}`,\n    )\n  }\n}\n\nexport class CostCallConflictError extends ValidationError {\n  readonly callId?: string\n  readonly receipt?: CostReceipt\n\n  constructor(\n    message: string,\n    options: { callId?: string; receipt?: CostReceipt; cause?: unknown } = {},\n  ) {\n    super(message, options.cause === undefined ? undefined : { cause: options.cause })\n    this.callId = options.callId\n    this.receipt = options.receipt ? cloneReceipt(options.receipt) : undefined\n  }\n}\n\nexport class CostLedgerPersistenceError extends ValidationError {\n  readonly callId?: string\n  readonly receipt?: CostReceipt\n\n  constructor(cause: unknown, callId?: string, receipt?: CostReceipt) {\n    super(\n      `CostLedger: failed to persist${callId ? ` call '${callId}'` : ''}: ${toError(cause).message}`,\n      { cause },\n    )\n    this.callId = callId\n    this.receipt = receipt ? cloneReceipt(receipt) : undefined\n  }\n}\n\nexport class CostReceiptCaptureError extends ValidationError {\n  readonly callId: string\n  readonly receipt?: CostReceipt\n  readonly receiptError: Error\n\n  constructor(callId: string, cause: unknown, receiptError: unknown, receipt?: CostReceipt) {\n    super(`CostLedger: could not capture the provider receipt for call '${callId}'`, { cause })\n    this.callId = callId\n    this.receipt = receipt ? cloneReceipt(receipt) : undefined\n    this.receiptError = toError(receiptError)\n  }\n}\n","/** Parse the append-only journal and enforce immutable pending-to-settled transitions. */\nimport { z } from 'zod'\nimport { ValidationError } from '../errors'\nimport type { CostCallBase, CostLedgerRecord, CostReceipt, PendingCostCall } from './contract'\nimport { CostCallConflictError } from './errors'\nimport {\n  CostReceiptSchema,\n  cloneRecord,\n  NonNegative,\n  PendingCostCallSchema,\n  TokenCount,\n} from './receipts'\nimport { validationMessage } from './validation'\n\ninterface PendingCostCallEvent {\n  version: 1\n  record: PendingCostCall\n}\n\ninterface SettledCostCallEvent {\n  version: 2\n  record: CostReceipt\n}\n\ninterface CompletedTasksEvent {\n  version: 1\n  completedTasks: number\n}\n\ninterface CostLimitEvent {\n  version: 1\n  costCeilingUsd: number\n}\n\nexport type CostCallEvent = PendingCostCallEvent | SettledCostCallEvent\nexport type CostLedgerEvent = CostCallEvent | CompletedTasksEvent | CostLimitEvent\n\nconst CostLedgerEventSchema = z.union([\n  z.strictObject({\n    version: z.literal(1),\n    record: PendingCostCallSchema,\n  }),\n  z.strictObject({\n    version: z.literal(2),\n    record: CostReceiptSchema,\n  }),\n  z.strictObject({\n    version: z.literal(1),\n    completedTasks: TokenCount,\n  }),\n  z.strictObject({\n    version: z.literal(1),\n    costCeilingUsd: NonNegative,\n  }),\n])\n\nexport function parseEvents(serialized: string): {\n  records: CostLedgerRecord[]\n  completedTasks: number\n  costCeilingUsd?: number\n} {\n  const records = new Map<string, CostLedgerRecord>()\n  let completedTasks = 0\n  let costCeilingUsd: number | undefined\n  let lineNumber = 0\n  try {\n    for (const line of completeJournalPrefix(serialized).split('\\n')) {\n      if (!line.trim()) continue\n      lineNumber += 1\n      const event = CostLedgerEventSchema.parse(JSON.parse(line)) as CostLedgerEvent\n      if ('record' in event) {\n        const record = event.record\n        validateTransition(records, record)\n        records.set(record.callId, cloneRecord(record))\n      } else if ('completedTasks' in event) {\n        completedTasks += event.completedTasks\n        if (!Number.isSafeInteger(completedTasks)) {\n          throw new ValidationError('CostLedger: completed task count exceeds safe integer range')\n        }\n      } else {\n        if (costCeilingUsd !== undefined) {\n          throw new ValidationError('CostLedger: duplicate persisted cost ceiling')\n        }\n        costCeilingUsd = event.costCeilingUsd\n      }\n    }\n    return {\n      records: [...records.values()],\n      completedTasks,\n      ...(costCeilingUsd === undefined ? {} : { costCeilingUsd }),\n    }\n  } catch (cause) {\n    throw new ValidationError(\n      `CostLedger: invalid persisted event ${lineNumber || 1}: ${validationMessage(cause)}`,\n      { cause },\n    )\n  }\n}\n\nfunction completeJournalPrefix(serialized: string): string {\n  if (!serialized || serialized.endsWith('\\n')) return serialized\n  const finalNewline = serialized.lastIndexOf('\\n')\n  const tail = serialized.slice(finalNewline + 1)\n  try {\n    JSON.parse(tail)\n  } catch {\n    return finalNewline < 0 ? '' : serialized.slice(0, finalNewline + 1)\n  }\n  throw new ValidationError(\n    'CostLedger: complete final persisted event is missing its newline terminator',\n  )\n}\n\nexport function validateTransition(\n  records: ReadonlyMap<string, CostLedgerRecord>,\n  record: CostLedgerRecord,\n): void {\n  const current = records.get(record.callId)\n  if (!current) return\n  if (record.status === 'pending' || current.status === 'settled') {\n    throw new CostCallConflictError(`CostLedger: duplicate callId '${record.callId}'`)\n  }\n  if (!sameAttribution(current, record)) {\n    throw new ValidationError(`CostLedger: receipt attribution changed for call '${record.callId}'`)\n  }\n}\n\nfunction sameAttribution(before: CostCallBase, after: CostCallBase): boolean {\n  return (\n    before.channel === after.channel &&\n    before.phase === after.phase &&\n    before.actor === after.actor &&\n    before.maximumCostUsd === after.maximumCostUsd &&\n    before.timestamp === after.timestamp &&\n    sameTags(before.tags, after.tags)\n  )\n}\n\nfunction sameTags(\n  left: Readonly<Record<string, string>> | undefined,\n  right: Readonly<Record<string, string>> | undefined,\n): boolean {\n  const leftEntries = Object.entries(left ?? {}).sort(([a], [b]) => a.localeCompare(b))\n  const rightEntries = Object.entries(right ?? {}).sort(([a], [b]) => a.localeCompare(b))\n  return JSON.stringify(leftEntries) === JSON.stringify(rightEntries)\n}\n","/** Derive attribution rollups and accounting completeness from one snapshot of ledger records. */\nimport type {\n  ChannelRollup,\n  CostChannel,\n  CostLedgerRecord,\n  CostLedgerSummary,\n  CostReceipt,\n  PendingCostCall,\n} from './contract'\n\nexport function summarizeCostLedger(\n  records: readonly CostLedgerRecord[],\n  activeCallIds: ReadonlySet<string>,\n  lateCallIds: ReadonlySet<string>,\n): CostLedgerSummary {\n  const pending = records.filter((record): record is PendingCostCall => record.status === 'pending')\n  const receipts = records.filter((record): record is CostReceipt => record.status === 'settled')\n  const byChannel = new Map<string, ChannelRollup>()\n  const unpriced = new Set<string>()\n  const incompleteReasons: string[] = pending.map(\n    (record) => `call '${record.callId}' for '${record.actor}' is pending`,\n  )\n  let inputTokens = 0\n  let outputTokens = 0\n  let reasoningTokens = 0\n  let cachedTokens = 0\n  let cacheWriteTokens = 0\n  let totalCostUsd = 0\n\n  for (const receipt of receipts) {\n    inputTokens += receipt.inputTokens\n    outputTokens += receipt.outputTokens\n    reasoningTokens += receipt.reasoningTokens ?? 0\n    cachedTokens += receipt.cachedTokens ?? 0\n    cacheWriteTokens += receipt.cacheWriteTokens ?? 0\n    totalCostUsd += receipt.costUsd\n    if (receipt.costUnknown) {\n      unpriced.add(receipt.model)\n      incompleteReasons.push(\n        receipt.error ?? `cost unknown for '${receipt.actor}' using '${receipt.model}'`,\n      )\n    }\n    if (receipt.usageUnknown) {\n      incompleteReasons.push(`token usage unknown for '${receipt.actor}' using '${receipt.model}'`)\n    }\n    if (receipt.maximumCostUsd !== undefined && receipt.costUsd > receipt.maximumCostUsd) {\n      incompleteReasons.push(\n        `'${receipt.actor}' charged ${receipt.costUsd}, exceeding its enforced maximum ${receipt.maximumCostUsd}`,\n      )\n    }\n    const rollup = byChannel.get(receipt.channel) ?? emptyRollup(receipt.channel)\n    rollup.calls += 1\n    rollup.inputTokens += receipt.inputTokens\n    rollup.outputTokens += receipt.outputTokens\n    rollup.reasoningTokens = (rollup.reasoningTokens ?? 0) + (receipt.reasoningTokens ?? 0)\n    rollup.cachedTokens += receipt.cachedTokens ?? 0\n    rollup.cacheWriteTokens = (rollup.cacheWriteTokens ?? 0) + (receipt.cacheWriteTokens ?? 0)\n    rollup.costUsd += receipt.costUsd\n    if (receipt.costUnknown) rollup.unpricedCalls += 1\n    if (receipt.usageUnknown) rollup.unknownUsageCalls += 1\n    byChannel.set(receipt.channel, rollup)\n  }\n\n  return {\n    totalCalls: receipts.length,\n    pendingCalls: pending.length,\n    unresolvedCalls: pending.filter(\n      (record) => !activeCallIds.has(record.callId) || lateCallIds.has(record.callId),\n    ).length,\n    reservedCostUsd: pending.reduce((sum, record) => sum + (record.maximumCostUsd ?? 0), 0),\n    inputTokens,\n    outputTokens,\n    reasoningTokens,\n    cachedTokens,\n    cacheWriteTokens,\n    totalCostUsd,\n    costProvenance:\n      pending.length > 0 || receipts.some((receipt) => receipt.costUnknown)\n        ? { kind: 'uncaptured', usd: null }\n        : receipts.every((receipt) => receipt.actualCostUsd !== undefined)\n          ? { kind: 'observed', usd: totalCostUsd }\n          : { kind: 'estimated', usd: totalCostUsd },\n    byChannel: [...byChannel.values()].sort((a, b) => a.channel.localeCompare(b.channel)),\n    unpricedModels: [...unpriced].sort(),\n    fullyPriced: unpriced.size === 0,\n    usageComplete: pending.length === 0 && receipts.every((receipt) => !receipt.usageUnknown),\n    accountingComplete: incompleteReasons.length === 0,\n    incompleteReasons: [...new Set(incompleteReasons)],\n  }\n}\n\nfunction emptyRollup(channel: CostChannel): ChannelRollup {\n  return {\n    channel,\n    calls: 0,\n    inputTokens: 0,\n    outputTokens: 0,\n    reasoningTokens: 0,\n    cachedTokens: 0,\n    cacheWriteTokens: 0,\n    costUsd: 0,\n    unpricedCalls: 0,\n    unknownUsageCalls: 0,\n  }\n}\n","/** Run-wide paid-call admission and durable call state. */\n\nimport type {\n  CostLedgerFilter,\n  CostLedgerOptions,\n  CostLedgerPersistence,\n  CostLedgerRecord,\n  CostLedgerSummary,\n  CostLedgerWaitOptions,\n  CostReceipt,\n  CostReceiptInput,\n  MaximumCharge,\n  PaidCallResult,\n  PendingCostCall,\n  PendingCostCallView,\n  RunPaidCallInput,\n} from './cost-ledger/contract'\nimport {\n  CostAccountingIncompleteError,\n  CostCallConflictError,\n  CostCeilingReachedError,\n  CostLedgerPersistenceError,\n  CostReceiptCaptureError,\n  CostReservationExceededError,\n} from './cost-ledger/errors'\nimport type { CostCallEvent, CostLedgerEvent } from './cost-ledger/journal'\nimport { parseEvents, validateTransition } from './cost-ledger/journal'\nimport { costForTokenPricing, costForUsage } from './cost-ledger/pricing'\nimport {\n  buildReceipt,\n  clonePendingCall,\n  cloneReceipt,\n  cloneRecord,\n  matches,\n  parseImportedReceipt,\n  validateAttribution,\n} from './cost-ledger/receipts'\nimport { summarizeCostLedger } from './cost-ledger/summary'\nimport { assertNonNegative, assertString, assertTimeout, toError } from './cost-ledger/validation'\nimport { ValidationError } from './errors'\n\nexport type {\n  ChannelRollup,\n  CostChannel,\n  CostLedgerFilter,\n  CostLedgerHandle,\n  CostLedgerOptions,\n  CostLedgerPersistence,\n  CostLedgerRecord,\n  CostLedgerSummary,\n  CostLedgerWaitOptions,\n  CostProvenance,\n  CostReceipt,\n  CostReceiptInput,\n  CostUsage,\n  CustomTokenPricing,\n  MaximumCharge,\n  PaidCallResult,\n  PendingCostCall,\n  PendingCostCallView,\n  RunPaidCallInput,\n} from './cost-ledger/contract'\nexport {\n  CostAccountingIncompleteError,\n  CostCallConflictError,\n  CostCeilingReachedError,\n  CostLedgerPersistenceError,\n  CostReceiptCaptureError,\n  CostReservationExceededError,\n} from './cost-ledger/errors'\nexport type { CostResult } from './cost-ledger/pricing'\nexport { costForTokenPricing, costForUsage, modelPriceKey } from './cost-ledger/pricing'\n\n/** Run-wide paid-call admission, durable call state, receipts, and summaries. */\nexport class CostLedger {\n  private readonly records = new Map<string, CostLedgerRecord>()\n  private readonly activeCallIds = new Set<string>()\n  private readonly lateCallIds = new Set<string>()\n  private readonly idleWaiters = new Set<() => void>()\n  private completedTasks = 0\n  private revision = 'memory'\n  private costLimitPersisted = false\n  readonly costCeilingUsd?: number\n  private readonly persistence?: CostLedgerPersistence\n\n  constructor(input?: number | CostLedgerOptions) {\n    const options = typeof input === 'number' ? { costCeilingUsd: input } : (input ?? {})\n    this.persistence = options.persistence\n    if (options.costCeilingUsd !== undefined) {\n      assertNonNegative(options.costCeilingUsd, 'costCeilingUsd')\n    }\n\n    let persistedCostCeilingUsd: number | undefined\n    if (this.persistence) {\n      let stored: ReturnType<CostLedgerPersistence['read']>\n      try {\n        stored = this.persistence.read()\n      } catch (cause) {\n        throw new CostLedgerPersistenceError(cause)\n      }\n      assertString(stored.revision, 'persistence revision')\n      this.revision = stored.revision\n      const restored = parseEvents(stored.events)\n      for (const record of restored.records) this.records.set(record.callId, record)\n      this.completedTasks = restored.completedTasks\n      persistedCostCeilingUsd = restored.costCeilingUsd\n    }\n\n    if (\n      options.costCeilingUsd !== undefined &&\n      persistedCostCeilingUsd !== undefined &&\n      options.costCeilingUsd !== persistedCostCeilingUsd\n    ) {\n      throw new ValidationError(\n        `CostLedger: requested cost ceiling ${options.costCeilingUsd} does not match persisted ceiling ${persistedCostCeilingUsd}`,\n      )\n    }\n    this.costCeilingUsd = persistedCostCeilingUsd ?? options.costCeilingUsd\n    this.costLimitPersisted =\n      !this.persistence ||\n      this.costCeilingUsd === undefined ||\n      persistedCostCeilingUsd !== undefined\n\n    if (\n      this.costCeilingUsd !== undefined &&\n      [...this.records.values()].some(\n        (record) => record.status === 'pending' && record.maximumCostUsd === undefined,\n      )\n    ) {\n      throw new ValidationError('CostLedger: capped event log contains an unbounded pending call')\n    }\n\n    if (options.receipts?.length) {\n      const imported = options.receipts.map((receipt, index) =>\n        parseImportedReceipt(receipt, `imported receipt ${index + 1}`),\n      )\n      this.ensureCostLimitPersisted()\n      for (const receipt of imported) this.appendRecord(receipt)\n    }\n  }\n\n  async runPaidCall<T>(input: RunPaidCallInput<T>): Promise<PaidCallResult<T>> {\n    let callId: string | undefined\n    let pending: PendingCostCall | undefined\n    try {\n      callId = resolveCallId(input.callId)\n      validateAttribution(input)\n      if (input.signal?.aborted) {\n        return { succeeded: false, callId, error: abortError(input.signal) }\n      }\n      this.ensureCostLimitPersisted(callId)\n\n      const maximumCostUsd = this.resolveMaximum(input.maximumCharge)\n      const existing = this.records.get(callId)\n      if (existing) {\n        return {\n          succeeded: false,\n          callId,\n          error: new CostCallConflictError(\n            existing.status === 'pending'\n              ? `CostLedger: callId '${callId}' is unresolved and must be reconciled before retry`\n              : `CostLedger: callId '${callId}' already exists`,\n            { callId },\n          ),\n        }\n      }\n\n      if (!pending) {\n        while (true) {\n          if (this.records.has(callId)) {\n            return {\n              succeeded: false,\n              callId,\n              error: new CostCallConflictError(`CostLedger: callId '${callId}' already exists`),\n            }\n          }\n          const admission = this.admissionState()\n          if (admission.unresolvedCalls > 0) {\n            return {\n              succeeded: false,\n              callId,\n              error: new CostAccountingIncompleteError(\n                `CostLedger: ${admission.unresolvedCalls} unresolved call(s) must be reconciled before new paid work`,\n              ),\n            }\n          }\n          if (this.costCeilingUsd === undefined) break\n          if (admission.budgetBreached) {\n            return {\n              succeeded: false,\n              callId,\n              error: new CostAccountingIncompleteError(\n                `CostLedger: a settled call exceeded its enforced maximum; refusing paid call '${input.actor}' during '${input.phase}'`,\n              ),\n            }\n          }\n          // A settled call whose cost the provider left unknown is charged its\n          // reserved maximum here, so the ceiling is enforced against a real\n          // upper bound and one under-reported response cannot let later calls\n          // silently exceed the budget — while still permitting them.\n          const { committedCostUsd } = admission\n          if (committedCostUsd + maximumCostUsd! > this.costCeilingUsd) {\n            return {\n              succeeded: false,\n              callId,\n              error: new CostCeilingReachedError(\n                this.costCeilingUsd,\n                committedCostUsd,\n                maximumCostUsd!,\n                input.phase,\n                input.actor,\n              ),\n            }\n          }\n          if (\n            committedCostUsd + admission.reservedCostUsd + maximumCostUsd! <=\n            this.costCeilingUsd\n          ) {\n            break\n          }\n          await this.waitForReservationRelease(input.signal)\n        }\n\n        pending = {\n          status: 'pending',\n          callId,\n          channel: input.channel,\n          phase: input.phase,\n          actor: input.actor,\n          model: pendingModel(input),\n          ...(maximumCostUsd === undefined ? {} : { maximumCostUsd }),\n          ...(input.tags ? { tags: { ...input.tags } } : {}),\n          timestamp: Date.now(),\n        }\n        this.appendRecord(pending)\n        this.activeCallIds.add(callId)\n      }\n    } catch (error) {\n      return { succeeded: false, ...(callId ? { callId } : {}), error: toError(error) }\n    }\n\n    try {\n      return await this.execute(input, pending)\n    } catch (error) {\n      return { succeeded: false, callId: pending.callId, error: toError(error) }\n    } finally {\n      if (!this.lateCallIds.has(pending.callId)) this.releaseActiveCall(pending.callId)\n    }\n  }\n\n  /** Wait until every call started by this ledger has produced a durable outcome. */\n  async waitForIdle(options: CostLedgerWaitOptions = {}): Promise<boolean> {\n    const hasActiveMatch = (): boolean =>\n      [...this.activeCallIds].some((callId) => {\n        const record = this.records.get(callId)\n        return record !== undefined && matches(record, options.filter)\n      })\n    if (!hasActiveMatch()) return true\n    const timeoutMs = options.timeoutMs ?? 5_000\n    assertTimeout(timeoutMs, 'waitForIdle.timeoutMs')\n    return new Promise<boolean>((resolve) => {\n      let timer: ReturnType<typeof setTimeout> | undefined\n      const finish = (settled: boolean): void => {\n        this.idleWaiters.delete(onIdle)\n        if (timer !== undefined) clearTimeout(timer)\n        resolve(settled)\n      }\n      const onIdle = (): void => {\n        if (!hasActiveMatch()) finish(true)\n      }\n      this.idleWaiters.add(onIdle)\n      timer = setTimeout(() => finish(false), timeoutMs)\n      onIdle()\n    })\n  }\n\n  /** Settle a call left pending by a crashed process after reconciling with the provider. */\n  reconcile(\n    callId: string,\n    observed: CostReceiptInput,\n    options: { failed?: boolean; error?: string } = {},\n  ): CostReceipt {\n    const pending = this.records.get(callId)\n    if (pending?.status !== 'pending') {\n      throw new CostCallConflictError(`CostLedger: no pending call '${callId}'`)\n    }\n    if (this.activeCallIds.has(callId)) {\n      throw new CostCallConflictError(`CostLedger: call '${callId}' is still active`)\n    }\n    this.ensureCostLimitPersisted(callId)\n    return this.commitReceipt(\n      pending,\n      observed,\n      options.failed === true || options.error !== undefined,\n      options.error,\n    )\n  }\n\n  list(filter?: CostLedgerFilter): CostReceipt[] {\n    return [...this.records.values()]\n      .filter((record): record is CostReceipt => record.status === 'settled')\n      .filter((receipt) => matches(receipt, filter))\n      .map(cloneReceipt)\n  }\n\n  /** Read pending calls without exposing mutable ledger state. */\n  listPending(filter?: CostLedgerFilter): PendingCostCallView[] {\n    return [...this.records.values()]\n      .filter((record): record is PendingCostCall => record.status === 'pending')\n      .filter((record) => matches(record, filter))\n      .map((record) => ({\n        ...clonePendingCall(record),\n        state: this.lateCallIds.has(record.callId)\n          ? 'late'\n          : this.activeCallIds.has(record.callId)\n            ? 'active'\n            : 'interrupted',\n      }))\n  }\n\n  summary(filter?: CostLedgerFilter): CostLedgerSummary {\n    const records = [...this.records.values()].filter((record) => matches(record, filter))\n    return summarizeCostLedger(records, this.activeCallIds, this.lateCallIds)\n  }\n  markCompleted(count = 1): void {\n    if (!Number.isInteger(count) || count < 0) {\n      throw new ValidationError(\n        `CostLedger.markCompleted: count must be a non-negative integer, got ${count}`,\n      )\n    }\n    if (count === 0) return\n    this.ensureCostLimitPersisted()\n    this.appendEvent({ version: 1, completedTasks: count })\n    this.completedTasks += count\n  }\n\n  costPerCompletedTask(): number | null {\n    return this.completedTasks === 0 ? null : this.summary().totalCostUsd / this.completedTasks\n  }\n\n  private async execute<T>(\n    input: RunPaidCallInput<T>,\n    pending: PendingCostCall,\n  ): Promise<PaidCallResult<T>> {\n    const signal = input.signal ?? new AbortController().signal\n    if (signal.aborted) {\n      return this.commitOutcome(pending, abortError(signal), {\n        model: pending.model,\n        inputTokens: 0,\n        outputTokens: 0,\n        actualCostUsd: 0,\n      })\n    }\n\n    const operation = Promise.resolve().then(() => input.execute(signal, pending.callId))\n    const settled = await settle(operation, signal)\n    if (settled.kind === 'aborted') {\n      this.lateCallIds.add(pending.callId)\n      this.captureLateOutcome(input, pending, operation)\n      return paidFailure(pending.callId, abortError(signal))\n    }\n    if (settled.kind === 'error') {\n      let observed: CostReceiptInput | undefined\n      try {\n        observed = input.receiptFromError?.(settled.error)\n      } catch (receiptError) {\n        return this.captureFailure(pending, settled.error, receiptError)\n      }\n      return this.commitOutcome(pending, settled.error, observed ?? unknownReceipt(pending.model))\n    }\n\n    try {\n      const receipt = this.commitReceipt(pending, input.receipt(settled.value))\n      if (receipt.maximumCostUsd !== undefined && receipt.costUsd > receipt.maximumCostUsd) {\n        return paidFailure(\n          pending.callId,\n          new CostReservationExceededError(pending.actor, receipt.costUsd, receipt.maximumCostUsd),\n          receipt,\n        )\n      }\n      return { succeeded: true, callId: pending.callId, value: settled.value, receipt }\n    } catch (receiptError) {\n      if (\n        receiptError instanceof CostLedgerPersistenceError ||\n        receiptError instanceof CostCallConflictError\n      ) {\n        return paidFailure(pending.callId, receiptError)\n      }\n      return this.captureFailure(pending, receiptError, receiptError)\n    }\n  }\n\n  private captureLateOutcome<T>(\n    input: RunPaidCallInput<T>,\n    pending: PendingCostCall,\n    operation: Promise<T>,\n  ): void {\n    void operation\n      .then(\n        (value) => {\n          if (this.records.get(pending.callId)?.status !== 'pending') return\n          try {\n            this.commitReceipt(pending, input.receipt(value))\n          } catch {\n            // A failed durable settlement leaves the reservation pending and blocks new paid work.\n          }\n        },\n        (cause) => {\n          if (this.records.get(pending.callId)?.status !== 'pending') return\n          const error = toError(cause)\n          try {\n            const observed = input.receiptFromError?.(error)\n            this.commitReceipt(pending, observed ?? unknownReceipt(pending.model), true)\n          } catch (receiptError) {\n            if (\n              receiptError instanceof CostLedgerPersistenceError ||\n              receiptError instanceof CostCallConflictError\n            ) {\n              return\n            }\n            this.captureFailure(pending, error, receiptError)\n          }\n        },\n      )\n      .finally(() => {\n        this.lateCallIds.delete(pending.callId)\n        this.releaseActiveCall(pending.callId)\n      })\n  }\n\n  private releaseActiveCall(callId: string): void {\n    this.activeCallIds.delete(callId)\n    for (const resolve of [...this.idleWaiters]) resolve()\n  }\n\n  private async waitForReservationRelease(signal?: AbortSignal): Promise<void> {\n    if (signal?.aborted) throw abortError(signal)\n    await new Promise<void>((resolve, reject) => {\n      let finished = false\n      const finish = (error?: Error): void => {\n        if (finished) return\n        finished = true\n        this.idleWaiters.delete(onRelease)\n        signal?.removeEventListener('abort', onAbort)\n        if (error) reject(error)\n        else resolve()\n      }\n      const onRelease = (): void => finish()\n      const onAbort = (): void => finish(abortError(signal!))\n      this.idleWaiters.add(onRelease)\n      signal?.addEventListener('abort', onAbort, { once: true })\n      if (this.activeCallIds.size === 0) onRelease()\n    })\n  }\n\n  private commitOutcome<T>(\n    pending: PendingCostCall,\n    error: Error,\n    observed: CostReceiptInput,\n  ): PaidCallResult<T> {\n    try {\n      const receipt = this.commitReceipt(pending, observed, true)\n      return paidFailure(pending.callId, error, receipt)\n    } catch (receiptError) {\n      if (\n        receiptError instanceof CostLedgerPersistenceError ||\n        receiptError instanceof CostCallConflictError\n      ) {\n        return paidFailure(pending.callId, receiptError)\n      }\n      return this.captureFailure(pending, error, receiptError)\n    }\n  }\n\n  private captureFailure<T>(\n    pending: PendingCostCall,\n    cause: unknown,\n    receiptError: unknown,\n  ): PaidCallResult<T> {\n    try {\n      const receipt = this.commitReceipt(pending, unknownReceipt(pending.model), true)\n      return paidFailure(\n        pending.callId,\n        new CostReceiptCaptureError(pending.callId, cause, receiptError, receipt),\n        receipt,\n      )\n    } catch (error) {\n      const typed = error instanceof Error ? error : toError(error)\n      return paidFailure(pending.callId, typed)\n    }\n  }\n\n  private commitReceipt(\n    pending: PendingCostCall,\n    observed: CostReceiptInput,\n    failed = false,\n    error?: string,\n  ): CostReceipt {\n    const receipt = buildReceipt(pending, observed, failed, error)\n    if (this.records.get(pending.callId)?.status !== 'pending') {\n      throw new CostCallConflictError(`CostLedger: call '${pending.callId}' is not pending`)\n    }\n    this.appendRecord(receipt)\n    return cloneReceipt(receipt)\n  }\n\n  private resolveMaximum(maximum: MaximumCharge | undefined): number | undefined {\n    if (!maximum) {\n      if (this.costCeilingUsd !== undefined) {\n        throw new CostAccountingIncompleteError(\n          'CostLedger: capped paid calls require a hard maximumCharge before execution',\n        )\n      }\n      return undefined\n    }\n    if ('externallyEnforcedMaximumUsd' in maximum) {\n      assertNonNegative(\n        maximum.externallyEnforcedMaximumUsd,\n        'maximumCharge.externallyEnforcedMaximumUsd',\n      )\n      return maximum.externallyEnforcedMaximumUsd\n    }\n    if ('customTokenPricing' in maximum) {\n      return costForTokenPricing(maximum.customTokenPricing, maximum)\n    }\n    const priced = costForUsage(maximum.model, maximum)\n    if (priced.costUnknown) {\n      if (this.costCeilingUsd !== undefined) {\n        throw new CostAccountingIncompleteError(\n          `CostLedger: cannot reserve unpriced model '${maximum.model}' in a capped run`,\n        )\n      }\n      return undefined\n    }\n    return priced.costUsd\n  }\n\n  /** Compute admission totals in record order without building reporting rollups. */\n  private admissionState() {\n    let unresolvedCalls = 0\n    let reservedCostUsd = 0\n    let committedCostUsd = 0\n    let budgetBreached = false\n    for (const record of this.records.values()) {\n      if (record.status === 'pending') {\n        if (!this.activeCallIds.has(record.callId) || this.lateCallIds.has(record.callId)) {\n          unresolvedCalls += 1\n        }\n        reservedCostUsd += record.maximumCostUsd ?? 0\n      } else {\n        if (record.maximumCostUsd !== undefined && record.costUsd > record.maximumCostUsd) {\n          budgetBreached = true\n        }\n        // Unknown settled costs consume their reserved maximum for admission.\n        committedCostUsd += record.costUnknown\n          ? (record.maximumCostUsd ?? record.costUsd)\n          : record.costUsd\n      }\n    }\n    return { unresolvedCalls, reservedCostUsd, committedCostUsd, budgetBreached }\n  }\n\n  private appendRecord(record: CostLedgerRecord): void {\n    const callId = record.callId\n    const receipt = record.status === 'settled' ? record : undefined\n    validateTransition(this.records, record)\n    const event: CostCallEvent =\n      record.status === 'settled'\n        ? { version: 2, record: cloneReceipt(record) }\n        : { version: 1, record: clonePendingCall(record) }\n    this.appendEvent(event, callId, receipt)\n    this.records.set(callId, cloneRecord(record))\n  }\n\n  private ensureCostLimitPersisted(callId?: string): void {\n    if (this.costLimitPersisted || this.costCeilingUsd === undefined) return\n    this.appendEvent({ version: 1, costCeilingUsd: this.costCeilingUsd }, callId)\n    this.costLimitPersisted = true\n  }\n\n  private appendEvent(event: CostLedgerEvent, callId?: string, receipt?: CostReceipt): void {\n    try {\n      if (this.persistence) {\n        const nextRevision = this.persistence.append(this.revision, `${JSON.stringify(event)}\\n`)\n        if (nextRevision === undefined) {\n          throw new CostCallConflictError(\n            `CostLedger: persisted revision changed while writing call '${callId}'`,\n            { callId, receipt },\n          )\n        }\n        assertString(nextRevision, 'persistence revision')\n        this.revision = nextRevision\n      }\n    } catch (cause) {\n      if (cause instanceof CostCallConflictError) throw cause\n      throw new CostLedgerPersistenceError(cause, callId, receipt)\n    }\n  }\n}\n\ntype Settled<T> =\n  | { kind: 'value'; value: T }\n  | { kind: 'error'; error: Error }\n  | { kind: 'aborted' }\n\nasync function settle<T>(promise: Promise<T>, signal: AbortSignal): Promise<Settled<T>> {\n  return await new Promise((resolve) => {\n    let done = false\n    const finish = (value: Settled<T>): void => {\n      if (done) return\n      done = true\n      signal.removeEventListener('abort', onAbort)\n      resolve(value)\n    }\n    const onAbort = () => finish({ kind: 'aborted' })\n    signal.addEventListener('abort', onAbort, { once: true })\n    if (signal.aborted) onAbort()\n    promise.then(\n      (value) => finish({ kind: 'value', value }),\n      (error) => finish({ kind: 'error', error: toError(error) }),\n    )\n  })\n}\n\nfunction pendingModel(input: RunPaidCallInput<unknown>): string {\n  if (input.model) return input.model\n  if (input.maximumCharge && 'model' in input.maximumCharge) return input.maximumCharge.model\n  return 'unknown'\n}\n\nfunction unknownReceipt(model: string): CostReceiptInput {\n  return { model, inputTokens: 0, outputTokens: 0, costUnknown: true, usageUnknown: true }\n}\n\nfunction resolveCallId(input: string | undefined): string {\n  if (input !== undefined) {\n    assertString(input, 'callId')\n    return input\n  }\n  if (typeof globalThis.crypto?.randomUUID !== 'function') {\n    throw new ValidationError('CostLedger: crypto.randomUUID is required when callId is omitted')\n  }\n  return globalThis.crypto.randomUUID()\n}\n\nfunction abortError(signal: AbortSignal): Error {\n  const reason = (signal as { reason?: unknown }).reason\n  if (reason instanceof Error) return reason\n  const error = new Error('CostLedger: paid call aborted')\n  error.name = 'AbortError'\n  return error\n}\n\nfunction paidFailure<T>(callId: string, error: Error, receipt?: CostReceipt): PaidCallResult<T> {\n  return {\n    succeeded: false,\n    callId,\n    error,\n    ...(receipt ? { receipt: cloneReceipt(receipt) } : {}),\n  }\n}\n"],"mappings":"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"}

package/dist/{cost-ledger-CO7UyEcQ.d.ts → cost-ledger-Jk62OBfF.d.ts}

@@ -1,5 +1,4 @@
-import { c as ValidationError } from "./errors-DEE6u6ot.js";
-//#region src/cost-ledger.d.ts
+//#region src/cost-ledger/contract.d.ts
 type CostChannel = 'agent' | 'judge' | 'verifier' | 'analyst' | 'driver' | (string & {});
 /** How a USD amount was obtained. */
 type CostProvenance = {
@@ -169,33 +168,15 @@ interface CostLedgerOptions {
   /** Import already-settled receipts without admitting new paid work. */
   receipts?: readonly CostReceipt[];
 }
-declare class CostCeilingReachedError extends ValidationError {
-  constructor(ceilingUsd: number, committedUsd: number, requestedUsd: number, phase: string, actor: string);
-}
-declare class CostAccountingIncompleteError extends ValidationError {}
-declare class CostReservationExceededError extends ValidationError {
-  constructor(actor: string, actualUsd: number, maximumUsd: number);
-}
-declare class CostCallConflictError extends ValidationError {
-  readonly callId?: string;
-  readonly receipt?: CostReceipt;
-  constructor(message: string, options?: {
-    callId?: string;
-    receipt?: CostReceipt;
-    cause?: unknown;
-  });
-}
-declare class CostLedgerPersistenceError extends ValidationError {
-  readonly callId?: string;
-  readonly receipt?: CostReceipt;
-  constructor(cause: unknown, callId?: string, receipt?: CostReceipt);
-}
-declare class CostReceiptCaptureError extends ValidationError {
-  readonly callId: string;
-  readonly receipt?: CostReceipt;
-  readonly receiptError: Error;
-  constructor(callId: string, cause: unknown, receiptError: unknown, receipt?: CostReceipt);
-}
+/** Public callback surface for a shared cost ledger.
+ *
+ * Declaration bundles may expose this type through multiple package subpaths.
+ * Keeping callback contracts structural lets those subpaths compose while the
+ * concrete {@link CostLedger} retains its private durable state.
+ */
+type CostLedgerHandle = Pick<CostLedger, Exclude<keyof CostLedger, 'listPending' | 'waitForIdle'>> & Partial<Pick<CostLedger, 'listPending' | 'waitForIdle'>>;
+//#endregion
+//#region src/cost-ledger.d.ts
 /** Run-wide paid-call admission, durable call state, receipts, and summaries. */
 declare class CostLedger {
   private readonly records;
@@ -236,22 +217,6 @@ declare class CostLedger {
   private ensureCostLimitPersisted;
   private appendEvent;
 }
-/** Public callback surface for a shared cost ledger.
- *
- * Declaration bundles may expose this type through multiple package subpaths.
- * Keeping callback contracts structural lets those subpaths compose while the
- * concrete {@link CostLedger} retains its private durable state.
- */
-type CostLedgerHandle = Pick<CostLedger, Exclude<keyof CostLedger, 'listPending' | 'waitForIdle'>> & Partial<Pick<CostLedger, 'listPending' | 'waitForIdle'>>;
-/** Return the canonical pricing-table key, or null when the model is unpriced. */
-declare function modelPriceKey(model: string): string | null;
-interface CostResult {
-  costUsd: number;
-  costUnknown: boolean;
-}
-declare function costForUsage(model: string, usage: CostUsage): CostResult;
-/** Price token counts with caller-supplied per-million rates. */
-declare function costForTokenPricing(pricing: CustomTokenPricing, usage: Pick<CostUsage, 'inputTokens' | 'outputTokens' | 'cachedTokens' | 'cacheWriteTokens'>): number;
 //#endregion
-export { PendingCostCall as C, costForUsage as D, costForTokenPricing as E, modelPriceKey as O, PaidCallResult as S, RunPaidCallInput as T, CostReservationExceededError as _, CostChannel as a, CustomTokenPricing as b, CostLedgerHandle as c, CostLedgerPersistenceError as d, CostLedgerSummary as f, CostReceiptInput as g, CostReceiptCaptureError as h, CostCeilingReachedError as i, CostLedgerOptions as l, CostReceipt as m, CostAccountingIncompleteError as n, CostLedger as o, CostProvenance as p, CostCallConflictError as r, CostLedgerFilter as s, ChannelRollup as t, CostLedgerPersistence as u, CostResult as v, PendingCostCallView as w, MaximumCharge as x, CostUsage as y };
-//# sourceMappingURL=cost-ledger-CO7UyEcQ.d.ts.map
+export { PendingCostCallView as _, CostLedgerHandle as a, CostLedgerSummary as c, CostReceiptInput as d, CostUsage as f, PendingCostCall as g, PaidCallResult as h, CostLedgerFilter as i, CostProvenance as l, MaximumCharge as m, ChannelRollup as n, CostLedgerOptions as o, CustomTokenPricing as p, CostChannel as r, CostLedgerPersistence as s, CostLedger as t, CostReceipt as u, RunPaidCallInput as v };
+//# sourceMappingURL=cost-ledger-Jk62OBfF.d.ts.map

package/dist/cost-ledger-Jk62OBfF.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-ledger-Jk62OBfF.d.ts","names":[],"sources":["../src/cost-ledger/contract.ts","../src/cost-ledger.ts"],"mappings":";KAGY;;KAGA;EACN;EAAkB;;EAClB;EAAmB;;EACnB;EAAoB;;UAET;EACf;;EAEA;;EAEA;;EAEA;;EAEA;;UAGe;EACf;EACA,SAAS;EACT;EACA;EACA;EACA;EACA,OAAO;EACP;;UAGe,wBAAwB;EACvC;;UAGe,4BAA4B;EAC3C;;UAGe,oBAAoB,cAAc;EACjD;EACA;EACA;EACA;;EAEA;IACE;IACA;IACA;IACA;;;EAGF;;EAEA;;;EAGA;;UAKe,yBAAyB;EACxC;;EAEA,qBAAqB;EACrB;;EAEA;EACA;EACA;;;UAIe;;EAEf;;EAEA;;EAEA;EACA;;KAGU;EACN;;EAEA,oBAAoB;IAClB,KAAK;EACN;IAAkB;UAER,iBAAiB;EAChC;EACA,SAAS;EACT;EACA;;EAEA;EACA,OAAO;EACP,SAAS;;EAET,gBAAgB;;EAEhB,QAAQ,QAAQ,aAAa,iBAAiB,QAAQ;EACtD,QAAQ,OAAO,IAAI;EACnB,kBAAkB,OAAO,QAAQ;;KAGvB,eAAe;EACrB;EAAiB;EAAgB,OAAO;EAAG,SAAS;;EACpD;EAAkB;EAAiB,OAAO;EAAO,UAAU;;UAEhD;EACf,SAAS;EACT;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,gBAAgB;EAChB,WAAW;EACX;EACA;EACA;EACA;EACA;;UAGe;EACf,UAAU;EACV;EACA,OAAO;;UAGQ;;EAEf;;EAEA,SAAS;;;UAIM;EACf;IAAU;IAAkB;;EAC5B,OAAO,0BAA0B;;UAGlB;EACf;EACA,cAAc;;EAEd,oBAAoB;;;;;;;;KASV,mBAAmB,KAC7B,YACA,cAAc,8CAEd,QAAQ,KAAK;;;;cC9GF;mBACM;mBACA;mBACA;mBACA;UACT;UACA;UACA;WACC;mBACQ;EAEjB,YAAY,iBAAiB;EAwDvB,YAAY,GAAG,OAAO,iBAAiB,KAAK,QAAQ,eAAe;;EA8GnE,YAAY,UAAS,wBAA6B;;EA0BxD,UACE,gBACA,UAAU,kBACV;IAAW;IAAkB;MAC5B;EAiBH,KAAK,SAAS,mBAAmB;;EAQjC,YAAY,SAAS,mBAAmB;EAcxC,QAAQ,SAAS,mBAAmB;EAIpC,cAAc;EAYd;UAIc;UAoDN;UAsCA;UAKM;UAoBN;UAmBA;UAkBA;UAcA;;UAgCA;UAwBA;UAYA;UAMA"}

package/dist/{counterfactual-DtMWvn7D.js → counterfactual-Dn3veueY.js}

@@ -1,4 +1,4 @@
-import { o as NotFoundError, s as ValidationError } from "./errors-Dngq5h35.js";
+import { o as NotFoundError, s as ValidationError } from "./errors-DVZiqS7K.js";
 import { t as TraceEmitter } from "./emitter-DbMXUIVP.js";
 import { t as buildTrajectory } from "./trajectory-D_7rLrvE.js";
 //#region src/counterfactual.ts
@@ -95,4 +95,4 @@ function applyMutation(step, mutation) {
 //#endregion
 export { runCounterfactual as t };
 
-//# sourceMappingURL=counterfactual-DtMWvn7D.js.map
+//# sourceMappingURL=counterfactual-Dn3veueY.js.map

package/dist/{counterfactual-DtMWvn7D.js.map → counterfactual-Dn3veueY.js.map}

@@ -1 +1 @@
-{"version":3,"file":"counterfactual-DtMWvn7D.js","names":[],"sources":["../src/counterfactual.ts"],"sourcesContent":["/**\n * Counterfactual replay — \"what would have happened if we'd changed\n * exactly one thing at turn N?\"\n *\n * The framework does NOT drive the agent — it sets up the replay\n * context (prior spans, prior state, mutation spec) and records the\n * resulting divergence. Consumers supply an `executeFrom(ctx)` callback\n * that runs their agent starting from turn N with the mutation applied.\n *\n * Counterfactual runs are recorded as a new Run with `layer='meta'` and\n * `parentRunId = originalRunId`, so downstream diff + correlation\n * pipelines see them natively.\n */\n\nimport { NotFoundError, ValidationError } from './errors'\nimport { TraceEmitter } from './trace/emitter'\nimport type { LlmSpan, Span, ToolSpan } from './trace/schema'\nimport type { TraceStore } from './trace/store'\nimport { buildTrajectory, type Trajectory, type TrajectoryStep } from './trajectory'\n\nexport type CounterfactualMutation =\n  | { kind: 'swap-model'; at: number; newModel: string }\n  | { kind: 'swap-tool-result'; at: number; newResult: unknown }\n  | { kind: 'truncate-after'; at: number }\n  | { kind: 'inject-system-message'; at: number; content: string }\n  | {\n      kind: 'custom'\n      at: number\n      describe: string\n      apply: (step: TrajectoryStep) => TrajectoryStep\n    }\n\nexport interface CounterfactualContext {\n  originalRunId: string\n  originalTrajectory: Trajectory\n  /** Steps up to (but not including) the mutation point — the prefix the\n   *  replayed agent inherits as its prior conversation/tool history. */\n  prefix: TrajectoryStep[]\n  mutation: CounterfactualMutation\n  /** Pre-applied mutation on the step at `mutation.at`. Consumers use this\n   *  as the FIRST step the replayed agent emits (they decide whether to\n   *  re-emit it or continue from there). */\n  mutatedStep: TrajectoryStep\n}\n\nexport interface CounterfactualResult {\n  counterfactualRunId: string\n  originalRunId: string\n  mutation: CounterfactualMutation\n  /** Structured delta summary — caller can extend via scoring. */\n  delta: {\n    originalOutcomeScore: number | null\n    counterfactualOutcomeScore: number | null\n    deltaScore: number | null\n  }\n}\n\nexport interface CounterfactualRunner {\n  /**\n   * Execute the agent from `ctx.prefix` with the mutation applied.\n   * MUST emit spans into the provided emitter so they become part of\n   * the counterfactual run. MUST call emitter.endRun() with a verdict.\n   */\n  executeFrom: (ctx: CounterfactualContext, emitter: TraceEmitter) => Promise<void>\n}\n\nexport async function runCounterfactual(\n  store: TraceStore,\n  originalRunId: string,\n  mutation: CounterfactualMutation,\n  runner: CounterfactualRunner,\n): Promise<CounterfactualResult> {\n  const originalRun = await store.getRun(originalRunId)\n  if (!originalRun) throw new NotFoundError(`counterfactual: run ${originalRunId} not found`)\n  const trajectory = await buildTrajectory(store, originalRunId)\n  if (mutation.at < 0 || mutation.at >= trajectory.steps.length) {\n    throw new ValidationError(\n      `counterfactual: mutation.at=${mutation.at} out of range [0, ${trajectory.steps.length})`,\n    )\n  }\n  const targetStep = trajectory.steps[mutation.at]!\n  const mutatedStep = applyMutation(targetStep, mutation)\n\n  const cfEmitter = new TraceEmitter(store)\n  await cfEmitter.startRun({\n    scenarioId: originalRun.scenarioId,\n    variantId: originalRun.variantId\n      ? `${originalRun.variantId}+cf:${mutation.kind}@${mutation.at}`\n      : `cf:${mutation.kind}@${mutation.at}`,\n    projectId: originalRun.projectId,\n    parentRunId: originalRunId,\n    layer: 'meta',\n    tags: { counterfactual: 'true', mutationKind: mutation.kind, mutationAt: String(mutation.at) },\n  })\n\n  await runner.executeFrom(\n    {\n      originalRunId,\n      originalTrajectory: trajectory,\n      prefix: trajectory.steps.slice(0, mutation.at),\n      mutation,\n      mutatedStep,\n    },\n    cfEmitter,\n  )\n\n  const counterfactual = await store.getRun(cfEmitter.runId)\n  const delta = {\n    originalOutcomeScore: originalRun.outcome?.score ?? null,\n    counterfactualOutcomeScore: counterfactual?.outcome?.score ?? null,\n    deltaScore:\n      originalRun.outcome?.score !== undefined && counterfactual?.outcome?.score !== undefined\n        ? counterfactual.outcome.score - originalRun.outcome.score\n        : null,\n  }\n  return { counterfactualRunId: cfEmitter.runId, originalRunId, mutation, delta }\n}\n\nfunction applyMutation(step: TrajectoryStep, mutation: CounterfactualMutation): TrajectoryStep {\n  if (mutation.kind === 'swap-model' && step.span.kind === 'llm') {\n    const llm = step.span as LlmSpan\n    return { ...step, span: { ...llm, model: mutation.newModel } }\n  }\n  if (mutation.kind === 'swap-tool-result' && step.span.kind === 'tool') {\n    const tool = step.span as ToolSpan\n    return { ...step, span: { ...tool, result: mutation.newResult } }\n  }\n  if (mutation.kind === 'inject-system-message' && step.span.kind === 'llm') {\n    const llm = step.span as LlmSpan\n    return {\n      ...step,\n      span: {\n        ...llm,\n        messages: [{ role: 'system', content: mutation.content }, ...llm.messages],\n      },\n    }\n  }\n  if (mutation.kind === 'custom') return mutation.apply(step)\n  // swap-tool-result on non-tool span / swap-model on non-llm / truncate-after: no step-level change.\n  return step\n}\n\n// Re-export Span type for consumer ergonomics.\nexport type { Span }\n"],"mappings":";;;;;;;;;;;;;;;;;AAkEA,eAAsB,kBACpB,OACA,eACA,UACA,QAC+B;CAC/B,MAAM,cAAc,MAAM,MAAM,OAAO,aAAa;CACpD,IAAI,CAAC,aAAa,MAAM,IAAI,cAAc,uBAAuB,cAAc,WAAW;CAC1F,MAAM,aAAa,MAAM,gBAAgB,OAAO,aAAa;CAC7D,IAAI,SAAS,KAAK,KAAK,SAAS,MAAM,WAAW,MAAM,QACrD,MAAM,IAAI,gBACR,+BAA+B,SAAS,GAAG,oBAAoB,WAAW,MAAM,OAAO,EACzF;CAEF,MAAM,aAAa,WAAW,MAAM,SAAS;CAC7C,MAAM,cAAc,cAAc,YAAY,QAAQ;CAEtD,MAAM,YAAY,IAAI,aAAa,KAAK;CACxC,MAAM,UAAU,SAAS;EACvB,YAAY,YAAY;EACxB,WAAW,YAAY,YACnB,GAAG,YAAY,UAAU,MAAM,SAAS,KAAK,GAAG,SAAS,OACzD,MAAM,SAAS,KAAK,GAAG,SAAS;EACpC,WAAW,YAAY;EACvB,aAAa;EACb,OAAO;EACP,MAAM;GAAE,gBAAgB;GAAQ,cAAc,SAAS;GAAM,YAAY,OAAO,SAAS,EAAE;EAAE;CAC/F,CAAC;CAED,MAAM,OAAO,YACX;EACE;EACA,oBAAoB;EACpB,QAAQ,WAAW,MAAM,MAAM,GAAG,SAAS,EAAE;EAC7C;EACA;CACF,GACA,SACF;CAEA,MAAM,iBAAiB,MAAM,MAAM,OAAO,UAAU,KAAK;CACzD,MAAM,QAAQ;EACZ,sBAAsB,YAAY,SAAS,SAAS;EACpD,4BAA4B,gBAAgB,SAAS,SAAS;EAC9D,YACE,YAAY,SAAS,UAAU,KAAA,KAAa,gBAAgB,SAAS,UAAU,KAAA,IAC3E,eAAe,QAAQ,QAAQ,YAAY,QAAQ,QACnD;CACR;CACA,OAAO;EAAE,qBAAqB,UAAU;EAAO;EAAe;EAAU;CAAM;AAChF;AAEA,SAAS,cAAc,MAAsB,UAAkD;CAC7F,IAAI,SAAS,SAAS,gBAAgB,KAAK,KAAK,SAAS,OAAO;EAC9D,MAAM,MAAM,KAAK;EACjB,OAAO;GAAE,GAAG;GAAM,MAAM;IAAE,GAAG;IAAK,OAAO,SAAS;GAAS;EAAE;CAC/D;CACA,IAAI,SAAS,SAAS,sBAAsB,KAAK,KAAK,SAAS,QAAQ;EACrE,MAAM,OAAO,KAAK;EAClB,OAAO;GAAE,GAAG;GAAM,MAAM;IAAE,GAAG;IAAM,QAAQ,SAAS;GAAU;EAAE;CAClE;CACA,IAAI,SAAS,SAAS,2BAA2B,KAAK,KAAK,SAAS,OAAO;EACzE,MAAM,MAAM,KAAK;EACjB,OAAO;GACL,GAAG;GACH,MAAM;IACJ,GAAG;IACH,UAAU,CAAC;KAAE,MAAM;KAAU,SAAS,SAAS;IAAQ,GAAG,GAAG,IAAI,QAAQ;GAC3E;EACF;CACF;CACA,IAAI,SAAS,SAAS,UAAU,OAAO,SAAS,MAAM,IAAI;CAE1D,OAAO;AACT"}
+{"version":3,"file":"counterfactual-Dn3veueY.js","names":[],"sources":["../src/counterfactual.ts"],"sourcesContent":["/**\n * Counterfactual replay — \"what would have happened if we'd changed\n * exactly one thing at turn N?\"\n *\n * The framework does NOT drive the agent — it sets up the replay\n * context (prior spans, prior state, mutation spec) and records the\n * resulting divergence. Consumers supply an `executeFrom(ctx)` callback\n * that runs their agent starting from turn N with the mutation applied.\n *\n * Counterfactual runs are recorded as a new Run with `layer='meta'` and\n * `parentRunId = originalRunId`, so downstream diff + correlation\n * pipelines see them natively.\n */\n\nimport { NotFoundError, ValidationError } from './errors'\nimport { TraceEmitter } from './trace/emitter'\nimport type { LlmSpan, Span, ToolSpan } from './trace/schema'\nimport type { TraceStore } from './trace/store'\nimport { buildTrajectory, type Trajectory, type TrajectoryStep } from './trajectory'\n\nexport type CounterfactualMutation =\n  | { kind: 'swap-model'; at: number; newModel: string }\n  | { kind: 'swap-tool-result'; at: number; newResult: unknown }\n  | { kind: 'truncate-after'; at: number }\n  | { kind: 'inject-system-message'; at: number; content: string }\n  | {\n      kind: 'custom'\n      at: number\n      describe: string\n      apply: (step: TrajectoryStep) => TrajectoryStep\n    }\n\nexport interface CounterfactualContext {\n  originalRunId: string\n  originalTrajectory: Trajectory\n  /** Steps up to (but not including) the mutation point — the prefix the\n   *  replayed agent inherits as its prior conversation/tool history. */\n  prefix: TrajectoryStep[]\n  mutation: CounterfactualMutation\n  /** Pre-applied mutation on the step at `mutation.at`. Consumers use this\n   *  as the FIRST step the replayed agent emits (they decide whether to\n   *  re-emit it or continue from there). */\n  mutatedStep: TrajectoryStep\n}\n\nexport interface CounterfactualResult {\n  counterfactualRunId: string\n  originalRunId: string\n  mutation: CounterfactualMutation\n  /** Structured delta summary — caller can extend via scoring. */\n  delta: {\n    originalOutcomeScore: number | null\n    counterfactualOutcomeScore: number | null\n    deltaScore: number | null\n  }\n}\n\nexport interface CounterfactualRunner {\n  /**\n   * Execute the agent from `ctx.prefix` with the mutation applied.\n   * MUST emit spans into the provided emitter so they become part of\n   * the counterfactual run. MUST call emitter.endRun() with a verdict.\n   */\n  executeFrom: (ctx: CounterfactualContext, emitter: TraceEmitter) => Promise<void>\n}\n\nexport async function runCounterfactual(\n  store: TraceStore,\n  originalRunId: string,\n  mutation: CounterfactualMutation,\n  runner: CounterfactualRunner,\n): Promise<CounterfactualResult> {\n  const originalRun = await store.getRun(originalRunId)\n  if (!originalRun) throw new NotFoundError(`counterfactual: run ${originalRunId} not found`)\n  const trajectory = await buildTrajectory(store, originalRunId)\n  if (mutation.at < 0 || mutation.at >= trajectory.steps.length) {\n    throw new ValidationError(\n      `counterfactual: mutation.at=${mutation.at} out of range [0, ${trajectory.steps.length})`,\n    )\n  }\n  const targetStep = trajectory.steps[mutation.at]!\n  const mutatedStep = applyMutation(targetStep, mutation)\n\n  const cfEmitter = new TraceEmitter(store)\n  await cfEmitter.startRun({\n    scenarioId: originalRun.scenarioId,\n    variantId: originalRun.variantId\n      ? `${originalRun.variantId}+cf:${mutation.kind}@${mutation.at}`\n      : `cf:${mutation.kind}@${mutation.at}`,\n    projectId: originalRun.projectId,\n    parentRunId: originalRunId,\n    layer: 'meta',\n    tags: { counterfactual: 'true', mutationKind: mutation.kind, mutationAt: String(mutation.at) },\n  })\n\n  await runner.executeFrom(\n    {\n      originalRunId,\n      originalTrajectory: trajectory,\n      prefix: trajectory.steps.slice(0, mutation.at),\n      mutation,\n      mutatedStep,\n    },\n    cfEmitter,\n  )\n\n  const counterfactual = await store.getRun(cfEmitter.runId)\n  const delta = {\n    originalOutcomeScore: originalRun.outcome?.score ?? null,\n    counterfactualOutcomeScore: counterfactual?.outcome?.score ?? null,\n    deltaScore:\n      originalRun.outcome?.score !== undefined && counterfactual?.outcome?.score !== undefined\n        ? counterfactual.outcome.score - originalRun.outcome.score\n        : null,\n  }\n  return { counterfactualRunId: cfEmitter.runId, originalRunId, mutation, delta }\n}\n\nfunction applyMutation(step: TrajectoryStep, mutation: CounterfactualMutation): TrajectoryStep {\n  if (mutation.kind === 'swap-model' && step.span.kind === 'llm') {\n    const llm = step.span as LlmSpan\n    return { ...step, span: { ...llm, model: mutation.newModel } }\n  }\n  if (mutation.kind === 'swap-tool-result' && step.span.kind === 'tool') {\n    const tool = step.span as ToolSpan\n    return { ...step, span: { ...tool, result: mutation.newResult } }\n  }\n  if (mutation.kind === 'inject-system-message' && step.span.kind === 'llm') {\n    const llm = step.span as LlmSpan\n    return {\n      ...step,\n      span: {\n        ...llm,\n        messages: [{ role: 'system', content: mutation.content }, ...llm.messages],\n      },\n    }\n  }\n  if (mutation.kind === 'custom') return mutation.apply(step)\n  // swap-tool-result on non-tool span / swap-model on non-llm / truncate-after: no step-level change.\n  return step\n}\n\n// Re-export Span type for consumer ergonomics.\nexport type { Span }\n"],"mappings":";;;;;;;;;;;;;;;;;AAkEA,eAAsB,kBACpB,OACA,eACA,UACA,QAC+B;CAC/B,MAAM,cAAc,MAAM,MAAM,OAAO,aAAa;CACpD,IAAI,CAAC,aAAa,MAAM,IAAI,cAAc,uBAAuB,cAAc,WAAW;CAC1F,MAAM,aAAa,MAAM,gBAAgB,OAAO,aAAa;CAC7D,IAAI,SAAS,KAAK,KAAK,SAAS,MAAM,WAAW,MAAM,QACrD,MAAM,IAAI,gBACR,+BAA+B,SAAS,GAAG,oBAAoB,WAAW,MAAM,OAAO,EACzF;CAEF,MAAM,aAAa,WAAW,MAAM,SAAS;CAC7C,MAAM,cAAc,cAAc,YAAY,QAAQ;CAEtD,MAAM,YAAY,IAAI,aAAa,KAAK;CACxC,MAAM,UAAU,SAAS;EACvB,YAAY,YAAY;EACxB,WAAW,YAAY,YACnB,GAAG,YAAY,UAAU,MAAM,SAAS,KAAK,GAAG,SAAS,OACzD,MAAM,SAAS,KAAK,GAAG,SAAS;EACpC,WAAW,YAAY;EACvB,aAAa;EACb,OAAO;EACP,MAAM;GAAE,gBAAgB;GAAQ,cAAc,SAAS;GAAM,YAAY,OAAO,SAAS,EAAE;EAAE;CAC/F,CAAC;CAED,MAAM,OAAO,YACX;EACE;EACA,oBAAoB;EACpB,QAAQ,WAAW,MAAM,MAAM,GAAG,SAAS,EAAE;EAC7C;EACA;CACF,GACA,SACF;CAEA,MAAM,iBAAiB,MAAM,MAAM,OAAO,UAAU,KAAK;CACzD,MAAM,QAAQ;EACZ,sBAAsB,YAAY,SAAS,SAAS;EACpD,4BAA4B,gBAAgB,SAAS,SAAS;EAC9D,YACE,YAAY,SAAS,UAAU,KAAA,KAAa,gBAAgB,SAAS,UAAU,KAAA,IAC3E,eAAe,QAAQ,QAAQ,YAAY,QAAQ,QACnD;CACR;CACA,OAAO;EAAE,qBAAqB,UAAU;EAAO;EAAe;EAAU;CAAM;AAChF;AAEA,SAAS,cAAc,MAAsB,UAAkD;CAC7F,IAAI,SAAS,SAAS,gBAAgB,KAAK,KAAK,SAAS,OAAO;EAC9D,MAAM,MAAM,KAAK;EACjB,OAAO;GAAE,GAAG;GAAM,MAAM;IAAE,GAAG;IAAK,OAAO,SAAS;GAAS;EAAE;CAC/D;CACA,IAAI,SAAS,SAAS,sBAAsB,KAAK,KAAK,SAAS,QAAQ;EACrE,MAAM,OAAO,KAAK;EAClB,OAAO;GAAE,GAAG;GAAM,MAAM;IAAE,GAAG;IAAM,QAAQ,SAAS;GAAU;EAAE;CAClE;CACA,IAAI,SAAS,SAAS,2BAA2B,KAAK,KAAK,SAAS,OAAO;EACzE,MAAM,MAAM,KAAK;EACjB,OAAO;GACL,GAAG;GACH,MAAM;IACJ,GAAG;IACH,UAAU,CAAC;KAAE,MAAM;KAAU,SAAS,SAAS;IAAQ,GAAG,GAAG,IAAI,QAAQ;GAC3E;EACF;CACF;CACA,IAAI,SAAS,SAAS,UAAU,OAAO,SAAS,MAAM,IAAI;CAE1D,OAAO;AACT"}

package/dist/{default-registry-Cn1LQ2Ve.js → default-registry-COhk9g36.js}

@@ -1,13 +1,13 @@
-import { a as hashCanonical, r as canonicalString } from "./canonical-BsZVgBhW.js";
+import { a as hashCanonical, r as canonicalString } from "./canonical-B2RqLofv.js";
 import { t as deepFreezeCanonicalJson } from "./deep-freeze-CurcOQg3.js";
 import { a as makeFinding } from "./types-IXD2HJzu.js";
-import { C as combineAbortSignals } from "./llm-client-DQveoxSM.js";
-import { A as spanEpochMillis, H as findingSubjectGrammarPromptFor, J as snapshotExactExecutionPlan, q as snapshotExactExecutionComponentIdentity, t as createTraceAnalyst } from "./kind-factory-CbZ-6tvu.js";
+import { A as spanEpochMillis, H as findingSubjectGrammarPromptFor, J as snapshotExactExecutionPlan, q as snapshotExactExecutionComponentIdentity, t as createTraceAnalyst } from "./kind-factory-BobI5Jy3.js";
 import { i as validateUsageSettlementTimeout, t as assertValidAnalystUsageReceipt } from "./usage-receipt-Cx3xNeyB.js";
 import { LLM_CONTEXT_TOKENS, LLM_INPUT_TOKEN_ATTR_KEYS, LLM_OUTPUT_TOKEN_ATTR_KEYS, TOOL_NAME_ATTR_KEYS } from "./trace-attributes.js";
 import "./otlp-attributes-D9ptWaIJ.js";
+import { y as combineAbortSignals } from "./llm-client-CyBAoYiX.js";
 import { t as executionTrackByLane } from "./execution-tracks-CpgFPpS5.js";
-import { t as analyzeSupervisorRunIntegrity } from "./integrity-BV1ZDf42.js";
+import { t as analyzeSupervisorRunIntegrity } from "./integrity-dLiDe2kD.js";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
 //#region src/feedback-trajectory-review.ts
@@ -2351,4 +2351,4 @@ function buildDefaultAnalystRegistry(options = {}) {
 //#endregion
 export { completedAnalystReviewQuality as _, KNOWLEDGE_POISONING_KIND_SPEC as a, validateAnalystReviewDecisions as b, FAILURE_MODE_KIND_SPEC as c, emitControlIntegrityFindings as d, behavioralAnalyst as f, assertUniqueFindingIds as g, analystRunDigest as h, DEFAULT_TRACE_ANALYST_KINDS as i, CONTROL_INTEGRITY_ANALYST as l, analystFindingDigest as m, AnalystRegistry as n, KNOWLEDGE_GAP_KIND_SPEC as o, deriveEfficiencyFindings as p, ExactAnalystRunExecutionError as r, IMPROVEMENT_KIND_SPEC as s, buildDefaultAnalystRegistry as t, ControlIntegrityAnalyst as u, readAnalystReview as v, snapshotAnalystRun as y };
 
-//# sourceMappingURL=default-registry-Cn1LQ2Ve.js.map
+//# sourceMappingURL=default-registry-COhk9g36.js.map