@tangle-network/agent-runtime 0.338.0 → 0.339.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (140) hide show
  1. package/dist/{activation-CsbNax2X.d.ts → activation-CJIIl_Ey.d.ts} +4 -24
  2. package/dist/{activation-kbkAuSmY.js → activation-CVSFxis9.js} +5 -18
  3. package/dist/{activation-kbkAuSmY.js.map → activation-CVSFxis9.js.map} +1 -1
  4. package/dist/agent.d.ts +4 -4
  5. package/dist/agent.js +3 -3
  6. package/dist/{bundle-DM60AI2B.js → bundle-DVOhBTic.js} +2 -2
  7. package/dist/{bundle-DM60AI2B.js.map → bundle-DVOhBTic.js.map} +1 -1
  8. package/dist/candidate-execution/index.d.ts +4 -63
  9. package/dist/candidate-execution/index.js +6 -145
  10. package/dist/candidate-execution/index.js.map +1 -1
  11. package/dist/{delegate-Se1YZKMb.js → delegate-CCWE_AkU.js} +2 -2
  12. package/dist/{delegate-Se1YZKMb.js.map → delegate-CCWE_AkU.js.map} +1 -1
  13. package/dist/{driver-control-acknowledgers-T2a1Ouay.js → driver-control-acknowledgers-C53ggdJ6.js} +12 -8
  14. package/dist/driver-control-acknowledgers-C53ggdJ6.js.map +1 -0
  15. package/dist/{durable-file-B_eJr6Mb.js → durable-file-gNI9ILAn.js} +1 -3
  16. package/dist/durable-file-gNI9ILAn.js.map +1 -0
  17. package/dist/durable.d.ts +3 -35
  18. package/dist/durable.js +10 -10
  19. package/dist/durable.js.map +1 -1
  20. package/dist/{graph-CY0wH838.js → graph-CI9JXKqO.js} +4 -4
  21. package/dist/graph-CI9JXKqO.js.map +1 -0
  22. package/dist/{graph-registry-By0tUj4S.js → graph-registry-BnO64cn8.js} +3 -3
  23. package/dist/{graph-registry-By0tUj4S.js.map → graph-registry-BnO64cn8.js.map} +1 -1
  24. package/dist/{improve-CWGBT13K.js → improve-BOXTLWJ3.js} +8 -35
  25. package/dist/improve-BOXTLWJ3.js.map +1 -0
  26. package/dist/{improvement-adapter-D5gwwoXQ.d.ts → improvement-adapter-HUt_-cWA.d.ts} +2 -20
  27. package/dist/index.d.ts +9 -206
  28. package/dist/index.js +91 -302
  29. package/dist/index.js.map +1 -1
  30. package/dist/intelligence.d.ts +10 -142
  31. package/dist/intelligence.js +7 -81
  32. package/dist/intelligence.js.map +1 -1
  33. package/dist/{jsonl-file-DBv31uPi.js → jsonl-file-C9Kde_0Z.js} +2 -2
  34. package/dist/{jsonl-file-DBv31uPi.js.map → jsonl-file-C9Kde_0Z.js.map} +1 -1
  35. package/dist/kernel.d.ts +4 -3
  36. package/dist/kernel.js +12 -14
  37. package/dist/loop-runner-CWzG1bH4.d.ts +32 -0
  38. package/dist/loop-runner-bin.d.ts +32 -2
  39. package/dist/loop-runner-bin.js +93 -1
  40. package/dist/loop-runner-bin.js.map +1 -0
  41. package/dist/loop-runner-pmPIHFVY.js +59 -0
  42. package/dist/loop-runner-pmPIHFVY.js.map +1 -0
  43. package/dist/mcp/bin.js +3 -3
  44. package/dist/mcp/index.d.ts +99 -418
  45. package/dist/mcp/index.js +121 -203
  46. package/dist/mcp/index.js.map +1 -1
  47. package/dist/mcp/memory-bin.js +231 -1
  48. package/dist/mcp/memory-bin.js.map +1 -1
  49. package/dist/model-policy-CyCUwHed.js.map +1 -1
  50. package/dist/placement.d.ts +2 -9
  51. package/dist/placement.js +1 -1
  52. package/dist/placement.js.map +1 -1
  53. package/dist/platform.d.ts +188 -1
  54. package/dist/platform.js +129 -1
  55. package/dist/platform.js.map +1 -1
  56. package/dist/{prepare-Bt0IouPq.js → prepare-bXkvPMJA.js} +8 -160
  57. package/dist/prepare-bXkvPMJA.js.map +1 -0
  58. package/dist/{profile-Do-5xO_D.js → profile-Dpei_Sq0.js} +2 -2
  59. package/dist/profile-Dpei_Sq0.js.map +1 -0
  60. package/dist/{profile-materialization-BnoEf1co.d.ts → profile-materialization-B1wm2SPT.d.ts} +3 -5
  61. package/dist/profiles.d.ts +2 -2
  62. package/dist/profiles.js +3 -40
  63. package/dist/profiles.js.map +1 -1
  64. package/dist/{protected-model-port-DGxQ8_YM.d.ts → protected-model-port-BGgpy2r9.d.ts} +3 -29
  65. package/dist/protected-redaction-DFCeo4vg.js.map +1 -1
  66. package/dist/{provision-supervisor-0jMufp4h.js → provision-supervisor-CJ6Zz6dz.js} +6 -6
  67. package/dist/{provision-supervisor-0jMufp4h.js.map → provision-supervisor-CJ6Zz6dz.js.map} +1 -1
  68. package/dist/{run-cancellation-BoW5Sg9Y.js → run-cancellation-C9oL62sW.js} +3 -7
  69. package/dist/{run-cancellation-BoW5Sg9Y.js.map → run-cancellation-C9oL62sW.js.map} +1 -1
  70. package/dist/{runtime-D37zRSs7.js → runtime-B2fjL9Oi.js} +2531 -2889
  71. package/dist/runtime-B2fjL9Oi.js.map +1 -0
  72. package/dist/{runtime-hooks-Bj6wJHlH.d.ts → runtime-hooks-nsqxSUFL.d.ts} +2 -6
  73. package/dist/{sandbox-profile-compat-xSoVtdWw.js → sandbox-profile-compat-BzVBFqrz.js} +2 -4
  74. package/dist/sandbox-profile-compat-BzVBFqrz.js.map +1 -0
  75. package/dist/{search-executor-DmgUm5p7.js → search-executor-zMumiak_.js} +3 -3
  76. package/dist/search-executor-zMumiak_.js.map +1 -0
  77. package/dist/{server-DQHJszfk.js → server-_4voDNrl.js} +362 -67
  78. package/dist/server-_4voDNrl.js.map +1 -0
  79. package/dist/{structural-rollout-DAvIE8mw.js → structural-rollout-DpLCXzaL.js} +80 -80
  80. package/dist/structural-rollout-DpLCXzaL.js.map +1 -0
  81. package/dist/{substrate-B0TYNrXn.js → substrate-CGDFTSRh.js} +2 -9
  82. package/dist/substrate-CGDFTSRh.js.map +1 -0
  83. package/dist/{supervise-WuPAwfPh.js → supervise-qAwXmPtD.js} +10 -57
  84. package/dist/supervise-qAwXmPtD.js.map +1 -0
  85. package/dist/{supervisor-CPG1I9UN.js → supervisor-DHrUJhEZ.js} +179 -236
  86. package/dist/supervisor-DHrUJhEZ.js.map +1 -0
  87. package/dist/testing.d.ts +2 -2
  88. package/dist/testing.js +13 -13
  89. package/dist/testing.js.map +1 -1
  90. package/dist/tool-loop.d.ts +1 -1
  91. package/dist/{tool-server-Dqer2M4_.js → tool-server-XV4aJwoQ.js} +2 -2
  92. package/dist/tool-server-XV4aJwoQ.js.map +1 -0
  93. package/dist/top-snapshot-CbZE1JsU.js +502 -0
  94. package/dist/top-snapshot-CbZE1JsU.js.map +1 -0
  95. package/dist/tui/bin.js +711 -1
  96. package/dist/tui/bin.js.map +1 -1
  97. package/dist/tui/index.d.ts +2 -70
  98. package/dist/tui/index.js +3 -3
  99. package/dist/{types-CrNWif8-.d.ts → types-CaOXqRTq.d.ts} +713 -2096
  100. package/dist/workspace-store/index.d.ts +2 -27
  101. package/dist/workspace-store/index.js +2 -2
  102. package/dist/workspace-store/index.js.map +1 -1
  103. package/dist/{workspace-streams-BZZds1Fw.d.ts → workspace-streams-BiS4ABah.d.ts} +3 -18
  104. package/package.json +1 -1
  105. package/skills/agent-graphs/references/authoring.md +3 -2
  106. package/dist/coder-yhVWbdWc.js +0 -40
  107. package/dist/coder-yhVWbdWc.js.map +0 -1
  108. package/dist/delegation-status-CF4D0NZ_.js +0 -358
  109. package/dist/delegation-status-CF4D0NZ_.js.map +0 -1
  110. package/dist/driver-control-acknowledgers-T2a1Ouay.js.map +0 -1
  111. package/dist/durable-file-B_eJr6Mb.js.map +0 -1
  112. package/dist/graph-CY0wH838.js.map +0 -1
  113. package/dist/improve-CWGBT13K.js.map +0 -1
  114. package/dist/integrations-6xttbPi9.d.ts +0 -190
  115. package/dist/integrations-dFi-ALk7.js +0 -132
  116. package/dist/integrations-dFi-ALk7.js.map +0 -1
  117. package/dist/kb-gate-C8z2juK8.d.ts +0 -80
  118. package/dist/kb-gate-DpaSwXVx.js +0 -80
  119. package/dist/kb-gate-DpaSwXVx.js.map +0 -1
  120. package/dist/loop-runner-bin-CFnrAHpl.d.ts +0 -164
  121. package/dist/loop-runner-bin-CdPlhy9g.js +0 -246
  122. package/dist/loop-runner-bin-CdPlhy9g.js.map +0 -1
  123. package/dist/memory-server-DXQ8IxGR.js +0 -234
  124. package/dist/memory-server-DXQ8IxGR.js.map +0 -1
  125. package/dist/openai-tools-DoQ32vpe.js +0 -44
  126. package/dist/openai-tools-DoQ32vpe.js.map +0 -1
  127. package/dist/openai-tools-zh2I_uD7.d.ts +0 -24
  128. package/dist/prepare-Bt0IouPq.js.map +0 -1
  129. package/dist/profile-Do-5xO_D.js.map +0 -1
  130. package/dist/runtime-D37zRSs7.js.map +0 -1
  131. package/dist/sandbox-profile-compat-xSoVtdWw.js.map +0 -1
  132. package/dist/search-executor-DmgUm5p7.js.map +0 -1
  133. package/dist/server-DQHJszfk.js.map +0 -1
  134. package/dist/structural-rollout-DAvIE8mw.js.map +0 -1
  135. package/dist/substrate-B0TYNrXn.js.map +0 -1
  136. package/dist/supervise-WuPAwfPh.js.map +0 -1
  137. package/dist/supervisor-CPG1I9UN.js.map +0 -1
  138. package/dist/tool-server-Dqer2M4_.js.map +0 -1
  139. package/dist/top-app-C55Wa7uy.js +0 -1214
  140. package/dist/top-app-C55Wa7uy.js.map +0 -1
@@ -1,11 +1,11 @@
1
- import { l as RuntimeHooks, o as RuntimeHookEvent, r as RuntimeDecisionPoint } from "./runtime-hooks-Bj6wJHlH.js";
2
- import { P as AgentCandidateOutputArtifactPort, g as AgentCandidateArtifactPort, l as AgentCandidateWorkspaceArchiveLimits, n as AgentCandidateWorkspaceTree } from "./workspace-streams-BZZds1Fw.js";
3
- import { s as ProfileMaterializationContract } from "./profile-materialization-BnoEf1co.js";
1
+ import { l as RuntimeHooks, o as RuntimeHookEvent, r as RuntimeDecisionPoint } from "./runtime-hooks-nsqxSUFL.js";
2
+ import { N as AgentCandidateOutputArtifactPort, g as AgentCandidateArtifactPort, l as AgentCandidateWorkspaceArchiveLimits, n as AgentCandidateWorkspaceTree } from "./workspace-streams-BiS4ABah.js";
3
+ import { a as ProfileMaterializationContract } from "./profile-materialization-B1wm2SPT.js";
4
4
  import { n as AnalystRegistryLike } from "./types-zWfqDjeL.js";
5
- import { AgentCandidateArtifactRef, AgentCandidateWorkspaceManifestMaterial, AgentCandidateWorkspaceSnapshotEvidence, AgentExactRunControlRef, AgentInteractiveSession, AgentInteractiveSessionControlClaim, AgentInteractiveSessionPromptAcknowledgement, AgentInteractiveSessionPromptCommand, AgentInteractiveSessionRef, AgentInteractiveSessionStart, AgentInteractiveSessionStatus, AgentNativeContextContinuationOptions, AgentNativeContextContinuationResult, AgentProfile, AgentProfile as AgentProfile$2, AgentProfile as AgentProfile$3, AgentProfileDiff, AgentProfileMcpServer, AgentProfilePrompt, AgentProfileSecurityPolicy, AgentSessionStatus, AgentTurnResult, ChildTaskEvent, ContextTransferReceipt, ContextTransferRequest, HarnessType, InputPart, InteractionAcknowledgement, InteractionRequest, InteractionResponseCommand, NativeContextBoundaryProof, NativeContextContinuationRequest, NativeContextContinuationTurn, ReasoningEffort, RequestedInteractions, RuntimeEventEnvelope, Sha256Digest, StreamEvent, TokenUsage, WorkspaceCheckpointRef, WorkspaceCheckpointRequest } from "@tangle-network/agent-interface";
5
+ import { AgentCandidateArtifactRef, AgentCandidateWorkspaceManifestMaterial, AgentCandidateWorkspaceSnapshotEvidence, AgentExactRunControlRef, AgentInteractiveSession, AgentInteractiveSessionControlClaim, AgentInteractiveSessionPromptAcknowledgement, AgentInteractiveSessionPromptCommand, AgentInteractiveSessionRef, AgentInteractiveSessionStart, AgentNativeContextContinuationOptions, AgentNativeContextContinuationResult, AgentProfile, AgentProfile as AgentProfile$2, AgentProfile as AgentProfile$3, AgentProfileDiff, AgentProfileMcpServer, AgentProfilePrompt, AgentProfileSecurityPolicy, AgentSessionStatus, AgentTurnResult, ChildTaskEvent, ContextTransferReceipt, ContextTransferRequest, HarnessType, InputPart, InteractionAcknowledgement, InteractionRequest, InteractionResponseCommand, NativeContextBoundaryProof, NativeContextContinuationRequest, NativeContextContinuationTurn, ReasoningEffort, RequestedInteractions, RuntimeEventEnvelope, Sha256Digest, StreamEvent, TokenUsage, WorkspaceCheckpointRef, WorkspaceCheckpointRequest } from "@tangle-network/agent-interface";
6
6
  import { AgentEvalError, AgentEvalError as AgentEvalError$1, AgentEvalErrorCode, AgentProfile as AgentProfile$1, AnalystFinding, AnalystFinding as AnalystFinding$1, AnalystFinding as AnalystFinding$2, AnalystRunInputs, ChatClient, ConfigError, ControlBudget, ControlDecision, ControlEvalResult, ControlRunResult, ControlStep, CustomTokenPricing, DataAcquisitionPlan, DefaultVerdict, DefaultVerdict as DefaultVerdict$1, DefaultVerdict as DefaultVerdict$2, DetectorSignal, HarnessType as HarnessType$1, JudgeError, KnowledgeReadinessReport, KnowledgeRequirement, MaximumCharge, NotFoundError, PairedPromotionDecision, ProposalFinding, RankTestMethod, RegistryRunOpts, RunRecord, StreamingDetector, ToolSpan, TraceAnalysisEngine, TraceAnalysisStore, TraceStore, UserQuestion, ValidationError, buildTrajectory, computeFindingId as computeFindingId$1, makeFinding as makeFinding$1 } from "@tangle-network/agent-eval";
7
7
  import { AgentRunOutcome } from "@tangle-network/sandbox/runtime";
8
- import { BackendType, BranchOptions, CreateRequestOptions, CreateSandboxOptions, CreateSandboxOptions as CreateSandboxOptions$1, Process, PromptOptions, Sandbox, SandboxEvent, SandboxEvent as SandboxEvent$1, SandboxInstance, SandboxInstance as SandboxInstance$1, SandboxResources } from "@tangle-network/sandbox";
8
+ import { BackendType, CreateRequestOptions, CreateSandboxOptions, CreateSandboxOptions as CreateSandboxOptions$1, PromptOptions, SandboxEvent, SandboxEvent as SandboxEvent$1, SandboxInstance, SandboxInstance as SandboxInstance$1, SandboxResources } from "@tangle-network/sandbox";
9
9
  import { watch } from "node:fs";
10
10
  import { ChildProcess } from "node:child_process";
11
11
  import { HarnessId, WorkspacePlanReceipt } from "@tangle-network/agent-profile-materialize";
@@ -14,7 +14,7 @@ import { AnalystRegistry, AnalystRunInputs as AnalystRunInputs$1, AnalystRunResu
14
14
  import { DispatchFn, ExternalOptimizerModelCall, JudgeConfig, NodeEstimate, ProfileDispatchFn, RunProfileMatrixOptions, RunProfileMatrixResult, Scenario, SearchAllocator, SearchAudit, SearchClaim, SearchClaimVerification, SearchCloseReason, SearchHistoryReceipt, SearchNodeStatus, SearchPolicy, SearchSplit, SearchStateView } from "@tangle-network/agent-eval/campaign";
15
15
  import { EvaluationClaim, SealedExperiment } from "@tangle-network/agent-eval/experiment";
16
16
  import { stuckLoopView, toolWasteView } from "@tangle-network/agent-eval/pipelines";
17
- import { AgentEnvironment, AgentEnvironment as AgentEnvironment$1, AgentEnvironmentCapabilities, AgentEnvironmentCapabilities as AgentEnvironmentCapabilities$1, AgentEnvironmentEvent, AgentEnvironmentEvent as AgentEnvironmentEvent$1, AgentEnvironmentProvider, AgentEnvironmentProvider as AgentEnvironmentProvider$1, AgentEnvironmentQuery, AgentEnvironmentStatus, AgentEnvironmentSummary, AgentProfileRef, AgentSession, AgentSessionRef, AgentSessionStatus as AgentSessionStatus$1, AgentTurnInput, AgentTurnInput as AgentTurnInput$1, AgentTurnResult as AgentTurnResult$1, AgentTurnResult as AgentTurnResult$2, CheckpointRef, CheckpointRequest, CreateAgentEnvironmentInput, CreateAgentEnvironmentInput as CreateAgentEnvironmentInput$1, ExecRequest, ExecResult, ForkRequest, PlacementInfo, ResourceRequest, WorkspaceRequest } from "@tangle-network/agent-interface/environment-provider";
17
+ import { AgentEnvironment, AgentEnvironment as AgentEnvironment$1, AgentEnvironmentCapabilities, AgentEnvironmentCapabilities as AgentEnvironmentCapabilities$1, AgentEnvironmentEvent, AgentEnvironmentEvent as AgentEnvironmentEvent$1, AgentEnvironmentProvider, AgentEnvironmentProvider as AgentEnvironmentProvider$1, AgentEnvironmentQuery, AgentEnvironmentStatus, AgentEnvironmentSummary, AgentSession, AgentSessionRef, AgentSessionStatus as AgentSessionStatus$1, AgentTurnInput, AgentTurnInput as AgentTurnInput$1, AgentTurnResult as AgentTurnResult$1, AgentTurnResult as AgentTurnResult$2, CheckpointRef, CheckpointRequest, CreateAgentEnvironmentInput, CreateAgentEnvironmentInput as CreateAgentEnvironmentInput$1, ExecRequest, ExecResult, ForkRequest, PlacementInfo, ResourceRequest, WorkspaceRequest } from "@tangle-network/agent-interface/environment-provider";
18
18
  import { CodemodeExecuteOptions, CodemodeJsonSchema, CodemodeResult, CodemodeSandboxOptions } from "@earendil-works/pi-codemode";
19
19
  //#region src/runtime/retained-run-types.d.ts
20
20
  /** Cursor plus runtime sequence needed to continue one ordered replay. @stable */
@@ -2557,96 +2557,6 @@ declare class RuntimeRunStateError extends AgentEvalError {
2557
2557
  cause?: unknown;
2558
2558
  });
2559
2559
  }
2560
- /**
2561
- *
2562
- * The dynamic-loop planner returned an unusable topology move — the LLM emitted
2563
- * no parseable envelope, an unknown `kind`, or a structurally-invalid move
2564
- * (e.g. a fanout with zero tasks). This is a structural failure of the
2565
- * agent-authored topology, not a config mistake: the planner ran but its output
2566
- * cannot drive the kernel. Carries `validation` so cross-package handlers can
2567
- * pattern-match without importing the runtime. Fail loud — never substitute a
2568
- * default move, or the loop silently runs a topology nobody chose.
2569
- *
2570
- * @stable
2571
- */
2572
- declare class PlannerError extends AgentEvalError {
2573
- constructor(message: string, options?: {
2574
- cause?: unknown;
2575
- });
2576
- }
2577
- /**
2578
- *
2579
- * The caller's `onAdmission` durability hook rejected, so a retained run's
2580
- * admission record is not durable. For a pre-create intent, no provider work
2581
- * has started. For a later record, provider state may already be live and the
2582
- * environment remains available for recovery. Carries `capture_integrity`
2583
- * because the required recovery record was not written.
2584
- *
2585
- * @stable
2586
- */
2587
- declare abstract class RetainedAdmissionError<TAdmission extends RetainedRunAdmission | RetainedInteractiveAdmission> extends AgentEvalError {
2588
- readonly phase: TAdmission['phase'];
2589
- /** The exact record the hook failed to persist, for direct recovery. */
2590
- readonly admission: TAdmission;
2591
- constructor(admission: TAdmission, options?: {
2592
- cause?: unknown;
2593
- });
2594
- }
2595
- /** The caller could not persist one detached-run recovery record. @stable */
2596
- declare class RetainedRunAdmissionError extends RetainedAdmissionError<RetainedRunAdmission> {}
2597
- /** The caller could not persist one exact interactive-process recovery record. @stable */
2598
- declare class RetainedInteractiveAdmissionError extends RetainedAdmissionError<RetainedInteractiveAdmission> {}
2599
- /**
2600
- * A provider returned a valid interactive reference that does not bind to the
2601
- * exact start request, or returned data that could not be parsed as one.
2602
- *
2603
- * The requested start and any valid provider reference are detached snapshots.
2604
- * Malformed provider data is never copied into the error, so the error remains
2605
- * safe to persist while the environment remains available for orphan cleanup.
2606
- *
2607
- * @stable
2608
- */
2609
- declare class RetainedInteractiveBindingError extends AgentEvalError {
2610
- /** The exact native-process start request sent to the provider. */
2611
- readonly requested: AgentInteractiveSessionStart;
2612
- /** The valid provider data, when the provider returned a parseable value. */
2613
- readonly returned: {
2614
- readonly ref?: AgentInteractiveSessionRef;
2615
- readonly status?: AgentInteractiveSessionStatus;
2616
- };
2617
- constructor(requested: AgentInteractiveSessionStart, returned: RetainedInteractiveBindingError['returned'], options?: {
2618
- cause?: unknown;
2619
- });
2620
- }
2621
- /**
2622
- *
2623
- * A retained dispatch answered with coordinates that do not bind to the
2624
- * identity the runtime requested, or failed exact verification. The
2625
- * environment-phase admission is already durable at this point, so its
2626
- * coordinates plus the provider reference carried here are the manual
2627
- * recovery path. The environment is intentionally kept. Carries
2628
- * `backend_integrity` because the provider violated its dispatch contract.
2629
- *
2630
- * @stable
2631
- */
2632
- declare class RetainedRunDispatchBindingError extends AgentEvalError {
2633
- /** The coordinates the runtime sent with the dispatch. */
2634
- readonly requested: {
2635
- readonly provider: string;
2636
- readonly environmentId: string;
2637
- readonly sessionId: string;
2638
- readonly executionId: string;
2639
- };
2640
- /** The loose reference the provider actually returned, for triage. */
2641
- readonly returned: {
2642
- readonly id?: string;
2643
- readonly provider?: string;
2644
- readonly controlRef?: unknown;
2645
- };
2646
- constructor(requested: RetainedRunDispatchBindingError['requested'], returned: RetainedRunDispatchBindingError['returned'], options?: {
2647
- cause?: unknown;
2648
- });
2649
- }
2650
2560
  //#endregion
2651
2561
  //#region src/redact.d.ts
2652
2562
  /**
@@ -2671,13 +2581,6 @@ type Redactor = (value: unknown) => unknown;
2671
2581
  * on customer input and never mutates it.
2672
2582
  */
2673
2583
  declare function defaultRedactor(value: unknown): unknown;
2674
- /**
2675
- * Resolve the redactor a client uses. A caller-supplied hook handles
2676
- * domain-specific values first, then the built-in scrubber still removes
2677
- * credentials and personal data. Returning `false` is the explicit opt-out for
2678
- * already-reviewed public values.
2679
- */
2680
- declare function resolveRedactor(redact: Redactor | false | undefined): Redactor;
2681
2584
  //#endregion
2682
2585
  //#region src/durable/content-address.d.ts
2683
2586
  /** Stable content address shared by result and trace artifacts. */
@@ -2863,27 +2766,6 @@ interface SqlAdapter {
2863
2766
  /** Execute a read statement (SELECT). Returns rows as plain objects. */
2864
2767
  query<TRow = Record<string, unknown>>(sql: string, params?: readonly unknown[]): Promise<TRow[]>;
2865
2768
  }
2866
- /**
2867
- * Adapt a Cloudflare D1 binding to the SqlAdapter shape. Lives here so D1
2868
- * consumers don't have to write the wrapper themselves; the runtime never
2869
- * imports `@cloudflare/workers-types` directly (peer-style typing).
2870
- */
2871
- declare function d1ToSqlAdapter(db: D1DatabaseLike): SqlAdapter;
2872
- /**
2873
- * Structural type matching the surface of `D1Database` we depend on, so the
2874
- * SDK never imports `@cloudflare/workers-types`. Consumers pass their real
2875
- * `D1Database` from `env.DB` and TS structural compatibility lines it up.
2876
- */
2877
- interface D1DatabaseLike {
2878
- prepare(sql: string): D1StmtLike;
2879
- }
2880
- interface D1StmtLike {
2881
- bind(...params: unknown[]): D1StmtLike;
2882
- run(): Promise<unknown>;
2883
- all<TRow = unknown>(): Promise<{
2884
- results?: TRow[];
2885
- }>;
2886
- }
2887
2769
  //#endregion
2888
2770
  //#region src/durable/sql-run-store.d.ts
2889
2771
  /** @internal The SQL run context owns the payload schema; this store owns publication. */
@@ -2923,6 +2805,184 @@ declare function openSqlRunStore<Payload>(db: SqlAdapter, runId: string, options
2923
2805
  acquire(signal?: AbortSignal): Promise<SqlRunLease<Payload>>;
2924
2806
  }>;
2925
2807
  //#endregion
2808
+ //#region src/mcp/codex-execution-policy.d.ts
2809
+ /** Isolation settings asserted before a reproducible Codex run is allowed to start. */
2810
+ interface CodexExecutionPolicy {
2811
+ sessionPersistence: 'ephemeral';
2812
+ userConfig: false;
2813
+ rules: false;
2814
+ projectInstructions: false;
2815
+ skillInstructions: false;
2816
+ appInstructions: false;
2817
+ toolSuggestions: false;
2818
+ multiAgentInstructions: false;
2819
+ sandbox: 'workspace-write';
2820
+ permissionProfile: 'agent_runtime_reproducible';
2821
+ approvalPolicy: 'never';
2822
+ shellNetwork: false;
2823
+ webSearch: false;
2824
+ serviceTier: 'default';
2825
+ shellEnvironment: 'core-filtered';
2826
+ loginShell: false;
2827
+ credentialsReadable: false;
2828
+ hostHomeReadable: false;
2829
+ procEnvironment: 'private-sanitized';
2830
+ sensitiveEnvironmentNamesVisible: false;
2831
+ parentRepoRead: false;
2832
+ gitMetadata: false;
2833
+ temporaryDirectory: 'workspace-private';
2834
+ stagedExecutable: 'static-elf-read-only';
2835
+ callerReadDeniedPaths: 'enforced';
2836
+ containerSockets: false;
2837
+ }
2838
+ //#endregion
2839
+ //#region src/mcp/codex-token-usage.d.ts
2840
+ /**
2841
+ * Exact aggregate usage emitted by Codex's terminal `turn.completed` JSONL event.
2842
+ *
2843
+ * `cachedInputTokens` is a part of `inputTokens` and `reasoningOutputTokens` is a part of
2844
+ * `outputTokens`; neither adds to the total it describes. `cacheWriteInputTokens` is optional
2845
+ * because the codex CLI reports it and a provider-normalized capture omits it, and an absent
2846
+ * counter must stay absent rather than become a zero that claims no cache write was measured.
2847
+ */
2848
+ interface CodexTokenUsage {
2849
+ inputTokens: number;
2850
+ cachedInputTokens: number;
2851
+ outputTokens: number;
2852
+ reasoningOutputTokens: number;
2853
+ cacheWriteInputTokens?: number;
2854
+ }
2855
+ //#endregion
2856
+ //#region src/mcp/local-harness-invocation.d.ts
2857
+ /**
2858
+ * Local coding harness available inside the sandbox — a narrowing of the shared `HarnessType`
2859
+ * vocabulary, NOT a private spelling of it. The harness id is `claude-code`; `claude` is the
2860
+ * EXECUTABLE name and lives only in the `command` field below. Keeping one vocabulary is what
2861
+ * lets a `LocalHarness` be handed straight to the profile materializer and the capability table
2862
+ * with no translation step.
2863
+ */
2864
+ type LocalHarness = Extract<HarnessType, 'claude-code' | 'codex' | 'opencode' | 'pi'>;
2865
+ /** Every local harness, in table order — the one list `AGENT_RUNTIME_LOCAL_HARNESSES` and any
2866
+ * other harness enumeration reads, so adding a row above is the only edit a new harness needs. */
2867
+ declare const LOCAL_HARNESSES: ReadonlyArray<LocalHarness>;
2868
+ //#endregion
2869
+ //#region src/mcp/local-harness-process.d.ts
2870
+ /** @experimental */
2871
+ interface RunLocalHarnessOptions {
2872
+ harness: LocalHarness;
2873
+ /** Working directory for the subprocess (typically a worktree path). */
2874
+ cwd: string;
2875
+ /** Prompt forwarded as the harness CLI's task argument. */
2876
+ taskPrompt: string;
2877
+ /**
2878
+ * Pre-built command + args (e.g. from `harnessInvocation` so the full authored
2879
+ * `AgentProfile` — systemPrompt + model — reaches the harness). When set it OVERRIDES the
2880
+ * default prompt-only `buildArgs(taskPrompt)` path; `command` defaults to the harness's
2881
+ * default binary when only `args` is supplied. When absent the legacy prompt-only shape
2882
+ * is used unchanged.
2883
+ */
2884
+ invocation?: {
2885
+ command?: string;
2886
+ args: ReadonlyArray<string>;
2887
+ };
2888
+ /** Allow autonomous edits without an interactive approval gate, using whichever bypass argv the
2889
+ * harness declares. Use only when `cwd` is an isolated candidate worktree. */
2890
+ dangerouslySkipPermissions?: boolean;
2891
+ /** Isolate Codex from ambient configuration/instructions and require JSONL token usage.
2892
+ * The invocation should come from `harnessInvocation(..., { codexReproducible: true })`. */
2893
+ codexReproducible?: boolean;
2894
+ /** Absolute host paths that reproducible Codex must not read. The normalized set is compiled
2895
+ * into the controlled permission profile and its digest is returned in execution evidence. */
2896
+ codexReadDeniedPaths?: ReadonlyArray<string>;
2897
+ /** Optional wall-clock kill deadline (ms). Omit it for no timer. A positive value sends
2898
+ * SIGTERM on expiry. */
2899
+ timeoutMs?: number;
2900
+ /** Newest stdout/stderr bytes retained per stream. Default 64 MiB. */
2901
+ maxOutputBytes?: number;
2902
+ /** Caller cancellation. SIGTERM is sent on abort. */
2903
+ signal?: AbortSignal;
2904
+ /** Override env (defaults to inheriting from the parent). */
2905
+ env?: NodeJS.ProcessEnv;
2906
+ /**
2907
+ * Test seam — inject a custom spawner so unit tests can mock the
2908
+ * subprocess without touching the OS. Defaults to node's `child_process.spawn`.
2909
+ */
2910
+ spawn?: (command: string, args: ReadonlyArray<string>, opts: {
2911
+ cwd: string;
2912
+ env: NodeJS.ProcessEnv;
2913
+ stdio: 'pipe';
2914
+ detached: boolean;
2915
+ }) => ChildProcess;
2916
+ /** Test seam for locating the native Codex executable before it is staged in the worktree. */
2917
+ resolveCodexExecutable?: (command: string, env: NodeJS.ProcessEnv) => Promise<string>;
2918
+ }
2919
+ /** @experimental */
2920
+ interface LocalHarnessResult {
2921
+ /** OS exit code. `null` when killed before exit. */
2922
+ exitCode: number | null;
2923
+ /** Concatenated stdout. */
2924
+ stdout: string;
2925
+ /** Concatenated stderr. */
2926
+ stderr: string;
2927
+ /** Set when the process exited via signal (timeout / abort). */
2928
+ killedBySignal: NodeJS.Signals | null;
2929
+ /** Wall-clock duration ms (spawn → exit). */
2930
+ durationMs: number;
2931
+ /** Set when timeoutMs elapsed before exit. */
2932
+ timedOut: boolean;
2933
+ /**
2934
+ * Set when the caller's AbortSignal fired before this result settled.
2935
+ * Optional so injected runners and stored results from older releases remain valid.
2936
+ */
2937
+ aborted?: boolean;
2938
+ /** Present for a reproducible Codex run; parsed from the real terminal JSONL event. */
2939
+ usage?: CodexTokenUsage;
2940
+ /** Present for reproducible Codex runs; generated and checked before model execution. */
2941
+ evidence?: CodexExecutionEvidence;
2942
+ }
2943
+ /**
2944
+ * Spawn a local coding harness CLI as a subprocess + collect its output.
2945
+ *
2946
+ * NOT responsible for parsing the harness's output or extracting a diff —
2947
+ * the in-process executor's `streamPrompt` orchestrates `git diff` against
2948
+ * the worktree after this resolves. This function is intentionally narrow:
2949
+ * spawn, wait, capture, return.
2950
+ *
2951
+ * Fails loud — throws when:
2952
+ * - `cwd` doesn't exist (subprocess emits ENOENT; surfaced as Error)
2953
+ * - the harness binary is not on PATH (ENOENT)
2954
+ * - the caller signal was already aborted before process launch
2955
+ *
2956
+ * Does NOT throw when:
2957
+ * - the subprocess exits non-zero (`result.exitCode` carries the code)
2958
+ * - a non-reproducible subprocess is aborted / timed out (`result.aborted` /
2959
+ * `result.timedOut` carries the reason even when a TERM-aware child exits zero)
2960
+ *
2961
+ * Reproducible Codex additionally requires a terminal usage event. If cancellation
2962
+ * prevents that event, this rejects with `CodexExecutionDiagnosticError` instead of
2963
+ * returning an incomplete reproducibility receipt.
2964
+ *
2965
+ * @experimental
2966
+ */
2967
+ declare function runLocalHarness(options: RunLocalHarnessOptions): Promise<LocalHarnessResult>;
2968
+ //#endregion
2969
+ //#region src/mcp/codex-execution-evidence.d.ts
2970
+ /** Zero-model-call evidence for the exact Codex process about to run. */
2971
+ interface CodexExecutionEvidence {
2972
+ cliVersion: string;
2973
+ executableSha256: string;
2974
+ /** SHA-256 of the exact composed prompt argument proved present in the rendered prompt. */
2975
+ requestedPromptSha256: string;
2976
+ effectivePromptSha256: string;
2977
+ nonPromptArgsSha256: string;
2978
+ controlledConfigSha256: string;
2979
+ /** Sorted normalized paths compiled into the permission profile. */
2980
+ readDeniedPaths: string[];
2981
+ readDeniedPathsSha256: string;
2982
+ readDeniedPathCount: number;
2983
+ policy: CodexExecutionPolicy;
2984
+ }
2985
+ //#endregion
2926
2986
  //#region src/mcp/tools/coordination-analysts.d.ts
