@tangle-network/agent-runtime 0.266.0 → 0.273.3

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-import { $t as padSpanId, Aa as OpenAIChatTool, Ar as AgentEvalErrorCode, Br as RuntimeRunStateError, Bt as OtelAttribute, Ca as AgentTaskContext, Da as BackendErrorDetail, Ea as AgentTaskStatus, Fa as RuntimeSession, Fr as PlannerError, Ft as EvalRunGeneration, Gt as buildLoopOtelSpans, Ht as OtelExporter, Ia as RuntimeSessionStore, Ir as RetainedInteractiveAdmissionError, It as EvalRunsExportConfig, Jt as createOpenInferenceFileExporter, Kt as buildLoopSpanNodes, La as RuntimeStreamEvent, Lr as RetainedInteractiveBindingError, Lt as EvalRunsExportResult, Ma as RunAgentTaskOptions, Mr as ConfigError, Na as RunAgentTaskStreamOptions, Nr as JudgeError, Oa as KnowledgeReadinessDecision, Pa as RuntimeCanonicalStreamEvent, Pr as NotFoundError, Pt as EvalRunEvent, Qt as loopEventToOtelSpan, Rr as RetainedRunAdmissionError, Rt as INTELLIGENCE_WIRE_VERSION, Sa as AgentRuntimeEventSink, Ta as AgentTaskSpec, Ut as OtelSpan, Vr as ValidationError, Vt as OtelExportConfig, Wt as RuntimeEventOtelOptions, Xt as exportEvalRuns, Yt as createOtelExporter, Zt as generateSpanId, _a as AgentBackendContext, an as RuntimeStreamEventSummary, ba as AgentKnowledgeProvider, ca as RuntimeRunCompleteInput, cn as SanitizedKnowledgeRequirement, da as RuntimeRunOptions, dn as sanitizeAgentRuntimeEvent, en as padTraceId, fa as RuntimeRunPersistenceAdapter, fn as sanitizeKnowledgeReadinessReport, g as ExecutorFactory, ga as AgentAdapter, ha as startRuntimeRun, i as Budget, in as RuntimeStreamEventSink, ja as OpenAIChatToolChoice, jr as BackendTransportError, ka as OpenAIChatResponseFormat, kr as AgentEvalError, la as RuntimeRunCost, ln as createRuntimeEventCollector, lt as SupervisedResult, ma as RuntimeRunStatus, nn as RuntimeEventCollector, on as RuntimeTelemetryOptions, pa as RuntimeRunRow, pn as sanitizeRuntimeStreamEvent, qt as buildRuntimeEventOtelSpans, rn as RuntimeStreamEventCollector, sn as SanitizedKnowledgeReadinessReport, tn as toOtelAttributes, ua as RuntimeRunHandle, un as createRuntimeStreamEventCollector, va as AgentBackendInput, wa as AgentTaskRunResult, xa as AgentRuntimeEvent, ya as AgentExecutionBackend, zr as RetainedRunDispatchBindingError, zt as LoopSpanNode } from "./types-CrnwLVYQ.js";
+import { $a as RunAgentTaskOptions, $r as ConfigError, $t as loopEventToOtelSpan, Aa as RuntimeRunCost, Ba as AgentExecutionBackend, Bt as OtelAttribute, Fa as RuntimeRunStatus, Ft as EvalRunGeneration, Ga as AgentTaskRunResult, Gt as RuntimeEventOtelOptions, Ha as AgentRuntimeEvent, Ht as OtelExportStats, Ia as startRuntimeRun, It as EvalRunsExportConfig, Ja as BackendErrorDetail, Jt as buildRuntimeEventOtelSpans, Ka as AgentTaskSpec, Kt as buildLoopOtelSpans, La as AgentAdapter, Lt as EvalRunsExportResult, Ma as RuntimeRunOptions, Na as RuntimeRunPersistenceAdapter, Pa as RuntimeRunRow, Pt as EvalRunEvent, Qa as OpenAIChatToolChoice, Qr as BackendTransportError, Qt as generateSpanId, Ra as AgentBackendContext, Rt as INTELLIGENCE_WIRE_VERSION, Ua as AgentRuntimeEventSink, Ut as OtelExporter, Va as AgentKnowledgeProvider, Vt as OtelExportConfig, Wa as AgentTaskContext, Wt as OtelSpan, Xa as OpenAIChatResponseFormat, Xr as AgentEvalError, Xt as createOtelExporter, Ya as KnowledgeReadinessDecision, Yt as createOpenInferenceFileExporter, Za as OpenAIChatTool, Zr as AgentEvalErrorCode, Zt as exportEvalRuns, ai as RetainedRunAdmissionError, an as RuntimeStreamEventSink, ci as ValidationError, cn as SanitizedKnowledgeReadinessReport, dn as createRuntimeStreamEventCollector, ei as JudgeError, en as padSpanId, eo as RunAgentTaskStreamOptions, fn as sanitizeAgentRuntimeEvent, g as ExecutorFactory, i as Budget, ii as RetainedInteractiveBindingError, in as RuntimeStreamEventCollector, io as RuntimeStreamEvent, ja as RuntimeRunHandle, ka as RuntimeRunCompleteInput, ln as SanitizedKnowledgeRequirement, lt as SupervisedResult, mn as sanitizeRuntimeStreamEvent, ni as PlannerError, nn as toOtelAttributes, no as RuntimeSession, oi as RetainedRunDispatchBindingError, on as RuntimeStreamEventSummary, pn as sanitizeKnowledgeReadinessReport, qa as AgentTaskStatus, qt as buildLoopSpanNodes, ri as RetainedInteractiveAdmissionError, rn as RuntimeEventCollector, ro as RuntimeSessionStore, si as RuntimeRunStateError, sn as RuntimeTelemetryOptions, ti as NotFoundError, tn as padTraceId, to as RuntimeCanonicalStreamEvent, un as createRuntimeEventCollector, za as AgentBackendInput, zt as LoopSpanNode } from "./types-DMRc3jru.js";
 import { i as SurfaceImprovementEdit } from "./improvement-adapter-D5gwwoXQ.js";
 import { o as ImprovementProposalSource } from "./types-zWfqDjeL.js";
-import { Hp as DeliverableSpec, Xa as SuperviseOptions, nr as StructuralRolloutPolicy, wo as SupervisorProfile } from "./index-CU2mlMfc.js";
+import { Ch as BackendCallPolicy, Eh as RetryableErrorPredicate, Km as DeliverableSpec, Nc as SuperviseOptions, Sh as TurnOrder, Th as RetryBackoff, _h as HaltContext, ah as ConversationJournal, bh as HaltSignal, ch as InMemoryConversationJournal, dh as ConversationDriveState, eh as D1DatabaseLike, fh as ConversationParticipant, gh as ConversationTurn, hh as ConversationStreamEvent, ih as d1ToSqlAdapter, lh as AuthSource, mh as ConversationResult, nh as SqlAdapter, nr as StructuralRolloutPolicy, oh as ConversationJournalEntry, ph as ConversationPolicy, rh as SqlConversationJournal, sh as FileConversationJournal, th as D1StmtLike, uh as Conversation, vh as HaltPredicate, wh as CircuitBreakerConfig, xh as RunConversationOptions, yh as HaltReason, yl as SupervisorProfile } from "./index-D2ipSqkP.js";
 import { a as RuntimeHookErrorContext, c as RuntimeHookTarget, d as defineRuntimeHooks, f as notifyRuntimeDecisionPoint, i as RuntimeHookContext, l as RuntimeHooks, n as RuntimeDecisionKind, o as RuntimeHookEvent, p as notifyRuntimeHookEvent, r as RuntimeDecisionPoint, s as RuntimeHookPhase, t as RuntimeDecisionEvidenceRef, u as composeRuntimeHooks } from "./runtime-hooks-Bj6wJHlH.js";
