@tangle-network/agent-runtime 0.94.12 → 0.95.0

package/dist/{chunk-U33YZ7B2.js → chunk-YLUOTX6U.js}

@@ -13,16 +13,16 @@ import {
   settledToIteration,
   supervise,
   withDriverExecutor
-} from "./chunk-C3UKLQ54.js";
+} from "./chunk-IADLKE7I.js";
 import {
   newRuntimeSession,
   normalizeBackendStreamEvent,
   nowIso
-} from "./chunk-AEG3NGJ2.js";
+} from "./chunk-Q2JSAVQ3.js";
 import {
   InMemoryResultBlobStore,
   InMemorySpawnJournal
-} from "./chunk-WIPGQ4GT.js";
+} from "./chunk-IMSNJSXH.js";
 import {
   addTokenUsage,
   isAbortError,
@@ -5788,4 +5788,4 @@ export {
   computeFindingId,
   makeFinding2 as makeFinding
 };
-//# sourceMappingURL=chunk-U33YZ7B2.js.map
+//# sourceMappingURL=chunk-YLUOTX6U.js.map

package/dist/{chunk-33OG2NN3.js → chunk-Z5I642SY.js}

@@ -8,7 +8,7 @@ import {
   DELEGATION_STATUS_DESCRIPTION,
   DELEGATION_STATUS_INPUT_SCHEMA,
   DELEGATION_STATUS_TOOL_NAME
-} from "./chunk-C3UKLQ54.js";
+} from "./chunk-IADLKE7I.js";
 
 // src/mcp/openai-tools.ts
 function buildTool(name, description, parameters) {
@@ -45,4 +45,4 @@ export {
   mcpToolsForRuntimeMcp,
   mcpToolsForRuntimeMcpSubset
 };
-//# sourceMappingURL=chunk-33OG2NN3.js.map
+//# sourceMappingURL=chunk-Z5I642SY.js.map

package/dist/{completion-gate-D1gX1-hg.d.ts → completion-gate-C80jiRfN.d.ts}

@@ -1,6 +1,6 @@
 import { WorkspacePlanReceipt } from '@tangle-network/agent-profile-materialize';
 import { L as LocalHarness, C as CodexTokenUsage, c as CodexExecutionPolicy } from './local-harness-ZqCx51u7.js';
-import { c as Executor } from './types-1d5QGK3t.js';
+import { c as Executor } from './types-CmnA2iL3.js';
 
 /**
  *

package/dist/conversation.d.ts

@@ -1,4 +1,4 @@
-import { c as AgentExecutionBackend } from './types-BwoZWq-i.js';
+import { c as AgentExecutionBackend, k as RuntimeSessionStore } from './types-BwoZWq-i.js';
 import { AgentProfile, MaximumCharge } from '@tangle-network/agent-eval';
 import { Scenario, ProfileDispatchFn } from '@tangle-network/agent-eval/campaign';
 
@@ -370,6 +370,8 @@ interface ConversationTurn {
      * `${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
@@ -424,6 +426,13 @@ interface RunConversationOptions {
      * 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,
@@ -656,6 +665,8 @@ declare class SqlConversationJournal implements ConversationJournal {
  * forward events as they arrive. Both share one driving loop.
  *
  * Distributed-systems primitives layered on top of the loop:
+ *   - **Participant sessions**: one backend session per participant is resumed
+ *     between turns; stateless backends receive one reconstructed transcript.
  *   - **Idempotent turn ids** — `turnId(runId, index, speaker)` stays stable
  *     across retries so caching gateways can dedupe.
  *   - **Durable journal** — optional `ConversationJournal` persists every

package/dist/conversation.js

@@ -23,8 +23,8 @@ import {
   sleep,
   slugifySpeaker,
   turnId
-} from "./chunk-VYA2YEKA.js";
-import "./chunk-AEG3NGJ2.js";
+} from "./chunk-2KGAN2HM.js";
+import "./chunk-Q2JSAVQ3.js";
 import "./chunk-YEJR7IXO.js";
 import "./chunk-DGUM43GV.js";
 export {

package/dist/{coordination-Dr_axlAf.d.ts → coordination-BFE3Den7.d.ts}

@@ -1,12 +1,12 @@
-import { E as ExecutorFactory, e as ExecutorRegistry, i as Spend, A as Agent, S as Scope, a as ResultBlobStore, B as Budget } from './types-1d5QGK3t.js';
+import { E as ExecutorFactory, e as ExecutorRegistry, i as Spend, A as Agent, S as Scope, a as ResultBlobStore, B as Budget } from './types-CmnA2iL3.js';
 import { AgentProfile } from '@tangle-network/agent-interface';
 import { U as UiLens, a as UiFinding, C as CoderTask } from './substrate-DO2GHNg2.js';
-import { S as SandboxClient, E as ExecCtx, r as LoopTraceEmitter, a as LoopTraceEvent, A as AgentRunSpec } from './types-ByAYqlVb.js';
+import { S as SandboxClient, E as ExecCtx, r as LoopTraceEmitter, b as LoopTraceEvent, A as AgentRunSpec } from './types-B3vAW0Oq.js';
 import { BackendType, SandboxEvent, SandboxInstance } from '@tangle-network/sandbox';
 import { AgentEvalError } from '@tangle-network/agent-eval';
 import { b as ToolSpec, c as RuntimeTelemetryOptions, R as RouterConfig } from './sanitize-BTSsdBXw.js';
 import { R as RuntimeStreamEvent } from './types-BwoZWq-i.js';
-import { G as GitRunner, a as WorktreeCheckRunner, D as DeliverableSpec } from './completion-gate-D1gX1-hg.js';
+import { G as GitRunner, a as WorktreeCheckRunner, D as DeliverableSpec } from './completion-gate-C80jiRfN.js';
 import { L as LocalHarness } from './local-harness-ZqCx51u7.js';
 import { ProviderExecutorOptions, AgentEnvironmentProviderRegistry } from './environment-provider.js';
 import { AgentEnvironmentProvider } from '@tangle-network/agent-interface/environment-provider';
@@ -1012,9 +1012,9 @@ interface DelegateUiAuditResult {
     estimatedDurationMs?: number;
 }
 /**
- * Loose shape of a research output over the wire — the substrate cannot
- * import the `ResearchOutput` type from agent-knowledge without inducing
- * a dependency cycle, so the MCP layer treats it structurally.
+ * Provider-neutral research output carried over the MCP boundary. The MCP
+ * layer accepts this structural shape instead of coupling its wire contract to
+ * one research implementation.
  *
  * @experimental
  */
@@ -1908,11 +1908,10 @@ declare function settleDetachedCoderTurn(turn: DetachedTurn, options: SettleDeta
  *
  * Feedback persistence surface for the MCP layer.
  *
- * The substrate cannot import `@tangle-network/agent-knowledge` (it would
- * induce a dependency cycle), so the store is an abstract interface. The
- * default implementation is in-memory; consumers wire their own adapter
- * (a real KbStore-backed sink, an HTTP relay to gtm-agent's knowledge
- * service, etc.) via `createMcpServer({ feedbackStore })`.
+ * Feedback storage is product policy, so the MCP layer depends on this narrow
+ * interface instead of choosing a knowledge store. The default implementation
+ * is in-memory; consumers wire their own durable adapter via
+ * `createMcpServer({ feedbackStore })`.
  *
  * Feedback events are append-only: every rating is a new event with a
  * fresh id, even when the same delegation is rated multiple times. The

package/dist/environment-provider.d.ts

@@ -2,8 +2,8 @@ import { AgentProfile, AgentProfileValidationResult } from '@tangle-network/agen
 import { CreateAgentEnvironmentInput, AgentTurnInput, AgentEnvironmentProvider, AgentEnvironmentCapabilities, AgentProfileRef } from '@tangle-network/agent-interface/environment-provider';
 export { AgentEnvironment, AgentEnvironmentCapabilities, AgentEnvironmentEvent, AgentEnvironmentProvider, AgentEnvironmentQuery, AgentEnvironmentStatus, AgentEnvironmentSummary, AgentProfileRef, AgentSession, AgentSessionRef, AgentSessionStatus, AgentTurnInput, AgentTurnResult, CheckpointRef, CheckpointRequest, CreateAgentEnvironmentInput, ExecRequest, ExecResult, ForkRequest, PlacementInfo, ResourceRequest, WorkspaceRequest } from '@tangle-network/agent-interface/environment-provider';
 import { CreateSandboxOptions, BackendType } from '@tangle-network/sandbox';
-import { R as Runtime, E as ExecutorFactory } from './types-1d5QGK3t.js';
-import { S as SandboxClient } from './types-ByAYqlVb.js';
+import { R as Runtime, E as ExecutorFactory } from './types-CmnA2iL3.js';
+import { S as SandboxClient } from './types-B3vAW0Oq.js';
 import '@tangle-network/agent-eval';
 import './types-BwoZWq-i.js';
 

package/dist/environment-provider.js

@@ -4,7 +4,7 @@ import {
   providerAsSandboxClient,
   resolveAgentEnvironmentProvider,
   sandboxClientAsProvider
-} from "./chunk-VSWBYWFK.js";
+} from "./chunk-M6MD6JBS.js";
 import "./chunk-3MDZX7YU.js";
 import "./chunk-DGUM43GV.js";
 export {

package/dist/{improve-BN3HyXIO.d.ts → improve-B-UYaEH5.d.ts}

@@ -2,7 +2,7 @@ import { WorktreeAdapter } from '@tangle-network/agent-eval/campaign';
 import { Scenario, SelfImproveOptions, SurfaceProposer, SelfImproveResult, MutableSurface } from '@tangle-network/agent-eval/contract';
 import { AgentProfile } from '@tangle-network/agent-interface';
 import { L as LocalHarness } from './local-harness-ZqCx51u7.js';
-import { V as Verifier, C as CandidateGenerator } from './agentic-generator-DDMM45kZ.js';
+import { V as Verifier, C as CandidateGenerator } from './agentic-generator-hCaQRAes.js';
 
 /**
  *
@@ -65,7 +65,7 @@ type ImproveOptions<TScenario extends Scenario, TArtifact> = Omit<SelfImproveOpt
      *  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 ~400-char distilled findings, feed the
+    /** 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
@@ -169,4 +169,4 @@ declare function applyImprovementWinnerToProfile(profile: AgentProfile, surface:
  */
 declare function improve<TScenario extends Scenario, TArtifact>(profile: AgentProfile, findings: unknown[], opts: ImproveOptions<TScenario, TArtifact>): Promise<ImproveResult<TScenario, TArtifact>>;
 
-export { type ImproveSurface as I, type ImproveOptions as a, type ImproveResult as b, type ImproveCodeOptions as c, type ImproveMemoryOptions as d, type ImproveSkillsOptions as e, applyImprovementWinnerToProfile as f, improve as i };
+export { type ImproveOptions as I, type ImproveResult as a, type ImproveCodeOptions as b, type ImproveMemoryOptions as c, type ImproveSkillsOptions as d, type ImproveSurface as e, applyImprovementWinnerToProfile as f, improve as i };

package/dist/index.d.ts

@@ -2,38 +2,40 @@ import { AgentEvalError, AnalystFinding, KnowledgeReadinessReport, RunRecord, Co
 export { AgentEvalError, AgentEvalErrorCode, ConfigError, ControlBudget, ControlDecision, ControlEvalResult, ControlRunResult, ControlStep, DataAcquisitionPlan, JudgeError, KnowledgeReadinessReport, KnowledgeRequirement, NotFoundError, RunRecord, ValidationError } from '@tangle-network/agent-eval';
 import { c as createOpenAICompatibleBackend } from './backends-BO4Jqoe2.js';
 export { a as createIterableBackend, b as createSandboxPromptBackend } from './backends-BO4Jqoe2.js';
-export { AgentCandidateCodeSource, AgentCandidateCodeSurfaceSource, AgentCandidateModelGrantActivateInput, AgentCandidateModelGrantClient, AgentCandidateModelGrantReservation, AgentCandidateModelGrantReserveInput, AgentCandidateModelGrantSettleInput, AgentCandidateProfileSource, AgentCandidateWorkspaceArchiveLimits, BuildAgentCandidateBundleInput, CaptureAgentCandidateWorkspaceOptions, CapturedAgentCandidateWorkspace, CreateAgentCandidateWorkspacePortOptions, CreateProtectedAgentCandidateModelPortOptions, DisposePreparedAgentCandidateOptions, FileAgentCandidateExecutionClaimStore, FileAgentCandidateExecutionClaimStoreOptions, RecoverExpiredAgentCandidateOptions, applyExactAgentProfileDiff, buildAgentCandidateBundle, candidateExecutionClaim, captureAgentCandidateWorkspace, captureAgentCandidateWorkspaceFiles, createAgentCandidateWorkspacePort, createProtectedAgentCandidateModelPort, disposePreparedAgentCandidateExecution, parseExactAgentProfile, parseExactAgentProfileDiff, persistCandidateOutputArtifact, recoverExpiredAgentCandidateExecution, verifyAgentCandidateBundle } from './candidate-execution/index.js';
-export { d as AgentCandidateArtifactPort, e as AgentCandidateBenchmarkGraderIdentity, f as AgentCandidateBenchmarkGraderPort, A as AgentCandidateBundleInput, g as AgentCandidateContainerPort, h as AgentCandidateExecutionAttemptRecord, i as AgentCandidateExecutionAttemptRef, j as AgentCandidateExecutionClaim, k as AgentCandidateExecutionClaimResult, l as AgentCandidateExecutionClaimStore, m as AgentCandidateExecutionCleanupHandles, n as AgentCandidateExecutionFailureClass, o as AgentCandidateExecutionFinishResult, p as AgentCandidateExecutionLease, q as AgentCandidateExecutionPhase, r as AgentCandidateExecutionPhaseResult, b as AgentCandidateExecutionPorts, s as AgentCandidateExecutionRecoveryEvidence, t as AgentCandidateExecutionStageResult, u as AgentCandidateExecutionTerminalRecord, v as AgentCandidateExecutionTerminalResult, w as AgentCandidateExecutionUsage, x as AgentCandidateExecutorFinalCapture, y as AgentCandidateExecutorMemoryCapture, z as AgentCandidateExecutorPort, B as AgentCandidateExecutorProfileFile, C as AgentCandidateExecutorRequest, D as AgentCandidateExecutorStopRequest, F as AgentCandidateExecutorTaskOutcomeCapture, G as AgentCandidateExecutorWorkspaceFile, H as AgentCandidateExecutorWorkspaceInput, I as AgentCandidateMemoryPort, J as AgentCandidateMemoryResetResult, K as AgentCandidateModelLimits, L as AgentCandidateModelPort, M as AgentCandidateOutputArtifactPort, N as AgentCandidateOutputPurpose, O as AgentCandidateProtectedModelActivation, Q as AgentCandidateProtectedModelCall, R as AgentCandidateProtectedModelReservation, S as AgentCandidateProtectedModelSettlement, T as AgentCandidateProtectedRunCapture, U as AgentCandidateRepositoryPort, V as AgentCandidateRetryRejection, c as AgentCandidateRunFinalization, a as AgentCandidateTaskExecution, W as AgentCandidateVerificationPorts, X as AgentCandidateWorkspacePort, Y as CANDIDATE_TRACE_ENV, Z as CANDIDATE_TRACE_TAGS, _ as CanonicalCandidateDocument, E as ExecutePreparedAgentCandidateOptions, $ as InMemoryAgentCandidateExecutionClaimStore, P as PrepareAgentCandidateExecutionOptions, a0 as PreparedAgentCandidateExecution, a1 as PreparedAgentCandidateInstruction, a2 as PreparedAgentCandidateLaunch, a3 as PreparedAgentCandidateTrace, a4 as ResolvedAgentCandidateContainer, a5 as VerifiedAgentCandidate, a6 as VerifiedAgentCandidateTaskOutcome, a7 as executePreparedAgentCandidate, a8 as prepareAgentCandidateExecution, a9 as sealAgentCandidateBundle } from './prepare-DIeVgQG3.js';
+export { AGENT_CANDIDATE_EXECUTION_SUPPORT, AgentCandidateBundleInput, AgentCandidateCodeSource, AgentCandidateCodeSurfaceSource, AgentCandidateModelGrantActivateInput, AgentCandidateModelGrantClient, AgentCandidateModelGrantReservation, AgentCandidateModelGrantReserveInput, AgentCandidateModelGrantSettleInput, AgentCandidateProfileSource, AgentCandidateWorkspaceArchiveLimits, BuildAgentCandidateBundleInput, CANDIDATE_KNOWLEDGE_RETRIEVAL_CONFIG_ENV, CANDIDATE_KNOWLEDGE_ROOT_ENV, CaptureAgentCandidateWorkspaceOptions, CapturedAgentCandidateWorkspace, CreateAgentCandidateWorkspacePortOptions, CreateProtectedAgentCandidateModelPortOptions, DisposePreparedAgentCandidateOptions, FileAgentCandidateExecutionClaimStore, FileAgentCandidateExecutionClaimStoreOptions, RecoverExpiredAgentCandidateOptions, buildAgentCandidateBundle, candidateExecutionClaim, candidateKnowledgeExecutionPaths, captureAgentCandidateWorkspace, captureAgentCandidateWorkspaceFiles, createAgentCandidateWorkspacePort, createProtectedAgentCandidateModelPort, disposePreparedAgentCandidateExecution, persistCandidateOutputArtifact, recoverExpiredAgentCandidateExecution, sealAgentCandidateBundle, verifyAgentCandidateBundle } from './candidate-execution/index.js';
+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-DDMM45kZ.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-DDMM45kZ.js';
-export { c as ImproveCodeOptions, d as ImproveMemoryOptions, a as ImproveOptions, b as ImproveResult, e as ImproveSkillsOptions, I as ImproveSurface, f as applyImprovementWinnerToProfile, i as improve } from './improve-BN3HyXIO.js';
-export { M as McpServeSpec, m as mcpServeVerifier } from './mcp-serve-verifier-DQQDbuyz.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 { ProposeContext, SurfaceProposer } from '@tangle-network/agent-eval/campaign';
-import { AgentProfileDiff, AgentProfile } from '@tangle-network/agent-interface';
+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, 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-BRQSQdHa.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';
 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-Dr_axlAf.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';
 export { m as AgentAdapter, d as AgentBackendContext, n as AgentKnowledgeProvider, e as AgentRuntimeEvent, o as AgentRuntimeEventSink, p as AgentTaskContext, g as AgentTaskSpec, f as AgentTaskStatus, B as BackendErrorDetail, b as OpenAIChatResponseFormat, O as OpenAIChatTool, a as OpenAIChatToolChoice } from './types-BwoZWq-i.js';
-import { R as RuntimeHooks } from './types-ByAYqlVb.js';
-export { c as RuntimeDecisionEvidenceRef, d as RuntimeDecisionKind, e as RuntimeDecisionPoint, f as RuntimeHookContext, g as RuntimeHookErrorContext, h as RuntimeHookEvent, i as RuntimeHookPhase, j as RuntimeHookTarget, k as RuntimeRunHandle, l as RuntimeRunPersistenceAdapter, m as RuntimeRunRow, n as composeRuntimeHooks, o as defineRuntimeHooks, p as notifyRuntimeDecisionPoint, q as notifyRuntimeHookEvent, s as startRuntimeRun } from './types-ByAYqlVb.js';
+import { R as RuntimeHooks } from './types-B3vAW0Oq.js';
+export { c as RuntimeDecisionEvidenceRef, d as RuntimeDecisionKind, e as RuntimeDecisionPoint, f as RuntimeHookContext, g as RuntimeHookErrorContext, h as RuntimeHookEvent, i as RuntimeHookPhase, j as RuntimeHookTarget, k as RuntimeRunHandle, l as RuntimeRunPersistenceAdapter, m as RuntimeRunRow, n as composeRuntimeHooks, o as defineRuntimeHooks, p as notifyRuntimeDecisionPoint, q as notifyRuntimeHookEvent, s as startRuntimeRun } from './types-B3vAW0Oq.js';
 import { c as RuntimeTelemetryOptions } from './sanitize-BTSsdBXw.js';
 export { d as RuntimeEventCollector, e as RuntimeStreamEventCollector, S as SanitizedKnowledgeReadinessReport, f as createRuntimeEventCollector, g as createRuntimeStreamEventCollector, s as sanitizeAgentRuntimeEvent, h as sanitizeKnowledgeReadinessReport, i as sanitizeRuntimeStreamEvent } from './sanitize-BTSsdBXw.js';
 import './local-harness-ZqCx51u7.js';
 import 'node:child_process';
 import '@tangle-network/agent-knowledge';
-import './supervise-DmYOug5f.js';
-import './types-1d5QGK3t.js';
+import './supervise-BLPI50-w.js';
+import './types-CmnA2iL3.js';
 import '@tangle-network/sandbox';
-import './completion-gate-D1gX1-hg.js';
+import './completion-gate-C80jiRfN.js';
 import '@tangle-network/agent-profile-materialize';
 import './kb-gate-CwHO0vz6.js';
-import './worktree-fanout-CPprU-qI.js';
+import './worktree-fanout-DCA3G4bO.js';
 import './substrate-DO2GHNg2.js';
 import './environment-provider.js';
 import '@tangle-network/agent-interface/environment-provider';
@@ -263,16 +265,11 @@ 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;
 
-interface AgentProfileDiffProposal {
-    diff: AgentProfileDiff;
-    label?: string;
-    rationale?: string;
-}
 type ProfileDiffProposerContext<TFindings = unknown> = ProposeContext<TFindings> & {
     profile: AgentProfile;
 };
 interface ProfileDiffProposerOptions<TFindings = unknown> {
-    proposeDiffs(context: ProfileDiffProposerContext<TFindings>): Promise<readonly AgentProfileDiffProposal[]> | readonly AgentProfileDiffProposal[];
+    proposeDiffs(context: ProfileDiffProposerContext<TFindings>): Promise<readonly AgentProfileDiff[]> | readonly AgentProfileDiff[];
 }
 /**
  * Turn exact AgentProfileDiffs from any source into full profile candidates for
@@ -286,7 +283,7 @@ declare function profileDiffProposer<TFindings = unknown>(options: ProfileDiffPr
  * `rawTraceDistiller` — the meta-harness `analyzeGeneration` producer.
  *
  * The default `generationFailureDistiller` (in `improve.ts`) COMPRESSES each
- * generation's failing cells into ~400-char structured findings before the next
+ * generation's failing cells into ~1500-char structured findings before the next
  * proposal round. That is the ACE-style recipe: a small summary is the proposer's
  * whole view of what went wrong. This producer does the opposite — the
  * meta-harness recipe (yoonholee.com/meta-harness): it does NOT summarize. It
@@ -294,7 +291,7 @@ declare function profileDiffProposer<TFindings = unknown>(options: ProfileDiffPr
  * disk under `runDir` — the durable per-cell `spans.jsonl` event logs,
  * `cached-result.json` scores, and any artifacts the substrate persisted — and
  * instructs the agent to `grep`/`cat`/`ls` them to diagnose the failures itself
- * (up to the harness's full context, ~millions of tokens, vs a ~400-char digest).
+ * (up to the harness's full context, ~millions of tokens, vs a ~1500-char digest).
  *
  * It emits `AnalystFinding[]` so it drops into the SAME `opts.analyzeGeneration`
  * slot the default distiller uses, and renders through the same
@@ -796,4 +793,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, type AgentProfileDiffProposal, 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 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 };

package/dist/index.js

@@ -6,22 +6,25 @@ import {
   knowledgeReadinessDeliverable,
   runKnowledgeImprovementJob,
   runSupervisedKnowledgeUpdate
-} from "./chunk-HGRW27YY.js";
+} from "./chunk-AP7CPGMZ.js";
 import "./chunk-5QOB7H74.js";
 import {
   FileAgentCandidateExecutionClaimStore,
   buildAgentCandidateBundle,
-  captureAgentCandidateWorkspace,
-  captureAgentCandidateWorkspaceFiles,
-  createAgentCandidateWorkspacePort,
   createProtectedAgentCandidateModelPort,
   disposePreparedAgentCandidateExecution,
-  recoverExpiredAgentCandidateExecution
-} from "./chunk-FTXM7Q7P.js";
+  recoverExpiredAgentCandidateExecution,
+  sealAgentCandidateBundle
+} from "./chunk-6YBA64Z2.js";
+import {
+  captureAgentCandidateWorkspace,
+  captureAgentCandidateWorkspaceFiles,
+  createAgentCandidateWorkspacePort
+} from "./chunk-MKGRLDWB.js";
 import {
   mcpToolsForRuntimeMcp,
   mcpToolsForRuntimeMcpSubset
-} from "./chunk-33OG2NN3.js";
+} from "./chunk-Z5I642SY.js";
 import {
   DEFAULT_ROUTER_BASE_URL,
   cleanModelId,
@@ -40,7 +43,7 @@ import {
   runLoopRunnerCli,
   selfImproveLoopRunner,
   worktreeLoopRunner
-} from "./chunk-XP5KDM3R.js";
+} from "./chunk-BPGXIKK7.js";
 import "./chunk-SGKPNBXE.js";
 import {
   CircuitBreakerState,
@@ -67,46 +70,49 @@ import {
   sleep,
   slugifySpeaker,
   turnId
-} from "./chunk-VYA2YEKA.js";
+} from "./chunk-2KGAN2HM.js";
 import {
   applyImprovementWinnerToProfile,
   improve,
   improvementDriver,
   rawTraceDistiller
-} from "./chunk-PCURO3DL.js";
+} from "./chunk-G55QE4IQ.js";
 import {
+  AGENT_CANDIDATE_EXECUTION_SUPPORT,
+  CANDIDATE_KNOWLEDGE_RETRIEVAL_CONFIG_ENV,
+  CANDIDATE_KNOWLEDGE_ROOT_ENV,
   CANDIDATE_TRACE_ENV,
   CANDIDATE_TRACE_TAGS,
   InMemoryAgentCandidateExecutionClaimStore,
   applyExactAgentProfileDiff,
   candidateExecutionClaim,
+  candidateKnowledgeExecutionPaths,
   canonicalCandidateDigest,
   executePreparedAgentCandidate,
   parseExactAgentProfile,
   parseExactAgentProfileDiff,
   persistCandidateOutputArtifact,
   prepareAgentCandidateExecution,
-  sealAgentCandidateBundle,
   verifyAgentCandidateBundle
-} from "./chunk-37V4KQDC.js";
-import "./chunk-U33YZ7B2.js";
+} from "./chunk-WTZ37EQY.js";
+import "./chunk-YLUOTX6U.js";
 import {
   composeRuntimeHooks,
   defineRuntimeHooks,
   notifyRuntimeDecisionPoint,
   notifyRuntimeHookEvent
-} from "./chunk-C3UKLQ54.js";
+} from "./chunk-IADLKE7I.js";
 import "./chunk-DPEUKJRO.js";
 import {
   InMemoryRuntimeSessionStore,
   createIterableBackend,
   createOpenAICompatibleBackend,
   createSandboxPromptBackend,
-  newRuntimeSession,
   normalizeBackendStreamEvent,
   nowIso,
+  startOrResumeRuntimeSession,
   touchSession
-} from "./chunk-AEG3NGJ2.js";
+} from "./chunk-Q2JSAVQ3.js";
 import {
   INTELLIGENCE_WIRE_VERSION,
   buildLoopOtelSpans,
@@ -121,8 +127,8 @@ import {
   sanitizeKnowledgeReadinessReport,
   sanitizeRuntimeStreamEvent
 } from "./chunk-ISTDY47H.js";
-import "./chunk-WIPGQ4GT.js";
-import "./chunk-VSWBYWFK.js";
+import "./chunk-IMSNJSXH.js";
+import "./chunk-M6MD6JBS.js";
 import "./chunk-3MDZX7YU.js";
 import "./chunk-QDSOD7RC.js";
 import "./chunk-M22PL4GH.js";
@@ -135,7 +141,7 @@ import {
   AGENTIC_PROFILE_RESOURCE_ROOT,
   agenticGenerator,
   commandVerifier
-} from "./chunk-D3H7F6L2.js";
+} from "./chunk-DHCHL6OG.js";
 import "./chunk-EP6RVHMX.js";
 import {
   AgentEvalError,
@@ -145,7 +151,6 @@ import {
   NotFoundError,
   PlannerError,
   RuntimeRunStateError,
-  SessionMismatchError,
   ValidationError
 } from "./chunk-YEJR7IXO.js";
 import "./chunk-DGUM43GV.js";
@@ -256,13 +261,13 @@ function profileDiffProposer(options) {
       const candidates = [];
       const normalizedBaseline = applyExactAgentProfileDiff(
         profile,
-        { schemaVersion: 1, kind: "agent-profile-diff" },
+        { kind: "agent-profile-diff" },
         "profile diff baseline"
       );
       const seen = /* @__PURE__ */ new Set([canonicalJson(normalizedBaseline)]);
       for (const [index, proposal] of proposals.entries()) {
         if (candidates.length >= ctx.populationSize || ctx.signal.aborted) break;
-        const diff = parseExactAgentProfileDiff(proposal.diff, `profile diff proposal ${index}`);
+        const diff = parseExactAgentProfileDiff(proposal, `profile diff proposal ${index}`);
         const axes = changedAgentProfileAxes(diff);
         if (axes.length === 0) continue;
         const candidate = applyExactAgentProfileDiff(
@@ -275,16 +280,16 @@ function profileDiffProposer(options) {
         seen.add(surface);
         candidates.push({
           surface,
-          label: proposal.label ?? diff.title ?? diff.id ?? `Change ${axes.join(", ")}`,
-          rationale: candidateRationale(proposal, diff, axes)
+          label: diff.title ?? diff.id ?? `Change ${axes.join(", ")}`,
+          rationale: candidateRationale(diff, axes)
         });
       }
       return candidates;
     }
   };
 }
-function candidateRationale(proposal, diff, axes) {
-  const reason = proposal.rationale ?? diff.rationale ?? `Changes profile axes: ${axes.join(", ")}.`;
+function candidateRationale(diff, axes) {
+  const reason = diff.rationale ?? `Changes profile axes: ${axes.join(", ")}.`;
   const source = diff.source ? [diff.source.kind, ...diff.source.artifacts ?? []].join(" \xB7 ") : "source unspecified";
   return `${reason} Source: ${source}. Diff: ${canonicalCandidateDigest(diff)}.`;
 }
@@ -557,19 +562,16 @@ async function* runAgentTaskStream(options) {
     return;
   }
   const store = options.sessionStore;
-  const existing = options.sessionId ? await store?.get(options.sessionId) : void 0;
-  const shouldResume = Boolean(options.resume && existing);
-  let session = shouldResume && existing ? await resumeBackendSession(options.backend, existing, input, {
-    task,
-    knowledge,
-    signal: options.signal
-  }) : await startBackendSession(
-    options.backend,
+  const opened = await startOrResumeRuntimeSession({
+    backend: options.backend,
     input,
-    { task, knowledge, signal: options.signal },
-    options.sessionId
-  );
-  await store?.put(session);
+    context: { task, knowledge, signal: options.signal },
+    store,
+    sessionId: options.sessionId,
+    resume: options.resume
+  });
+  let session = opened.session;
+  const shouldResume = opened.resumed;
   const sessionEvent = streamEvent({
     type: shouldResume ? "session_resumed" : "session_created",
     task,
@@ -587,7 +589,7 @@ async function* runAgentTaskStream(options) {
   yield backendStart;
   let finalText = "";
   try {
-    for await (const rawEvent of options.backend.stream(input, {
+    for await (const rawEvent of options.backend.stream(opened.input, {
       task,
       knowledge,
       session,
@@ -709,17 +711,6 @@ async function runKnowledgePreflightStream(task, questions, acquisitionPlans, pr
 function streamEvent(event) {
   return { ...event, timestamp: nowIso() };
 }
-async function startBackendSession(backend, input, context, requestedSessionId) {
-  if (backend.start) return backend.start(input, { ...context, requestedSessionId });
-  return newRuntimeSession(backend.kind, requestedSessionId);
-}
-async function resumeBackendSession(backend, session, input, context) {
-  if (session.backend !== backend.kind) {
-    throw new SessionMismatchError(session.backend, backend.kind);
-  }
-  if (backend.resume) return backend.resume(session, input, context);
-  return touchSession({ ...session, status: "active" });
-}
 function buildReadiness(task, provider) {
   if (provider?.buildReadiness) return provider.buildReadiness(task);
   return scoreKnowledgeReadiness({
@@ -1394,8 +1385,11 @@ function randomSuffix2(len = 8) {
 }
 export {
   AGENTIC_PROFILE_RESOURCE_ROOT,
+  AGENT_CANDIDATE_EXECUTION_SUPPORT,
   AgentEvalError,
   BackendTransportError,
+  CANDIDATE_KNOWLEDGE_RETRIEVAL_CONFIG_ENV,
+  CANDIDATE_KNOWLEDGE_ROOT_ENV,
   CANDIDATE_TRACE_ENV,
   CANDIDATE_TRACE_TAGS,
   CircuitBreakerState,
@@ -1430,6 +1424,7 @@ export {
   buildLoopSpanNodes,
   buildRuntimeEventOtelSpans,
   candidateExecutionClaim,
+  candidateKnowledgeExecutionPaths,
   captureAgentCandidateWorkspace,
   captureAgentCandidateWorkspaceFiles,
   cleanModelId,