@tangle-network/agent-runtime 0.349.0 → 0.350.2

package/dist/intelligence.d.ts

@@ -1,15 +1,14 @@
-import { Em as AgentEnvironmentProviderRegistry, G_ as OtelExportStats, S as RuntimeStreamEvent, Tm as AgentEnvironmentProviderRef, gS as LoopTraceEvent, gb as defaultRedactor, hb as Redactor, rv as RuntimeTelemetryOptions } from "./types-C8BGOCBn.js";
-import { H as AgentCandidateTaskExecution, N as AgentCandidateOutputArtifactPort, S as AgentCandidateExecutorPort, _ as AgentCandidateBenchmarkGraderPort, y as AgentCandidateExecutionPorts } from "./workspace-streams-BiS4ABah.js";
-import { d as RunAnalystLoopResult, u as RunAnalystLoopOpts } from "./types-Cwrea-bU.js";
-import { b as AgentCandidateExecutionClaimStore, f as PrepareAgentCandidateExecutionOptions, i as CreateProtectedAgentCandidateModelPortOptions, m as ExecutePreparedAgentCandidateOptions, u as parseAgentCandidateProfileActivation } from "./protected-model-port-DVVh-hEk.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-wBipBkCf.js";
+import { FS as LoopTraceEvent, Fb as defaultRedactor, Pb as Redactor, S as RuntimeStreamEvent, Sv as RuntimeTelemetryOptions, Um as AgentEnvironmentProviderRef, Wm as AgentEnvironmentProviderRegistry, uv as OtelExportStats } from "./types-Fowuwdz2.js";
+import { H as AgentCandidateTaskExecution, N as AgentCandidateOutputArtifactPort, S as AgentCandidateExecutorPort, _ as AgentCandidateBenchmarkGraderPort, y as AgentCandidateExecutionPorts } from "./workspace-streams-Dq2Fzk3c.js";
+import { d as RunAnalystLoopResult, u as RunAnalystLoopOpts } from "./types-qsqfyQoY.js";
+import { b as AgentCandidateExecutionClaimStore, f as PrepareAgentCandidateExecutionOptions, i as CreateProtectedAgentCandidateModelPortOptions, m as ExecutePreparedAgentCandidateOptions, u as parseAgentCandidateProfileActivation } from "./protected-model-port-IKqhTypD.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-DyiHrTlS.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";
 import { AgentProfileImprovementExperimentExecutionInput, CandidateExperimentExecutionInput, CompareCandidateExperimentOptions, Scenario as Scenario$1 } from "@tangle-network/agent-eval/contract";
 import { AgentExactProcessResources } from "@tangle-network/agent-interface/environment-provider";
-//#region src/intelligence/effort.d.ts
 /**
  *
  * EffortPolicy — pure data, no execution. Resolves a named tier into a flat
@@ -69,7 +68,7 @@ type EffortOverrides = Partial<EffortSettings>;
  * caller explicitly overrides a field — overriding off is an opt-in the caller
  * owns, not a default the composer leaks.
  */
-declare function resolveEffort(tier: EffortTier, overrides?: EffortOverrides): EffortSettings;
+export declare function resolveEffort(tier: EffortTier, overrides?: EffortOverrides): EffortSettings;
 /**
  * True when these settings admit NO intelligence spawn — the passthrough
  * predicate the wrapper branches on. Every intelligence axis must be off:
@@ -77,7 +76,7 @@ declare function resolveEffort(tier: EffortTier, overrides?: EffortOverrides): E
  * budget. A caller who overrides any one of these back on is no longer at the
  * OFF floor and the wrapper treats them as an intelligence-enabled run.
  */
-declare function isIntelligenceOff(settings: EffortSettings): boolean;
+export declare function isIntelligenceOff(settings: EffortSettings): boolean;
 /**
  * The run-config overrides an `EffortSettings` compiles to — the bridge between the
  * pure effort policy and the orchestration entrypoints (`runPersonified` / the
@@ -117,9 +116,7 @@ interface EffortOverridesCompiled {
  * (no breadth) at `off`; `withLoops: false` no-ops the improvement cycle. `standard`+
  * compile to `withAnalyst: true`, the tier's `fanout`, and `withLoops: true`.
  */