-import { f as ExecutorConfig, hr as Redactor, mn as WorktreeCheckRunner } from "./stream-agent-turn-Gw9hLpBn.js";
+import { f as ExecutorConfig, gr as Redactor, mn as WorktreeCheckRunner } from "./stream-agent-turn-ewm3BZAp.js";
 import { y as AgentCandidateOutputArtifactPort } from "./types-CuXu5zuS.js";
-import { $ as ImprovementMaterializedProfilePopulationCandidate, A as ImproveCodeResult, B as ImproveMethodSource, C as TrainingBoundaryResult, Ct as CandidateGenerator, D as ImproveCandidateValidator, E as ImproveCandidateValidationInput, F as ImproveMethodContext, G as ImproveProfileSurface, H as ImproveOptions, I as ImproveMethodFactory, J as ImproveScenarioPartitions, K as ImproveResult, L as ImproveMethodLineage, M as ImproveCost, N as ImproveCustomCodeGeneratorOptions, O as ImproveCodeBaseOptions, P as ImproveLineage, Q as ImprovementCodeCandidate, R as ImproveMethodOptions, S as ProfileTrainerRequest, St as defaultBuildPrompt, T as createCommandProfileTrainer, U as ImproveProfileAgent, V as ImproveOptimizationRunOptions, W as ImproveProfileComponents, X as ImproveSurface, Y as ImproveSkillsOptions, Z as ImprovementCandidate, _ as CheckpointServingPort, _t as AgenticGeneratorShotReceipt, at as ImprovementProfilePopulationCandidate, b as ImproveTrainingResult, bt as agenticGenerator, ct as ImprovementProfilePopulationLineageNode, dt as DeepReadonly, et as ImprovementProfileCandidate, ft as ReadonlyAgentProfile, g as improve, gt as AgenticGeneratorShotExecution, ht as AgenticGeneratorShotDisposition, i as AgentImprovementActivationTransition, it as ImprovementProfilePopulationArtifactSource, j as ImproveCodeRunOptions, k as ImproveCodeOptions, lt as ImprovementProfilePopulationObservationSource, mt as AgenticGeneratorOptions, n as AgentImprovementActivationResultStore, nt as ImprovementProfileCandidatePopulationAvailable, ot as ImprovementProfilePopulationCandidateSource, pt as AgenticGeneratorExecutorForWorktree, q as ImproveRuntimeCodeGeneratorOptions, rt as ImprovementProfileCandidatePopulationUnavailable, st as ImprovementProfilePopulationLineage, t as AgentImprovementActivationReconciliation, tt as ImprovementProfileCandidatePopulation, ut as ImprovementRefusedProfilePopulationCandidate, v as ControlledTrainingCommand, vt as Verifier, w as TrainingDatasetDocument, x as ProfileTrainer, xt as commandVerifier, y as ImproveTrainingOptions, yt as VerifyResult, z as ImproveMethodResult } from "./activation-VpxSbDKJ.js";
-import { _ as researchLoopRunner, a as DELEGATED_LOOP_MODES, c as DelegatedLoopResult, d as ResearchLoopRunnerOptions, f as RunDelegatedLoopOptions, g as isDelegatedLoopMode, h as auditLoopRunner, i as runLoopRunnerCli, l as DelegatedLoopRunner, m as WorktreeLoopRunnerOptions, n as LoopRunnerCliResult, o as DelegatedLoopMode, p as VetoedFact, r as parseLoopRunnerArgv, s as DelegatedLoopRegistry, t as LoopRunnerCliArgs, u as ResearchLoopResult, v as runDelegatedLoop, y as worktreeLoopRunner } from "./loop-runner-bin-XKZXM08Q.js";
-import { n as mcpToolsForRuntimeMcpSubset, t as mcpToolsForRuntimeMcp } from "./openai-tools-D3ajI_D2.js";
+import { $ as ImprovementMaterializedProfilePopulationCandidate, A as ImproveCodeResult, B as ImproveMethodSource, C as TrainingBoundaryResult, Ct as CandidateGenerator, D as ImproveCandidateValidator, E as ImproveCandidateValidationInput, F as ImproveMethodContext, G as ImproveProfileSurface, H as ImproveOptions, I as ImproveMethodFactory, J as ImproveScenarioPartitions, K as ImproveResult, L as ImproveMethodLineage, M as ImproveCost, N as ImproveCustomCodeGeneratorOptions, O as ImproveCodeBaseOptions, P as ImproveLineage, Q as ImprovementCodeCandidate, R as ImproveMethodOptions, S as ProfileTrainerRequest, St as defaultBuildPrompt, T as createCommandProfileTrainer, U as ImproveProfileAgent, V as ImproveOptimizationRunOptions, W as ImproveProfileComponents, X as ImproveSurface, Y as ImproveSkillsOptions, Z as ImprovementCandidate, _ as CheckpointServingPort, _t as AgenticGeneratorShotReceipt, at as ImprovementProfilePopulationCandidate, b as ImproveTrainingResult, bt as agenticGenerator, ct as ImprovementProfilePopulationLineageNode, dt as DeepReadonly, et as ImprovementProfileCandidate, ft as ReadonlyAgentProfile, g as improve, gt as AgenticGeneratorShotExecution, ht as AgenticGeneratorShotDisposition, i as AgentImprovementActivationTransition, it as ImprovementProfilePopulationArtifactSource, j as ImproveCodeRunOptions, k as ImproveCodeOptions, lt as ImprovementProfilePopulationObservationSource, mt as AgenticGeneratorOptions, n as AgentImprovementActivationResultStore, nt as ImprovementProfileCandidatePopulationAvailable, ot as ImprovementProfilePopulationCandidateSource, pt as AgenticGeneratorExecutorForWorktree, q as ImproveRuntimeCodeGeneratorOptions, rt as ImprovementProfileCandidatePopulationUnavailable, st as ImprovementProfilePopulationLineage, t as AgentImprovementActivationReconciliation, tt as ImprovementProfileCandidatePopulation, ut as ImprovementRefusedProfilePopulationCandidate, v as ControlledTrainingCommand, vt as Verifier, w as TrainingDatasetDocument, x as ProfileTrainer, xt as commandVerifier, y as ImproveTrainingOptions, yt as VerifyResult, z as ImproveMethodResult } from "./activation-IfDlhR3J.js";
+import { _ as researchLoopRunner, a as DELEGATED_LOOP_MODES, c as DelegatedLoopResult, d as ResearchLoopRunnerOptions, f as RunDelegatedLoopOptions, g as isDelegatedLoopMode, h as auditLoopRunner, i as runLoopRunnerCli, l as DelegatedLoopRunner, m as WorktreeLoopRunnerOptions, n as LoopRunnerCliResult, o as DelegatedLoopMode, p as VetoedFact, r as parseLoopRunnerArgv, s as DelegatedLoopRegistry, t as LoopRunnerCliArgs, u as ResearchLoopResult, v as runDelegatedLoop, y as worktreeLoopRunner } from "./loop-runner-bin-ThlwVkvo.js";
+import { n as mcpToolsForRuntimeMcpSubset, t as mcpToolsForRuntimeMcp } from "./openai-tools-Bb0mAr5z.js";
 import { AgentCandidateBundle, AgentCandidateCapturedArtifact, AgentCandidateKnowledge, AgentProfile, Sha256Digest } from "@tangle-network/agent-interface";
 import { AgentProfile as AgentProfile$1, ControlBudget, ControlDecision, ControlEvalResult, ControlEvalResult as ControlEvalResult$1, ControlRunResult, ControlStep, DataAcquisitionPlan, KnowledgeReadinessReport, KnowledgeReadinessReport as KnowledgeReadinessReport$1, KnowledgeRequirement, MaximumCharge, ProposalFinding, RunRecord, RunRecord as RunRecord$1 } from "@tangle-network/agent-eval";
 import { GepaOptimizationMethodConfig, ProfileDispatchFn, Scenario, SkillOptOptimizationMethodConfig } from "@tangle-network/agent-eval/campaign";
@@ -48,386 +48,6 @@ declare function createProfileExecutionBackend(options: {
   executor: ExecutorFactory<unknown>;
 }): AgentExecutionBackend;
 //#endregion
