@tangle-network/agent-runtime 0.337.2 → 0.339.0

package/dist/intelligence.d.ts

@@ -1,9 +1,9 @@
-import { Cw as Redactor, Dv as ToolSpec, N_ as AgentEnvironmentProviderRef, P_ as AgentEnvironmentProviderRegistry, S as RuntimeStreamEvent, Tw as resolveRedactor, rC as OtelExportStats, wT as LoopTraceEvent, ww as defaultRedactor, xC as RuntimeTelemetryOptions } from "./types-Dl5L4r8Z.js";
-import { C as AgentCandidateExecutorPort, H as AgentCandidateRunFinalization, P as AgentCandidateOutputArtifactPort, U as AgentCandidateTaskExecution, b as AgentCandidateExecutionPorts, v as AgentCandidateBenchmarkGraderPort } from "./workspace-streams-JLjh5DC6.js";
+import { S as RuntimeStreamEvent, V_ as RuntimeTelemetryOptions, k_ as OtelExportStats, lm as AgentEnvironmentProviderRef, nb as defaultRedactor, oS as LoopTraceEvent, tb as Redactor, um as AgentEnvironmentProviderRegistry } from "./types-CaOXqRTq.js";
+import { H as AgentCandidateTaskExecution, N as AgentCandidateOutputArtifactPort, S as AgentCandidateExecutorPort, _ as AgentCandidateBenchmarkGraderPort, y as AgentCandidateExecutionPorts } from "./workspace-streams-BiS4ABah.js";
 import { d as RunAnalystLoopOpts, f as RunAnalystLoopResult } from "./types-zWfqDjeL.js";