2927
2987
  /**
2928
2988
  * What one analyst lens may return.
@@ -2952,7 +3012,7 @@ interface AnalystKind {
2952
3012
  declare const analystToolGroupNames: readonly ["all", "discovery", "discoveryAndRead", "discoveryAndSearch", "targeted", "singleTrace"];
2953
3013
  type AnalystToolGroupName = (typeof analystToolGroupNames)[number];
2954
3014
  /** Bounds on the recursive investigation a defined analyst may run. Each field is optional and is
2955
- * clamped to {@link ANALYST_DEFINITION_BOUNDS}; omitted fields take the engine's own default. */
3015
+ * clamped to `ANALYST_DEFINITION_BOUNDS`; omitted fields take the engine's own default. */
2956
3016
  interface AuthoredAnalystLimits {
2957
3017
  readonly maxIterations?: number;
2958
3018
  readonly maxLlmCalls?: number;
@@ -2991,35 +3051,6 @@ interface AuthoredAnalystDefinition {
2991
3051
  /** Minimum distinct evidence citations per finding. Default 1. */
2992
3052
  readonly minimumEvidenceCitations?: number;
2993
3053
  }
2994
- /** Every bound `define_analyst` enforces before a definition reaches a registry.
2995
- *
2996
- * MOTIVE, stated as numbers, because a fence whose motive cannot be stated is over-engineering:
2997
- * a defined lens spends real model calls from the run's own account on every settle it is routed
2998
- * over, and its `instructions` are re-sent on every one of them. So the two fields that multiply
2999
- * — `instructions` bytes and `maxLlmCalls` — are the ones with hard ceilings, and the ceilings are
3000
- * twice agent-eval's own defaults (`maxIterations` 12, `maxLlmCalls` 8, `maxToolCalls` 48,
3001
- * `maxOutputChars` 10_000): enough headroom for a deeper question than the shipped lenses ask,
3002
- * not enough for one definition to become the dominant cost of a run. */
3003
- declare const ANALYST_DEFINITION_BOUNDS: Readonly<{
3004
- idPattern: RegExp;
3005
- maxDescriptionChars: 300;
3006
- maxAreaChars: 64;
3007
- maxQuestionChars: 1000;
3008
- maxInstructionsChars: 20000;
3009
- maxModelChars: 128;
3010
- maxIterations: 24;
3011
- maxLlmCalls: 16;
3012
- maxToolCalls: 96;
3013
- maxOutputChars: 20000;
3014
- maxEvidenceCitations: 10;
3015
- /** Lenses ONE manager may define, counting those it defined in a PRIOR process of a durable run.
3016
- * This bounds MENU GROWTH, not spend: a definition costs nothing until `run_analyst` is called,
3017
- * so the failure it stops is a manager that keeps re-authoring a lens instead of running one —
3018
- * each definition adds a line every later `list_analysts` re-reads. Eight is more than the five
3019
- * calibrated lenses agent-eval ships. Per-run analyst SPEND is bounded by the conserved pool the
3020
- * engine draws from, not here. */
3021
- maxDefinitionsPerManager: 8;
3022
- }>;
3023
3054
  /** What the coordination layer records when a definition is admitted: the exact accepted bytes, the
3024
3055
  * kind the registry returned, and a digest over the definition so a finding can be traced back to
3025
3056
  * the words that produced it. */
@@ -3051,7 +3082,7 @@ interface AnalystRegistry$1 {
3051
3082
  * run started. Present = `define_analyst` is mounted; absent = the menu is fixed (the status quo).
3052
3083
  *
3053
3084
  * The coordination layer validates and bounds the definition first (see
3054
- * {@link ANALYST_DEFINITION_BOUNDS}) and refuses a duplicate id, so an implementation receives
3085
+ * `ANALYST_DEFINITION_BOUNDS`) and refuses a duplicate id, so an implementation receives
3055
3086
  * only well-formed, in-bounds definitions. It returns the {@link AnalystKind} the lens is now
3056
3087
  * reachable as; `run_analyst` must resolve that id immediately afterwards. THROWING is the
3057
3088
  * refusal channel — an unavailable model seat, a policy that forbids authored lenses — and the
@@ -3071,15 +3102,6 @@ interface AnalystFindingEvent {
3071
3102
  * digesting subscribers (the coordination-event id) never throw on analyst-shaped data. */
3072
3103
  readonly findings?: unknown;
3073
3104
  }
3074
- /** Producer-side cleanliness for the `finding` event. The findings payload is arbitrary analyst
3075
- * output, the digest a subscriber computes (RFC 8785) throws on ANY `undefined` value — nested
3076
- * included — and a throwing subscriber leaves the event invisible to EVERY subscriber. The
3077
- * producer, not the digest, owns keeping the event canonical: an `undefined` payload is stripped
3078
- * to key-absence, everything else is JSON round-tripped (nested `undefined` object values drop,
3079
- * `undefined` array slots become `null`), and a payload JSON cannot represent at all (cycle,
3080
- * BigInt, bare function) becomes a record OF that fact — degraded findings beat a vanished
3081
- * event. */
3082
- declare function canonicalFindingEvent(finding: AnalystFindingEvent): AnalystFindingEvent;
3083
3105
  /**
3084
3106
  * One analyst-on-settle ROUTE: which lens runs (`kind`), over WHICH settled workers (`over`),
3085
3107
  * delivered to WHOM (`to`), wrapped in WHAT standing instruction (`directive`). The generalized
@@ -3143,26 +3165,6 @@ interface AnalystAssignmentRecord {
3143
3165
  readonly directive?: string;
3144
3166
  readonly to?: string;
3145
3167
  }
3146
- /** One rejected field of an authored analyst definition: which field, and what is wrong with it. */
3147
- interface AnalystDefinitionIssue {
3148
- readonly path: string;
3149
- readonly message: string;
3150
- }
3151
- /**
3152
- * Validate and BOUND one `define_analyst` argument.
3153
- *
3154
- * Every reason is collected, never short-circuited: a manager re-authoring from a partial list of
3155
- * complaints spends a turn per complaint. Numeric limits are CLAMPED rather than rejected — asking
3156
- * for 200 tool calls is a mis-estimate, not a malformed definition, and the accepted value is
3157
- * returned so the manager reads the ceiling it actually got.
3158
- */
3159
- declare function parseAuthoredAnalystDefinition(raw: unknown): {
3160
- definition: AuthoredAnalystDefinition;
3161
- } | {
3162
- issues: ReadonlyArray<AnalystDefinitionIssue>;
3163
- };
3164
- /** Normalize the two spellings of an analyst-on-settle entry to the route form. */
3165
- declare function normalizeAnalyzeOnSettle(entry: string | AnalyzeOnSettleRoute): AnalyzeOnSettleRoute;
3166
3168
  //#endregion
3167
3169
  //#region src/runtime/supervise/detector-monitor.d.ts
3168
3170
  interface WatchTraceOptions {
@@ -3474,7 +3476,7 @@ type MapItemFailurePolicy = 'all-or-refuse' | 'settled-subset';
3474
3476
  * is the item's task — at most `concurrency` at a time. Once every item settled it starts `join`
3475
3477
  * with the ordered results. Items and the join go through the same admission a `spawn_worker` call
3476
3478
  * takes (pre-flight, budget reservation from the conserved pool, `makeWorkerAgent`), carrying the
3477
- * runtime-authored {@link WorkerSpawnContext.map} marker, so no manager turn is spent on them.
3479
+ * runtime-authored `WorkerSpawnContext.map` marker, so no manager turn is spent on them.
3478
3480
  *
3479
3481
  * Every step publishes a `map` event. Item settlements are recorded but not queued, so the
3480
3482
  * manager is woken by the join's settlement, or by a `map` event when the map was refused or its
@@ -3536,15 +3538,6 @@ interface MapTraversalEvent {
3536
3538
  }
3537
3539
  //#endregion
3538
3540
  //#region src/mcp/tools/coordination-messages.d.ts
3539
- /**
3540
- * Why one parent→child delivery did not land, in the words the MANAGER needs.
3541
- *
3542
- * `DownMessageDeliveryOutcome` is the machine code; this is the sentence beside it. A code alone
3543
- * left the manager to guess whether to retry, spawn, or give up — `already-settled` and
3544
- * `scope-stopped` look alike and need opposite moves. Every refusal a coordination verb returns
3545
- * carries a sentence like these, because the manager cannot see the state that produced it.
3546
- */
3547
- declare const downMessageRefusalReasons: Readonly<Record<DownMessageDeliveryOutcome, string>>;
3548
3541
  /** How a spawn CONTINUES a node's prior work: `'fresh'` starts a brand-new session (the default,
3549
3542
  * and the only pre-continuity behavior); `'resume'` re-attaches to the node's most recent
3550
3543
  * SETTLED worker — a NEW live worker is spawned whose spawn context carries the prior worker's
@@ -4118,261 +4111,7 @@ interface ToolOutcomeEvent {
4118
4111
  readonly elapsedMs: number;
4119
4112
  }
4120
4113
  //#endregion
4121
- //#region src/mcp/codex-execution-policy.d.ts
4122
- /** Isolation settings asserted before a reproducible Codex run is allowed to start. */
4123
- interface CodexExecutionPolicy {
4124
- sessionPersistence: 'ephemeral';
4125
- userConfig: false;
4126
- rules: false;
4127
- projectInstructions: false;
4128
- skillInstructions: false;
4129
- appInstructions: false;
4130
- toolSuggestions: false;
4131
- multiAgentInstructions: false;
4132
- sandbox: 'workspace-write';
4133
- permissionProfile: 'agent_runtime_reproducible';
4134
- approvalPolicy: 'never';
4135
- shellNetwork: false;
4136
- webSearch: false;
4137
- serviceTier: 'default';
4138
- shellEnvironment: 'core-filtered';
4139
- loginShell: false;
4140
- credentialsReadable: false;
4141
- hostHomeReadable: false;
4142
- procEnvironment: 'private-sanitized';
4143
- sensitiveEnvironmentNamesVisible: false;
4144
- parentRepoRead: false;
4145
- gitMetadata: false;
4146
- temporaryDirectory: 'workspace-private';
4147
- stagedExecutable: 'static-elf-read-only';
4148
- callerReadDeniedPaths: 'enforced';
4149
- containerSockets: false;
4150
- }
4151
- //#endregion
4152
- //#region src/mcp/codex-token-usage.d.ts
4153
- /**
4154
- * Exact aggregate usage emitted by Codex's terminal `turn.completed` JSONL event.
4155
- *
4156
- * `cachedInputTokens` is a part of `inputTokens` and `reasoningOutputTokens` is a part of
4157
- * `outputTokens`; neither adds to the total it describes. `cacheWriteInputTokens` is optional
4158
- * because the codex CLI reports it and a provider-normalized capture omits it, and an absent
4159
- * counter must stay absent rather than become a zero that claims no cache write was measured.
4160
- */
4161
- interface CodexTokenUsage {
4162
- inputTokens: number;
4163
- cachedInputTokens: number;
4164
- outputTokens: number;
4165
- reasoningOutputTokens: number;
4166
- cacheWriteInputTokens?: number;
4167
- }
4168
- /**
4169
- * Parse and validate the one terminal usage event emitted by `codex exec --json`.
4170
- *
4171
- * The JSONL framing is this surface's own; the usage RECORD is read by `parseCodexUsageRecord`,
4172
- * the one codex usage reader the sandbox decoder also calls, so both surfaces hold the same field
4173
- * policy and the same two cross-field invariants.
4174
- */
4175
- declare function parseCodexTokenUsage(stdout: string): CodexTokenUsage;
4176
- //#endregion
4177
- //#region src/mcp/local-harness-invocation.d.ts
4178
- /**
4179
- * Local coding harness available inside the sandbox — a narrowing of the shared `HarnessType`
4180
- * vocabulary, NOT a private spelling of it. The harness id is `claude-code`; `claude` is the
4181
- * EXECUTABLE name and lives only in the `command` field below. Keeping one vocabulary is what
4182
- * lets a `LocalHarness` be handed straight to the profile materializer and the capability table
4183
- * with no translation step.
4184
- */
4185
- type LocalHarness = Extract<HarnessType, 'claude-code' | 'codex' | 'opencode' | 'pi'>;
4186
- /** Every local harness, in table order — the one list `AGENT_RUNTIME_LOCAL_HARNESSES` and any
4187
- * other harness enumeration reads, so adding a row above is the only edit a new harness needs. */
4188
- declare const LOCAL_HARNESSES: ReadonlyArray<LocalHarness>;
4189
- /** The harness a caller gets when it expresses no preference. A composition-root default, not a
4190
- * capability claim: one constant so the several entry points cannot drift apart. */
4191
- declare const DEFAULT_LOCAL_HARNESS: LocalHarness;
4192
- /** The CLI binary a harness id runs. The two are NOT the same string (`claude-code` runs `claude`),
4193
- * so anything spawning a harness — a version probe, a login check — reads it from here rather than
4194
- * passing the harness id as a command. */
4195
- declare function localHarnessExecutable(harness: LocalHarness): string;
4196
- /**
4197
- * Whether the harness's native control can express this reasoning effort. Admission checks read
4198
- * this so a profile the invocation would later refuse is rejected BEFORE any workspace state is
4199
- * created, against the same table that emits the argv.
4200
- */
4201
- declare function harnessSupportsReasoningEffort(harness: LocalHarness, reasoningEffort: ReasoningEffort): boolean;
4202
- //#endregion
4203
- //#region src/mcp/codex-execution-evidence.d.ts
4204
- /** Zero-model-call evidence for the exact Codex process about to run. */
4205
- interface CodexExecutionEvidence {
4206
- cliVersion: string;
4207
- executableSha256: string;
4208
- /** SHA-256 of the exact composed prompt argument proved present in the rendered prompt. */
4209
- requestedPromptSha256: string;
4210
- effectivePromptSha256: string;
4211
- nonPromptArgsSha256: string;
4212
- controlledConfigSha256: string;
4213
- /** Sorted normalized paths compiled into the permission profile. */
4214
- readDeniedPaths: string[];
4215
- readDeniedPathsSha256: string;
4216
- readDeniedPathCount: number;
4217
- policy: CodexExecutionPolicy;
4218
- }
4219
- //#endregion
4220
- //#region src/mcp/local-harness-process.d.ts
4221
- /** @experimental */
4222
- interface RunLocalHarnessOptions {
4223
- harness: LocalHarness;
4224
- /** Working directory for the subprocess (typically a worktree path). */
4225
- cwd: string;
4226
- /** Prompt forwarded as the harness CLI's task argument. */
4227
- taskPrompt: string;
4228
- /**
4229
- * Pre-built command + args (e.g. from `harnessInvocation` so the full authored
4230
- * `AgentProfile` — systemPrompt + model — reaches the harness). When set it OVERRIDES the
4231
- * default prompt-only `buildArgs(taskPrompt)` path; `command` defaults to the harness's
4232
- * default binary when only `args` is supplied. When absent the legacy prompt-only shape
4233
- * is used unchanged.
4234
- */
4235
- invocation?: {
4236
- command?: string;
4237
- args: ReadonlyArray<string>;
4238
- };
4239
- /** Allow autonomous edits without an interactive approval gate, using whichever bypass argv the
4240
- * harness declares. Use only when `cwd` is an isolated candidate worktree. */
4241
- dangerouslySkipPermissions?: boolean;
4242
- /** Isolate Codex from ambient configuration/instructions and require JSONL token usage.
4243
- * The invocation should come from `harnessInvocation(..., { codexReproducible: true })`. */
4244
- codexReproducible?: boolean;
4245
- /** Absolute host paths that reproducible Codex must not read. The normalized set is compiled
4246
- * into the controlled permission profile and its digest is returned in execution evidence. */
4247
- codexReadDeniedPaths?: ReadonlyArray<string>;
4248
- /** Optional wall-clock kill deadline (ms). Omit it for no timer. A positive value sends
4249
- * SIGTERM on expiry. */
4250
- timeoutMs?: number;
4251
- /** Newest stdout/stderr bytes retained per stream. Default 64 MiB. */
4252
- maxOutputBytes?: number;
4253
- /** Caller cancellation. SIGTERM is sent on abort. */
4254
- signal?: AbortSignal;
4255
- /** Override env (defaults to inheriting from the parent). */
4256
- env?: NodeJS.ProcessEnv;
4257
- /**
4258
- * Test seam — inject a custom spawner so unit tests can mock the
4259
- * subprocess without touching the OS. Defaults to node's `child_process.spawn`.
4260
- */
4261
- spawn?: (command: string, args: ReadonlyArray<string>, opts: {
4262
- cwd: string;
4263
- env: NodeJS.ProcessEnv;
4264
- stdio: 'pipe';
4265
- detached: boolean;
4266
- }) => ChildProcess;
4267
- /** Test seam for locating the native Codex executable before it is staged in the worktree. */
4268
- resolveCodexExecutable?: (command: string, env: NodeJS.ProcessEnv) => Promise<string>;
4269
- }
4270
- /** @experimental */
4271
- interface LocalHarnessResult {
4272
- /** OS exit code. `null` when killed before exit. */
4273
- exitCode: number | null;
4274
- /** Concatenated stdout. */
4275
- stdout: string;
4276
- /** Concatenated stderr. */
4277
- stderr: string;
4278
- /** Set when the process exited via signal (timeout / abort). */
4279
- killedBySignal: NodeJS.Signals | null;
4280
- /** Wall-clock duration ms (spawn → exit). */
4281
- durationMs: number;
4282
- /** Set when timeoutMs elapsed before exit. */
4283
- timedOut: boolean;
4284
- /**
4285
- * Set when the caller's AbortSignal fired before this result settled.
4286
- * Optional so injected runners and stored results from older releases remain valid.
4287
- */
4288
- aborted?: boolean;
4289
- /** Present for a reproducible Codex run; parsed from the real terminal JSONL event. */
4290
- usage?: CodexTokenUsage;
4291
- /** Present for reproducible Codex runs; generated and checked before model execution. */
4292
- evidence?: CodexExecutionEvidence;
4293
- }
4294
- /**
4295
- * Spawn a local coding harness CLI as a subprocess + collect its output.
4296
- *
4297
- * NOT responsible for parsing the harness's output or extracting a diff —
4298
- * the in-process executor's `streamPrompt` orchestrates `git diff` against
4299
- * the worktree after this resolves. This function is intentionally narrow:
4300
- * spawn, wait, capture, return.
4301
- *
4302
- * Fails loud — throws when:
4303
- * - `cwd` doesn't exist (subprocess emits ENOENT; surfaced as Error)
4304
- * - the harness binary is not on PATH (ENOENT)
4305
- * - the caller signal was already aborted before process launch
4306
- *
4307
- * Does NOT throw when:
4308
- * - the subprocess exits non-zero (`result.exitCode` carries the code)
4309
- * - a non-reproducible subprocess is aborted / timed out (`result.aborted` /
4310
- * `result.timedOut` carries the reason even when a TERM-aware child exits zero)
4311
- *
4312
- * Reproducible Codex additionally requires a terminal usage event. If cancellation
4313
- * prevents that event, this rejects with `CodexExecutionDiagnosticError` instead of
4314
- * returning an incomplete reproducibility receipt.
4315
- *
4316
- * @experimental
4317
- */
4318
- declare function runLocalHarness(options: RunLocalHarnessOptions): Promise<LocalHarnessResult>;
4319
- //#endregion
4320
4114
  //#region src/mcp/worktree.d.ts
4321
- /** @experimental */
4322
- interface WorktreeHandle {
4323
- /** Absolute path to the worktree directory. */
4324
- path: string;
4325
- /** SHA the worktree was created at. */
4326
- baseSha: string;
4327
- /** Branch name created for this worktree (typically `delegate/<runId>`). */
4328
- branch: string;
4329
- }
4330
- /** @experimental */
4331
- interface CreateWorktreeOptions {
4332
- /** Absolute path to the main git checkout. */
4333
- repoRoot: string;
4334
- /** Unique id for the worktree path + branch. Use the delegation run id. */
4335
- runId: string;
4336
- /** Parent directory the worktree lives under. Defaults to `.agent-worktrees`. */
4337
- variantsDir?: string;
4338
- /** Override the base ref (default `HEAD`). */
4339
- baseRef?: string;
4340
- /** Test seam — inject a custom git runner. */
4341
- runGit?: GitRunner;
4342
- }
4343
- /** @experimental */
4344
- interface DiffOptions {
4345
- /** Worktree to diff. */
4346
- worktree: WorktreeHandle;
4347
- /** What to compare against. Default `worktree.baseSha`. */
4348
- baseRef?: string;
4349
- /**
4350
- * Repository-relative input paths to omit from the captured worker patch.
4351
- * Paths are passed to Git with literal exclusion magic, so profile-provided
4352
- * `*`, `?`, `[` and `:` characters can never expand into broader pathspecs.
4353
- */
4354
- excludePaths?: ReadonlyArray<string>;
4355
- /** Test seam. */
4356
- runGit?: GitRunner;
4357
- }
4358
- /** @experimental */
4359
- interface DiffResult {
4360
- patch: string;
4361
- stats: {
4362
- filesChanged: number;
4363
- insertions: number;
4364
- deletions: number;
4365
- };
4366
- }
4367
- /** @experimental */
4368
- interface RemoveWorktreeOptions {
4369
- worktree: WorktreeHandle;
4370
- repoRoot: string;
4371
- /** Force removal even if dirty (default true; the loser of a fanout has uncommitted changes). */
4372
- force?: boolean;
4373
- /** Test seam. */
4374
- runGit?: GitRunner;
4375
- }
4376
4115
  /** Pluggable git runner (sync) — replaceable in tests. */
4377
4116
  type GitRunner = (args: ReadonlyArray<string>, opts: {
4378
4117
  cwd: string;
@@ -4381,16 +4120,6 @@ type GitRunner = (args: ReadonlyArray<string>, opts: {
4381
4120
  stderr: string;
4382
4121
  exitCode: number;
4383
4122
  };
4384
- /** Checkout a fresh git worktree for a delegation run on a new branch under `variantsDir`. @experimental */
4385
- declare function createWorktree(options: CreateWorktreeOptions): Promise<WorktreeHandle>;
4386
- /** Stage worker changes and return the diff + shortstat, excluding declared input paths. @experimental */
4387
- declare function captureWorktreeDiff(options: DiffOptions): Promise<DiffResult>;
4388
- /**
4389
- * Remove a git worktree and delete its branch. Already-removed paths are harmless; every other
4390
- * Git failure rejects so callers cannot report a worktree as destroyed when cleanup failed.
4391
- * @experimental
4392
- */
4393
- declare function removeWorktree(options: RemoveWorktreeOptions): Promise<void>;
4394
4123
  //#endregion
4395
4124
  //#region src/mcp/worktree-harness.d.ts
4396
4125
  /** Outcome of one verification command run in the worktree (test or typecheck). */
@@ -4672,26 +4401,6 @@ interface OtelAttribute {
4672
4401
  boolValue?: boolean;
4673
4402
  };
4674
4403
  }
4675
- /**
4676
- * Create an exporter that APPENDS spans to a local OpenInference-JSONL file, one complete span per
4677
- * line, instead of posting them to a collector.
4678
- *
4679
- * Why this exists beside {@link createOtelExporter}: that one needs an OTLP endpoint, so a run on a
4680
- * laptop, in CI, or inside a sandbox with no collector emits nothing and its per-turn shape is
4681
- * simply lost. The journal records the TREE (who spawned whom, what settled, what it spent); it
4682
- * does not record what happened inside a turn. A run whose tree is readable but whose turns are not
4683
- * is exactly the state that made an observability gap invisible until someone went looking.
4684
- *
4685
- * The line shape is the one `@tangle-network/traces` reads (`spans.otlp.jsonl`) and is a standard
4686
- * OpenInference representation, so the same file feeds any OpenInference tool with no conversion:
4687
- * snake_case identity fields, ISO-8601 times, `parent_span_id` empty at the root, and attributes as
4688
- * a plain object rather than OTLP's key/value array.
4689
- *
4690
- * Appends synchronously per span so a killed process keeps every span it had already finished —
4691
- * matching the spawn journal's durability posture, since a trace that only survives a clean exit is
4692
- * useless for the runs you most want to look at.
4693
- */
4694
- declare function createOpenInferenceFileExporter(filePath: string): OtelExporter;
4695
4404
  /**
4696
4405
  * Create an OTLP/HTTP exporter. Returns undefined when no endpoint is configured.
4697
4406
  *
@@ -4699,7 +4408,7 @@ declare function createOpenInferenceFileExporter(filePath: string): OtelExporter
4699
4408
  * `maxQueueSize`. Every span ends in exactly one of `written` or `dropped`: a non-2xx response, a
4700
4409
  * network error, a timeout, an OTLP `partialSuccess.rejectedSpans` count and a full queue each count
4701
4410
  * as drops and set `lastError`. Nothing here throws into the caller's run; `flush()` reports the
4702
- * loss, the same rule {@link createOpenInferenceFileExporter} follows.
4411
+ * loss, the same rule `createOpenInferenceFileExporter` follows.
4703
4412
  */
4704
4413
  declare function createOtelExporter(config?: OtelExportConfig): OtelExporter | undefined;
4705
4414
  /**
@@ -4711,31 +4420,6 @@ declare function loopEventToOtelSpan(event: {
4711
4420
  timestamp: number;
4712
4421
  payload: object;
4713
4422
  }, traceId: string, parentSpanId?: string): OtelSpan;
4714
- interface RuntimeEventOtelOptions extends RuntimeTelemetryOptions {
4715
- /** Final customer redactor applied after the schema-aware runtime sanitizer. */
4716
- redact?: (value: unknown) => unknown;
4717
- }
4718
- /** Convert normalized runtime events into lossless, redacted child spans. */
4719
- declare function buildRuntimeEventOtelSpans(events: ReadonlyArray<RuntimeStreamEvent>, traceId: string, parentSpanId?: string, options?: RuntimeEventOtelOptions): OtelSpan[];
4720
- /**
4721
- * Sink-neutral node in a reconstructed loop span tree. The root node's
4722
- * `parentSpanId` is `undefined` — sinks decide how to parent it (the OTEL
4723
- * mapper attaches the inherited delegation span; the delegation journal
4724
- * leaves it as the tree root).
4725
- */
4726
- interface LoopSpanNode {
4727
- spanId: string;
4728
- parentSpanId?: string;
4729
- /** `'loop'` | `'loop.round'` | `'loop.iteration'`. */
4730
- name: string;
4731
- /** Topology level: loop root, plan round, or iteration branch. */
4732
- kind: 'loop' | 'round' | 'branch';
4733
- startMs: number;
4734
- endMs: number;
4735
- attrs: Record<string, string | number | boolean>;
4736
- /** True when the iteration carried an error — maps to OTEL status code 2. */
4737
- error: boolean;
4738
- }
4739
4423
  /**
4740
4424
  * Build a nested, real-duration OTLP span tree for ONE loop run from its full
4741
4425
  * ordered `LoopTraceEvent` stream. Unlike `loopEventToOtelSpan` (one flat,
@@ -4758,27 +4442,6 @@ declare function buildLoopOtelSpans(events: ReadonlyArray<{
4758
4442
  timestamp: number;
4759
4443
  payload: object;
4760
4444
  }>, traceId: string, rootParentSpanId?: string, redact?: (value: unknown) => unknown): OtelSpan[];
4761
- /**
4762
- * Sink-neutral core behind {@link buildLoopOtelSpans}: reconstruct the
4763
- * loop → round → branch span tree from one run's ordered `LoopTraceEvent`
4764
- * stream. Consumed by the OTEL mapper above and by the MCP delegation
4765
- * journal's compact trace tee — one topology reconstruction, two sinks.
4766
- * Tolerates partial streams (a run that never reached `loop.ended` closes
4767
- * at the last observed event's timestamp).
4768
- */
4769
- declare function buildLoopSpanNodes(events: ReadonlyArray<{
4770
- kind: string;
4771
- runId: string;
4772
- timestamp: number;
4773
- payload: object;
4774
- }>, redact?: (value: unknown) => unknown): LoopSpanNode[];
4775
- /**
4776
- * Convert a flat record into the OTLP attribute list. Non-finite numbers are DROPPED (an OTLP
4777
- * `doubleValue` of `NaN`/`Infinity` is not representable), integers ride as `intValue`. Exported so
4778
- * a producer that mints its own `OtelSpan` (the supervisor span recorder) builds attributes exactly
4779
- * the way every span in this file does, rather than re-deriving the encoding.
4780
- */
4781
- declare function toOtelAttributes(record: Record<string, string | number | boolean>): OtelAttribute[];
4782
4445
  /**
4783
4446
  * Map a caller-supplied span id onto the 16-hex OTLP encoding. An id that is already a valid W3C
4784
4447
  * span id passes through UNCHANGED — that is what lets an inherited `PARENT_SPAN_ID`/`TRACEPARENT`
@@ -4796,10 +4459,6 @@ declare function padSpanId(id: string): string;
4796
4459
  * UUID-form, preserving the pre-strict-W3C wire id), everything else is derived with
4797
4460
  * `deriveHexId(id, 16)` so every process derives the SAME wire id for the same run. */
4798
4461
  declare function padTraceId(id: string): string;
4799
- /** Mint a fresh 16-hex-character OTLP span id. Exported so a producer that must know a span's id
4800
- * BEFORE the span closes (a node opened at spawn and parented by its children) uses this one
4801
- * generator instead of a second copy of it. */
4802
- declare function generateSpanId(): string;
4803
4462
  //#endregion
4804
4463
  //#region src/runtime/sandbox-evidence-retention.d.ts
4805
4464
  /** One durable capture before a Sandbox box is removed. */
@@ -4838,13 +4497,6 @@ interface SandboxEvidenceReceipt {
4838
4497
  readonly coverageComplete: boolean;
4839
4498
  readonly incompleteReason?: string;
4840
4499
  }
4841
- /** A failed capture keeps the live source handle available for an explicit retry. */
4842
- declare class SandboxEvidenceRetentionError extends Error {
4843
- readonly box: SandboxInstance;
4844
- constructor(box: SandboxInstance, cause: unknown);
4845
- }
4846
- /** Capture, verify, durably record, then destroy. A failure leaves the source intact. */
4847
- declare function captureBeforeDestroy(port: SandboxEvidenceRetentionPort, context: SandboxEvidenceContext, destroy: () => Promise<void>): Promise<SandboxEvidenceReceipt>;
4848
4500
  //#endregion
4849
4501
  //#region src/runtime/agent-rounds.d.ts
4850
4502
  /** @stable */
@@ -5232,8 +4884,6 @@ interface RunCodeModeOptions extends CodeModeOptions {
5232
4884
  /** An explicit snapshot from the caller's existing state owner. */
5233
4885
  readonly store?: CodeModeStore;
5234
4886
  }
5235
- /** Render the same tool descriptors that are executed, including their result schemas. */
5236
- declare function describeCodeModeTools(tools: ReadonlyArray<CodeModeTool>, query?: string): Promise<string>;
5237
4887
  /**
5238
4888
  * Execute a JS async-function body against Runtime capabilities. The upstream
5239
4889
  * QuickJS/WASM worker is the boundary; there is no node:vm or unsafe fallback.
@@ -5615,8 +5265,6 @@ interface CoderTask {
5615
5265
  /** Default 400. Hard cap; the gate hard-fails when exceeded. */
5616
5266
  maxDiffLines?: number;
5617
5267
  }
5618
- /** Render a `CoderTask` into the per-task instruction handed to the coder profile. @experimental */
5619
- declare function coderTaskToPrompt(task: CoderTask): string;
5620
5268
  //#endregion
5621
5269
  //#region src/mcp/detached-coder.d.ts
5622
5270
  /** @experimental The structured coder result the sandbox-session path decodes + gates. */
@@ -5664,21 +5312,6 @@ interface DelegationStore {
5664
5312
  /** Delete the named records — the retention-cap eviction path. */
5665
5313
  remove(taskIds: readonly string[]): Promise<void>;
5666
5314
  }
5667
- /**
5668
- * The persisted delegation state exists but cannot be parsed into
5669
- * records. Fail loud: silently starting empty over a corrupt journal
5670
- * would erase delegation history and re-run idempotent work. Opt into
5671
- * recovery explicitly via `FileDelegationStoreOptions.recoverCorrupt`
5672
- * (the bin maps `AGENT_RUNTIME_DELEGATION_STATE_RECOVER=1` onto it),
5673
- * which archives the corrupt file and starts fresh.
5674
- *
5675
- * @stable
5676
- */
5677
- declare class DelegationStateCorruptError extends AgentEvalError$1 {
5678
- constructor(message: string, options?: {
5679
- cause?: unknown;
5680
- });
5681
- }
5682
5315
  /**
5683
5316
  * A delegation-store read or write failed (filesystem error, store
5684
5317
  * called before `loadAll`, ...). Once the queue observes one, it stops
@@ -5692,14 +5325,6 @@ declare class DelegationPersistenceError extends AgentEvalError$1 {
5692
5325
  cause?: unknown;
5693
5326
  });
5694
5327
  }
5695
- /** In-memory `DelegationStore` — suitable for single-process use and tests. @stable */
5696
- declare class InMemoryDelegationStore implements DelegationStore {
5697
- private readonly records;
5698
- loadAll(): Promise<DelegationRecord[]>;
5699
- upsert(record: DelegationRecord): Promise<void>;
5700
- lookupIdempotencyKey(key: string): Promise<string | undefined>;
5701
- remove(taskIds: readonly string[]): Promise<void>;
5702
- }
5703
5328
  /** @stable */
5704
5329
  interface FileDelegationStoreOptions {
5705
5330
  /** Absolute path of the JSON state file. Parent directories are created on first write. */
@@ -5763,59 +5388,6 @@ interface DelegationTraceSpan {
5763
5388
  endMs: number;
5764
5389
  meta?: Record<string, string | number | boolean>;
5765
5390
  }
5766
- /** Default cap on spans retained per delegation record. @experimental */
5767
- declare const DELEGATION_TRACE_MAX_SPANS = 512;
5768
- /** Default cap on the serialized trace payload per record, in bytes. @experimental */
5769
- declare const DELEGATION_TRACE_MAX_BYTES: number;
5770
- /** @experimental */
5771
- interface DelegationTraceCaps {
5772
- /** Default {@link DELEGATION_TRACE_MAX_SPANS}. */
5773
- maxSpans?: number;
5774
- /** Default {@link DELEGATION_TRACE_MAX_BYTES}. Approximate — measured as the
5775
- * sum of per-span `JSON.stringify` lengths. */
5776
- maxBytes?: number;
5777
- }
5778
- /** @experimental */
5779
- interface CappedDelegationTrace {
5780
- trace: DelegationTraceSpan[];
5781
- /** True when oldest spans were dropped to honor the caps. */
5782
- truncated: boolean;
5783
- }
5784
- /**
5785
- * Derive the compact span tree for ONE loop run from its buffered
5786
- * `LoopTraceEvent` stream. Same reconstruction as the OTEL exporter
5787
- * ({@link buildLoopSpanNodes}); tolerates partial streams.
5788
- *
5789
- * @experimental
5790
- */
5791
- declare function buildDelegationTraceSpans(events: ReadonlyArray<LoopTraceEvent>): DelegationTraceSpan[];
5792
- /**
5793
- * Enforce the trace caps over an ordered (oldest-first) span list. Drops the
5794
- * OLDEST spans first and reports `truncated: true` when anything was dropped;
5795
- * the newest span always survives, so a non-empty input never caps to empty.
5796
- * Dropping a parent may orphan surviving children's `parentSpanId` references
5797
- * — acceptable for the flat journal shape; consumers treat unresolved parents
5798
- * as roots.
5799
- *
5800
- * @experimental
5801
- */
5802
- declare function capDelegationTrace(spans: ReadonlyArray<DelegationTraceSpan>, caps?: DelegationTraceCaps): CappedDelegationTrace;
5803
- /**
5804
- * Per-delegation trace collector. Buffers `LoopTraceEvent`s per runId
5805
- * (mirroring the OTEL emitter's buffering) and hands the derived compact
5806
- * spans to `onSpans` when a run reaches `loop.ended`. `settle()` drains runs
5807
- * that never ended — a hard-aborted loop still leaves its partial tree in the
5808
- * journal, unlike the OTEL path which drops it.
5809
- *
5810
- * @experimental
5811
- */
5812
- interface DelegationTraceCollector {
5813
- emitter: LoopTraceEmitter;
5814
- /** Flush buffered events of runs that never reached `loop.ended`. */
5815
- settle(): void;
5816
- }
5817
- /** Build a `DelegationTraceCollector` that buffers loop-trace events and converts them to spans on settle. @experimental */
5818
- declare function createDelegationTraceCollector(onSpans: (spans: DelegationTraceSpan[]) => void): DelegationTraceCollector;
5819
5391
  /**
5820
5392
  * Fan one `LoopTraceEvent` stream into several emitters — e.g. the
5821
5393
  * process-wide OTEL exporter AND the per-delegation journal collector.
@@ -5855,29 +5427,6 @@ declare function createPropagatingTraceEmitter(ctx: TraceContext): {
5855
5427
  exporter: OtelExporter | undefined;
5856
5428
  context: TraceContext;
5857
5429
  };
5858
- /**
5859
- * Build env vars to pass to a child subprocess so it inherits the current trace context.
5860
- *
5861
- * Writes BOTH conventions (see the module doc): `TRACEPARENT` carries the W3C-hex ids — mapped
5862
- * through the exporter's own `padTraceId`/`padSpanId` (dashed hex passes through dash-stripped, a
5863
- * human id is derived through the contract's `deriveHexId`), the SAME normalization every emitted
5864
- * span uses, so both spellings and the parent's own spans all name ONE trace — and the legacy
5865
- * pair carries the caller's ids verbatim. `TRACEPARENT` needs a parent span id by grammar; when
5866
- * the context has none, the legacy pair still propagates the trace id alone.
5867
- */
5868
- declare function traceContextToEnv(ctx: TraceContext): Record<string, string>;
5869
- /**
5870
- * Merge a spawned child's environment from lowest to highest precedence — ambient env, the
5871
- * recorder's stamped trace env, the caller's own overrides — while keeping the ONE cross-key
5872
- * invariant a plain spread cannot: `TRACEPARENT` and the legacy pair must name the SAME trace.
5873
- * A caller override that declares `TRACE_ID` / `PARENT_SPAN_ID` without its own `TRACEPARENT`
5874
- * would otherwise keep the recorder's W3C wire — the child would join the caller's trace on the
5875
- * legacy pair and the RECORDER's on the standard one. The dual-write is performed on the
5876
- * caller's behalf: the merged `TRACEPARENT` is rebuilt from the merged legacy pair through the
5877
- * same {@link traceContextToEnv} derivation (`deriveHexId` for human ids), or dropped when no
5878
- * parent span id survives the merge (the W3C grammar requires one).
5879
- */
5880
- declare function mergeTraceEnv(ambient: Record<string, string | undefined>, traceEnv: Record<string, string>, overrides?: Record<string, string>): Record<string, string | undefined>;
5881
5430
  //#endregion
5882
5431
  //#region src/profiles/researcher.d.ts
5883
5432
  /** Source families a researcher profile may prefer for a task. One owner: the delegation
@@ -5998,51 +5547,6 @@ declare function researcherProfile(options: ResearcherProfileOptions & {
5998
5547
  validator: Validator<ResearchOutput>;
5999
5548
  agentRunSpec: AgentRunSpec<ResearchTask>;
6000
5549
  };
6001
- /** @experimental */
6002
- interface MultiHarnessResearcherFanoutOptions {
6003
- /** Exact execution profiles, one per parallel researcher. */
6004
- profiles: ReadonlyArray<AgentProfile>;
6005
- /** Default citation density floor for the shared validator. */
6006
- citationDensityMin?: number;
6007
- /** Optional task — narrows the validator's namespace check. */
6008
- task?: ResearchTask;
6009
- }
6010
- /**
6011
- * Build a fanout topology over multiple harnesses. The kernel round-robins
6012
- * `agentRuns` across the N parallel iterations and the `FanoutVote` driver
6013
- * picks the highest-scoring valid output.
6014
- *
6015
- * @experimental
6016
- */
6017
- declare function multiHarnessResearcherFanout(options: MultiHarnessResearcherFanoutOptions): {
6018
- agentRuns: AgentRunSpec<ResearchTask>[];
6019
- output: OutputAdapter<ResearchOutput>;
6020
- validator: Validator<ResearchOutput>;
6021
- driver: Driver<ResearchTask, ResearchOutput, 'done'>;
6022
- };
6023
- /**
6024
- * Build a validator that closes over a specific `ResearchTask`'s constraints.
6025
- *
6026
- * Checks in order:
6027
- * 1. Items must be non-empty.
6028
- * 2. Every item carries `evidence.length >= 1`.
6029
- * 3. Every item + proposedWrite is scoped to `task.knowledgeNamespace`
6030
- * (hard-fail on any namespace mismatch — defence in depth for the
6031
- * multi-tenant invariant).
6032
- * 4. Citation density (citations with quote / items) >= floor.
6033
- *
6034
- * Aggregate score:
6035
- * 0.4 · citation_density
6036
- * + 0.2 · source_diversity (distinct sources / max(items, 1))
6037
- * + 0.2 · recency_match (mean fraction within `recencyWindow`)
6038
- * + 0.2 · (1 − gaps/maxGaps), maxGaps = max(items, 1)
6039
- *
6040
- * @experimental
6041
- */
6042
- declare function createResearcherValidator(task: ResearchTask, config?: {
6043
- citationDensityMin?: number;
6044
- namespaceCheck?: boolean;
6045
- }): Validator<ResearchOutput>;
6046
5550
  //#endregion
6047
5551
  //#region src/profiles/ui-auditor/substrate.d.ts
6048
5552
  /**
@@ -6065,8 +5569,6 @@ declare function createResearcherValidator(task: ResearchTask, config?: {
6065
5569
  * under a generic label.
6066
5570
  */
6067
5571
  type UiLens = 'consistency' | 'hierarchy' | 'layout' | 'ux-flow' | 'duplication' | 'accessibility' | 'responsive' | 'states' | 'content' | 'interaction' | 'performance-perceived' | 'other';
6068
- /** Frozen tuple of lenses for validation + iteration. */
6069
- declare const UI_LENSES: readonly UiLens[];
6070
5572
  /**
6071
5573
  * Severity scale.
6072
5574
  * - `critical` — blocks a core task or is an accessibility blocker.
@@ -6075,8 +5577,6 @@ declare const UI_LENSES: readonly UiLens[];
6075
5577
  * - `low` — nitpick worth fixing eventually.
6076
5578
  */
6077
5579
  type UiFindingSeverity = 'low' | 'med' | 'high' | 'critical';
6078
- /** Frozen severity tuple, ordered worst → least bad for sort/report. */
6079
- declare const UI_FINDING_SEVERITIES: readonly UiFindingSeverity[];
6080
5580
  /** Pointer to a screenshot referenced by a finding (workspace-relative path). */
6081
5581
  interface UiFindingScreenshot {
6082
5582
  path: string;
@@ -6166,12 +5666,6 @@ interface DelegateCodeArgs {
6166
5666
  namespace?: string;
6167
5667
  }
6168
5668
  /** @experimental */
6169
- interface DelegateCodeResult {
6170
- taskId: string;
6171
- /** Best-effort hint — coder loops can take minutes-to-hours. */
6172
- estimatedDurationMs?: number;
6173
- }
6174
- /** @experimental */
6175
5669
  interface DelegateResearchConfig {
6176
5670
  recencyWindow?: {
6177
5671
  since?: string;
@@ -6190,11 +5684,6 @@ interface DelegateResearchArgs {
6190
5684
  config?: DelegateResearchConfig;
6191
5685
  }
6192
5686
  /** @experimental */
6193
- interface DelegateResearchResult {
6194
- taskId: string;
6195
- estimatedDurationMs?: number;
6196
- }
6197
- /** @experimental */
6198
5687
  interface FeedbackRefersTo {
6199
5688
  kind: 'delegation' | 'artifact' | 'outcome';
6200
5689
  /** For `'delegation'`, this is the taskId. */
@@ -6217,22 +5706,6 @@ interface DelegateFeedbackArgs {
6217
5706
  namespace?: string;
6218
5707
  }
6219
5708
  /** @experimental */
6220
- interface DelegateFeedbackResult {
6221
- recorded: true;
6222
- id: string;
6223
- }
6224
- /** @experimental */
6225
- interface DelegationStatusArgs {
6226
- taskId: string;
6227
- /**
6228
- * Return the delegation's compact loop-trace span tree alongside the
6229
- * status. Default false — status polls stay light; opt in when you need
6230
- * the topology (which iterations ran, where they were placed, what each
6231
- * cost) rather than just the state machine.
6232
- */
6233
- includeTrace?: boolean;
6234
- }
6235
- /** @experimental */
6236
5709
  interface DelegationProgress {
6237
5710
  iteration: number;
6238
5711
  phase: string;
@@ -6317,11 +5790,6 @@ interface DelegateUiAuditArgs {
6317
5790
  namespace?: string;
6318
5791
  config?: DelegateUiAuditConfig;
6319
5792
  }
6320
- /** @experimental */
6321
- interface DelegateUiAuditResult {
6322
- taskId: string;
6323
- estimatedDurationMs?: number;
6324
- }
6325
5793
  /**
6326
5794
  * Provider-neutral research output carried over the MCP boundary. The MCP
6327
5795
  * layer accepts this structural shape instead of coupling its wire contract to
@@ -6395,10 +5863,6 @@ interface DelegationHistoryEntry {
6395
5863
  /** Inherited trace identity recorded at submit — join key into the caller's trace. */
6396
5864
  traceId?: string;
6397
5865
  }
6398
- /** @experimental */
6399
- interface DelegationHistoryResult {
6400
- delegations: DelegationHistoryEntry[];
6401
- }
6402
5866
  //#endregion
6403
5867
  //#region src/mcp/task-queue.d.ts
6404
5868
  /** Arguments accepted by the durable delegation queue. @stable */
@@ -6675,73 +6139,8 @@ declare class DelegationTaskQueue {
6675
6139
  private failPersistence;
6676
6140
  private enforceRetention;
6677
6141
  }
6678
- /**
6679
- * Best-effort stable hash for use as `idempotencyKey`. Not cryptographic;
6680
- * collisions only affect dedupe, never correctness.
6681
- *
6682
- * @stable
6683
- */
6684
- declare function hashIdempotencyInput(value: unknown): string;
6685
6142
  //#endregion
6686
6143
  //#region src/mcp/detached-turn.d.ts
6687
- /**
6688
- * Structural mirror of the sandbox SDK's `TurnDriveResult` (>= 0.6).
6689
- * Discriminated on `state`; `failed` is terminal and deterministic per the
6690
- * SDK contract — re-invoking with the same ids returns the same outcome.
6691
- *
6692
- * @experimental
6693
- */
6694
- type DriveTurnTick = {
6695
- state: 'completed';
6696
- text: string;
6697
- result: Record<string, unknown>;
6698
- } | {
6699
- state: 'running';
6700
- startedAt?: Date;
6701
- elapsedMs?: number;
6702
- } | {
6703
- state: 'failed';
6704
- error: string;
6705
- };
6706
- /**
6707
- * The box surface detached turns need. `SandboxInstance`
6708
- * (`@tangle-network/sandbox` >= 0.6) satisfies it structurally; tests pass
6709
- * in-memory fakes. `_sessionCancel` is the SDK's remote-cancellation surface —
6710
- * optional here because older SDKs / fakes may not expose it; when present it
6711
- * is invoked on abort so the remote run actually stops.
6712
- *
6713
- * @experimental
6714
- */
6715
- interface DriveTurnCapableBox {
6716
- driveTurn(message: string, opts: {
6717
- sessionId: string;
6718
- turnId?: string;
6719
- wallCapMs?: number;
6720
- }): Promise<DriveTurnTick>;
6721
- _sessionCancel?(id: string): Promise<void>;
6722
- }
6723
- /**
6724
- * Decoded `DelegationRecord.detachedSessionRef`. `sandboxId` is absent between
6725
- * submit and box acquisition — a record restored in that window is not
6726
- * resumable (there is no box to resume on) and the resume driver fails it
6727
- * loud rather than dispatching onto a guessed box.
6728
- *
6729
- * @experimental
6730
- */
6731
- interface DetachedSessionRefParts {
6732
- sessionId: string;
6733
- sandboxId?: string;
6734
- }
6735
- /**
6736
- * Encode ref parts into the JSON-safe string stored on the record:
6737
- * `session=<id>` before the box exists, `sandbox=<id>;session=<id>` once
6738
- * bound. Ids must not contain the `;`/`=` delimiters.
6739
- *
6740
- * @experimental
6741
- */
6742
- declare function formatDetachedSessionRef(parts: DetachedSessionRefParts): string;
6743
- /** Parse a `detachedSessionRef` string back to parts; throws `ValidationError` on malformed input. @experimental */
6744
- declare function parseDetachedSessionRef(raw: string): DetachedSessionRefParts;
6745
6144
  /** @experimental The terminal payload of a finished detached turn. */
6746
6145
  interface DetachedTurn {
6747
6146
  /** Final assistant text. */
@@ -6749,15 +6148,6 @@ interface DetachedTurn {
6749
6148
  /** The SDK's cached AgentExecutionResult-shape record for the turn. */
6750
6149
  result: Record<string, unknown>;
6751
6150
  }
6752
- /**
6753
- * Synthesize the terminal event array a detached turn settles through. Shaped
6754
- * so the existing event-stream output adapters (coder, researcher) parse it:
6755
- * `data.result` for adapters that read a structured terminal record, `data.text`
6756
- * for adapters that scan assistant text for the fenced result block.
6757
- *
6758
- * @experimental
6759
- */
6760
- declare function detachedTurnEvents(sessionId: string, turn: DetachedTurn): SandboxEvent[];
6761
6151
  /** @experimental */
6762
6152
  interface RunDetachedTurnOptions {
6763
6153
  /** Sandbox client used to acquire the box (the delegate's executor client). */
@@ -6804,55 +6194,6 @@ interface RunDetachedTurnOptions {
6804
6194
  * @experimental
6805
6195
  */
6806
6196
  declare function runDetachedTurn(options: RunDetachedTurnOptions): Promise<DetachedTurn>;
6807
- /** @experimental */
6808
- interface DetachedTurnResumeDriverOptions {
6809
- /**
6810
- * Resolve the live box owning a detached session. The bin wires this to the
6811
- * sandbox client's `get(sandboxId)`; throw when the box no longer exists —
6812
- * a thrown tick settles the record as failed, which is the truth.
6813
- */
6814
- resolveSandbox(sandboxId: string): Promise<DriveTurnCapableBox>;
6815
- /**
6816
- * Rebuild the turn prompt from the persisted record. Only consumed by
6817
- * `driveTurn`'s dispatch leg — i.e. when the previous process died after
6818
- * binding the box but before the session was dispatched. Must reproduce the
6819
- * prompt the delegate would have sent.
6820
- */
6821
- buildMessage(record: DelegationRecord): string;
6822
- /**
6823
- * Map a completed turn onto the delegation's typed output payload (parse +
6824
- * validate per profile). Throw when the resumed result does not pass the
6825
- * profile's gate — the queue settles the record as failed with that error.
6826
- */
6827
- settleOutput(turn: DetachedTurn, record: DelegationRecord, ctx: {
6828
- signal: AbortSignal;
6829
- }): Promise<DelegationResultPayload['output']> | DelegationResultPayload['output'];
6830
- /** Delay between `running` ticks (ms). Default 5000. */
6831
- intervalMs?: number;
6832
- /** Wall-clock cap forwarded to `driveTurn` on every tick. */
6833
- wallCapMs?: number;
6834
- }
6835
- /**
6836
- * Build the `driveTurn`-backed {@link DelegationResumeDriver}. Each `tick()`
6837
- * is one settle/poll/dispatch pass:
6838
- *
6839
- * - ref without a sandbox binding → `failed` (`DetachedSessionUnboundError`):
6840
- * the previous process died before a box existed; there is nothing to resume.
6841
- * - `driveTurn` `completed` → `settleOutput` → `completed` tick.
6842
- * - `running` → progress via `ctx.report`, `running` tick (queue re-ticks
6843
- * after `intervalMs`).
6844
- * - `failed` → `failed` tick (`DetachedTurnFailedError`) — terminal per the
6845
- * SDK's deterministic-failure contract.
6846
- *
6847
- * Abort: the queue stops ticking once `cancel()` flips the record, so remote
6848
- * cancellation is hooked onto `ctx.signal` (once per task) and fires
6849
- * `_sessionCancel` when the SDK surface exposes it. The driver never deletes
6850
- * boxes — it cannot know whether `sandboxId` is a disposable sibling or a
6851
- * fleet machine, and destroying a fleet machine would be unrecoverable.
6852
- *
6853
- * @experimental
6854
- */
6855
- declare function createDetachedTurnResumeDriver(options: DetachedTurnResumeDriverOptions): DelegationResumeDriver;
6856
6197
  //#endregion
6857
6198
  //#region src/mcp/executor.d.ts
6858
6199
  /** @experimental */
@@ -7061,40 +6402,6 @@ interface DetachedSessionDelegateOptions {
7061
6402
  * @experimental
7062
6403
  */
7063
6404
  declare function detachedSessionDelegate(options: DetachedSessionDelegateOptions): CoderDelegate;
7064
- /**
7065
- * Canonical `DelegateCodeArgs` → `CoderTask` mapping — the single source for
7066
- * the delegate's live dispatch AND the resume driver's settle/message
7067
- * rebuilding, so a resumed record reproduces exactly the task the original
7068
- * process dispatched.
7069
- *
7070
- * @experimental
7071
- */
7072
- declare function coderTaskFromArgs(args: DelegateCodeArgs): CoderTask;
7073
- /** @experimental */
7074
- interface SettleDetachedCoderTurnOptions {
7075
- task: CoderTask;
7076
- /** Session id of the detached turn — used as the synthesized event id. */
7077
- sessionId: string;
7078
- signal: AbortSignal;
7079
- /** Same gate as the streaming path: an unapproved candidate cannot win. */
7080
- reviewer?: CoderReviewer;
7081
- }
7082
- /**
7083
- * Settle a completed detached coder turn through the same gate the streaming
7084
- * path applies: parse the terminal payload with the coder output adapter,
7085
- * run the mechanical validator (tests/typecheck/forbidden/diff/no-op/secrets),
7086
- * then the optional reviewer. Throws when nothing survives — a resumed or
7087
- * detached run must not return an unvalidated patch.
7088
- *
7089
- * SCOPE NOTE (detached/resume): the detached `driveTurn`-tick + cross-restart resume path is
7090
- * bound to the `runAgentRounds` + sandbox-session substrate. The recursive `Scope`/worktree-CLI leaf has
7091
- * journal→replay but no driveTurn-over-a-detached-sandbox-session equivalent yet, so resume is NOT
7092
- * advertised on the generic `worktreeFanout` path. This helper (with `coderTaskFromArgs` and
7093
- * `createDetachedTurnResumeDriver`) stays as the resume seam `bin.ts` wires for in-flight records.
7094
- *
7095
- * @experimental
7096
- */
7097
- declare function settleDetachedCoderTurn(turn: DetachedTurn, options: SettleDetachedCoderTurnOptions): Promise<CoderOutput>;
7098
6405
  //#endregion
7099
6406
  //#region src/mcp/feedback-store.d.ts
7100
6407
  /** @stable */
@@ -7119,22 +6426,6 @@ interface FeedbackStore {
7119
6426
  refersToRef?: string;
7120
6427
  }): Promise<FeedbackEvent[]>;
7121
6428
  }
7122
- /** In-memory `FeedbackStore` — suitable for single-process use and tests. @stable */
7123
- declare class InMemoryFeedbackStore implements FeedbackStore {
7124
- private readonly events;
7125
- put(event: FeedbackEvent): Promise<void>;
7126
- list(filter?: {
7127
- namespace?: string;
7128
- refersToRef?: string;
7129
- }): Promise<FeedbackEvent[]>;
7130
- }
7131
- /**
7132
- * Project a `FeedbackEvent` down to the snapshot shape carried on
7133
- * `delegation_history` entries.
7134
- *
7135
- * @stable
7136
- */
7137
- declare function eventToSnapshot(event: FeedbackEvent): DelegationFeedbackSnapshot;
7138
6429
  //#endregion
7139
6430
  //#region src/runtime/tool-loop.d.ts
7140
6431
  /** Provider-neutral conversation record accepted by a tool-loop brain. */
@@ -7352,32 +6643,6 @@ interface SandboxServedBackend {
7352
6643
  readonly model?: string;
7353
6644
  readonly source?: string;
7354
6645
  }
7355
- /**
7356
- * Read the served execution identity off one Sandbox event.
7357
- *
7358
- * The platform reports `effectiveBackend` on `execution.started` and again on the terminal
7359
- * event (`@tangle-network/sandbox`, `EffectiveBackend`). Absence returns `undefined`
7360
- * and must stay unknown — a request is not a receipt, so nothing here may be inferred from
7361
- * what was asked for.
7362
- */
7363
- declare function sandboxEventServedBackend(event: SandboxEvent): SandboxServedBackend | undefined;
7364
- /**
7365
- * Fail the execution when the platform reports serving a model other than the exact one asked for.
7366
- *
7367
- * Measured motive (agent-runtime#892, live infrastructure 2026-08-17): 6 of 6 boxes whose profile
7368
- * declared `zai-coding-plan/glm-5.2` reported
7369
- * `{"provider":"openai-compat","model":"deepseek/deepseek-v4-flash","source":"environment"}`,
7370
- * while the materialization receipt recorded the declared model as `status: "known"`. Sending
7371
- * `backend.model` makes that substitution unlikely; only reading the report back makes it
7372
- * detectable. A run that cannot say which model produced its evidence must not settle as one
7373
- * that can.
7374
- *
7375
- * Silent when the platform reports no served model: unobserved stays unobserved.
7376
- */
7377
- declare function assertSandboxServedModel(event: SandboxEvent, expected: {
7378
- readonly provider?: string;
7379
- readonly model?: string;
7380
- } | undefined): void;
7381
6646
  /**
7382
6647
  * Extract a `RuntimeStreamEvent`-shaped `llm_call` from a sandbox event when
7383
6648
  * the event carries usage/cost data. Returns `undefined` for non-cost events
@@ -7434,9 +6699,6 @@ interface SandboxUsageLedger {
7434
6699
  type: 'llm_call';
7435
6700
  }) | undefined;
7436
6701
  }
7437
- /** A {@link SandboxUsageLedger} for one worker. Pass the worker's harness to decode with that
7438
- * harness's adapter; omit it to try every registered adapter. */
7439
- declare function createSandboxUsageLedger(harness?: HarnessType): SandboxUsageLedger;
7440
6702
  /**
7441
6703
  * Sum the token usage + USD cost of a sandbox turn's events — the one honest way to meter an
7442
6704
  * `openSandboxRun` cell. Folds a {@link SandboxUsageLedger} over the stream, so it reads usage off
@@ -7548,20 +6810,6 @@ declare function mapSandboxToolEvent(event: SandboxEvent, state: SandboxToolPart
7548
6810
  declare function mapSandboxEvent(event: SandboxEvent, opts?: {
7549
6811
  agentRunName?: string;
7550
6812
  }): RuntimeStreamEvent | undefined;
7551
- /**
7552
- * Project one `SandboxEvent` onto Runtime's executor progress vocabulary: incremental text and
7553
- * reasoning, tool calls and results, and an interaction request. It composes the existing
7554
- * projections ({@link mapSandboxEvent}, {@link mapSandboxToolEvent}, and the canonical Agent
7555
- * Interface decode) so every sandbox-shaped executor publishes live output through one reader.
7556
- * Usage-bearing events project to nothing here — accounting stays on the `tokens`/`cost`
7557
- * channels.
7558
- *
7559
- * Pass one {@link SandboxToolPartState} per turn so a multi-frame tool call yields one call and
7560
- * at most one result.
7561
- *
7562
- * @experimental
7563
- */
7564
- declare function sandboxProgressEvents(event: SandboxEvent, state: SandboxToolPartState): ExecutorProgressEvent[];
7565
6813
  /**
7566
6814
  * What a settled turn produced, as an explicit marker.
7567
6815
  *
@@ -7769,17 +7017,6 @@ interface BridgeModelCredential {
7769
7017
  provider: KeyProvider;
7770
7018
  }
7771
7019
  //#endregion
7772
- //#region src/runtime/supervise/cli-executor-factories.d.ts
7773
- /** Executor factory for a CLI harness that runs in a git worktree of the caller's checkout. */
7774
- declare const cliWorktreeExecutor: ExecutorFactory<unknown>;
7775
- /**
7776
- * The leaf `createInPlaceCliExecutor` as a backend-as-data factory: a supervisor-authored
7777
- * `AgentProfile` driving a local coding CLI in the workspace the caller supplied, so its edits are
7778
- * still there for the next spawn. `budgetExempt` like the other CLI leaves; the authored
7779
- * systemPrompt + model reach the harness via §1.5.
7780
- */
7781
- declare const cliInPlaceExecutor: ExecutorFactory<unknown>;
7782
- //#endregion
7783
7020
  //#region src/runtime/provider-placement.d.ts
7784
7021
  /** Caller-declared execution placement. Matching never changes the authored profile.
7785
7022
  * @experimental */
@@ -7957,41 +7194,6 @@ declare const ROUTER_CLIENT_HEADER = "x-tangle-client";
7957
7194
  * a new record: the row whose `clientName` is `agent-runtime-node/<nodeId>` is that node's spend.
7958
7195
  */
7959
7196
  declare function sharedWorkerClientName(nodeId: string): string;
7960
- /** The Sandbox box surface a shared box uses. The Sandbox SDK's `SandboxInstance` satisfies it. */
7961
- interface SharedBoxHandle {
7962
- readonly id: string;
7963
- exec(command: string, options?: {
7964
- timeoutMs?: number;
7965
- }): Promise<{
7966
- exitCode?: number | null;
7967
- stdout?: string;
7968
- stderr?: string;
7969
- }>;
7970
- readonly fs: {
7971
- read(path: string): Promise<string>;
7972
- write(path: string, content: string): Promise<unknown>;
7973
- };
7974
- readonly process: {
7975
- spawnExact(executable: string, args: readonly string[], options?: {
7976
- cwd?: string;
7977
- env?: Record<string, string>;
7978
- timeoutMs?: number;
7979
- }): Promise<SharedBoxProcess>;
7980
- list(): Promise<ReadonlyArray<{
7981
- pid: number;
7982
- command?: string;
7983
- cwd?: string;
7984
- }>>;
7985
- get(pid: number): Promise<SharedBoxProcess | null>;
7986
- };
7987
- delete(): Promise<unknown>;
7988
- }
7989
- /** One process in a shared box, as the Sandbox SDK's process manager returns it. */
7990
- interface SharedBoxProcess extends Pick<Process, 'pid' | 'wait' | 'stdout' | 'stderr'> {
7991
- kill(signal?: 'SIGTERM' | 'SIGKILL', options?: {
7992
- tree?: boolean;
7993
- }): Promise<void>;
7994
- }
7995
7197
  /**
7996
7198
  * Why a shared box cannot carry `profile`, or `undefined` when it can.
7997
7199
  *
@@ -8102,20 +7304,6 @@ interface SharedBoxPlacement {
8102
7304
  declare function sharedBoxPlacement(options: SharedBoxPlacementOptions): SharedBoxPlacement;
8103
7305
  //#endregion
8104
7306
  //#region src/runtime/supervise/inbox.d.ts
8105
- /** The one terminal answer an inbox gives the sender of a message. `messageId` is the wire
8106
- * `messageId` when the sender named one. `closed` failures come from {@link Inbox.failPending};
8107
- * a holder that can still reach the recipient another way (a manager's durable lead queue) may
8108
- * re-route on that cause instead of reporting the failure. */
8109
- type InboxReceipt = {
8110
- readonly status: 'consumed';
8111
- readonly messageId: string;
8112
- readonly attemptId: string;
8113
- } | {
8114
- readonly status: 'failed';
8115
- readonly messageId: string;
8116
- readonly reason: string;
8117
- readonly cause: 'closed' | 'promoted-attempt-failed';
8118
- };
8119
7307
  /** A message from the run's AUTHORITY — the parent driver. These two kinds carry instruction. */
8120
7308
  interface AuthorityInboxMessage {
8121
7309
  /** The sender's `messageId`, or one minted on arrival. What {@link InboxLease.commit} names. */
@@ -8526,33 +7714,6 @@ declare function createExecutor(config: ExecutorConfig): ExecutorFactory<unknown
8526
7714
  declare function createExecutorRegistry(): ExecutorRegistry;
8527
7715
  //#endregion
8528
7716
  //#region src/mcp/tools/delegate.d.ts
8529
- /** MCP tool name for the `delegate` generic-delegation tool. @stable */
8530
- declare const DELEGATE_TOOL_NAME = "delegate";
8531
- /** Human-readable description of the `delegate` MCP tool, injected into the tool manifest. @stable */
8532
- declare const DELEGATE_DESCRIPTION: string;
8533
- /** JSON Schema for `delegate` tool arguments (`intent` + optional trace id). @stable */
8534
- declare const DELEGATE_INPUT_SCHEMA: {
8535
- readonly type: "object";
8536
- readonly properties: {
8537
- readonly intent: {
8538
- readonly type: "string";
8539
- readonly description: "What you want accomplished, as an outcome. The supervisor authors the worker.";
8540
- };
8541
- readonly runId: {
8542
- readonly type: "string";
8543
- readonly description: "Optional trace-correlation id for this delegation.";
8544
- };
8545
- };
8546
- readonly required: readonly ["intent"];
8547
- readonly additionalProperties: false;
8548
- };
8549
- /** Parsed `delegate` tool arguments. */
8550
- interface DelegateArgs {
8551
- intent: string;
8552
- runId?: string;
8553
- }
8554
- /** Parse and validate raw MCP tool input into typed `DelegateArgs`; throws `TypeError` on bad input. @stable */
8555
- declare function validateDelegateArgs(raw: unknown): DelegateArgs;
8556
7717
  /** The synchronous result the `delegate` tool returns to the calling agent: the delivered output (or
8557
7718
  * the no-winner reason) PLUS the conserved spend of the whole delegation. */
8558
7719
  type DelegateResult = {
@@ -8650,64 +7811,8 @@ interface McpServer {
8650
7811
  * @experimental
8651
7812
  */
8652
7813
  declare function createMcpServer(options?: McpServerOptions): McpServer;
8653
- /**
8654
- * In-process pair of `Readable` + `Writable` streams suitable for driving
8655
- * `server.serve(...)` from a test. Returns the agent-side stream (the
8656
- * client writes to it) and the server-side stream (the test reads from it).
8657
- *
8658
- * @experimental
8659
- */
8660
- declare function createInProcessTransport(): {
8661
- transport: McpTransport;
8662
- clientWrite(line: string): void;
8663
- clientClose(): void;
8664
- readServer(): Promise<JsonRpcResponse[]>;
8665
- };
8666
7814
  //#endregion
8667
7815
  //#region src/mcp/tools/spawn-resource-paths.d.ts
8668
- /**
8669
- * Inline resources a manager hands a child by PATH instead of by content.
8670
- *
8671
- * The canonical profile schema knows two resource kinds, `inline` (a content string) and `github`.
8672
- * A manager that wants a child to receive a data file therefore had one way to do it: emit the
8673
- * bytes inside its own `spawn` tool call. That is a transcription by a language model, and it does
8674
- * not survive size. Measured 2026-09-12 (discovery-lab `mech-interp-foundations-glm2-b-20260912b`):
8675
- * a 29,144-character base64 payload on the manager's disk reached three children as 15,928
8676
- * characters with 11 substitutions, and a fourth child received the literal placeholder the
8677
- * manager meant to replace. Seven blind-check attempts across two runs delivered no data.
8678
- *
8679
- * `{ kind: 'inline', name, path }` lets the coordination server be the transport: it reads the
8680
- * file from the manager's workspace, fills `content`, and the profile that reaches the schema,
8681
- * the journal, and the provider is an ordinary inline resource. Nothing downstream changes; the
8682
- * model's output stops carrying the bytes.
8683
- *
8684
- * Where the bytes come from is a {@link SpawnResourceReader}, and there are two:
8685
- * - a HOST DIRECTORY, for a manager whose driver runs on this host (a loopback bridge with a
8686
- * `cwd`), read through the descriptor-identity checks below;
8687
- * - the manager's OWN EXECUTION ENVIRONMENT, for a manager inside a provider sandbox, read
8688
- * through the environment's `read()`. The coordination server cannot see a sandbox filesystem,
8689
- * but the provider that created the sandbox can, and it is already in hand.
8690
- *
8691
- * The second reader exists because the first one's absence was not a refusal a manager could
8692
- * work around. Measured 2026-09-17 (discovery-lab `mech-interp-foundations-sandbox-a-20260917h`):
8693
- * a sandbox-rooted director, refused by path, fell back to emitting its files as content and got
8694
- * 5 characters wrong in 24,008, destroying 3 of 7 files including its instrument and both
8695
- * drivers. At that rate 20 KB of mounts all arrive intact about 2% of the time, and gzip makes it
8696
- * worse by turning one wrong character into total loss. Four consecutive runs in that lane lost
8697
- * their research children to this. There is no encoding that fixes a transcription channel; the
8698
- * only fix is a channel with no model in it.
8699
- *
8700
- * Fail-closed rules, each with the reason a manager needs to fix its call:
8701
- * - no reader available → refused (neither a host directory nor an environment with `read`)
8702
- * - absolute path or `..` escape → refused by both readers; a symlink that resolves outside the
8703
- * root → refused by the host reader (the environment reader delegates containment to the
8704
- * provider, which serves only the sandbox's own workspace)
8705
- * - not a regular file → refused
8706
- * - over {@link SPAWN_RESOURCE_PATH_MAX_BYTES} → refused naming the bound
8707
- * - bytes that are not valid UTF-8 → refused; `content` is a string, so binary data is encoded
8708
- * (base64) by the manager first, exactly as it would be for a content resource
8709
- */
8710
- declare const SPAWN_RESOURCE_PATH_MAX_BYTES: number;
8711
7816
  /** One successful read: the bytes as a string plus the identity the journal records. */
8712
7817
  interface SpawnResourceBytes {
8713
7818
  readonly content: string;
@@ -8729,8 +7834,6 @@ interface SpawnResourceReader {
8729
7834
  readonly describe: string;
8730
7835
  read(path: string): Promise<SpawnResourceRead>;
8731
7836
  }
8732
- /** The host-directory reader: a manager whose workspace is a directory this process can open. */
8733
- declare function hostDirectoryReader(root: string): SpawnResourceReader;
8734
7837
  /**
8735
7838
  * The environment reader: a manager running inside a provider environment whose `read()` serves
8736
7839
  * its own workspace. The provider owns containment — it will not serve a path outside the box —
@@ -8773,9 +7876,6 @@ type ResolveSpawnResourcePathsResult = {
8773
7876
  declare function resolveSpawnResourcePaths(profile: unknown, source: string | SpawnResourceReader | undefined): Promise<ResolveSpawnResourcePathsResult>;
8774
7877
  //#endregion
8775
7878
  //#region src/runtime/supervise/driver-retry.d.ts
8776
- /** The scope's live conserved-pool readout — the retry's real bound. Indexed off `Scope` so this
8777
- * module tracks the pool's shape rather than restating it. */
8778
- type DriverBudgetReadout = Scope<unknown>['budget'];
8779
7879
  /** Whether the run's declared completion check has passed. `'none'` means the caller declared no
8780
7880
  * check at all — the retry then reads spend and settlements exactly as it always has. */
8781
7881
  type DriverContractState = 'met' | 'unmet' | 'none';
@@ -8805,30 +7905,6 @@ interface DriverRetryPolicy extends UnavailablePausePolicy {
8805
7905
  * Platform restart. */
8806
7906
  readonly transientOutageMs?: number;
8807
7907
  }
8808
- /** The comparable mark used to decide whether an attempt moved the run TOWARD ITS DELIVERABLE.
8809
- * While a declared check is unmet, spend and settlements are not progress on their own; see this
8810
- * file's header for the measurement that made that the rule. */
8811
- interface DriverProgressMark {
8812
- /** Monotone total of POOL spend since the first reading, in tokens — the driver's own metered
8813
- * turns AND any child settlement, because the conserved pool is shared. Deliberately not
8814
- * driver-only: a child that settled during the attempt is progress by any reading, and the
8815
- * coarser signal can only bias toward rescuing a run, never toward abandoning one. */
8816
- readonly poolTokensSpent: number;
8817
- /** Monotone count of settled children. */
8818
- readonly settledCount: number;
8819
- /** Whether an accepted deliverable exists — a submission that PASSED the completion check. */
8820
- readonly submitted: boolean;
8821
- /** The completion check's verdict right now. Omit (or `'none'`) when the caller declares no
8822
- * check: the retry then reads spend and settlements exactly as it did before this field
8823
- * existed, so a caller with no contract is unaffected. */
8824
- readonly contract?: DriverContractState;
8825
- /** Monotone count of settled children that PASSED the completion check. A child that ran and
8826
- * settled without delivering does not count here, which is the whole point. */
8827
- readonly deliveredCount?: number;
8828
- /** The best composite any check read has scored so far. A rise is progress: the director moved
8829
- * the outside check even though it has not passed. */
8830
- readonly composite?: number;
8831
- }
8832
7908
  /** Why the loop is entering the driver again. Absent on the first attempt only.
8833
7909
  *
8834
7910
  * An `unmet-contract` re-entry carries Runtime's continuation note. A `driver-failure` re-entry
@@ -8877,13 +7953,6 @@ type DriverReentry = {
8877
7953
  };
8878
7954
  //#endregion
8879
7955
  //#region src/runtime/supervise/continuation.d.ts
8880
- /** Read a check function's return value into a verdict. Anything but `true` or a passing verdict
8881
- * is a failure: a check fails closed. */
8882
- declare function checkVerdictOf(outcome: unknown): CheckVerdict;
8883
- /** Items that fail in `verdict`: every item below 1, or the named items of its FAIL lines. */
8884
- declare function failedItems(verdict: CheckVerdict): ReadonlyArray<string>;
8885
- /** Items that pass in `verdict`. */
8886
- declare function passedItems(verdict: CheckVerdict): ReadonlyArray<string>;
8887
7956
  /** One time the check ran inside the run, whatever started it. */
8888
7957
  interface CheckRead {
8889
7958
  /** 1-based count of check reads in this manager, the unavailable ones included. */
@@ -8962,7 +8031,7 @@ declare function admitContinuationPolicy(policy: ContinuationPolicy, context: st
8962
8031
  /**
8963
8032
  * Every instruction word of the note. Runtime supplies the facts and their order; this data
8964
8033
  * supplies the words, so the note can be improved (by a person, reflection, or GEPA) without a code
8965
- * change. Templates may name the facts in {@link CONTINUATION_FACTS} as `{name}`.
8034
+ * change. Templates may name the facts in `CONTINUATION_FACTS` as `{name}`.
8966
8035
  */
8967
8036
  interface ContinuationProfile {
8968
8037
  /** Recorded with every note, so each continuation names the words it carried. */
@@ -8994,8 +8063,6 @@ interface ContinuationProfile {
8994
8063
  * chain's `'review-of-best'`. It may name `{version}`, `{path}` and `{score}`. */
8995
8064
  readonly review?: string;
8996
8065
  }
8997
- /** The facts a profile template may name. */
8998
- declare const CONTINUATION_FACTS: readonly ["composite", "threshold", "failed", "total", "reads", "owed", "settled", "delivered", "continuation"];
8999
8066
  /** What the question panel reads for one continuation. */
9000
8067
  interface ContinuationPanelInput {
9001
8068
  /** 1-based continuation number. */
@@ -9058,59 +8125,6 @@ type ContinuationAppend = (context: {
9058
8125
  readonly heading: string;
9059
8126
  readonly text: string;
9060
8127
  } | undefined>;
9061
- /** A finding that reached the note, with the continuation that admitted it. */
9062
- interface AdmittedFinding extends PanelFinding {
9063
- readonly admittedAt: number;
9064
- /** Set once every item the finding named passes. */
9065
- readonly resolvedAt?: number;
9066
- }
9067
- /** Findings reach the note only when every citation resolves, at least two distinct spans are
9068
- * cited, and the independent verifier agreed. The best method in Who&When found the failing step
9069
- * 14.2% of the time, so an unverified finding is noise with a citation. */
9070
- declare function admitFinding(finding: PanelFinding): boolean;
9071
- /**
9072
- * Rank the admitted findings by how many failed items they explain, drop repeats, and keep them
9073
- * within the note's cap. Earlier findings stay as they were written (ACE: itemized additions keep
9074
- * detail that repeated rewrites lose); a finding whose items all pass now is marked resolved.
9075
- */
9076
- declare function distillFindings(prior: ReadonlyArray<AdmittedFinding>, proposed: ReadonlyArray<PanelFinding>, failing: ReadonlySet<string>, continuation: number): ReadonlyArray<AdmittedFinding>;
9077
- /** Expand the profile's question templates over the failed items and the settled workers. */
9078
- declare function expandQuestions(templates: ReadonlyArray<string>, failing: ReadonlyArray<string>, workers: ReadonlyArray<{
9079
- readonly id: string;
9080
- readonly label: string;
9081
- }>): ReadonlyArray<string>;
9082
- /** The facts one note is written from. */
9083
- interface ContinuationNoteInput {
9084
- readonly profile: ContinuationProfile;
9085
- /** 1-based. */
9086
- readonly continuation: number;
9087
- /** The verdict this turn ended on; absent when no result has reached the check. */
9088
- readonly verdict?: CheckVerdict;
9089
- /** The verdict the previous note reported, for what changed. */
9090
- readonly previous?: CheckVerdict;
9091
- /** Check reads so far, the unavailable ones included. */
9092
- readonly reads: number;
9093
- /** `verbatim` only when the policy and the check both allow the FAIL lines. */
9094
- readonly failures: 'verbatim' | 'off';
9095
- readonly findings?: ReadonlyArray<AdmittedFinding>;
9096
- readonly bar?: {
9097
- readonly best?: ContinuationPolicy['best'];
9098
- readonly reference?: string;
9099
- };
9100
- readonly appended?: ReadonlyArray<{
9101
- readonly heading: string;
9102
- readonly text: string;
9103
- }>;
9104
- /** What the run owes, from the check's description. */
9105
- readonly owed?: string;
9106
- readonly progress: DriverProgressMark;
9107
- /** Whether `read_continuation` is served to this manager. */
9108
- readonly canReadMore: boolean;
9109
- /** Whether submit_result is served to this manager. Absent means unavailable. */
9110
- readonly canSubmitResult?: boolean;
9111
- /** Whether the check's score comes from cases the director cannot see. */
9112
- readonly sealed?: boolean;
9113
- }
9114
8128
  /** One continuation as the settle record carries it (`DriverContinuationRecord.continuations`). */
9115
8129
  interface ContinuationEntry {
9116
8130
  /** 1-based. */
@@ -9147,19 +8161,6 @@ interface VerdictSummary {
9147
8161
  readonly failed?: number;
9148
8162
  readonly total?: number;
9149
8163
  }
9150
- /** The readout a continuation is composed from. */
9151
- interface ContinuationContext {
9152
- /** The attempt that just completed, 1-based. */
9153
- readonly attempt: number;
9154
- /** Continuations this run has already sent. */
9155
- readonly continuations: number;
9156
- /** The mark read after the completed drive. */
9157
- readonly progress: DriverProgressMark;
9158
- readonly budget: DriverBudgetReadout;
9159
- /** Re-entered drives in a row, this one included, that ended without progress. */
9160
- readonly barrenReentries: number;
9161
- readonly signal: AbortSignal;
9162
- }
9163
8164
  //#endregion
9164
8165
  //#region src/runtime/supervise/coordination-log.d.ts
9165
8166
  /** Stable identity of the supervisor that owns one coordination stream. High-level supervision
@@ -9450,53 +8451,10 @@ interface FinalizeContext {
9450
8451
  }
9451
8452
  /** The finalization seam: ledger in, output (or `undefined` = nothing deliverable) out. */
9452
8453
  type SupervisorFinalizer = (ctx: FinalizeContext) => Promise<unknown | undefined> | unknown | undefined;
9453
- /** The single argmax both the default finalizer and `finalizeBestDelivered` share: highest
9454
- * score wins, missing scores count 0, ties keep the earliest ledger entry. */
9455
- declare function pickBestDelivered<T extends {
9456
- readonly score?: number;
9457
- }>(delivered: ReadonlyArray<T>): T | undefined;
9458
8454
  /** Keep-best under the completion oracle — the DEFAULT finalizer and the exact behavior every
9459
8455
  * existing caller had: the highest-scoring delivered child's output, `undefined` when nothing
9460
8456
  * delivered (or the best delivered child carries no artifact). */
9461
8457
  declare const bestDelivered: SupervisorFinalizer;
9462
- /**
9463
- * Every verified distinct output, highest score first — the shape for competing hypotheses, a
9464
- * Pareto front, or a recorded evaluator split (three judges 2:1 → both outputs survive, with
9465
- * provenance, instead of the minority report being erased). Distinct by `outRef` (content
9466
- * address), so identical outputs collapse to one entry. `undefined` when nothing delivered —
9467
- * an empty collection is a no-winner, not a winner wrapping `[]`.
9468
- */
9469
- declare const collectDelivered: SupervisorFinalizer;
9470
- /**
9471
- * Run a finalizer over a settled-worker ledger under the delivered-only invariant: filter the
9472
- * ledger to structurally delivered children, materialize their outputs, and hand the finalizer a
9473
- * blob reader that throws on any ref outside that set. This is the one call site both driver arms
9474
- * (the in-process tool-loop and the MCP-mounted harness) finalize through. When a parent declares
9475
- * a deliverable, its candidate must also pass that check: children may have narrower assignments.
9476
- * The default selects the highest-scoring child that passes the parent's check; custom finalizers
9477
- * assemble their candidate before the check. A rejection leaves the parent incomplete; a thrown
9478
- * oracle surfaces a validation error. Neither changes child validity.
9479
- */
9480
- declare function runFinalizer(finalizer: SupervisorFinalizer, args: {
9481
- readonly settled: ReadonlyArray<FinalizerSettled>;
9482
- readonly blobs: ResultBlobStore;
9483
- readonly tree: TreeView;
9484
- readonly budget: Scope<unknown>['budget'];
9485
- readonly deliverable?: DeliverableSpec;
9486
- }): Promise<unknown | undefined>;
9487
- /** Keep-best finalize under the completion-oracle: return the highest-scoring DELIVERED child's
9488
- * output (settled `done` AND `valid` — its deliverable check passed). Returns undefined when no
9489
- * child delivered — an honest "the driver produced nothing", never a high-scoring result that
9490
- * ran without passing its check (Foreman's 0/18 lesson). `valid` is the single delivery signal,
9491
- * matching `defaultSelectWinner`'s valid-first rule; the oracle just doesn't fall back to an
9492
- * unchecked best-effort. The same argmax as the `bestDelivered` finalizer (`pickBestDelivered`);
9493
- * this direct form serves callers that hold a bare ledger + blob store. */
9494
- declare function finalizeBestDelivered(settled: ReadonlyArray<{
9495
- status: string;
9496
- score?: number;
9497
- valid?: boolean;
9498
- outRef?: string;
9499
- }>, blobs: ResultBlobStore): Promise<unknown>;
9500
8458
  //#endregion
9501
8459
  //#region src/runtime/supervise/reentry.d.ts
9502
8460
  /** What the next drive continues, as the drive harness can prove it before the turn starts. */
@@ -9581,10 +8539,6 @@ interface RunCancellation {
9581
8539
  /** The runtime's explanation of how it arrived at `effect`. */
9582
8540
  readonly detail?: string;
9583
8541
  }
9584
- /** The run-scoped cancel request file of one run — one {@link RunCancelRequest}. */
9585
- declare function runCancelRequestFile(eventDir: string): string;
9586
- /** The run-scoped acknowledgement file of one run — one {@link RunCancellation}. */
9587
- declare function runCancellationFile(eventDir: string): string;
9588
8542
  /** Read the run-scoped cancel request, or `undefined` when none was written. */
9589
8543
  declare function readRunCancelRequest(eventDir: string): RunCancelRequest | undefined;
9590
8544
  /**
@@ -9619,18 +8573,6 @@ declare function cancelRun(eventDir: string, operationId: string, options?: {
9619
8573
  }): RunCancellation;
9620
8574
  //#endregion
9621
8575
  //#region src/runtime/supervise/stop-rules.d.ts
9622
- /** One settled unit of work, reduced to what a stop rule reads. `objective` is the run's own
9623
- * quality signal (a verdict score, a test pass-rate, a judge rating); `undefined` = this
9624
- * settlement produced no measurable objective (it failed, or nothing scored it). */
9625
- interface ProgressSample {
9626
- readonly id: string;
9627
- /** Epoch ms the settlement was observed. */
9628
- readonly at: number;
9629
- readonly objective?: number;
9630
- /** True when the settlement passed its deliverable check — a scored-but-undelivered result is
9631
- * not progress. */
9632
- readonly delivered: boolean;
9633
- }
9634
8576
  /** The read-model a `StopRule` decides from — the run's progress, not its budget. */
9635
8577
  interface ProgressView {
9636
8578
  readonly now: number;
@@ -9667,42 +8609,6 @@ type StopDecision = {
9667
8609
  /** Evaluated from the progress feed, never from the budget. Pure and synchronous: it is called on
9668
8610
  * the driver's hot path, once per turn. */
9669
8611
  type StopRule = (view: ProgressView) => StopDecision;
9670
- /** Accumulates settlements and materializes a `ProgressView`. Idempotent by settlement id, so a
9671
- * caller may re-push its whole roster every turn (the driver does exactly that) without
9672
- * double-counting or moving a recorded timestamp. */
9673
- interface ProgressTracker {
9674
- /** Record a settlement. A second call with the same `id` is ignored. Returns true when it was
9675
- * new. */
9676
- record(sample: ProgressSample): boolean;
9677
- /** Materialize the view. Pass the live `Scope` to include the worker feed and tree shape. */
9678
- view(scope?: Scope<unknown>, opts?: {
9679
- readonly stallAfterMs?: number;
9680
- }): ProgressView;
9681
- /** Evaluate a rule against the current view. */
9682
- evaluate(rule: StopRule, scope?: Scope<unknown>, opts?: {
9683
- readonly stallAfterMs?: number;
9684
- }): StopDecision;
9685
- /** The samples recorded so far, in order. */
9686
- samples(): ReadonlyArray<ProgressSample>;
9687
- }
9688
- interface ProgressTrackerOptions {
9689
- /** Clock for `view().now`. Defaults to `Date.now`. */
9690
- readonly now?: () => number;
9691
- /** Treat a settlement that did NOT pass its deliverable check as having no objective. Default
9692
- * true — "scored 0.9 but never delivered" is not progress, and counting it as progress is the
9693
- * exact way a plateau rule gets talked out of firing. */
9694
- readonly requireDelivered?: boolean;
9695
- /** How much the best-so-far must rise for a settlement to count as an IMPROVEMENT. Default 0
9696
- * (any strict rise counts). Raise it to ignore score noise. */
9697
- readonly minImprovement?: number;
9698
- }
9699
- /** Build the settled-work ledger a `StopRule` decides from: record each settlement (idempotent by
9700
- * id) and materialize a `ProgressView` combining the best-so-far curve with the live worker feed. */
9701
- declare function createProgressTracker(opts?: ProgressTrackerOptions): ProgressTracker;
9702
- /** Build a `ProgressSample` from a scope settlement. The objective is the verdict score and
9703
- * `delivered` is the verdict's `valid` — the SAME single delivery signal `finalizeBestDelivered`
9704
- * and `defaultSelectWinner` use, so "progress" and "winner" cannot disagree. */
9705
- declare function sampleFromSettled(settled: Settled<unknown>, at: number): ProgressSample;
9706
8612
  interface NoProgressForOptions {
9707
8613
  /** Stop when this many ms have passed since the last SETTLEMENT. Omit to not bound on time. */
9708
8614
  readonly ms?: number;
@@ -9759,24 +8665,10 @@ interface AllWorkersStalledOptions {
9759
8665
  declare function allWorkersStalled(opts?: AllWorkersStalledOptions): StopRule;
9760
8666
  /** Stop when ANY rule stops — the ordinary composition (each rule is a separate reason to end). */
9761
8667
  declare function anyOf(...rules: ReadonlyArray<StopRule>): StopRule;
9762
- /** Stop only when EVERY rule stops — for a conservative gate that needs corroboration. */
9763
- declare function allOf(...rules: ReadonlyArray<StopRule>): StopRule;
9764
8668
  //#endregion
9765
8669
  //#region src/runtime/supervise/supervisor-agent-profile.d.ts
9766
8670
  /** A supervisor is an exact canonical AgentProfile; no looser model/prompt shape exists. */
9767
8671
  type SupervisorProfile = AgentProfile;
9768
- /** The exact profile fields consumed by supervisor materialization. */
9769
- interface ResolvedSupervisorProfile {
9770
- readonly name: string;
9771
- readonly harness: string | null;
9772
- readonly modelId: string;
9773
- readonly systemPrompt?: string;
9774
- }
9775
- /**
9776
- * Reduce one canonical executable profile to the scalars the two brain arms consume.
9777
- */
9778
- declare function resolveSupervisorProfile(profile: SupervisorProfile): ResolvedSupervisorProfile;
9779
- /** Listener, authenticated remote endpoint, and bounded request policy for one manager. */
9780
8672
  //#endregion
9781
8673
  //#region src/runtime/supervise/wake.d.ts
9782
8674
  /** How Runtime wakes a manager that ended its turn with work open. */
@@ -9788,8 +8680,6 @@ interface ManagerWakePolicy {
9788
8680
  /** Wake once this long before the deadline and ask for the best result now. Default 15 min. */
9789
8681
  readonly deadlineWarningMs?: number;
9790
8682
  }
9791
- /** How long before its deadline a manager is woken once to submit its best result: 15 min. */
9792
- declare const DEFAULT_DEADLINE_WARNING_MS: number;
9793
8683
  //#endregion
9794
8684
  //#region src/runtime/supervise/supervisor-agent-contracts.d.ts
9795
8685
  type CoordinationBinding = CoordinationTransportOptions;
@@ -10096,7 +8986,7 @@ interface SupervisorAgentDeps {
10096
8986
  readonly finalizer?: SupervisorFinalizer;
10097
8987
  /** Where the coordination MCP binds (external arm). Omit = an ephemeral loopback port, which is
10098
8988
  * unreachable from an off-host harness. A non-loopback host fails closed — see
10099
- * {@link runtime.assertCoordinationBinding}. */
8989
+ * `assertCoordinationBinding`. */
10100
8990
  readonly coordination?: CoordinationBinding;
10101
8991
  /** OPT-IN async gate run before every spawn mints an assignment or reserves budget — the one
10102
8992
  * pre-journal point that may ask the backend a question (does this bridge route the child's
@@ -10146,10 +9036,6 @@ interface SupervisorAgentTestDeps extends SupervisorAgentDeps {
10146
9036
  readonly brain: ToolLoopChat;
10147
9037
  }
10148
9038
  //#endregion
10149
- //#region src/runtime/supervise/supervisor-router-config.d.ts
10150
- /** Validate a manager's coordination authentication and request limits before execution. */
10151
- declare function assertCoordinationBinding(binding: CoordinationBinding | undefined): void;
10152
- //#endregion
10153
9039
  //#region src/runtime/supervise/supervisor-agent.d.ts
10154
9040
  /** Build a supervisor `Agent` from its profile: the brain resolves from `profile.harness`
10155
9041
  * (backend-as-data), the same resolution rule as every worker. */
@@ -10253,17 +9139,38 @@ declare class GraphRouteError extends Error {
10253
9139
  /** Default per-edge traversal cap — the cyclic-graph backstop when an edge names none. */
10254
9140
  declare const defaultEdgeTraversalCap = 32;
10255
9141
  //#endregion
10256
- //#region src/runtime/supervise/budget.d.ts
9142
+ //#region src/runtime/supervise/root-stream.d.ts
9143
+ /** One line of `root-stream.jsonl`. */
9144
+ type RootStreamRecord = {
9145
+ /** 1-based position in the file, continuing across drive attempts and across processes. */
9146
+ readonly seq: number;
9147
+ /** ISO instant the line was appended, from the run's own clock. */
9148
+ readonly at: string;
9149
+ /** The 1-based drive attempt of the root that produced it: a driver retry or re-prompt
9150
+ * re-enters the harness and continues the same file with the next attempt number. */
9151
+ readonly attempt: number;
9152
+ } & ({
9153
+ readonly event: ExecutorProgressEvent;
9154
+ } | {
9155
+ /** The event could not be written as JSON; its kind and the reason stand in so the gap
9156
+ * is recorded in the file itself instead of silently narrowing the stream. */
9157
+ readonly dropped: {
9158
+ readonly kind: ExecutorProgressEvent['kind'];
9159
+ readonly reason: string;
9160
+ };
9161
+ });
10257
9162
  /**
10258
- * A reconciliation whose spend the pool cannot verify. It is thrown after the reservation has
10259
- * settled. `budgetViolation` carries any measured overspend on the same settlement, so a child
10260
- * that fails closed on the fault still records how far its known channels exceeded the
10261
- * reservation.
9163
+ * The receipt for the root stream a run directory holds, recomputed from the file's bytes, or
9164
+ * `undefined` when the directory holds none. This is what a run that never settled — a root that
9165
+ * died mid-turn — gets on its failure record, and it equals what `close()` returned for a run
9166
+ * that did.
10262
9167
  */
10263
- declare class BudgetReconcileFault extends Error {
10264
- readonly budgetViolation?: BudgetViolation;
10265
- constructor(message: string, budgetViolation?: BudgetViolation);
10266
- }
9168
+ declare function readRootStreamReceipt(runDir: string): Promise<RootStreamReceipt | undefined>;
9169
+ /** Every committed line of the root stream, in order, or `undefined` when there is no file. A
9170
+ * torn final line from a process that died mid-write is not a record and is left out. */
9171
+ declare function readRootStream(runDir: string): Promise<RootStreamRecord[] | undefined>;
9172
+ //#endregion
9173
+ //#region src/runtime/supervise/budget.d.ts
10267
9174
  /** Opaque, single-use reservation handle returned by `reserve` and consumed by
10268
9175
  * `reconcile`. Carries the reserved ceilings so reconciliation needs no lookup. */
10269
9176
  interface ReservationTicket {
@@ -10365,15 +9272,6 @@ interface ReserveOptions {
10365
9272
  /** Leave this much of each channel free after the reservation. */
10366
9273
  readonly keep?: ReservationFloor;
10367
9274
  }
10368
- /**
10369
- * A waiting reservation that can never be granted: every open reservation settled and the free
10370
- * balance still cannot cover it. `shortfalls` are the channels that did not fit at that moment.
10371
- */
10372
- declare class ReservationWaitRefused extends Error {
10373
- readonly reason: "budget-exhausted";
10374
- readonly shortfalls: readonly ReservationShortfall[];
10375
- constructor(shortfalls: readonly ReservationShortfall[]);
10376
- }
10377
9275
  /** Why a reservation was refused. `budget-exhausted` means the pool ran out of a channel it
10378
9276
  * budgets; `usd-unbudgeted` means the root declared no dollar ceiling, so a dollar request is
10379
9277
  * unsatisfiable at any amount and the fix is to budget the root, not to ask for less. */
@@ -10412,7 +9310,7 @@ interface BudgetPool {
10412
9310
  *
10413
9311
  * With `wait`, a request the free balance cannot cover now, but could once the open reservations
10414
9312
  * return, is admitted as a WAITING ticket: `granted` resolves when the pool reserves it, and
10415
- * rejects with {@link ReservationWaitRefused} once nothing open could return enough. A waiting
9313
+ * rejects with `ReservationWaitRefused` once nothing open could return enough. A waiting
10416
9314
  * ticket reserves nothing; reconciling it withdraws it. While any ticket waits, a new waiting
10417
9315
  * request queues behind it even when it would fit, so the order of asking is the order of grant.
10418
9316
  */
@@ -10485,7 +9383,7 @@ declare function createBudgetPool(root: Budget, runStartedAtMs: number, restore?
10485
9383
  //#region src/runtime/supervise/deadline.d.ts
10486
9384
  /**
10487
9385
  * What a steerable child's own time box does: a check-in, not a kill. At the child's deadline its
10488
- * lead's scope delivers {@link DEADLINE_CHECK_IN_MESSAGE} to the child's inbox and keeps it
9386
+ * lead's scope delivers `DEADLINE_CHECK_IN_MESSAGE` to the child's inbox and keeps it
10489
9387
  * running; the child is stopped (reason `child deadline exceeded`) only once it then makes no
10490
9388
  * progress for `idleMs`. The run's own deadline, the budgets and cancellation still stop it at once.
10491
9389
  * `false` restores the hard kill at the time box. A child that exposes no inbox cannot be told,
@@ -10499,277 +9397,14 @@ declare function createBudgetPool(root: Budget, runStartedAtMs: number, restore?
10499
9397
  type DeadlineCheckIn = false | {
10500
9398
  readonly idleMs?: number;
10501
9399
  };
10502
- /** How long a checked-in child may go without progress before it is stopped: 30 min. */
10503
- declare const DEFAULT_CHECK_IN_IDLE_MS: number;
10504
- /** The check-in a child receives at its own time box. */
10505
- declare const DEADLINE_CHECK_IN_MESSAGE: string;
10506
- //#endregion
10507
- //#region src/runtime/supervise/worker-events.d.ts
10508
- /** Live observation is bounded and process-local. A reconnect explicitly reports expired history. */
10509
- interface WorkerEventCursor {
10510
- readonly epoch: string;
10511
- readonly next: number;
10512
- }
10513
- interface WorkerEventEntry {
10514
- readonly sequence: number;
10515
- readonly at: number;
10516
- readonly event: unknown;
10517
- readonly omitted?: 'event-too-large' | 'event-not-serializable';
10518
- }
10519
- type WorkerEventPage = {
10520
- readonly status: 'unavailable';
10521
- readonly reason: 'unknown-worker' | 'not-captured';
10522
- } | {
10523
- readonly status: 'available';
10524
- readonly entries: readonly WorkerEventEntry[];
10525
- readonly cursor: WorkerEventCursor;
10526
- readonly reset: boolean;
10527
- readonly historyExpired: boolean;
10528
- readonly remaining: number;
10529
- };
10530
- //#endregion
10531
- //#region src/runtime/supervise/worker-slots.d.ts
10532
- /**
10533
- * Worker slots: the one bound on how many spawned agents work at the same time.
10534
- *
10535
- * Every scope of a supervised tree draws from one allocator. A host that runs several trees in one
10536
- * process can pass the same allocator to each of them, and the bound then holds across all of them.
10537
- *
10538
- * A spawn past the bound is never refused. It keeps its reserved budget slice and waits in a queue,
10539
- * and it starts when a slot frees. The queue releases the deepest spawn first and then the oldest,
10540
- * so a subtree that is already paid for finishes before the tree grows wider.
10541
- *
10542
- * A slot counts a working agent: a spawned agent that runs with no running child of its own. A
10543
- * manager whose children are all running is waiting on them, so its first running child takes over
10544
- * the manager's slot and the manager takes it back when its last running child ends. This makes
10545
- * nested waits deadlock-free: a manager can always run one child on its own slot, so a queued subtree
10546
- * always keeps a path to completion, whatever the bound and however deep the tree.
10547
- *
10548
- * The bound therefore limits working agents, not environments. The environments alive at one time
10549
- * can exceed it by the number of managers that have a running child. The conserved budget pool and
10550
- * the deadline bound the total work; this allocator only bounds how much of it runs at once.
10551
- *
10552
- * @experimental
10553
- */
10554
- /** A fleet-wide bound on concurrently working agents, with a queue for the spawns past it. */
10555
- interface WorkerSlots {
10556
- /** The bound on working agents, or `undefined` when only the budget bounds concurrency. */
10557
- readonly max: number | undefined;
10558
- /** Working agents that hold a slot now. */
10559
- readonly working: number;
10560
- /** Spawns that hold a budget slice and wait for a slot. */
10561
- readonly queued: number;
10562
- }
10563
- /**
10564
- * One held or awaited slot. `ready` resolves when the slot is granted; `granted` reads whether it
10565
- * has been. `release` returns the slot, or withdraws a request that is still queued, and is
10566
- * idempotent.
10567
- */
10568
- interface SlotPermit {
10569
- readonly ready: Promise<void>;
10570
- readonly granted: boolean;
10571
- release(): void;
10572
- }
10573
- /**
10574
- * Create a worker-slot allocator. `max` omitted, `0`, or negative leaves concurrency bounded by the
10575
- * budget alone, and every spawn starts at once. Pass the returned allocator as `workerSlots` to each
10576
- * run that should share one bound.
10577
- */
10578
- declare function createWorkerSlots(max?: number): WorkerSlots;
10579
9400
  //#endregion
10580
9401
  //#region src/runtime/supervise/worker-trace.d.ts
10581
- /**
10582
- * Seam key the `Scope` seeds a {@link TraceContext} under on each child's `ExecutorContext.seams`.
10583
- * Single-sourced here so the scope and every backend agree on it without a circular import — the
10584
- * same arrangement `nestedScopeSeamKey` uses.
10585
- */
10586
- declare const workerTraceSeamKey = "worker-trace";
10587
9402
  /**
10588
9403
  * Resolve the trace context a worker spawned BY `spawningNodeId` should inherit. `undefined` means
10589
9404
  * this run records no spans, so nothing is stamped. Supplied by
10590
9405
  * `SupervisorSpanRecorder.workerTrace` and threaded to the scope as `SupervisorOpts.workerTrace`.
10591
9406
  */
10592
9407
  type WorkerTraceResolver = (spawningNodeId: string) => TraceContext | undefined;
10593
- /**
10594
- * What the two readers below need off an `ExecutorContext` — its seam bag, and nothing else.
10595
- * Structural (not an `ExecutorContext` import) so this module stays free of the keystone type
10596
- * surface, and exported because it is part of a public signature.
10597
- */
10598
- interface WorkerTraceSeamCarrier {
10599
- readonly seams: Readonly<Record<string, unknown>>;
10600
- }
10601
- /**
10602
- * Read the inherited trace context off an `ExecutorContext`, or `undefined` when the run records no
10603
- * spans. Fails CLOSED on a malformed seam value (returns `undefined`) rather than stamping a
10604
- * half-formed id that would produce an unjoinable orphan span downstream.
10605
- */
10606
- declare function readWorkerTraceContext(ctx: WorkerTraceSeamCarrier): TraceContext | undefined;
10607
- /**
10608
- * The trace env to merge into a worker's environment — `TRACEPARENT` plus the legacy
10609
- * `TRACE_ID` / `PARENT_SPAN_ID` pair (dual-written for one release) — EMPTY when the run
10610
- * records no spans, which is what keeps the untraced path byte-identical. Merge it BELOW the
10611
- * caller's own seam env so a deliberately-set id wins (see the precedence note above).
10612
- */
10613
- declare function workerTraceEnv(ctx: WorkerTraceSeamCarrier): Record<string, string>;
10614
- /**
10615
- * The trace request headers for a worker dispatched over the cli-bridge HTTP transport — W3C
10616
- * `traceparent` plus the legacy `x-trace-id` / `x-parent-span-id` pair the bridge also reads —
10617
- * EMPTY when the run records no spans, which keeps the untraced request byte-identical. Derived
10618
- * from the same dual-write the env channel uses ({@link workerTraceEnv}), so the header and env
10619
- * spellings can never name different traces. `traceparent` is present only when a parent span id
10620
- * exists (the W3C grammar requires one); the legacy pair still carries a lone trace id.
10621
- */
10622
- declare function workerTraceHeaders(ctx: WorkerTraceSeamCarrier): Record<string, string>;
10623
- //#endregion
10624
- //#region src/runtime/supervise/scope-contract.d.ts
10625
- /** Construction args for `createScope`. The supervisor threads the shared pool, journal,
10626
- * blob store, and executor registry through; `depth`/`maxDepth` pair the runtime
10627
- * recursion ceiling with the conserved pool (R3). */
10628
- interface ScopeArgs {
10629
- /** This scope's owning node id — children get `${parentId}:s${seq}` ids. */
10630
- readonly parentId: NodeId;
10631
- /** Journal/blob root key the supervisor `beginTree`'d. */
10632
- readonly root: NodeId;
10633
- /** The reservation pool for this scope: the root total or one nested allocated partition. */
10634
- readonly pool: BudgetPool;
10635
- /** Append-only spawn journal; this scope writes `spawned` + `settled` records. */
10636
- readonly journal: SpawnJournal;
10637
- /** Content-addressed result store backing `outRef` rehydration. */
10638
- readonly blobs: ResultBlobStore;
10639
- /** The open executor resolver (BYO → router/inline → registered harness factory). */
10640
- readonly executors: ExecutorRegistry;
10641
- /** Per-spawn executor-construction seams (sandbox client, router config, cli bin). */
10642
- readonly seams: Readonly<Record<string, unknown>>;
10643
- /** This scope's recursion depth (root = 0). */
10644
- readonly depth: number;
10645
- /** Runtime recursion-depth ceiling — a spawn past it fails closed `depth-exceeded`. */
10646
- readonly maxDepth?: number;
10647
- /** The allocator that bounds concurrently working agents across this scope, every nested scope,
10648
- * and every other tree that shares it. Absent means no bound: only the budget limits concurrency. */
10649
- readonly workerSlots?: WorkerSlots;
10650
- /** @internal The slot this scope's own manager holds in its parent scope. A nested scope's first
10651
- * running child works on it while the manager waits. Absent on a root scope. */
10652
- readonly slotOwner?: SlotPermit;
10653
- /** Optional policy that keeps part of each manager's budget for its own inference. */
10654
- readonly reservationPolicy?: RecursiveReservationPolicy;
10655
- /** The budget from which this scope's owner-share floor is derived. */
10656
- readonly ownerBudget?: Budget;
10657
- /** What a steerable child's own time box does: a check-in by default (`deadline.ts`
10658
- * `DeadlineCheckIn`); `false` stops the child at its time box. Nested scopes inherit it. */
10659
- readonly deadlineCheckIn?: DeadlineCheckIn;
10660
- /** How long a keyed leaf whose turn ended over its budget keeps its environment for a same-key
10661
- * re-spawn to continue (ms). Default {@link DEFAULT_BUDGET_STOP_HOLD_MS}; `0` keeps none.
10662
- * Nested scopes inherit it. */
10663
- readonly budgetStopHoldMs?: number;
10664
- /** Abort signal for this scope; an abort cascades into every live child's executor. */
10665
- readonly signal: AbortSignal;
10666
- /** Injected clock — keeps the journal `at` timestamp deterministic in tests. */
10667
- readonly now?: () => number;
10668
- /** Lifecycle stream sink. `spawn` emits `agent.spawn`, `next` emits `agent.child` — the
10669
- * SAME stream `runAgentRounds`/`tool-loop` feed, so the recursive tree is ONE observable stream
10670
- * (the topology viewer reads it). Undefined ⇒ the journal stays the only record. */
10671
- readonly hooks?: RuntimeHooks;
10672
- /**
10673
- * Trace context to hand down to each spawned worker (`SupervisorOpts.workerTrace`). Called with
10674
- * THIS scope's own `parentId` — the node doing the spawning — and the resolved context is seeded
10675
- * onto each child's `ExecutorContext` under `workerTraceSeamKey`. Absent (the untraced default)
10676
- * ⇒ no seam is seeded and no worker environment is touched.
10677
- */
10678
- readonly workerTrace?: WorkerTraceResolver;
10679
- /**
10680
- * Present when this run RECORDS spans but the worker backend has NO channel to carry the trace
10681
- * context (`WORKER_TRACE_PROPAGATION[backend] === false` — cli-worktree has no env
10682
- * channel; router / router-tools / provider have no worker process). Each spawn then journals a
10683
- * `trace-unpropagated` event naming the severed hop, so a child whose trace shows up as a
10684
- * disconnected root is a recorded fact rather than a silent stranger. Absent ⇒ either the run
10685
- * is untraced or the backend propagates; nothing is journaled.
10686
- */
10687
- readonly workerTraceUnpropagated?: {
10688
- readonly backend: string;
10689
- readonly reason: 'no-env-channel' | 'no-worker-process' | 'caller-omitted';
10690
- };
10691
- /** Durable run directory that receives exact worker interactive bindings. */
10692
- readonly interactiveBindingDir?: string;
10693
- /** @internal Trusted root-adapter publication channel. It is never exposed as a Scope method. */
10694
- readonly ownerMaterialization?: {
10695
- readonly runtime: NodeSnapshot['runtime'];
10696
- readonly authoredProfile?: unknown;
10697
- readonly attemptId: string;
10698
- readonly prior?: ProfileMaterializationReceipt;
10699
- readonly journalRoot?: NodeId;
10700
- readonly nodeId?: NodeId;
10701
- readonly requiredKnown?: boolean;
10702
- readonly onReceipt?: (materialization: ProfileMaterializationReceipt, binding: ExecutionBindingReceipt) => void;
10703
- };
10704
- /**
10705
- * Resume seam — set ONLY by the supervisor when `SupervisorOpts.resume` is on AND a non-empty
10706
- * journal tree exists for this root. It carries the replayed committed work (so `scope.resume`
10707
- * exposes it to a resume-aware `act`) and the recorded ordinal/cursor maxima the new counters
10708
- * continue past, so a freshly-spawned child never reuses a journaled `seq`. Absent ⇒ fresh run.
10709
- */
10710
- readonly resumeFrom?: {
10711
- /** @internal Executor adoption plans validated by the supervisor's recovery preparation. */
10712
- readonly recoveries?: readonly RetainedChildRecovery[];
10713
- readonly events?: readonly SpawnEvent[];
10714
- readonly settled: ReadonlyArray<Settled<unknown>>;
10715
- readonly view: TreeView;
10716
- /** Highest `spawned` ordinal already journaled; new spawns start at `+1`. */
10717
- readonly maxSpawnOrdinal: number;
10718
- /** Highest cursor `seq` already journaled; new settlements start at `+1`. */
10719
- readonly maxCursorSeq: number;
10720
- /** Keyed assignments from the prior journal — what a keyed re-spawn resolves against. */
10721
- readonly keys: ReadonlyMap<string, ResumedKeyState<unknown>>;
10722
- /** Prior committed spend summed off the journal (settled child work + metered inference). */
10723
- readonly priorSpend: {
10724
- readonly childWork: Spend;
10725
- readonly driverInference: Spend;
10726
- };
10727
- };
10728
- }
10729
- //#endregion
10730
- //#region src/runtime/supervise/scope-capabilities.d.ts
10731
- /** How many of a manager's direct children its summary lists; the counts always cover all. */
10732
- declare const SUBTREE_RESULT_LIMIT = 8;
10733
- /** Ten minutes: a manager that is alive decides within a turn or two; one that crashed, or a host
10734
- * that restarted, must not leave a paid environment running until a retire pass finds it. */
10735
- declare const DEFAULT_BUDGET_STOP_HOLD_MS = 600000;
10736
- //#endregion
10737
- //#region src/runtime/supervise/scope-construction.d.ts
10738
- /** Create the reactive `Scope` a driver's `Agent.act` runs inside: spawn children on an atomically reserved conserved budget, settle via the `next()` cursor, journal for replay. */
10739
- declare function createScope<Out>(args: ScopeArgs): Scope<Out>;
10740
- //#endregion
10741
- //#region src/runtime/supervise/scope-observation.d.ts
10742
- /**
10743
- * The step-8 merge-boundary adapter (M4): rehydrate a `Settled.done` into the kernel's
10744
- * `Iteration` shape so `defaultSelectWinner` stays single-sourced — the supervisor selects
10745
- * across settled children with the SAME argmax the loop kernel uses, not a forked copy.
10746
- *
10747
- * `index` is the cursor `seq` (the recorded, replay-stable order); `output`/`verdict`/
10748
- * `tokenUsage`/`costUsd` are read straight off the settlement (already rehydrated from the
10749
- * `outRef` blob by `next()`). Events are empty — a settled child is an opaque leaf result,
10750
- * not a sandbox event stream — and the timing/cost fields project its conserved `Spend`.
10751
- * Fail loud on a `down` settlement: only a `done` child is an iteration.
10752
- */
10753
- declare function settledToIteration<Out>(settled: Settled<Out>): Iteration<unknown, Out>;
10754
- //#endregion
10755
- //#region src/runtime/supervise/supervisor-root-handle.d.ts
10756
- /**
10757
- * Mint a `RootHandle` plus its supervisor-private control. The handle is the substrate a
10758
- * chat/pi-viz client attaches to (Q2): `view()` reads the live tree, `signal()` delivers
10759
- * an out-of-band message, `abort()` cascades. Before `run` binds it (and after `run`
10760
- * unbinds it) the handle is fail-loud: a client that talks to a handle that is not
10761
- * driving a live run gets a typed error, never a silent no-op.
10762
- */
10763
- declare function createRootHandle<Out>(): SteerableRootHandle<Out>;
10764
- //#endregion
10765
- //#region src/runtime/supervise/supervisor-run.d.ts
10766
- /** The default recursion-depth ceiling. The conserved pool is what bounds a tree's depth: every
10767
- * level draws its slice from the level above, so a tree ends when its slices run out. This
10768
- * ceiling only stops a runaway recursion that keeps spawning tiny slices, so it sits well above
10769
- * any depth a budget can usefully pay for. */
10770
- declare const DEFAULT_MAX_DEPTH = 16;
10771
- /** Create a supervisor that owns one recursive agent execution tree. */
10772
- declare function createSupervisor<Task, Out>(): Supervisor<Task, Out>;
10773
9408
  //#endregion
10774
9409
  //#region src/runtime/supervise/otel-spans.d.ts
10775
9410
  /** OTLP span attribute values. Exported because `SupervisorSpanOptions.attributes` is public and
@@ -11103,9 +9738,58 @@ declare function withWorkerSpawnRetry(make: MakeWorkerAgent, policy: WorkerSpawn
11103
9738
  * Exported so an owner of `makeLeafAgent` — which builds its own executors — gets the same seam
11104
9739
  * without reimplementing the two proofs.
11105
9740
  */
11106
- declare function retryPreSpawnRefusals<Out>(inner: Executor<Out>, policy: ResolvedWorkerSpawnRetry, hooks?: WorkerSpawnRetryHooks & {
11107
- worker?: string;
11108
- }): Executor<Out>;
9741
+ declare function retryPreSpawnRefusals<Out>(inner: Executor<Out>, policy: ResolvedWorkerSpawnRetry, hooks?: WorkerSpawnRetryHooks & {
9742
+ worker?: string;
9743
+ }): Executor<Out>;
9744
+ //#endregion
9745
+ //#region src/runtime/supervise/worker-slots.d.ts
9746
+ /**
9747
+ * Worker slots: the one bound on how many spawned agents work at the same time.
9748
+ *
9749
+ * Every scope of a supervised tree draws from one allocator. A host that runs several trees in one
9750
+ * process can pass the same allocator to each of them, and the bound then holds across all of them.
9751
+ *
9752
+ * A spawn past the bound is never refused. It keeps its reserved budget slice and waits in a queue,
9753
+ * and it starts when a slot frees. The queue releases the deepest spawn first and then the oldest,
9754
+ * so a subtree that is already paid for finishes before the tree grows wider.
9755
+ *
9756
+ * A slot counts a working agent: a spawned agent that runs with no running child of its own. A
9757
+ * manager whose children are all running is waiting on them, so its first running child takes over
9758
+ * the manager's slot and the manager takes it back when its last running child ends. This makes
9759
+ * nested waits deadlock-free: a manager can always run one child on its own slot, so a queued subtree
9760
+ * always keeps a path to completion, whatever the bound and however deep the tree.
9761
+ *
9762
+ * The bound therefore limits working agents, not environments. The environments alive at one time
9763
+ * can exceed it by the number of managers that have a running child. The conserved budget pool and
9764
+ * the deadline bound the total work; this allocator only bounds how much of it runs at once.
9765
+ *
9766
+ * @experimental
9767
+ */
9768
+ /** A fleet-wide bound on concurrently working agents, with a queue for the spawns past it. */
9769
+ interface WorkerSlots {
9770
+ /** The bound on working agents, or `undefined` when only the budget bounds concurrency. */
9771
+ readonly max: number | undefined;
9772
+ /** Working agents that hold a slot now. */
9773
+ readonly working: number;
9774
+ /** Spawns that hold a budget slice and wait for a slot. */
9775
+ readonly queued: number;
9776
+ }
9777
+ /**
9778
+ * One held or awaited slot. `ready` resolves when the slot is granted; `granted` reads whether it
9779
+ * has been. `release` returns the slot, or withdraws a request that is still queued, and is
9780
+ * idempotent.
9781
+ */
9782
+ interface SlotPermit {
9783
+ readonly ready: Promise<void>;
9784
+ readonly granted: boolean;
9785
+ release(): void;
9786
+ }
9787
+ /**
9788
+ * Create a worker-slot allocator. `max` omitted, `0`, or negative leaves concurrency bounded by the
9789
+ * budget alone, and every spawn starts at once. Pass the returned allocator as `workerSlots` to each
9790
+ * run that should share one bound.
9791
+ */
9792
+ declare function createWorkerSlots(max?: number): WorkerSlots;
11109
9793
  //#endregion
11110
9794
  //#region src/runtime/supervise/supervise-options.d.ts
11111
9795
  interface SuperviseOptions {
@@ -11635,11 +10319,6 @@ interface SuperviseTestOptions extends SuperviseOptions {
11635
10319
  readonly brain: ToolLoopChat;
11636
10320
  }
11637
10321
  //#endregion
11638
- //#region src/runtime/supervise/supervise-profile-admission.d.ts
11639
- /** Manager-authored profiles are untrusted until product policy says otherwise. Remote MCP and
11640
- * ambient connection grants therefore fail closed by default, in addition to local MCP and hooks. */
11641
- declare const DEFAULT_AUTHORED_PROFILE_SECURITY_POLICY: AgentProfileSecurityPolicy;
11642
- //#endregion
11643
10322
  //#region src/runtime/supervise/supervise-worker-backend.d.ts
11644
10323
  /**
11645
10324
  * Build the worker seam from a backend (WHERE workers run) + an optional completion oracle (the
@@ -11928,14 +10607,17 @@ type GraphEdge =
11928
10607
  * root decides the order, the branch, the repair loop or the stop. On each usable settle of
11929
10608
  * `from` its outgoing routes edges are tried in declaration order and the first whose `when`
11930
10609
  * holds fires; an edge without `when` is the default branch and comes last. A node target is
11931
- * spawned with `{ from: { node, result }, evidence: { [id]: latest usable result } }` and the
11932
- * directive appended to its pinned instructions; `{ stop }` ends the run with no winner and
10610
+ * spawned with `{ from: { node, result }, evidence: { [id]: latest usable result } }` (a join's
10611
+ * target with `{ from: { nodes }, evidence }`, see below) and the directive appended to its pinned instructions; `{ stop }` ends the run with no winner and
11933
10612
  * `GraphResult.stopped`; `{ finish }` makes this settle part of the run's output.
11934
10613
  *
11935
10614
  * A fork lists two or more nodes in `to`: one traversal spawns each of them at once, each under
11936
10615
  * its own key `route:<edge id>#<traversal>:<node>`. A join lists two or more nodes in `from`: it
11937
- * fires once every member has settled usably since it last fired, and the target's evidence
11938
- * holds each member's latest result. A join carries no `when`, and it is the only routes edge
10616
+ * fires once every member has settled usably since it last fired, and the target's task is
10617
+ * `{ from: { nodes: <members in declared order> }, evidence }` with each member's latest result
10618
+ * in `evidence`, so it does not depend on which member settled last and a resumed run derives the
10619
+ * same task. A routes edge that spawns a node with a settled worker in this flow (a back edge)
10620
+ * names that node's latest settled worker as the spawn's `successorOf`. A join carries no `when`, and it is the only routes edge
11939
10621
  * leaving each of its members. A route into a node that still has a running worker throws
11940
10622
  * {@link GraphRouteError} with reason `target-live`: converging branches use a join.
11941
10623
  */
@@ -12209,8 +10891,6 @@ declare class FileObserverJournal implements ObserverJournal {
12209
10891
  private readExistingUnsafe;
12210
10892
  private assertComplete;
12211
10893
  }
12212
- /** Verify identity, monotonic sequence, payload shape, and the complete digest chain. */
12213
- declare function verifyObserverRecords(records: readonly ObserverRecord[], pursuitId?: string): readonly ObserverRecord[];
12214
10894
  /** Compute the canonical SHA-256 digest for an unsigned observer record. */
12215
10895
  declare function observerRecordDigest(record: Omit<ObserverRecord, 'digest'>): string;
12216
10896
  //#endregion
@@ -13404,9 +12084,6 @@ interface PipelineStage<Task, StepIn, StepOut> {
13404
12084
  * Fail loud (return a `blocked`) when the child produced nothing usable for the next stage. */
13405
12085
  collect(settled: Settled<Outcome<StepOut>>): Outcome<StepOut>;
13406
12086
  }
13407
- /** `pipeline(stages)` — build the sequential combinator from an ordered stage list. The first
13408
- * stage's `StepIn` is the root `Task`; the last stage's `StepOut` is the deliverable `D`. */
13409
- type Pipeline = <Task, D>(stages: ReadonlyArray<PipelineStage<Task, unknown, unknown>>) => CombinatorShape<Task, D>;
13410
12087
  /**
13411
12088
  * `fanout(items, { synthesize? })` — N children spawned in one round (one per item, bounded by
13412
12089
  * the conserved pool's fail-closed admission), drained via `scope.next()`, then optionally a
@@ -13475,8 +12152,6 @@ interface FanoutSynthesis<D> {
13475
12152
  synthesisTask(gathered: ReadonlyArray<Settled<Outcome<D>>>, ctx: ShapeContext<D>): unknown;
13476
12153
  collect(settled: Settled<Outcome<D>>): Outcome<D>;
13477
12154
  }
13478
- /** `fanout(items, opts)` — build the fanout combinator over a static item list. */
13479
- type Fanout = <Task, Item, D>(items: ReadonlyArray<Item>, opts: FanoutOptions<Item, D>) => CombinatorShape<Task, D>;
13480
12155
  /**
13481
12156
  * `loopUntil({ until, step })` — iterative deepening inside the conserved pool: spawn one `step`
13482
12157
  * child per round, ask `until` whether the accumulated state satisfies the goal, and stop when it
@@ -13507,8 +12182,6 @@ interface LoopUntilState<State> {
13507
12182
  readonly round: number;
13508
12183
  readonly value: State;
13509
12184
  }
13510
- /** `loopUntil(spec)` — build the iterative-deepening combinator. `seed` is the initial state. */
13511
- type LoopUntil = <Task, State, D>(seed: State, spec: LoopUntilSpec<Task, State, D>) => CombinatorShape<Task, D>;
13512
12185
  /**
13513
12186
  * `panel(judges)` — M judges over ONE artifact, merged WRITE-ONLY (selector≠judge taken to its
13514
12187
  * limit). The combinator spawns the M judge children over the same input artifact, drains their
@@ -13637,10 +12310,6 @@ interface WidenLineage<D> {
13637
12310
  }
13638
12311
  /** `widen(spec)` — build the streaming progressive-widening combinator. */
13639
12312
  type Widen = <Task, Seed, D>(spec: WidenSpec<Seed, D>) => CombinatorShape<Task, D>;
13640
- /** The flat default `ScopeWidenGate` factory contract — never widens, keeping the R2 firewall
13641
- * conflict dormant. Exported so a gate run can pass it explicitly and a test can assert the
13642
- * default is flat. */
13643
- type FlatWidenGate = <D>() => ScopeWidenGate<D>;
13644
12313
  /**
13645
12314
  * The reactive analyst seam — the PORT of the round-synchronous driver's `analyze` hook
13646
12315
  * (dynamic.ts) onto the reactive `Scope`. The old driver wired the analyst at round
@@ -13781,9 +12450,6 @@ interface RenderCorpusToInstructionsOptions {
13781
12450
  /** Optional cap on rendered lines (most-confident first), independent of the query `limit`. */
13782
12451
  readonly maxLines?: number;
13783
12452
  }
13784
- /** `renderCorpusToInstructions(opts)` — the flywheel read-back projection. Async (queries the
13785
- * durable corpus); returns a fresh `AgentProfile` with the accreted facts merged in. */
13786
- type RenderCorpusToInstructions = (opts: RenderCorpusToInstructionsOptions) => Promise<AgentProfile$3>;
13787
12453
  /**
13788
12454
  * One node in the reconstructed trajectory tree — a driver OR a leaf, with its OWN spend and the
13789
12455
  * spend ROLLED UP over its subtree. Reconstructed from the `SpawnJournal` (structure + per-node
@@ -13831,8 +12497,6 @@ interface TrajectoryReportOptions {
13831
12497
  /** Rehydrate each `done` node's `output` from the blob store. Off by default (cost-only report). */
13832
12498
  readonly withOutputs?: boolean;
13833
12499
  }
13834
- /** `trajectoryReport(...)` — the tree+cost reconstructor. Async (reads journal + optionally blobs). */
13835
- type TrajectoryReportFn = (journal: SpawnJournal, blobs: ResultBlobStore, root: NodeId, options?: TrajectoryReportOptions) => Promise<TrajectoryReport>;
13836
12500
  /**
13837
12501
  * One arm of an equal-k comparison — a labeled trajectory (a `TrajectoryReport` is one arm's whole
13838
12502
  * run). The arm's conserved COST is `report.total` (tokens + usd), which the sandbox executor
@@ -13880,8 +12544,6 @@ interface EqualKOnCostOptions {
13880
12544
  * the impl (e.g. 0.05). A tighter tolerance = a stricter equal-compute claim. */
13881
12545
  readonly tolerance?: number;
13882
12546
  }
13883
- /** `equalKOnCost(arms, opts)` — the cross-arm equal-compute check on conserved cost. */
13884
- type EqualKOnCost = (arms: ReadonlyArray<EqualKArm>, options?: EqualKOnCostOptions) => EqualKVerdict;
13885
12547
  //#endregion
13886
12548
  //#region src/runtime/observe.d.ts
13887
12549
  interface ObserveInput {
@@ -14450,8 +13112,6 @@ declare function defaultSelectWinner<Task, Output>(iterations: Iteration<Task, O
14450
13112
  declare const TERMINAL_DECISIONS: readonly ["stop", "pick-winner", "fail", "done"];
14451
13113
  /** One of the kernel's terminal decision values. @stable */
14452
13114
  type TerminalDecision = (typeof TERMINAL_DECISIONS)[number];
14453
- /** True when the kernel stops the loop for this decision value. @stable */
14454
- declare function isTerminalDecision(decision: unknown): decision is TerminalDecision;
14455
13115
  //#endregion
14456
13116
  //#region src/runtime/local-sandbox-client.d.ts
14457
13117
  interface LocalSandboxClientOptions {
@@ -14471,12 +13131,6 @@ interface LocalSandboxClientOptions {
14471
13131
  * different per-create profile and provides no host isolation. */
14472
13132
  profileSecurityPolicy?: AgentProfileSecurityPolicy;
14473
13133
  }
14474
- /** A same-host `SandboxClient` adapter with no process isolation. Local MCP is
14475
- * refused unless the caller explicitly supplies a policy that allows it.
14476
- *
14477
- * There is no box, so a per-prompt `backend` or `model` override is refused rather than dropped;
14478
- * other per-prompt options (`timeoutMs`, `context`) are accepted and ignored. */
14479
- declare function localSandboxClient(opts: LocalSandboxClientOptions): SandboxClient;
14480
13134
  //#endregion
14481
13135
  //#region src/runtime/loop-dispatch.d.ts
14482
13136
  /** runAgentRounds options minus the `ctx` (loopDispatch builds the ctx). */
@@ -14960,19 +13614,6 @@ declare function definePersona<D = unknown>(input: DefinePersonaInput<D>): Perso
14960
13614
  */
14961
13615
  declare function runPersonified<Task, D>(options: RunPersonifiedOptions<Task, D>): Promise<SupervisedResult<Outcome<D>>>;
14962
13616
  //#endregion
14963
- //#region src/runtime/personify/registry.d.ts
14964
- /**
14965
- * Build a fresh open `ShapeRegistry`. A factory is stored type-erased and re-cast on resolve — the
14966
- * caller asserts the `<Task, D>` it expects, exactly as the executor registry stores its factories.
14967
- */
14968
- declare function createShapeRegistry(): ShapeRegistry;
14969
- /** The default registry `runPersonified` resolves a shape name against. Empty by construction —
14970
- * a caller registers its own composed shapes; the engine ships no domain shape. */
14971
- declare const builtinShapes: ShapeRegistry;
14972
- /** Register a composed shape on the default `builtinShapes` registry — the one-call extension
14973
- * point a caller invokes so its shape is resolvable by name with zero edits to the engine. */
14974
- declare function registerShape<Task, D>(name: string, factory: LoopShape<Task, D>): void;
14975
- //#endregion
14976
13617
  //#region src/runtime/personify/trajectory.d.ts
14977
13618
  /**
14978
13619
  * Reconstruct the whole spawn tree for `root` with per-node + rolled-up `Spend`. Reads the
@@ -15076,144 +13717,18 @@ interface PrivateCasArtifactPort extends AgentCandidateOutputArtifactPort {
15076
13717
  * Bytes are written to the host first. With a durable store, every object is also copied off the
15077
13718
  * host as it is written, and `localBudgetBytes` bounds what the host keeps: an object's local copy
15078
13719
  * is deleted only after its durable receipt exists, and reads fall back to the durable store.
15079
- */
15080
- declare function createPrivateCasArtifactPort(root: string, namespace: string, options?: PrivateCasOptions): PrivateCasArtifactPort;
15081
- //#endregion
15082
- //#region src/runtime/stream-agent-turn.d.ts
15083
- /**
15084
- * The execution substrate one turn runs on — a closed discriminated union over
15085
- * the three stream surfaces the runtime already owns.
15086
- *
15087
- * @stable
15088
- */
15089
- type AgentTurnBackend = {
15090
- /** A Runtime-owned executor factory materialized from this exact canonical profile. */
15091
- kind: 'executor';
15092
- factory: ExecutorFactory<unknown>;
15093
- /** Exact canonical identity materialized by the executor. */
15094
- profile: AgentProfile;
15095
- /** Model label stamped on cost-only `llm_call` events. Default `'agent'`. */
15096
- agentRunName?: string;
15097
- };
15098
- /** @stable */
15099
- interface StreamAgentTurnOptions {
15100
- /** Caller-initiated cancellation. Terminates the stream with `final.status: 'aborted'`. */
15101
- signal?: AbortSignal;
15102
- /**
15103
- * Wall-clock deadline for the whole turn in ms. An expired deadline aborts
15104
- * the backend and terminates the stream with `final.status: 'failed'`
15105
- * (a blown deadline is a turn failure, not a caller cancellation).
15106
- */
15107
- timeoutMs?: number;
15108
- /** Stable logical paid-call id, forwarded as the provider idempotency key and retained in evidence. */
15109
- callId?: string;
15110
- /** Caller trace tag retained in evidence and forwarded when the transport supports it. */
15111
- correlationId?: string;
15112
- /**
15113
- * Opt-in tool-part projection for box and executor backends: sandbox tool
15114
- * parts additionally surface in-stream as
15115
- * `tool_call` / `tool_result` events (`mapSandboxToolEvent`), so a consumer
15116
- * rendering tool activity needs no bespoke sandbox-event parser. Default
15117
- * off — the stream vocabulary existing consumers see is unchanged. No-op
15118
- * for the `chat` kind (its backend emits `RuntimeStreamEvent`s directly,
15119
- * tool events included when the backend produces them).
15120
- */
15121
- preserveToolParts?: boolean;
15122
- /**
15123
- * Raw-event tap for box-kind backends: called (and awaited) with every
15124
- * unmapped `SandboxEvent` BEFORE it is projected, so a consumer can read
15125
- * parts the chat-UX projection drops (part ids, step markers, custom
15126
- * backend events) without forking the mapper. Purely observational — it
15127
- * cannot alter the mapped stream. Never called for the `chat` kind, which
15128
- * has no sandbox events.
15129
- */
15130
- onRawEvent?: (event: SandboxEvent) => void | Promise<void>;
15131
- }
15132
- /**
15133
- * Metered usage of one turn, summed over every cost-bearing event the backend
15134
- * emitted. `input`/`output` are token counts and are accompanied by
15135
- * `tokensKnown: false` when the backend did not report them. `costUsd`/`model`
15136
- * are present only when the backend actually reported them.
15137
- *
15138
- * @stable
15139
- */
15140
- interface AgentTurnUsage {
15141
- input: number;
15142
- output: number;
15143
- /** Present when a real turn ran but the provider did not report token usage. */
15144
- tokensKnown?: false;
15145
- costUsd?: number;
15146
- /** Present when Runtime could not prove the full dollar amount. */
15147
- usdKnown?: false;
15148
- /** Separately-labelled local/catalog estimate; never billed spend. */
15149
- estimatedCostUsd?: number;
15150
- /** Provider-reported prompt-cache fields; absent fields remain unknown. */
15151
- promptCache?: Readonly<Record<string, number | string>>;
15152
- /** Provider-reported reasoning-token subset of output, when available. */
15153
- reasoningTokens?: number;
15154
- model?: string;
15155
- }
15156
- /**
15157
- * A drained turn: the terminal summary plus every event the stream yielded.
15158
- * `status`/`error` mirror the terminal `final` event so a failed or aborted
15159
- * turn stays inspectable without re-scanning `events`.
15160
- *
15161
- * @stable
15162
- */
15163
- interface CollectedAgentTurn {
15164
- finalText: string;
15165
- /** Exact terminal artifact output from a Runtime-owned executor. */
15166
- output?: unknown;
15167
- usage: AgentTurnUsage;
15168
- /** Exact underlying transport calls when the Runtime-owned executor reports them. */
15169
- transportAttempts?: number;
15170
- toolCalls: Array<{
15171
- id?: string;
15172
- name: string;
15173
- arguments: string;
15174
- }>;
15175
- events: RuntimeStreamEvent[];
15176
- status: AgentTaskStatus;
15177
- error?: BackendErrorDetail;
15178
- /** Public Sandbox outcome, when the turn ran through a Sandbox stream or executor. */
15179
- sandboxOutcome?: AgentRunOutcome;
15180
- }
15181
- /**
15182
- * Run ONE agent turn on any backend kind and stream its events. Yields the
15183
- * `RuntimeStreamEvent` vocabulary incrementally and always ends with a `final`
15184
- * event carrying the turn's text and usage (`metadata.tokenUsage`,
15185
- * `metadata.costUsd?`, `metadata.model?`) — on success, failure, abort, and
15186
- * timeout alike. The generator never throws; failures surface in-band as
15187
- * `backend_error` + `final` with a typed `error` detail.
15188
- *
15189
- * @stable
15190
- */
15191
- declare function streamAgentTurn(backend: AgentTurnBackend, input: AgentTurnInput, opts?: StreamAgentTurnOptions): AsyncGenerator<RuntimeStreamEvent>;
15192
- /**
15193
- * Drain a `streamAgentTurn` stream (or any `RuntimeStreamEvent` stream that
15194
- * honors its terminal contract) into the turn summary plus the full event
15195
- * list. Fail-loud: throws when the stream ends without a terminal `final`
15196
- * event — a stream that violates the contract must not read as an empty turn.
15197
13720
  *
15198
- * @stable
15199
- */
15200
- declare function collectAgentTurn(stream: AsyncIterable<RuntimeStreamEvent>): Promise<CollectedAgentTurn>;
15201
- //#endregion
15202
- //#region src/runtime/supervise/model-policy.d.ts
15203
- /**
15204
- * Throw a `ConfigError` when `allowed` is set, `model` is defined, and `model` is not a
15205
- * member of `allowed`. No-op when `allowed` is unset (the unrestricted default) or when
15206
- * `model` is undefined (nothing was configured to check).
13721
+ * An object's name is published only after its bytes are synced, and that order is what makes a
13722
+ * name trustworthy. A put whose digest already exists links nothing: it re-reads the existing
13723
+ * object and refuses on a mismatch, and no later put replaces that file. So a deferred-sync mode
13724
+ * that published names before one batch sync would, after a crash, leave a torn object under its
13725
+ * valid name, and every later put of that digest would fail. Any batching must keep the order:
13726
+ * write under temporary names, sync, publish the names, sync again (discovery-lab
13727
+ * runner/evidence-store.mjs commits receipts this way). On drew-gtr-pro's USB SMR disk on
13728
+ * 2026-10-21 these per-object fsyncs, 545 ms each on the 16 SYNC_THREADS, set a store's rate at
13729
+ * about 26 files/s.
15207
13730
  */
15208
- declare function assertModelAllowed(model: string | undefined, allowed: readonly string[] | undefined): void;
15209
- /** Check every canonical model-bearing field in a complete profile, including the models a
15210
- * backend may select for cheap work, named subagents, or modes.
15211
- *
15212
- * Every compared value is a bare model id. The composed `harness/provider/model` wire id
15213
- * (`profileBridgeWireModel`) is neither built nor compared here, so this admits any route that
15214
- * declares an allowed id, and a qualified entry in `allowed` matches nothing. Route pinning
15215
- * belongs to `SuperviseOptions.authorizeSpawn`. */
15216
- declare function assertProfileModelsAllowed(profile: AgentProfile, allowed: readonly string[] | undefined): void;
13731
+ declare function createPrivateCasArtifactPort(root: string, namespace: string, options?: PrivateCasOptions): PrivateCasArtifactPort;
15217
13732
  //#endregion
15218
13733
  //#region src/runtime/profile-chat-client.d.ts
15219
13734
  /** Profile-exact adapter for packages that consume agent-eval's ChatClient contract.
@@ -15518,22 +14033,6 @@ declare function createSandboxLineage(client: SandboxClient, options?: {
15518
14033
  beforeDelete?: (box: SandboxInstance) => Promise<void>;
15519
14034
  onAcquire?: (box: SandboxInstance, profile: AgentProfile) => void;
15520
14035
  }): SandboxLineage;
15521
- /** Loop-side view of the current Sandbox SDK's live branch method. @experimental */
15522
- interface BranchCapableBox {
15523
- branch?: (count: number, options?: BranchOptions) => Promise<SandboxInstance[]>;
15524
- }
15525
- /**
15526
- * Loop-side widening of the box's optional session accessor. The real
15527
- * `SandboxInstance` exposes `session(id).status()`; the loop reads it optionally
15528
- * so `continue` can assert session liveness without requiring it of the test
15529
- * fakes. `status()` resolves `null` when the id is unknown to the sandbox.
15530
- * @experimental
15531
- */
15532
- interface SessionCapableBox {
15533
- session?: (id: string) => {
15534
- status: () => Promise<unknown | null>;
15535
- };
15536
- }
15537
14036
  //#endregion
15538
14037
  //#region src/runtime/sandbox-run.d.ts
15539
14038
  /**
@@ -15752,51 +14251,171 @@ interface TournamentRow {
15752
14251
  rep: number;
15753
14252
  cells: Record<string, TournamentCell>;
15754
14253
  }
15755
- /** Every settled cell of one split, by task and strategy. Strategies measured on different
15756
- * tasks have unpaired means; compare them with the paired `selection` estimates. */
15757
- interface StrategyTournament {
15758
- split: SearchSplit;
15759
- rows: TournamentRow[];
15760
- perStrategy: Record<string, {
15761
- cells: number;
15762
- scored: number;
15763
- score: number | null;
15764
- usd: number;
15765
- usdKnown: boolean;
14254
+ /** Every settled cell of one split, by task and strategy. Strategies measured on different
14255
+ * tasks have unpaired means; compare them with the paired `selection` estimates. */
14256
+ interface StrategyTournament {
14257
+ split: SearchSplit;
14258
+ rows: TournamentRow[];
14259
+ perStrategy: Record<string, {
14260
+ cells: number;
14261
+ scored: number;
14262
+ score: number | null;
14263
+ usd: number;
14264
+ usdKnown: boolean;
14265
+ }>;
14266
+ }
14267
+ interface EvolutionReport {
14268
+ searchId: string;
14269
+ /** The search ledger: the only record and checkpoint. */
14270
+ ledger: string;
14271
+ closeReason: SearchCloseReason;
14272
+ /** Root first, in registration order. */
14273
+ strategies: EvolutionStrategy[];
14274
+ /** The strategy the search keeps: the claim's selection, else the root. */
14275
+ selected: EvolutionStrategy;
14276
+ claim: SearchClaim;
14277
+ claimVerification: SearchClaimVerification;
14278
+ /** `ship` only when the claim shipped, re-derives from the ledger, every cost is known, and
14279
+ * the shipped finalist's test lower bound is above zero. */
14280
+ decision: 'ship' | 'hold';
14281
+ reason: string;
14282
+ tournament: Record<SearchSplit, StrategyTournament>;
14283
+ /** Known dollars, proven floors of unknown ones, and how many cells and operations (an
14284
+ * authoring an interrupted process lost, for example) have an unknown cost. */
14285
+ spend: {
14286
+ knownUsd: number;
14287
+ floorUsd: number;
14288
+ unknownCostCells: number;
14289
+ unknownCostOperations: number;
14290
+ };
14291
+ }
14292
+ /** Evolve a strategy on the search kernel and claim once on the sealed test split. */
14293
+ declare function runStrategyEvolution(cfg: StrategyEvolutionConfig): Promise<EvolutionReport>;
14294
+ /**
14295
+ * The tournament on one split, projected from the ledger: each settled cell's final attempt,
14296
+ * by task and repeat, keyed by strategy name. `names` maps node ids to report names.
14297
+ */
14298
+ declare function strategyTournament(state: SearchStateView, split: SearchSplit, names: ReadonlyMap<string, string>): StrategyTournament;
14299
+ //#endregion
14300
+ //#region src/runtime/stream-agent-turn.d.ts
14301
+ /**
14302
+ * The execution substrate one turn runs on — a closed discriminated union over
14303
+ * the three stream surfaces the runtime already owns.
14304
+ *
14305
+ * @stable
14306
+ */
14307
+ type AgentTurnBackend = {
14308
+ /** A Runtime-owned executor factory materialized from this exact canonical profile. */
14309
+ kind: 'executor';
14310
+ factory: ExecutorFactory<unknown>;
14311
+ /** Exact canonical identity materialized by the executor. */
14312
+ profile: AgentProfile;
14313
+ /** Model label stamped on cost-only `llm_call` events. Default `'agent'`. */
14314
+ agentRunName?: string;
14315
+ };
14316
+ /** @stable */
14317
+ interface StreamAgentTurnOptions {
14318
+ /** Caller-initiated cancellation. Terminates the stream with `final.status: 'aborted'`. */
14319
+ signal?: AbortSignal;
14320
+ /**
14321
+ * Wall-clock deadline for the whole turn in ms. An expired deadline aborts
14322
+ * the backend and terminates the stream with `final.status: 'failed'`
14323
+ * (a blown deadline is a turn failure, not a caller cancellation).
14324
+ */
14325
+ timeoutMs?: number;
14326
+ /** Stable logical paid-call id, forwarded as the provider idempotency key and retained in evidence. */
14327
+ callId?: string;
14328
+ /** Caller trace tag retained in evidence and forwarded when the transport supports it. */
14329
+ correlationId?: string;
14330
+ /**
14331
+ * Opt-in tool-part projection for box and executor backends: sandbox tool
14332
+ * parts additionally surface in-stream as
14333
+ * `tool_call` / `tool_result` events (`mapSandboxToolEvent`), so a consumer
14334
+ * rendering tool activity needs no bespoke sandbox-event parser. Default
14335
+ * off — the stream vocabulary existing consumers see is unchanged. No-op
14336
+ * for the `chat` kind (its backend emits `RuntimeStreamEvent`s directly,
14337
+ * tool events included when the backend produces them).
14338
+ */
14339
+ preserveToolParts?: boolean;
14340
+ /**
14341
+ * Raw-event tap for box-kind backends: called (and awaited) with every
14342
+ * unmapped `SandboxEvent` BEFORE it is projected, so a consumer can read
14343
+ * parts the chat-UX projection drops (part ids, step markers, custom
14344
+ * backend events) without forking the mapper. Purely observational — it
14345
+ * cannot alter the mapped stream. Never called for the `chat` kind, which
14346
+ * has no sandbox events.
14347
+ */
14348
+ onRawEvent?: (event: SandboxEvent) => void | Promise<void>;
14349
+ }
14350
+ /**
14351
+ * Metered usage of one turn, summed over every cost-bearing event the backend
14352
+ * emitted. `input`/`output` are token counts and are accompanied by
14353
+ * `tokensKnown: false` when the backend did not report them. `costUsd`/`model`
14354
+ * are present only when the backend actually reported them.
14355
+ *
14356
+ * @stable
14357
+ */
14358
+ interface AgentTurnUsage {
14359
+ input: number;
14360
+ output: number;
14361
+ /** Present when a real turn ran but the provider did not report token usage. */
14362
+ tokensKnown?: false;
14363
+ costUsd?: number;
14364
+ /** Present when Runtime could not prove the full dollar amount. */
14365
+ usdKnown?: false;
14366
+ /** Separately-labelled local/catalog estimate; never billed spend. */
14367
+ estimatedCostUsd?: number;
14368
+ /** Provider-reported prompt-cache fields; absent fields remain unknown. */
14369
+ promptCache?: Readonly<Record<string, number | string>>;
14370
+ /** Provider-reported reasoning-token subset of output, when available. */
14371
+ reasoningTokens?: number;
14372
+ model?: string;
14373
+ }
14374
+ /**
14375
+ * A drained turn: the terminal summary plus every event the stream yielded.
14376
+ * `status`/`error` mirror the terminal `final` event so a failed or aborted
14377
+ * turn stays inspectable without re-scanning `events`.
14378
+ *
14379
+ * @stable
14380
+ */
14381
+ interface CollectedAgentTurn {
14382
+ finalText: string;
14383
+ /** Exact terminal artifact output from a Runtime-owned executor. */
14384
+ output?: unknown;
14385
+ usage: AgentTurnUsage;
14386
+ /** Exact underlying transport calls when the Runtime-owned executor reports them. */
14387
+ transportAttempts?: number;
14388
+ toolCalls: Array<{
14389
+ id?: string;
14390
+ name: string;
14391
+ arguments: string;
15766
14392
  }>;
14393
+ events: RuntimeStreamEvent[];
14394
+ status: AgentTaskStatus;
14395
+ error?: BackendErrorDetail;
14396
+ /** Public Sandbox outcome, when the turn ran through a Sandbox stream or executor. */
14397
+ sandboxOutcome?: AgentRunOutcome;
15767
14398
  }
15768
- interface EvolutionReport {
15769
- searchId: string;
15770
- /** The search ledger: the only record and checkpoint. */
15771
- ledger: string;
15772
- closeReason: SearchCloseReason;
15773
- /** Root first, in registration order. */
15774
- strategies: EvolutionStrategy[];
15775
- /** The strategy the search keeps: the claim's selection, else the root. */
15776
- selected: EvolutionStrategy;
15777
- claim: SearchClaim;
15778
- claimVerification: SearchClaimVerification;
15779
- /** `ship` only when the claim shipped, re-derives from the ledger, every cost is known, and
15780
- * the shipped finalist's test lower bound is above zero. */
15781
- decision: 'ship' | 'hold';
15782
- reason: string;
15783
- tournament: Record<SearchSplit, StrategyTournament>;
15784
- /** Known dollars, proven floors of unknown ones, and how many cells and operations (an
15785
- * authoring an interrupted process lost, for example) have an unknown cost. */
15786
- spend: {
15787
- knownUsd: number;
15788
- floorUsd: number;
15789
- unknownCostCells: number;
15790
- unknownCostOperations: number;
15791
- };
15792
- }
15793
- /** Evolve a strategy on the search kernel and claim once on the sealed test split. */
15794
- declare function runStrategyEvolution(cfg: StrategyEvolutionConfig): Promise<EvolutionReport>;
15795
14399
  /**
15796
- * The tournament on one split, projected from the ledger: each settled cell's final attempt,
15797
- * by task and repeat, keyed by strategy name. `names` maps node ids to report names.
14400
+ * Run ONE agent turn on any backend kind and stream its events. Yields the
14401
+ * `RuntimeStreamEvent` vocabulary incrementally and always ends with a `final`
14402
+ * event carrying the turn's text and usage (`metadata.tokenUsage`,
14403
+ * `metadata.costUsd?`, `metadata.model?`) — on success, failure, abort, and
14404
+ * timeout alike. The generator never throws; failures surface in-band as
14405
+ * `backend_error` + `final` with a typed `error` detail.
14406
+ *
14407
+ * @stable
15798
14408
  */
15799
- declare function strategyTournament(state: SearchStateView, split: SearchSplit, names: ReadonlyMap<string, string>): StrategyTournament;
14409
+ declare function streamAgentTurn(backend: AgentTurnBackend, input: AgentTurnInput, opts?: StreamAgentTurnOptions): AsyncGenerator<RuntimeStreamEvent>;
14410
+ /**
14411
+ * Drain a `streamAgentTurn` stream (or any `RuntimeStreamEvent` stream that
14412
+ * honors its terminal contract) into the turn summary plus the full event
14413
+ * list. Fail-loud: throws when the stream ends without a terminal `final`
14414
+ * event — a stream that violates the contract must not read as an empty turn.
14415
+ *
14416
+ * @stable
14417
+ */
14418
+ declare function collectAgentTurn(stream: AsyncIterable<RuntimeStreamEvent>): Promise<CollectedAgentTurn>;
15800
14419
  //#endregion
15801
14420
  //#region src/runtime/structural-rollout.d.ts
15802
14421
  /** Provider-neutral conversation records read by structural candidate extraction. */
@@ -16080,6 +14699,30 @@ interface ChatWorkerSeamOptions {
16080
14699
  /** Session-owning worker factory for graph continuity. */
16081
14700
  declare function chatWorkerSeam(opts: ChatWorkerSeamOptions): MakeWorkerAgent;
16082
14701
  //#endregion
14702
+ //#region src/runtime/supervise/worker-events.d.ts
14703
+ /** Live observation is bounded and process-local. A reconnect explicitly reports expired history. */
14704
+ interface WorkerEventCursor {
14705
+ readonly epoch: string;
14706
+ readonly next: number;
14707
+ }
14708
+ interface WorkerEventEntry {
14709
+ readonly sequence: number;
14710
+ readonly at: number;
14711
+ readonly event: unknown;
14712
+ readonly omitted?: 'event-too-large' | 'event-not-serializable';
14713
+ }
14714
+ type WorkerEventPage = {
14715
+ readonly status: 'unavailable';
14716
+ readonly reason: 'unknown-worker' | 'not-captured';
14717
+ } | {
14718
+ readonly status: 'available';
14719
+ readonly entries: readonly WorkerEventEntry[];
14720
+ readonly cursor: WorkerEventCursor;
14721
+ readonly reset: boolean;
14722
+ readonly historyExpired: boolean;
14723
+ readonly remaining: number;
14724
+ };
14725
+ //#endregion
16083
14726
  //#region src/runtime/supervise/contracts/agent-scope.d.ts
16084
14727
  /**
16085
14728
  * One self-similar atom. A leaf is an `Agent` that never calls `scope.spawn`; a driver
@@ -17606,42 +16249,6 @@ interface InPlaceCliExecutorOptions {
17606
16249
  */
17607
16250
  declare function createInPlaceCliExecutor(options: InPlaceCliExecutorOptions): Executor<InPlaceHarnessResult>;
17608
16251
  //#endregion
17609
- //#region src/runtime/supervise/interactive-admission.d.ts
17610
- /** The credential-free record written for one interactive admission phase. */
17611
- type WorkerInteractiveAdmission = {
17612
- readonly schemaVersion: 1;
17613
- readonly workerId: string;
17614
- readonly recordedAt: string;
17615
- readonly phase: 'interactive_intent';
17616
- readonly provider: string;
17617
- readonly idempotencyKey: string;
17618
- readonly interactiveIdempotencyKey: string;
17619
- readonly sessionId: string;
17620
- readonly executionId: string;
17621
- readonly runId: string;
17622
- readonly requestedProfileDigest: `sha256:${string}`;
17623
- readonly requestDigest: `sha256:${string}`;
17624
- } | {
17625
- readonly schemaVersion: 1;
17626
- readonly workerId: string;
17627
- readonly recordedAt: string;
17628
- readonly phase: 'interactive_environment';
17629
- readonly provider: string;
17630
- readonly environmentId: string;
17631
- readonly idempotencyKey: string;
17632
- readonly interactiveIdempotencyKey: string;
17633
- readonly requestDigest: `sha256:${string}`;
17634
- } | {
17635
- readonly schemaVersion: 1;
17636
- readonly workerId: string;
17637
- readonly recordedAt: string;
17638
- readonly phase: 'interactive_started';
17639
- readonly idempotencyKey: string;
17640
- readonly interactiveIdempotencyKey: string;
17641
- readonly ref: AgentInteractiveSessionRef;
17642
- readonly refDigest: `sha256:${string}`;
17643
- };
17644
- //#endregion
17645
16252
  //#region src/runtime/supervise/interactive-worker.d.ts
17646
16253
  /** Environment fields supplied to every interactive worker after Runtime adds the exact profile. */
17647
16254
  type InteractiveWorkerEnvironment = Omit<CreateAgentEnvironmentInput, 'profile' | 'idempotencyKey' | 'signal'>;
@@ -17697,105 +16304,6 @@ interface InteractiveWorkerKeyInput {
17697
16304
  */
17698
16305
  declare function workerFromInteractiveProvider(provider: AgentEnvironmentProvider, options?: InteractiveWorkerOptions): MakeWorkerAgent;
17699
16306
  //#endregion
17700
- //#region src/runtime/supervise/patch-checks.d.ts
17701
- /** @experimental The per-task constraints the mechanical gate enforces. */
17702
- interface CoderCheckConstraints {
17703
- /** Default 400. Hard cap; gate fails when exceeded. */
17704
- maxDiffLines?: number;
17705
- /** Literal path prefixes the patch must not touch. */
17706
- forbiddenPaths?: string[];
17707
- }
17708
- //#endregion
17709
- //#region src/runtime/supervise/worktree-cli-executor.d.ts
17710
- /** Terminal artifact of one worktree-CLI run — the canonical worktree-harness result (the captured
17711
- * diff + the harness's run record + the derived checks). */
17712
- type WorktreePatchArtifact = WorktreeHarnessResult;
17713
- /** @experimental */
17714
- interface WorktreeCliExecutorOptions {
17715
- /** Absolute path to the git checkout the worktree is cut from. */
17716
- repoRoot: string;
17717
- /**
17718
- * The supervisor-authored prompt/model plus materializable structural resources.
17719
- * `model.default` selects the one-shot model. Routing-only model hints, placement concerns,
17720
- * provider extensions, and `resources.failOnError` fail before execution because this path
17721
- * cannot honor them. Harness-specific values the materializer cannot preserve also fail closed.
17722
- */
17723
- profile: AgentProfile;
17724
- /** Default instruction for direct `execute(undefined, signal)` calls. An execution-time task
17725
- * is authoritative. Omit when the caller always supplies the task to `execute`. */
17726
- taskPrompt?: string;
17727
- /** Unique id for the worktree path + branch. Defaults to a fresh UUID. */
17728
- runId?: string;
17729
- /** Override the base ref the worktree is cut from (default `HEAD`). */
17730
- baseRef?: string;
17731
- /** Optional wall-clock cap per harness subprocess (ms). Omit it for no timer. */
17732
- harnessTimeoutMs?: number;
17733
- /** Run Codex with an ephemeral session, isolated config/instructions, network disabled, and
17734
- * JSONL usage capture. Requires `profile.harness: 'codex'`; metered by default. */
17735
- codexReproducible?: boolean;
17736
- /** Absolute host paths denied to reproducible Codex (for benchmark answer copies, credentials,
17737
- * or other task-specific ambient state). */
17738
- codexReadDeniedPaths?: ReadonlyArray<string>;
17739
- /**
17740
- * Shell command run in the live worktree to derive the tests-PASS signal (e.g. `pnpm test`).
17741
- * Its exit code becomes `artifact.checks.tests.passed`. Omit to skip (no signal derived).
17742
- */
17743
- testCmd?: string;
17744
- /** Shell command run in the live worktree to derive the typecheck-PASS signal (e.g. `pnpm typecheck`). */
17745
- typecheckCmd?: string;
17746
- /** Wall-clock cap per verification command (ms). Default = `harnessTimeoutMs` or 5 min. */
17747
- checkTimeoutMs?: number;
17748
- /** Cap on each check's captured output. Default 16k. */
17749
- checkOutputCap?: number;
17750
- /** Test seam — inject a git runner so unit tests drive the worktree helpers without git. */
17751
- runGit?: GitRunner;
17752
- /** Test seam — inject the harness runner so unit tests script a `LocalHarnessResult`. */
17753
- runHarness?: typeof runLocalHarness;
17754
- /** Test seam — inject the verification-command runner so unit tests script test/typecheck
17755
- * outcomes without spawning a real shell. Defaults to a `/bin/sh -c` spawn in the worktree. */
17756
- runCommand?: WorktreeCheckRunner;
17757
- /**
17758
- * Exclude this leaf's spend from accounting. Defaults to `true` for ordinary CLI runs and
17759
- * `false` for `codexReproducible`, which captures real token usage. A metered custom runner must
17760
- * likewise return `LocalHarnessResult.usage`.
17761
- */
17762
- budgetExempt?: boolean;
17763
- /** @internal Kernel-minted attempt identity threaded by the built-in registry. */
17764
- executionAttemptId?: string;
17765
- }
17766
- /**
17767
- * Build a worktree-CLI leaf `Executor`. Per-spawn (a fresh worktree + abort + teardown each), so a
17768
- * fanout of N profiles = N parallel worktrees that never clobber each other.
17769
- *
17770
- * Fail-loud: an empty `repoRoot`, an incomplete/unsupported profile, a separate harness override,
17771
- * or an explicitly empty `taskPrompt` throws at construction. Calling `execute(undefined, signal)`
17772
- * without a configured prompt throws before a worktree is created. `resultArtifact()` before
17773
- * `execute()` resolves throws.
17774
- *
17775
- * @experimental
17776
- */
17777
- declare function createWorktreeCliExecutor(options: WorktreeCliExecutorOptions): Executor<WorktreePatchArtifact>;
17778
- //#endregion
17779
- //#region src/runtime/supervise/patch-deliverable.d.ts
17780
- /** @experimental */
17781
- interface PatchDeliverableOptions extends CoderCheckConstraints {
17782
- /**
17783
- * Which verification signals the gate REQUIRES to be present-and-passing. A required signal
17784
- * that the artifact never derived (the command was not configured on the executor) fails the
17785
- * gate closed. Unlisted signals default to passed-when-absent (the executor simply didn't run
17786
- * that command). Default `[]` — gate on no-op / secret / forbidden / diff-size only.
17787
- */
17788
- require?: ReadonlyArray<'tests' | 'typecheck'>;
17789
- }
17790
- /**
17791
- * Build the `DeliverableSpec<WorktreePatchArtifact>`: `check(artifact)` runs the shared mechanical
17792
- * gate (`runCoderChecks`) over the captured patch + the worktree-derived pass signals and returns
17793
- * whether the patch is DELIVERED (the `valid` conjunction).
17794
- *
17795
- * @experimental
17796
- */
17797
- declare function patchDelivered(options?: PatchDeliverableOptions): DeliverableSpec<WorktreePatchArtifact>;
17798
- //#endregion
17799
16307
  //#region src/runtime/supervise/profile-registry.d.ts
17800
16308
  /** One completed run of one exact profile revision, under its stable NAME. */
17801
16309
  interface ProfileRunRecord {
@@ -17968,20 +16476,6 @@ interface WriteWorkerSteerOptions {
17968
16476
  readonly source?: string;
17969
16477
  readonly interrupt?: boolean;
17970
16478
  }
17971
- /** One durable worker-scoped cancel request appended to the run's cancellation inbox. */
17972
- interface WorkerCancelRequest {
17973
- /** Caller-minted stable operation identifier — the idempotency key of the whole operation. */
17974
- readonly operationId: string;
17975
- /** ISO timestamp of the append. */
17976
- readonly at: string;
17977
- /** Who asked — 'human', a brain label, a tool name. Provenance, not authorization. */
17978
- readonly source: string;
17979
- /** The worker the request targets: a workerId (node id — routed to the owning manager at any
17980
- * depth), or a profile name or spawn label (resolved by the root manager against its direct
17981
- * children only). */
17982
- readonly worker: string;
17983
- readonly reason?: string;
17984
- }
17985
16479
  /**
17986
16480
  * The durable acknowledgement state for one worker-scoped cancel operation, keyed by
17987
16481
  * `operationId`. The runtime acknowledger is the ONLY writer; `cancelWorker` only reads it.
@@ -18041,35 +16535,10 @@ declare function supervisorRunDir(rootDir: string, id: string): string;
18041
16535
  * here anymore.
18042
16536
  */
18043
16537
  declare function legacySupervisorRunDir(rootDir: string, id: string): string;
18044
- /**
18045
- * The pre-rename runs root (`<root>/.loops/supervisor`). Only readers that ENUMERATE historical
18046
- * runs need this — the per-id form is {@link legacySupervisorRunDir}. Nothing writes here.
18047
- */
18048
- declare function legacySupervisorRunsRoot(rootDir: string): string;
18049
16538
  /** A worker label reduced to a safe filename stem. Empty labels get a stable fallback. */
18050
16539
  declare function safeWorkerFile(label: string): string;
18051
- /** The directory holding every per-worker file of one run (inboxes and control-event logs). */
18052
- declare function supervisorWorkersDir(eventDir: string): string;
18053
- /** The durable inbox file for one worker of one run. */
18054
- declare function workerInboxFile(rootDir: string, supervisorId: string, worker: string): string;
18055
16540
  /** Same, addressed from an already-known run directory (the reader's usual entry point). */
18056
16541
  declare function workerInboxFileFromEventDir(eventDir: string, worker: string): string;
18057
- /**
18058
- * The best-effort control-event log for one worker (`workers/<label>.ndjson`) — delivery
18059
- * bookkeeping for steers, plus whatever lifecycle events a writer chooses to append. Distinct from
18060
- * the inbox: the inbox is the durable down-leg queue, this is the record of what happened to it.
18061
- */
18062
- declare function workerControlLogFile(eventDir: string, worker: string): string;
18063
- /** Directory containing atomically admitted steer requests and runtime acknowledgements. */
18064
- declare function workerSteersDir(eventDir: string): string;
18065
- /** Directory containing one canonical request file per steer operation. */
18066
- declare function workerSteerRequestsDir(eventDir: string): string;
18067
- /** Directory containing one runtime acknowledgement per steer operation. */
18068
- declare function workerSteerAcknowledgementsDir(eventDir: string): string;
18069
- /** Canonical request file for one caller-owned steer operation id. */
18070
- declare function workerSteerRequestFile(eventDir: string, operationId: string): string;
18071
- /** Runtime acknowledgement file for one caller-owned steer operation id. */
18072
- declare function workerSteerAcknowledgementFile(eventDir: string, operationId: string): string;
18073
16542
  /**
18074
16543
  * Admit one steer exactly once under a caller-owned operation id.
18075
16544
  *
@@ -18093,24 +16562,7 @@ declare function writeWorkerSteer(rootDir: string, supervisorId: string, worker:
18093
16562
  /** Read every atomically admitted request for one exact worker id, in admission order. @stable */
18094
16563
  declare function readWorkerSteerRequests(eventDir: string, worker?: string): WorkerSteerRequest[];
18095
16564
  /** Read one runtime steer acknowledgement, or `undefined` while no manager has answered. @stable */
18096
- declare function readWorkerSteerAcknowledgement(eventDir: string, operationId: string): WorkerSteerAcknowledgement | undefined;
18097
- /** The directory holding every cancellation artifact of one run (request inbox + acknowledgements). */
18098
- declare function workerCancellationsDir(eventDir: string): string;
18099
- /**
18100
- * The durable cancel-request inbox of one run — one NDJSON line per {@link WorkerCancelRequest}.
18101
- * It stays append-only so independent operations retain admission order and readers can skip a
18102
- * partial trailing line. `appendDurableFile` uses O_APPEND, one write, file fsync, and directory
18103
- * fsync; single-record acknowledgements use atomic replacement instead.
18104
- */
18105
- declare function workerCancelRequestsFile(eventDir: string): string;
18106
- /**
18107
- * The acknowledgement file for one cancel operation. The filename is a sanitized stem of the
18108
- * `operationId`; the record inside carries the exact id, and readers verify it so two distinct
18109
- * ids that sanitize to one stem fail loud instead of answering for each other.
18110
- */
18111
- declare function workerCancellationFile(eventDir: string, operationId: string): string;
18112
- /** Read every valid cancel request in the run's cancellation inbox. Corrupt lines are skipped. */
18113
- declare function readWorkerCancelRequests(eventDir: string): WorkerCancelRequest[];
16565
+ declare function readWorkerSteerAcknowledgement(eventDir: string, operationId: string): WorkerSteerAcknowledgement | undefined;
18114
16566
  /**
18115
16567
  * Read the acknowledgement for one cancel operation. `undefined` when the runtime has not
18116
16568
  * answered. A record whose stored `operationId` differs from the requested one is a filename
@@ -18140,6 +16592,130 @@ declare function cancelWorker(eventDir: string, worker: string, operationId: str
18140
16592
  readonly source?: string;
18141
16593
  }): WorkerCancellation;
18142
16594
  //#endregion
16595
+ //#region src/runtime/supervise/scope-contract.d.ts
16596
+ /** Construction args for `createScope`. The supervisor threads the shared pool, journal,
16597
+ * blob store, and executor registry through; `depth`/`maxDepth` pair the runtime
16598
+ * recursion ceiling with the conserved pool (R3). */
16599
+ interface ScopeArgs {
16600
+ /** This scope's owning node id — children get `${parentId}:s${seq}` ids. */
16601
+ readonly parentId: NodeId;
16602
+ /** Journal/blob root key the supervisor `beginTree`'d. */
16603
+ readonly root: NodeId;
16604
+ /** The reservation pool for this scope: the root total or one nested allocated partition. */
16605
+ readonly pool: BudgetPool;
16606
+ /** Append-only spawn journal; this scope writes `spawned` + `settled` records. */
16607
+ readonly journal: SpawnJournal;
16608
+ /** Content-addressed result store backing `outRef` rehydration. */
16609
+ readonly blobs: ResultBlobStore;
16610
+ /** The open executor resolver (BYO → router/inline → registered harness factory). */
16611
+ readonly executors: ExecutorRegistry;
16612
+ /** Per-spawn executor-construction seams (sandbox client, router config, cli bin). */
16613
+ readonly seams: Readonly<Record<string, unknown>>;
16614
+ /** This scope's recursion depth (root = 0). */
16615
+ readonly depth: number;
16616
+ /** Runtime recursion-depth ceiling — a spawn past it fails closed `depth-exceeded`. */
16617
+ readonly maxDepth?: number;
16618
+ /** The allocator that bounds concurrently working agents across this scope, every nested scope,
16619
+ * and every other tree that shares it. Absent means no bound: only the budget limits concurrency. */
16620
+ readonly workerSlots?: WorkerSlots;
16621
+ /** @internal The slot this scope's own manager holds in its parent scope. A nested scope's first
16622
+ * running child works on it while the manager waits. Absent on a root scope. */
16623
+ readonly slotOwner?: SlotPermit;
16624
+ /** Optional policy that keeps part of each manager's budget for its own inference. */
16625
+ readonly reservationPolicy?: RecursiveReservationPolicy;
16626
+ /** The budget from which this scope's owner-share floor is derived. */
16627
+ readonly ownerBudget?: Budget;
16628
+ /** What a steerable child's own time box does: a check-in by default (`deadline.ts`
16629
+ * `DeadlineCheckIn`); `false` stops the child at its time box. Nested scopes inherit it. */
16630
+ readonly deadlineCheckIn?: DeadlineCheckIn;
16631
+ /** How long a keyed leaf whose turn ended over its budget keeps its environment for a same-key
16632
+ * re-spawn to continue (ms). Default `DEFAULT_BUDGET_STOP_HOLD_MS`; `0` keeps none.
16633
+ * Nested scopes inherit it. */
16634
+ readonly budgetStopHoldMs?: number;
16635
+ /** Abort signal for this scope; an abort cascades into every live child's executor. */
16636
+ readonly signal: AbortSignal;
16637
+ /** Injected clock — keeps the journal `at` timestamp deterministic in tests. */
16638
+ readonly now?: () => number;
16639
+ /** Lifecycle stream sink. `spawn` emits `agent.spawn`, `next` emits `agent.child` — the
16640
+ * SAME stream `runAgentRounds`/`tool-loop` feed, so the recursive tree is ONE observable stream
16641
+ * (the topology viewer reads it). Undefined ⇒ the journal stays the only record. */
16642
+ readonly hooks?: RuntimeHooks;
16643
+ /**
16644
+ * Trace context to hand down to each spawned worker (`SupervisorOpts.workerTrace`). Called with
16645
+ * THIS scope's own `parentId` — the node doing the spawning — and the resolved context is seeded
16646
+ * onto each child's `ExecutorContext` under `workerTraceSeamKey`. Absent (the untraced default)
16647
+ * ⇒ no seam is seeded and no worker environment is touched.
16648
+ */
16649
+ readonly workerTrace?: WorkerTraceResolver;
16650
+ /**
16651
+ * Present when this run RECORDS spans but the worker backend has NO channel to carry the trace
16652
+ * context (`WORKER_TRACE_PROPAGATION[backend] === false` — cli-worktree has no env
16653
+ * channel; router / router-tools / provider have no worker process). Each spawn then journals a
16654
+ * `trace-unpropagated` event naming the severed hop, so a child whose trace shows up as a
16655
+ * disconnected root is a recorded fact rather than a silent stranger. Absent ⇒ either the run
16656
+ * is untraced or the backend propagates; nothing is journaled.
16657
+ */
16658
+ readonly workerTraceUnpropagated?: {
16659
+ readonly backend: string;
16660
+ readonly reason: 'no-env-channel' | 'no-worker-process' | 'caller-omitted';
16661
+ };
16662
+ /** Durable run directory that receives exact worker interactive bindings. */
16663
+ readonly interactiveBindingDir?: string;
16664
+ /** @internal Trusted root-adapter publication channel. It is never exposed as a Scope method. */
16665
+ readonly ownerMaterialization?: {
16666
+ readonly runtime: NodeSnapshot['runtime'];
16667
+ readonly authoredProfile?: unknown;
16668
+ readonly attemptId: string;
16669
+ readonly prior?: ProfileMaterializationReceipt;
16670
+ readonly journalRoot?: NodeId;
16671
+ readonly nodeId?: NodeId;
16672
+ readonly requiredKnown?: boolean;
16673
+ readonly onReceipt?: (materialization: ProfileMaterializationReceipt, binding: ExecutionBindingReceipt) => void;
16674
+ };
16675
+ /**
16676
+ * Resume seam — set ONLY by the supervisor when `SupervisorOpts.resume` is on AND a non-empty
16677
+ * journal tree exists for this root. It carries the replayed committed work (so `scope.resume`
16678
+ * exposes it to a resume-aware `act`) and the recorded ordinal/cursor maxima the new counters
16679
+ * continue past, so a freshly-spawned child never reuses a journaled `seq`. Absent ⇒ fresh run.
16680
+ */
16681
+ readonly resumeFrom?: {
16682
+ /** @internal Executor adoption plans validated by the supervisor's recovery preparation. */
16683
+ readonly recoveries?: readonly RetainedChildRecovery[];
16684
+ readonly events?: readonly SpawnEvent[];
16685
+ readonly settled: ReadonlyArray<Settled<unknown>>;
16686
+ readonly view: TreeView;
16687
+ /** Highest `spawned` ordinal already journaled; new spawns start at `+1`. */
16688
+ readonly maxSpawnOrdinal: number;
16689
+ /** Highest cursor `seq` already journaled; new settlements start at `+1`. */
16690
+ readonly maxCursorSeq: number;
16691
+ /** Keyed assignments from the prior journal — what a keyed re-spawn resolves against. */
16692
+ readonly keys: ReadonlyMap<string, ResumedKeyState<unknown>>;
16693
+ /** Prior committed spend summed off the journal (settled child work + metered inference). */
16694
+ readonly priorSpend: {
16695
+ readonly childWork: Spend;
16696
+ readonly driverInference: Spend;
16697
+ };
16698
+ };
16699
+ }
16700
+ //#endregion
16701
+ //#region src/runtime/supervise/scope-construction.d.ts
16702
+ /** Create the reactive `Scope` a driver's `Agent.act` runs inside: spawn children on an atomically reserved conserved budget, settle via the `next()` cursor, journal for replay. */
16703
+ declare function createScope<Out>(args: ScopeArgs): Scope<Out>;
16704
+ //#endregion
16705
+ //#region src/runtime/supervise/scope-observation.d.ts
16706
+ /**
16707
+ * The step-8 merge-boundary adapter (M4): rehydrate a `Settled.done` into the kernel's
16708
+ * `Iteration` shape so `defaultSelectWinner` stays single-sourced — the supervisor selects
16709
+ * across settled children with the SAME argmax the loop kernel uses, not a forked copy.
16710
+ *
16711
+ * `index` is the cursor `seq` (the recorded, replay-stable order); `output`/`verdict`/
16712
+ * `tokenUsage`/`costUsd` are read straight off the settlement (already rehydrated from the
16713
+ * `outRef` blob by `next()`). Events are empty — a settled child is an opaque leaf result,
16714
+ * not a sandbox event stream — and the timing/cost fields project its conserved `Spend`.
16715
+ * Fail loud on a `down` settlement: only a `done` child is an iteration.
16716
+ */
16717
+ declare function settledToIteration<Out>(settled: Settled<Out>): Iteration<unknown, Out>;
16718
+ //#endregion
18143
16719
  //#region src/runtime/supervise/search-spec.d.ts
18144
16720
  /**
18145
16721
  * One multi-agent research configuration: seven orthogonal axes, all data.
@@ -18314,6 +16890,25 @@ interface FencedSqlRunContext extends RunContext {
18314
16890
  */
18315
16891
  declare function createFencedSqlRunContext(db: SqlAdapter, runId: string, options?: SqlRunContextOptions): Promise<FencedSqlRunContext>;
18316
16892
  //#endregion
16893
+ //#region src/runtime/supervise/supervisor-root-handle.d.ts
16894
+ /**
16895
+ * Mint a `RootHandle` plus its supervisor-private control. The handle is the substrate a
16896
+ * chat/pi-viz client attaches to (Q2): `view()` reads the live tree, `signal()` delivers
16897
+ * an out-of-band message, `abort()` cascades. Before `run` binds it (and after `run`
16898
+ * unbinds it) the handle is fail-loud: a client that talks to a handle that is not
16899
+ * driving a live run gets a typed error, never a silent no-op.
16900
+ */
16901
+ declare function createRootHandle<Out>(): SteerableRootHandle<Out>;
16902
+ //#endregion
16903
+ //#region src/runtime/supervise/supervisor-run.d.ts
16904
+ /** The default recursion-depth ceiling. The conserved pool is what bounds a tree's depth: every
16905
+ * level draws its slice from the level above, so a tree ends when its slices run out. This
16906
+ * ceiling only stops a runaway recursion that keeps spawning tiny slices, so it sits well above
16907
+ * any depth a budget can usefully pay for. */
16908
+ declare const DEFAULT_MAX_DEPTH = 16;
16909
+ /** Create a supervisor that owns one recursive agent execution tree. */
16910
+ declare function createSupervisor<Task, Out>(): Supervisor<Task, Out>;
16911
+ //#endregion
18317
16912
  //#region src/runtime/supervise/trace-evidence.d.ts
18318
16913
  /** Schema version for content-addressed worker tool-trace artifacts. */
18319
16914
  declare const WORKER_TOOL_TRACE_SCHEMA_VERSION: 1;
@@ -18322,10 +16917,6 @@ interface WorkerToolTraceArtifact {
18322
16917
  readonly schemaVersion: typeof WORKER_TOOL_TRACE_SCHEMA_VERSION;
18323
16918
  readonly spans: ReadonlyArray<ToolSpan>;
18324
16919
  }
18325
- /** Collect and persist one executor's structured tool trace without changing its task outcome. */
18326
- declare function captureWorkerTraceEvidence(readSource: (() => TraceSource | undefined) | undefined, blobs: ResultBlobStore, executed: boolean): Promise<WorkerTraceEvidence>;
18327
- /** Rehydrate exact persisted spans through agent-eval's one bounded trace-analysis adapter. */
18328
- declare function workerTraceAnalysisStore(evidence: WorkerTraceEvidence, blobs: Pick<ResultBlobStore, 'get'>): Promise<TraceAnalysisStore>;
18329
16920
  /** Validate a stored trace artifact before an analyst or replay trusts it. */
18330
16921
  declare function parseWorkerToolTraceArtifact(value: unknown, traceRef?: string): WorkerToolTraceArtifact;
18331
16922
  //#endregion
@@ -18527,6 +17118,97 @@ declare function readWorkerInteractiveBinding(eventDir: string, workerId: string
18527
17118
  */
18528
17119
  declare function attachWorker(eventDir: string, workerId: string, options: AttachWorkerOptions): Promise<WorkerInteractiveSession>;
18529
17120
  //#endregion
17121
+ //#region src/runtime/supervise/worktree-cli-executor.d.ts
17122
+ /** Terminal artifact of one worktree-CLI run — the canonical worktree-harness result (the captured
17123
+ * diff + the harness's run record + the derived checks). */
17124
+ type WorktreePatchArtifact = WorktreeHarnessResult;
17125
+ /** @experimental */
17126
+ interface WorktreeCliExecutorOptions {
17127
+ /** Absolute path to the git checkout the worktree is cut from. */
17128
+ repoRoot: string;
17129
+ /**
17130
+ * The supervisor-authored prompt/model plus materializable structural resources.
17131
+ * `model.default` selects the one-shot model. Routing-only model hints, placement concerns,
17132
+ * provider extensions, and `resources.failOnError` fail before execution because this path
17133
+ * cannot honor them. Harness-specific values the materializer cannot preserve also fail closed.
17134
+ */
17135
+ profile: AgentProfile;
17136
+ /** Default instruction for direct `execute(undefined, signal)` calls. An execution-time task
17137
+ * is authoritative. Omit when the caller always supplies the task to `execute`. */
17138
+ taskPrompt?: string;
17139
+ /** Unique id for the worktree path + branch. Defaults to a fresh UUID. */
17140
+ runId?: string;
17141
+ /** Override the base ref the worktree is cut from (default `HEAD`). */
17142
+ baseRef?: string;
17143
+ /** Optional wall-clock cap per harness subprocess (ms). Omit it for no timer. */
17144
+ harnessTimeoutMs?: number;
17145
+ /** Run Codex with an ephemeral session, isolated config/instructions, network disabled, and
17146
+ * JSONL usage capture. Requires `profile.harness: 'codex'`; metered by default. */
17147
+ codexReproducible?: boolean;
17148
+ /** Absolute host paths denied to reproducible Codex (for benchmark answer copies, credentials,
17149
+ * or other task-specific ambient state). */
17150
+ codexReadDeniedPaths?: ReadonlyArray<string>;
17151
+ /**
17152
+ * Shell command run in the live worktree to derive the tests-PASS signal (e.g. `pnpm test`).
17153
+ * Its exit code becomes `artifact.checks.tests.passed`. Omit to skip (no signal derived).
17154
+ */
17155
+ testCmd?: string;
17156
+ /** Shell command run in the live worktree to derive the typecheck-PASS signal (e.g. `pnpm typecheck`). */
17157
+ typecheckCmd?: string;
17158
+ /** Wall-clock cap per verification command (ms). Default = `harnessTimeoutMs` or 5 min. */
17159
+ checkTimeoutMs?: number;
17160
+ /** Cap on each check's captured output. Default 16k. */
17161
+ checkOutputCap?: number;
17162
+ /** Test seam — inject a git runner so unit tests drive the worktree helpers without git. */
17163
+ runGit?: GitRunner;
17164
+ /** Test seam — inject the harness runner so unit tests script a `LocalHarnessResult`. */
17165
+ runHarness?: typeof runLocalHarness;
17166
+ /** Test seam — inject the verification-command runner so unit tests script test/typecheck
17167
+ * outcomes without spawning a real shell. Defaults to a `/bin/sh -c` spawn in the worktree. */
17168
+ runCommand?: WorktreeCheckRunner;
17169
+ /**
17170
+ * Exclude this leaf's spend from accounting. Defaults to `true` for ordinary CLI runs and
17171
+ * `false` for `codexReproducible`, which captures real token usage. A metered custom runner must
17172
+ * likewise return `LocalHarnessResult.usage`.
17173
+ */
17174
+ budgetExempt?: boolean;
17175
+ /** @internal Kernel-minted attempt identity threaded by the built-in registry. */
17176
+ executionAttemptId?: string;
17177
+ }
17178
+ /**
17179
+ * Build a worktree-CLI leaf `Executor`. Per-spawn (a fresh worktree + abort + teardown each), so a
17180
+ * fanout of N profiles = N parallel worktrees that never clobber each other.
17181
+ *
17182
+ * Fail-loud: an empty `repoRoot`, an incomplete/unsupported profile, a separate harness override,
17183
+ * or an explicitly empty `taskPrompt` throws at construction. Calling `execute(undefined, signal)`
17184
+ * without a configured prompt throws before a worktree is created. `resultArtifact()` before
17185
+ * `execute()` resolves throws.
17186
+ *
17187
+ * @experimental
17188
+ */
17189
+ declare function createWorktreeCliExecutor(options: WorktreeCliExecutorOptions): Executor<WorktreePatchArtifact>;
17190
+ //#endregion
17191
+ //#region src/runtime/supervise/patch-checks.d.ts
17192
+ /** @experimental The per-task constraints the mechanical gate enforces. */
17193
+ interface CoderCheckConstraints {
17194
+ /** Default 400. Hard cap; gate fails when exceeded. */
17195
+ maxDiffLines?: number;
17196
+ /** Literal path prefixes the patch must not touch. */
17197
+ forbiddenPaths?: string[];
17198
+ }
17199
+ //#endregion
17200
+ //#region src/runtime/supervise/patch-deliverable.d.ts
17201
+ /** @experimental */
17202
+ interface PatchDeliverableOptions extends CoderCheckConstraints {
17203
+ /**
17204
+ * Which verification signals the gate REQUIRES to be present-and-passing. A required signal
17205
+ * that the artifact never derived (the command was not configured on the executor) fails the
17206
+ * gate closed. Unlisted signals default to passed-when-absent (the executor simply didn't run
17207
+ * that command). Default `[]` — gate on no-op / secret / forbidden / diff-size only.
17208
+ */
17209
+ require?: ReadonlyArray<'tests' | 'typecheck'>;
17210
+ }
17211
+ //#endregion
18530
17212
  //#region src/runtime/supervise/worktree-fanout.d.ts
18531
17213
  /** @experimental One authored profile in a worktree fanout. Its exact `harness` field chooses the
18532
17214
  * local CLI; the supervisor authors the complete profile per sub-task. */
@@ -18756,19 +17438,6 @@ declare function boxSurfaceReader(box: SurfaceReadBox, options?: BoxSurfaceReade
18756
17438
  */
18757
17439
  declare function fsSurfaceReader(root: string): SurfaceReader;
18758
17440
  //#endregion
18759
- //#region src/runtime/tangle-sandbox-exact-process-provider.d.ts
18760
- type SandboxControlClient = Pick<Sandbox, 'create' | 'get' | 'list'>;
18761
- interface CreateTangleSandboxExactProcessProviderOptions {
18762
- name?: string;
18763
- }
18764
- /**
18765
- * Adapt Tangle Sandbox's managed control runtime to Runtime's exact-process provider.
18766
- *
18767
- * The adapter deliberately exposes no ordinary agent environment: an exact experiment
18768
- * must start a fresh Sandbox with no managed agent and launch its declared argv directly.
18769
- */
18770
- declare function createTangleSandboxExactProcessProvider(client: SandboxControlClient, options?: CreateTangleSandboxExactProcessProviderOptions): AgentEnvironmentProvider;
18771
- //#endregion
18772
17441
  //#region src/runtime/verifier-environment.d.ts
18773
17442
  interface VerifierEnvironmentOptions {
18774
17443
  name: string;
@@ -19371,30 +18040,6 @@ type DriverRepromptRefusal = 'closed' | Extract<DriverAttemptStop, 'aborted' | '
19371
18040
  * budget, and cancellation bound the pauses.
19372
18041
  */
19373
18042
  type DriverFailureClass = 'transient' | 'terminal' | 'unavailable';
19374
- /**
19375
- * The code or status that marks `error` as an upstream capacity refusal, or `undefined`.
19376
- *
19377
- * A structured field is read first: a turn outcome's `errorCode`, a transport error's
19378
- * `upstreamCode` and `status`, a provider SDK error's `status`. The failure text is read only when
19379
- * no structured field decided, because a harness CLI reports the router's refusal as text.
19380
- */
19381
- declare function upstreamUnavailableSignal(error: unknown): string | undefined;
19382
- /**
19383
- * Classify one driver failure. Runtime's own typed refusals are decisions and stay terminal; an
19384
- * upstream capacity refusal is `unavailable`; anything else foreign is an accident and is
19385
- * retryable. A `BackendTransportError` is split by status because the taxonomy already promises
19386
- * consumers may branch on it: a 5xx/408 is the upstream having a bad moment, a 429/503/529 is the
19387
- * upstream out of capacity, and a 401/404/422 is a request that will fail identically forever. The
19388
- * bridge's own never-retry classes are terminal whether or not a status rides with them.
19389
- */
19390
- declare function classifyDriverFailure(error: unknown, signal?: AbortSignal): DriverFailureClass;
19391
- /** The error a give-up throws: the original cause, re-described with the attempt history so
19392
- * `driver-failed` carries a diagnosable message instead of one backend's last words. */
19393
- declare class DriverAttemptsExhaustedError extends RuntimeRunStateError {
19394
- readonly attempts: readonly DriverAttemptRecord[];
19395
- readonly stop: DriverAttemptStop;
19396
- constructor(cause: unknown, attempts: readonly DriverAttemptRecord[], stop: DriverAttemptStop);
19397
- }
19398
18043
  /**
19399
18044
  * What one driver loop did, counted from its attempt records: the numbers a run's settle record
19400
18045
  * carries so a reader can tell genuine continuations from failure retries without the journal.
@@ -19449,8 +18094,6 @@ interface DriverContinuationRecord extends DriverLoopRecord {
19449
18094
  * Empty for a manager with no check. */
19450
18095
  readonly continuations: ReadonlyArray<ContinuationEntry>;
19451
18096
  }
19452
- /** Count a loop's attempt records into its {@link DriverLoopRecord}. */
19453
- declare function summarizeDriverAttempts(records: ReadonlyArray<DriverAttemptRecord>): DriverLoopRecord;
19454
18097
  //#endregion
19455
18098
  //#region src/runtime/supervise/contracts/supervisor-result.d.ts
19456
18099
  /** Provider-observed model identity for the root manager's settled inference turns.
@@ -20313,32 +18956,6 @@ interface RuntimeFailureCause {
20313
18956
  /** The upstream or provider machine code the failure carried, when it carried one. */
20314
18957
  readonly providerCode?: string;
20315
18958
  }
20316
- /** What the caller knows about how a failed operation ended. */
20317
- interface RuntimeFailureContext {
20318
- /** The caller's own signal. Aborted means the caller cancelled. */
20319
- readonly signal?: AbortSignal;
20320
- /** The operation's own deadline expired before the caller cancelled it. */
20321
- readonly deadlineExpired?: boolean;
20322
- }
20323
- /**
20324
- * Classify a thrown failure. Pass the caller's signal so a cancellation the caller asked for is
20325
- * attributed to the caller even when the provider surfaced it as an ordinary error, and say when
20326
- * the operation's own deadline expired so a blown deadline is never reported as a cancellation.
20327
- */
20328
- declare function runtimeFailureCause(error: unknown, context?: RuntimeFailureContext): RuntimeFailureCause;
20329
- /**
20330
- * Classify a down settlement from the typed facts Runtime recorded while the cause was still a
20331
- * value: the retained cause, the failure classified where the executor threw, then `infra: false`,
20332
- * the throw path's statement that the work itself failed. `infra: true` is not an owner: Runtime
20333
- * also sets it for cancellations, budget reconcile faults and validation errors, and from the
20334
- * platform's failure messages, so a settlement with nothing else typed is `unknown`.
20335
- */
20336
- declare function settlementFailureCause(down: {
20337
- readonly reason: string;
20338
- readonly infra?: boolean;
20339
- readonly retainedPendingCause?: RetainedPendingCause;
20340
- readonly failure?: RuntimeFailureCause;
20341
- }): RuntimeFailureCause;
20342
18959
  //#endregion
20343
18960
  //#region src/types.d.ts
20344
18961
  /** @stable */
@@ -20877,5 +19494,5 @@ interface KnowledgeReadinessDecision {
20877
19494
  nonBlockingGapIds: string[];
20878
19495
  }
20879
19496
  //#endregion
20880
- export { SubtreeSummary as $, NodeExecutionIdentity as $C, analystToolGroupNames as $S, startRuntimeRun as $T, DelegationHistoryEntry as $_, filterAuthoredAsserts as $a, CreateWorktreeOptions as $b, harvestCorpus as $c, SelectSeat as $d, RegisteredPrompt as $f, CoderDelegate as $g, SharedBoxHandle as $h, delegate as $i, PersonaContext as $l, ResolveSpawnResourcePathsResult as $m, runInWorkspace as $n, StreamAgentTurnOptions as $o, runCancellationFile as $p, ProvisionSupervisorRequest as $r, LocalSandboxClientOptions as $s, ForkRequest as $t, PursuitNodeCost as $u, CheckUnavailableError as $v, HarnessTranscriptReadOptions as $w, DownMessageAuthorizationInput as $x, renderPairwiseMarkdown as $y, RetainedPendingCause as A, BackendTransportError as AC, McpTransport as AS, LoopResult as AT, DelegationResumeDriver as A_, ProfileRichnessThresholds as Aa, createOtelExporter as Ab, breadthStrategy as Ac, superviseFleetCapabilities as Ad, WorkerEventEntry as Af, mapSandboxToolEvent as Ag, RouterToolsSeam as Ah, graphFromStored as Ai, PipelineStage as Al, ContinuationAppend as Am, WorkerInteractiveProviderSource as An, acquireSandbox as Ao, resolveSupervisorProfile as Ap, readWorkerSteerRequests as Ar, registryScopeAnalyst as As, SpawnRefusalCause as At, IsolatedCheckOptions as Au, createPropagatingTraceEmitter as Av, TeamProgress as Aw, GateRequest as Ax, CodeModeTool as Ay, Spend as B, ValidationError as BC, ANALYST_DEFINITION_BOUNDS as BS, OutputAdapter as BT, DelegateCodeResult as B_, CheckSource as Ba, RuntimeTelemetryOptions as Bb, StrategyCtx as Bc, WorkerSpawnRetryAttempt as Bd, ReservationFloor as Bf, RouterTransportConfig as Bg, InboxMessage as Bh, DispatchReport as Bi, TrajectoryReportOptions as Bl, VerdictSummary as Bm, spendFromUsageEvents as Bn, reconnectRetainedInteractiveRun as Bo, allOf as Bp, workerInboxFileFromEventDir as Br, BenchmarkStrategySummary as Bs, AgentProfile$2 as Bt, VersionJudge as Bu, buildDelegationTraceSpans as Bv, StartRetainedInteractiveRunOptions as Bw, QuestionEscalationOutcome as Bx, Interval as By, RuntimeFailureCause as C, InMemorySpawnJournal as CC, RetainedRunStartMaterial as CE, isPeerMailEnvelope as CS, LoopEndedPayload as CT, detachedTurnEvents as C_, ChatTransportTool as Ca, OtelExporter as Cb, AgenticTool as Cc, GraphTopology as Cd, readWorkerTraceContext as Cf, resolveSecretEnv as Cg, createExecutor as Ch, createInPlaceCliExecutor as Ci, LoopUntilSpec as Cl, CoordinationLog as Cm, analystsFromRegistry as Cn, openSandboxRun as Co, SupervisorNodeContextSeed as Cp, WriteWorkerSteerOptions as Cr, verify as Cs, GraphSubtasks as Ct, checkProgramDigest as Cu, ResearchSource as Cv, decodeToolPart as Cw, LeadMessage as Cx, harnessUsageIsEmpty as Cy, runtimeFailureCause as D, resolveRedactor as DC, JsonRpcResponse as DS, LoopLineageOptions as DT, DelegationArgs as D_, createChatSessionStore as Da, buildLoopSpanNodes as Db, StrategyMessage as Dc, runGraph as Dd, WorkerSlots as Df, SandboxToolPartState as Dg, CliWorktreeSeam as Dh, StoredGraph as Di, PanelSpec as Dl, AdmittedFinding as Dm, worktreeFanout as Dn, SessionCapableBox as Do, ManagerWakePolicy as Dp, readWorkerCancelRequests as Dr, assertTraceDerivedFindings as Ds, SpawnPreflight as Dt, readDeclaredCheck as Du, multiHarnessResearcherFanout as Dv, DEFAULT_STALL_AFTER_MS as Dw, WorkerWatchOptions as Dx, CodeModeOptions as Dy, RuntimeFailureOwner as E, defaultRedactor as EC, StartRetainedRunOptions as EE, JsonRpcMessage as ES, LoopIterationStartedPayload as ET, runDetachedTurn as E_, chatWorkerSeam as Ea, buildLoopOtelSpans as Eb, RunAgenticOptions as Ec, TraversalContinuity as Ed, workerTraceSeamKey as Ef, SandboxOutputMarker as Eg, CliWorktreeBridgeSeam as Eh, GraphSelection as Ei, PanelJudge as El, PriorCoordination as Em, WorktreeFanoutOptions as En, SandboxLineageHandle as Eo, DEFAULT_DEADLINE_WARNING_MS as Ep, legacySupervisorRunsRoot as Er, RegistryAnalyzeProjection as Es, SettledWorker as Et, declaredCheckJudge as Eu, createResearcherValidator as Ev, ActivityNote as Ew, ToolOutcomeEvent as Ex, decodeHarnessUsage as Ey, Budget as F, RetainedInteractiveAdmissionError as FC, PublishOptions as FS, LoopTraceEmitter as FT, SubmitInput as F_, supervisorInstructions as Fa, toOtelAttributes as Fb, AuthorStrategyOptions as Fc, AuthorizedSpawnContext as Fd, BudgetPool as Ff, createSandboxUsageLedger as Fg, SteerableSandboxSession as Fh, lookupGraph as Fi, ScopeWidenGate as Fl, ContinuationPanelInput as Fm, VERIFY_TAIL_CHARS as Fn, recoverRetainedRun as Fo, ProgressTracker as Fp, workerCancelRequestsFile as Fr, sanitizeMcpToolSchema as Fs, AgentEnvironmentEvent$1 as Ft, NextPursuitVersionInput as Fu, DELEGATION_TRACE_MAX_BYTES as Fv, RecoverRetainedInteractiveRunOptions as Fw, RouteWhen as Fx, createCodeModeTools as Fy, NodeSnapshot as G, SpawnModelSubstitution as GC, AnalystLensOutput as GS, Validator as GT, DelegateResearchResult as G_, StructuralRolloutPolicy as Ga, sanitizeAgentRuntimeEvent as Gb, defineStrategy as Gc, retryPreSpawnRefusals as Gd, ReservationTicket as Gf, ToolLoopCompaction as Gg, DEFAULT_SHARED_BOX_WORKERS as Gh, queueOf as Gi, WidenLineage as Gl, expandQuestions as Gm, GitWorkspaceOptions as Gn, profileChatClient as Go, plateau as Gp, workerSteersDir as Gr, LoopCampaignDispatchOptions as Gs, AgentTurnResult$2 as Gt, SupervisePursuitOptions as Gu, DelegationStateCorruptError as Gv, HarnessTranscriptUnavailable as Gw, QuestionPolicy as Gx, PairwiseVerdict as Gy, SpendGap as H, ExecutorContext as HC, AnalystDefinitionIssue as HS, SandboxClient as HT, DelegateFeedbackResult as H_, RepairStop as Ha, SanitizedKnowledgeRequirement as Hb, adaptiveRefine as Hc, WorkerSpawnRetryPolicy as Hd, ReservationRejection as Hf, ToolSpec as Hg, PeerInboxMessage as Hh, DispatchUnit as Hi, VerifySpec as Hl, admitFinding as Hm, UntrackedCopyStats as Hn, startRetainedInteractiveRun as Ho, anyOf as Hp, workerSteerAcknowledgementsDir as Hr, Environment as Hs, AgentSession as Ht, assertPursuitVersions as Hu, composeLoopTraceEmitters as Hv, HarnessTranscriptCapture as Hw, QuestionEscalationTarget as Hx, LeaderboardOptions as Hy, BudgetOverspend as I, RetainedInteractiveBindingError as IC, createEventBus as IS, LoopTraceEvent as IT, SubmitOutput as I_, CheckExecChannel as Ia, RuntimeEventCollector as Ib, AuthoredStrategy as Ic, DeliverableResolutionInput as Id, BudgetPoolRestore as If, extractLlmCallEvent as Ig, createSteerableSandboxSession as Ih, pickBestGraph as Ii, SteerContext as Il, ContinuationPanelResult as Im, WorkerEvidenceInput as In, startRetainedRun as Io, ProgressTrackerOptions as Ip, workerCancellationFile as Ir, BenchmarkCell as Is, AgentEnvironmentProvider$1 as It, PursuitVersionChain as Iu, DELEGATION_TRACE_MAX_SPANS as Iv, RetainedInteractiveAdmissionHook as Iw, ChildQuestionInbox as Ix, describeCodeModeTools as Iy, Settled as J, ExecutorExecutionBinding as JC, AnalystToolGroupName as JS, RuntimeRunHandle as JT, DelegateUiAuditResult as J_, canDisplace as Ja, InPlaceHarnessResult as Jb, strategyAuthorSystemPrompt as Jc, SuperviseRegistryTable as Jd, createBudgetPool as Jf, ToolLoopToolCall as Jg, SharedBoxPlacementOptions as Jh, DesignerToolsEnv as Ji, DefinePersona as Jl, DriverBudgetReadout as Jm, WorkspaceCommit as Jn, assertProfileModelsAllowed as Jo, RunCancellation as Jp, RemoteSupervisorReader as Jr, SuperviseDispatchOptions as Js, CheckpointRequest as Jt, supervisePursuit as Ju, FileDelegationStoreOptions as Jv, captureHarnessTranscript as Jw, questionEscalationTargets as Jx, leaderboard as Jy, NodeStatus as K, AgentExecutionRef as KC, AnalystRegistry$1 as KS, RuntimeRunCompleteInput as KT, DelegateUiAuditArgs as K_, StructuralRolloutResult as Ka, sanitizeKnowledgeReadinessReport as Kb, sampleThenRefine as Kc, withWorkerSpawnRetry as Kd, ReservationWaitRefused as Kf, ToolLoopCompactionOptions as Kg, SharedBoxCloseReceipt as Kh, rollingDispatch as Ki, WidenSpec as Kl, failedItems as Km, Shell as Kn, profileOptimizerModelCall as Ko, sampleFromSettled as Kp, writeWorkerSteer as Kr, LoopDispatchOptions as Ks, AnalystFinding$1 as Kt, SupervisedPursuitResult as Ku, DelegationStore as Kv, HarnessTranscriptUnavailableReason as Kw, QuestionRecord as Kx, ProfileKeyOf as Ky, BudgetViolation as L, RetainedRunAdmissionError as LC, WatchTraceOptions as LS, LoopWinner as LT, hashIdempotencyInput as L_, CheckOutcome as La, RuntimeStreamEventCollector as Lb, ShotSpec as Lc, SuperviseOptions as Ld, BudgetReadout as Lf, sandboxEventServedBackend as Lg, AuthorityInboxMessage as Lh, recordGraphRun as Li, TrajectoryNode as Ll, ContinuationPolicy as Lm, closingWorkerNote as Ln, startRetainedRunInEnvironment as Lo, ProgressView as Lp, workerCancellationsDir as Lr, BenchmarkConfig as Ls, AgentEnvironmentQuery as Lt, PursuitVersionStop as Lu, DelegationTraceCaps as Lv, RetainedInteractiveEnvironmentInput as Lw, EscalateQuestion as Lx, runCodeMode as Ly, TRACE_SUMMARY_SCHEMA as M, JudgeError as MC, BusRecord as MS, LoopStartedPayload as MT, DelegationRunContext as M_, assessAuthoredProfile as Ma, loopEventToOtelSpan as Mb, refine as Mc, workerFromBackend as Md, DEADLINE_CHECK_IN_MESSAGE as Mf, SandboxServedBackend as Mg, DEFAULT_SANDBOX_STEERING_MAX_TURNS as Mh, graphRunsFor as Mi, RenderCorpusToInstructionsOptions as Ml, ContinuationEntry as Mm, readWorkerInteractiveBinding as Mn, S3PrivateCasStoreOptions as Mo, NoProgressForOptions as Mp, supervisorRunDir as Mr, McpEndpoint as Ms, WorkerSpawnContext as Mt, runIsolatedCheck as Mu, readTraceContextFromEnv as Mv, createActivityLog as Mw, RouteFlow as Mx, CodeModeToolsOptions as My, TraceRootArtifact as N, NotFoundError as NC, BusStats as NS, LoopTeardownFailedPayload as NT, DelegationTaskQueue as N_, defaultProfileRichnessThresholds as Na, padSpanId as Nb, runAgentic as Nc, DEFAULT_AUTHORED_PROFILE_SECURITY_POLICY as Nd, DEFAULT_CHECK_IN_IDLE_MS as Nf, SandboxUsageLedger as Ng, SandboxSteeringOptions as Nh, listGraphRuns as Ni, ScopeAnalyst as Nl, ContinuationNoteInput as Nm, EVIDENCE_MAX_CHARS as Nn, createS3PrivateCasStore as No, PlateauOptions as Np, supervisorRunsRoot as Nr, McpEnvironmentOptions as Ns, AgentEnvironment$1 as Nt, JudgedPursuitVersion as Nu, traceContextToEnv as Nv, readWorkerProgress as Nw, RouteGate as Nx, CodeModeToolset as Ny, settlementFailureCause as O, AgentEvalError$1 as OC, McpToolAnnotations as OS, LoopPlanDescription as OT, DelegationRecord as O_, AuthoredProfile as Oa, buildRuntimeEventOtelSpans as Ob, StrategyShotResult as Oc, runGraphWithTestBrain as Od, createWorkerSlots as Of, createSandboxToolPartState as Og, ProviderSeam as Oh, digestOfGraph as Oi, PanelVerdict as Ol, CONTINUATION_FACTS as Om, AttachWorkerOptions as On, createSandboxLineage as Oo, ResolvedSupervisorProfile as Op, readWorkerCancellation as Or, buildSteerContext as Os, SpawnPreflightContext as Ot, IsolatedCheckBox as Ou, researcherProfile as Ov, ExecutorProgress as Ow, DecideGate as Ox, CodeModeResult as Oy, TraceSummary as P, PlannerError as PC, EventBus as PS, LoopTokenUsage as PT, DelegationTaskQueueOptions as P_, profileRichnessFinding as Pa, padTraceId as Pb, sample as Pc, AuthorizedSpawn as Pd, DeadlineCheckIn as Pf, assertSandboxServedModel as Pg, SteerableSandboxArgs as Ph, loadGraph as Pi, ScopeAnalyzeInput as Pl, ContinuationPanel as Pm, NOTE_MAX_CHARS as Pn, reconnectRetainedRun as Po, ProgressSample as Pp, supervisorWorkersDir as Pr, createMcpEnvironment as Ps, AgentEnvironmentCapabilities$1 as Pt, NextPursuitVersion as Pu, CappedDelegationTrace as Pv, ReconnectRetainedInteractiveRunOptions as Pw, RouteMatch as Px, RunCodeModeOptions as Py, SubtreeResult as Q, MaterializedModelIdentity as QC, DefinedAnalystRecord as QS, RuntimeRunStatus as QT, DelegationHistoryArgs as Q_, defaultStructuralRolloutPolicy as Qa, WorktreeProfileMaterializationReceipt as Qb, HarvestReport as Qc, SeatStage as Qd, PromptRegistry as Qf, eventToSnapshot as Qg, ROUTER_CLIENT_HEADER as Qh, defaultDelegateBudget as Qi, Persona as Ql, DriverRetryPolicy as Qm, localShell as Qn, CollectedAgentTurn as Qo, runCancelRequestFile as Qp, ProvisionSupervisorConnection as Qr, superviseDispatch as Qs, ExecResult as Qt, PursuitCostProvenance as Qu, coderTaskToPrompt as Qv, HarnessTranscriptReadLimits as Qw, ContinuityMode as Qx, renderLeaderboardSvg as Qy, ResourceLimit as R, RetainedRunDispatchBindingError as RC, defaultToolDetectors as RS, MountManifestEntry as RT, DelegateCodeArgs as R_, CheckRunContext as Ra, RuntimeStreamEventSink as Rb, Strategy as Rc, SuperviseTestOptions as Rd, BudgetReconcileFault as Rf, sumSandboxUsage as Rg, Inbox as Rh, storedGraphDigests as Ri, TrajectoryReport as Rl, ContinuationProfile as Rm, composeWorkerEvidence as Rn, ClaimRetainedInteractiveControlOptions as Ro, StopDecision as Rp, workerControlLogFile as Rr, BenchmarkLift as Rs, AgentEnvironmentStatus as Rt, PursuitVersions as Ru, DelegationTraceCollector as Rv, RetainedInteractiveRunHandle as Rw, Question as Rx, AxisScoresOf as Ry, RuntimeStreamEvent as S, InMemoryResultBlobStore as SC, RetainedRunSnapshot as SE, createPeerMailbox as SS, LoopDecisionPayload as ST, createDetachedTurnResumeDriver as S_, ChatTransportExecutorOptions as Sa, OtelExportStats as Sb, AgenticTask as Sc, GraphResult as Sd, WorkerTraceSeamCarrier as Sf, resolveMcpServerLaunch as Sg, ExecutorConfig as Sh, InPlaceCliExecutorOptions as Si, LoopUntil as Sl, CoordinationDeliveryEvidence as Sm, AnalystAuthoring as Sn, TurnResult as So, SupervisorNodeContext as Sp, WorkerSteerRequest as Sr, selectValidWinner as Ss, GraphSubtaskPreparation as St, assertDeclaredCheck as Su, ResearchOutput as Sv, createPushTraceSource as Sw, EventAcknowledgement as Sx, createCodexRolloutStoreReader as Sy, RuntimeFailureContext as T, Redactor as TC, StartRetainedRunInEnvironmentOptions as TE, peerMailVerbNames as TS, LoopIterationEndedPayload as TT, parseDetachedSessionRef as T_, chatTransportExecutor as Ta, RuntimeEventOtelOptions as Tb, CorpusReadbackOptions as Tc, RunGraphTestOptions as Td, workerTraceHeaders as Tf, SandboxLeafOut as Tg, CliSeam as Th, GraphRunRecord as Ti, Panel as Tl, FileCoordinationLog as Tm, AuthoredHarness as Tn, SandboxLineage as To, SupervisorToolInvocationContext as Tp, legacySupervisorRunDir as Tr, CreateScopeAnalystOptions as Ts, PeerAuditAccess as Tt, declaredCheckDigest as Tu, ResearcherProfileOptions as Tv, ActivityLog as Tw, ManagerWake as Tx, HarnessUsage as Ty, Handle as U, ExecutorFactory as UC, AnalystFindingEvent as US, SelectionReceipt as UT, DelegateResearchArgs as U_, StructuralRolloutConfig as Ua, createRuntimeEventCollector as Ub, assertStrategyContract as Uc, isPreSpawnExecutorFailure as Ud, ReservationShortfall as Uf, ToolLoopCallContext as Ug, createInbox as Uh, RollingDispatchOptions as Ui, Widen as Ul, checkVerdictOf as Um, copyUntrackedIntoClone as Un, ResolveSandboxClientOptions as Uo, createProgressTracker as Up, workerSteerRequestFile as Ur, printBenchmarkReport as Us, AgentSessionRef as Ut, SuperviseGraphPursuitOptions as Uu, createDelegationTraceCollector as Uv, HarnessTranscriptEvidence as Uw, QuestionLevel as Ux, LeaderboardRow as Uy, SpendChannel as V, AgentSpec as VC, AnalystAssignmentRecord as VS, RunProvenance as VT, DelegateFeedbackArgs as V_, CheckSourceCtx as Va, SanitizedKnowledgeReadinessReport as Vb, StrategyResult as Vc, WorkerSpawnRetryHooks as Vd, ReservationHolder as Vf, RouterRouting as Vg, InboxReceipt as Vh, DispatchStopReason as Vi, Verify as Vl, admitContinuationPolicy as Vm, CopyOptions as Vn, recoverRetainedInteractiveRun as Vo, allWorkersStalled as Vp, workerSteerAcknowledgementFile as Vr, BenchmarkTaskRow as Vs, AgentProfileRef as Vt, VersionVerdict as Vu, capDelegationTrace as Vv, HarnessTranscriptArtifact as Vw, QuestionEscalationRecord as Vx, Leaderboard as Vy, NodeId as W, ExecutorRegistry as WC, AnalystKind as WS, ValidationCtx as WT, DelegateResearchConfig as W_, StructuralRolloutMessage as Wa, createRuntimeStreamEventCollector as Wb, authorStrategy as Wc, resolveWorkerSpawnRetry as Wd, ReservationStage as Wf, ToolLoopChat as Wg, DEFAULT_SHARED_BOX_RESOURCES as Wh, freeSlots as Wi, WidenDecision as Wl, distillFindings as Wm, withUntrackedArtifacts as Wn, resolveSandboxClient as Wo, noProgressFor as Wp, workerSteerRequestsDir as Wr, runBenchmark as Ws, AgentSessionStatus$1 as Wt, SupervisePursuitError as Wu, DelegationPersistenceError as Wv, HarnessTranscriptFile as Ww, QuestionOption as Wx, PairwiseOptions as Wy, SpawnPrior as X, ExecutorNodeContext as XC, AuthoredAnalystDefinition as XS, RuntimeRunPersistenceAdapter as XT, DelegationError as X_, composeCheckSources as Xa, WorktreeCommandResult as Xb, HarvestError as Xc, SeatSelection as Xd, GraphRouteError as Xf, FeedbackStore as Xg, SharedWorkerIdentity as Xh, graphDesignerExtraTools as Xi, LoopShape as Xl, DriverProgressMark as Xm, gitWorkspace as Xn, AgentTurnInput$1 as Xo, readRunCancelRequest as Xp, RemoteWorkerEvents as Xr, loopCampaignDispatch as Xs, CreateSandboxOptions$1 as Xt, RUN_FORK_CORRELATION_KEYS as Xu, CoderOutput as Xv, persistHarnessTranscript as Xw, AuthorizedDownMessage as Xx, renderLeaderboardHtml as Xy, SpawnOpts as Y, ExecutorMaterialization as YC, AnalyzeOnSettleRoute as YS, RuntimeRunOptions as YT, DelegateUiAuditRoute as Y_, compareCheckOutcomes as Ya, WorktreeCheckRunner as Yb, HarvestCorpusOptions as Yc, SeatSegment as Yd, defaultEdgeTraversalCap as Yf, FeedbackEvent as Yg, SharedBoxStats as Yh, GraphDesignerExtraTools as Yi, DefinePersonaInput as Yl, DriverContractState as Ym, WorkspaceRun as Yn, AgentTurnBackend as Yo, cancelRun as Yp, RemoteSupervisorTree as Yr, SuperviseOptionsForDispatch as Ys, CreateAgentEnvironmentInput$1 as Yt, PursuitFork as Yu, InMemoryDelegationStore as Yv, harnessTranscriptArtifact as Yw, AuthorizeDownMessage as Yx, pairwiseSignificance as Yy, SpawnRejection as Z, MaterializedExecutionIdentity as ZC, AuthoredAnalystLimits as ZS, RuntimeRunRow as ZT, DelegationFeedbackSnapshot as Z_, defaultExtractCandidate as Za, WorktreeHarnessResult as Zb, HarvestFailure as Zc, SeatSelectionInput as Zd, PromptHandle as Zf, InMemoryFeedbackStore as Zg, sharedBoxPlacement as Zh, DelegateOptions as Zi, Outcome as Zl, DriverReentry as Zm, jjWorkspace as Zn, AgentTurnUsage as Zo, readRunCancellation as Zp, connectRemoteSupervisor as Zr, loopDispatch as Zs, ExecRequest as Zt, PursuitObserverDelivery as Zu, CoderTask as Zv, HarnessTranscriptMetadata as Zw, ContinuationInstruction as Zx, renderLeaderboardMarkdown as Zy, RunAgentTaskOptions as _, SpawnForestTree as _C, RetainedRunEnvironmentAdmission as _E, PeerMailRefusal as _S, AgentRunSpec as _T, DetachedTurn as __, Scope as _a, SandboxEvidenceRetentionPort as _b, connectStdioMcp as _c, EdgeDeliveryOutcome as _d, createScope as _f, BridgeSeam as _g, DelegateHandlerOptions as _h, InteractiveWorkerKeyInput as _i, Fanout as _l, CoordinationTransportOptions as _m, SurfaceReader as _n, OpenSandboxRunBeforeStartContext as _o, ObserveSupervisorNodeEvent as _p, searchPresets as _r, fanout as _s, upstreamUnavailableSignal as _t, LeaderboardSpec as _u, UiFindingSeverity as _v, WorkerTraceUnavailableReason as _w, CodexTokenUsage as _x, CodexRolloutStoreReader as _y, AgentKnowledgeProvider as a, SqlRunStoreOptions as aC, RecoverRetainedRunOptions as aE, MapItemFailurePolicy as aS, ProviderNativeCapturePhase as aT, SettleDetachedCoderTurnOptions as a_, RecursiveReservationPolicy as aa, bestSoFar as ab, inlineSandboxClient as ac, PursuitProjection as ad, createFileRunContext as af, createAgentEnvironmentProviderRegistry as ag, environmentReader as ah, bestProfileFor as ai, defaultAnalystInstruction as al, FinalizeContext as am, computeFindingId$1 as an, structuralRollout as ao, formatPromptHandle as ap, parseWorkerToolTraceArtifact as ar, PrivateCasOptions as as, RootProviderModelEvidence as at, ShapeRegistry as au, DelegationStatusArgs as av, ExecutorAccounting as aw, captureWorktreeDiff as ax, verdictFromJudgeScore as ay, RuntimeSession as b, replaySpawnTree as bC, RetainedRunIntentAdmission as bE, PeerMailboxOptions as bS, ExecCtx as bT, DriveTurnTick as b_, ChatCompletionsTransport as ba, OtelAttribute as bb, AgenticRunResult as bc, GraphEdgeCapError as bd, ScopeArgs as bf, envKeyProvider as bg, validateDelegateArgs as bh, workerFromInteractiveProvider as bi, FanoutWinnerSelector as bl, CoordinationHttpOptions as bm, fsSurfaceReader as bn, SandboxRun as bo, SupervisorAgentDeps as bp, WorkerCancellation as br, panel as bs, CoordinationTools as bt, DeclaredCheckPlacement as bu, KnowledgeUpdate as bv, ToolStepInput as bw, AwaitWakeInput as bx, CodexStoreDelta as by, AgentTaskContext as c, D1StmtLike as cC, RetainedInteractiveEnvironmentAdmission as cE, MapTraversalEvent as cS, ProviderWorkspaceCaptureReceipt as cT, detachedSessionDelegate as c_, RootSegmentEntry as ca, WaterfallCollector as cb, InProcessSandboxClientOptions as cc, PursuitStatus as cd, SupervisorSpanAttributes as cf, ProviderLeafOut as cg, McpServer as ch, profileRegistry as ci, AssertTraceDerivedFindings as cl, bestDelivered as cm, createVerifierEnvironment as cn, EvolutionReport as co, promptHandle as cp, SqlRunContextOptions as cr, trajectoryReport as cs, DriverAttemptRecord as ct, DefinedLeaderboard as cu, FeedbackRefersTo as cv, ExecutorResult as cw, LocalHarnessResult as cx, CompletionPolicy as cy, AgentTaskStatus as d, materializeTreeView as dC, RetainedRunAdmission as dE, PEER_MAIL_WIRE_KEY as dS, ProviderWorkspaceRetentionContext as dT, FleetHandle as d_, Supervisor as da, createWaterfallCollector as db, LocalMcpMaterialization as dc, ObserverJournal as dd, SupervisorSpanRecorder as df, UnavailablePausePolicy as dg, createMcpServer as dh, PatchDeliverableOptions as di, CorpusFilter as dl, pickBestDelivered as dm, createTangleSandboxExactProcessProvider as dn, StrategyTournament as do, assertCoordinationBinding as dp, SEARCH_SPEC_CORRELATION_KEY as dr, registerShape as ds, DriverContinuationRecord as dt, LeaderboardBenchmarkAdapter as du, UiAuditorDelegationOutput as dv, HeldForContinuation as dw, CodexExecutionEvidence as dx, deterministicCompletion as dy, canonicalFindingEvent as eC, NativeContextContinuationExecution as eE, DownMessageDeliveryAttempt as eS, RetainedHarnessTranscriptCapture as eT, CoderReview as e_, ResultBlobStore as ea, AnytimeReport as eb, localSandboxClient as ec, PursuitNodePlacement as ed, subscriptionUsageLimitSignal as ef, SharedBoxProcess as eg, ResolvedSpawnResourcePath as eh, ProvisionedSupervisor as ei, Observation as el, ReentryContinuity as em, PlacementInfo as en, modelAuthoredChecks as eo, analyzesFindingsReportPrompt as ep, TrajectoryAnalysis as er, collectAgentTurn as es, TreeView as et, PersonaExecutors as eu, DelegationHistoryResult as ev, ProfileMaterializationReceipt as ew, DiffOptions as ex, CheckVerdict as ey, BackendErrorDetail as f, SpawnForest as fC, RetainedRunAdmissionHook as fE, PeerMailEnvelope as fS, ProviderWorkspaceRetentionPort as fT, FleetWorkspaceExecutorOptions as f_, SupervisorOpts as fa, RunAgentRoundsOptions as fb, MaterializeLocalMcpOptions as fc, ObserverRecord as fd, createSupervisorSpanRecorder as ff, ProviderPlacement as fg, DELEGATE_DESCRIPTION as fh, patchDelivered as fi, CorpusRecord as fl, runFinalizer as fm, BoxSurfaceReaderOptions as fn, TournamentCell as fo, CoordinationBinding as fp, SearchSpec as fr, definePersona as fs, DriverFailureClass as ft, LeaderboardFlagSpec as fu, delegationProfiles as fv, HeldRelease as fw, DEFAULT_LOCAL_HARNESS as fx, sentinelCompletion as fy, OpenAIChatToolChoice as g, SpawnForestNode as gC, RetainedRunEffect as gE, PeerMailReadout as gS, UsageEvent as gT, DetachedSessionRefParts as g_, ResumedWork as ga, SandboxEvidenceRetentionError as gb, StdioMcpServerSpec as gc, AgentGraph as gd, settledToIteration as gf, BridgeModelCredential as gg, DelegateError as gh, InteractiveWorkerEnvironment as gi, EqualKVerdict as gl, CoordinationReadAccess as gm, SurfaceReadOutcome as gn, Deliverable as go, DriveHarnessOwnerContext as gp, compileSearchSpec as gr, renderCorpusToInstructions as gs, summarizeDriverAttempts as gt, LeaderboardScore as gu, UiFindingScreenshot as gv, WorkerTraceEvidence as gw, localHarnessExecutable as gx, CodexRolloutSession as gy, OpenAIChatTool as h, SpawnForestMissingTree as hC, RetainedRunDispatchedAdmission as hE, PeerMailOutcome as hS, TokenUsageProvenance as hT, createSiblingSandboxExecutor as h_, ResumedKeyState as ha, SandboxEvidenceReceipt as hb, StdioMcpConnection as hc, verifyObserverRecords as hd, createRootHandle as hf, BridgeHarnessStore as hg, DelegateArgs as hh, createWorktreeCliExecutor as hi, EqualKOnCostOptions as hl, CoordinationPublicAddress as hm, SurfaceReadBox as hn, strategyTournament as ho, DriveHarness as hp, assertSearchSpec as hr, InMemoryCorpus as hs, classifyDriverFailure as ht, LeaderboardScenario as hu, UiFinding as hv, WorkerInteractiveUnavailableReason as hw, harnessSupportsReasoningEffort as hx, CodexRolloutIdentity as hy, AgentExecutionBackend as i, SqlRunOwnershipError as iC, RecoverRetainedRunIntentOptions as iE, downMessageRefusalReasons as iS, ProviderCheckpointCaptureContext as iT, DetachedWinnerSelection as i_, WorkspaceCheckpointMarker as ia, areaUnderCurve as ib, isTerminalDecision as ic, PursuitNodeUsage as id, RunContextLease as if, AgentEnvironmentProviderRegistry as ig, SpawnResourceReader as ih, ProfileRunRecord as ii, ObserveOptions as il, DeliveredOutput as im, WorkspaceRequest as in, selectBestIndex as io, dumbContinuationPassPrompt as ip, captureWorkerTraceEvidence as ir, PrivateCasOffloadReport as is, ProviderModelExecutionEvidence as it, ShapeContext as iu, DelegationStatus as iv, Executor as iw, WorktreeHandle as ix, mapExecutorResult as iy, TRACE_ROOT_SCHEMA as j, ConfigError as jC, BusEvent as jS, LoopSandboxPlacement as jT, DelegationResumeTick as j_, asAuthoredProfile as ja, generateSpanId as jb, depthStrategy as jc, superviseWithTestBrain as jd, WorkerEventPage as jf, sandboxProgressEvents as jg, SandboxSeam as jh, graphRegistry as ji, RenderCorpusToInstructions as jl, ContinuationContext as jm, attachWorker as jn, S3PrivateCasStore as jo, AllWorkersStalledOptions as jp, safeWorkerFile as jr, observationFromRegistry as js, SuperviseProfileEntry as jt, IsolatedCheckResult as ju, mergeTraceEnv as jv, WorkerProgress as jw, JsonScalar as jx, CodeModeToolContext as jy, EvidencePendingEvent as k, AgentEvalErrorCode as kC, McpToolDescriptor as kS, LoopPlanPayload as kT, DelegationResumeContext as k_, ProfileRichness as ka, createOpenInferenceFileExporter as kb, SurfaceScore as kc, supervise as kd, WorkerEventCursor as kf, mapSandboxEvent as kg, RouterSeam as kh, graphDigest as ki, Pipeline as kl, CheckRead as km, WorkerInteractiveBinding as kn, AcquireOptions as ko, SupervisorProfile as kp, readWorkerSteerAcknowledgement as kr, createScopeAnalyst as ks, SpawnRefusal as kt, IsolatedCheckBoxEvidence as ku, TraceContext as kv, ScopeProgressInput as kw, GateDecision as kx, CodeModeStore as ky, AgentTaskRunResult as l, SqlAdapter as lC, RetainedInteractiveIntentAdmission as lE, AUTHORITY_MARKERS as lS, ProviderWorkspaceCaptureResult as lT, settleDetachedCoderTurn as l_, RootSignal as la, WaterfallReport as lb, inProcessSandboxClient as lc, projectPursuit as ld, SupervisorSpanOptions as lf, ProviderPromptOptions as lg, McpServerOptions as lh, profileRunsForName as li, CombinatorShape as ll, collectDelivered as lm, CreateTangleSandboxExactProcessProviderOptions as ln, EvolutionStrategy as lo, supervisorAgent as lp, createFencedSqlRunContext as lr, builtinShapes as ls, DriverAttemptStop as lt, LeaderboardBenchScore as lu, ResearchOutputShape as lv, ExecutorTeardownWarning as lw, RunLocalHarnessOptions as lx, CompletionVerdict as ly, OpenAIChatResponseFormat as m, SpawnForestInDoubtNode as mC, RetainedRunCancellation as mE, PeerMailLimits as mS, ExecutorToolCall as mT, createFleetWorkspaceExecutor as m_, ReenteredWorkers as ma, SandboxEvidenceContext as mb, McpSpawnFault as mc, observerRecordDigest as md, createSupervisor as mf, cliWorktreeExecutor as mg, DELEGATE_TOOL_NAME as mh, WorktreePatchArtifact as mi, EqualKOnCost as ml, CoordinationMcpHandle as mm, SurfaceDiff as mn, runStrategyEvolution as mo, CoordinationVerbs as mp, SearchSpecOwnedOption as mr, FileCorpus as ms, DriverRepromptRefusal as mt, LeaderboardRunContext as mu, UI_LENSES as mv, WorkerInteractiveSession as mw, LocalHarness as mx, CodexForkBoundary as my, AgentBackendContext as n, parseAuthoredAnalystDefinition as nC, NativeContextContinuationInput as nE, DownMessageEvent as nS, resolveHarnessTranscriptCapture as nT, DelegateRunCtx as n_, SpawnJournal as na, AnytimeTaskCurve as nb, TerminalDecision as nc, PursuitNodeProjection as nd, InMemoryRunContextOptions as nf, sharedWorkerClientName as ng, SpawnResourceBytes as nh, provisionSupervisor as ni, ObservationError as nl, UNPROVEN_CONTINUITY as nm, SandboxEvent$1 as nn, resolveEntrySymbol as no, delegatesWorkerBriefPrompt as np, WORKER_TOOL_TRACE_SCHEMA_VERSION as nr, PrivateCasArtifactPort as ns, NoWinnerError as nt, RunPersonifiedOptions as nu, DelegationProgress as nv, UnknownMaterializationReason as nw, GitRunner as nx, ExecutorResultMapping as ny, AgentRuntimeEvent as o, openSqlRunStore as oC, RecoverRetainedRunResult as oE, MapOnSettleRoute as oS, ProviderWorkspaceAttemptProvenance as oT, UiAuditorDelegate as o_, RootHandle as oa, plateauLength as ob, InProcessOnPrompt as oc, PursuitRunProjection as od, createInMemoryRunContext as of, resolveAgentEnvironmentProvider as og, hostDirectoryReader as oh, loadProfile as oi, observe as ol, FinalizerSettled as om, makeFinding$1 as on, visibleCheckScore as oo, kernelPromptRegistry as op, workerTraceAnalysisStore as or, createPrivateCasArtifactPort as os, RootStreamReceipt as ot, ProviderAsSandboxClientOptions as ou, DelegationStatusResult as ov, ExecutorCancellation as ow, createWorktree as ox, CompletionAnalyst as oy, KnowledgeReadinessDecision as p, SpawnForestEvent as pC, RetainedRunCancelOptions as pE, PeerMailEvent as pS, ExecutorProgressEvent as pT, SiblingSandboxExecutorOptions as p_, Agent as pa, runAgentRounds as pb, McpListedTool as pc, ObserverRecordKind as pd, DEFAULT_MAX_DEPTH as pf, cliInPlaceExecutor as pg, DELEGATE_INPUT_SCHEMA as ph, WorktreeCliExecutorOptions as pi, EqualKArm as pl, CoordinationAuthentication as pm, HarvestSurfaceDiffsOptions as pn, TournamentRow as po, CoordinationToolFace as pp, SearchSpecInputs as pr, runPersonified as ps, DriverLoopRecord as pt, LeaderboardIterationInfo as pu, UI_FINDING_SEVERITIES as pv, Runtime as pw, LOCAL_HARNESSES as px, stopSentinel as py, RetainedExecutionState as q, ExecutionBindingReceipt as qC, AnalystRunContext as qS, RuntimeRunCost as qT, DelegateUiAuditConfig as q_, VisibleCheck as qa, sanitizeRuntimeStreamEvent as qb, strategyAuthorContract as qc, SuperviseRegistry as qd, ReserveOptions as qf, ToolLoopMessageRecord as qg, SharedBoxPlacement as qh, DesignerRunGraphEnv as qi, WinnerStrategy as ql, passedItems as qm, Workspace as qn, assertModelAllowed as qo, RunCancelRequest as qp, RemoteSupervisorAgent as qr, LoopOptionsForDispatch as qs, CheckpointRef as qt, superviseGraphPursuit as qu, FileDelegationStore as qv, ReadableEnvironment as qw, QuestionUrgency as qx, ScoreOf as qy, AgentBackendInput as r, SqlRunLease as rC, ReconnectRetainedRunOptions as rE, WorkerResumeContext as rS, retainHarnessTranscript as rT, DetachedSessionDelegateOptions as r_, TraceRootReceipt as ra, anytimeReport as rb, defaultSelectWinner as rc, PursuitNodeTiming as rd, RunContext as rf, AgentEnvironmentProviderRef as rg, SpawnResourceRead as rh, ProfileRegistryDir as ri, ObserveInput as rl, composeReentryTask as rm, SandboxInstance$1 as rn, sandboxCheckRunner as ro, dumbContinuationFailPrompt as rp, WorkerToolTraceArtifact as rr, PrivateCasDurableStore as rs, ProviderModelAttemptEvidence as rt, ShapeBudget as ru, DelegationResultPayload as rv, EnvironmentTeardownReceipt as rw, RemoveWorktreeOptions as rx, gateOnDeliverable as ry, AgentRuntimeEventSink as s, D1DatabaseLike as sC, RetainedInteractiveAdmission as sE, MapSpawnMarker as sS, ProviderWorkspaceCaptureProvenance as sT, coderTaskFromArgs as s_, RootSegment as sa, renderAnytimeTable as sb, InProcessPromptCtx as sc, PursuitRunTotals as sd, withRunContext as sf, ProviderExecutorOptions as sg, resolveSpawnResourcePaths as sh, pickBestProfile as si, renderReport as sl, SupervisorFinalizer as sm, VerifierEnvironmentOptions as sn, EvolutionAuthor as so, naiveContinuationPrompt as sp, FencedSqlRunContext as sr, equalKOnCost as ss, SupervisedResult as st, providerAsSandboxClient as su, FeedbackRating as sv, ExecutorCancellationRequest as sw, removeWorktree as sx, CompletionEvidence as sy, AgentAdapter as t, normalizeAnalyzeOnSettle as tC, NativeContextContinuationHandle as tE, DownMessageDeliveryOutcome as tS, RetainedHarnessTranscriptDescriptor as tT, CoderReviewer as t_, SpawnEvent as ta, AnytimeStrategySummary as tb, TERMINAL_DECISIONS as tc, PursuitNodePlatform as td, InMemoryRunContext as tf, sharedBoxRefusal as tg, SPAWN_RESOURCE_PATH_MAX_BYTES as th, SupervisorCleanupReceipt as ti, ObservationAnalysis as tl, ReentryTaskInput as tm, ResourceRequest as tn, officialChecksFromMeta as to, createPromptRegistry as tp, analyzeTrace as tr, streamAgentTurn as ts, FleetYield as tt, RunPersonified as tu, DelegationProfile as tv, RootMaterialization as tw, DiffResult as tx, DeliverableSpec as ty, AgentTaskSpec as u, d1ToSqlAdapter as uC, RetainedInteractiveStartedAdmission as uE, DEFAULT_PEER_MAIL_LIMITS as uS, ProviderWorkspaceEntryMetadata as uT, DelegationExecutor as u_, SteerableRootHandle as ua, WaterfallSpan as ub, HttpMcpServerSpec as uc, FileObserverJournal as ud, SupervisorSpanOutcome as uf, providerAsExecutor as ug, createInProcessTransport as uh, recordProfileRun as ui, Corpus as ul, finalizeBestDelivered as um, SandboxControlClient as un, StrategyEvolutionConfig as uo, supervisorAgentWithTestBrain as up, CompiledSearchSpec as ur, createShapeRegistry as us, DriverAttemptsExhaustedError as ut, LeaderboardBenchTask as uu, UiAuditLensFilter as uv, HeldEnvironment as uw, runLocalHarness as ux, completionAuthorizes as uy, RunAgentTaskStreamOptions as v, loadSpawnForest as vC, RetainedRunEventOptions as vE, PeerMailSendInput as vS, DefaultVerdict$2 as vT, DetachedTurnResumeDriverOptions as v_, UnconfirmedTeardown as va, captureBeforeDestroy as vb, materializeLocalMcp as vc, EdgeTraversal as vd, DEFAULT_BUDGET_STOP_HOLD_MS as vf, KeyProvider as vg, DelegateResult as vh, InteractiveWorkerOptions as vi, FanoutOptions as vl, serveCoordinationMcp as vm, WatchedSurface as vn, OpenSandboxRunOptions as vo, ResolveDriveHarness as vp, searchSpecDigest as vr, flatWidenGate as vs, BlockedToolReport as vt, defineLeaderboard as vu, UiLens as vv, SessionMessageLike as vw, parseCodexTokenUsage as vx, CodexRolloutStoreRef as vy, RuntimeFailureCode as w, contentAddress as wC, RetainedRunTurnInput as wE, peerMailTools as wS, LoopIterationDispatchPayload as wT, formatDetachedSessionRef as w_, ChatWorkerSeamOptions as wa, OtelSpan as wb, ArtifactHandle as wc, RunGraphOptions as wd, workerTraceEnv as wf, secretEnvOfMcpServer as wg, CliInPlaceSeam as wh, GraphRegistryDir as wi, LoopUntilState as wl, CoordinationOwnerId as wm, failuresAnalyst as wn, BranchCapableBox as wo, SupervisorToolDescriptor as wp, cancelWorker as wr, widen as ws, MakeWorkerAgent as wt, declaredCheckDeliverable as wu, ResearchTask as wv, sandboxSessionTraceSource as ww, ManagerReentryState as wx, readCodexRolloutSession as wy, RuntimeSessionStore as x, FileSpawnJournal as xC, RetainedRunReplayPoint as xE, claimsAuthority as xS, Iteration as xT, RunDetachedTurnOptions as x_, ChatSessionStore as xa, OtelExportConfig as xb, AgenticSurface as xc, GraphNode as xd, WorkerTraceResolver as xf, mcpSecretEnvMetadataKey as xg, createExecutorRegistry as xh, WorkerInteractiveAdmission as xi, FlatWidenGate as xl, CoordinationRejectReason as xm, harvestSurfaceDiffs as xn, SandboxRunAbortError as xo, SupervisorAgentTestDeps as xp, WorkerSteerAcknowledgement as xr, pipeline as xs, CoordinationToolsOptions as xt, DeclaredCheckStateCapture as xu, MultiHarnessResearcherFanoutOptions as xv, TraceSource as xw, CoordinationEvent as xx, addHarnessUsage as xy, RuntimeCanonicalStreamEvent as y, FileResultBlobStore as yC, RetainedRunHandle as yE, PeerMailbox as yS, Driver as yT, DriveTurnCapableBox as y_, WidenGate as ya, LoopSpanNode as yb, AgenticOptions as yc, GraphEdge as yd, SUBTREE_RESULT_LIMIT as yf, ResolvedMcpServerLaunch as yg, createDelegateHandler as yh, InteractiveWorkerResult as yi, FanoutSynthesis as yl, CoordinationHttpAudit as ym, boxSurfaceReader as yn, OpenSandboxRunPromptOptions as yo, ResolveSupervisorTools as yp, WorkerCancelRequest as yr, loopUntil as ys, CoordinationStats as yt, DeclaredCheck as yu, KnowledgeItem as yv, SessionTraceBox as yw, CodexExecutionPolicy as yx, CodexRolloutTurn as yy, ResourceSpend as z, RuntimeRunStateError as zC, watchTrace as zS, MountRecorder as zT, DelegateCodeConfig as z_, CheckRunner as za, RuntimeStreamEventSummary as zb, StrategyArtifacts as zc, ResolvedWorkerSpawnRetry as zd, LeakedReservation as zf, RouterResponseReceipt as zg, InboxLease as zh, taskShapeDigest as zi, TrajectoryReportFn as zl, PanelFinding as zm, settledWorkerOut as zn, claimRetainedInteractiveControl as zo, StopRule as zp, workerInboxFile as zr, BenchmarkReport as zs, AgentEnvironmentSummary as zt, SettledPursuitVersion as zu, DelegationTraceSpan as zv, RetainedInteractiveStartMaterial as zw, QuestionDecision as zx, GroupOf as zy };
20881
- //# sourceMappingURL=types-CrNWif8-.d.ts.map
19497
+ export { NoWinnerError as $, WorktreeProfileMaterializationReceipt as $_, strategyTournament as $a, ScopeProgressInput as $b, TrajectoryNode as $c, formatPromptHandle as $d, CoordinationLog as $f, LeaderboardRow as $g, ResearcherProfileOptions as $h, ChatTransportExecutorOptions as $i, PursuitVersions as $l, CoderReviewer as $m, SqlRunContextOptions as $n, createScopeAnalyst as $o, DEFAULT_SHARED_BOX_WORKERS as $p, GraphRunRecord as $r, depthStrategy as $s, createVerifierEnvironment as $t, WorkerSpawnRetryAttempt as $u, PeerMailbox as $v, LoopPlanPayload as $x, InMemorySpawnJournal as $y, TraceRootArtifact as A, RecoverRetainedRunResult as AS, OtelExporter as A_, filterAuthoredAsserts as Aa, ExecutorCancellation as Ab, AssertTraceDerivedFindings as Ac, BudgetReadout as Ad, RunCancelRequest as Af, CodexRolloutStoreReader as Ag, DelegateUiAuditRoute as Ah, SpawnJournal as Ai, LeaderboardScenario as Al, SandboxOutputMarker as Am, settledWorkerOut as An, PrivateCasDurableStore as Ao, createExecutorRegistry as Ap, RemoteWorkerEvents as Ar, InProcessSandboxClientOptions as As, AgentEnvironmentStatus as At, EdgeDeliveryOutcome as Au, AuthorizeDownMessage as Av, ProviderWorkspaceAttemptProvenance as Ax, CodexExecutionEvidence as Ay, Handle as B, RetainedRunEffect as BS, RuntimeStreamEventSummary as B_, AgentTurnUsage as Ba, WorkerTraceEvidence as Bb, FanoutWinnerSelector as Bc, RootStreamRecord as Bd, FinalizeContext as Bf, CodeModeStore as Bg, FeedbackRefersTo as Bh, SupervisorOpts as Bi, declaredCheckDigest as Bl, RouterTransportConfig as Bm, WorkspaceRun as Bn, renderCorpusToInstructions as Bo, SandboxSeam as Bp, loadProfile as Br, materializeLocalMcp as Bs, CreateAgentEnvironmentInput$1 as Bt, runGraph as Bu, MapOnSettleRoute as Bv, UsageEvent as Bx, SqlAdapter as By, RuntimeFailureCause as C, startRuntimeRun as CS, runAgentRounds as C_, StructuralRolloutResult as Ca, NodeExecutionIdentity as Cb, ObservationAnalysis as Cc, SupervisorSpanOutcome as Cd, ProgressView as Cf, completionAuthorizes as Cg, SubmitOutput as Ch, GraphDesignerExtraTools as Ci, DefinedLeaderboard as Cl, ResolvedMcpServerLaunch as Cm, readWorkerInteractiveBinding as Cn, recoverRetainedInteractiveRun as Co, McpServer as Cp, supervisorRunDir as Cr, LocalSandboxClientOptions as Cs, SuperviseProfileEntry as Ct, projectPursuit as Cu, QuestionEscalationTarget as Cv, HarnessTranscriptReadOptions as Cx, AnalystLensOutput as Cy, RetainedPendingCause as D, ReconnectRetainedRunOptions as DS, OtelAttribute as D_, composeCheckSources as Da, EnvironmentTeardownReceipt as Db, defaultAnalystInstruction as Dc, DeadlineCheckIn as Dd, anyOf as Df, CodexForkBoundary as Dg, DelegateResearchConfig as Dh, delegate as Di, LeaderboardFlagSpec as Dl, resolveSecretEnv as Dm, WorkerEvidenceInput as Dn, profileChatClient as Do, DelegateHandlerOptions as Dp, RemoteSupervisorAgent as Dr, inlineSandboxClient as Ds, AgentEnvironmentEvent$1 as Dt, ObserverRecordKind as Du, QuestionRecord as Dv, retainHarnessTranscript as Dx, AuthoredAnalystDefinition as Dy, EvidencePendingEvent as E, NativeContextContinuationInput as ES, SandboxEvidenceRetentionPort as E_, compareCheckOutcomes as Ea, UnknownMaterializationReason as Eb, ObserveOptions as Ec, WorkerTraceResolver as Ed, allWorkersStalled as Ef, stopSentinel as Eg, DelegateResearchArgs as Eh, defaultDelegateBudget as Ei, LeaderboardBenchmarkAdapter as El, resolveMcpServerLaunch as Em, VERIFY_TAIL_CHARS as En, resolveSandboxClient as Eo, DelegateError as Ep, writeWorkerSteer as Er, defaultSelectWinner as Es, AgentEnvironmentCapabilities$1 as Et, ObserverRecord as Eu, QuestionPolicy as Ev, resolveHarnessTranscriptCapture as Ex, AnalyzeOnSettleRoute as Ey, ResourceLimit as F, RetainedRunAdmission as FS, padSpanId as F_, selectBestIndex as Fa, HeldForContinuation as Fb, EqualKArm as Fc, ReservationShortfall as Fd, ReentryContinuity as Ff, createCodexRolloutStoreReader as Fg, DelegationProgress as Fh, RootSegment as Fi, DeclaredCheckPlacement as Fl, SandboxServedBackend as Fm, withUntrackedArtifacts as Fn, trajectoryReport as Fo, CliWorktreeBridgeSeam as Fp, SupervisorCleanupReceipt as Fr, McpListedTool as Fs, AgentSessionStatus$1 as Ft, GraphResult as Fu, DownMessageDeliveryAttempt as Fv, ProviderWorkspaceRetentionContext as Fx, LocalHarness as Fy, Settled as G, RetainedRunReplayPoint as GS, createRuntimeStreamEventCollector as G_, EvolutionAuthor as Ga, TraceSource as Gb, PanelSpec as Gc, PromptHandle as Gd, CoordinationMcpHandle as Gf, RunCodeModeOptions as Gg, UiFindingScreenshot as Gh, Scope as Gi, IsolatedCheckOptions as Gl, ToolLoopCompaction as Gm, TrajectoryAnalysis as Gn, pipeline as Go, createSteerableSandboxSession as Gp, InteractiveWorkerEnvironment as Gr, AgenticTool as Gs, PlacementInfo as Gt, workerFromBackend as Gu, PEER_MAIL_WIRE_KEY as Gv, Iteration as Gx, SpawnForestMissingTree as Gy, NodeSnapshot as H, RetainedRunEventOptions as HS, SanitizedKnowledgeReadinessReport as H_, StreamAgentTurnOptions as Ha, SessionMessageLike as Hb, LoopUntilState as Hc, readRootStreamReceipt as Hd, SupervisorFinalizer as Hf, CodeModeToolContext as Hg, UiAuditLensFilter as Hh, ReenteredWorkers as Hi, readDeclaredCheck as Hl, ToolSpec as Hm, jjWorkspace as Hn, flatWidenGate as Ho, SandboxSteeringOptions as Hp, profileRegistry as Hr, AgenticRunResult as Hs, ExecRequest as Ht, supervise as Hu, MapTraversalEvent as Hv, DefaultVerdict$2 as Hx, SpawnForest as Hy, ResourceSpend as I, RetainedRunAdmissionHook as IS, padTraceId as I_, structuralRollout as Ia, HeldRelease as Ib, EqualKOnCostOptions as Ic, ReservationStage as Id, ReentryTaskInput as If, harnessUsageIsEmpty as Ig, DelegationResultPayload as Ih, RootSegmentEntry as Ii, DeclaredCheckStateCapture as Il, SandboxUsageLedger as Im, GitWorkspaceOptions as In, definePersona as Io, CliWorktreeSeam as Ip, provisionSupervisor as Ir, McpSpawnFault as Is, AgentTurnResult$2 as It, GraphTopology as Iu, DownMessageDeliveryOutcome as Iv, ProviderWorkspaceRetentionPort as Ix, CodexTokenUsage as Iy, SpawnRejection as J, RetainedRunTurnInput as JS, sanitizeRuntimeStreamEvent as J_, StrategyEvolutionConfig as Ja, sandboxSessionTraceSource as Jb, RenderCorpusToInstructionsOptions as Jc, analyzesFindingsReportPrompt as Jd, CoordinationTransportOptions as Jf, AxisScoresOf as Jg, KnowledgeItem as Jh, WorkerEventCursor as Ji, JudgedPursuitVersion as Jl, ToolLoopToolCall as Jm, parseWorkerToolTraceArtifact as Jn, widen as Jo, InboxLease as Jp, InteractiveWorkerResult as Jr, RunAgenticOptions as Js, SandboxInstance$1 as Jt, SuperviseOptions as Ju, PeerMailLimits as Jv, LoopIterationDispatchPayload as Jx, loadSpawnForest as Jy, SpawnOpts as K, RetainedRunSnapshot as KS, sanitizeAgentRuntimeEvent as K_, EvolutionReport as Ka, createPushTraceSource as Kb, PanelVerdict as Kc, PromptRegistry as Kd, CoordinationPublicAddress as Kf, createCodeModeTools as Kg, UiFindingSeverity as Kh, UnconfirmedTeardown as Ki, IsolatedCheckResult as Kl, ToolLoopCompactionOptions as Km, analyzeTrace as Kn, selectValidWinner as Ko, AuthorityInboxMessage as Kp, InteractiveWorkerKeyInput as Kr, ArtifactHandle as Ks, ResourceRequest as Kt, AuthorizedSpawn as Ku, PeerMailEnvelope as Kv, LoopDecisionPayload as Kx, SpawnForestNode as Ky, Spend as L, RetainedRunCancelOptions as LS, RuntimeEventCollector as L_, visibleCheckScore as La, Runtime as Lb, EqualKVerdict as Lc, ReservationTicket as Ld, UNPROVEN_CONTINUITY as Lf, readCodexRolloutSession as Lg, DelegationStatus as Lh, RootSignal as Li, assertDeclaredCheck as Ll, extractLlmCallEvent as Lm, Shell as Ln, runPersonified as Lo, ProviderSeam as Lp, ProfileRegistryDir as Lr, StdioMcpConnection as Ls, AnalystFinding$1 as Lt, RunGraphOptions as Lu, DownMessageEvent as Lv, ExecutorProgressEvent as Lx, CodexExecutionPolicy as Ly, Budget as M, RetainedInteractiveEnvironmentAdmission as MS, buildLoopOtelSpans as M_, officialChecksFromMeta as Ma, ExecutorResult as Mb, Corpus as Mc, ReservationFloor as Md, cancelRun as Mf, CodexRolloutTurn as Mg, DelegationFeedbackSnapshot as Mh, WorkspaceCheckpointMarker as Mi, LeaderboardSpec as Ml, createSandboxToolPartState as Mm, CopyOptions as Mn, PrivateCasOptions as Mo, createExecutor as Mp, ProvisionSupervisorConnection as Mr, HttpMcpServerSpec as Ms, AgentProfile$2 as Mt, GraphEdge as Mu, ContinuationInstruction as Mv, ProviderWorkspaceCaptureReceipt as Mx, RunLocalHarnessOptions as My, BudgetOverspend as N, RetainedInteractiveIntentAdmission as NS, createOtelExporter as N_, resolveEntrySymbol as Na, ExecutorTeardownWarning as Nb, CorpusFilter as Nc, ReservationHolder as Nd, readRunCancelRequest as Nf, CodexStoreDelta as Ng, DelegationHistoryArgs as Nh, RecursiveReservationPolicy as Ni, defineLeaderboard as Nl, mapSandboxEvent as Nm, UntrackedCopyStats as Nn, createPrivateCasArtifactPort as No, CliInPlaceSeam as Np, ProvisionSupervisorRequest as Nr, LocalMcpMaterialization as Ns, AgentSession as Nt, GraphEdgeCapError as Nu, ContinuityMode as Nv, ProviderWorkspaceCaptureResult as Nx, runLocalHarness as Ny, TRACE_ROOT_SCHEMA as O, RecoverRetainedRunIntentOptions as OS, OtelExportConfig as O_, defaultExtractCandidate as Oa, Executor as Ob, observe as Oc, BudgetPool as Od, noProgressFor as Of, CodexRolloutIdentity as Og, DelegateUiAuditArgs as Oh, ResultBlobStore as Oi, LeaderboardIterationInfo as Ol, secretEnvOfMcpServer as Om, closingWorkerNote as On, profileOptimizerModelCall as Oo, DelegateResult as Op, RemoteSupervisorReader as Or, InProcessOnPrompt as Os, AgentEnvironmentProvider$1 as Ot, observerRecordDigest as Ou, QuestionUrgency as Ov, ProviderCheckpointCaptureContext as Ox, AuthoredAnalystLimits as Oy, BudgetViolation as P, RetainedInteractiveStartedAdmission as PS, loopEventToOtelSpan as P_, sandboxCheckRunner as Pa, HeldEnvironment as Pb, CorpusRecord as Pc, ReservationRejection as Pd, readRunCancellation as Pf, addHarnessUsage as Pg, DelegationHistoryEntry as Ph, RootHandle as Pi, DeclaredCheck as Pl, mapSandboxToolEvent as Pm, copyUntrackedIntoClone as Pn, equalKOnCost as Po, CliSeam as Pp, ProvisionedSupervisor as Pr, MaterializeLocalMcpOptions as Ps, AgentSessionRef as Pt, GraphNode as Pu, DownMessageAuthorizationInput as Pv, ProviderWorkspaceEntryMetadata as Px, LOCAL_HARNESSES as Py, FleetYield as Q, WorktreeHarnessResult as Q_, runStrategyEvolution as Qa, ExecutorProgress as Qb, SteerContext as Qc, dumbContinuationPassPrompt as Qd, CoordinationDeliveryEvidence as Qf, LeaderboardOptions as Qg, ResearchTask as Qh, ChatSessionStore as Qi, PursuitVersionStop as Ql, CoderReview as Qm, FencedSqlRunContext as Qn, buildSteerContext as Qo, DEFAULT_SHARED_BOX_RESOURCES as Qp, GraphRegistryDir as Qr, breadthStrategy as Qs, VerifierEnvironmentOptions as Qt, ResolvedWorkerSpawnRetry as Qu, PeerMailSendInput as Qv, LoopPlanDescription as Qx, InMemoryResultBlobStore as Qy, SpendChannel as R, RetainedRunCancellation as RS, RuntimeStreamEventCollector as R_, AgentTurnBackend as Ra, WorkerInteractiveSession as Rb, FanoutOptions as Rc, ReserveOptions as Rd, composeReentryTask as Rf, HarnessUsage as Rg, DelegationStatusResult as Rh, SteerableRootHandle as Ri, checkProgramDigest as Rl, sumSandboxUsage as Rm, Workspace as Rn, FileCorpus as Ro, RouterSeam as Rp, ProfileRunRecord as Rr, StdioMcpServerSpec as Rs, CheckpointRef as Rt, RunGraphTestOptions as Ru, WorkerResumeContext as Rv, ExecutorToolCall as Rx, SqlRunOwnershipError as Ry, RuntimeStreamEvent as S, RuntimeRunStatus as SS, RunAgentRoundsOptions as S_, StructuralRolloutPolicy as Sa, MaterializedModelIdentity as Sb, Observation as Sc, SupervisorSpanOptions as Sd, PlateauOptions as Sf, CompletionVerdict as Sg, SubmitInput as Sh, DesignerToolsEnv as Si, providerAsSandboxClient as Sl, KeyProvider as Sm, attachWorker as Sn, reconnectRetainedInteractiveRun as So, resolveSpawnResourcePaths as Sp, safeWorkerFile as Sr, superviseDispatch as Ss, SpawnRefusalCause as St, PursuitStatus as Su, QuestionEscalationRecord as Sv, HarnessTranscriptReadLimits as Sx, AnalystKind as Sy, RuntimeFailureOwner as T, NativeContextContinuationHandle as TS, SandboxEvidenceReceipt as T_, canDisplace as Ta, RootMaterialization as Tb, ObserveInput as Tc, createSupervisorSpanRecorder as Td, StopRule as Tf, sentinelCompletion as Tg, DelegateCodeConfig as Th, DelegateOptions as Ti, LeaderboardBenchTask as Tl, mcpSecretEnvMetadataKey as Tm, NOTE_MAX_CHARS as Tn, ResolveSandboxClientOptions as To, createMcpServer as Tp, workerInboxFileFromEventDir as Tr, TerminalDecision as Ts, AgentEnvironment$1 as Tt, ObserverJournal as Tu, QuestionOption as Tv, RetainedHarnessTranscriptDescriptor as Tx, AnalystRunContext as Ty, NodeStatus as U, RetainedRunHandle as US, SanitizedKnowledgeRequirement as U_, collectAgentTurn as Ua, SessionTraceBox as Ub, Panel as Uc, defaultEdgeTraversalCap as Ud, bestDelivered as Uf, CodeModeToolsOptions as Ug, UiAuditorDelegationOutput as Uh, ResumedKeyState as Ui, IsolatedCheckBox as Ul, ToolLoopCallContext as Um, localShell as Un, loopUntil as Uo, SteerableSandboxArgs as Up, profileRunsForName as Ur, AgenticSurface as Us, ExecResult as Ut, superviseFleetCapabilities as Uu, AUTHORITY_MARKERS as Uv, Driver as Ux, SpawnForestEvent as Uy, NodeId as V, RetainedRunEnvironmentAdmission as VS, RuntimeTelemetryOptions as V_, CollectedAgentTurn as Va, WorkerTraceUnavailableReason as Vb, LoopUntilSpec as Vc, readRootStream as Vd, FinalizerSettled as Vf, CodeModeTool as Vg, ResearchOutputShape as Vh, Agent as Vi, declaredCheckJudge as Vl, RouterRouting as Vm, gitWorkspace as Vn, fanout as Vo, DEFAULT_SANDBOX_STEERING_MAX_TURNS as Vp, pickBestProfile as Vr, AgenticOptions as Vs, CreateSandboxOptions$1 as Vt, runGraphWithTestBrain as Vu, MapSpawnMarker as Vv, AgentRunSpec as Vx, materializeTreeView as Vy, RetainedExecutionState as W, RetainedRunIntentAdmission as WS, createRuntimeEventCollector as W_, streamAgentTurn as Wa, ToolStepInput as Wb, PanelJudge as Wc, GraphRouteError as Wd, CoordinationAuthentication as Wf, CodeModeToolset as Wg, UiFinding as Wh, ResumedWork as Wi, IsolatedCheckBoxEvidence as Wl, ToolLoopChat as Wm, runInWorkspace as Wn, panel as Wo, SteerableSandboxSession as Wp, recordProfileRun as Wr, AgenticTask as Ws, ForkRequest as Wt, superviseWithTestBrain as Wu, DEFAULT_PEER_MAIL_LIMITS as Wv, ExecCtx as Wx, SpawnForestInDoubtNode as Wy, SubtreeSummary as X, StartRetainedRunOptions as XS, WorktreeCheckRunner as X_, TournamentCell as Xa, ActivityNote as Xb, ScopeAnalyzeInput as Xc, delegatesWorkerBriefPrompt as Xd, CoordinationHttpAudit as Xf, Interval as Xg, ResearchOutput as Xh, WorkerEventPage as Xi, NextPursuitVersionInput as Xl, FeedbackStore as Xm, createSupervisor as Xn, RegistryAnalyzeProjection as Xo, PeerInboxMessage as Xp, InPlaceCliExecutorOptions as Xr, StrategyShotResult as Xs, computeFindingId$1 as Xt, WorkerSlots as Xu, PeerMailReadout as Xv, LoopIterationStartedPayload as Xx, replaySpawnTree as Xy, SubtreeResult as Y, StartRetainedRunInEnvironmentOptions as YS, InPlaceHarnessResult as Y_, StrategyTournament as Ya, ActivityLog as Yb, ScopeAnalyst as Yc, createPromptRegistry as Yd, serveCoordinationMcp as Yf, GroupOf as Yg, KnowledgeUpdate as Yh, WorkerEventEntry as Yi, NextPursuitVersion as Yl, FeedbackEvent as Ym, DEFAULT_MAX_DEPTH as Yn, CreateScopeAnalystOptions as Yo, InboxMessage as Yp, workerFromInteractiveProvider as Yr, StrategyMessage as Ys, WorkspaceRequest as Yt, SuperviseTestOptions as Yu, PeerMailOutcome as Yv, LoopIterationEndedPayload as Yx, FileResultBlobStore as Yy, TreeView as Z, WorktreeCommandResult as Z_, TournamentRow as Za, DEFAULT_STALL_AFTER_MS as Zb, ScopeWidenGate as Zc, dumbContinuationFailPrompt as Zd, CoordinationRejectReason as Zf, Leaderboard as Zg, ResearchSource as Zh, ChatCompletionsTransport as Zi, PursuitVersionChain as Zl, CoderDelegate as Zm, createRootHandle as Zn, assertTraceDerivedFindings as Zo, createInbox as Zp, createInPlaceCliExecutor as Zr, SurfaceScore as Zs, makeFinding$1 as Zt, createWorkerSlots as Zu, PeerMailRefusal as Zv, LoopLineageOptions as Zx, FileSpawnJournal as Zy, RunAgentTaskOptions as _, RuntimeRunCost as _S, renderAnytimeTable as __, CheckSource as _a, ExecutionBindingReceipt as _b, HarvestCorpusOptions as _c, RunContextLease as _d, SupervisorToolInvocationContext as _f, mapExecutorResult as _g, DelegationResumeDriver as _h, RollingDispatchOptions as _i, RunPersonifiedOptions as _l, UnavailablePausePolicy as _m, WorktreePatchArtifact as _n, recoverRetainedRun as _o, ResolvedSpawnResourcePath as _p, cancelWorker as _r, LoopOptionsForDispatch as _s, PeerAuditAccess as _t, PursuitNodeTiming as _u, ChildQuestionInbox as _v, ReadableEnvironment as _x, WatchTraceOptions as _y, AgentKnowledgeProvider as a, LoopTraceEmitter as aS, pairwiseSignificance as a_, AuthoredProfile as aa, BackendTransportError as ab, ShotSpec as ac, withWorkerSpawnRetry as ad, CoordinationToolFace as af, composeLoopTraceEmitters as ag, DelegationExecutor as ah, graphRegistry as ai, WidenDecision as al, sharedBoxPlacement as am, SurfaceReader as an, SandboxRunAbortError as ao, ContinuationPanel as ap, SearchSpecOwnedOption as ar, sanitizeMcpToolSchema as as, DriverAttemptRecord as at, SupervisePursuitError as au, ManagerReentryState as av, RecoverRetainedInteractiveRunOptions as ax, peerMailVerbNames as ay, RuntimeSession as b, RuntimeRunPersistenceAdapter as bS, WaterfallSpan as b_, StructuralRolloutConfig as ba, ExecutorNodeContext as bb, HarvestReport as bc, withRunContext as bd, AllWorkersStalledOptions as bf, CompletionEvidence as bg, DelegationTaskQueue as bh, rollingDispatch as bi, ShapeRegistry as bl, BridgeModelCredential as bm, WorkerInteractiveBinding as bn, ClaimRetainedInteractiveControlOptions as bo, SpawnResourceReader as bp, readWorkerSteerAcknowledgement as br, loopCampaignDispatch as bs, SpawnPreflightContext as bt, PursuitRunProjection as bu, QuestionDecision as bv, persistHarnessTranscript as bx, AnalystAssignmentRecord as by, AgentTaskContext as c, MountManifestEntry as cS, renderLeaderboardSvg as c_, asAuthoredProfile as ca, NotFoundError as cb, StrategyCtx as cc, SeatSegment as cd, DriveHarnessOwnerContext as cf, FileDelegationStore as cg, SiblingSandboxExecutorOptions as ch, loadGraph as ci, WinnerStrategy as cl, sharedWorkerClientName as cm, fsSurfaceReader as cn, SandboxLineage as co, ContinuationPolicy as cp, searchPresets as cr, BenchmarkLift as cs, DriverFailureClass as ct, superviseGraphPursuit as cu, WorkerWatchOptions as cv, RetainedInteractiveRunHandle as cx, McpToolAnnotations as cy, AgentTaskStatus as d, RunProvenance as dS, AnytimeStrategySummary as d_, profileRichnessFinding as da, AgentSpec as db, assertStrategyContract as dc, SeatStage as dd, ResolveSupervisorTools as df, CoderTask as dg, DetachedTurn as dh, recordGraphRun as di, LoopShape as dl, createAgentEnvironmentProviderRegistry as dm, analystsFromRegistry as dn, AcquireOptions as do, VerdictSummary as dp, createScope as dr, BenchmarkTaskRow as ds, CoordinationStats as dt, RUN_FORK_CORRELATION_KEYS as du, GateRequest as dv, HarnessTranscriptArtifact as dx, BusEvent as dy, LoopResult as eS, PairwiseOptions as e_, ChatTransportTool as ea, contentAddress as eb, refine as ec, WorkerSpawnRetryHooks as ed, kernelPromptRegistry as ef, researcherProfile as eg, DelegateRunCtx as eh, GraphSelection as ei, TrajectoryReport as el, SharedBoxCloseReceipt as em, BoxSurfaceReaderOptions as en, Deliverable as eo, FileCoordinationLog as ep, createFencedSqlRunContext as er, registryScopeAnalyst as es, ProviderModelAttemptEvidence as et, SettledPursuitVersion as eu, GitRunner as ev, TeamProgress as ex, PeerMailboxOptions as ey, BackendErrorDetail as f, SandboxClient as fS, AnytimeTaskCurve as f_, supervisorInstructions as fa, ExecutorContext as fb, authorStrategy as fc, SelectSeat as fd, SupervisorAgentDeps as ff, CheckUnavailableError as fg, RunDetachedTurnOptions as fh, storedGraphDigests as fi, Outcome as fl, resolveAgentEnvironmentProvider as fm, failuresAnalyst as fn, acquireSandbox as fo, admitContinuationPolicy as fp, ScopeArgs as fr, Environment as fs, CoordinationTools as ft, PursuitObserverDelivery as fu, JsonScalar as fv, HarnessTranscriptCapture as fx, BusRecord as fy, OpenAIChatToolChoice as g, RuntimeRunCompleteInput as gS, plateauLength as g_, CheckRunner as ga, AgentExecutionRef as gb, strategyAuthorSystemPrompt as gc, RunContext as gd, SupervisorToolDescriptor as gf, gateOnDeliverable as gg, DelegationResumeContext as gh, DispatchUnit as gi, RunPersonified as gl, providerAsExecutor as gm, WorktreeCliExecutorOptions as gn, reconnectRetainedRun as go, ResolveSpawnResourcePathsResult as gp, WriteWorkerSteerOptions as gr, LoopDispatchOptions as gs, MakeWorkerAgent as gt, PursuitNodeProjection as gu, RouteWhen as gv, HarnessTranscriptUnavailableReason as gx, createEventBus as gy, OpenAIChatTool as h, Validator as hS, bestSoFar as h_, CheckRunContext as ha, SpawnModelSubstitution as hb, strategyAuthorContract as hc, InMemoryRunContextOptions as hd, SupervisorNodeContextSeed as hf, ExecutorResultMapping as hg, DelegationRecord as hh, DispatchStopReason as hi, PersonaExecutors as hl, ProviderPromptOptions as hm, worktreeFanout as hn, createS3PrivateCasStore as ho, DriverRetryPolicy as hp, WorkerSteerRequest as hr, LoopCampaignDispatchOptions as hs, GraphSubtasks as ht, PursuitNodePlatform as hu, RouteMatch as hv, HarnessTranscriptUnavailable as hx, PublishOptions as hy, AgentExecutionBackend as i, LoopTokenUsage as iS, leaderboard as i_, createChatSessionStore as ia, AgentEvalErrorCode as ib, AuthoredStrategy as ic, retryPreSpawnRefusals as id, supervisorAgentWithTestBrain as if, DelegationTraceSpan as ig, detachedSessionDelegate as ih, graphFromStored as ii, Widen as il, SharedWorkerIdentity as im, SurfaceReadOutcome as in, SandboxRun as io, ContinuationEntry as ip, SearchSpecInputs as ir, createMcpEnvironment as is, SupervisedResult as it, SuperviseGraphPursuitOptions as iu, LeadMessage as iv, ReconnectRetainedInteractiveRunOptions as ix, peerMailTools as iy, TraceSummary as j, RetainedInteractiveAdmission as jS, OtelSpan as j_, modelAuthoredChecks as ja, ExecutorCancellationRequest as jb, CombinatorShape as jc, LeakedReservation as jd, RunCancellation as jf, CodexRolloutStoreRef as jg, DelegationError as jh, TraceRootReceipt as ji, LeaderboardScore as jl, SandboxToolPartState as jm, spendFromUsageEvents as jn, PrivateCasOffloadReport as jo, ExecutorConfig as jp, connectRemoteSupervisor as jr, inProcessSandboxClient as js, AgentEnvironmentSummary as jt, EdgeTraversal as ju, AuthorizedDownMessage as jv, ProviderWorkspaceCaptureProvenance as jx, LocalHarnessResult as jy, TRACE_SUMMARY_SCHEMA as k, RecoverRetainedRunOptions as kS, OtelExportStats as k_, defaultStructuralRolloutPolicy as ka, ExecutorAccounting as kb, renderReport as kc, BudgetPoolRestore as kd, plateau as kf, CodexRolloutSession as kg, DelegateUiAuditConfig as kh, SpawnEvent as ki, LeaderboardRunContext as kl, SandboxLeafOut as km, composeWorkerEvidence as kn, PrivateCasArtifactPort as ko, createDelegateHandler as kp, RemoteSupervisorTree as kr, InProcessPromptCtx as ks, AgentEnvironmentQuery as kt, AgentGraph as ku, questionEscalationTargets as kv, ProviderNativeCapturePhase as kx, DefinedAnalystRecord as ky, AgentTaskRunResult as l, MountRecorder as lS, renderPairwiseMarkdown as l_, assessAuthoredProfile as la, RuntimeRunStateError as lb, StrategyResult as lc, SeatSelection as ld, ObserveSupervisorNodeEvent as lf, FileDelegationStoreOptions as lg, createFleetWorkspaceExecutor as lh, lookupGraph as li, DefinePersona as ll, AgentEnvironmentProviderRef as lm, harvestSurfaceDiffs as ln, SandboxLineageHandle as lo, ContinuationProfile as lp, searchSpecDigest as lr, BenchmarkReport as ls, DriverRepromptRefusal as lt, supervisePursuit as lu, DecideGate as lv, RetainedInteractiveStartMaterial as lx, McpToolDescriptor as ly, OpenAIChatResponseFormat as m, ValidationCtx as mS, areaUnderCurve as m_, CheckOutcome as ma, ExecutorRegistry as mb, sampleThenRefine as mc, InMemoryRunContext as md, SupervisorNodeContext as mf, DeliverableSpec as mg, DelegationArgs as mh, DispatchReport as mi, PersonaContext as ml, ProviderLeafOut as mm, WorktreeFanoutOptions as mn, S3PrivateCasStoreOptions as mo, DriverReentry as mp, WorkerSteerAcknowledgement as mr, runBenchmark as ms, GraphSubtaskPreparation as mt, PursuitNodeCost as mu, RouteGate as mv, HarnessTranscriptFile as mx, EventBus as my, AgentBackendContext as n, LoopStartedPayload as nS, ProfileKeyOf as n_, chatTransportExecutor as na, defaultRedactor as nb, sample as nc, isPreSpawnExecutorFailure as nd, promptHandle as nf, createPropagatingTraceEmitter as ng, DetachedWinnerSelection as nh, digestOfGraph as ni, Verify as nl, SharedBoxPlacementOptions as nm, SurfaceDiff as nn, OpenSandboxRunOptions as no, CheckRead as np, SEARCH_SPEC_CORRELATION_KEY as nr, McpEndpoint as ns, RootProviderModelEvidence as nt, VersionVerdict as nu, CoordinationEvent as nv, createActivityLog as nx, createPeerMailbox as ny, AgentRuntimeEvent as o, LoopTraceEvent as oS, renderLeaderboardHtml as o_, ProfileRichness as oa, ConfigError as ob, Strategy as oc, SuperviseRegistry as od, CoordinationVerbs as of, DelegationPersistenceError as og, FleetHandle as oh, graphRunsFor as oi, WidenLineage as ol, ROUTER_CLIENT_HEADER as om, WatchedSurface as on, TurnResult as oo, ContinuationPanelInput as op, assertSearchSpec as or, BenchmarkCell as os, DriverAttemptStop as ot, SupervisePursuitOptions as ou, ManagerWake as ov, RetainedInteractiveAdmissionHook as ox, JsonRpcMessage as oy, KnowledgeReadinessDecision as p, SelectionReceipt as pS, anytimeReport as p_, CheckExecChannel as pa, ExecutorFactory as pb, defineStrategy as pc, subscriptionUsageLimitSignal as pd, SupervisorAgentTestDeps as pf, CheckVerdict as pg, runDetachedTurn as ph, taskShapeDigest as pi, Persona as pl, ProviderExecutorOptions as pm, AuthoredHarness as pn, S3PrivateCasStore as po, DriverContractState as pp, WorkerCancellation as pr, printBenchmarkReport as ps, CoordinationToolsOptions as pt, PursuitCostProvenance as pu, RouteFlow as pv, HarnessTranscriptEvidence as px, BusStats as py, SpawnPrior as q, RetainedRunStartMaterial as qS, sanitizeKnowledgeReadinessReport as q_, EvolutionStrategy as qa, decodeToolPart as qb, PipelineStage as qc, RegisteredPrompt as qd, CoordinationReadAccess as qf, runCodeMode as qg, UiLens as qh, WidenGate as qi, runIsolatedCheck as ql, ToolLoopMessageRecord as qm, WorkerToolTraceArtifact as qn, verify as qo, Inbox as qp, InteractiveWorkerOptions as qr, CorpusReadbackOptions as qs, SandboxEvent$1 as qt, AuthorizedSpawnContext as qu, PeerMailEvent as qv, LoopEndedPayload as qx, SpawnForestTree as qy, AgentBackendInput as r, LoopTeardownFailedPayload as rS, ScoreOf as r_, chatWorkerSeam as ra, AgentEvalError$1 as rb, AuthorStrategyOptions as rc, resolveWorkerSpawnRetry as rd, supervisorAgent as rf, readTraceContextFromEnv as rg, UiAuditorDelegate as rh, graphDigest as ri, VerifySpec as rl, SharedBoxStats as rm, SurfaceReadBox as rn, OpenSandboxRunPromptOptions as ro, ContinuationAppend as rp, SearchSpec as rr, McpEnvironmentOptions as rs, RootStreamReceipt as rt, assertPursuitVersions as ru, EventAcknowledgement as rv, readWorkerProgress as rx, isPeerMailEnvelope as ry, AgentRuntimeEventSink as s, LoopWinner as sS, renderLeaderboardMarkdown as s_, ProfileRichnessThresholds as sa, JudgeError as sb, StrategyArtifacts as sc, SuperviseRegistryTable as sd, DriveHarness as sf, DelegationStore as sg, FleetWorkspaceExecutorOptions as sh, listGraphRuns as si, WidenSpec as sl, sharedBoxRefusal as sm, boxSurfaceReader as sn, openSandboxRun as so, ContinuationPanelResult as sp, compileSearchSpec as sr, BenchmarkConfig as ss, DriverContinuationRecord as st, SupervisedPursuitResult as su, ToolOutcomeEvent as sv, RetainedInteractiveEnvironmentInput as sx, JsonRpcResponse as sy, AgentAdapter as t, LoopSandboxPlacement as tS, PairwiseVerdict as t_, ChatWorkerSeamOptions as ta, Redactor as tb, runAgentic as tc, WorkerSpawnRetryPolicy as td, naiveContinuationPrompt as tf, TraceContext as tg, DetachedSessionDelegateOptions as th, StoredGraph as ti, TrajectoryReportOptions as tl, SharedBoxPlacement as tm, HarvestSurfaceDiffsOptions as tn, OpenSandboxRunBeforeStartContext as to, PriorCoordination as tp, CompiledSearchSpec as tr, observationFromRegistry as ts, ProviderModelExecutionEvidence as tt, VersionJudge as tu, AwaitWakeInput as tv, WorkerProgress as tx, claimsAuthority as ty, AgentTaskSpec as u, OutputAdapter as uS, AnytimeReport as u_, defaultProfileRichnessThresholds as ua, ValidationError as ub, adaptiveRefine as uc, SeatSelectionInput as ud, ResolveDriveHarness as uf, CoderOutput as ug, createSiblingSandboxExecutor as uh, pickBestGraph as ui, DefinePersonaInput as ul, AgentEnvironmentProviderRegistry as um, AnalystAuthoring as un, createSandboxLineage as uo, PanelFinding as up, settledToIteration as ur, BenchmarkStrategySummary as us, BlockedToolReport as ut, PursuitFork as uu, GateDecision as uv, StartRetainedInteractiveRunOptions as ux, McpTransport as uy, RunAgentTaskStreamOptions as v, RuntimeRunHandle as vS, WaterfallCollector as v_, CheckSourceCtx as va, ExecutorExecutionBinding as vb, HarvestError as vc, createFileRunContext as vd, ManagerWakePolicy as vf, verdictFromJudgeScore as vg, DelegationResumeTick as vh, freeSlots as vi, ShapeBudget as vl, ProviderPlacement as vm, createWorktreeCliExecutor as vn, startRetainedRun as vo, SpawnResourceBytes as vp, legacySupervisorRunDir as vr, SuperviseDispatchOptions as vs, SettledWorker as vt, PursuitNodeUsage as vu, EscalateQuestion as vv, captureHarnessTranscript as vx, defaultToolDetectors as vy, RuntimeFailureCode as w, NativeContextContinuationExecution as wS, SandboxEvidenceContext as w_, VisibleCheck as wa, ProfileMaterializationReceipt as wb, ObservationError as wc, SupervisorSpanRecorder as wd, StopDecision as wf, deterministicCompletion as wg, DelegateCodeArgs as wh, graphDesignerExtraTools as wi, LeaderboardBenchScore as wl, envKeyProvider as wm, EVIDENCE_MAX_CHARS as wn, startRetainedInteractiveRun as wo, McpServerOptions as wp, supervisorRunsRoot as wr, TERMINAL_DECISIONS as ws, WorkerSpawnContext as wt, FileObserverJournal as wu, QuestionLevel as wv, RetainedHarnessTranscriptCapture as wx, AnalystRegistry$1 as wy, RuntimeSessionStore as x, RuntimeRunRow as xS, createWaterfallCollector as x_, StructuralRolloutMessage as xa, MaterializedExecutionIdentity as xb, harvestCorpus as xc, SupervisorSpanAttributes as xd, NoProgressForOptions as xf, CompletionPolicy as xg, DelegationTaskQueueOptions as xh, DesignerRunGraphEnv as xi, ProviderAsSandboxClientOptions as xl, BridgeSeam as xm, WorkerInteractiveProviderSource as xn, claimRetainedInteractiveControl as xo, environmentReader as xp, readWorkerSteerRequests as xr, loopDispatch as xs, SpawnRefusal as xt, PursuitRunTotals as xu, QuestionEscalationOutcome as xv, HarnessTranscriptMetadata as xx, AnalystFindingEvent as xy, RuntimeCanonicalStreamEvent as y, RuntimeRunOptions as yS, WaterfallReport as y_, RepairStop as ya, ExecutorMaterialization as yb, HarvestFailure as yc, createInMemoryRunContext as yd, SupervisorProfile as yf, CompletionAnalyst as yg, DelegationRunContext as yh, queueOf as yi, ShapeContext as yl, BridgeHarnessStore as ym, AttachWorkerOptions as yn, startRetainedRunInEnvironment as yo, SpawnResourceRead as yp, readWorkerCancellation as yr, SuperviseOptionsForDispatch as ys, SpawnPreflight as yt, PursuitProjection as yu, Question as yv, harnessTranscriptArtifact as yx, watchTrace as yy, SpendGap as z, RetainedRunDispatchedAdmission as zS, RuntimeStreamEventSink as z_, AgentTurnInput$1 as za, WorkerInteractiveUnavailableReason as zb, FanoutSynthesis as zc, createBudgetPool as zd, DeliveredOutput as zf, decodeHarnessUsage as zg, FeedbackRating as zh, Supervisor as zi, declaredCheckDeliverable as zl, RouterResponseReceipt as zm, WorkspaceCommit as zn, InMemoryCorpus as zo, RouterToolsSeam as zp, bestProfileFor as zr, connectStdioMcp as zs, CheckpointRequest as zt, TraversalContinuity as zu, MapItemFailurePolicy as zv, TokenUsageProvenance as zx, openSqlRunStore as zy };
19498
+ //# sourceMappingURL=types-CaOXqRTq.d.ts.map