@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.
- package/dist/{activation-CsbNax2X.d.ts → activation-CJIIl_Ey.d.ts} +4 -24
- package/dist/{activation-kbkAuSmY.js → activation-CVSFxis9.js} +5 -18
- package/dist/{activation-kbkAuSmY.js.map → activation-CVSFxis9.js.map} +1 -1
- package/dist/agent.d.ts +4 -4
- package/dist/agent.js +3 -3
- package/dist/{bundle-DM60AI2B.js → bundle-DVOhBTic.js} +2 -2
- package/dist/{bundle-DM60AI2B.js.map → bundle-DVOhBTic.js.map} +1 -1
- package/dist/candidate-execution/index.d.ts +4 -63
- package/dist/candidate-execution/index.js +6 -145
- package/dist/candidate-execution/index.js.map +1 -1
- package/dist/{delegate-Se1YZKMb.js → delegate-CCWE_AkU.js} +2 -2
- package/dist/{delegate-Se1YZKMb.js.map → delegate-CCWE_AkU.js.map} +1 -1
- package/dist/{driver-control-acknowledgers-T2a1Ouay.js → driver-control-acknowledgers-C53ggdJ6.js} +12 -8
- package/dist/driver-control-acknowledgers-C53ggdJ6.js.map +1 -0
- package/dist/{durable-file-B_eJr6Mb.js → durable-file-gNI9ILAn.js} +1 -3
- package/dist/durable-file-gNI9ILAn.js.map +1 -0
- package/dist/durable.d.ts +3 -35
- package/dist/durable.js +10 -10
- package/dist/durable.js.map +1 -1
- package/dist/{graph-CY0wH838.js → graph-CI9JXKqO.js} +4 -4
- package/dist/graph-CI9JXKqO.js.map +1 -0
- package/dist/{graph-registry-By0tUj4S.js → graph-registry-BnO64cn8.js} +3 -3
- package/dist/{graph-registry-By0tUj4S.js.map → graph-registry-BnO64cn8.js.map} +1 -1
- package/dist/{improve-CWGBT13K.js → improve-BOXTLWJ3.js} +8 -35
- package/dist/improve-BOXTLWJ3.js.map +1 -0
- package/dist/{improvement-adapter-D5gwwoXQ.d.ts → improvement-adapter-HUt_-cWA.d.ts} +2 -20
- package/dist/index.d.ts +9 -206
- package/dist/index.js +91 -302
- package/dist/index.js.map +1 -1
- package/dist/intelligence.d.ts +10 -142
- package/dist/intelligence.js +7 -81
- package/dist/intelligence.js.map +1 -1
- package/dist/{jsonl-file-DBv31uPi.js → jsonl-file-C9Kde_0Z.js} +2 -2
- package/dist/{jsonl-file-DBv31uPi.js.map → jsonl-file-C9Kde_0Z.js.map} +1 -1
- package/dist/kernel.d.ts +4 -3
- package/dist/kernel.js +12 -14
- package/dist/loop-runner-CWzG1bH4.d.ts +32 -0
- package/dist/loop-runner-bin.d.ts +32 -2
- package/dist/loop-runner-bin.js +93 -1
- package/dist/loop-runner-bin.js.map +1 -0
- package/dist/loop-runner-pmPIHFVY.js +59 -0
- package/dist/loop-runner-pmPIHFVY.js.map +1 -0
- package/dist/mcp/bin.js +3 -3
- package/dist/mcp/index.d.ts +99 -418
- package/dist/mcp/index.js +121 -203
- package/dist/mcp/index.js.map +1 -1
- package/dist/mcp/memory-bin.js +231 -1
- package/dist/mcp/memory-bin.js.map +1 -1
- package/dist/model-policy-CyCUwHed.js.map +1 -1
- package/dist/placement.d.ts +2 -9
- package/dist/placement.js +1 -1
- package/dist/placement.js.map +1 -1
- package/dist/platform.d.ts +188 -1
- package/dist/platform.js +129 -1
- package/dist/platform.js.map +1 -1
- package/dist/{prepare-Bt0IouPq.js → prepare-bXkvPMJA.js} +8 -160
- package/dist/prepare-bXkvPMJA.js.map +1 -0
- package/dist/{profile-Do-5xO_D.js → profile-Dpei_Sq0.js} +2 -2
- package/dist/profile-Dpei_Sq0.js.map +1 -0
- package/dist/{profile-materialization-BnoEf1co.d.ts → profile-materialization-B1wm2SPT.d.ts} +3 -5
- package/dist/profiles.d.ts +2 -2
- package/dist/profiles.js +3 -40
- package/dist/profiles.js.map +1 -1
- package/dist/{protected-model-port-DGxQ8_YM.d.ts → protected-model-port-BGgpy2r9.d.ts} +3 -29
- package/dist/protected-redaction-DFCeo4vg.js.map +1 -1
- package/dist/{provision-supervisor-0jMufp4h.js → provision-supervisor-CJ6Zz6dz.js} +6 -6
- package/dist/{provision-supervisor-0jMufp4h.js.map → provision-supervisor-CJ6Zz6dz.js.map} +1 -1
- package/dist/{run-cancellation-BoW5Sg9Y.js → run-cancellation-C9oL62sW.js} +3 -7
- package/dist/{run-cancellation-BoW5Sg9Y.js.map → run-cancellation-C9oL62sW.js.map} +1 -1
- package/dist/{runtime-D37zRSs7.js → runtime-B2fjL9Oi.js} +2531 -2889
- package/dist/runtime-B2fjL9Oi.js.map +1 -0
- package/dist/{runtime-hooks-Bj6wJHlH.d.ts → runtime-hooks-nsqxSUFL.d.ts} +2 -6
- package/dist/{sandbox-profile-compat-xSoVtdWw.js → sandbox-profile-compat-BzVBFqrz.js} +2 -4
- package/dist/sandbox-profile-compat-BzVBFqrz.js.map +1 -0
- package/dist/{search-executor-DmgUm5p7.js → search-executor-zMumiak_.js} +3 -3
- package/dist/search-executor-zMumiak_.js.map +1 -0
- package/dist/{server-DQHJszfk.js → server-_4voDNrl.js} +362 -67
- package/dist/server-_4voDNrl.js.map +1 -0
- package/dist/{structural-rollout-DAvIE8mw.js → structural-rollout-DpLCXzaL.js} +80 -80
- package/dist/structural-rollout-DpLCXzaL.js.map +1 -0
- package/dist/{substrate-B0TYNrXn.js → substrate-CGDFTSRh.js} +2 -9
- package/dist/substrate-CGDFTSRh.js.map +1 -0
- package/dist/{supervise-WuPAwfPh.js → supervise-qAwXmPtD.js} +10 -57
- package/dist/supervise-qAwXmPtD.js.map +1 -0
- package/dist/{supervisor-CPG1I9UN.js → supervisor-DHrUJhEZ.js} +179 -236
- package/dist/supervisor-DHrUJhEZ.js.map +1 -0
- package/dist/testing.d.ts +2 -2
- package/dist/testing.js +13 -13
- package/dist/testing.js.map +1 -1
- package/dist/tool-loop.d.ts +1 -1
- package/dist/{tool-server-Dqer2M4_.js → tool-server-XV4aJwoQ.js} +2 -2
- package/dist/tool-server-XV4aJwoQ.js.map +1 -0
- package/dist/top-snapshot-CbZE1JsU.js +502 -0
- package/dist/top-snapshot-CbZE1JsU.js.map +1 -0
- package/dist/tui/bin.js +711 -1
- package/dist/tui/bin.js.map +1 -1
- package/dist/tui/index.d.ts +2 -70
- package/dist/tui/index.js +3 -3
- package/dist/{types-CrNWif8-.d.ts → types-CaOXqRTq.d.ts} +713 -2096
- package/dist/workspace-store/index.d.ts +2 -27
- package/dist/workspace-store/index.js +2 -2
- package/dist/workspace-store/index.js.map +1 -1
- package/dist/{workspace-streams-BZZds1Fw.d.ts → workspace-streams-BiS4ABah.d.ts} +3 -18
- package/package.json +1 -1
- package/skills/agent-graphs/references/authoring.md +3 -2
- package/dist/coder-yhVWbdWc.js +0 -40
- package/dist/coder-yhVWbdWc.js.map +0 -1
- package/dist/delegation-status-CF4D0NZ_.js +0 -358
- package/dist/delegation-status-CF4D0NZ_.js.map +0 -1
- package/dist/driver-control-acknowledgers-T2a1Ouay.js.map +0 -1
- package/dist/durable-file-B_eJr6Mb.js.map +0 -1
- package/dist/graph-CY0wH838.js.map +0 -1
- package/dist/improve-CWGBT13K.js.map +0 -1
- package/dist/integrations-6xttbPi9.d.ts +0 -190
- package/dist/integrations-dFi-ALk7.js +0 -132
- package/dist/integrations-dFi-ALk7.js.map +0 -1
- package/dist/kb-gate-C8z2juK8.d.ts +0 -80
- package/dist/kb-gate-DpaSwXVx.js +0 -80
- package/dist/kb-gate-DpaSwXVx.js.map +0 -1
- package/dist/loop-runner-bin-CFnrAHpl.d.ts +0 -164
- package/dist/loop-runner-bin-CdPlhy9g.js +0 -246
- package/dist/loop-runner-bin-CdPlhy9g.js.map +0 -1
- package/dist/memory-server-DXQ8IxGR.js +0 -234
- package/dist/memory-server-DXQ8IxGR.js.map +0 -1
- package/dist/openai-tools-DoQ32vpe.js +0 -44
- package/dist/openai-tools-DoQ32vpe.js.map +0 -1
- package/dist/openai-tools-zh2I_uD7.d.ts +0 -24
- package/dist/prepare-Bt0IouPq.js.map +0 -1
- package/dist/profile-Do-5xO_D.js.map +0 -1
- package/dist/runtime-D37zRSs7.js.map +0 -1
- package/dist/sandbox-profile-compat-xSoVtdWw.js.map +0 -1
- package/dist/search-executor-DmgUm5p7.js.map +0 -1
- package/dist/server-DQHJszfk.js.map +0 -1
- package/dist/structural-rollout-DAvIE8mw.js.map +0 -1
- package/dist/substrate-B0TYNrXn.js.map +0 -1
- package/dist/supervise-WuPAwfPh.js.map +0 -1
- package/dist/supervisor-CPG1I9UN.js.map +0 -1
- package/dist/tool-server-Dqer2M4_.js.map +0 -1
- package/dist/top-app-C55Wa7uy.js +0 -1214
- 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-
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
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,
|
|
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,
|
|
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,
|
|
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
|
|
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
|
-
*
|
|
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
|
|
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
|
|
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
|
|
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
|
-
*
|
|
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/
|
|
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
|
-
*
|
|
10259
|
-
*
|
|
10260
|
-
*
|
|
10261
|
-
*
|
|
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
|
|
10264
|
-
|
|
10265
|
-
|
|
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
|
|
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
|
|
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 } }`
|
|
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
|
|
11938
|
-
*
|
|
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
|
-
*
|
|
15199
|
-
|
|
15200
|
-
|
|
15201
|
-
|
|
15202
|
-
|
|
15203
|
-
|
|
15204
|
-
*
|
|
15205
|
-
*
|
|
15206
|
-
*
|
|
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
|
|
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
|
-
*
|
|
15797
|
-
*
|
|
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
|
|
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-
|
|
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
|