-import { T as AgentCandidateExecutionClaimStore, _ as PrepareAgentCandidateExecutionOptions, o as CreateProtectedAgentCandidateModelPortOptions, p as parseAgentCandidateProfileActivation, y as ExecutePreparedAgentCandidateOptions } from "./protected-model-port-BhpQRTw-.js";
-import { $ as ImproveScenarioPartitions, U as ImproveMethodOptions, W as ImproveMethodResult, Z as ImproveResult, a as AgentImprovementActivationTransitionInput, c as CreateAgentImprovementActivationResultOptions, d as ProfileImprovementActivationTransitionInput, f as SealedCandidateActivationTransitionInput, h as verifyAgentImprovementActivationResult, i as AgentImprovementActivationTransition, l as ExecuteAgentImprovementActivationInput, m as executeAgentImprovementActivation, n as AgentImprovementActivationResultStore, o as AgentProfileImprovementActivationOperation, p as createAgentImprovementActivationResult, q as ImproveOptions, r as AgentImprovementActivationTargetPlan, s as AgentProfileImprovementActivationTargetPlan, t as AgentImprovementActivationReconciliation, u as ExecuteAgentImprovementActivationOptions } from "./activation-DRHM55Oo.js";
-import { AgentCandidateBenchmarkCellRef, AgentCandidateBundle, AgentCandidateEvaluationPolicy, AgentCandidateExperiment, AgentCandidateExperimentMaterial, AgentCandidateExperimentMeasurement, AgentCandidateLineage, AgentCandidateProfileActivation as CandidateProfileMaterialization, AgentImprovementActivation, AgentImprovementActivation as AgentImprovementActivation$1, AgentImprovementActivationIntent, AgentImprovementActivationIntent as AgentImprovementActivationIntent$1, AgentImprovementActivationOutcome, AgentImprovementActivationResult, AgentImprovementActivationTarget, AgentImprovementActivationTargetState, AgentImprovementActivationTargetTransition, AgentImprovementEvaluation, AgentImprovementEvaluation as AgentImprovementEvaluation$1, AgentImprovementMeasuredComparison, AgentImprovementMeasuredComparison as AgentImprovementMeasuredComparison$1, AgentImprovementProposal, AgentImprovementProposal as AgentImprovementProposal$1, AgentImprovementReview, AgentImprovementReview as AgentImprovementReview$1, AgentImprovementReviewDecision, AgentImprovementReviewDecision as AgentImprovementReviewDecision$1, AgentImprovementSource, AgentImprovementSurface, AgentProfile, AgentProfileDiff, AgentProfileImprovementChange, AgentProfileImprovementExecutionRef, AgentProfileImprovementExperiment, AgentProfileImprovementMeasuredComparison, AgentProfileImprovementMeasurement, AgentProfileImprovementRunReceipt, AgentProfileImprovementTaskMaterial, AgentProfileMcpServer, CandidateExecutionEvidence, CandidateExecutionEvidence as CandidateExecutionEvidence$1, Sha256Digest } from "@tangle-network/agent-interface";
+import { S as AgentCandidateExecutionClaimStore, d as parseAgentCandidateProfileActivation, g as ExecutePreparedAgentCandidateOptions, i as CreateProtectedAgentCandidateModelPortOptions, m as PrepareAgentCandidateExecutionOptions } from "./protected-model-port-BGgpy2r9.js";
+import { A as AgentProfileMeasuredSurface, C as verifyAgentImprovementProposal, D as AgentImprovementActivationTargetIdentity, E as AGENT_PROFILE_MEASURED_SURFACES, F as isAgentImprovementProfileSurface, I as isAgentProfileMeasuredSurface, M as agentImprovementProfileSurfaceDigest, N as agentImprovementProfileSurfaceInput, O as AgentImprovementProfileSurface, P as agentImprovementTargetProfileDiffs, S as verifyAgentImprovementActivationResult, T as AGENT_IMPROVEMENT_PROFILE_SURFACES, _ as createAgentImprovementActivationResult, _t as ImproveResult, a as AgentImprovementActivationTransitionInput, b as reviewAgentImprovementProposal, c as CreateAgentImprovementActivationOptions, d as ExecuteAgentImprovementActivationInput, f as ExecuteAgentImprovementActivationOptions, g as createAgentImprovementActivation, h as SealedCandidateActivationTransitionInput, j as agentImprovementProfileDiffs, k as AgentImprovementTargetProfileDiffOptions, l as CreateAgentImprovementActivationResultOptions, lt as ImproveMethodOptions, m as ReviewAgentImprovementInput, o as AgentProfileImprovementActivationOperation, p as ProfileImprovementActivationTransitionInput, pt as ImproveOptions, r as AgentImprovementActivationTargetPlan, s as AgentProfileImprovementActivationTargetPlan, u as CreateAgentImprovementProposalOptions, ut as ImproveMethodResult, v as createAgentImprovementProposal, w as verifyAgentImprovementReview, x as verifyAgentImprovementActivation, y as executeAgentImprovementActivation, yt as ImproveScenarioPartitions } from "./activation-CJIIl_Ey.js";
+import { AgentCandidateBenchmarkCellRef, AgentCandidateEvaluationPolicy, AgentCandidateExperiment, AgentCandidateExperimentMaterial, AgentCandidateExperimentMeasurement, AgentCandidateLineage, AgentImprovementActivation, AgentImprovementActivationIntent, AgentImprovementActivationOutcome, AgentImprovementActivationResult, AgentImprovementActivationTargetState, AgentImprovementActivationTargetTransition, AgentImprovementEvaluation, AgentImprovementMeasuredComparison, AgentImprovementProposal, AgentImprovementProposal as AgentImprovementProposal$1, AgentImprovementReview, AgentImprovementReviewDecision, AgentImprovementSource, AgentProfile, AgentProfileDiff, AgentProfileImprovementExecutionRef, AgentProfileImprovementExperiment, AgentProfileImprovementMeasuredComparison, AgentProfileImprovementMeasurement, AgentProfileImprovementRunReceipt, AgentProfileImprovementTaskMaterial, CandidateExecutionEvidence, CandidateExecutionEvidence as CandidateExecutionEvidence$1, Sha256Digest } from "@tangle-network/agent-interface";
 import { CostLedgerHandle, TraceStore } from "@tangle-network/agent-eval";
 import { ProposalFinding as ProposalFinding$1 } from "@tangle-network/agent-eval/analyst";
 import { CampaignScenarioIdentity, OptimizationMethodComparison, OptimizationPackageSource, OptimizationTokenUsage } from "@tangle-network/agent-eval/campaign";
