@tangle-network/agent-runtime 0.95.0 → 0.96.1

package/dist/conversation.js

@@ -26,7 +26,6 @@ import {
 } from "./chunk-2KGAN2HM.js";
 import "./chunk-Q2JSAVQ3.js";
 import "./chunk-YEJR7IXO.js";
-import "./chunk-DGUM43GV.js";
 export {
   CircuitBreakerState,
   CircuitOpenError,

package/dist/environment-provider.js

@@ -6,7 +6,6 @@ import {
   sandboxClientAsProvider
 } from "./chunk-M6MD6JBS.js";
 import "./chunk-3MDZX7YU.js";
-import "./chunk-DGUM43GV.js";
 export {
   createAgentEnvironmentProviderRegistry,
   providerAsExecutor,

package/dist/{agentic-generator-hCaQRAes.d.ts → improve-g75IE2Cx.d.ts}

@@ -1,7 +1,8 @@
-import { AnalystFinding, CostLedgerHandle, MaximumCharge } from '@tangle-network/agent-eval';
+import { LabeledScenarioStore, WorktreeAdapter, SurfaceProposer } from '@tangle-network/agent-eval/campaign';
+import { Scenario, SelfImproveOptions, SurfaceProposer as SurfaceProposer$1, MutableSurface, SelfImproveResult } from '@tangle-network/agent-eval/contract';
 import { AgentProfile, ReasoningEffort } from '@tangle-network/agent-interface';
 import { L as LocalHarness, C as CodexTokenUsage, a as CodexExecutionEvidence, b as LocalHarnessResult, r as runLocalHarness } from './local-harness-ZqCx51u7.js';
-import { LabeledScenarioStore, WorktreeAdapter, SurfaceProposer } from '@tangle-network/agent-eval/campaign';
+import { AnalystFinding, CostLedgerHandle, MaximumCharge } from '@tangle-network/agent-eval';
 
 /**
  *
@@ -254,4 +255,152 @@ declare function agenticGenerator(opts?: AgenticGeneratorOptions): CandidateGene
  *  silent fallback). */
 declare function commandVerifier(command: string, args?: string[], timeoutMs?: number): Verifier;
 
-export { AGENTIC_PROFILE_RESOURCE_ROOT as A, type CandidateGenerator as C, type ImprovementDriverOptions as I, type ManagedImprovementDriver as M, type Verifier as V, type AgenticGeneratorOptions as a, type AgenticGeneratorShotDisposition as b, type AgenticGeneratorShotExecution as c, type AgenticGeneratorShotReceipt as d, type VerifyResult as e, agenticGenerator as f, commandVerifier as g, improvementDriver as i };
+/**
+ *
+ * `improve` — the ONE public, surface-pluggable RSI verb.
+ *
+ * A thin facade over agent-eval's `selfImprove` (the held-out-gated closed
+ * loop). It removes the two things a caller otherwise has to know to drive the
+ * loop by hand: WHICH `MutableSurface` of the profile is being optimized, and
+ * WHICH `SurfaceProposer` mutates that surface. You name a `surface`; the
+ * facade picks the matching default proposer, extracts the baseline surface from
+ * the profile, and runs `selfImprove`. It returns a frozen candidate and never
+ * changes the input profile or caller-owned state.
+ *
+ *   - `surface: 'prompt'` → `gepaProposer` mutates `profile.prompt.systemPrompt`.
+ *   - `surface: 'skills'` → `skillOptProposer` mutates one named inline skill.
+ *   - `surface: 'memory'` → `memoryCurationProposer` curates the profile's
+ *     additional instructions as bounded durable lessons.
+ *   - `surface: 'agent-profile'` → caller-supplied proposer mutates the complete
+ *     canonical AgentProfile JSON in one candidate.
+ *   - `surface` ∈ {`tools`, `mcp`, `hooks`, `subagents`, `agent-profile`} → no zero-config default
+ *     proposer exists (a code/config proposer needs caller-supplied wiring — a
+ *     worktree repo root, a candidate generator, a serializer). The facade
+ *     requires an explicit `opts.generator` for these and throws a `ConfigError`
+ *     otherwise. This is a designed boundary, not a missing default: there is
+ *     no safe value the facade could invent for those surfaces. Code instead
+ *     requires `opts.code.repoRoot` and accepts only the runtime-owned
+ *     `opts.code.generator` path so every isolated checkout can be released.
+ *
+ * Everything else (`scenarios`, `judge`, `agent`, `budget`, `llm`) passes
+ * straight through to `selfImprove`.
+ *
+ * @experimental
+ */
+
+/** The executable agent lever `improve` optimizes. Profile fields remain
+ *  portable AgentProfile coordinates; implementation and orchestration files
+ *  use the code surface so a winner can be sealed into an exact candidate. */
+type ImproveSurface = 'prompt' | 'skills' | 'tools' | 'mcp' | 'hooks' | 'subagents' | 'agent-profile' | 'memory' | 'code';
+type ImproveOptions<TScenario extends Scenario, TArtifact> = Omit<SelfImproveOptions<TScenario, TArtifact>, 'analyzeGeneration' | 'baselineSurface' | 'findings' | 'gate' | 'proposer'> & {
+    /** Which profile lever to optimize. Default `'prompt'`. Selects the default
+     *  generator + the baseline-surface extraction shape. */
+    surface?: ImproveSurface;
+    /** The `SurfaceProposer` that mutates a profile surface. When unset, the facade
+     *  picks the default for prompt, skills, and memory; surfaces
+     *  with no default REQUIRE this (fail-loud otherwise). Forbidden for code;
+     *  use `code.generator` so the runtime owns candidate cleanup. */
+    generator?: SurfaceProposer$1;
+    /** Gate mode. `'holdout'` (default) runs the held-out promotion gate;
+     *  `'none'` is a baseline-only run (`budget.generations = 0`). */
+    gate?: 'holdout' | 'none';
+    /** Restrict the run to this subset of models. When set, the reflection model
+     *  (`llm.model`, or the default when unset) must be a member, or `improve()` throws
+     *  a `ConfigError` before the generator is built. Unset = unrestricted. */
+    allowedModels?: readonly string[];
+    /** Per-generation findings producer passthrough (see selfImprove.analyzeGeneration).
+     *  DEFAULT: the built-in failure distiller — after each generation it turns the
+     *  worst-scoring/errored cells into structured findings ({ scenario, composite,
+     *  notes, error }) for the NEXT proposal round, so the proposer reasons over what
+     *  actually failed instead of a static seed. Pass your own producer (e.g. a
+     *  trace-analyst over the runDir's traces) to replace it; pass `null` to disable
+     *  and keep the static `findings` all the way through. */
+    analyzeGeneration?: SelfImproveOptions<TScenario, TArtifact>['analyzeGeneration'] | null;
+    /** META-HARNESS mode: instead of the ~1500-char distilled findings, feed the
+     *  proposer RAW-TRACE FILESYSTEM CONTEXT — the PATHS into the prior generation's
+     *  real run traces under `runDir` (per-cell `spans.jsonl` event logs +
+     *  `cached-result.json` scores + artifacts) plus a `grep`/`cat`-to-diagnose
+     *  instruction — so the coding agent reads the actual failures itself rather than
+     *  a pre-summary. Requires a REAL `runDir` (that is where the traces live).
+     *  Ignored when `analyzeGeneration` is set explicitly (that wins) or is `null`
+     *  (disabled). Equivalent to `analyzeGeneration: rawTraceDistiller()`; this flag
+     *  is the one-line enable. Default `false` (the distiller stays the default). */
+    rawTraceContext?: boolean;
+    /** CODE-surface wiring: name `surface: 'code'`, point at a repo, and the
+     *  facade assembles the whole candidate pipeline — an isolated incumbent plus git worktrees
+     *  (`gitWorktreeAdapter`) driven by `improvementDriver` with the full agentic
+     *  generator (a real coding harness edits each candidate worktree; a `verify`
+     *  hook gates candidates before they are ever measured). Ignored when
+     *  `opts.generator` is supplied. Required for every code run because a real
+     *  repository and base ref are necessary to measure the incumbent. */
+    code?: ImproveCodeOptions;
+    /** Select the exact inline skill document to optimize. */
+    skills?: ImproveSkillsOptions;
+    /** Custom held-back-exam decision. The string `gate` above controls whether
+     *  the exam runs; this callback controls how its evidence decides promotion. */
+    promotionGate?: SelfImproveOptions<TScenario, TArtifact>['gate'];
+};
+interface ImproveSkillsOptions {
+    /** `name` of one inline entry in `profile.resources.skills`. */
+    resourceName: string;
+}
+interface ImproveCodeOptions {
+    /** Repo root candidate worktrees fork from. */
+    repoRoot: string;
+    /** Base ref candidates fork from. Default `main`. */
+    baseRef?: string;
+    /** Directory worktrees are created under. Default `<repoRoot>/.worktrees`. */
+    worktreeDir?: string;
+    /** Git-compatible adapter override, primarily for tests. Candidate advancement
+     *  still requires normal Git worktree and commit semantics. */
+    worktree?: WorktreeAdapter;
+    /** Coding harness the agentic generator runs in each worktree. Default `claude`. */
+    harness?: LocalHarness;
+    /** Verify a candidate worktree before it becomes a measurable surface; failures
+     *  feed the next shot (see `agenticGenerator.verify` / `commandVerifier`). */
+    verify?: Verifier;
+    /** Per-shot wall-clock timeout for the harness (ms). */
+    timeoutMs?: number;
+    /** Byte-producer override — the test seam and the escape hatch for custom
+     *  candidate production. When set, `harness`/`verify`/`timeoutMs` are unused. */
+    generator?: CandidateGenerator;
+}
+interface ImprovementCandidate {
+    /** Surface searched by this run. */
+    surface: ImproveSurface;
+    /** Exact winning value returned by agent-eval. */
+    value: MutableSurface;
+    /** Detached profile candidate when the surface maps directly to AgentProfile. */
+    profile?: AgentProfile;
+}
+interface ImproveResult<TScenario extends Scenario, TArtifact> {
+    /** Frozen candidate only. Live state is changed through an approved activation. */
+    candidate: ImprovementCandidate;
+    /** Held-out decision for this search result. */
+    decision: SelfImproveResult<TScenario, TArtifact>['gateDecision'];
+    /** Held-out lift (`winner − baseline` composite). */
+    lift: number;
+    /** Full `selfImprove` result for advanced inspection. For code runs,
+     *  `raw.winner.surface.worktreeRef` remains live after return whether the
+     *  candidate passed or held; call `dispose()` after consuming it. */
+    raw: SelfImproveResult<TScenario, TArtifact>;
+    /** Release resources owned by this result. Idempotent; currently disposes
+     *  the returned code worktree and is a no-op for profile-only surfaces. */
+    dispose(): Promise<void>;
+}
+/**
+ * Run the held-out-gated self-improvement loop on ONE profile surface.
+ *
+ * @example Optimize the system prompt, default holdout gate:
+ *
+ *   const out = await improve(profile, findings, {
+ *     surface: 'prompt',
+ *     scenarios,
+ *     judge,
+ *     agent: (surface, scenario, ctx) => runAgent(surface, scenario, ctx.signal),
+ *   })
+ *   if (out.decision === 'ship') console.log(out.candidate)
+ */
+declare function improve<TScenario extends Scenario, TArtifact>(profile: AgentProfile, findings: unknown[], opts: ImproveOptions<TScenario, TArtifact>): Promise<ImproveResult<TScenario, TArtifact>>;
+
+export { AGENTIC_PROFILE_RESOURCE_ROOT as A, type CandidateGenerator as C, type ImproveOptions as I, type ManagedImprovementDriver as M, type Verifier as V, type ImproveResult as a, type AgenticGeneratorOptions as b, type AgenticGeneratorShotDisposition as c, type AgenticGeneratorShotExecution as d, type AgenticGeneratorShotReceipt as e, type ImproveCodeOptions as f, type ImproveSkillsOptions as g, type ImproveSurface as h, type ImprovementCandidate as i, type ImprovementDriverOptions as j, type VerifyResult as k, agenticGenerator as l, commandVerifier as m, improve as n, improvementDriver as o };

package/dist/{improvement-adapter-BieWeK5J.d.ts → improvement-adapter-HAZz-7vK.d.ts}

@@ -1,5 +1,5 @@
 import { FindingSubject, AnalystFinding } from '@tangle-network/agent-eval';
-import { I as ImprovementAdapter } from './types-BC3bZpH0.js';
+import { I as ImprovementProposalSource } from './types-CmYCMbFT.js';
 
 /**
  * `AgentSurfaces` — declarative map of the mutable file/directory paths
@@ -116,23 +116,15 @@ declare function validateSurfaces(surfaces: AgentSurfaces, repoRoot: string): Re
 declare function renderSurfaceIssues(issues: ReadonlyArray<SurfaceValidationIssue>, repoRoot: string): string;
 
 /**
- * Substrate-default `ImprovementAdapter` — surfaces-driven, LLM-drafted
- * patches, optional auto-apply or PR-open.
+ * Surface improvement proposer — resolves analyst findings into LLM-drafted
+ * candidate patches without changing the caller's repository.
  *
- * This is the one ImprovementAdapter every vertical agent uses. The
- * substrate parses each finding's `subject` via
+ * The proposer parses each finding's `subject` via
  * `parseFindingSubject` (agent-eval), resolves it to a real file path
  * via the agent's `AgentSurfaces`, reads the current content, and asks
  * an LLM to draft a unified-diff patch given the finding + current
  * content + per-kind editing-discipline rules.
  *
- * Auto-apply gates on the source-finding's confidence and the
- * autoApply.improvement policy. Two modes:
- *   `write` — apply the patch in-place via `git apply -p0`. Operator
- *     reviews via `git diff`.
- *   `open-pr` — write to a branch, commit, push, open a PR via `gh`.
- *     Operator reviews via the PR UI.
- *
  * Fail-loud rules:
  *   - Findings whose subject doesn't parse → counted in `errors`.
  *   - Findings whose subject targets an undeclared surface → counted in
@@ -169,7 +161,7 @@ interface SurfaceImprovementEdit {
     /** Carry-forward severity for prioritization. */
     severity: AnalystFinding['severity'];
 }
-interface CreateSurfaceImprovementAdapterOpts {
+interface CreateSurfaceImprovementProposerOptions {
     surfaces: AgentSurfaces;
     repoRoot: string;
     /**
@@ -181,21 +173,6 @@ interface CreateSurfaceImprovementAdapterOpts {
      * substantive prompt rewrites, etc.) via this callback.
      */
     draftPatch: (input: DraftPatchInput) => Promise<DraftPatchOutput>;
-    /**
-     * Apply mode:
-     *   `write` — `git apply` in-place; operator reviews via `git diff`
-     *   `open-pr` — branch + commit + push + `gh pr create`
-     *   `none` — never apply; collect proposals for the report only
-     *
-     * The `apply` method honours this even when the loop calls it; the
-     * effective behaviour is also gated on the per-finding confidence
-     * threshold via `runAnalystLoop`'s `autoApply` policy.
-     */
-    mode?: 'write' | 'open-pr' | 'none';
-    /** When `mode === 'open-pr'`, the base branch new PRs target. Default: `main`. */
-    baseBranch?: string;
-    /** Required for `mode === 'open-pr'` — the GH owner/repo (`tangle-network/tax-agent`). */
-    ghRepo?: string;
     /**
      * When the resolved target doesn't exist, allow the substrate to
      * CREATE the file (for `knowledge.wiki`, `new-tool` subjects). Default
@@ -220,7 +197,7 @@ interface DraftPatchOutput {
     /** Multi-line rationale for the PR body. */
     rationale: string;
 }
-/** The substrate-default `ImprovementAdapter`: resolve each finding's subject to a real surface path, LLM-draft a unified-diff patch, then auto-apply or open a PR. */
-declare function createSurfaceImprovementAdapter(opts: CreateSurfaceImprovementAdapterOpts): ImprovementAdapter<SurfaceImprovementEdit>;
+/** Resolve each finding to a real surface and draft a detached patch candidate. */
+declare function createSurfaceImprovementProposer(opts: CreateSurfaceImprovementProposerOptions): ImprovementProposalSource<SurfaceImprovementEdit>;
 
-export { type AgentSurfaces as A, type CreateSurfaceImprovementAdapterOpts as C, type DraftPatchInput as D, type ResolvedSurface as R, type SurfaceImprovementEdit as S, type DraftPatchOutput as a, type SurfaceValidationIssue as b, createSurfaceImprovementAdapter as c, resolveSubjectPath as d, renderSurfaceIssues as r, validateSurfaces as v };
+export { type AgentSurfaces as A, type CreateSurfaceImprovementProposerOptions as C, type DraftPatchInput as D, type ResolvedSurface as R, type SurfaceImprovementEdit as S, type DraftPatchOutput as a, type SurfaceValidationIssue as b, createSurfaceImprovementProposer as c, resolveSubjectPath as d, renderSurfaceIssues as r, validateSurfaces as v };

package/dist/index.d.ts

@@ -6,18 +6,16 @@ export { AGENT_CANDIDATE_EXECUTION_SUPPORT, AgentCandidateBundleInput, AgentCand
 export { a as AgentCandidateExecutionAttemptRecord, b as AgentCandidateExecutionAttemptRef, c as AgentCandidateExecutionClaim, d as AgentCandidateExecutionClaimResult, A as AgentCandidateExecutionClaimStore, e as AgentCandidateExecutionCleanupHandles, f as AgentCandidateExecutionFailureClass, g as AgentCandidateExecutionFinishResult, h as AgentCandidateExecutionLease, i as AgentCandidateExecutionPhase, j as AgentCandidateExecutionPhaseResult, k as AgentCandidateExecutionRecoveryEvidence, l as AgentCandidateExecutionStageResult, m as AgentCandidateExecutionTerminalRecord, n as AgentCandidateExecutionTerminalResult, o as AgentCandidatePreparationEvidence, q as AgentCandidateRetryRejection, E as ExecutePreparedAgentCandidateOptions, I as InMemoryAgentCandidateExecutionClaimStore, P as PrepareAgentCandidateExecutionOptions, r as applyExactAgentProfileDiff, s as executePreparedAgentCandidate, t as parseExactAgentProfile, u as parseExactAgentProfileDiff, v as prepareAgentCandidateExecution } from './profile-DbfaMTdk.js';
 export { f as AgentCandidateArtifactPort, a as AgentCandidateBenchmarkGraderPort, g as AgentCandidateContainerPort, e as AgentCandidateExecutionPorts, h as AgentCandidateExecutorFinalCapture, i as AgentCandidateExecutorMemoryCapture, A as AgentCandidateExecutorPort, j as AgentCandidateExecutorProfileFile, k as AgentCandidateExecutorRequest, l as AgentCandidateExecutorStopRequest, m as AgentCandidateExecutorTaskOutcomeCapture, n as AgentCandidateExecutorWorkspaceFile, o as AgentCandidateExecutorWorkspaceInput, p as AgentCandidateMemoryPort, q as AgentCandidateMemoryResetResult, r as AgentCandidateModelLimits, s as AgentCandidateModelPort, b as AgentCandidateOutputArtifactPort, t as AgentCandidateOutputPurpose, u as AgentCandidateProtectedModelActivation, v as AgentCandidateProtectedModelReservation, w as AgentCandidateProtectedModelSettlement, x as AgentCandidateProtectedRunCapture, y as AgentCandidateRepositoryPort, c as AgentCandidateRunFinalization, d as AgentCandidateTaskExecution, z as AgentCandidateVerificationPorts, B as AgentCandidateWorkspacePort, C as CANDIDATE_TRACE_ENV, D as CANDIDATE_TRACE_TAGS, E as CanonicalCandidateDocument, P as PreparedAgentCandidateExecution, F as PreparedAgentCandidateInstruction, G as PreparedAgentCandidateKnowledge, H as PreparedAgentCandidateLaunch, I as PreparedAgentCandidateTrace, R as ResolvedAgentCandidateContainer, V as VerifiedAgentCandidate, J as VerifiedAgentCandidateTaskOutcome } from './types-CWqfCO8s.js';
 export { AuthSource, BackendCallPolicy, CircuitBreakerConfig, CircuitBreakerState, CircuitOpenError, Conversation, ConversationDriveState, ConversationJournal, ConversationJournalEntry, ConversationParticipant, ConversationPolicy, ConversationResult, ConversationStreamEvent, ConversationTurn, D1DatabaseLike, D1StmtLike, DEFAULT_MAX_DEPTH, DeadlineExceededError, FORWARD_HEADERS, FileConversationJournal, ForwardHeaderName, HaltContext, HaltPredicate, HaltReason, HaltSignal, InMemoryConversationJournal, PersonaConversationResult, PersonaDriver, PropagatedHeaders, RetryBackoff, RetryableErrorPredicate, RunConversationOptions, RunPersonaConfig, RunPersonaConversationOptions, SqlAdapter, SqlConversationJournal, TurnOrder, buildForwardHeaders, computeBackoff, createConversationBackend, d1ToSqlAdapter, defaultIsRetryable, defineConversation, isDepthExceeded, makePerAttemptSignal, readDepth, runConversation, runConversationStream, runPersonaConversation, runPersonaDispatch, sleep, slugifySpeaker, turnId } from './conversation.js';
-import { C as CandidateGenerator } from './agentic-generator-hCaQRAes.js';
-export { A as AGENTIC_PROFILE_RESOURCE_ROOT, a as AgenticGeneratorOptions, b as AgenticGeneratorShotDisposition, c as AgenticGeneratorShotExecution, d as AgenticGeneratorShotReceipt, I as ImprovementDriverOptions, M as ManagedImprovementDriver, V as Verifier, e as VerifyResult, f as agenticGenerator, g as commandVerifier, i as improvementDriver } from './agentic-generator-hCaQRAes.js';
-export { b as ImproveCodeOptions, c as ImproveMemoryOptions, I as ImproveOptions, a as ImproveResult, d as ImproveSkillsOptions, e as ImproveSurface, f as applyImprovementWinnerToProfile, i as improve } from './improve-B-UYaEH5.js';
-export { M as McpServeSpec, m as mcpServeVerifier } from './mcp-serve-verifier-Bs_n0xPc.js';
+import { V as Verifier, C as CandidateGenerator } from './improve-g75IE2Cx.js';
+export { A as AGENTIC_PROFILE_RESOURCE_ROOT, b as AgenticGeneratorOptions, c as AgenticGeneratorShotDisposition, d as AgenticGeneratorShotExecution, e as AgenticGeneratorShotReceipt, f as ImproveCodeOptions, I as ImproveOptions, a as ImproveResult, g as ImproveSkillsOptions, h as ImproveSurface, i as ImprovementCandidate, j as ImprovementDriverOptions, M as ManagedImprovementDriver, k as VerifyResult, l as agenticGenerator, m as commandVerifier, n as improve, o as improvementDriver } from './improve-g75IE2Cx.js';
 import { ProposeContext, SurfaceProposer } from '@tangle-network/agent-eval/campaign';
 import { AgentProfile, AgentProfileDiff } from '@tangle-network/agent-interface';
 export { AgentCandidateBenchmarkGraderIdentity } from '@tangle-network/agent-interface';
 import { Scenario, SelfImproveOptions } from '@tangle-network/agent-eval/contract';
-import { S as SurfaceImprovementEdit } from './improvement-adapter-BieWeK5J.js';
-import { I as ImprovementAdapter } from './types-BC3bZpH0.js';
-export { AgentKnowledgeReadinessCheckOptions, ApprovedKnowledgeImprovementCandidate, KnowledgeImprovementJobMeasurement, KnowledgeImprovementJobResult, KnowledgeReadinessCheck, KnowledgeReadinessCheckInput, KnowledgeReadinessCheckResult, RESEARCH_SUPERVISOR_SYSTEM_PROMPT, RunKnowledgeImprovementJobOptions, SupervisedKnowledgeUpdateInput, SupervisedKnowledgeUpdateOptions, SupervisedKnowledgeUpdateResult, SupervisedKnowledgeUpdater, createAgentKnowledgeReadinessCheck, createSupervisedKnowledgeUpdater, formatSupervisedKnowledgeTask, knowledgeReadinessDeliverable, runKnowledgeImprovementJob, runSupervisedKnowledgeUpdate } from './knowledge.js';
-export { D as DELEGATED_LOOP_MODES, a as DelegatedLoopMode, b as DelegatedLoopRegistry, c as DelegatedLoopResult, d as DelegatedLoopRunner, L as LoopRunnerCliArgs, e as LoopRunnerCliResult, R as ResearchLoopResult, f as ResearchLoopRunnerOptions, g as RunDelegatedLoopOptions, V as VetoedFact, W as WorktreeLoopRunnerOptions, h as auditLoopRunner, i as isDelegatedLoopMode, p as parseLoopRunnerArgv, r as researchLoopRunner, j as runDelegatedLoop, k as runLoopRunnerCli, s as selfImproveLoopRunner, w as worktreeLoopRunner } from './loop-runner-bin-BIQldFS8.js';
+import { S as SurfaceImprovementEdit } from './improvement-adapter-HAZz-7vK.js';
+import { I as ImprovementProposalSource } from './types-CmYCMbFT.js';
+export { AgentKnowledgeReadinessCheckOptions, CreateKnowledgeImprovementActivationExecutorOptions, KnowledgeImprovementActivationExecutor, KnowledgeImprovementCandidatePair, KnowledgeImprovementExperimentBundles, KnowledgeImprovementJobMeasurement, KnowledgeImprovementJobResult, KnowledgeReadinessCheck, KnowledgeReadinessCheckInput, KnowledgeReadinessCheckResult, RESEARCH_SUPERVISOR_SYSTEM_PROMPT, RunKnowledgeImprovementJobOptions, SupervisedKnowledgeUpdateInput, SupervisedKnowledgeUpdateOptions, SupervisedKnowledgeUpdateResult, SupervisedKnowledgeUpdater, buildKnowledgeImprovementExperimentBundles, createAgentKnowledgeReadinessCheck, createKnowledgeImprovementActivationExecutor, createSupervisedKnowledgeUpdater, formatSupervisedKnowledgeTask, knowledgeReadinessDeliverable, runKnowledgeImprovementJob, runSupervisedKnowledgeUpdate } from './knowledge.js';
+export { D as DELEGATED_LOOP_MODES, a as DelegatedLoopMode, b as DelegatedLoopRegistry, c as DelegatedLoopResult, d as DelegatedLoopRunner, L as LoopRunnerCliArgs, e as LoopRunnerCliResult, R as ResearchLoopResult, f as ResearchLoopRunnerOptions, g as RunDelegatedLoopOptions, V as VetoedFact, W as WorktreeLoopRunnerOptions, h as auditLoopRunner, i as isDelegatedLoopMode, p as parseLoopRunnerArgv, r as researchLoopRunner, j as runDelegatedLoop, k as runLoopRunnerCli, s as selfImproveLoopRunner, w as worktreeLoopRunner } from './loop-runner-bin-Cn1N2rRo.js';
 export { m as mcpToolsForRuntimeMcp, a as mcpToolsForRuntimeMcpSubset } from './openai-tools-fnj6SRVg.js';
 export { b0 as EvalRunEvent, b1 as EvalRunGeneration, b2 as EvalRunsExportConfig, b3 as EvalRunsExportResult, b4 as INTELLIGENCE_WIRE_VERSION, b5 as LoopSpanNode, b6 as OtelAttribute, b7 as OtelExportConfig, b8 as OtelExporter, b9 as OtelSpan, ba as RuntimeEventOtelOptions, bb as buildLoopOtelSpans, bc as buildLoopSpanNodes, bd as buildRuntimeEventOtelSpans, be as createOtelExporter, bf as exportEvalRuns, bg as loopEventToOtelSpan } from './coordination-BFE3Den7.js';
 import { K as KnowledgeReadinessDecision, A as AgentBackendInput, c as AgentExecutionBackend, h as RunAgentTaskOptions, i as AgentTaskRunResult, j as RunAgentTaskStreamOptions, R as RuntimeStreamEvent, k as RuntimeSessionStore, l as RuntimeSession } from './types-BwoZWq-i.js';
@@ -29,6 +27,7 @@ export { d as RuntimeEventCollector, e as RuntimeStreamEventCollector, S as Sani
 import './local-harness-ZqCx51u7.js';
 import 'node:child_process';
 import '@tangle-network/agent-knowledge';
+import './activation-B0ZD7nfX.js';
 import './supervise-BLPI50-w.js';
 import './types-CmnA2iL3.js';
 import '@tangle-network/sandbox';
@@ -265,6 +264,37 @@ declare function toolBuildPrompt(args: FindingsArg): string;
 /** Build the starting instruction for a coder agent tasked with implementing a new MCP server. */
 declare function mcpBuildPrompt(args: FindingsArg): string;
 
+/**
+ * `mcpServeVerifier` — the intrinsic verifier for a built MCP server: the
+ * boot-and-probe checker named in docs/artifact-lifecycle-frontier.md. A
+ * generated MCP server is only a candidate if it actually *serves* — so this
+ * boots it over stdio (the default local MCP transport) and runs the real
+ * handshake: `initialize` → `notifications/initialized` → `tools/list`, and
+ * asserts the server answers with at least `minTools` tools.
+ *
+ * Outcomes follow the `Verifier` contract: a server that fails to start, exits
+ * early, errors the handshake, times out, or exposes no tools is a FAILED
+ * candidate (`{ok:false}`, fed back into the next generation shot); a missing
+ * start binary or spawn fault THROWS (a setup bug, never a silent fallback).
+ *
+ * Protocol matches the runtime's own stdio MCP server (src/mcp/server.ts):
+ * newline-delimited JSON-RPC 2.0, protocol version 2024-11-05.
+ */
+
+interface McpServeSpec {
+    /** Command that starts the built MCP server in the worktree (stdio transport). */
+    command: string;
+    args?: string[];
+    /** Extra env for the server process (merged over `process.env`). */
+    env?: Record<string, string>;
+    /** Handshake timeout (ms). Default 30s. */
+    timeoutMs?: number;
+    /** Minimum tools the server must expose to pass. Default 1. */
+    minTools?: number;
+}
+/** Build a `Verifier` that boots a generated MCP server over stdio and checks it exposes tools. */
+declare function mcpServeVerifier(spec: McpServeSpec): Verifier;
+
 type ProfileDiffProposerContext<TFindings = unknown> = ProposeContext<TFindings> & {
     profile: AgentProfile;
 };
@@ -350,7 +380,7 @@ declare function rawTraceDistiller<TScenario extends Scenario = Scenario, TArtif
 /**
  *
  * `reflectiveGenerator` — the cheap, no-sandbox `CandidateGenerator`. It drafts
- * surface edits via the existing improvement adapter (`proposeFromFindings`,
+ * surface edits via the existing improvement proposer (`proposeFromFindings`,
  * one LLM patch per finding) and applies them as ONE coherent improvement into
  * the candidate worktree. `maxShots` is ignored — reflection is single-shot by
  * construction (the patches are already drafted).
@@ -363,7 +393,7 @@ declare function rawTraceDistiller<TScenario extends Scenario = Scenario, TArtif
  */
 
 interface ReflectiveGeneratorOptions {
-    improvementAdapter: ImprovementAdapter<SurfaceImprovementEdit>;
+    improvementProposalSource: ImprovementProposalSource<SurfaceImprovementEdit>;
 }
 /** Cheap no-sandbox `CandidateGenerator` (the `shots=1` setting): draft surface edits via the improvement adapter and apply them as one coherent candidate. */
 declare function reflectiveGenerator(opts: ReflectiveGeneratorOptions): CandidateGenerator;
@@ -793,4 +823,4 @@ interface StreamToolLoopOptions<Raw> {
  *  `capped` if it stops for any non-completed reason with calls still pending. */
 declare function streamToolLoop<Raw>(opts: StreamToolLoopOptions<Raw>): AsyncGenerator<StreamToolLoopYield<Raw>, void, unknown>;
 
-export { AgentBackendInput, type AgentBackendKind, AgentExecutionBackend, AgentTaskRunResult, BackendTransportError, CandidateGenerator, type ChatStreamEvent, type ChatTurnHooks, type ChatTurnIdentity, type ChatTurnProducer, type ChatTurnResult, DEFAULT_ROUTER_BASE_URL, InMemoryRuntimeSessionStore, type ModelInfo, PlannerError, type ProfileDiffProposerContext, type ProfileDiffProposerOptions, type RawTraceDistillerOptions, type ReflectiveGeneratorOptions, type ResolveAgentBackendOptions, type ResolvedChatModel, type RouterEnv, type RunChatTurnInput, type RunToolLoopOptions, RuntimeHooks, RuntimeRunStateError, RuntimeSessionStore, RuntimeStreamEvent, RuntimeTelemetryOptions, type StreamToolLoopOptions, type StreamToolLoopYield, type ToolCallOutcome, type ToolLoopAssistantToolCall, type ToolLoopCall, type ToolLoopEvent, type ToolLoopMessage, type ToolLoopResult, type ToolLoopStopReason, applyRunRecordDefaults, cleanModelId, createOpenAICompatibleBackend, decideKnowledgeReadiness, deriveExecutionId, getModels, handleChatTurn, mcpBuildPrompt, profileDiffProposer, rawTraceDistiller, readinessServerSentEvent, reflectiveGenerator, resolveAgentBackend, resolveChatModel, resolveRouterBaseUrl, runAgentTask, runAgentTaskStream, runToolLoop, runtimeStreamServerSentEvent, streamToolLoop, toolBuildPrompt, validateChatModelId };
+export { AgentBackendInput, type AgentBackendKind, AgentExecutionBackend, AgentTaskRunResult, BackendTransportError, CandidateGenerator, type ChatStreamEvent, type ChatTurnHooks, type ChatTurnIdentity, type ChatTurnProducer, type ChatTurnResult, DEFAULT_ROUTER_BASE_URL, InMemoryRuntimeSessionStore, type McpServeSpec, type ModelInfo, PlannerError, type ProfileDiffProposerContext, type ProfileDiffProposerOptions, type RawTraceDistillerOptions, type ReflectiveGeneratorOptions, type ResolveAgentBackendOptions, type ResolvedChatModel, type RouterEnv, type RunChatTurnInput, type RunToolLoopOptions, RuntimeHooks, RuntimeRunStateError, RuntimeSessionStore, RuntimeStreamEvent, RuntimeTelemetryOptions, type StreamToolLoopOptions, type StreamToolLoopYield, type ToolCallOutcome, type ToolLoopAssistantToolCall, type ToolLoopCall, type ToolLoopEvent, type ToolLoopMessage, type ToolLoopResult, type ToolLoopStopReason, Verifier, applyRunRecordDefaults, cleanModelId, createOpenAICompatibleBackend, decideKnowledgeReadiness, deriveExecutionId, getModels, handleChatTurn, mcpBuildPrompt, mcpServeVerifier, profileDiffProposer, rawTraceDistiller, readinessServerSentEvent, reflectiveGenerator, resolveAgentBackend, resolveChatModel, resolveRouterBaseUrl, runAgentTask, runAgentTaskStream, runToolLoop, runtimeStreamServerSentEvent, streamToolLoop, toolBuildPrompt, validateChatModelId };