-//#region src/conversation/call-policy.d.ts
-/**
- *
- * Per-call resilience policy for participant backends: deadline, retry with
- * backoff, and a circuit breaker. Each policy is applied *around* a single
- * turn's backend invocation, not across the whole conversation — the
- * conversation-level credit cap and `maxTurns` bound the broader run.
- *
- * Deadlines abort the underlying backend stream via `AbortSignal` linkage so
- * the OpenAI/SDK clients tear down their HTTP request cleanly instead of
- * leaking sockets. Retries replay the same logical turn (same `turnId`) so
- * any caching gateway can dedupe. Circuit breakers are *per participant*: A's
- * failures don't open B's breaker.
- *
- * @stable
- */
-/** Pure judgment of whether an error is worth retrying. Defaults: TimeoutError, AbortError, fetch-level network errors. */
-type RetryableErrorPredicate = (err: unknown) => boolean;
-/** Backoff between attempts. Constant ms, or `(attempt: 1-indexed) => ms`. */
-type RetryBackoff = number | ((attempt: number) => number);
-/** Circuit-breaker tuning. `failuresToOpen` consecutive failures opens it; closed only after `cooldownMs`. */
-interface CircuitBreakerConfig {
-  failuresToOpen: number;
-  cooldownMs: number;
-}
-interface BackendCallPolicy {
-  /** Per-attempt wall clock limit. Exceeding fires an AbortSignal and is treated as a retryable failure. */
-  perAttemptDeadlineMs?: number;
-  /** Number of retries after the first attempt; total attempts = 1 + maxRetries. Default 0. */
-  maxRetries?: number;
-  /** Backoff between attempts. Default 250ms with jitter. */
-  retryBackoffMs?: RetryBackoff;
-  /** Custom retry classifier. Defaults to retrying transport failures and retryable HTTP statuses. */
-  isRetryable?: RetryableErrorPredicate;
-  /** Circuit breaker that opens after N consecutive failures per participant. */
-  circuitBreaker?: CircuitBreakerConfig;
-}
-//#endregion
-//#region src/conversation/headers.d.ts
-/**
- * Header bag carried through `AgentBackendContext.propagatedHeaders` so
- * backends that opt in can merge them into their outbound HTTP requests.
- * Distinct from `buildForwardHeaders` so callers can attach extra
- * non-protocol headers (e.g. tracing) without colliding.
- */
-type PropagatedHeaders = Readonly<Record<string, string>>;
-//#endregion
-//#region src/conversation/journal.d.ts
-interface ConversationJournalEntry {
-  runId: string;
-  startedAt: string;
-  /** Set when the run reaches a terminal state. */
-  halted?: HaltReason;
-  endedAt?: string;
-  turns: ConversationTurn[];
-}
-interface ConversationJournal {
-  /**
-   * Load any prior state for `runId`. Returns `undefined` for a fresh run.
-   * Implementations MUST NOT mutate the returned object — the runner clones
-   * before continuing — but the runtime treats absence and emptiness
-   * identically, so a journal with zero turns is equivalent to "fresh."
-   */
-  loadRun(runId: string): Promise<ConversationJournalEntry | undefined>;
-  /**
-   * Initialise journal state for a fresh run. Called once per run, before any
-   * `appendTurn`. Idempotent: calling with an existing runId is a no-op if
-   * the entry already exists with the same `startedAt`.
-   */
-  beginRun(runId: string, startedAt: string): Promise<void>;
-  /**
-   * Append a committed turn. The runner only calls this AFTER the turn's
-   * backend stream completed and the credit total has been updated, so an
-   * appended turn is observed-committed and never speculative.
-   */
-  appendTurn(runId: string, turn: ConversationTurn): Promise<void>;
-  /**
-   * Record the run's terminal halt reason + end time. Once called, the run
-   * is observed-final; subsequent `loadRun` returns the same halt.
-   */
-  recordHalt(runId: string, halt: HaltReason, endedAt: string): Promise<void>;
-}
-/** In-memory `ConversationJournal` — suitable for testing and single-process runs. */
-declare class InMemoryConversationJournal implements ConversationJournal {
-  private readonly entries;
-  loadRun(runId: string): Promise<ConversationJournalEntry | undefined>;
-  beginRun(runId: string, startedAt: string): Promise<void>;
-  appendTurn(runId: string, turn: ConversationTurn): Promise<void>;
-  recordHalt(runId: string, halt: HaltReason, endedAt: string): Promise<void>;
-}
-/**
- * JSONL on disk. One line per record; first line is the `begin`, subsequent
- * lines are `turn` records, terminal line is `halt`. Replays the whole file
- * on `loadRun` — cheap for the conversation sizes this is designed for
- * (thousands of turns, not millions). For huge runs, plug in a real DB
- * adapter; the interface is small.
- *
- * Reads and appends over the shared append-only spine (`durable/jsonl-file`): each
- * `appendTurn` / `recordHalt` finishes a short write and calls `fsync`, so a process
- * crash between writes never loses an acknowledged turn, and a crash DURING one leaves
- * an uncommitted final line that the next read skips and the next append truncates.
- */
-declare class FileConversationJournal implements ConversationJournal {
-  private readonly path;
-  constructor(path: string);
-  loadRun(runId: string): Promise<ConversationJournalEntry | undefined>;
-  beginRun(runId: string, startedAt: string): Promise<void>;
-  appendTurn(runId: string, turn: ConversationTurn): Promise<void>;
-  recordHalt(runId: string, halt: HaltReason, endedAt: string): Promise<void>;
-  private appendRecord;
-}
-//#endregion
-//#region src/conversation/types.d.ts
-/** @stable */
-interface ConversationParticipant {
-  /**
-   * Stable name used as the speaker label in the transcript. Must be unique
-   * within a `Conversation`.
-   */
-  name: string;
-  /**
-   * Backend that runs this participant's turn. Reuses the existing
-   * `AgentExecutionBackend` contract from `runAgentTaskStream`, so an iterable,
-   * sandbox, or profile-backed Runtime executor works through the same runner.
-   */
-  backend: AgentExecutionBackend;
-  /**
-   * Optional human label for traces / dashboards. Distinct from `name`, which
-   * is the addressing key.
-   */
-  label?: string;
-  /**
-   * Optional per-participant override of the conversation's default
-   * `callPolicy`. Use to tighten the deadline or raise the retry budget for
-   * a participant known to be slow or flaky.
-   */
-  callPolicy?: BackendCallPolicy;
-  /**
-   * Who pays for THIS participant's outbound calls?
-   *
-   * - `'forward-user'` (default) — propagate the caller's
-   *   `X-Tangle-Forwarded-Authorization` so the downstream gateway bills the
-   *   original user. Right for pass-through agents that aggregate/route
-   *   without taking economic risk.
-   * - `'agent-owned'` — DO NOT forward the user's auth; the participant's
-   *   backend uses its own credentials (typically a sk-tan-AGENT or x402
-   *   wallet baked into the backend at construction). Downstream charges
-   *   land on the agent, not the user. Right for resold-bundle agents that
-   *   take margin between their inbound price and their sub-agent costs.
-   * - `(state) => AuthSource` — per-turn / per-condition decision, e.g. base
-   *   sub-services are agent-owned but premium add-ons forward the user.
-   *
-   * The agent's own credentials live on its caller-owned backend or
-   * profile-bound Runtime executor; this field is purely about *whether to
-   * also forward the user's identity downstream*.
-   */
-  authSource?: AuthSource;
-}
-/** @stable */
-type AuthSource = 'forward-user' | 'agent-owned' | ((state: ConversationDriveState) => 'forward-user' | 'agent-owned');
-/** @stable */
-type TurnOrder = 'alternate' | 'round-robin' | ((state: ConversationDriveState) => number);
-/** @stable */
-interface ConversationDriveState {
-  transcript: readonly ConversationTurn[];
-  turnIndex: number;
-  spentCreditsCents: number;
-}
-/** @stable */
-interface HaltContext extends ConversationDriveState {
-  lastTurn: ConversationTurn;
-}
-/** @stable */
-interface HaltSignal {
-  halted: true;
-  reason: string;
-}
-/** @stable */
-type HaltPredicate = (ctx: HaltContext) => boolean | HaltSignal | Promise<boolean | HaltSignal>;
-/** @stable */
-type HaltReason = {
-  kind: 'max_turns';
-  turns: number;
-} | {
-  kind: 'max_credits';
-  spentCents: number;
-  capCents: number;
-} | {
-  kind: 'predicate';
-  reason: string;
-} | {
-  kind: 'abort';
-} | {
-  kind: 'participant_error';
-  participant: string;
-  message: string;
-};
-/** @stable */
-interface ConversationPolicy {
-  /** Hard cap on speaker-turns. Each call into a participant's backend counts as 1. */
-  maxTurns: number;
-  /**
-   * Hard cap on aggregate credit spend across all participants, in cents.
-   * Computed by summing `llm_call.costUsd` from every participant's stream.
-   * Unset (`undefined`) means no credit ceiling — the run is bounded only by
-   * `maxTurns` and `haltOn`.
-   */
-  maxCreditsCents?: number;
-  /**
-   * Speaker selection. Defaults to `'alternate'` for two-participant
-   * conversations and `'round-robin'` for any other arity.
-   */
-  turnOrder?: TurnOrder;
-  /**
-   * Optional convergence / content-based halt. Called after every turn ends;
-   * returning truthy stops the loop with `{ kind: 'predicate', ... }`.
-   */
-  haltOn?: HaltPredicate;
-  /**
-   * Default per-turn resilience policy applied to every participant call
-   * (deadline, retries, circuit breaker). Individual participants may
-   * override via `ConversationParticipant.callPolicy`.
-   */
-  defaultCallPolicy?: BackendCallPolicy;
-}
-/** @stable */
-interface ConversationTurn {
-  index: number;
-  speaker: string;
-  /**
-   * Deterministic turn identifier — stable across retries of the same logical
-   * turn so caching gateways and trace backends can dedupe. Shape:
-   * `${runId}.t${index}.${speakerSlug}`.
-   */
-  turnId: string;
-  /** Backend session used for this turn. Present on turns recorded by session-aware runners. */
-  sessionId?: string;
-  text: string;
-  /**
-   * Aggregated backend usage for this turn alone. Populated from any
-   * `llm_call` stream events the backend emitted; `undefined` when the
-   * backend reports no usage.
-   */
-  usage?: {
-    tokensIn?: number;
-    tokensOut?: number;
-    costUsd?: number;
-    latencyMs?: number;
-    model?: string;
-  };
-  /**
-   * Number of attempts that ran before this turn committed. `1` is the
-   * common case; higher means the call policy retried after transient
-   * failures.
-   */
-  attempts: number;
-  startedAt: string;
-  endedAt: string;
-}
-/** @stable */
-interface Conversation {
-  participants: readonly ConversationParticipant[];
-  policy: ConversationPolicy;
-}
-/** @stable */
-interface RunConversationOptions {
-  /** First message kicking off the conversation. Routes to the first speaker. */
-  seed: string;
-  /**
-   * Optional run identifier for cross-participant trace correlation. Auto-
-   * generated when omitted. Reusing a runId against the same `journal`
-   * resumes the prior run — the runner replays the persisted transcript and
-   * continues from the first un-recorded turn.
-   */
-  runId?: string;
-  /** Cancellation signal — aborts mid-stream and halts with `{ kind: 'abort' }`. */
-  signal?: AbortSignal;
-  /**
-   * Event sink for per-turn micro-events. Distinct from the result transcript:
-   * the sink fires for every text-delta, every turn-start/end, and the
-   * conversation-start/end markers. Used to drive SSE / dashboard updates
-   * without waiting for the conversation to finish.
-   */
-  onEvent?: (event: ConversationStreamEvent) => void | Promise<void>;
-  /**
-   * Optional durable transcript. When set, the runner persists every
-   * committed turn before yielding `turn_end`. Reusing the same `runId`
-   * against the same journal resumes from the last committed turn — so a
-   * driver process crash mid-run loses zero acknowledged turns.
-   */
-  journal?: ConversationJournal;
-  /**
-   * Stores each participant's backend session. The runner keeps an in-memory
-   * store for one invocation when omitted. Reuse a durable store with the same
-   * `runId` and journal after a process restart. Backends implementing `resume`
-   * continue their provider session; other backends receive the full transcript.
-   */
-  sessionStore?: RuntimeSessionStore;
-  /**
-   * Headers to forward verbatim to every participant backend call (gateway
-   * propagation: `X-Tangle-Forwarded-Authorization`, run/turn correlation,
-   * depth counter). Backends opt in by reading `propagatedHeaders` from
-   * their `AgentBackendContext`; backends that ignore the field still work.
-   */
-  propagatedHeaders?: PropagatedHeaders;
-  /**
-   * Inbound depth at the point this driver was invoked. The runner
-   * increments it on every outbound participant call; gateways refuse at
-   * `DEFAULT_MAX_DEPTH`. Default 0 (origin caller).
-   */
-  inboundDepth?: number;
-  /**
-   * Parent turn id when this conversation is *inside* another turn (i.e. the
-   * driver is itself a participant via `createConversationBackend`). The
-   * runner stamps each outbound call with this as `X-Tangle-Parent-TurnId`
-   * so trace stitching survives nested orchestration.
-   */
-  parentTurnId?: string;
-}
-/** @stable */
-interface ConversationResult {
-  runId: string;
-  transcript: ConversationTurn[];
-  turns: number;
-  spentCreditsCents: number;
-  halted: HaltReason;
-  durationMs: number;
-  startedAt: string;
-  endedAt: string;
-}
-/** @stable */
-type ConversationStreamEvent = {
-  type: 'conversation_start';
-  runId: string;
-  participants: readonly string[];
-  seed: string;
-  timestamp: string;
-} | {
-  type: 'conversation_resumed';
-  runId: string;
-  participants: readonly string[];
-  transcript: readonly ConversationTurn[];
-  timestamp: string;
-} | {
-  type: 'turn_start';
-  runId: string;
-  index: number;
-  speaker: string;
-  turnId: string;
-  attempt: number;
-  timestamp: string;
-} | {
-  type: 'turn_text_delta';
-  runId: string;
-  index: number;
-  speaker: string;
-  turnId: string;
-  text: string;
-  timestamp?: string;
-} | {
-  type: 'turn_retry';
-  runId: string;
-  index: number;
-  speaker: string;
-  turnId: string;
-  attempt: number;
-  reason: string;
-  timestamp: string;
-} | {
-  type: 'turn_end';
-  runId: string;
-  turn: ConversationTurn;
-  timestamp: string;
-} | {
-  type: 'conversation_end';
-  runId: string;
-  result: ConversationResult;
-  timestamp: string;
-};
-//#endregion
 //#region src/conversation/conversation-backend.d.ts
 /** Adapt a multi-participant conversation into the standard execution backend contract. */
 declare function createConversationBackend(options: {
@@ -443,70 +63,6 @@ declare function defineConversation(input: {
   policy: ConversationPolicy;
 }): Conversation;
 //#endregion
-//#region src/conversation/journal-sql.d.ts
-/**
- * Minimal SQL driver shape. Implementations forward to whichever client the
- * deployment already uses; agent-runtime takes no opinion on which.
- *
- * Parameter placeholders MUST be `?` (positional). All adapters listed in the
- * file header accept this convention.
- */
-interface SqlAdapter {
-  /** Execute a write statement (INSERT/UPDATE/DELETE/DDL). */
-  exec(sql: string, params?: readonly unknown[]): Promise<{
-    rowsAffected: number;
-  }>;
-  /** Execute a read statement (SELECT). Returns rows as plain objects. */
-  query<TRow = Record<string, unknown>>(sql: string, params?: readonly unknown[]): Promise<TRow[]>;
-}
-/**
- * Adapt a Cloudflare D1 binding to the SqlAdapter shape. Lives here so D1
- * consumers don't have to write the wrapper themselves; the runtime never
- * imports `@cloudflare/workers-types` directly (peer-style typing).
- */
-declare function d1ToSqlAdapter(db: D1DatabaseLike): SqlAdapter;
-/**
- * Structural type matching the surface of `D1Database` we depend on, so the
- * SDK never imports `@cloudflare/workers-types`. Consumers pass their real
- * `D1Database` from `env.DB` and TS structural compatibility lines it up.
- */
-interface D1DatabaseLike {
-  prepare(sql: string): D1StmtLike;
-}
-interface D1StmtLike {
-  bind(...params: unknown[]): D1StmtLike;
-  run(): Promise<unknown>;
-  all<TRow = unknown>(): Promise<{
-    results?: TRow[];
-  }>;
-}
-/**
- * SQL-backed ConversationJournal. Two tables — runs (one row per runId, holds
- * start/halt timestamps + halt reason) and turns (one row per committed turn,
- * payload is the ConversationTurn JSON). Replays the turns table on
- * `loadRun` and writes append-only per `appendTurn`.
- */
-declare class SqlConversationJournal implements ConversationJournal {
-  private readonly db;
-  private readonly table;
-  /**
-   * @param db    SQL adapter (D1, postgres, sqlite, libSQL — all work)
-   * @param table Table-name prefix; the journal creates `${table}_runs` and
-   *              `${table}_turns`. Lets multiple journals share a database
-   *              without colliding (e.g. one per product surface).
-   */
-  constructor(db: SqlAdapter, table?: string);
-  /**
-   * Create the journal's tables if absent. Idempotent. Call once at deploy
-   * (or at app boot) — running on every request is harmless but adds latency.
-   */
-  migrate(): Promise<void>;
-  loadRun(runId: string): Promise<ConversationJournalEntry | undefined>;
-  beginRun(runId: string, startedAt: string): Promise<void>;
-  appendTurn(runId: string, turn: ConversationTurn): Promise<void>;
-  recordHalt(runId: string, halt: HaltReason, endedAt: string): Promise<void>;
-}
-//#endregion
 //#region src/conversation/run-conversation.d.ts
 /** Run a conversation to completion and return its terminal result. */
 declare function runConversation(conversation: Conversation, options: RunConversationOptions): Promise<ConversationResult>;
@@ -1109,5 +665,5 @@ declare function readinessServerSentEvent(report: KnowledgeReadinessReport$1, op
 /** Serialize a `RuntimeStreamEvent` as a Server-Sent Event string. @stable */
 declare function runtimeStreamServerSentEvent(event: RuntimeStreamEvent, options?: RuntimeTelemetryOptions & ServerSentEventOptions): string;
 //#endregion
-export { type AgentAdapter, type AgentBackendContext, type AgentBackendInput, AgentEvalError, type AgentEvalErrorCode, type AgentExecutionBackend, type AgentKnowledgeProvider, type AgentKnowledgeReadinessCheckOptions, type AgentRuntimeEvent, type AgentRuntimeEventSink, type AgentTaskContext, type AgentTaskRunResult, type AgentTaskSpec, type AgentTaskStatus, type AgenticGeneratorExecutorForWorktree, type AgenticGeneratorOptions, type AgenticGeneratorShotDisposition, type AgenticGeneratorShotExecution, type AgenticGeneratorShotReceipt, type AuthSource, type BackendCallPolicy, type BackendErrorDetail, BackendTransportError, type BuildPromptFindingsInput, type CandidateGenerator, type ChatModelCandidate, type ChatModelValidation, type CheckpointServingPort, type CircuitBreakerConfig, ConfigError, type ControlBudget, type ControlDecision, type ControlEvalResult, type ControlRunResult, type ControlStep, type ControlledTrainingCommand, type Conversation, type ConversationDriveState, type ConversationJournal, type ConversationJournalEntry, type ConversationParticipant, type ConversationPolicy, type ConversationResult, type ConversationStreamEvent, type ConversationTurn, type CreateKnowledgeImprovementActivationExecutorOptions, type CreateProfileImprovementHarnessOptions, type D1DatabaseLike, type D1StmtLike, DEFAULT_ROUTER_BASE_URL, DELEGATED_LOOP_MODES, type DataAcquisitionPlan, type DeepReadonly, type DelegatedLoopMode, type DelegatedLoopRegistry, type DelegatedLoopResult, type DelegatedLoopRunner, type EvalRunEvent, type EvalRunGeneration, type EvalRunsExportConfig, type EvalRunsExportResult, FileConversationJournal, type HaltContext, type HaltPredicate, type HaltReason, type HaltSignal, INTELLIGENCE_WIRE_VERSION, type ImproveCandidateValidationInput, type ImproveCandidateValidator, type ImproveCodeBaseOptions, type ImproveCodeOptions, type ImproveCodeResult, type ImproveCodeRunOptions, type ImproveCost, type ImproveCustomCodeGeneratorOptions, type ImproveLineage, type ImproveMethodContext, type ImproveMethodFactory, type ImproveMethodLineage, type ImproveMethodOptions, type ImproveMethodResult, type ImproveMethodSource, type ImproveOptimizationRunOptions, type ImproveOptions, type ImproveProfileAgent, type ImproveProfileComponents, type ImproveProfileSurface, type ImproveResult, type ImproveRuntimeCodeGeneratorOptions, type ImproveScenarioPartitions, type ImproveSkillsOptions, type ImproveSurface, type ImproveTrainingOptions, type ImproveTrainingResult, type ImprovementCandidate, type ImprovementCodeCandidate, type ImprovementMaterializedProfilePopulationCandidate, type ImprovementProfileCandidate, type ImprovementProfileCandidatePopulation, type ImprovementProfileCandidatePopulationAvailable, type ImprovementProfileCandidatePopulationUnavailable, type ImprovementProfilePopulationArtifactSource, type ImprovementProfilePopulationCandidate, type ImprovementProfilePopulationCandidateSource, type ImprovementProfilePopulationLineage, type ImprovementProfilePopulationLineageNode, type ImprovementProfilePopulationObservationSource, type ImprovementRefusedProfilePopulationCandidate, InMemoryConversationJournal, InMemoryRuntimeSessionStore, JudgeError, type KnowledgeImprovementActivationExecutor, type KnowledgeImprovementCandidatePair, type KnowledgeImprovementExperimentBundles, type KnowledgeImprovementJobMeasurement, type KnowledgeImprovementJobResult, type KnowledgeReadinessCheck, type KnowledgeReadinessCheckInput, type KnowledgeReadinessCheckResult, type KnowledgeReadinessDecision, type KnowledgeReadinessReport, type KnowledgeRequirement, type LoopRunnerCliArgs, type LoopRunnerCliResult, type LoopSpanNode, type McpServeSpec, type ModelInfo, NotFoundError, type OfficialGepaOptions, type OfficialOptimizerContextOptions, OfficialOptimizerUnavailableError, type OfficialSensitiveCandidateInput, type OfficialSkillOptOptions, type OpenAIChatResponseFormat, type OpenAIChatTool, type OpenAIChatToolChoice, type OtelAttribute, type OtelExportConfig, type OtelExporter, type OtelSpan, PROMPT_INSTRUCTION_COMPONENT_PREFIX, type PersonaConversationResult, type PersonaDriver, PlannerError, type ProfileImprovementHarness, type ProfileImprovementHarnessRunOptions, type ProfileImprovementHarnessTrainOptions, type ProfileTrainer, type ProfileTrainerRequest, RESEARCH_SUPERVISOR_SYSTEM_PROMPT, ROLLOUT_POLICY_EXTENSION, type RawTraceDistillerOptions, type ReadonlyAgentProfile, type ReflectiveGeneratorOptions, type ResearchLoopResult, type ResearchLoopRunnerOptions, type ResolvedChatModel, RetainedInteractiveAdmissionError, RetainedInteractiveBindingError, RetainedRunAdmissionError, RetainedRunDispatchBindingError, type RetryBackoff, type RetryableErrorPredicate, type RouterEnv, type RunAgentTaskOptions, type RunAgentTaskStreamOptions, type RunConversationOptions, type RunDelegatedLoopOptions, type RunKnowledgeImprovementJobOptions, type RunPersonaConfig, type RunPersonaConversationOptions, type RunRecord, type RuntimeCanonicalStreamEvent, type RuntimeDecisionEvidenceRef, type RuntimeDecisionKind, type RuntimeDecisionPoint, type RuntimeEventCollector, type RuntimeEventOtelOptions, type RuntimeHookContext, type RuntimeHookErrorContext, type RuntimeHookEvent, type RuntimeHookPhase, type RuntimeHookTarget, type RuntimeHooks, type RuntimeRunCompleteInput, type RuntimeRunCost, type RuntimeRunHandle, type RuntimeRunOptions, type RuntimeRunPersistenceAdapter, type RuntimeRunRow, RuntimeRunStateError, type RuntimeRunStatus, type RuntimeSession, type RuntimeSessionStore, type RuntimeStreamEvent, type RuntimeStreamEventCollector, type RuntimeStreamEventSink, type RuntimeStreamEventSummary, type RuntimeTelemetryOptions, type SanitizedKnowledgeReadinessReport, type SanitizedKnowledgeRequirement, type ServerSentEventOptions, type SqlAdapter, SqlConversationJournal, type SupervisedKnowledgeUpdateInput, type SupervisedKnowledgeUpdateOptions, type SupervisedKnowledgeUpdateResult, type SupervisedKnowledgeUpdater, type TrainingBoundaryResult, type TrainingDatasetDocument, type TurnOrder, ValidationError, type Verifier, type VerifyResult, type VetoedFact, type WorktreeCheckRunner, type WorktreeLoopRunnerOptions, agenticGenerator, applyRolloutPolicyToProfile, applyRunRecordDefaults, auditLoopRunner, buildKnowledgeImprovementExperimentBundles, buildLoopOtelSpans, buildLoopSpanNodes, buildRuntimeEventOtelSpans, cleanModelId, commandVerifier, composeRuntimeHooks, createAgentKnowledgeReadinessCheck, createCommandProfileTrainer, createConversationBackend, createIterableBackend, createKnowledgeImprovementActivationExecutor, createOpenInferenceFileExporter, createOtelExporter, createProfileExecutionBackend, createProfileImprovementHarness, createRuntimeEventCollector, createRuntimeStreamEventCollector, createSandboxPromptBackend, createSupervisedKnowledgeUpdater, d1ToSqlAdapter, decideKnowledgeReadiness, defaultBuildPrompt, defineConversation, defineRuntimeHooks, exportEvalRuns, findingLines, formatSupervisedKnowledgeTask, generateSpanId, getModels, improve, isDelegatedLoopMode, knowledgeReadinessDeliverable, loopEventToOtelSpan, mcpBuildPrompt, mcpServeVerifier, mcpToolsForRuntimeMcp, mcpToolsForRuntimeMcpSubset, normalizeRolloutPolicy, notifyRuntimeDecisionPoint, notifyRuntimeHookEvent, officialGepa, officialSkillOpt, optimizerMethod, padSpanId, padTraceId, parseLoopRunnerArgv, parseRolloutPolicy, promptInstructionsProfileComponents, rawTraceDistiller, readinessServerSentEvent, reflectiveGenerator, researchLoopRunner, resolveChatModel, resolveRouterBaseUrl, runAgentTask, runAgentTaskStream, runConversation, runConversationStream, runDelegatedLoop, runKnowledgeImprovementJob, runLoopRunnerCli, runPersonaConversation, runPersonaDispatch, runSupervisedKnowledgeUpdate, runtimeStreamServerSentEvent, sanitizeAgentRuntimeEvent, sanitizeKnowledgeReadinessReport, sanitizeRuntimeStreamEvent, serializeRolloutPolicy, startRuntimeRun, strategyAuthorMethod, structuralRolloutPolicyFromProfile, toOtelAttributes, toolBuildPrompt, validateChatModelId, worktreeLoopRunner };
+export { type AgentAdapter, type AgentBackendContext, type AgentBackendInput, AgentEvalError, type AgentEvalErrorCode, type AgentExecutionBackend, type AgentKnowledgeProvider, type AgentKnowledgeReadinessCheckOptions, type AgentRuntimeEvent, type AgentRuntimeEventSink, type AgentTaskContext, type AgentTaskRunResult, type AgentTaskSpec, type AgentTaskStatus, type AgenticGeneratorExecutorForWorktree, type AgenticGeneratorOptions, type AgenticGeneratorShotDisposition, type AgenticGeneratorShotExecution, type AgenticGeneratorShotReceipt, type AuthSource, type BackendCallPolicy, type BackendErrorDetail, BackendTransportError, type BuildPromptFindingsInput, type CandidateGenerator, type ChatModelCandidate, type ChatModelValidation, type CheckpointServingPort, type CircuitBreakerConfig, ConfigError, type ControlBudget, type ControlDecision, type ControlEvalResult, type ControlRunResult, type ControlStep, type ControlledTrainingCommand, type Conversation, type ConversationDriveState, type ConversationJournal, type ConversationJournalEntry, type ConversationParticipant, type ConversationPolicy, type ConversationResult, type ConversationStreamEvent, type ConversationTurn, type CreateKnowledgeImprovementActivationExecutorOptions, type CreateProfileImprovementHarnessOptions, type D1DatabaseLike, type D1StmtLike, DEFAULT_ROUTER_BASE_URL, DELEGATED_LOOP_MODES, type DataAcquisitionPlan, type DeepReadonly, type DelegatedLoopMode, type DelegatedLoopRegistry, type DelegatedLoopResult, type DelegatedLoopRunner, type EvalRunEvent, type EvalRunGeneration, type EvalRunsExportConfig, type EvalRunsExportResult, FileConversationJournal, type HaltContext, type HaltPredicate, type HaltReason, type HaltSignal, INTELLIGENCE_WIRE_VERSION, type ImproveCandidateValidationInput, type ImproveCandidateValidator, type ImproveCodeBaseOptions, type ImproveCodeOptions, type ImproveCodeResult, type ImproveCodeRunOptions, type ImproveCost, type ImproveCustomCodeGeneratorOptions, type ImproveLineage, type ImproveMethodContext, type ImproveMethodFactory, type ImproveMethodLineage, type ImproveMethodOptions, type ImproveMethodResult, type ImproveMethodSource, type ImproveOptimizationRunOptions, type ImproveOptions, type ImproveProfileAgent, type ImproveProfileComponents, type ImproveProfileSurface, type ImproveResult, type ImproveRuntimeCodeGeneratorOptions, type ImproveScenarioPartitions, type ImproveSkillsOptions, type ImproveSurface, type ImproveTrainingOptions, type ImproveTrainingResult, type ImprovementCandidate, type ImprovementCodeCandidate, type ImprovementMaterializedProfilePopulationCandidate, type ImprovementProfileCandidate, type ImprovementProfileCandidatePopulation, type ImprovementProfileCandidatePopulationAvailable, type ImprovementProfileCandidatePopulationUnavailable, type ImprovementProfilePopulationArtifactSource, type ImprovementProfilePopulationCandidate, type ImprovementProfilePopulationCandidateSource, type ImprovementProfilePopulationLineage, type ImprovementProfilePopulationLineageNode, type ImprovementProfilePopulationObservationSource, type ImprovementRefusedProfilePopulationCandidate, InMemoryConversationJournal, InMemoryRuntimeSessionStore, JudgeError, type KnowledgeImprovementActivationExecutor, type KnowledgeImprovementCandidatePair, type KnowledgeImprovementExperimentBundles, type KnowledgeImprovementJobMeasurement, type KnowledgeImprovementJobResult, type KnowledgeReadinessCheck, type KnowledgeReadinessCheckInput, type KnowledgeReadinessCheckResult, type KnowledgeReadinessDecision, type KnowledgeReadinessReport, type KnowledgeRequirement, type LoopRunnerCliArgs, type LoopRunnerCliResult, type LoopSpanNode, type McpServeSpec, type ModelInfo, NotFoundError, type OfficialGepaOptions, type OfficialOptimizerContextOptions, OfficialOptimizerUnavailableError, type OfficialSensitiveCandidateInput, type OfficialSkillOptOptions, type OpenAIChatResponseFormat, type OpenAIChatTool, type OpenAIChatToolChoice, type OtelAttribute, type OtelExportConfig, type OtelExportStats, type OtelExporter, type OtelSpan, PROMPT_INSTRUCTION_COMPONENT_PREFIX, type PersonaConversationResult, type PersonaDriver, PlannerError, type ProfileImprovementHarness, type ProfileImprovementHarnessRunOptions, type ProfileImprovementHarnessTrainOptions, type ProfileTrainer, type ProfileTrainerRequest, RESEARCH_SUPERVISOR_SYSTEM_PROMPT, ROLLOUT_POLICY_EXTENSION, type RawTraceDistillerOptions, type ReadonlyAgentProfile, type ReflectiveGeneratorOptions, type ResearchLoopResult, type ResearchLoopRunnerOptions, type ResolvedChatModel, RetainedInteractiveAdmissionError, RetainedInteractiveBindingError, RetainedRunAdmissionError, RetainedRunDispatchBindingError, type RetryBackoff, type RetryableErrorPredicate, type RouterEnv, type RunAgentTaskOptions, type RunAgentTaskStreamOptions, type RunConversationOptions, type RunDelegatedLoopOptions, type RunKnowledgeImprovementJobOptions, type RunPersonaConfig, type RunPersonaConversationOptions, type RunRecord, type RuntimeCanonicalStreamEvent, type RuntimeDecisionEvidenceRef, type RuntimeDecisionKind, type RuntimeDecisionPoint, type RuntimeEventCollector, type RuntimeEventOtelOptions, type RuntimeHookContext, type RuntimeHookErrorContext, type RuntimeHookEvent, type RuntimeHookPhase, type RuntimeHookTarget, type RuntimeHooks, type RuntimeRunCompleteInput, type RuntimeRunCost, type RuntimeRunHandle, type RuntimeRunOptions, type RuntimeRunPersistenceAdapter, type RuntimeRunRow, RuntimeRunStateError, type RuntimeRunStatus, type RuntimeSession, type RuntimeSessionStore, type RuntimeStreamEvent, type RuntimeStreamEventCollector, type RuntimeStreamEventSink, type RuntimeStreamEventSummary, type RuntimeTelemetryOptions, type SanitizedKnowledgeReadinessReport, type SanitizedKnowledgeRequirement, type ServerSentEventOptions, type SqlAdapter, SqlConversationJournal, type SupervisedKnowledgeUpdateInput, type SupervisedKnowledgeUpdateOptions, type SupervisedKnowledgeUpdateResult, type SupervisedKnowledgeUpdater, type TrainingBoundaryResult, type TrainingDatasetDocument, type TurnOrder, ValidationError, type Verifier, type VerifyResult, type VetoedFact, type WorktreeCheckRunner, type WorktreeLoopRunnerOptions, agenticGenerator, applyRolloutPolicyToProfile, applyRunRecordDefaults, auditLoopRunner, buildKnowledgeImprovementExperimentBundles, buildLoopOtelSpans, buildLoopSpanNodes, buildRuntimeEventOtelSpans, cleanModelId, commandVerifier, composeRuntimeHooks, createAgentKnowledgeReadinessCheck, createCommandProfileTrainer, createConversationBackend, createIterableBackend, createKnowledgeImprovementActivationExecutor, createOpenInferenceFileExporter, createOtelExporter, createProfileExecutionBackend, createProfileImprovementHarness, createRuntimeEventCollector, createRuntimeStreamEventCollector, createSandboxPromptBackend, createSupervisedKnowledgeUpdater, d1ToSqlAdapter, decideKnowledgeReadiness, defaultBuildPrompt, defineConversation, defineRuntimeHooks, exportEvalRuns, findingLines, formatSupervisedKnowledgeTask, generateSpanId, getModels, improve, isDelegatedLoopMode, knowledgeReadinessDeliverable, loopEventToOtelSpan, mcpBuildPrompt, mcpServeVerifier, mcpToolsForRuntimeMcp, mcpToolsForRuntimeMcpSubset, normalizeRolloutPolicy, notifyRuntimeDecisionPoint, notifyRuntimeHookEvent, officialGepa, officialSkillOpt, optimizerMethod, padSpanId, padTraceId, parseLoopRunnerArgv, parseRolloutPolicy, promptInstructionsProfileComponents, rawTraceDistiller, readinessServerSentEvent, reflectiveGenerator, researchLoopRunner, resolveChatModel, resolveRouterBaseUrl, runAgentTask, runAgentTaskStream, runConversation, runConversationStream, runDelegatedLoop, runKnowledgeImprovementJob, runLoopRunnerCli, runPersonaConversation, runPersonaDispatch, runSupervisedKnowledgeUpdate, runtimeStreamServerSentEvent, sanitizeAgentRuntimeEvent, sanitizeKnowledgeReadinessReport, sanitizeRuntimeStreamEvent, serializeRolloutPolicy, startRuntimeRun, strategyAuthorMethod, structuralRolloutPolicyFromProfile, toOtelAttributes, toolBuildPrompt, validateChatModelId, worktreeLoopRunner };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,15 +1,15 @@
-import { Ar as createRuntimeEventCollector, Cr as exportEvalRuns, Dr as padSpanId, Er as loopEventToOtelSpan, Mr as sanitizeAgentRuntimeEvent, Ni as executableAgentProfileSnapshot, Nr as sanitizeKnowledgeReadinessReport, Or as padTraceId, Pr as sanitizeRuntimeStreamEvent, Sr as createOtelExporter, Tr as generateSpanId, _r as INTELLIGENCE_WIRE_VERSION, br as buildRuntimeEventOtelSpans, cr as resolveRedactor, fi as prepareJsonlAppend, jr as createRuntimeStreamEventCollector, kr as toOtelAttributes, mi as writeAllBytes, or as defaultRedactor, pi as readCommittedJsonLines, sr as defaultRedactorIdentityMaterial, vr as buildLoopOtelSpans, wa as providerMessageText, xr as createOpenInferenceFileExporter, yr as buildLoopSpanNodes } from "./supervisor-B8UMAXya.js";
+import { Ai as readCommittedJsonLines, Br as exportEvalRuns, Cr as defaultRedactorIdentityMaterial, Fr as buildLoopOtelSpans, Gr as padTraceId, Hr as generateSpanId, Ir as buildLoopSpanNodes, Jr as createRuntimeStreamEventCollector, Kr as toOtelAttributes, Lr as buildRuntimeEventOtelSpans, Pr as INTELLIGENCE_WIRE_VERSION, Rr as createOpenInferenceFileExporter, Ur as loopEventToOtelSpan, Va as providerMessageText, Wr as padSpanId, Xi as executableAgentProfileSnapshot, Xr as sanitizeKnowledgeReadinessReport, Yr as sanitizeAgentRuntimeEvent, Zr as sanitizeRuntimeStreamEvent, ji as writeAllBytes, ki as prepareJsonlAppend, qr as createRuntimeEventCollector, wr as resolveRedactor, zr as createOtelExporter } from "./supervisor-DdKPGluv.js";
 import { a as JudgeError, c as RetainedInteractiveAdmissionError, d as RetainedRunDispatchBindingError, f as RuntimeRunStateError, i as ConfigError, l as RetainedInteractiveBindingError, m as ValidationError, o as NotFoundError, r as BackendTransportError, s as PlannerError, t as AgentEvalError, u as RetainedRunAdmissionError } from "./errors-DodWX-cb.js";
-import { F as InMemoryRuntimeSessionStore, I as newRuntimeSession, L as nowIso, M as createIterableBackend, N as createSandboxPromptBackend, O as optimizerMethod, P as normalizeBackendStreamEvent, R as startOrResumeRuntimeSession, j as streamAgentTurn, k as strategyAuthorMethod, z as touchSession } from "./structural-rollout-DV9YoQF6.js";
+import { F as InMemoryRuntimeSessionStore, I as newRuntimeSession, L as nowIso, M as createIterableBackend, N as createSandboxPromptBackend, O as optimizerMethod, P as normalizeBackendStreamEvent, R as startOrResumeRuntimeSession, j as streamAgentTurn, k as strategyAuthorMethod, z as touchSession } from "./structural-rollout-DCUprNpH.js";
 import { t as assertExecutableAgentProfile } from "./model-policy-BbSCSak0.js";
-import { a as createRuntimeUsageTotals, i as addRuntimeUsage, o as isUsageAmount, t as createAgentImprovementActivationResult } from "./activation-BERiJjx5.js";
+import { a as createRuntimeUsageTotals, i as addRuntimeUsage, o as isUsageAmount, t as createAgentImprovementActivationResult } from "./activation-Cx2dKA_l.js";
 import { C as canonicalCandidateDigest$1, D as immutableCandidateValue, E as embeddedCandidateArtifact, O as omitTopLevelDigest, S as canonicalCandidateBytes$1, a as persistCandidateOutputArtifact, t as captureAgentCandidateWorkspace } from "./workspace-archive-C9lgf77y.js";
-import { Ut as McpSpawnFault, Wt as connectStdioMcp } from "./runtime-hOLlAc1i.js";
+import { nn as connectStdioMcp, tn as McpSpawnFault } from "./runtime-CHxXrUeZ.js";
 import { i as notifyRuntimeHookEvent, n as defineRuntimeHooks, r as notifyRuntimeDecisionPoint, t as composeRuntimeHooks } from "./runtime-hooks-tXpAarhW.js";
-import { B as assertCandidateValidator, G as applyRolloutPolicyToProfile, H as parseExecutionRef, J as serializeRolloutPolicy, K as normalizeRolloutPolicy, L as improve, Q as defaultBuildPrompt, R as createCommandProfileTrainer, U as rawTraceDistiller, W as ROLLOUT_POLICY_EXTENSION, X as agenticGenerator, Y as structuralRolloutPolicyFromProfile, Z as commandVerifier, q as parseRolloutPolicy, z as withMethodRuntimeControls } from "./improvement-cycle-GRPoHLm1.js";
+import { B as assertCandidateValidator, G as applyRolloutPolicyToProfile, H as parseExecutionRef, J as serializeRolloutPolicy, K as normalizeRolloutPolicy, L as improve, Q as defaultBuildPrompt, R as createCommandProfileTrainer, U as rawTraceDistiller, W as ROLLOUT_POLICY_EXTENSION, X as agenticGenerator, Y as structuralRolloutPolicyFromProfile, Z as commandVerifier, q as parseRolloutPolicy, z as withMethodRuntimeControls } from "./improvement-cycle-CO2HRCQq.js";
 import { t as sealAgentCandidateBundle } from "./bundle-CvLGRVO-.js";
-import { r as supervise } from "./supervise--njTtSL3.js";
-import { a as isDelegatedLoopMode, c as worktreeLoopRunner, i as auditLoopRunner, n as runLoopRunnerCli, o as researchLoopRunner, r as DELEGATED_LOOP_MODES, s as runDelegatedLoop, t as parseLoopRunnerArgv } from "./loop-runner-bin-cC16EPUq.js";
+import { r as supervise } from "./supervise-Dej5aSDa.js";
+import { a as isDelegatedLoopMode, c as worktreeLoopRunner, i as auditLoopRunner, n as runLoopRunnerCli, o as researchLoopRunner, r as DELEGATED_LOOP_MODES, s as runDelegatedLoop, t as parseLoopRunnerArgv } from "./loop-runner-bin-B9MIq9O7.js";
 import { n as mcpToolsForRuntimeMcpSubset, t as mcpToolsForRuntimeMcp } from "./openai-tools-DoQ32vpe.js";
 import { agentCandidateKnowledgeSchema, agentProfileSchema, canonicalAgentProfileDigest, sha256DigestSchema } from "@tangle-network/agent-interface";
 import { FAILURE_CLASSES, acquisitionPlansForKnowledgeGaps, blockingKnowledgeEval, canonicalJson, runAgentControlLoop, scoreKnowledgeReadiness, userQuestionsForKnowledgeGaps } from "@tangle-network/agent-eval";
@@ -18,7 +18,7 @@ import { spawnSync } from "node:child_process";
 import { readFileSync, realpathSync } from "node:fs";
 import { isAbsolute, relative, resolve, sep } from "node:path";
 import { realpath } from "node:fs/promises";
-import { isDeepStrictEqual } from "node:util";
+import { redact } from "@tangle-network/agent-eval/traces";
 import { gepaOptimizationMethod, skillOptOptimizationMethod } from "@tangle-network/agent-eval/campaign";
 import { evaluateKnowledgeBaseReadiness, fromAgentCandidateKnowledgeRef, improveKnowledgeBase, knowledgeImprovementCandidateRef, loadKnowledgeImprovementActivationResult, normalizeKnowledgeStateScope, promoteKnowledgeCandidate, restoreKnowledgeCandidateBaseline, toAgentCandidateKnowledgeRef, withKnowledgeImprovementComparison } from "@tangle-network/agent-knowledge";
 //#region src/runtime/profile-execution-backend.ts
@@ -1563,9 +1563,8 @@ function methodBackground(options) {
 	return sections.join("\n\n");
 }
 function assertSafeOptimizerCandidate(label, input, authorizeSensitiveCandidate) {
-	const redactedValue = defaultRedactor(input.value);
-	const redactedSurface = defaultRedactor(input.candidateSurface);
-	if (!isDeepStrictEqual(input.value, redactedValue) || !isDeepStrictEqual(input.candidateSurface, redactedSurface)) throw new ConfigError(`${label}: the selected profile surface contains a common credential or private value. Store live credentials as provider references, or remove private data before starting an external optimizer.`);
+	const privatePaths = [...new Set([input.value, input.candidateSurface].flatMap((value) => redact(value).report.findings.map((finding) => jsonPathOf(finding.path))))];
+	if (privatePaths.length > 0) throw new ConfigError(`${label}: the selected profile surface contains a common credential or private value at ${privatePaths.slice(0, 8).join(", ")}. Store live credentials as provider references, or remove private data before starting an external optimizer.`);
 	const sensitivePaths = sensitiveProfileSurfacePaths(input);
 	if (sensitivePaths.length === 0) return;
 	let authorized = false;
@@ -1579,6 +1578,10 @@ function assertSafeOptimizerCandidate(label, input, authorizeSensitiveCandidate)
 	}
 	if (!authorized) throw new ConfigError(`${label}: the selected profile surface contains fields that may carry private values: ${sensitivePaths.slice(0, 8).join(", ")}. Remove them, replace values with safe references, or authorize the exact profile with authorizeSensitiveCandidate.`);
 }
+/** `/remote/url` or `/tools/0/env` as `$.remote.url` or `$.tools[0].env`. */
+function jsonPathOf(pointer) {
+	return pointer.split("/").slice(1).map((segment) => segment.replaceAll("~1", "/").replaceAll("~0", "~")).reduce((path, segment) => /^\d+$/.test(segment) ? `${path}[${segment}]` : `${path}.${segment}`, "$");
+}
 function sensitiveProfileSurfacePaths(input) {
 	const paths = /* @__PURE__ */ new Set();
 	if (input.surface === "tools" || input.surface === "mcp" || input.surface === "hooks" || input.surface === "subagents" || input.surface === "agent-profile") paths.add("$");