@@ -58,10 +58,6 @@ interface EffortSettings {
 /** Per-field overrides applied on top of a tier preset. Any subset of the
  *  resolved settings; each provided field wins over the preset. */
 type EffortOverrides = Partial<EffortSettings>;
-/** The default tier when a client declares no effort. `'standard'` turns
- *  intelligence on with sensible knobs; opt down to `'off'`/`'eco'` or up to
- *  `'thorough'`/`'max'`. */
-declare const defaultEffortTier: EffortTier;
 /**
  * Compile a named tier (plus optional per-field overrides) into the flat
  * `EffortSettings` the wrapper reads. Pure: same inputs → same object, no I/O,
@@ -123,53 +119,6 @@ interface EffortOverridesCompiled {
  */
 declare function compileEffort(settings: EffortSettings): EffortOverridesCompiled;
 //#endregion
-//#region src/intelligence/improvement-surfaces.d.ts
-/** Agent improvement surfaces delivered as exact `AgentProfileDiff` replacements. */
-declare const AGENT_IMPROVEMENT_PROFILE_SURFACES: readonly ["prompt", "skills", "tools", "mcp", "hooks", "subagents"];
-type AgentImprovementProfileSurface = (typeof AGENT_IMPROVEMENT_PROFILE_SURFACES)[number];
-/**
- * Profile changes eligible for the product-owned measured comparison path.
- * The six directly deliverable profile surfaces retain their granular labels;
- * any residual profile axis also adds the complete `agent-profile` surface.
- */
-declare const AGENT_PROFILE_MEASURED_SURFACES: readonly ["prompt", "skills", "tools", "mcp", "hooks", "subagents", "agent-profile"];
-type AgentProfileMeasuredSurface = (typeof AGENT_PROFILE_MEASURED_SURFACES)[number];
-interface AgentImprovementTargetProfileDiffOptions {
-  id: string;
-  source?: AgentProfileDiff['source'];
-  metadata?: Record<string, unknown>;
-}
-type AgentImprovementActivationTargetIdentity = Pick<AgentImprovementActivationTarget, 'surface' | 'identity'>;
-/** Bind caller-owned target identities to the exact source state Runtime measured. */
-declare function buildAgentImprovementActivationTargets(surfaces: readonly AgentImprovementSurface[], experiment: AgentImprovementEvaluation$1['experiment'], intent: AgentImprovementActivationIntent$1, identities: readonly AgentImprovementActivationTargetIdentity[]): [AgentImprovementActivationTarget, ...AgentImprovementActivationTarget[]];
-/** Return whether a measured surface can be delivered through an agent profile. */
-declare function isAgentImprovementProfileSurface(surface: AgentImprovementSurface): surface is AgentImprovementProfileSurface;
-/** Return whether a surface is eligible for shared profile measurement. */
-declare function isAgentProfileMeasuredSurface(surface: string): surface is AgentProfileMeasuredSurface;
-/**
- * Return the canonical current-state input for one profile-deliverable improvement target.
- * Missing slots become `null`; tools and subagents include both their direct and resource slots.
- * Unrelated profile fields are excluded. The result matches `agentImprovementTargetInput` for the
- * same profile inside a candidate bundle.
- */
-declare function agentImprovementProfileSurfaceInput(profile: AgentProfile, surface: AgentImprovementProfileSurface): unknown;
-/** Return the `Sha256Digest` of one profile surface using Runtime's canonical candidate digest. */
-declare function agentImprovementProfileSurfaceDigest(profile: AgentProfile, surface: AgentImprovementProfileSurface): Sha256Digest;
-/**
- * Replace one measured profile surface exactly, including array-valued resources.
- * Apply the returned diffs in order: a diff applies its set before its removal,
- * so exact replacement requires a reset record followed by a set record.
- */
-declare function agentImprovementTargetProfileDiffs(target: {
-  surface: AgentImprovementProfileSurface;
-  desiredInput: unknown;
-}, options: AgentImprovementTargetProfileDiffOptions): [AgentProfileDiff, ...AgentProfileDiff[]];
-/**
- * Derive the ordered profile patch that changes one executable profile into
- * another, then prove the patch preserves the complete candidate state.
- */
-declare function agentImprovementProfileDiffs(baselineInput: AgentProfile, candidateInput: AgentProfile, options: AgentImprovementTargetProfileDiffOptions): [AgentProfileDiff, ...AgentProfileDiff[]];
-//#endregion
 //#region src/intelligence/profile-activation.d.ts
 type AgentImprovementProfileActivationTarget = Omit<AgentImprovementActivationTargetPlan, 'surface'> & {
   surface: AgentImprovementProfileSurface;
@@ -251,7 +200,7 @@ interface RunAgentCandidateExperimentOptions extends Omit<CompareCandidateExperi
 interface RunAgentCandidateExperimentResult {
   experiment: AgentCandidateExperiment;
   measurements: AgentCandidateExperimentMeasurement[];
-  evaluation: AgentImprovementMeasuredComparison$1;
+  evaluation: AgentImprovementMeasuredComparison;
 }
 interface ExecuteAgentCandidateExperimentCellOptions extends CandidateExperimentExecutionInput, AgentCandidateExperimentCellPlacement {}
 interface VerifyCandidateExecutionEvidenceOptions {
@@ -262,40 +211,6 @@ interface VerifyCandidateExecutionEvidenceOptions {
   attempt?: number;
   resolvedResources?: ReadonlyMap<Sha256Digest, string>;
 }
-/** A failed baseline or candidate cell with its complete Runtime failure result. */
-declare class AgentCandidateExperimentCellExecutionError extends Error {
-  readonly finalization: Extract<AgentCandidateRunFinalization, {
-    succeeded: false;
-  }>;
-  constructor(finalization: Extract<AgentCandidateRunFinalization, {
-    succeeded: false;
-  }>);
-}
-interface CreateAgentImprovementProposalOptions {
-  runId: string;
-  findings: readonly ProposalFinding$1[];
-  evaluation: AgentImprovementEvaluation$1;
-  now?: () => Date;
-}
-type CreateAgentImprovementMeasuredComparisonOptions = CompareCandidateExperimentOptions;
-interface ReviewAgentImprovementInput {
-  decision: AgentImprovementReviewDecision$1;
-  reviewedBy: string;
-  reason: string;
-  feedback?: string;
-  now?: () => Date;
-}
-interface CreateAgentImprovementActivationOptions {
-  intent: AgentImprovementActivationIntent$1;
-  /** Runtime derives each exact source digest; callers identify only the records to change. */
-  targets: [AgentImprovementActivationTargetIdentity, ...AgentImprovementActivationTargetIdentity[]];
-  fundingOwner: string;
-  authorizedBy: string;
-  expiresAt: string;
-  /** Required only when an activation targets the complete `agent-profile` surface. */
-  executionRef?: AgentProfileImprovementExecutionRef;
-  now?: () => Date;
-}
 type AgentImprovementAnalysisOptions = Omit<RunAnalystLoopOpts, 'runId' | 'inputs' | 'improvementProposalSource' | 'knowledgeProposalSource' | 'onEvent' | 'log' | 'costLedger' | 'costPhase' | 'signal'> & {
   inputs: Omit<RunAnalystLoopOpts['inputs'], 'judgeInput'> & {
     judgeInput?: never;
@@ -316,8 +231,8 @@ interface ProposeAgentImprovementOptions<TScenario extends Scenario$1, TArtifact
   placeCell: RunAgentCandidateExperimentOptions['placeCell'];
   maxConcurrency?: number;
   signal?: AbortSignal;
-  candidate?: AgentImprovementMeasuredComparison$1['candidate'];
-  metadata?: AgentImprovementMeasuredComparison$1['metadata'];
+  candidate?: AgentImprovementMeasuredComparison['candidate'];
+  metadata?: AgentImprovementMeasuredComparison['metadata'];
   now?: () => Date;
 }
 /** Product-supplied experiment material. Runtime supplies optimizer ancestry and the final digest. */
@@ -386,8 +301,6 @@ interface ProposeAgentProfileImprovementResult {
 declare function runAgentCandidateExperiment(options: RunAgentCandidateExperimentOptions): Promise<RunAgentCandidateExperimentResult>;
 /** Execute one exact arm, task, repetition, seed, and attempt through Runtime. */
 declare function executeAgentCandidateExperimentCell(options: ExecuteAgentCandidateExperimentCellOptions): Promise<CandidateExecutionEvidence$1>;
-/** Delegate all statistics and promotion checks to agent-eval's receipt-based comparison. */
-declare function createAgentImprovementMeasuredComparison(options: CreateAgentImprovementMeasuredComparisonOptions): AgentImprovementMeasuredComparison$1;
 /**
  * Analyze a product-owned profile, search one profile surface, then run the
  * exact baseline and candidate through the product executor before proposing.
@@ -395,22 +308,6 @@ declare function createAgentImprovementMeasuredComparison(options: CreateAgentIm
 declare function proposeAgentProfileImprovement<TScenario extends Scenario$1, TArtifact>(options: ProposeAgentProfileImprovementOptions<TScenario, TArtifact>): Promise<ProposeAgentProfileImprovementResult>;
 /** Analyze, search, then remeasure the resulting exact candidate before proposing it. */
 declare function proposeAgentImprovement<TScenario extends Scenario$1, TArtifact>(options: ProposeAgentImprovementOptions<TScenario, TArtifact>): Promise<ProposeAgentImprovementResult<TScenario, TArtifact>>;
-/** Create the reviewable record only from a complete, recomputable experiment result. */
-declare function createAgentImprovementProposal(options: CreateAgentImprovementProposalOptions): AgentImprovementProposal$1;
-/** Persist a human or tenant-policy decision bound to one exact proposal. */
-declare function reviewAgentImprovementProposal(inputProposal: AgentImprovementProposal$1, input: ReviewAgentImprovementInput): AgentImprovementReview$1;
-/** Authorize product-owned writes only after the exact candidate was measured and approved. */
-declare function createAgentImprovementActivation(inputProposal: AgentImprovementProposal$1, inputReview: AgentImprovementReview$1, options: CreateAgentImprovementActivationOptions): AgentImprovementActivation$1;
-/** Validate a proposal and recompute every binding to its measured experiment. */
-declare function verifyAgentImprovementProposal(input: unknown): AgentImprovementProposal$1;
-/** Validate the canonical identity and wire shape of an improvement review. */
-declare function verifyAgentImprovementReview(input: unknown): AgentImprovementReview$1;
-/** Validate activation authority against the exact proposal, review, experiment, and base state. */
-declare function verifyAgentImprovementActivation(input: {
-  proposal: unknown;
-  review: unknown;
-  activation: unknown;
-}): AgentImprovementActivation$1;
 /** Recheck one Runtime receipt against its exact signed experiment cell. */
 declare function verifyCandidateExecutionEvidence(input: unknown, options: VerifyCandidateExecutionEvidenceOptions): CandidateExecutionEvidence$1;
 //#endregion
@@ -560,47 +457,6 @@ interface PullCertifiedOptions {
   /** Abort the request after this many ms. Default 10000. */
   timeoutMs?: number;
 }
-/** What Runtime knows about a failed proposal submission.
- * `not-sent` means no request began, `rejected` means Intelligence returned a
- * definitive 4xx response, and `unconfirmed` means the caller may safely retry
- * the same immutable proposal. */
-type AgentImprovementProposalSubmissionState = 'not-sent' | 'rejected' | 'unconfirmed';
-/** Submit a completed measured proposal for product-side review. */
-interface SubmitAgentImprovementProposalOptions {
-  proposal: AgentImprovementProposal$1;
-  /** Bearer key. Defaults to `process.env.TANGLE_API_KEY`. */
-  apiKey?: string;
-  /** Plane base URL. Defaults to `process.env.TANGLE_INTELLIGENCE_URL` then
-   * `https://intelligence.tangle.tools`. */
-  baseUrl?: string;
-  /** fetch impl (tests / non-global-fetch runtimes). Defaults to global fetch. */
-  fetchImpl?: typeof fetch;
-  /** Abort the request after this many ms. Default 10000. */
-  timeoutMs?: number;
-}
-/** Typed result for proposal submission. A successful result contains the
- * exact immutable proposal Intelligence recorded. */
-type SubmitAgentImprovementProposalOutcome = {
-  succeeded: true;
-  value: AgentImprovementProposal$1;
-  status: number;
-} | {
-  succeeded: false;
-  submission: AgentImprovementProposalSubmissionState;
-  error: string;
-  status?: number;
-  code?: string;
-};
-/** Resolve the ONE Intelligence base URL — the single knob both the send and
- *  receive paths derive from. Env fallback: `TANGLE_INTELLIGENCE_URL`. */
-declare function resolveIntelligenceBaseUrl(baseUrl: string | undefined): string;
-/**
- * Deserialize the composed-endpoint response into a `CertifiedProfile`. The
- * previously-dropped `agentProfileDiffs`/`capabilities`/`agentProfile` are read
- * here so they round-trip to the consumer; a plane that has not yet promoted any
- * diffs simply yields empty arrays / a null profile (fail-closed, never a crash).
- */
-declare function normalizeCertifiedProfile(raw: unknown): CertifiedProfile;
 /**
  * Pull the certified composed profile for a target. Fail-closed: a network
  * error or a non-2xx returns a typed `succeeded: false` (never throws), so a
@@ -608,14 +464,6 @@ declare function normalizeCertifiedProfile(raw: unknown): CertifiedProfile;
  * the normal "nothing promoted yet" signal, carried as `status: 404`.
  */
 declare function pullCertified(opts: PullCertifiedOptions): Promise<PullOutcome>;
-/**
- * Submit a completed Runtime proposal to Intelligence for product-side review.
- * This never runs an experiment, approves a proposal, or applies a candidate.
- * A 4xx response is a confirmed `rejected` request. Network failures, timeouts,
- * 5xx responses, and invalid success responses are `unconfirmed`, so callers
- * can retry the same digest because Intelligence stores proposals idempotently.
- */
-declare function submitAgentImprovementProposal(opts: SubmitAgentImprovementProposalOptions): Promise<SubmitAgentImprovementProposalOutcome>;
 /**
  * Fold the certified prompt surface (and any certified prompt-folding artifacts:
  * `prompt-surface` / `skill` / `instructions`) into a base system prompt under a
@@ -692,8 +540,6 @@ type CapabilityInterface = {
   name: string;
   description?: string;
 };
-/** Every interface surface tag supported by the manifest schema. */
-type CapabilitySurface = CapabilityInterface['surface'];
 /**
  * Where a capability's bytes live. A leaked manifest carries no live secret and
  * no inlined blob: `github`/`blob` are pointers resolved at provision time.
@@ -845,56 +691,6 @@ interface CapabilityManifest {
   promptSurface: CertifiedPromptSurface | null;
   capabilities: CertifiedCapability[];
 }
-/** One retrieval handle. The agent never learns vector vs graph vs index. */
-interface ResolvedRetrieval {
-  name: string;
-  retrieve(query: string, k?: number): Promise<Array<{
-    text: string;
-    score?: number;
-  }>>;
-}
-/** One resolved hook — event + the command/matcher the seam folds into
- *  `AgentProfile.hooks`. */
-interface ResolvedHook {
-  event: string;
-  command: string;
-  matcher?: string;
-}
-/** One resolved subagent — folded into `AgentProfile.subagents`. */
-interface ResolvedSubagent {
-  name: string;
-  description?: string;
-  prompt?: string;
-}
-/** Materialized capability surfaces supplied by a consumer-owned executor. */
-interface ResolvedSurface {
-  /** Host-side tool defs → `RouterToolsSeam.tools` / agent-app `extraTools`. */
-  tools: ToolSpec[];
-  /** Host-side dispatch for a resolved tool. Throws when `name` is unknown so a
-   *  mis-dispatch is loud, never a silent empty string. */
-  execute(name: string, args: Record<string, unknown>, task: unknown): Promise<string>;
-  /** Sandbox-side tool delivery → `AgentProfile.mcp` / in-proc `createMcpEnvironment`. */
-  mcpConnections: Record<string, AgentProfileMcpServer>;
-  /** Prompt-context additions, byte-stable-ordered → folded system prompt. */
-  promptAdditions: string[];
-  /** Workspace files → `AgentProfile.resources.files`. */
-  files: Array<{
-    path: string;
-    content: string;
-    executable?: boolean;
-  }>;
-  /** Uniform retrieval handles. */
-  retrieval: ResolvedRetrieval[];
-  /** Hooks → `AgentProfile.hooks`. */
-  hooks: ResolvedHook[];
-  /** Subagents → `AgentProfile.subagents`. */
-  subagents: ResolvedSubagent[];
-  /** The folded system prompt — base + the byte-stable prompt additions, exactly
-   *  as `composeCertifiedPrompt` renders the inline/context capabilities. */
-  systemPrompt: string;
-  /** Tear down provisioned hosts (reverse dependency order). */
-  dispose(): Promise<void>;
-}
 /**
  * A consumer rejected a binding that its executor does not admit.
  */
@@ -1023,7 +819,7 @@ interface OptimizationReceiptCost {
 /** Build a detached receipt only for methods backed by an identified external optimizer. */
 declare function createOptimizationActivationReceipt(improvement: ImproveMethodResult): OptimizationActivationReceipt | undefined;
 /** Read and verify the optimizer evidence carried by a measured proposal. */
-declare function optimizationActivationReceiptFromMetadata(metadata: AgentImprovementMeasuredComparison$1['metadata']): OptimizationActivationReceipt | undefined;
+declare function optimizationActivationReceiptFromMetadata(metadata: AgentImprovementMeasuredComparison['metadata']): OptimizationActivationReceipt | undefined;
 //#endregion
 //#region src/intelligence/with-intelligence.d.ts
 /** What the hook hands the agent each run. Additive over the prompt-only
@@ -1279,21 +1075,6 @@ interface RecordTraceMeta {
    *  `traceRun` span). Omitted ⇒ the loop root is the trace root. */
   rootParentSpanId?: string;
 }
-/** The resolved outcome of one traced run, surfaced on the export span and
- *  available to the caller for downstream billing assertions. */
-interface TraceOutcome {
-  runId: string;
-  traceId: string;
-  project: string;
-  /** The resolved effort settings this run executed under. */
-  effort: EffortSettings;
-  /** True when this run ran as pure passthrough (the OFF floor). */
-  intelligenceOff: boolean;
-  success?: boolean;
-  score?: number;
-  /** Per-class billing split. `intelligenceUsd` is `0` at the OFF tier. */
-  usage: UsageSplit;
-}
 /** The Observe-mode Intelligence client. */
 interface IntelligenceClient {
   /** The resolved project id. */
@@ -1369,5 +1150,5 @@ interface DoctorReport {
  */
 declare function createIntelligenceClient(config: IntelligenceConfig): IntelligenceClient;
 //#endregion
-export { AGENT_IMPROVEMENT_PROFILE_SURFACES, AGENT_PROFILE_MEASURED_SURFACES, type AgentCandidateExecutionHostPorts, AgentCandidateExperimentCellExecutionError, type AgentCandidateExperimentCellPlacement, type AgentImprovementActivation, type AgentImprovementActivationIntent, type AgentImprovementActivationOutcome, type AgentImprovementActivationReconciliation, type AgentImprovementActivationResult, type AgentImprovementActivationResultStore, type AgentImprovementActivationTargetIdentity, type AgentImprovementActivationTargetPlan, type AgentImprovementActivationTransition, type AgentImprovementActivationTransitionInput, type AgentImprovementAnalysisOptions, type AgentImprovementEvaluation, type AgentImprovementExperimentMaterial, type AgentImprovementMeasuredComparison, type AgentImprovementProfileActivationInput, type AgentImprovementProfileActivationPreparation, type AgentImprovementProfileActivationTarget, type AgentImprovementProfileReplacement, type AgentImprovementProfileStateDigest, type AgentImprovementProfileStateDigestInput, type AgentImprovementProfileStateResolver, type AgentImprovementProfileStateResolverInput, type AgentImprovementProfileSurface, type AgentImprovementProfileTargetState, type AgentImprovementProfileTargetTransition, type AgentImprovementProposal, type AgentImprovementProposalSubmissionState, type AgentImprovementReview, type AgentImprovementReviewDecision, type AgentImprovementTargetProfileDiffOptions, type AgentProfileCandidateMeasurementExecutor, type AgentProfileImprovementActivationOperation, type AgentProfileImprovementActivationTargetPlan, type AgentProfileImprovementBenchmark, type AgentProfileImprovementExecutor, type AgentProfileImprovementMethodOptions, type AgentProfileMeasuredSurface, type AppliedIntelligence, type AuthoredAgentProfileCandidateLineage, type AuthoredAgentProfileDiffOptions, type CandidateExecutionEvidence, type CandidateProfileMaterialization, type CapabilityAuth, type CapabilityInterface, type CapabilityManifest, CapabilityNotAdmittedError, type CapabilitySurface, type CertProvenance, type CertifiedArtifact, type CertifiedCapability, type CertifiedCapabilitySummary, type CertifiedProfile, type CertifiedPromptSource, type CertifiedPromptSourceOptions, type CertifiedPromptSurface, type ContentRef, type CorpusAccess, type CreateAgentImprovementActivationOptions, type CreateAgentImprovementActivationResultOptions, type CreateAgentImprovementProposalOptions, type CreateExactProcessCandidateExperimentExecutorOptions, type CreateProtectedExactProcessCandidateExperimentExecutorOptions, type CredentialRef, type DeliveryBinding, type DeliveryBindingKind, type DiffProvenance, DoctorReport, type EffortOverrides, type EffortOverridesCompiled, type EffortSettings, type EffortTier, type ExactProcessCandidateExperimentExecution, type ExactProcessCandidateExperimentExecutor, type ExecuteAgentCandidateExperimentCellOptions, type ExecuteAgentImprovementActivationInput, type ExecuteAgentImprovementActivationOptions, type HostSpec, type IntelligenceAgent, IntelligenceClient, IntelligenceConfig, type IntelligenceHookConfig, type IntelligenceWrapped, type JsonSchema, ModeReadiness, type OptimizationActivationReceipt, type OptimizationReceiptCost, type ProfileImprovementActivationTransitionInput, type ProposeAgentImprovementOptions, type ProposeAgentImprovementResult, type ProposeAgentProfileImprovementOptions, type ProposeAgentProfileImprovementResult, type ProposeAuthoredAgentProfileImprovementOptions, type ProposeAuthoredAgentProfileImprovementResult, type ProposedProfileDiff, type ProtectedExactProcessCandidateExperimentExecutor, type PullCertifiedOptions, type PullOutcome, RecordTraceMeta, type Redactor, RepoConfig, type ResolvedHook, type ResolvedRetrieval, type ResolvedSubagent, type ResolvedSurface, type ReviewAgentImprovementInput, type RunAgentCandidateExperimentOptions, type RunAgentCandidateExperimentResult, RunRecord, RunReport, type SealedCandidateActivationTransitionInput, type SubmitAgentImprovementProposalOptions, type SubmitAgentImprovementProposalOutcome, TraceHandle, TraceMeta, TraceOutcome, UsageSplit, type VerifyCandidateExecutionEvidenceOptions, agentImprovementProfileDiffs, agentImprovementProfileSurfaceDigest, agentImprovementProfileSurfaceInput, agentImprovementTargetProfileDiffs, buildAgentImprovementActivationTargets, compileEffort, composeCertifiedPrompt, createAgentImprovementActivation, createAgentImprovementActivationResult, createAgentImprovementMeasuredComparison, createAgentImprovementProposal, createCertifiedPromptSource, createExactProcessCandidateExperimentExecutor, createIntelligenceClient, createOptimizationActivationReceipt, createProtectedExactProcessCandidateExperimentExecutor, defaultEffortTier, defaultRedactor, exactProcessCandidateExperimentExecutionSupport, executeAgentCandidateExperimentCell, executeAgentImprovementActivation, isAgentImprovementProfileSurface, isAgentProfileMeasuredSurface, isIntelligenceOff, manifestFromProfile, normalizeCertifiedProfile, optimizationActivationReceiptFromMetadata, parseAgentCandidateProfileActivation as parseCandidateProfileMaterialization, prepareAgentImprovementProfileActivation, proposeAgentImprovement, proposeAgentProfileImprovement, proposeAuthoredAgentProfileImprovement, pullCertified, resolveEffort, resolveIntelligenceBaseUrl, resolveRedactor, reviewAgentImprovementProposal, runAgentCandidateExperiment, submitAgentImprovementProposal, verifyAgentImprovementActivation, verifyAgentImprovementActivationResult, verifyAgentImprovementProposal, verifyAgentImprovementReview, verifyCandidateExecutionEvidence, withIntelligence };
+export { type AGENT_IMPROVEMENT_PROFILE_SURFACES, type AGENT_PROFILE_MEASURED_SURFACES, type AgentCandidateExecutionHostPorts, type AgentCandidateExperimentCellPlacement, type AgentEnvironmentProviderRef, type AgentImprovementActivation, type AgentImprovementActivationIntent, type AgentImprovementActivationOutcome, type AgentImprovementActivationResult, type AgentImprovementActivationTargetIdentity, type AgentImprovementActivationTargetPlan, type AgentImprovementActivationTransitionInput, type AgentImprovementAnalysisOptions, type AgentImprovementEvaluation, type AgentImprovementExperimentMaterial, type AgentImprovementProfileActivationInput, type AgentImprovementProfileActivationPreparation, type AgentImprovementProfileActivationTarget, type AgentImprovementProfileReplacement, type AgentImprovementProfileStateDigest, type AgentImprovementProfileStateDigestInput, type AgentImprovementProfileStateResolver, type AgentImprovementProfileStateResolverInput, type AgentImprovementProfileSurface, type AgentImprovementProfileTargetState, type AgentImprovementProfileTargetTransition, type AgentImprovementProposal, type AgentImprovementReview, type AgentImprovementReviewDecision, type AgentImprovementTargetProfileDiffOptions, type AgentProfileCandidateMeasurementExecutor, type AgentProfileImprovementActivationOperation, type AgentProfileImprovementActivationTargetPlan, type AgentProfileImprovementBenchmark, type AgentProfileImprovementExecutor, type AgentProfileImprovementMethodOptions, type AgentProfileMeasuredSurface, type AppliedIntelligence, type AuthoredAgentProfileCandidateLineage, type CandidateExecutionEvidence, type CapabilityAuth, type CapabilityInterface, type CapabilityManifest, CapabilityNotAdmittedError, type CertProvenance, type CertifiedArtifact, type CertifiedCapability, type CertifiedCapabilitySummary, type CertifiedProfile, type CertifiedPromptSource, type CertifiedPromptSourceOptions, type CertifiedPromptSurface, type ContentRef, type CorpusAccess, type CreateAgentImprovementActivationOptions, type CreateAgentImprovementActivationResultOptions, type CreateAgentImprovementProposalOptions, type CreateExactProcessCandidateExperimentExecutorOptions, type CreateProtectedExactProcessCandidateExperimentExecutorOptions, type CredentialRef, type DeliveryBinding, type DiffProvenance, DoctorReport, type EffortOverridesCompiled, type EffortSettings, type EffortTier, type ExactProcessCandidateExperimentExecution, type ExactProcessCandidateExperimentExecutor, type ExecuteAgentCandidateExperimentCellOptions, type ExecuteAgentImprovementActivationInput, type ExecuteAgentImprovementActivationOptions, type HostSpec, type ImproveResult, type IntelligenceAgent, IntelligenceClient, IntelligenceConfig, type IntelligenceHookConfig, type IntelligenceWrapped, type JsonSchema, ModeReadiness, type OptimizationActivationReceipt, type OptimizationReceiptCost, type PrepareAgentCandidateExecutionOptions, type ProfileImprovementActivationTransitionInput, type ProposeAgentImprovementOptions, type ProposeAgentImprovementResult, type ProposeAgentProfileImprovementOptions, type ProposeAgentProfileImprovementResult, type ProposeAuthoredAgentProfileImprovementOptions, type ProposeAuthoredAgentProfileImprovementResult, type ProposedProfileDiff, type ProtectedExactProcessCandidateExperimentExecutor, type PullCertifiedOptions, type PullOutcome, RecordTraceMeta, type Redactor, RepoConfig, type ReviewAgentImprovementInput, type RunAgentCandidateExperimentOptions, type RunAgentCandidateExperimentResult, RunRecord, RunReport, type SealedCandidateActivationTransitionInput, TraceHandle, TraceMeta, UsageSplit, type VerifyCandidateExecutionEvidenceOptions, agentImprovementProfileDiffs, agentImprovementProfileSurfaceDigest, agentImprovementProfileSurfaceInput, agentImprovementTargetProfileDiffs, compileEffort, composeCertifiedPrompt, createAgentImprovementActivation, createAgentImprovementActivationResult, createAgentImprovementProposal, createCertifiedPromptSource, createExactProcessCandidateExperimentExecutor, createIntelligenceClient, createOptimizationActivationReceipt, createProtectedExactProcessCandidateExperimentExecutor, defaultRedactor, exactProcessCandidateExperimentExecutionSupport, executeAgentCandidateExperimentCell, executeAgentImprovementActivation, isAgentImprovementProfileSurface, isAgentProfileMeasuredSurface, isIntelligenceOff, manifestFromProfile, optimizationActivationReceiptFromMetadata, parseAgentCandidateProfileActivation as parseCandidateProfileMaterialization, prepareAgentImprovementProfileActivation, proposeAgentImprovement, proposeAgentProfileImprovement, proposeAuthoredAgentProfileImprovement, pullCertified, resolveEffort, reviewAgentImprovementProposal, runAgentCandidateExperiment, verifyAgentImprovementActivation, verifyAgentImprovementActivationResult, verifyAgentImprovementProposal, verifyAgentImprovementReview, verifyCandidateExecutionEvidence, withIntelligence };
 //# sourceMappingURL=intelligence.d.ts.map