-declare function compileEffort(settings: EffortSettings): EffortOverridesCompiled;
-//#endregion
-//#region src/intelligence/profile-activation.d.ts
+export declare function compileEffort(settings: EffortSettings): EffortOverridesCompiled;
 type AgentImprovementProfileActivationTarget = Omit<AgentImprovementActivationTargetPlan, 'surface'> & {
   surface: AgentImprovementProfileSurface;
 };
@@ -175,9 +172,7 @@ type AgentImprovementProfileActivationPreparation = {
  * all-or-none replacements. The product owns locking, persistence, and retained
  * state; Runtime owns the profile diff semantics and digest checks.
  */
-declare function prepareAgentImprovementProfileActivation(input: AgentImprovementProfileActivationInput): AgentImprovementProfileActivationPreparation;
-//#endregion
-//#region src/intelligence/improvement-cycle.d.ts
+export declare function prepareAgentImprovementProfileActivation(input: AgentImprovementProfileActivationInput): AgentImprovementProfileActivationPreparation;
 interface AgentCandidateExperimentCellPlacement {
   executionId: string;
   attempt?: number;
@@ -298,20 +293,18 @@ interface ProposeAgentProfileImprovementResult {
   proposal: AgentImprovementProposal$1;
 }
 /** Execute both arms of one immutable experiment and derive its paired result. */
-declare function runAgentCandidateExperiment(options: RunAgentCandidateExperimentOptions): Promise<RunAgentCandidateExperimentResult>;
+export 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>;
+export declare function executeAgentCandidateExperimentCell(options: ExecuteAgentCandidateExperimentCellOptions): Promise<CandidateExecutionEvidence$1>;
 /**
  * Analyze a product-owned profile, search one profile surface, then run the
  * exact baseline and candidate through the product executor before proposing.
  */
-declare function proposeAgentProfileImprovement<TScenario extends Scenario$1, TArtifact>(options: ProposeAgentProfileImprovementOptions<TScenario, TArtifact>): Promise<ProposeAgentProfileImprovementResult>;
+export 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>>;
+export declare function proposeAgentImprovement<TScenario extends Scenario$1, TArtifact>(options: ProposeAgentImprovementOptions<TScenario, TArtifact>): Promise<ProposeAgentImprovementResult<TScenario, TArtifact>>;
 /** Recheck one Runtime receipt against its exact signed experiment cell. */
-declare function verifyCandidateExecutionEvidence(input: unknown, options: VerifyCandidateExecutionEvidenceOptions): CandidateExecutionEvidence$1;
-//#endregion
-//#region src/intelligence/authored-profile-improvement.d.ts
+export declare function verifyCandidateExecutionEvidence(input: unknown, options: VerifyCandidateExecutionEvidenceOptions): CandidateExecutionEvidence$1;
 /** Lineage accepted by the direct candidate path. Optimizer lineage belongs to `improve()`. */
 type AuthoredAgentProfileCandidateLineage = Omit<AgentCandidateLineage, 'source' | 'profileDiffIds'> & {
   source: Exclude<AgentCandidateLineage['source'], 'optimizer'>;
@@ -364,9 +357,7 @@ interface ProposeAuthoredAgentProfileImprovementResult {
  * Put a complete authored/imported profile through the canonical profile
  * experiment and proposal path without invoking `improve()`.
  */
-declare function proposeAuthoredAgentProfileImprovement(options: ProposeAuthoredAgentProfileImprovementOptions): Promise<ProposeAuthoredAgentProfileImprovementResult>;
-//#endregion
-//#region src/intelligence/delivery.d.ts
+export declare function proposeAuthoredAgentProfileImprovement(options: ProposeAuthoredAgentProfileImprovementOptions): Promise<ProposeAuthoredAgentProfileImprovementResult>;
 /** A promoted, certified artifact (one entry in the composed profile). */
 interface CertifiedArtifact {
   path: string | null;
@@ -463,7 +454,7 @@ interface PullCertifiedOptions {
  * caller can run on its base surface when Intelligence is unreachable. A 404 is
  * the normal "nothing promoted yet" signal, carried as `status: 404`.
  */
-declare function pullCertified(opts: PullCertifiedOptions): Promise<PullOutcome>;
+export declare function pullCertified(opts: PullCertifiedOptions): Promise<PullOutcome>;
 /**
  * Fold the certified prompt surface (and any certified prompt-folding artifacts:
  * `prompt-surface` / `skill` / `instructions`) into a base system prompt under a
@@ -473,7 +464,7 @@ declare function pullCertified(opts: PullCertifiedOptions): Promise<PullOutcome>
  * renders byte-identically each call. Returns `base` unchanged when there is no
  * usable certified content. Reads only the prompt-folding slice of a profile.
  */
-declare function composeCertifiedPrompt(base: string, certified: Pick<CertifiedProfile, 'promptSurface' | 'artifacts'> | null): string;
+export declare function composeCertifiedPrompt(base: string, certified: Pick<CertifiedProfile, 'promptSurface' | 'artifacts'> | null): string;
 /** A cached, self-refreshing source of a target's certified prompt additions —
  *  the prompt-only delivery lane for callers that assemble their OWN system
  *  prompt (product chat routes) rather than wrapping an agent fn. Same
@@ -503,9 +494,7 @@ interface CertifiedPromptSourceOptions extends PullCertifiedOptions {
  * rather than hand-rolling the same lines around `pullCertified`. The
  * `withIntelligence` hook rides this same source for its prompt delivery.
  */
-declare function createCertifiedPromptSource(opts: CertifiedPromptSourceOptions): CertifiedPromptSource;
-//#endregion
-//#region src/intelligence/capability.d.ts
+export declare function createCertifiedPromptSource(opts: CertifiedPromptSourceOptions): CertifiedPromptSource;
 /** A structural JSON Schema object describing a tool's parameters. */
 type JsonSchema = Record<string, unknown>;
 /**
@@ -694,7 +683,7 @@ interface CapabilityManifest {
 /**
  * A consumer rejected a binding that its executor does not admit.
  */
-declare class CapabilityNotAdmittedError extends Error {
+export declare class CapabilityNotAdmittedError extends Error {
   readonly kind: DeliveryBindingKind;
   readonly capabilityId: string;
   constructor(kind: DeliveryBindingKind, capabilityId: string, reason: string);
@@ -707,11 +696,9 @@ declare class CapabilityNotAdmittedError extends Error {
  * `composeCertifiedPrompt` folds it before other prompt artifacts.
  * This delivers the spine against today's wire before the plane changes.
  */
-declare function manifestFromProfile(profile: CertifiedProfile): CapabilityManifest;
-//#endregion
-//#region src/intelligence/exact-process-candidate.d.ts
+export declare function manifestFromProfile(profile: CertifiedProfile): CapabilityManifest;
 /** Candidate surfaces implemented by the neutral exact-process executor. */
-declare const exactProcessCandidateExperimentExecutionSupport: Readonly<{
+export declare const exactProcessCandidateExperimentExecutionSupport: Readonly<{
   outcomes: readonly ["output"];
   outputMediaTypes: readonly ["text/*", "application/json", "*+json"];
   code: readonly ["disabled"];
@@ -773,11 +760,9 @@ interface ProtectedExactProcessCandidateExperimentExecutor extends ExactProcessC
   readonly recoveryPorts: Pick<AgentCandidateExecutionPorts, 'models' | 'memory'>;
 }
 /** Execute one signed experiment cell through any declared exact-process provider. */
-declare function createExactProcessCandidateExperimentExecutor(options: CreateExactProcessCandidateExperimentExecutorOptions): ExactProcessCandidateExperimentExecutor;
+export declare function createExactProcessCandidateExperimentExecutor(options: CreateExactProcessCandidateExperimentExecutorOptions): ExactProcessCandidateExperimentExecutor;
 /** Compose host-owned execution ports with protected model access for one exact-process run. */
-declare function createProtectedExactProcessCandidateExperimentExecutor(options: CreateProtectedExactProcessCandidateExperimentExecutorOptions): ProtectedExactProcessCandidateExperimentExecutor;
-//#endregion
-//#region src/intelligence/optimization-receipt.d.ts
+export declare function createProtectedExactProcessCandidateExperimentExecutor(options: CreateProtectedExactProcessCandidateExperimentExecutorOptions): ProtectedExactProcessCandidateExperimentExecutor;
 type OptimizationProvenance = NonNullable<OptimizationMethodComparison['best']['provenance']>;
 interface OptimizationActivationReceipt {
   kind: 'optimization-activation-receipt';
@@ -817,11 +802,9 @@ interface OptimizationReceiptCost {
   incompleteReasons: string[];
 }
 /** Build a detached receipt only for methods backed by an identified external optimizer. */
-declare function createOptimizationActivationReceipt(improvement: ImproveMethodResult): OptimizationActivationReceipt | undefined;
+export declare function createOptimizationActivationReceipt(improvement: ImproveMethodResult): OptimizationActivationReceipt | undefined;
 /** Read and verify the optimizer evidence carried by a measured proposal. */
-declare function optimizationActivationReceiptFromMetadata(metadata: AgentImprovementMeasuredComparison['metadata']): OptimizationActivationReceipt | undefined;
-//#endregion
-//#region src/intelligence/with-intelligence.d.ts
+export declare function optimizationActivationReceiptFromMetadata(metadata: AgentImprovementMeasuredComparison['metadata']): OptimizationActivationReceipt | undefined;
 /** What the hook hands the agent each run. Additive over the prompt-only
  *  delivery: `composePrompt` folds the certified prompt surface (as before);
  *  `proposals`/`applyProfile` surface the promoted profile DIFFS — never
@@ -884,15 +867,13 @@ type IntelligenceWrapped<I, O> = ((input: I) => Promise<O>) & {
  * best-effort — an export failure never fails the agent's turn — while an error
  * thrown by the agent itself propagates unchanged.
  */
-declare function withIntelligence<I, O>(agent: IntelligenceAgent<I, O>, config: IntelligenceHookConfig): IntelligenceWrapped<I, O>;
-//#endregion
-//#region src/intelligence/index.d.ts
+export declare function withIntelligence<I, O>(agent: IntelligenceAgent<I, O>, config: IntelligenceHookConfig): IntelligenceWrapped<I, O>;
 /**
  * The per-class cost split carried by every trace and outcome. `off` ⇒
  * `intelligenceUsd: 0` by construction — there is no intelligence spawn to
  * bill. This is a classification on the trace, NOT a budget-pool split.
  */
-interface UsageSplit {
+export interface UsageSplit {
   /** Observed base-stream spend in USD; a subtotal when `inferenceUsdKnown` is false. */
   inferenceUsd: number;
   /** Intelligence-spawn spend in USD. Provably `0` at the OFF tier. */
@@ -911,7 +892,7 @@ interface UsageSplit {
  * `loopEvents`, when present, export as the nested loop→round→iteration span
  * tree under the same `traceId`.
  */
-interface RunRecord {
+export interface RunRecord {
   runId: string;
   traceId: string;
   project: string;
@@ -959,7 +940,7 @@ interface RunRecord {
  * with unknown usage, except for the OFF billing guarantee.
  * `costUsd` supplies inference spend when the split omits it.
  */
-interface RunReport {
+export interface RunReport {
   success?: boolean;
   score?: number;
   usage?: Partial<UsageSplit>;
@@ -979,7 +960,7 @@ interface RunReport {
 /** Repo coordinates a product may declare for the (later) Gated-PR mode. The
  *  Observe slice only records their PRESENCE for `doctor()`; it never touches
  *  the repo. */
-interface RepoConfig {
+export interface RepoConfig {
   owner: string;
   name: string;
   baseBranch: string;
@@ -987,7 +968,7 @@ interface RepoConfig {
 /** Client configuration. `project` + `apiKey` are the Observe minimum; the
  *  rest tune effort, endpoint, redaction, and (for `doctor()` readiness)
  *  declare the surfaces/checks/repo a later PR mode would need. */
-interface IntelligenceConfig {
+export interface IntelligenceConfig {
   /** Stable project id — the tenant dimension every trace is tagged with. */
   project: string;
   /** Bearer key for the Intelligence ingest. Reads `TANGLE_API_KEY` when omitted. */
@@ -1032,7 +1013,7 @@ interface IntelligenceConfig {
   payloadAttributes?: 'metadata' | 'full';
 }
 /** Metadata describing one traced run. `runId`/`traceId` default to fresh ids. */
-interface TraceMeta {
+export interface TraceMeta {
   /** The run's input — exported through the redactor. */
   input?: unknown;
   /** Stable run id. Defaults to a fresh id. */
@@ -1052,7 +1033,7 @@ interface TraceMeta {
  * outcome + the `{ inferenceUsd, intelligenceUsd }` split. Both are optional —
  * an un-recorded run still exports a span with whatever was set.
  */
-interface TraceHandle {
+export interface TraceHandle {
   /** Capture the run's output. Exported through the redactor. */
   recordOutput(output: unknown): void;
   /**
@@ -1068,7 +1049,7 @@ interface TraceHandle {
   }): void;
 }
 /** Metadata for {@link IntelligenceClient.recordTrace}. */
-interface RecordTraceMeta {
+export interface RecordTraceMeta {
   /** 32-hex trace id to anchor every span to. Defaults to a fresh id. */
   traceId?: string;
   /** Span id of an enclosing span the loop root should parent under (e.g. a
@@ -1076,7 +1057,7 @@ interface RecordTraceMeta {
   rootParentSpanId?: string;
 }
 /** The Observe-mode Intelligence client. */
-interface IntelligenceClient {
+export interface IntelligenceClient {
   /** The resolved project id. */
   readonly project: string;
   /** The resolved effort settings. */
@@ -1125,13 +1106,13 @@ interface IntelligenceClient {
   exportStats(): OtelExportStats | undefined;
 }
 /** One mode's readiness verdict. */
-interface ModeReadiness {
+export interface ModeReadiness {
   ready: boolean;
   /** Inputs this mode still needs, when not ready. Empty when ready. */
   missing: string[];
 }
 /** The `doctor()` readiness report — Mode-readiness without any network call. */
-interface DoctorReport {
+export interface DoctorReport {
   project: string;
   effort: EffortSettings;
   /** True when an OTLP endpoint is configured (export will actually ship). */
@@ -1148,7 +1129,6 @@ interface DoctorReport {
  * `apiKey` is present (send becomes a no-op — the ingest requires a tenant key,
  * and best-effort export must never spam an unauthenticated plane).
  */
-declare function createIntelligenceClient(config: IntelligenceConfig): IntelligenceClient;
-//#endregion
-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 };
+export declare function createIntelligenceClient(config: IntelligenceConfig): IntelligenceClient;
+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, 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, type EffortOverridesCompiled, type EffortSettings, type EffortTier, type ExactProcessCandidateExperimentExecution, type ExactProcessCandidateExperimentExecutor, type ExecuteAgentCandidateExperimentCellOptions, type ExecuteAgentImprovementActivationInput, type ExecuteAgentImprovementActivationOptions, type HostSpec, type ImproveResult, type IntelligenceAgent, type IntelligenceHookConfig, type IntelligenceWrapped, type JsonSchema, 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, type Redactor, type ReviewAgentImprovementInput, type RunAgentCandidateExperimentOptions, type RunAgentCandidateExperimentResult, type SealedCandidateActivationTransitionInput, type VerifyCandidateExecutionEvidenceOptions, agentImprovementProfileDiffs, agentImprovementProfileSurfaceDigest, agentImprovementProfileSurfaceInput, agentImprovementTargetProfileDiffs, createAgentImprovementActivation, createAgentImprovementActivationResult, createAgentImprovementProposal, defaultRedactor, executeAgentImprovementActivation, isAgentImprovementProfileSurface, isAgentProfileMeasuredSurface, parseAgentCandidateProfileActivation as parseCandidateProfileMaterialization, reviewAgentImprovementProposal, verifyAgentImprovementActivation, verifyAgentImprovementActivationResult, verifyAgentImprovementProposal, verifyAgentImprovementReview };
 //# sourceMappingURL=intelligence.d.ts.map

package/dist/intelligence.js

@@ -1,17 +1,17 @@
-import { An as toOtelAttributes, Ji as defaultRedactor, Sn as buildRuntimeEventOtelSpans, Tn as flatOtelSpan, Xi as resolveRedactor, Xt as resolveAgentEnvironmentProvider, bn as buildLoopOtelSpans, ii as authoredAgentIdentity, wn as createOtelExporter } from "./supervisor-wS9Ehz_x.js";
-import { F as canonicalCandidateDocument, N as canonicalCandidateBytes$1, P as canonicalCandidateDigest$1, R as immutableCandidateValue, V as verifyCanonicalCandidateDocument, z as omitTopLevelDigest } from "./sandbox-profile-compat-DtuJWFrM.js";
-import { a as assertProfileTrainingIsHeldOut, f as addRuntimeUsage, l as rethrowAfterCleanup, m as isUsageAmount, p as createRuntimeUsageTotals, t as improve } from "./improve-DwSahPi1.js";
-import { _ as agentImprovementTargetProfileDiffs, a as reviewAgentImprovementProposal, b as isAgentProfileMeasuredSurface, c as verifyAgentImprovementProposal, d as attachOptimizationActivationReceipt, f as createOptimizationActivationReceipt, g as agentImprovementProfileSurfaceInput, h as agentImprovementProfileSurfaceDigest, i as executeAgentImprovementActivation, l as verifyAgentImprovementReview, m as agentImprovementProfileDiffs, n as createAgentImprovementActivationResult, o as verifyAgentImprovementActivation, p as optimizationActivationReceiptFromMetadata, r as createAgentImprovementProposal, s as verifyAgentImprovementActivationResult, t as createAgentImprovementActivation, u as assertNoCallerOptimizationReceipt, v as assertProfileImprovementTargetsShareIdentity, y as isAgentImprovementProfileSurface } from "./activation-tNGW73Y9.js";
-import { _ as parseAgentCandidateProfileActivation, a as applyExactAgentProfileDiff, d as createAgentCandidateProfileActivation, g as omitUndefinedObjectFields, m as materializeAgentCandidateProfilePlan, o as assertCandidateProfileBinding, v as parseExactAgentProfile } from "./profile-JLJd2wFG.js";
-import { t as runAnalystLoop } from "./analyst-loop-DZw5QWT9.js";
-import { C as verifiedResourceTextByDigest, S as AGENT_CANDIDATE_EXECUTION_SUPPORT, n as executePreparedAgentCandidate, t as prepareAgentCandidateExecution, w as verifyAgentCandidateBundle, x as exactProcessProviderAsCandidateExecutor, y as createProtectedAgentCandidateModelPort } from "./prepare-B9wWffjO.js";
+import { An as toOtelAttributes, Qi as resolveRedactor, Sn as buildRuntimeEventOtelSpans, Tn as flatOtelSpan, Xi as defaultRedactor, Xt as resolveAgentEnvironmentProvider, ai as authoredAgentIdentity, bn as buildLoopOtelSpans, wn as createOtelExporter } from "./supervisor-C1OePYE-.js";
+import { F as canonicalCandidateDocument, N as canonicalCandidateBytes$1, P as canonicalCandidateDigest$1, R as immutableCandidateValue, V as verifyCanonicalCandidateDocument, z as omitTopLevelDigest } from "./sandbox-profile-compat-BxMQ1VXv.js";
+import { a as assertProfileTrainingIsHeldOut, f as addRuntimeUsage, l as rethrowAfterCleanup, m as isUsageAmount, p as createRuntimeUsageTotals, t as improve } from "./improve-i0HU1-aa.js";
+import { _ as agentImprovementTargetProfileDiffs, a as reviewAgentImprovementProposal, b as isAgentProfileMeasuredSurface, c as verifyAgentImprovementProposal, d as attachOptimizationActivationReceipt, f as createOptimizationActivationReceipt, g as agentImprovementProfileSurfaceInput, h as agentImprovementProfileSurfaceDigest, i as executeAgentImprovementActivation, l as verifyAgentImprovementReview, m as agentImprovementProfileDiffs, n as createAgentImprovementActivationResult, o as verifyAgentImprovementActivation, p as optimizationActivationReceiptFromMetadata, r as createAgentImprovementProposal, s as verifyAgentImprovementActivationResult, t as createAgentImprovementActivation, u as assertNoCallerOptimizationReceipt, v as assertProfileImprovementTargetsShareIdentity, y as isAgentImprovementProfileSurface } from "./activation-CfJMyzEs.js";
+import { _ as parseAgentCandidateProfileActivation, a as applyExactAgentProfileDiff, d as createAgentCandidateProfileActivation, g as omitUndefinedObjectFields, m as materializeAgentCandidateProfilePlan, o as assertCandidateProfileBinding, v as parseExactAgentProfile } from "./profile-CAhZDW2T.js";
+import { t as runAnalystLoop } from "./analyst-loop-BZvXCDKy.js";
+import { C as verifiedResourceTextByDigest, S as AGENT_CANDIDATE_EXECUTION_SUPPORT, n as executePreparedAgentCandidate, t as prepareAgentCandidateExecution, w as verifyAgentCandidateBundle, x as exactProcessProviderAsCandidateExecutor, y as createProtectedAgentCandidateModelPort } from "./prepare-DE8TQnLu.js";
 import { AGENT_IMPROVEMENT_SOURCE_METADATA_KEY, agentCandidateMaterializationReceiptSchema, agentCandidateRunReceiptSchema, agentImprovementSourceMetadata, agentImprovementSourceSchema, agentProfileImprovementArmSchema, applyAgentProfileDiff, candidateExecutionEvidenceSchema, numbersApproximatelyEqual } from "@tangle-network/agent-interface";
 import { CostLedger, contentHash } from "@tangle-network/agent-eval";
 import { ATTR, agentIdentityAttributes } from "@tangle-network/agent-trace-contract";
 import { assertProposalFindings } from "@tangle-network/agent-eval/analyst";
 import { campaignSplitDigestFromIdentities } from "@tangle-network/agent-eval/campaign";
 import { measuredComparisonFromAgentProfileImprovementExperiment, measuredComparisonFromCandidateExperiment, runAgentProfileImprovementExperiment, runCandidateExperiment, sealAgentProfileImprovementExperiment, sealAgentProfileImprovementSuite, sealAgentProfileImprovementTask, sealCandidateExperiment, verifyAgentProfileImprovementExperimentComparison, verifyCandidateExperiment, verifyCandidateExperimentComparison } from "@tangle-network/agent-eval/contract";
-//#region src/intelligence/delivery.ts
+// src/intelligence/delivery.ts
 const defaultPlaneBaseUrl = "https://intelligence.tangle.tools";
 const defaultRefreshMs = 3e5;
 const defaultPlaneRequestTimeoutMs = 1e4;
@@ -208,8 +208,7 @@ function createCertifiedPromptSource(opts) {
 		}
 	};
 }
-//#endregion
-//#region src/intelligence/effort.ts
+// src/intelligence/effort.ts
 const presets = {
 	off: {
 		analysts: false,
@@ -299,8 +298,7 @@ function compileEffort(settings) {
 		intelligenceBudgetUsd: settings.intelligenceBudgetUsd
 	};
 }
-//#endregion
-//#region src/intelligence/usage.ts
+// src/intelligence/usage.ts
 /** Numeric reports replace subtotals; explicit or malformed missingness is irreversible. */
 function mergeReportedUsage(target, report) {
 	const update = {
@@ -330,8 +328,7 @@ function normalizeReportedUsage(usage, intelligenceOff = false) {
 		...isUsageAmount(usage.estimatedInferenceUsd) ? { estimatedInferenceUsd: usage.estimatedInferenceUsd } : {}
 	};
 }
-//#endregion
-//#region src/intelligence/otel-run-export.ts
+// src/intelligence/otel-run-export.ts
 /**
 * The OTLP spans Tangle Intelligence receives for one traced run or run record.
 * Attribute keys are verbatim: the plane's session, model and cost readers
@@ -482,8 +479,7 @@ function withMissingAttributes(span, attributes) {
 		attributes: [...span.attributes ?? [], ...toOtelAttributes(missing)]
 	};
 }
-//#endregion
-//#region src/intelligence/profile-improvement-experiment.ts
+// src/intelligence/profile-improvement-experiment.ts
 function createProfileImprovementCostLedger(budgetUsd, context = "profile improvement") {
 	if (!Number.isFinite(budgetUsd) || budgetUsd < 0) throw new Error(`${context} budgetUsd must be a non-negative finite number`);
 	return new CostLedger({ costCeilingUsd: budgetUsd });
@@ -546,8 +542,7 @@ function completeImprovementSearchAccounting(analysis, improvement) {
 		searchDurationMs: analysis.durationMs + improvement.durationMs
 	};
 }
-//#endregion
-//#region src/intelligence/authored-profile-improvement.ts
+// src/intelligence/authored-profile-improvement.ts
 /**
 * Put a complete authored/imported profile through the canonical profile
 * experiment and proposal path without invoking `improve()`.
@@ -652,8 +647,7 @@ function assertDirectCandidateReleaseWorkIsFresh(benchmark, lineage, development
 	const reused = benchmark.tasks.map(profileTaskScenarioIdentity).filter((scenario) => development.has(canonicalCandidateDigest$1(scenario))).map((scenario) => scenario.id);
 	if (reused.length > 0) throw new Error(`authored profile release reuses development scenario(s): [${reused.join(", ")}]`);
 }
-//#endregion
-//#region src/intelligence/capability.ts
+// src/intelligence/capability.ts
 /**
 * A consumer rejected a binding that its executor does not admit.
 */
@@ -828,8 +822,7 @@ function isStringRecord(v) {
 function isJsonSchema(v) {
 	return typeof v === "object" && v !== null && !Array.isArray(v);
 }
-//#endregion
-//#region src/intelligence/improvement-cycle.ts
+// src/intelligence/improvement-cycle.ts
 /** A failed baseline or candidate cell with its complete Runtime failure result. */
 var AgentCandidateExperimentCellExecutionError = class extends Error {
 	finalization;
@@ -1028,7 +1021,8 @@ function assertProfileReleaseWorkIsFresh(benchmark, improvement) {
 */
 async function proposeAgentProfileImprovement(options) {
 	const source = agentImprovementSourceSchema.parse(options.source);
-	if (!isAgentProfileMeasuredSurface(options.improvement.surface ?? "prompt")) throw new Error("measured profile improvement supports profile surfaces or a complete agent profile; use the sealed-candidate path for this surface");
+	const surface = options.improvement.surface ?? "prompt";
+	if (!isAgentProfileMeasuredSurface(surface)) throw new Error("measured profile improvement supports profile surfaces or a complete agent profile; use the sealed-candidate path for this surface");
 	assertMeasuredAnalysisOptions(options.analysis);
 	const inputFindings = assertProposalFindings(options.improvement.findings ?? [], "profile improvement input findings");
 	const costLedger = createProfileImprovementCostLedger(options.budgetUsd);
@@ -1255,8 +1249,7 @@ function assertEvidenceMaterialDigest(evidence, label) {
 	const bytes = canonicalCandidateBytes$1(evidence.material);
 	if (canonicalCandidateDigest$1(evidence.material) !== evidence.digest || evidence.artifact.sha256 !== evidence.digest || evidence.artifact.byteLength !== bytes.byteLength) throw new Error(`${label} digest does not match its canonical material`);
 }
-//#endregion
-//#region src/intelligence/exact-process-candidate.ts
+// src/intelligence/exact-process-candidate.ts
 /** Candidate surfaces implemented by the neutral exact-process executor. */
 const exactProcessCandidateExperimentExecutionSupport = Object.freeze({
 	outcomes: Object.freeze(["output"]),
@@ -1277,8 +1270,9 @@ const exactProcessCandidateExperimentExecutionSupport = Object.freeze({
 });
 /** Execute one signed experiment cell through any declared exact-process provider. */
 function createExactProcessCandidateExperimentExecutor(options) {
+	const provider = resolveAgentEnvironmentProvider(options.provider, options.providerRegistry);
 	const executor = exactProcessProviderAsCandidateExecutor({
-		provider: resolveAgentEnvironmentProvider(options.provider, options.providerRegistry),
+		provider,
 		resources: options.resources,
 		...options.providerOptions ? { providerOptions: options.providerOptions } : {},
 		...options.provisionTimeoutMs === void 0 ? {} : { provisionTimeoutMs: options.provisionTimeoutMs },
@@ -1327,8 +1321,7 @@ function createProtectedExactProcessCandidateExperimentExecutor(options) {
 		})
 	});
 }
-//#endregion
-//#region src/intelligence/profile-activation.ts
+// src/intelligence/profile-activation.ts
 /**
 * Compare product-owned profiles with an exact measured transition and prepare
 * all-or-none replacements. The product owns locking, persistence, and retained
@@ -1489,8 +1482,7 @@ function assertUniqueProfileTargets(targets) {
 	const targetKeys = targets.map((target) => `${target.identity}\u0000${target.surface}`);
 	if (new Set(targetKeys).size !== targetKeys.length) throw new Error("agent profile activation repeats a target");
 }
-//#endregion
-//#region src/intelligence/with-intelligence.ts
+// src/intelligence/with-intelligence.ts
 function summarizeRuntimeEvents(events) {
 	const summary = createRuntimeUsageTotals();
 	for (const event of events) {
@@ -1667,8 +1659,7 @@ function withIntelligence(agent, config) {
 	wrapped.flush = client.flush;
 	return wrapped;
 }
-//#endregion
-//#region src/intelligence/index.ts
+// src/intelligence/index.ts
 function resolveEffortConfig(effort) {
 	if (effort === void 0) return resolveEffort(defaultEffortTier);
 	if (typeof effort === "string") return resolveEffort(effort);
@@ -1829,7 +1820,6 @@ function createIntelligenceClient(config) {
 		}
 	};
 }
-//#endregion
 export { CapabilityNotAdmittedError, 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.js.map