@tangle-network/agent-runtime 0.338.0 → 0.340.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-kbkAuSmY.js → activation-D2PVljaw.js} +5 -18
- package/dist/{activation-kbkAuSmY.js.map → activation-D2PVljaw.js.map} +1 -1
- package/dist/{activation-CsbNax2X.d.ts → activation-DGDl4wwI.d.ts} +4 -24
- package/dist/agent.d.ts +4 -18
- package/dist/agent.js +3 -21
- package/dist/agent.js.map +1 -1
- package/dist/analyst-loop.d.ts +2 -2
- package/dist/{bundle-DM60AI2B.js → bundle-DNUq-OPW.js} +2 -2
- package/dist/{bundle-DM60AI2B.js.map → bundle-DNUq-OPW.js.map} +1 -1
- package/dist/candidate-execution/index.d.ts +4 -101
- package/dist/candidate-execution/index.js +10 -395
- package/dist/candidate-execution/index.js.map +1 -1
- package/dist/{delegate-Se1YZKMb.js → delegate-CtJIS-tp.js} +2 -2
- package/dist/{delegate-Se1YZKMb.js.map → delegate-CtJIS-tp.js.map} +1 -1
- package/dist/{driver-control-acknowledgers-T2a1Ouay.js → driver-control-acknowledgers-MTrs8HAF.js} +15 -11
- package/dist/driver-control-acknowledgers-MTrs8HAF.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-DfWqp_1e.js} +4 -4
- package/dist/graph-DfWqp_1e.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-CKRVQqzt.js} +8 -35
- package/dist/improve-CKRVQqzt.js.map +1 -0
- package/dist/{improvement-adapter-D5gwwoXQ.d.ts → improvement-adapter-sIthWkcN.d.ts} +3 -21
- package/dist/index.d.ts +10 -215
- package/dist/index.js +91 -302
- package/dist/index.js.map +1 -1
- package/dist/intelligence.d.ts +11 -143
- 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-C4EWEcXf.d.ts +32 -0
- package/dist/loop-runner-DNWbTcVm.js +59 -0
- package/dist/loop-runner-DNWbTcVm.js.map +1 -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/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 -33
- package/dist/placement.js +1 -35
- 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-FzJoS68l.js} +8 -160
- package/dist/prepare-FzJoS68l.js.map +1 -0
- package/dist/{profile-Do-5xO_D.js → profile-DToH0XEs.js} +2 -2
- package/dist/profile-DToH0XEs.js.map +1 -0
- package/dist/profile-materialization-bPm0gGLO.d.ts +49 -0
- 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-DVVh-hEk.d.ts} +3 -33
- package/dist/protected-redaction-DFCeo4vg.js.map +1 -1
- package/dist/{provision-supervisor-0jMufp4h.js → provision-supervisor-DqvWXmAE.js} +6 -6
- package/dist/{provision-supervisor-0jMufp4h.js.map → provision-supervisor-DqvWXmAE.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-C55Zgo1R.js} +2531 -2889
- package/dist/runtime-C55Zgo1R.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-DRr3JwDx.js} +2 -4
- package/dist/sandbox-profile-compat-DRr3JwDx.js.map +1 -0
- package/dist/{search-executor-DmgUm5p7.js → search-executor-ChOlRBgg.js} +3 -3
- package/dist/search-executor-ChOlRBgg.js.map +1 -0
- package/dist/{server-DQHJszfk.js → server-DkVBSN_S.js} +362 -67
- package/dist/server-DkVBSN_S.js.map +1 -0
- package/dist/{structural-rollout-DAvIE8mw.js → structural-rollout-C1LEk_zq.js} +80 -80
- package/dist/structural-rollout-C1LEk_zq.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-CaUAxZZP.js} +92 -75
- package/dist/supervise-CaUAxZZP.js.map +1 -0
- package/dist/{supervisor-CPG1I9UN.js → supervisor-VXuN2OHT.js} +205 -319
- package/dist/supervisor-VXuN2OHT.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-zWfqDjeL.d.ts → types-Cwrea-bU.d.ts} +2 -17
- package/dist/{types-CrNWif8-.d.ts → types-DZ6L0Bv3.d.ts} +765 -2152
- package/dist/workspace-store/index.d.ts +1 -107
- package/dist/workspace-store/index.js +1 -415
- 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/profile-materialization-BnoEf1co.d.ts +0 -96
- 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 {
|
|
4
|
-
import { n as AnalystRegistryLike } from "./types-
|
|
5
|
-
import { AgentCandidateArtifactRef, AgentCandidateWorkspaceManifestMaterial, AgentCandidateWorkspaceSnapshotEvidence, AgentExactRunControlRef, AgentInteractiveSession, AgentInteractiveSessionControlClaim, AgentInteractiveSessionPromptAcknowledgement, AgentInteractiveSessionPromptCommand, AgentInteractiveSessionRef, AgentInteractiveSessionStart,
|
|
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-bPm0gGLO.js";
|
|
4
|
+
import { n as AnalystRegistryLike } from "./types-Cwrea-bU.js";
|
|
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 */
|
|
@@ -1891,9 +1891,6 @@ interface TraceSource {
|
|
|
1891
1891
|
/** The full set of tool spans for the run (SETTLE / batch). Always available. */
|
|
1892
1892
|
collect(): Promise<ToolSpan[]>;
|
|
1893
1893
|
}
|
|
1894
|
-
/** Decode a part with a specific harness's adapter when known, else try every registered adapter
|
|
1895
|
-
* (the composite — robust to mixed/unknown streams). Never throws. */
|
|
1896
|
-
declare function decodeToolPart(part: unknown, harness?: HarnessType): ToolStepInput | undefined;
|
|
1897
1894
|
/** A push source for OWNED tool loops (router-tools / cli-bridge tool dispatch): the loop calls
|
|
1898
1895
|
* `record(step)` for each tool call; it becomes a span, fan-out to live subscribers + buffered for
|
|
1899
1896
|
* `collect`. */
|
|
@@ -1909,23 +1906,6 @@ declare function createPushTraceSource(opts?: {
|
|
|
1909
1906
|
interface SessionMessageLike {
|
|
1910
1907
|
readonly parts?: ReadonlyArray<unknown>;
|
|
1911
1908
|
}
|
|
1912
|
-
/** The minimal box surface this needs: list a session's messages (incl. mid-turn partials). */
|
|
1913
|
-
interface SessionTraceBox {
|
|
1914
|
-
messages(opts: {
|
|
1915
|
-
sessionId: string;
|
|
1916
|
-
}): Promise<ReadonlyArray<SessionMessageLike>>;
|
|
1917
|
-
}
|
|
1918
|
-
/** The SANDBOX / fleet trace source: read a box session's message parts and decode the harness's tool
|
|
1919
|
-
* calls into spans. `collect` (settle) is the solid path — `box.messages({sessionId})` → parts → spans;
|
|
1920
|
-
* black-box harnesses aren't mid-step interruptible, so online steering is the owned-loop's job and a
|
|
1921
|
-
* live `subscribe` is opt-in (pass `subscribeParts` from `streamPrompt` when the harness streams parts). */
|
|
1922
|
-
declare function sandboxSessionTraceSource(box: SessionTraceBox, sessionId: string, opts?: {
|
|
1923
|
-
/** The box's harness (e.g. 'opencode', 'claude-code') → selects its decoder adapter. */
|
|
1924
|
-
harness?: HarnessType;
|
|
1925
|
-
subscribeParts?: (onPart: (part: unknown) => void) => () => void;
|
|
1926
|
-
runId?: string;
|
|
1927
|
-
now?: () => number;
|
|
1928
|
-
}): TraceSource;
|
|
1929
1909
|
//#endregion
|
|
1930
1910
|
//#region src/runtime/supervise/contracts/executor-port.d.ts
|
|
1931
1911
|
/**
|
|
@@ -2545,108 +2525,6 @@ declare class BackendTransportError extends AgentEvalError {
|
|
|
2545
2525
|
providerDispatch?: 'not_started';
|
|
2546
2526
|
});
|
|
2547
2527
|
}
|
|
2548
|
-
/**
|
|
2549
|
-
*
|
|
2550
|
-
* A runtime-run lifecycle method was called in an order the state machine does
|
|
2551
|
-
* not allow: `persist()` before `complete()`, `complete()` twice, etc.
|
|
2552
|
-
*
|
|
2553
|
-
* @stable
|
|
2554
|
-
*/
|
|
2555
|
-
declare class RuntimeRunStateError extends AgentEvalError {
|
|
2556
|
-
constructor(message: string, options?: {
|
|
2557
|
-
cause?: unknown;
|
|
2558
|
-
});
|
|
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
2528
|
//#endregion
|
|
2651
2529
|
//#region src/redact.d.ts
|
|
2652
2530
|
/**
|
|
@@ -2671,13 +2549,6 @@ type Redactor = (value: unknown) => unknown;
|
|
|
2671
2549
|
* on customer input and never mutates it.
|
|
2672
2550
|
*/
|
|
2673
2551
|
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
2552
|
//#endregion
|
|
2682
2553
|
//#region src/durable/content-address.d.ts
|
|
2683
2554
|
/** Stable content address shared by result and trace artifacts. */
|
|
@@ -2863,27 +2734,6 @@ interface SqlAdapter {
|
|
|
2863
2734
|
/** Execute a read statement (SELECT). Returns rows as plain objects. */
|
|
2864
2735
|
query<TRow = Record<string, unknown>>(sql: string, params?: readonly unknown[]): Promise<TRow[]>;
|
|
2865
2736
|
}
|
|
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
2737
|
//#endregion
|
|
2888
2738
|
//#region src/durable/sql-run-store.d.ts
|
|
2889
2739
|
/** @internal The SQL run context owns the payload schema; this store owns publication. */
|
|
@@ -2923,6 +2773,184 @@ declare function openSqlRunStore<Payload>(db: SqlAdapter, runId: string, options
|
|
|
2923
2773
|
acquire(signal?: AbortSignal): Promise<SqlRunLease<Payload>>;
|
|
2924
2774
|
}>;
|
|
2925
2775
|
//#endregion
|
|
2776
|
+
//#region src/mcp/codex-execution-policy.d.ts
|
|
2777
|
+
/** Isolation settings asserted before a reproducible Codex run is allowed to start. */
|
|
2778
|
+
interface CodexExecutionPolicy {
|
|
2779
|
+
sessionPersistence: 'ephemeral';
|
|
2780
|
+
userConfig: false;
|
|
2781
|
+
rules: false;
|
|
2782
|
+
projectInstructions: false;
|
|
2783
|
+
skillInstructions: false;
|
|
2784
|
+
appInstructions: false;
|
|
2785
|
+
toolSuggestions: false;
|
|
2786
|
+
multiAgentInstructions: false;
|
|
2787
|
+
sandbox: 'workspace-write';
|
|
2788
|
+
permissionProfile: 'agent_runtime_reproducible';
|
|
2789
|
+
approvalPolicy: 'never';
|
|
2790
|
+
shellNetwork: false;
|
|
2791
|
+
webSearch: false;
|
|
2792
|
+
serviceTier: 'default';
|
|
2793
|
+
shellEnvironment: 'core-filtered';
|
|
2794
|
+
loginShell: false;
|
|
2795
|
+
credentialsReadable: false;
|
|
2796
|
+
hostHomeReadable: false;
|
|
2797
|
+
procEnvironment: 'private-sanitized';
|
|
2798
|
+
sensitiveEnvironmentNamesVisible: false;
|
|
2799
|
+
parentRepoRead: false;
|
|
2800
|
+
gitMetadata: false;
|
|
2801
|
+
temporaryDirectory: 'workspace-private';
|
|
2802
|
+
stagedExecutable: 'static-elf-read-only';
|
|
2803
|
+
callerReadDeniedPaths: 'enforced';
|
|
2804
|
+
containerSockets: false;
|
|
2805
|
+
}
|
|
2806
|
+
//#endregion
|
|
2807
|
+
//#region src/mcp/codex-token-usage.d.ts
|
|
2808
|
+
/**
|
|
2809
|
+
* Exact aggregate usage emitted by Codex's terminal `turn.completed` JSONL event.
|
|
2810
|
+
*
|
|
2811
|
+
* `cachedInputTokens` is a part of `inputTokens` and `reasoningOutputTokens` is a part of
|
|
2812
|
+
* `outputTokens`; neither adds to the total it describes. `cacheWriteInputTokens` is optional
|
|
2813
|
+
* because the codex CLI reports it and a provider-normalized capture omits it, and an absent
|
|
2814
|
+
* counter must stay absent rather than become a zero that claims no cache write was measured.
|
|
2815
|
+
*/
|
|
2816
|
+
interface CodexTokenUsage {
|
|
2817
|
+
inputTokens: number;
|
|
2818
|
+
cachedInputTokens: number;
|
|
2819
|
+
outputTokens: number;
|
|
2820
|
+
reasoningOutputTokens: number;
|
|
2821
|
+
cacheWriteInputTokens?: number;
|
|
2822
|
+
}
|
|
2823
|
+
//#endregion
|
|
2824
|
+
//#region src/mcp/local-harness-invocation.d.ts
|
|
2825
|
+
/**
|
|
2826
|
+
* Local coding harness available inside the sandbox — a narrowing of the shared `HarnessType`
|
|
2827
|
+
* vocabulary, NOT a private spelling of it. The harness id is `claude-code`; `claude` is the
|
|
2828
|
+
* EXECUTABLE name and lives only in the `command` field below. Keeping one vocabulary is what
|
|
2829
|
+
* lets a `LocalHarness` be handed straight to the profile materializer and the capability table
|
|
2830
|
+
* with no translation step.
|
|
2831
|
+
*/
|
|
2832
|
+
type LocalHarness = Extract<HarnessType, 'claude-code' | 'codex' | 'opencode' | 'pi'>;
|
|
2833
|
+
/** Every local harness, in table order — the one list `AGENT_RUNTIME_LOCAL_HARNESSES` and any
|
|
2834
|
+
* other harness enumeration reads, so adding a row above is the only edit a new harness needs. */
|
|
2835
|
+
declare const LOCAL_HARNESSES: ReadonlyArray<LocalHarness>;
|
|
2836
|
+
//#endregion
|
|
2837
|
+
//#region src/mcp/local-harness-process.d.ts
|
|
2838
|
+
/** @experimental */
|
|
2839
|
+
interface RunLocalHarnessOptions {
|
|
2840
|
+
harness: LocalHarness;
|
|
2841
|
+
/** Working directory for the subprocess (typically a worktree path). */
|
|
2842
|
+
cwd: string;
|
|
2843
|
+
/** Prompt forwarded as the harness CLI's task argument. */
|
|
2844
|
+
taskPrompt: string;
|
|
2845
|
+
/**
|
|
2846
|
+
* Pre-built command + args (e.g. from `harnessInvocation` so the full authored
|
|
2847
|
+
* `AgentProfile` — systemPrompt + model — reaches the harness). When set it OVERRIDES the
|
|
2848
|
+
* default prompt-only `buildArgs(taskPrompt)` path; `command` defaults to the harness's
|
|
2849
|
+
* default binary when only `args` is supplied. When absent the legacy prompt-only shape
|
|
2850
|
+
* is used unchanged.
|
|
2851
|
+
*/
|
|
2852
|
+
invocation?: {
|
|
2853
|
+
command?: string;
|
|
2854
|
+
args: ReadonlyArray<string>;
|
|
2855
|
+
};
|
|
2856
|
+
/** Allow autonomous edits without an interactive approval gate, using whichever bypass argv the
|
|
2857
|
+
* harness declares. Use only when `cwd` is an isolated candidate worktree. */
|
|
2858
|
+
dangerouslySkipPermissions?: boolean;
|
|
2859
|
+
/** Isolate Codex from ambient configuration/instructions and require JSONL token usage.
|
|
2860
|
+
* The invocation should come from `harnessInvocation(..., { codexReproducible: true })`. */
|
|
2861
|
+
codexReproducible?: boolean;
|
|
2862
|
+
/** Absolute host paths that reproducible Codex must not read. The normalized set is compiled
|
|
2863
|
+
* into the controlled permission profile and its digest is returned in execution evidence. */
|
|
2864
|
+
codexReadDeniedPaths?: ReadonlyArray<string>;
|
|
2865
|
+
/** Optional wall-clock kill deadline (ms). Omit it for no timer. A positive value sends
|
|
2866
|
+
* SIGTERM on expiry. */
|
|
2867
|
+
timeoutMs?: number;
|
|
2868
|
+
/** Newest stdout/stderr bytes retained per stream. Default 64 MiB. */
|
|
2869
|
+
maxOutputBytes?: number;
|
|
2870
|
+
/** Caller cancellation. SIGTERM is sent on abort. */
|
|
2871
|
+
signal?: AbortSignal;
|
|
2872
|
+
/** Override env (defaults to inheriting from the parent). */
|
|
2873
|
+
env?: NodeJS.ProcessEnv;
|
|
2874
|
+
/**
|
|
2875
|
+
* Test seam — inject a custom spawner so unit tests can mock the
|
|
2876
|
+
* subprocess without touching the OS. Defaults to node's `child_process.spawn`.
|
|
2877
|
+
*/
|
|
2878
|
+
spawn?: (command: string, args: ReadonlyArray<string>, opts: {
|
|
2879
|
+
cwd: string;
|
|
2880
|
+
env: NodeJS.ProcessEnv;
|
|
2881
|
+
stdio: 'pipe';
|
|
2882
|
+
detached: boolean;
|
|
2883
|
+
}) => ChildProcess;
|
|
2884
|
+
/** Test seam for locating the native Codex executable before it is staged in the worktree. */
|
|
2885
|
+
resolveCodexExecutable?: (command: string, env: NodeJS.ProcessEnv) => Promise<string>;
|
|
2886
|
+
}
|
|
2887
|
+
/** @experimental */
|
|
2888
|
+
interface LocalHarnessResult {
|
|
2889
|
+
/** OS exit code. `null` when killed before exit. */
|
|
2890
|
+
exitCode: number | null;
|
|
2891
|
+
/** Concatenated stdout. */
|
|
2892
|
+
stdout: string;
|
|
2893
|
+
/** Concatenated stderr. */
|
|
2894
|
+
stderr: string;
|
|
2895
|
+
/** Set when the process exited via signal (timeout / abort). */
|
|
2896
|
+
killedBySignal: NodeJS.Signals | null;
|
|
2897
|
+
/** Wall-clock duration ms (spawn → exit). */
|
|
2898
|
+
durationMs: number;
|
|
2899
|
+
/** Set when timeoutMs elapsed before exit. */
|
|
2900
|
+
timedOut: boolean;
|
|
2901
|
+
/**
|
|
2902
|
+
* Set when the caller's AbortSignal fired before this result settled.
|
|
2903
|
+
* Optional so injected runners and stored results from older releases remain valid.
|
|
2904
|
+
*/
|
|
2905
|
+
aborted?: boolean;
|
|
2906
|
+
/** Present for a reproducible Codex run; parsed from the real terminal JSONL event. */
|
|
2907
|
+
usage?: CodexTokenUsage;
|
|
2908
|
+
/** Present for reproducible Codex runs; generated and checked before model execution. */
|
|
2909
|
+
evidence?: CodexExecutionEvidence;
|
|
2910
|
+
}
|
|
2911
|
+
/**
|
|
2912
|
+
* Spawn a local coding harness CLI as a subprocess + collect its output.
|
|
2913
|
+
*
|
|
2914
|
+
* NOT responsible for parsing the harness's output or extracting a diff —
|
|
2915
|
+
* the in-process executor's `streamPrompt` orchestrates `git diff` against
|
|
2916
|
+
* the worktree after this resolves. This function is intentionally narrow:
|
|
2917
|
+
* spawn, wait, capture, return.
|
|
2918
|
+
*
|
|
2919
|
+
* Fails loud — throws when:
|
|
2920
|
+
* - `cwd` doesn't exist (subprocess emits ENOENT; surfaced as Error)
|
|
2921
|
+
* - the harness binary is not on PATH (ENOENT)
|
|
2922
|
+
* - the caller signal was already aborted before process launch
|
|
2923
|
+
*
|
|
2924
|
+
* Does NOT throw when:
|
|
2925
|
+
* - the subprocess exits non-zero (`result.exitCode` carries the code)
|
|
2926
|
+
* - a non-reproducible subprocess is aborted / timed out (`result.aborted` /
|
|
2927
|
+
* `result.timedOut` carries the reason even when a TERM-aware child exits zero)
|
|
2928
|
+
*
|
|
2929
|
+
* Reproducible Codex additionally requires a terminal usage event. If cancellation
|
|
2930
|
+
* prevents that event, this rejects with `CodexExecutionDiagnosticError` instead of
|
|
2931
|
+
* returning an incomplete reproducibility receipt.
|
|
2932
|
+
*
|
|
2933
|
+
* @experimental
|
|
2934
|
+
*/
|
|
2935
|
+
declare function runLocalHarness(options: RunLocalHarnessOptions): Promise<LocalHarnessResult>;
|
|
2936
|
+
//#endregion
|
|
2937
|
+
//#region src/mcp/codex-execution-evidence.d.ts
|
|
2938
|
+
/** Zero-model-call evidence for the exact Codex process about to run. */
|
|
2939
|
+
interface CodexExecutionEvidence {
|
|
2940
|
+
cliVersion: string;
|
|
2941
|
+
executableSha256: string;
|
|
2942
|
+
/** SHA-256 of the exact composed prompt argument proved present in the rendered prompt. */
|
|
2943
|
+
requestedPromptSha256: string;
|
|
2944
|
+
effectivePromptSha256: string;
|
|
2945
|
+
nonPromptArgsSha256: string;
|
|
2946
|
+
controlledConfigSha256: string;
|
|
2947
|
+
/** Sorted normalized paths compiled into the permission profile. */
|
|
2948
|
+
readDeniedPaths: string[];
|
|
2949
|
+
readDeniedPathsSha256: string;
|
|
2950
|
+
readDeniedPathCount: number;
|
|
2951
|
+
policy: CodexExecutionPolicy;
|
|
2952
|
+
}
|
|
2953
|
+
//#endregion
|
|
2926
2954
|
//#region src/mcp/tools/coordination-analysts.d.ts
|
|
2927
2955
|
/**
|
|
2928
2956
|
* What one analyst lens may return.
|
|
@@ -2952,7 +2980,7 @@ interface AnalystKind {
|
|
|
2952
2980
|
declare const analystToolGroupNames: readonly ["all", "discovery", "discoveryAndRead", "discoveryAndSearch", "targeted", "singleTrace"];
|
|
2953
2981
|
type AnalystToolGroupName = (typeof analystToolGroupNames)[number];
|
|
2954
2982
|
/** Bounds on the recursive investigation a defined analyst may run. Each field is optional and is
|
|
2955
|
-
* clamped to
|
|
2983
|
+
* clamped to `ANALYST_DEFINITION_BOUNDS`; omitted fields take the engine's own default. */
|
|
2956
2984
|
interface AuthoredAnalystLimits {
|
|
2957
2985
|
readonly maxIterations?: number;
|
|
2958
2986
|
readonly maxLlmCalls?: number;
|
|
@@ -2991,35 +3019,6 @@ interface AuthoredAnalystDefinition {
|
|
|
2991
3019
|
/** Minimum distinct evidence citations per finding. Default 1. */
|
|
2992
3020
|
readonly minimumEvidenceCitations?: number;
|
|
2993
3021
|
}
|
|
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
3022
|
/** What the coordination layer records when a definition is admitted: the exact accepted bytes, the
|
|
3024
3023
|
* kind the registry returned, and a digest over the definition so a finding can be traced back to
|
|
3025
3024
|
* the words that produced it. */
|
|
@@ -3051,7 +3050,7 @@ interface AnalystRegistry$1 {
|
|
|
3051
3050
|
* run started. Present = `define_analyst` is mounted; absent = the menu is fixed (the status quo).
|
|
3052
3051
|
*
|
|
3053
3052
|
* The coordination layer validates and bounds the definition first (see
|
|
3054
|
-
*
|
|
3053
|
+
* `ANALYST_DEFINITION_BOUNDS`) and refuses a duplicate id, so an implementation receives
|
|
3055
3054
|
* only well-formed, in-bounds definitions. It returns the {@link AnalystKind} the lens is now
|
|
3056
3055
|
* reachable as; `run_analyst` must resolve that id immediately afterwards. THROWING is the
|
|
3057
3056
|
* refusal channel — an unavailable model seat, a policy that forbids authored lenses — and the
|
|
@@ -3071,15 +3070,6 @@ interface AnalystFindingEvent {
|
|
|
3071
3070
|
* digesting subscribers (the coordination-event id) never throw on analyst-shaped data. */
|
|
3072
3071
|
readonly findings?: unknown;
|
|
3073
3072
|
}
|
|
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
3073
|
/**
|
|
3084
3074
|
* One analyst-on-settle ROUTE: which lens runs (`kind`), over WHICH settled workers (`over`),
|
|
3085
3075
|
* delivered to WHOM (`to`), wrapped in WHAT standing instruction (`directive`). The generalized
|
|
@@ -3143,26 +3133,6 @@ interface AnalystAssignmentRecord {
|
|
|
3143
3133
|
readonly directive?: string;
|
|
3144
3134
|
readonly to?: string;
|
|
3145
3135
|
}
|
|
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
3136
|
//#endregion
|
|
3167
3137
|
//#region src/runtime/supervise/detector-monitor.d.ts
|
|
3168
3138
|
interface WatchTraceOptions {
|
|
@@ -3474,7 +3444,7 @@ type MapItemFailurePolicy = 'all-or-refuse' | 'settled-subset';
|
|
|
3474
3444
|
* is the item's task — at most `concurrency` at a time. Once every item settled it starts `join`
|
|
3475
3445
|
* with the ordered results. Items and the join go through the same admission a `spawn_worker` call
|
|
3476
3446
|
* takes (pre-flight, budget reservation from the conserved pool, `makeWorkerAgent`), carrying the
|
|
3477
|
-
* runtime-authored
|
|
3447
|
+
* runtime-authored `WorkerSpawnContext.map` marker, so no manager turn is spent on them.
|
|
3478
3448
|
*
|
|
3479
3449
|
* Every step publishes a `map` event. Item settlements are recorded but not queued, so the
|
|
3480
3450
|
* manager is woken by the join's settlement, or by a `map` event when the map was refused or its
|
|
@@ -3536,15 +3506,6 @@ interface MapTraversalEvent {
|
|
|
3536
3506
|
}
|
|
3537
3507
|
//#endregion
|
|
3538
3508
|
//#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
3509
|
/** How a spawn CONTINUES a node's prior work: `'fresh'` starts a brand-new session (the default,
|
|
3549
3510
|
* and the only pre-continuity behavior); `'resume'` re-attaches to the node's most recent
|
|
3550
3511
|
* SETTLED worker — a NEW live worker is spawned whose spawn context carries the prior worker's
|
|
@@ -4118,261 +4079,7 @@ interface ToolOutcomeEvent {
|
|
|
4118
4079
|
readonly elapsedMs: number;
|
|
4119
4080
|
}
|
|
4120
4081
|
//#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
4082
|
//#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
4083
|
/** Pluggable git runner (sync) — replaceable in tests. */
|
|
4377
4084
|
type GitRunner = (args: ReadonlyArray<string>, opts: {
|
|
4378
4085
|
cwd: string;
|
|
@@ -4381,16 +4088,6 @@ type GitRunner = (args: ReadonlyArray<string>, opts: {
|
|
|
4381
4088
|
stderr: string;
|
|
4382
4089
|
exitCode: number;
|
|
4383
4090
|
};
|
|
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
4091
|
//#endregion
|
|
4395
4092
|
//#region src/mcp/worktree-harness.d.ts
|
|
4396
4093
|
/** Outcome of one verification command run in the worktree (test or typecheck). */
|
|
@@ -4551,10 +4248,6 @@ interface SanitizedKnowledgeReadinessReport {
|
|
|
4551
4248
|
}
|
|
4552
4249
|
/** Strip PII and large blobs from a `KnowledgeReadinessReport` for safe telemetry emission. @stable */
|
|
4553
4250
|
declare function sanitizeKnowledgeReadinessReport(report: KnowledgeReadinessReport, options?: RuntimeTelemetryOptions): SanitizedKnowledgeReadinessReport;
|
|
4554
|
-
/** Reduce an `AgentRuntimeEvent` to a PII-safe, serializable plain object for telemetry. @stable */
|
|
4555
|
-
declare function sanitizeAgentRuntimeEvent<TState, TAction, TActionResult, TEval extends ControlEvalResult>(event: AgentRuntimeEvent<TState, TAction, TActionResult, TEval>, options?: RuntimeTelemetryOptions): Record<string, unknown>;
|
|
4556
|
-
/** Reduce a `RuntimeStreamEvent` to a PII-safe, serializable plain object for telemetry. @stable */
|
|
4557
|
-
declare function sanitizeRuntimeStreamEvent(event: RuntimeStreamEvent, options?: RuntimeTelemetryOptions): Record<string, unknown>;
|
|
4558
4251
|
/** @stable */
|
|
4559
4252
|
interface RuntimeEventCollector<TState = unknown, TAction = unknown, TActionResult = unknown, TEval extends ControlEvalResult = ControlEvalResult> {
|
|
4560
4253
|
onEvent: (event: AgentRuntimeEvent<TState, TAction, TActionResult, TEval>) => void;
|
|
@@ -4672,26 +4365,6 @@ interface OtelAttribute {
|
|
|
4672
4365
|
boolValue?: boolean;
|
|
4673
4366
|
};
|
|
4674
4367
|
}
|
|
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
4368
|
/**
|
|
4696
4369
|
* Create an OTLP/HTTP exporter. Returns undefined when no endpoint is configured.
|
|
4697
4370
|
*
|
|
@@ -4699,7 +4372,7 @@ declare function createOpenInferenceFileExporter(filePath: string): OtelExporter
|
|
|
4699
4372
|
* `maxQueueSize`. Every span ends in exactly one of `written` or `dropped`: a non-2xx response, a
|
|
4700
4373
|
* network error, a timeout, an OTLP `partialSuccess.rejectedSpans` count and a full queue each count
|
|
4701
4374
|
* as drops and set `lastError`. Nothing here throws into the caller's run; `flush()` reports the
|
|
4702
|
-
* loss, the same rule
|
|
4375
|
+
* loss, the same rule `createOpenInferenceFileExporter` follows.
|
|
4703
4376
|
*/
|
|
4704
4377
|
declare function createOtelExporter(config?: OtelExportConfig): OtelExporter | undefined;
|
|
4705
4378
|
/**
|
|
@@ -4711,31 +4384,6 @@ declare function loopEventToOtelSpan(event: {
|
|
|
4711
4384
|
timestamp: number;
|
|
4712
4385
|
payload: object;
|
|
4713
4386
|
}, 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
4387
|
/**
|
|
4740
4388
|
* Build a nested, real-duration OTLP span tree for ONE loop run from its full
|
|
4741
4389
|
* ordered `LoopTraceEvent` stream. Unlike `loopEventToOtelSpan` (one flat,
|
|
@@ -4758,27 +4406,6 @@ declare function buildLoopOtelSpans(events: ReadonlyArray<{
|
|
|
4758
4406
|
timestamp: number;
|
|
4759
4407
|
payload: object;
|
|
4760
4408
|
}>, 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
4409
|
/**
|
|
4783
4410
|
* Map a caller-supplied span id onto the 16-hex OTLP encoding. An id that is already a valid W3C
|
|
4784
4411
|
* span id passes through UNCHANGED — that is what lets an inherited `PARENT_SPAN_ID`/`TRACEPARENT`
|
|
@@ -4796,10 +4423,6 @@ declare function padSpanId(id: string): string;
|
|
|
4796
4423
|
* UUID-form, preserving the pre-strict-W3C wire id), everything else is derived with
|
|
4797
4424
|
* `deriveHexId(id, 16)` so every process derives the SAME wire id for the same run. */
|
|
4798
4425
|
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
4426
|
//#endregion
|
|
4804
4427
|
//#region src/runtime/sandbox-evidence-retention.d.ts
|
|
4805
4428
|
/** One durable capture before a Sandbox box is removed. */
|
|
@@ -4838,13 +4461,6 @@ interface SandboxEvidenceReceipt {
|
|
|
4838
4461
|
readonly coverageComplete: boolean;
|
|
4839
4462
|
readonly incompleteReason?: string;
|
|
4840
4463
|
}
|
|
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
4464
|
//#endregion
|
|
4849
4465
|
//#region src/runtime/agent-rounds.d.ts
|
|
4850
4466
|
/** @stable */
|
|
@@ -5232,8 +4848,6 @@ interface RunCodeModeOptions extends CodeModeOptions {
|
|
|
5232
4848
|
/** An explicit snapshot from the caller's existing state owner. */
|
|
5233
4849
|
readonly store?: CodeModeStore;
|
|
5234
4850
|
}
|
|
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
4851
|
/**
|
|
5238
4852
|
* Execute a JS async-function body against Runtime capabilities. The upstream
|
|
5239
4853
|
* QuickJS/WASM worker is the boundary; there is no node:vm or unsafe fallback.
|
|
@@ -5615,8 +5229,6 @@ interface CoderTask {
|
|
|
5615
5229
|
/** Default 400. Hard cap; the gate hard-fails when exceeded. */
|
|
5616
5230
|
maxDiffLines?: number;
|
|
5617
5231
|
}
|
|
5618
|
-
/** Render a `CoderTask` into the per-task instruction handed to the coder profile. @experimental */
|
|
5619
|
-
declare function coderTaskToPrompt(task: CoderTask): string;
|
|
5620
5232
|
//#endregion
|
|
5621
5233
|
//#region src/mcp/detached-coder.d.ts
|
|
5622
5234
|
/** @experimental The structured coder result the sandbox-session path decodes + gates. */
|
|
@@ -5664,21 +5276,6 @@ interface DelegationStore {
|
|
|
5664
5276
|
/** Delete the named records — the retention-cap eviction path. */
|
|
5665
5277
|
remove(taskIds: readonly string[]): Promise<void>;
|
|
5666
5278
|
}
|
|
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
5279
|
/**
|
|
5683
5280
|
* A delegation-store read or write failed (filesystem error, store
|
|
5684
5281
|
* called before `loadAll`, ...). Once the queue observes one, it stops
|
|
@@ -5692,14 +5289,6 @@ declare class DelegationPersistenceError extends AgentEvalError$1 {
|
|
|
5692
5289
|
cause?: unknown;
|
|
5693
5290
|
});
|
|
5694
5291
|
}
|
|
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
5292
|
/** @stable */
|
|
5704
5293
|
interface FileDelegationStoreOptions {
|
|
5705
5294
|
/** Absolute path of the JSON state file. Parent directories are created on first write. */
|
|
@@ -5763,64 +5352,11 @@ interface DelegationTraceSpan {
|
|
|
5763
5352
|
endMs: number;
|
|
5764
5353
|
meta?: Record<string, string | number | boolean>;
|
|
5765
5354
|
}
|
|
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
5355
|
/**
|
|
5785
|
-
*
|
|
5786
|
-
*
|
|
5787
|
-
*
|
|
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
|
-
/**
|
|
5820
|
-
* Fan one `LoopTraceEvent` stream into several emitters — e.g. the
|
|
5821
|
-
* process-wide OTEL exporter AND the per-delegation journal collector.
|
|
5822
|
-
* `undefined` entries are skipped; returns `undefined` when nothing is left
|
|
5823
|
-
* so callers keep the kernel's "no emitter, no events" fast path.
|
|
5356
|
+
* Fan one `LoopTraceEvent` stream into several emitters — e.g. the
|
|
5357
|
+
* process-wide OTEL exporter AND the per-delegation journal collector.
|
|
5358
|
+
* `undefined` entries are skipped; returns `undefined` when nothing is left
|
|
5359
|
+
* so callers keep the kernel's "no emitter, no events" fast path.
|
|
5824
5360
|
*
|
|
5825
5361
|
* @experimental
|
|
5826
5362
|
*/
|
|
@@ -5855,29 +5391,6 @@ declare function createPropagatingTraceEmitter(ctx: TraceContext): {
|
|
|
5855
5391
|
exporter: OtelExporter | undefined;
|
|
5856
5392
|
context: TraceContext;
|
|
5857
5393
|
};
|
|
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
5394
|
//#endregion
|
|
5882
5395
|
//#region src/profiles/researcher.d.ts
|
|
5883
5396
|
/** Source families a researcher profile may prefer for a task. One owner: the delegation
|
|
@@ -5998,51 +5511,6 @@ declare function researcherProfile(options: ResearcherProfileOptions & {
|
|
|
5998
5511
|
validator: Validator<ResearchOutput>;
|
|
5999
5512
|
agentRunSpec: AgentRunSpec<ResearchTask>;
|
|
6000
5513
|
};
|
|
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
5514
|
//#endregion
|
|
6047
5515
|
//#region src/profiles/ui-auditor/substrate.d.ts
|
|
6048
5516
|
/**
|
|
@@ -6065,8 +5533,6 @@ declare function createResearcherValidator(task: ResearchTask, config?: {
|
|
|
6065
5533
|
* under a generic label.
|
|
6066
5534
|
*/
|
|
6067
5535
|
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
5536
|
/**
|
|
6071
5537
|
* Severity scale.
|
|
6072
5538
|
* - `critical` — blocks a core task or is an accessibility blocker.
|
|
@@ -6075,8 +5541,6 @@ declare const UI_LENSES: readonly UiLens[];
|
|
|
6075
5541
|
* - `low` — nitpick worth fixing eventually.
|
|
6076
5542
|
*/
|
|
6077
5543
|
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
5544
|
/** Pointer to a screenshot referenced by a finding (workspace-relative path). */
|
|
6081
5545
|
interface UiFindingScreenshot {
|
|
6082
5546
|
path: string;
|
|
@@ -6166,12 +5630,6 @@ interface DelegateCodeArgs {
|
|
|
6166
5630
|
namespace?: string;
|
|
6167
5631
|
}
|
|
6168
5632
|
/** @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
5633
|
interface DelegateResearchConfig {
|
|
6176
5634
|
recencyWindow?: {
|
|
6177
5635
|
since?: string;
|
|
@@ -6190,11 +5648,6 @@ interface DelegateResearchArgs {
|
|
|
6190
5648
|
config?: DelegateResearchConfig;
|
|
6191
5649
|
}
|
|
6192
5650
|
/** @experimental */
|
|
6193
|
-
interface DelegateResearchResult {
|
|
6194
|
-
taskId: string;
|
|
6195
|
-
estimatedDurationMs?: number;
|
|
6196
|
-
}
|
|
6197
|
-
/** @experimental */
|
|
6198
5651
|
interface FeedbackRefersTo {
|
|
6199
5652
|
kind: 'delegation' | 'artifact' | 'outcome';
|
|
6200
5653
|
/** For `'delegation'`, this is the taskId. */
|
|
@@ -6217,22 +5670,6 @@ interface DelegateFeedbackArgs {
|
|
|
6217
5670
|
namespace?: string;
|
|
6218
5671
|
}
|
|
6219
5672
|
/** @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
5673
|
interface DelegationProgress {
|
|
6237
5674
|
iteration: number;
|
|
6238
5675
|
phase: string;
|
|
@@ -6317,11 +5754,6 @@ interface DelegateUiAuditArgs {
|
|
|
6317
5754
|
namespace?: string;
|
|
6318
5755
|
config?: DelegateUiAuditConfig;
|
|
6319
5756
|
}
|
|
6320
|
-
/** @experimental */
|
|
6321
|
-
interface DelegateUiAuditResult {
|
|
6322
|
-
taskId: string;
|
|
6323
|
-
estimatedDurationMs?: number;
|
|
6324
|
-
}
|
|
6325
5757
|
/**
|
|
6326
5758
|
* Provider-neutral research output carried over the MCP boundary. The MCP
|
|
6327
5759
|
* layer accepts this structural shape instead of coupling its wire contract to
|
|
@@ -6395,10 +5827,6 @@ interface DelegationHistoryEntry {
|
|
|
6395
5827
|
/** Inherited trace identity recorded at submit — join key into the caller's trace. */
|
|
6396
5828
|
traceId?: string;
|
|
6397
5829
|
}
|
|
6398
|
-
/** @experimental */
|
|
6399
|
-
interface DelegationHistoryResult {
|
|
6400
|
-
delegations: DelegationHistoryEntry[];
|
|
6401
|
-
}
|
|
6402
5830
|
//#endregion
|
|
6403
5831
|
//#region src/mcp/task-queue.d.ts
|
|
6404
5832
|
/** Arguments accepted by the durable delegation queue. @stable */
|
|
@@ -6675,73 +6103,8 @@ declare class DelegationTaskQueue {
|
|
|
6675
6103
|
private failPersistence;
|
|
6676
6104
|
private enforceRetention;
|
|
6677
6105
|
}
|
|
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
6106
|
//#endregion
|
|
6686
6107
|
//#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
6108
|
/** @experimental The terminal payload of a finished detached turn. */
|
|
6746
6109
|
interface DetachedTurn {
|
|
6747
6110
|
/** Final assistant text. */
|
|
@@ -6749,15 +6112,6 @@ interface DetachedTurn {
|
|
|
6749
6112
|
/** The SDK's cached AgentExecutionResult-shape record for the turn. */
|
|
6750
6113
|
result: Record<string, unknown>;
|
|
6751
6114
|
}
|
|
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
6115
|
/** @experimental */
|
|
6762
6116
|
interface RunDetachedTurnOptions {
|
|
6763
6117
|
/** Sandbox client used to acquire the box (the delegate's executor client). */
|
|
@@ -6804,55 +6158,6 @@ interface RunDetachedTurnOptions {
|
|
|
6804
6158
|
* @experimental
|
|
6805
6159
|
*/
|
|
6806
6160
|
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
6161
|
//#endregion
|
|
6857
6162
|
//#region src/mcp/executor.d.ts
|
|
6858
6163
|
/** @experimental */
|
|
@@ -7061,40 +6366,6 @@ interface DetachedSessionDelegateOptions {
|
|
|
7061
6366
|
* @experimental
|
|
7062
6367
|
*/
|
|
7063
6368
|
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
6369
|
//#endregion
|
|
7099
6370
|
//#region src/mcp/feedback-store.d.ts
|
|
7100
6371
|
/** @stable */
|
|
@@ -7119,22 +6390,6 @@ interface FeedbackStore {
|
|
|
7119
6390
|
refersToRef?: string;
|
|
7120
6391
|
}): Promise<FeedbackEvent[]>;
|
|
7121
6392
|
}
|
|
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
6393
|
//#endregion
|
|
7139
6394
|
//#region src/runtime/tool-loop.d.ts
|
|
7140
6395
|
/** Provider-neutral conversation record accepted by a tool-loop brain. */
|
|
@@ -7352,32 +6607,6 @@ interface SandboxServedBackend {
|
|
|
7352
6607
|
readonly model?: string;
|
|
7353
6608
|
readonly source?: string;
|
|
7354
6609
|
}
|
|
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
6610
|
/**
|
|
7382
6611
|
* Extract a `RuntimeStreamEvent`-shaped `llm_call` from a sandbox event when
|
|
7383
6612
|
* the event carries usage/cost data. Returns `undefined` for non-cost events
|
|
@@ -7434,9 +6663,6 @@ interface SandboxUsageLedger {
|
|
|
7434
6663
|
type: 'llm_call';
|
|
7435
6664
|
}) | undefined;
|
|
7436
6665
|
}
|
|
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
6666
|
/**
|
|
7441
6667
|
* Sum the token usage + USD cost of a sandbox turn's events — the one honest way to meter an
|
|
7442
6668
|
* `openSandboxRun` cell. Folds a {@link SandboxUsageLedger} over the stream, so it reads usage off
|
|
@@ -7548,20 +6774,6 @@ declare function mapSandboxToolEvent(event: SandboxEvent, state: SandboxToolPart
|
|
|
7548
6774
|
declare function mapSandboxEvent(event: SandboxEvent, opts?: {
|
|
7549
6775
|
agentRunName?: string;
|
|
7550
6776
|
}): 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
6777
|
/**
|
|
7566
6778
|
* What a settled turn produced, as an explicit marker.
|
|
7567
6779
|
*
|
|
@@ -7769,17 +6981,6 @@ interface BridgeModelCredential {
|
|
|
7769
6981
|
provider: KeyProvider;
|
|
7770
6982
|
}
|
|
7771
6983
|
//#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
6984
|
//#region src/runtime/provider-placement.d.ts
|
|
7784
6985
|
/** Caller-declared execution placement. Matching never changes the authored profile.
|
|
7785
6986
|
* @experimental */
|
|
@@ -7957,41 +7158,6 @@ declare const ROUTER_CLIENT_HEADER = "x-tangle-client";
|
|
|
7957
7158
|
* a new record: the row whose `clientName` is `agent-runtime-node/<nodeId>` is that node's spend.
|
|
7958
7159
|
*/
|
|
7959
7160
|
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
7161
|
/**
|
|
7996
7162
|
* Why a shared box cannot carry `profile`, or `undefined` when it can.
|
|
7997
7163
|
*
|
|
@@ -8102,20 +7268,6 @@ interface SharedBoxPlacement {
|
|
|
8102
7268
|
declare function sharedBoxPlacement(options: SharedBoxPlacementOptions): SharedBoxPlacement;
|
|
8103
7269
|
//#endregion
|
|
8104
7270
|
//#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
7271
|
/** A message from the run's AUTHORITY — the parent driver. These two kinds carry instruction. */
|
|
8120
7272
|
interface AuthorityInboxMessage {
|
|
8121
7273
|
/** The sender's `messageId`, or one minted on arrival. What {@link InboxLease.commit} names. */
|
|
@@ -8172,8 +7324,6 @@ interface Inbox {
|
|
|
8172
7324
|
/** Render taken messages as ONE operator turn to fold into the worker's conversation. */
|
|
8173
7325
|
fold(messages: ReadonlyArray<InboxMessage>): string;
|
|
8174
7326
|
}
|
|
8175
|
-
/** Create the worker-side inbox for the down-leg: the driver's `steer_agent` / `answer_question` messages and a sibling's peer mail queue here, and the worker's loop leases them at step boundaries and before settle. */
|
|
8176
|
-
declare function createInbox(): Inbox;
|
|
8177
7327
|
//#endregion
|
|
8178
7328
|
//#region src/runtime/supervise/sandbox-session.d.ts
|
|
8179
7329
|
/** Ceiling on continuation turns. Turn 0 is the task; every later turn is a folded steer, so
|
|
@@ -8526,33 +7676,6 @@ declare function createExecutor(config: ExecutorConfig): ExecutorFactory<unknown
|
|
|
8526
7676
|
declare function createExecutorRegistry(): ExecutorRegistry;
|
|
8527
7677
|
//#endregion
|
|
8528
7678
|
//#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
7679
|
/** The synchronous result the `delegate` tool returns to the calling agent: the delivered output (or
|
|
8557
7680
|
* the no-winner reason) PLUS the conserved spend of the whole delegation. */
|
|
8558
7681
|
type DelegateResult = {
|
|
@@ -8650,64 +7773,8 @@ interface McpServer {
|
|
|
8650
7773
|
* @experimental
|
|
8651
7774
|
*/
|
|
8652
7775
|
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
7776
|
//#endregion
|
|
8667
7777
|
//#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
7778
|
/** One successful read: the bytes as a string plus the identity the journal records. */
|
|
8712
7779
|
interface SpawnResourceBytes {
|
|
8713
7780
|
readonly content: string;
|
|
@@ -8729,8 +7796,6 @@ interface SpawnResourceReader {
|
|
|
8729
7796
|
readonly describe: string;
|
|
8730
7797
|
read(path: string): Promise<SpawnResourceRead>;
|
|
8731
7798
|
}
|
|
8732
|
-
/** The host-directory reader: a manager whose workspace is a directory this process can open. */
|
|
8733
|
-
declare function hostDirectoryReader(root: string): SpawnResourceReader;
|
|
8734
7799
|
/**
|
|
8735
7800
|
* The environment reader: a manager running inside a provider environment whose `read()` serves
|
|
8736
7801
|
* its own workspace. The provider owns containment — it will not serve a path outside the box —
|
|
@@ -8773,9 +7838,6 @@ type ResolveSpawnResourcePathsResult = {
|
|
|
8773
7838
|
declare function resolveSpawnResourcePaths(profile: unknown, source: string | SpawnResourceReader | undefined): Promise<ResolveSpawnResourcePathsResult>;
|
|
8774
7839
|
//#endregion
|
|
8775
7840
|
//#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
7841
|
/** Whether the run's declared completion check has passed. `'none'` means the caller declared no
|
|
8780
7842
|
* check at all — the retry then reads spend and settlements exactly as it always has. */
|
|
8781
7843
|
type DriverContractState = 'met' | 'unmet' | 'none';
|
|
@@ -8805,30 +7867,6 @@ interface DriverRetryPolicy extends UnavailablePausePolicy {
|
|
|
8805
7867
|
* Platform restart. */
|
|
8806
7868
|
readonly transientOutageMs?: number;
|
|
8807
7869
|
}
|
|
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
7870
|
/** Why the loop is entering the driver again. Absent on the first attempt only.
|
|
8833
7871
|
*
|
|
8834
7872
|
* An `unmet-contract` re-entry carries Runtime's continuation note. A `driver-failure` re-entry
|
|
@@ -8841,6 +7879,12 @@ type DriverReentry = {
|
|
|
8841
7879
|
readonly steer: string;
|
|
8842
7880
|
/** 1-based: which continuation this is. */
|
|
8843
7881
|
readonly continuation: number;
|
|
7882
|
+
/** Present when the barren streak had reached `maxBarren` and the loop paused before this
|
|
7883
|
+
* re-entry: the re-entered drives in a row that delivered nothing, and the pause. */
|
|
7884
|
+
readonly barren?: {
|
|
7885
|
+
readonly streak: number;
|
|
7886
|
+
readonly pausedMs: number;
|
|
7887
|
+
};
|
|
8844
7888
|
} | {
|
|
8845
7889
|
readonly reason: 'driver-failure';
|
|
8846
7890
|
/** The failure that ended the previous drive, as recorded. */
|
|
@@ -8877,13 +7921,6 @@ type DriverReentry = {
|
|
|
8877
7921
|
};
|
|
8878
7922
|
//#endregion
|
|
8879
7923
|
//#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
7924
|
/** One time the check ran inside the run, whatever started it. */
|
|
8888
7925
|
interface CheckRead {
|
|
8889
7926
|
/** 1-based count of check reads in this manager, the unavailable ones included. */
|
|
@@ -8904,17 +7941,20 @@ interface CheckRead {
|
|
|
8904
7941
|
*
|
|
8905
7942
|
* Required for an external manager with a check: Runtime supplies no default, because a retry
|
|
8906
7943
|
* default in source is a research decision the record must make. There is no re-prompt count.
|
|
8907
|
-
* The loop re-enters until the check passes or a bound ends it: this deadline, the budget,
|
|
8908
|
-
* `maxBarren` turns in a row without progress,
|
|
7944
|
+
* The loop re-enters until the check passes or a bound ends it: this deadline, the budget, or
|
|
7945
|
+
* cancellation. After `maxBarren` turns in a row without progress, each further continuation
|
|
7946
|
+
* waits a barren pause first (5 minutes, doubling to 60) and is journaled `barren-pause`; a
|
|
7947
|
+
* barren streak never ends the run. A tool `report_blocked` shows
|
|
8909
7948
|
* really failed is recorded and the loop goes on: a blocked tool is not a terminal condition.
|
|
8910
7949
|
* Progress means the check's best composite rose, an accepted result, or a worker that delivered.
|
|
8911
7950
|
*/
|
|
8912
7951
|
interface ContinuationPolicy {
|
|
8913
7952
|
/** No re-entry starts at or after this instant: epoch ms, or an ISO 8601 time. */
|
|
8914
7953
|
readonly deadline: number | string;
|
|
8915
|
-
/** Re-entered turns in a row that may end without progress before
|
|
8916
|
-
* The evidence for 2: repair loses most of its effect within
|
|
8917
|
-
* fresh start at the same budget scored higher (Debugging Decay
|
|
7954
|
+
/** Re-entered turns in a row that may end without progress before each further continuation
|
|
7955
|
+
* waits a barren pause. Minimum 1. The evidence for 2: repair loses most of its effect within
|
|
7956
|
+
* two or three attempts, and a fresh start at the same budget scored higher (Debugging Decay
|
|
7957
|
+
* Index). */
|
|
8918
7958
|
readonly maxBarren: number;
|
|
8919
7959
|
/** Every instruction word of the note. */
|
|
8920
7960
|
readonly profile: ContinuationProfile;
|
|
@@ -8962,7 +8002,7 @@ declare function admitContinuationPolicy(policy: ContinuationPolicy, context: st
|
|
|
8962
8002
|
/**
|
|
8963
8003
|
* Every instruction word of the note. Runtime supplies the facts and their order; this data
|
|
8964
8004
|
* 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
|
|
8005
|
+
* change. Templates may name the facts in `CONTINUATION_FACTS` as `{name}`.
|
|
8966
8006
|
*/
|
|
8967
8007
|
interface ContinuationProfile {
|
|
8968
8008
|
/** Recorded with every note, so each continuation names the words it carried. */
|
|
@@ -8994,8 +8034,6 @@ interface ContinuationProfile {
|
|
|
8994
8034
|
* chain's `'review-of-best'`. It may name `{version}`, `{path}` and `{score}`. */
|
|
8995
8035
|
readonly review?: string;
|
|
8996
8036
|
}
|
|
8997
|
-
/** The facts a profile template may name. */
|
|
8998
|
-
declare const CONTINUATION_FACTS: readonly ["composite", "threshold", "failed", "total", "reads", "owed", "settled", "delivered", "continuation"];
|
|
8999
8037
|
/** What the question panel reads for one continuation. */
|
|
9000
8038
|
interface ContinuationPanelInput {
|
|
9001
8039
|
/** 1-based continuation number. */
|
|
@@ -9058,59 +8096,6 @@ type ContinuationAppend = (context: {
|
|
|
9058
8096
|
readonly heading: string;
|
|
9059
8097
|
readonly text: string;
|
|
9060
8098
|
} | 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
8099
|
/** One continuation as the settle record carries it (`DriverContinuationRecord.continuations`). */
|
|
9115
8100
|
interface ContinuationEntry {
|
|
9116
8101
|
/** 1-based. */
|
|
@@ -9147,19 +8132,6 @@ interface VerdictSummary {
|
|
|
9147
8132
|
readonly failed?: number;
|
|
9148
8133
|
readonly total?: number;
|
|
9149
8134
|
}
|
|
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
8135
|
//#endregion
|
|
9164
8136
|
//#region src/runtime/supervise/coordination-log.d.ts
|
|
9165
8137
|
/** Stable identity of the supervisor that owns one coordination stream. High-level supervision
|
|
@@ -9450,53 +8422,10 @@ interface FinalizeContext {
|
|
|
9450
8422
|
}
|
|
9451
8423
|
/** The finalization seam: ledger in, output (or `undefined` = nothing deliverable) out. */
|
|
9452
8424
|
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
8425
|
/** Keep-best under the completion oracle — the DEFAULT finalizer and the exact behavior every
|
|
9459
8426
|
* existing caller had: the highest-scoring delivered child's output, `undefined` when nothing
|
|
9460
8427
|
* delivered (or the best delivered child carries no artifact). */
|
|
9461
8428
|
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
8429
|
//#endregion
|
|
9501
8430
|
//#region src/runtime/supervise/reentry.d.ts
|
|
9502
8431
|
/** What the next drive continues, as the drive harness can prove it before the turn starts. */
|
|
@@ -9581,10 +8510,6 @@ interface RunCancellation {
|
|
|
9581
8510
|
/** The runtime's explanation of how it arrived at `effect`. */
|
|
9582
8511
|
readonly detail?: string;
|
|
9583
8512
|
}
|
|
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
8513
|
/** Read the run-scoped cancel request, or `undefined` when none was written. */
|
|
9589
8514
|
declare function readRunCancelRequest(eventDir: string): RunCancelRequest | undefined;
|
|
9590
8515
|
/**
|
|
@@ -9619,18 +8544,6 @@ declare function cancelRun(eventDir: string, operationId: string, options?: {
|
|
|
9619
8544
|
}): RunCancellation;
|
|
9620
8545
|
//#endregion
|
|
9621
8546
|
//#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
8547
|
/** The read-model a `StopRule` decides from — the run's progress, not its budget. */
|
|
9635
8548
|
interface ProgressView {
|
|
9636
8549
|
readonly now: number;
|
|
@@ -9667,42 +8580,6 @@ type StopDecision = {
|
|
|
9667
8580
|
/** Evaluated from the progress feed, never from the budget. Pure and synchronous: it is called on
|
|
9668
8581
|
* the driver's hot path, once per turn. */
|
|
9669
8582
|
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
8583
|
interface NoProgressForOptions {
|
|
9707
8584
|
/** Stop when this many ms have passed since the last SETTLEMENT. Omit to not bound on time. */
|
|
9708
8585
|
readonly ms?: number;
|
|
@@ -9759,24 +8636,10 @@ interface AllWorkersStalledOptions {
|
|
|
9759
8636
|
declare function allWorkersStalled(opts?: AllWorkersStalledOptions): StopRule;
|
|
9760
8637
|
/** Stop when ANY rule stops — the ordinary composition (each rule is a separate reason to end). */
|
|
9761
8638
|
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
8639
|
//#endregion
|
|
9765
8640
|
//#region src/runtime/supervise/supervisor-agent-profile.d.ts
|
|
9766
8641
|
/** A supervisor is an exact canonical AgentProfile; no looser model/prompt shape exists. */
|
|
9767
8642
|
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
8643
|
//#endregion
|
|
9781
8644
|
//#region src/runtime/supervise/wake.d.ts
|
|
9782
8645
|
/** How Runtime wakes a manager that ended its turn with work open. */
|
|
@@ -9788,8 +8651,6 @@ interface ManagerWakePolicy {
|
|
|
9788
8651
|
/** Wake once this long before the deadline and ask for the best result now. Default 15 min. */
|
|
9789
8652
|
readonly deadlineWarningMs?: number;
|
|
9790
8653
|
}
|
|
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
8654
|
//#endregion
|
|
9794
8655
|
//#region src/runtime/supervise/supervisor-agent-contracts.d.ts
|
|
9795
8656
|
type CoordinationBinding = CoordinationTransportOptions;
|
|
@@ -9927,8 +8788,8 @@ interface DriveHarness {
|
|
|
9927
8788
|
};
|
|
9928
8789
|
/** Call once per model event the harness streams: text, reasoning, or a tool call or result.
|
|
9929
8790
|
* On a run this process took over after a restart, the driver counts no drive toward its
|
|
9930
|
-
*
|
|
9931
|
-
*
|
|
8791
|
+
* barren streak until the first call, so a harness that never calls it is never paused for
|
|
8792
|
+
* a barren streak on that run. */
|
|
9932
8793
|
readonly onModelEvent?: () => void;
|
|
9933
8794
|
}): Promise<void>;
|
|
9934
8795
|
/** Optional live inbox for the manager session this adapter currently drives. Return `false`
|
|
@@ -10096,7 +8957,7 @@ interface SupervisorAgentDeps {
|
|
|
10096
8957
|
readonly finalizer?: SupervisorFinalizer;
|
|
10097
8958
|
/** Where the coordination MCP binds (external arm). Omit = an ephemeral loopback port, which is
|
|
10098
8959
|
* unreachable from an off-host harness. A non-loopback host fails closed — see
|
|
10099
|
-
*
|
|
8960
|
+
* `assertCoordinationBinding`. */
|
|
10100
8961
|
readonly coordination?: CoordinationBinding;
|
|
10101
8962
|
/** OPT-IN async gate run before every spawn mints an assignment or reserves budget — the one
|
|
10102
8963
|
* pre-journal point that may ask the backend a question (does this bridge route the child's
|
|
@@ -10146,10 +9007,6 @@ interface SupervisorAgentTestDeps extends SupervisorAgentDeps {
|
|
|
10146
9007
|
readonly brain: ToolLoopChat;
|
|
10147
9008
|
}
|
|
10148
9009
|
//#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
9010
|
//#region src/runtime/supervise/supervisor-agent.d.ts
|
|
10154
9011
|
/** Build a supervisor `Agent` from its profile: the brain resolves from `profile.harness`
|
|
10155
9012
|
* (backend-as-data), the same resolution rule as every worker. */
|
|
@@ -10253,17 +9110,38 @@ declare class GraphRouteError extends Error {
|
|
|
10253
9110
|
/** Default per-edge traversal cap — the cyclic-graph backstop when an edge names none. */
|
|
10254
9111
|
declare const defaultEdgeTraversalCap = 32;
|
|
10255
9112
|
//#endregion
|
|
10256
|
-
//#region src/runtime/supervise/
|
|
9113
|
+
//#region src/runtime/supervise/root-stream.d.ts
|
|
9114
|
+
/** One line of `root-stream.jsonl`. */
|
|
9115
|
+
type RootStreamRecord = {
|
|
9116
|
+
/** 1-based position in the file, continuing across drive attempts and across processes. */
|
|
9117
|
+
readonly seq: number;
|
|
9118
|
+
/** ISO instant the line was appended, from the run's own clock. */
|
|
9119
|
+
readonly at: string;
|
|
9120
|
+
/** The 1-based drive attempt of the root that produced it: a driver retry or re-prompt
|
|
9121
|
+
* re-enters the harness and continues the same file with the next attempt number. */
|
|
9122
|
+
readonly attempt: number;
|
|
9123
|
+
} & ({
|
|
9124
|
+
readonly event: ExecutorProgressEvent;
|
|
9125
|
+
} | {
|
|
9126
|
+
/** The event could not be written as JSON; its kind and the reason stand in so the gap
|
|
9127
|
+
* is recorded in the file itself instead of silently narrowing the stream. */
|
|
9128
|
+
readonly dropped: {
|
|
9129
|
+
readonly kind: ExecutorProgressEvent['kind'];
|
|
9130
|
+
readonly reason: string;
|
|
9131
|
+
};
|
|
9132
|
+
});
|
|
10257
9133
|
/**
|
|
10258
|
-
*
|
|
10259
|
-
*
|
|
10260
|
-
*
|
|
10261
|
-
*
|
|
9134
|
+
* The receipt for the root stream a run directory holds, recomputed from the file's bytes, or
|
|
9135
|
+
* `undefined` when the directory holds none. This is what a run that never settled — a root that
|
|
9136
|
+
* died mid-turn — gets on its failure record, and it equals what `close()` returned for a run
|
|
9137
|
+
* that did.
|
|
10262
9138
|
*/
|
|
10263
|
-
declare
|
|
10264
|
-
|
|
10265
|
-
|
|
10266
|
-
|
|
9139
|
+
declare function readRootStreamReceipt(runDir: string): Promise<RootStreamReceipt | undefined>;
|
|
9140
|
+
/** Every committed line of the root stream, in order, or `undefined` when there is no file. A
|
|
9141
|
+
* torn final line from a process that died mid-write is not a record and is left out. */
|
|
9142
|
+
declare function readRootStream(runDir: string): Promise<RootStreamRecord[] | undefined>;
|
|
9143
|
+
//#endregion
|
|
9144
|
+
//#region src/runtime/supervise/budget.d.ts
|
|
10267
9145
|
/** Opaque, single-use reservation handle returned by `reserve` and consumed by
|
|
10268
9146
|
* `reconcile`. Carries the reserved ceilings so reconciliation needs no lookup. */
|
|
10269
9147
|
interface ReservationTicket {
|
|
@@ -10365,15 +9243,6 @@ interface ReserveOptions {
|
|
|
10365
9243
|
/** Leave this much of each channel free after the reservation. */
|
|
10366
9244
|
readonly keep?: ReservationFloor;
|
|
10367
9245
|
}
|
|
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
9246
|
/** Why a reservation was refused. `budget-exhausted` means the pool ran out of a channel it
|
|
10378
9247
|
* budgets; `usd-unbudgeted` means the root declared no dollar ceiling, so a dollar request is
|
|
10379
9248
|
* unsatisfiable at any amount and the fix is to budget the root, not to ask for less. */
|
|
@@ -10412,7 +9281,7 @@ interface BudgetPool {
|
|
|
10412
9281
|
*
|
|
10413
9282
|
* With `wait`, a request the free balance cannot cover now, but could once the open reservations
|
|
10414
9283
|
* return, is admitted as a WAITING ticket: `granted` resolves when the pool reserves it, and
|
|
10415
|
-
* rejects with
|
|
9284
|
+
* rejects with `ReservationWaitRefused` once nothing open could return enough. A waiting
|
|
10416
9285
|
* ticket reserves nothing; reconciling it withdraws it. While any ticket waits, a new waiting
|
|
10417
9286
|
* request queues behind it even when it would fit, so the order of asking is the order of grant.
|
|
10418
9287
|
*/
|
|
@@ -10485,7 +9354,7 @@ declare function createBudgetPool(root: Budget, runStartedAtMs: number, restore?
|
|
|
10485
9354
|
//#region src/runtime/supervise/deadline.d.ts
|
|
10486
9355
|
/**
|
|
10487
9356
|
* 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
|
|
9357
|
+
* lead's scope delivers `DEADLINE_CHECK_IN_MESSAGE` to the child's inbox and keeps it
|
|
10489
9358
|
* running; the child is stopped (reason `child deadline exceeded`) only once it then makes no
|
|
10490
9359
|
* progress for `idleMs`. The run's own deadline, the budgets and cancellation still stop it at once.
|
|
10491
9360
|
* `false` restores the hard kill at the time box. A child that exposes no inbox cannot be told,
|
|
@@ -10499,277 +9368,14 @@ declare function createBudgetPool(root: Budget, runStartedAtMs: number, restore?
|
|
|
10499
9368
|
type DeadlineCheckIn = false | {
|
|
10500
9369
|
readonly idleMs?: number;
|
|
10501
9370
|
};
|
|
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
9371
|
//#endregion
|
|
10580
9372
|
//#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
9373
|
/**
|
|
10588
9374
|
* Resolve the trace context a worker spawned BY `spawningNodeId` should inherit. `undefined` means
|
|
10589
9375
|
* this run records no spans, so nothing is stamped. Supplied by
|
|
10590
9376
|
* `SupervisorSpanRecorder.workerTrace` and threaded to the scope as `SupervisorOpts.workerTrace`.
|
|
10591
9377
|
*/
|
|
10592
9378
|
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
9379
|
//#endregion
|
|
10774
9380
|
//#region src/runtime/supervise/otel-spans.d.ts
|
|
10775
9381
|
/** OTLP span attribute values. Exported because `SupervisorSpanOptions.attributes` is public and
|
|
@@ -11107,6 +9713,55 @@ declare function retryPreSpawnRefusals<Out>(inner: Executor<Out>, policy: Resolv
|
|
|
11107
9713
|
worker?: string;
|
|
11108
9714
|
}): Executor<Out>;
|
|
11109
9715
|
//#endregion
|
|
9716
|
+
//#region src/runtime/supervise/worker-slots.d.ts
|
|
9717
|
+
/**
|
|
9718
|
+
* Worker slots: the one bound on how many spawned agents work at the same time.
|
|
9719
|
+
*
|
|
9720
|
+
* Every scope of a supervised tree draws from one allocator. A host that runs several trees in one
|
|
9721
|
+
* process can pass the same allocator to each of them, and the bound then holds across all of them.
|
|
9722
|
+
*
|
|
9723
|
+
* A spawn past the bound is never refused. It keeps its reserved budget slice and waits in a queue,
|
|
9724
|
+
* and it starts when a slot frees. The queue releases the deepest spawn first and then the oldest,
|
|
9725
|
+
* so a subtree that is already paid for finishes before the tree grows wider.
|
|
9726
|
+
*
|
|
9727
|
+
* A slot counts a working agent: a spawned agent that runs with no running child of its own. A
|
|
9728
|
+
* manager whose children are all running is waiting on them, so its first running child takes over
|
|
9729
|
+
* the manager's slot and the manager takes it back when its last running child ends. This makes
|
|
9730
|
+
* nested waits deadlock-free: a manager can always run one child on its own slot, so a queued subtree
|
|
9731
|
+
* always keeps a path to completion, whatever the bound and however deep the tree.
|
|
9732
|
+
*
|
|
9733
|
+
* The bound therefore limits working agents, not environments. The environments alive at one time
|
|
9734
|
+
* can exceed it by the number of managers that have a running child. The conserved budget pool and
|
|
9735
|
+
* the deadline bound the total work; this allocator only bounds how much of it runs at once.
|
|
9736
|
+
*
|
|
9737
|
+
* @experimental
|
|
9738
|
+
*/
|
|
9739
|
+
/** A fleet-wide bound on concurrently working agents, with a queue for the spawns past it. */
|
|
9740
|
+
interface WorkerSlots {
|
|
9741
|
+
/** The bound on working agents, or `undefined` when only the budget bounds concurrency. */
|
|
9742
|
+
readonly max: number | undefined;
|
|
9743
|
+
/** Working agents that hold a slot now. */
|
|
9744
|
+
readonly working: number;
|
|
9745
|
+
/** Spawns that hold a budget slice and wait for a slot. */
|
|
9746
|
+
readonly queued: number;
|
|
9747
|
+
}
|
|
9748
|
+
/**
|
|
9749
|
+
* One held or awaited slot. `ready` resolves when the slot is granted; `granted` reads whether it
|
|
9750
|
+
* has been. `release` returns the slot, or withdraws a request that is still queued, and is
|
|
9751
|
+
* idempotent.
|
|
9752
|
+
*/
|
|
9753
|
+
interface SlotPermit {
|
|
9754
|
+
readonly ready: Promise<void>;
|
|
9755
|
+
readonly granted: boolean;
|
|
9756
|
+
release(): void;
|
|
9757
|
+
}
|
|
9758
|
+
/**
|
|
9759
|
+
* Create a worker-slot allocator. `max` omitted, `0`, or negative leaves concurrency bounded by the
|
|
9760
|
+
* budget alone, and every spawn starts at once. Pass the returned allocator as `workerSlots` to each
|
|
9761
|
+
* run that should share one bound.
|
|
9762
|
+
*/
|
|
9763
|
+
declare function createWorkerSlots(max?: number): WorkerSlots;
|
|
9764
|
+
//#endregion
|
|
11110
9765
|
//#region src/runtime/supervise/supervise-options.d.ts
|
|
11111
9766
|
interface SuperviseOptions {
|
|
11112
9767
|
/** Whole-run persistence and ownership. SQL contexts are acquired before replay and compute. */
|
|
@@ -11329,8 +9984,9 @@ interface SuperviseOptions {
|
|
|
11329
9984
|
*
|
|
11330
9985
|
* A continuation is the retry path, not a second loop: same scope, same coordination server,
|
|
11331
9986
|
* same live children, and the same budget, deadline, and abort bounds. There is no count: the
|
|
11332
|
-
* loop ends when the check passes, at this deadline, on the budget,
|
|
11333
|
-
* a row without progress,
|
|
9987
|
+
* loop ends when the check passes, at this deadline, on the budget, or on cancellation. After
|
|
9988
|
+
* `maxBarren` turns in a row without progress, each further continuation waits a barren pause
|
|
9989
|
+
* first, journaled `barren-pause`. A turn that ends, a blocked tool, and a lost
|
|
11334
9990
|
* stream are segment boundaries, never the end of the run. Runtime writes the note from the check's verdict (`src/runtime/supervise/continuation.ts`); the
|
|
11335
9991
|
* profile owns its words, and `append` may add a section but never replace one.
|
|
11336
9992
|
*
|
|
@@ -11635,11 +10291,6 @@ interface SuperviseTestOptions extends SuperviseOptions {
|
|
|
11635
10291
|
readonly brain: ToolLoopChat;
|
|
11636
10292
|
}
|
|
11637
10293
|
//#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
10294
|
//#region src/runtime/supervise/supervise-worker-backend.d.ts
|
|
11644
10295
|
/**
|
|
11645
10296
|
* Build the worker seam from a backend (WHERE workers run) + an optional completion oracle (the
|
|
@@ -11928,14 +10579,17 @@ type GraphEdge =
|
|
|
11928
10579
|
* root decides the order, the branch, the repair loop or the stop. On each usable settle of
|
|
11929
10580
|
* `from` its outgoing routes edges are tried in declaration order and the first whose `when`
|
|
11930
10581
|
* 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
|
|
10582
|
+
* spawned with `{ from: { node, result }, evidence: { [id]: latest usable result } }` (a join's
|
|
10583
|
+
* target with `{ from: { nodes }, evidence }`, see below) and the directive appended to its pinned instructions; `{ stop }` ends the run with no winner and
|
|
11933
10584
|
* `GraphResult.stopped`; `{ finish }` makes this settle part of the run's output.
|
|
11934
10585
|
*
|
|
11935
10586
|
* A fork lists two or more nodes in `to`: one traversal spawns each of them at once, each under
|
|
11936
10587
|
* 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
|
-
*
|
|
10588
|
+
* fires once every member has settled usably since it last fired, and the target's task is
|
|
10589
|
+
* `{ from: { nodes: <members in declared order> }, evidence }` with each member's latest result
|
|
10590
|
+
* in `evidence`, so it does not depend on which member settled last and a resumed run derives the
|
|
10591
|
+
* same task. A routes edge that spawns a node with a settled worker in this flow (a back edge)
|
|
10592
|
+
* 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
10593
|
* leaving each of its members. A route into a node that still has a running worker throws
|
|
11940
10594
|
* {@link GraphRouteError} with reason `target-live`: converging branches use a join.
|
|
11941
10595
|
*/
|
|
@@ -12209,8 +10863,6 @@ declare class FileObserverJournal implements ObserverJournal {
|
|
|
12209
10863
|
private readExistingUnsafe;
|
|
12210
10864
|
private assertComplete;
|
|
12211
10865
|
}
|
|
12212
|
-
/** Verify identity, monotonic sequence, payload shape, and the complete digest chain. */
|
|
12213
|
-
declare function verifyObserverRecords(records: readonly ObserverRecord[], pursuitId?: string): readonly ObserverRecord[];
|
|
12214
10866
|
/** Compute the canonical SHA-256 digest for an unsigned observer record. */
|
|
12215
10867
|
declare function observerRecordDigest(record: Omit<ObserverRecord, 'digest'>): string;
|
|
12216
10868
|
//#endregion
|
|
@@ -13404,9 +12056,6 @@ interface PipelineStage<Task, StepIn, StepOut> {
|
|
|
13404
12056
|
* Fail loud (return a `blocked`) when the child produced nothing usable for the next stage. */
|
|
13405
12057
|
collect(settled: Settled<Outcome<StepOut>>): Outcome<StepOut>;
|
|
13406
12058
|
}
|
|
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
12059
|
/**
|
|
13411
12060
|
* `fanout(items, { synthesize? })` — N children spawned in one round (one per item, bounded by
|
|
13412
12061
|
* the conserved pool's fail-closed admission), drained via `scope.next()`, then optionally a
|
|
@@ -13475,8 +12124,6 @@ interface FanoutSynthesis<D> {
|
|
|
13475
12124
|
synthesisTask(gathered: ReadonlyArray<Settled<Outcome<D>>>, ctx: ShapeContext<D>): unknown;
|
|
13476
12125
|
collect(settled: Settled<Outcome<D>>): Outcome<D>;
|
|
13477
12126
|
}
|
|
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
12127
|
/**
|
|
13481
12128
|
* `loopUntil({ until, step })` — iterative deepening inside the conserved pool: spawn one `step`
|
|
13482
12129
|
* child per round, ask `until` whether the accumulated state satisfies the goal, and stop when it
|
|
@@ -13507,8 +12154,6 @@ interface LoopUntilState<State> {
|
|
|
13507
12154
|
readonly round: number;
|
|
13508
12155
|
readonly value: State;
|
|
13509
12156
|
}
|
|
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
12157
|
/**
|
|
13513
12158
|
* `panel(judges)` — M judges over ONE artifact, merged WRITE-ONLY (selector≠judge taken to its
|
|
13514
12159
|
* limit). The combinator spawns the M judge children over the same input artifact, drains their
|
|
@@ -13637,10 +12282,6 @@ interface WidenLineage<D> {
|
|
|
13637
12282
|
}
|
|
13638
12283
|
/** `widen(spec)` — build the streaming progressive-widening combinator. */
|
|
13639
12284
|
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
12285
|
/**
|
|
13645
12286
|
* The reactive analyst seam — the PORT of the round-synchronous driver's `analyze` hook
|
|
13646
12287
|
* (dynamic.ts) onto the reactive `Scope`. The old driver wired the analyst at round
|
|
@@ -13781,9 +12422,6 @@ interface RenderCorpusToInstructionsOptions {
|
|
|
13781
12422
|
/** Optional cap on rendered lines (most-confident first), independent of the query `limit`. */
|
|
13782
12423
|
readonly maxLines?: number;
|
|
13783
12424
|
}
|
|
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
12425
|
/**
|
|
13788
12426
|
* One node in the reconstructed trajectory tree — a driver OR a leaf, with its OWN spend and the
|
|
13789
12427
|
* spend ROLLED UP over its subtree. Reconstructed from the `SpawnJournal` (structure + per-node
|
|
@@ -13831,8 +12469,6 @@ interface TrajectoryReportOptions {
|
|
|
13831
12469
|
/** Rehydrate each `done` node's `output` from the blob store. Off by default (cost-only report). */
|
|
13832
12470
|
readonly withOutputs?: boolean;
|
|
13833
12471
|
}
|
|
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
12472
|
/**
|
|
13837
12473
|
* One arm of an equal-k comparison — a labeled trajectory (a `TrajectoryReport` is one arm's whole
|
|
13838
12474
|
* run). The arm's conserved COST is `report.total` (tokens + usd), which the sandbox executor
|
|
@@ -13880,8 +12516,6 @@ interface EqualKOnCostOptions {
|
|
|
13880
12516
|
* the impl (e.g. 0.05). A tighter tolerance = a stricter equal-compute claim. */
|
|
13881
12517
|
readonly tolerance?: number;
|
|
13882
12518
|
}
|
|
13883
|
-
/** `equalKOnCost(arms, opts)` — the cross-arm equal-compute check on conserved cost. */
|
|
13884
|
-
type EqualKOnCost = (arms: ReadonlyArray<EqualKArm>, options?: EqualKOnCostOptions) => EqualKVerdict;
|
|
13885
12519
|
//#endregion
|
|
13886
12520
|
//#region src/runtime/observe.d.ts
|
|
13887
12521
|
interface ObserveInput {
|
|
@@ -14450,8 +13084,6 @@ declare function defaultSelectWinner<Task, Output>(iterations: Iteration<Task, O
|
|
|
14450
13084
|
declare const TERMINAL_DECISIONS: readonly ["stop", "pick-winner", "fail", "done"];
|
|
14451
13085
|
/** One of the kernel's terminal decision values. @stable */
|
|
14452
13086
|
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
13087
|
//#endregion
|
|
14456
13088
|
//#region src/runtime/local-sandbox-client.d.ts
|
|
14457
13089
|
interface LocalSandboxClientOptions {
|
|
@@ -14471,12 +13103,6 @@ interface LocalSandboxClientOptions {
|
|
|
14471
13103
|
* different per-create profile and provides no host isolation. */
|
|
14472
13104
|
profileSecurityPolicy?: AgentProfileSecurityPolicy;
|
|
14473
13105
|
}
|
|
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
13106
|
//#endregion
|
|
14481
13107
|
//#region src/runtime/loop-dispatch.d.ts
|
|
14482
13108
|
/** runAgentRounds options minus the `ctx` (loopDispatch builds the ctx). */
|
|
@@ -14960,19 +13586,6 @@ declare function definePersona<D = unknown>(input: DefinePersonaInput<D>): Perso
|
|
|
14960
13586
|
*/
|
|
14961
13587
|
declare function runPersonified<Task, D>(options: RunPersonifiedOptions<Task, D>): Promise<SupervisedResult<Outcome<D>>>;
|
|
14962
13588
|
//#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
13589
|
//#region src/runtime/personify/trajectory.d.ts
|
|
14977
13590
|
/**
|
|
14978
13591
|
* Reconstruct the whole spawn tree for `root` with per-node + rolled-up `Spend`. Reads the
|
|
@@ -15076,144 +13689,18 @@ interface PrivateCasArtifactPort extends AgentCandidateOutputArtifactPort {
|
|
|
15076
13689
|
* Bytes are written to the host first. With a durable store, every object is also copied off the
|
|
15077
13690
|
* host as it is written, and `localBudgetBytes` bounds what the host keeps: an object's local copy
|
|
15078
13691
|
* 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
13692
|
*
|
|
15198
|
-
*
|
|
15199
|
-
|
|
15200
|
-
|
|
15201
|
-
|
|
15202
|
-
|
|
15203
|
-
|
|
15204
|
-
*
|
|
15205
|
-
*
|
|
15206
|
-
*
|
|
13693
|
+
* An object's name is published only after its bytes are synced, and that order is what makes a
|
|
13694
|
+
* name trustworthy. A put whose digest already exists links nothing: it re-reads the existing
|
|
13695
|
+
* object and refuses on a mismatch, and no later put replaces that file. So a deferred-sync mode
|
|
13696
|
+
* that published names before one batch sync would, after a crash, leave a torn object under its
|
|
13697
|
+
* valid name, and every later put of that digest would fail. Any batching must keep the order:
|
|
13698
|
+
* write under temporary names, sync, publish the names, sync again (discovery-lab
|
|
13699
|
+
* runner/evidence-store.mjs commits receipts this way). On drew-gtr-pro's USB SMR disk on
|
|
13700
|
+
* 2026-10-21 these per-object fsyncs, 545 ms each on the 16 SYNC_THREADS, set a store's rate at
|
|
13701
|
+
* about 26 files/s.
|
|
15207
13702
|
*/
|
|
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;
|
|
13703
|
+
declare function createPrivateCasArtifactPort(root: string, namespace: string, options?: PrivateCasOptions): PrivateCasArtifactPort;
|
|
15217
13704
|
//#endregion
|
|
15218
13705
|
//#region src/runtime/profile-chat-client.d.ts
|
|
15219
13706
|
/** Profile-exact adapter for packages that consume agent-eval's ChatClient contract.
|
|
@@ -15518,22 +14005,6 @@ declare function createSandboxLineage(client: SandboxClient, options?: {
|
|
|
15518
14005
|
beforeDelete?: (box: SandboxInstance) => Promise<void>;
|
|
15519
14006
|
onAcquire?: (box: SandboxInstance, profile: AgentProfile) => void;
|
|
15520
14007
|
}): 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
14008
|
//#endregion
|
|
15538
14009
|
//#region src/runtime/sandbox-run.d.ts
|
|
15539
14010
|
/**
|
|
@@ -15752,51 +14223,171 @@ interface TournamentRow {
|
|
|
15752
14223
|
rep: number;
|
|
15753
14224
|
cells: Record<string, TournamentCell>;
|
|
15754
14225
|
}
|
|
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;
|
|
14226
|
+
/** Every settled cell of one split, by task and strategy. Strategies measured on different
|
|
14227
|
+
* tasks have unpaired means; compare them with the paired `selection` estimates. */
|
|
14228
|
+
interface StrategyTournament {
|
|
14229
|
+
split: SearchSplit;
|
|
14230
|
+
rows: TournamentRow[];
|
|
14231
|
+
perStrategy: Record<string, {
|
|
14232
|
+
cells: number;
|
|
14233
|
+
scored: number;
|
|
14234
|
+
score: number | null;
|
|
14235
|
+
usd: number;
|
|
14236
|
+
usdKnown: boolean;
|
|
14237
|
+
}>;
|
|
14238
|
+
}
|
|
14239
|
+
interface EvolutionReport {
|
|
14240
|
+
searchId: string;
|
|
14241
|
+
/** The search ledger: the only record and checkpoint. */
|
|
14242
|
+
ledger: string;
|
|
14243
|
+
closeReason: SearchCloseReason;
|
|
14244
|
+
/** Root first, in registration order. */
|
|
14245
|
+
strategies: EvolutionStrategy[];
|
|
14246
|
+
/** The strategy the search keeps: the claim's selection, else the root. */
|
|
14247
|
+
selected: EvolutionStrategy;
|
|
14248
|
+
claim: SearchClaim;
|
|
14249
|
+
claimVerification: SearchClaimVerification;
|
|
14250
|
+
/** `ship` only when the claim shipped, re-derives from the ledger, every cost is known, and
|
|
14251
|
+
* the shipped finalist's test lower bound is above zero. */
|
|
14252
|
+
decision: 'ship' | 'hold';
|
|
14253
|
+
reason: string;
|
|
14254
|
+
tournament: Record<SearchSplit, StrategyTournament>;
|
|
14255
|
+
/** Known dollars, proven floors of unknown ones, and how many cells and operations (an
|
|
14256
|
+
* authoring an interrupted process lost, for example) have an unknown cost. */
|
|
14257
|
+
spend: {
|
|
14258
|
+
knownUsd: number;
|
|
14259
|
+
floorUsd: number;
|
|
14260
|
+
unknownCostCells: number;
|
|
14261
|
+
unknownCostOperations: number;
|
|
14262
|
+
};
|
|
14263
|
+
}
|
|
14264
|
+
/** Evolve a strategy on the search kernel and claim once on the sealed test split. */
|
|
14265
|
+
declare function runStrategyEvolution(cfg: StrategyEvolutionConfig): Promise<EvolutionReport>;
|
|
14266
|
+
/**
|
|
14267
|
+
* The tournament on one split, projected from the ledger: each settled cell's final attempt,
|
|
14268
|
+
* by task and repeat, keyed by strategy name. `names` maps node ids to report names.
|
|
14269
|
+
*/
|
|
14270
|
+
declare function strategyTournament(state: SearchStateView, split: SearchSplit, names: ReadonlyMap<string, string>): StrategyTournament;
|
|
14271
|
+
//#endregion
|
|
14272
|
+
//#region src/runtime/stream-agent-turn.d.ts
|
|
14273
|
+
/**
|
|
14274
|
+
* The execution substrate one turn runs on — a closed discriminated union over
|
|
14275
|
+
* the three stream surfaces the runtime already owns.
|
|
14276
|
+
*
|
|
14277
|
+
* @stable
|
|
14278
|
+
*/
|
|
14279
|
+
type AgentTurnBackend = {
|
|
14280
|
+
/** A Runtime-owned executor factory materialized from this exact canonical profile. */
|
|
14281
|
+
kind: 'executor';
|
|
14282
|
+
factory: ExecutorFactory<unknown>;
|
|
14283
|
+
/** Exact canonical identity materialized by the executor. */
|
|
14284
|
+
profile: AgentProfile;
|
|
14285
|
+
/** Model label stamped on cost-only `llm_call` events. Default `'agent'`. */
|
|
14286
|
+
agentRunName?: string;
|
|
14287
|
+
};
|
|
14288
|
+
/** @stable */
|
|
14289
|
+
interface StreamAgentTurnOptions {
|
|
14290
|
+
/** Caller-initiated cancellation. Terminates the stream with `final.status: 'aborted'`. */
|
|
14291
|
+
signal?: AbortSignal;
|
|
14292
|
+
/**
|
|
14293
|
+
* Wall-clock deadline for the whole turn in ms. An expired deadline aborts
|
|
14294
|
+
* the backend and terminates the stream with `final.status: 'failed'`
|
|
14295
|
+
* (a blown deadline is a turn failure, not a caller cancellation).
|
|
14296
|
+
*/
|
|
14297
|
+
timeoutMs?: number;
|
|
14298
|
+
/** Stable logical paid-call id, forwarded as the provider idempotency key and retained in evidence. */
|
|
14299
|
+
callId?: string;
|
|
14300
|
+
/** Caller trace tag retained in evidence and forwarded when the transport supports it. */
|
|
14301
|
+
correlationId?: string;
|
|
14302
|
+
/**
|
|
14303
|
+
* Opt-in tool-part projection for box and executor backends: sandbox tool
|
|
14304
|
+
* parts additionally surface in-stream as
|
|
14305
|
+
* `tool_call` / `tool_result` events (`mapSandboxToolEvent`), so a consumer
|
|
14306
|
+
* rendering tool activity needs no bespoke sandbox-event parser. Default
|
|
14307
|
+
* off — the stream vocabulary existing consumers see is unchanged. No-op
|
|
14308
|
+
* for the `chat` kind (its backend emits `RuntimeStreamEvent`s directly,
|
|
14309
|
+
* tool events included when the backend produces them).
|
|
14310
|
+
*/
|
|
14311
|
+
preserveToolParts?: boolean;
|
|
14312
|
+
/**
|
|
14313
|
+
* Raw-event tap for box-kind backends: called (and awaited) with every
|
|
14314
|
+
* unmapped `SandboxEvent` BEFORE it is projected, so a consumer can read
|
|
14315
|
+
* parts the chat-UX projection drops (part ids, step markers, custom
|
|
14316
|
+
* backend events) without forking the mapper. Purely observational — it
|
|
14317
|
+
* cannot alter the mapped stream. Never called for the `chat` kind, which
|
|
14318
|
+
* has no sandbox events.
|
|
14319
|
+
*/
|
|
14320
|
+
onRawEvent?: (event: SandboxEvent) => void | Promise<void>;
|
|
14321
|
+
}
|
|
14322
|
+
/**
|
|
14323
|
+
* Metered usage of one turn, summed over every cost-bearing event the backend
|
|
14324
|
+
* emitted. `input`/`output` are token counts and are accompanied by
|
|
14325
|
+
* `tokensKnown: false` when the backend did not report them. `costUsd`/`model`
|
|
14326
|
+
* are present only when the backend actually reported them.
|
|
14327
|
+
*
|
|
14328
|
+
* @stable
|
|
14329
|
+
*/
|
|
14330
|
+
interface AgentTurnUsage {
|
|
14331
|
+
input: number;
|
|
14332
|
+
output: number;
|
|
14333
|
+
/** Present when a real turn ran but the provider did not report token usage. */
|
|
14334
|
+
tokensKnown?: false;
|
|
14335
|
+
costUsd?: number;
|
|
14336
|
+
/** Present when Runtime could not prove the full dollar amount. */
|
|
14337
|
+
usdKnown?: false;
|
|
14338
|
+
/** Separately-labelled local/catalog estimate; never billed spend. */
|
|
14339
|
+
estimatedCostUsd?: number;
|
|
14340
|
+
/** Provider-reported prompt-cache fields; absent fields remain unknown. */
|
|
14341
|
+
promptCache?: Readonly<Record<string, number | string>>;
|
|
14342
|
+
/** Provider-reported reasoning-token subset of output, when available. */
|
|
14343
|
+
reasoningTokens?: number;
|
|
14344
|
+
model?: string;
|
|
14345
|
+
}
|
|
14346
|
+
/**
|
|
14347
|
+
* A drained turn: the terminal summary plus every event the stream yielded.
|
|
14348
|
+
* `status`/`error` mirror the terminal `final` event so a failed or aborted
|
|
14349
|
+
* turn stays inspectable without re-scanning `events`.
|
|
14350
|
+
*
|
|
14351
|
+
* @stable
|
|
14352
|
+
*/
|
|
14353
|
+
interface CollectedAgentTurn {
|
|
14354
|
+
finalText: string;
|
|
14355
|
+
/** Exact terminal artifact output from a Runtime-owned executor. */
|
|
14356
|
+
output?: unknown;
|
|
14357
|
+
usage: AgentTurnUsage;
|
|
14358
|
+
/** Exact underlying transport calls when the Runtime-owned executor reports them. */
|
|
14359
|
+
transportAttempts?: number;
|
|
14360
|
+
toolCalls: Array<{
|
|
14361
|
+
id?: string;
|
|
14362
|
+
name: string;
|
|
14363
|
+
arguments: string;
|
|
15766
14364
|
}>;
|
|
14365
|
+
events: RuntimeStreamEvent[];
|
|
14366
|
+
status: AgentTaskStatus;
|
|
14367
|
+
error?: BackendErrorDetail;
|
|
14368
|
+
/** Public Sandbox outcome, when the turn ran through a Sandbox stream or executor. */
|
|
14369
|
+
sandboxOutcome?: AgentRunOutcome;
|
|
15767
14370
|
}
|
|
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
14371
|
/**
|
|
15796
|
-
*
|
|
15797
|
-
*
|
|
14372
|
+
* Run ONE agent turn on any backend kind and stream its events. Yields the
|
|
14373
|
+
* `RuntimeStreamEvent` vocabulary incrementally and always ends with a `final`
|
|
14374
|
+
* event carrying the turn's text and usage (`metadata.tokenUsage`,
|
|
14375
|
+
* `metadata.costUsd?`, `metadata.model?`) — on success, failure, abort, and
|
|
14376
|
+
* timeout alike. The generator never throws; failures surface in-band as
|
|
14377
|
+
* `backend_error` + `final` with a typed `error` detail.
|
|
14378
|
+
*
|
|
14379
|
+
* @stable
|
|
15798
14380
|
*/
|
|
15799
|
-
declare function
|
|
14381
|
+
declare function streamAgentTurn(backend: AgentTurnBackend, input: AgentTurnInput, opts?: StreamAgentTurnOptions): AsyncGenerator<RuntimeStreamEvent>;
|
|
14382
|
+
/**
|
|
14383
|
+
* Drain a `streamAgentTurn` stream (or any `RuntimeStreamEvent` stream that
|
|
14384
|
+
* honors its terminal contract) into the turn summary plus the full event
|
|
14385
|
+
* list. Fail-loud: throws when the stream ends without a terminal `final`
|
|
14386
|
+
* event — a stream that violates the contract must not read as an empty turn.
|
|
14387
|
+
*
|
|
14388
|
+
* @stable
|
|
14389
|
+
*/
|
|
14390
|
+
declare function collectAgentTurn(stream: AsyncIterable<RuntimeStreamEvent>): Promise<CollectedAgentTurn>;
|
|
15800
14391
|
//#endregion
|
|
15801
14392
|
//#region src/runtime/structural-rollout.d.ts
|
|
15802
14393
|
/** Provider-neutral conversation records read by structural candidate extraction. */
|
|
@@ -16080,6 +14671,30 @@ interface ChatWorkerSeamOptions {
|
|
|
16080
14671
|
/** Session-owning worker factory for graph continuity. */
|
|
16081
14672
|
declare function chatWorkerSeam(opts: ChatWorkerSeamOptions): MakeWorkerAgent;
|
|
16082
14673
|
//#endregion
|
|
14674
|
+
//#region src/runtime/supervise/worker-events.d.ts
|
|
14675
|
+
/** Live observation is bounded and process-local. A reconnect explicitly reports expired history. */
|
|
14676
|
+
interface WorkerEventCursor {
|
|
14677
|
+
readonly epoch: string;
|
|
14678
|
+
readonly next: number;
|
|
14679
|
+
}
|
|
14680
|
+
interface WorkerEventEntry {
|
|
14681
|
+
readonly sequence: number;
|
|
14682
|
+
readonly at: number;
|
|
14683
|
+
readonly event: unknown;
|
|
14684
|
+
readonly omitted?: 'event-too-large' | 'event-not-serializable';
|
|
14685
|
+
}
|
|
14686
|
+
type WorkerEventPage = {
|
|
14687
|
+
readonly status: 'unavailable';
|
|
14688
|
+
readonly reason: 'unknown-worker' | 'not-captured';
|
|
14689
|
+
} | {
|
|
14690
|
+
readonly status: 'available';
|
|
14691
|
+
readonly entries: readonly WorkerEventEntry[];
|
|
14692
|
+
readonly cursor: WorkerEventCursor;
|
|
14693
|
+
readonly reset: boolean;
|
|
14694
|
+
readonly historyExpired: boolean;
|
|
14695
|
+
readonly remaining: number;
|
|
14696
|
+
};
|
|
14697
|
+
//#endregion
|
|
16083
14698
|
//#region src/runtime/supervise/contracts/agent-scope.d.ts
|
|
16084
14699
|
/**
|
|
16085
14700
|
* One self-similar atom. A leaf is an `Agent` that never calls `scope.spawn`; a driver
|
|
@@ -17291,7 +15906,7 @@ type SpawnEvent = {
|
|
|
17291
15906
|
* without settling it after a host reboot, a crash, or a killed process. `live` names every
|
|
17292
15907
|
* worker the journal held open at that moment; `replaced` names those this process
|
|
17293
15908
|
* re-placed, so the rest are gone. The root is re-driven with both, and no re-entered drive
|
|
17294
|
-
* counts toward its
|
|
15909
|
+
* counts toward its barren streak until the root has streamed a model event in this
|
|
17295
15910
|
* process. Infrastructure evidence: replay and cost readers skip it; `seq` counts this run's
|
|
17296
15911
|
* re-entries. */
|
|
17297
15912
|
kind: 'root-reentered';
|
|
@@ -17320,6 +15935,25 @@ type SpawnEvent = {
|
|
|
17320
15935
|
madeProgress: boolean;
|
|
17321
15936
|
seq: number;
|
|
17322
15937
|
at: string;
|
|
15938
|
+
} | {
|
|
15939
|
+
/** A manager's re-entered drives completed without progress `streak` times in a row, at or
|
|
15940
|
+
* past its `continuation.maxBarren`, and the driver paused before the next continuation
|
|
15941
|
+
* instead of ending the run. One row per pause, for an operator alarm. Informational:
|
|
15942
|
+
* replay, `materializeTreeView`, and cost readers skip it; `seq` counts this node's barren
|
|
15943
|
+
* pauses. */
|
|
15944
|
+
kind: 'barren-pause';
|
|
15945
|
+
id: NodeId;
|
|
15946
|
+
/** The completed driver attempt the pause follows, 1-based. */
|
|
15947
|
+
attempt: number;
|
|
15948
|
+
streak: number;
|
|
15949
|
+
pauseMs: number;
|
|
15950
|
+
/** ISO 8601: when the next drive may start. */
|
|
15951
|
+
resumeAt: string;
|
|
15952
|
+
/** ISO 8601: when the manager's last attempt that made progress ended, or when its driver
|
|
15953
|
+
* loop began in this process if none has. */
|
|
15954
|
+
lastProgressAt: string;
|
|
15955
|
+
seq: number;
|
|
15956
|
+
at: string;
|
|
17323
15957
|
};
|
|
17324
15958
|
/**
|
|
17325
15959
|
* The spawn-tree event source (begin/append/load).
|
|
@@ -17606,42 +16240,6 @@ interface InPlaceCliExecutorOptions {
|
|
|
17606
16240
|
*/
|
|
17607
16241
|
declare function createInPlaceCliExecutor(options: InPlaceCliExecutorOptions): Executor<InPlaceHarnessResult>;
|
|
17608
16242
|
//#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
16243
|
//#region src/runtime/supervise/interactive-worker.d.ts
|
|
17646
16244
|
/** Environment fields supplied to every interactive worker after Runtime adds the exact profile. */
|
|
17647
16245
|
type InteractiveWorkerEnvironment = Omit<CreateAgentEnvironmentInput, 'profile' | 'idempotencyKey' | 'signal'>;
|
|
@@ -17697,105 +16295,6 @@ interface InteractiveWorkerKeyInput {
|
|
|
17697
16295
|
*/
|
|
17698
16296
|
declare function workerFromInteractiveProvider(provider: AgentEnvironmentProvider, options?: InteractiveWorkerOptions): MakeWorkerAgent;
|
|
17699
16297
|
//#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
16298
|
//#region src/runtime/supervise/profile-registry.d.ts
|
|
17800
16299
|
/** One completed run of one exact profile revision, under its stable NAME. */
|
|
17801
16300
|
interface ProfileRunRecord {
|
|
@@ -17968,20 +16467,6 @@ interface WriteWorkerSteerOptions {
|
|
|
17968
16467
|
readonly source?: string;
|
|
17969
16468
|
readonly interrupt?: boolean;
|
|
17970
16469
|
}
|
|
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
16470
|
/**
|
|
17986
16471
|
* The durable acknowledgement state for one worker-scoped cancel operation, keyed by
|
|
17987
16472
|
* `operationId`. The runtime acknowledger is the ONLY writer; `cancelWorker` only reads it.
|
|
@@ -18041,35 +16526,10 @@ declare function supervisorRunDir(rootDir: string, id: string): string;
|
|
|
18041
16526
|
* here anymore.
|
|
18042
16527
|
*/
|
|
18043
16528
|
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
16529
|
/** A worker label reduced to a safe filename stem. Empty labels get a stable fallback. */
|
|
18050
16530
|
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
16531
|
/** Same, addressed from an already-known run directory (the reader's usual entry point). */
|
|
18056
16532
|
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
16533
|
/**
|
|
18074
16534
|
* Admit one steer exactly once under a caller-owned operation id.
|
|
18075
16535
|
*
|
|
@@ -18093,24 +16553,7 @@ declare function writeWorkerSteer(rootDir: string, supervisorId: string, worker:
|
|
|
18093
16553
|
/** Read every atomically admitted request for one exact worker id, in admission order. @stable */
|
|
18094
16554
|
declare function readWorkerSteerRequests(eventDir: string, worker?: string): WorkerSteerRequest[];
|
|
18095
16555
|
/** 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[];
|
|
16556
|
+
declare function readWorkerSteerAcknowledgement(eventDir: string, operationId: string): WorkerSteerAcknowledgement | undefined;
|
|
18114
16557
|
/**
|
|
18115
16558
|
* Read the acknowledgement for one cancel operation. `undefined` when the runtime has not
|
|
18116
16559
|
* answered. A record whose stored `operationId` differs from the requested one is a filename
|
|
@@ -18140,6 +16583,130 @@ declare function cancelWorker(eventDir: string, worker: string, operationId: str
|
|
|
18140
16583
|
readonly source?: string;
|
|
18141
16584
|
}): WorkerCancellation;
|
|
18142
16585
|
//#endregion
|
|
16586
|
+
//#region src/runtime/supervise/scope-contract.d.ts
|
|
16587
|
+
/** Construction args for `createScope`. The supervisor threads the shared pool, journal,
|
|
16588
|
+
* blob store, and executor registry through; `depth`/`maxDepth` pair the runtime
|
|
16589
|
+
* recursion ceiling with the conserved pool (R3). */
|
|
16590
|
+
interface ScopeArgs {
|
|
16591
|
+
/** This scope's owning node id — children get `${parentId}:s${seq}` ids. */
|
|
16592
|
+
readonly parentId: NodeId;
|
|
16593
|
+
/** Journal/blob root key the supervisor `beginTree`'d. */
|
|
16594
|
+
readonly root: NodeId;
|
|
16595
|
+
/** The reservation pool for this scope: the root total or one nested allocated partition. */
|
|
16596
|
+
readonly pool: BudgetPool;
|
|
16597
|
+
/** Append-only spawn journal; this scope writes `spawned` + `settled` records. */
|
|
16598
|
+
readonly journal: SpawnJournal;
|
|
16599
|
+
/** Content-addressed result store backing `outRef` rehydration. */
|
|
16600
|
+
readonly blobs: ResultBlobStore;
|
|
16601
|
+
/** The open executor resolver (BYO → router/inline → registered harness factory). */
|
|
16602
|
+
readonly executors: ExecutorRegistry;
|
|
16603
|
+
/** Per-spawn executor-construction seams (sandbox client, router config, cli bin). */
|
|
16604
|
+
readonly seams: Readonly<Record<string, unknown>>;
|
|
16605
|
+
/** This scope's recursion depth (root = 0). */
|
|
16606
|
+
readonly depth: number;
|
|
16607
|
+
/** Runtime recursion-depth ceiling — a spawn past it fails closed `depth-exceeded`. */
|
|
16608
|
+
readonly maxDepth?: number;
|
|
16609
|
+
/** The allocator that bounds concurrently working agents across this scope, every nested scope,
|
|
16610
|
+
* and every other tree that shares it. Absent means no bound: only the budget limits concurrency. */
|
|
16611
|
+
readonly workerSlots?: WorkerSlots;
|
|
16612
|
+
/** @internal The slot this scope's own manager holds in its parent scope. A nested scope's first
|
|
16613
|
+
* running child works on it while the manager waits. Absent on a root scope. */
|
|
16614
|
+
readonly slotOwner?: SlotPermit;
|
|
16615
|
+
/** Optional policy that keeps part of each manager's budget for its own inference. */
|
|
16616
|
+
readonly reservationPolicy?: RecursiveReservationPolicy;
|
|
16617
|
+
/** The budget from which this scope's owner-share floor is derived. */
|
|
16618
|
+
readonly ownerBudget?: Budget;
|
|
16619
|
+
/** What a steerable child's own time box does: a check-in by default (`deadline.ts`
|
|
16620
|
+
* `DeadlineCheckIn`); `false` stops the child at its time box. Nested scopes inherit it. */
|
|
16621
|
+
readonly deadlineCheckIn?: DeadlineCheckIn;
|
|
16622
|
+
/** How long a keyed leaf whose turn ended over its budget keeps its environment for a same-key
|
|
16623
|
+
* re-spawn to continue (ms). Default `DEFAULT_BUDGET_STOP_HOLD_MS`; `0` keeps none.
|
|
16624
|
+
* Nested scopes inherit it. */
|
|
16625
|
+
readonly budgetStopHoldMs?: number;
|
|
16626
|
+
/** Abort signal for this scope; an abort cascades into every live child's executor. */
|
|
16627
|
+
readonly signal: AbortSignal;
|
|
16628
|
+
/** Injected clock — keeps the journal `at` timestamp deterministic in tests. */
|
|
16629
|
+
readonly now?: () => number;
|
|
16630
|
+
/** Lifecycle stream sink. `spawn` emits `agent.spawn`, `next` emits `agent.child` — the
|
|
16631
|
+
* SAME stream `runAgentRounds`/`tool-loop` feed, so the recursive tree is ONE observable stream
|
|
16632
|
+
* (the topology viewer reads it). Undefined ⇒ the journal stays the only record. */
|
|
16633
|
+
readonly hooks?: RuntimeHooks;
|
|
16634
|
+
/**
|
|
16635
|
+
* Trace context to hand down to each spawned worker (`SupervisorOpts.workerTrace`). Called with
|
|
16636
|
+
* THIS scope's own `parentId` — the node doing the spawning — and the resolved context is seeded
|
|
16637
|
+
* onto each child's `ExecutorContext` under `workerTraceSeamKey`. Absent (the untraced default)
|
|
16638
|
+
* ⇒ no seam is seeded and no worker environment is touched.
|
|
16639
|
+
*/
|
|
16640
|
+
readonly workerTrace?: WorkerTraceResolver;
|
|
16641
|
+
/**
|
|
16642
|
+
* Present when this run RECORDS spans but the worker backend has NO channel to carry the trace
|
|
16643
|
+
* context (`WORKER_TRACE_PROPAGATION[backend] === false` — cli-worktree has no env
|
|
16644
|
+
* channel; router / router-tools / provider have no worker process). Each spawn then journals a
|
|
16645
|
+
* `trace-unpropagated` event naming the severed hop, so a child whose trace shows up as a
|
|
16646
|
+
* disconnected root is a recorded fact rather than a silent stranger. Absent ⇒ either the run
|
|
16647
|
+
* is untraced or the backend propagates; nothing is journaled.
|
|
16648
|
+
*/
|
|
16649
|
+
readonly workerTraceUnpropagated?: {
|
|
16650
|
+
readonly backend: string;
|
|
16651
|
+
readonly reason: 'no-env-channel' | 'no-worker-process' | 'caller-omitted';
|
|
16652
|
+
};
|
|
16653
|
+
/** Durable run directory that receives exact worker interactive bindings. */
|
|
16654
|
+
readonly interactiveBindingDir?: string;
|
|
16655
|
+
/** @internal Trusted root-adapter publication channel. It is never exposed as a Scope method. */
|
|
16656
|
+
readonly ownerMaterialization?: {
|
|
16657
|
+
readonly runtime: NodeSnapshot['runtime'];
|
|
16658
|
+
readonly authoredProfile?: unknown;
|
|
16659
|
+
readonly attemptId: string;
|
|
16660
|
+
readonly prior?: ProfileMaterializationReceipt;
|
|
16661
|
+
readonly journalRoot?: NodeId;
|
|
16662
|
+
readonly nodeId?: NodeId;
|
|
16663
|
+
readonly requiredKnown?: boolean;
|
|
16664
|
+
readonly onReceipt?: (materialization: ProfileMaterializationReceipt, binding: ExecutionBindingReceipt) => void;
|
|
16665
|
+
};
|
|
16666
|
+
/**
|
|
16667
|
+
* Resume seam — set ONLY by the supervisor when `SupervisorOpts.resume` is on AND a non-empty
|
|
16668
|
+
* journal tree exists for this root. It carries the replayed committed work (so `scope.resume`
|
|
16669
|
+
* exposes it to a resume-aware `act`) and the recorded ordinal/cursor maxima the new counters
|
|
16670
|
+
* continue past, so a freshly-spawned child never reuses a journaled `seq`. Absent ⇒ fresh run.
|
|
16671
|
+
*/
|
|
16672
|
+
readonly resumeFrom?: {
|
|
16673
|
+
/** @internal Executor adoption plans validated by the supervisor's recovery preparation. */
|
|
16674
|
+
readonly recoveries?: readonly RetainedChildRecovery[];
|
|
16675
|
+
readonly events?: readonly SpawnEvent[];
|
|
16676
|
+
readonly settled: ReadonlyArray<Settled<unknown>>;
|
|
16677
|
+
readonly view: TreeView;
|
|
16678
|
+
/** Highest `spawned` ordinal already journaled; new spawns start at `+1`. */
|
|
16679
|
+
readonly maxSpawnOrdinal: number;
|
|
16680
|
+
/** Highest cursor `seq` already journaled; new settlements start at `+1`. */
|
|
16681
|
+
readonly maxCursorSeq: number;
|
|
16682
|
+
/** Keyed assignments from the prior journal — what a keyed re-spawn resolves against. */
|
|
16683
|
+
readonly keys: ReadonlyMap<string, ResumedKeyState<unknown>>;
|
|
16684
|
+
/** Prior committed spend summed off the journal (settled child work + metered inference). */
|
|
16685
|
+
readonly priorSpend: {
|
|
16686
|
+
readonly childWork: Spend;
|
|
16687
|
+
readonly driverInference: Spend;
|
|
16688
|
+
};
|
|
16689
|
+
};
|
|
16690
|
+
}
|
|
16691
|
+
//#endregion
|
|
16692
|
+
//#region src/runtime/supervise/scope-construction.d.ts
|
|
16693
|
+
/** 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. */
|
|
16694
|
+
declare function createScope<Out>(args: ScopeArgs): Scope<Out>;
|
|
16695
|
+
//#endregion
|
|
16696
|
+
//#region src/runtime/supervise/scope-observation.d.ts
|
|
16697
|
+
/**
|
|
16698
|
+
* The step-8 merge-boundary adapter (M4): rehydrate a `Settled.done` into the kernel's
|
|
16699
|
+
* `Iteration` shape so `defaultSelectWinner` stays single-sourced — the supervisor selects
|
|
16700
|
+
* across settled children with the SAME argmax the loop kernel uses, not a forked copy.
|
|
16701
|
+
*
|
|
16702
|
+
* `index` is the cursor `seq` (the recorded, replay-stable order); `output`/`verdict`/
|
|
16703
|
+
* `tokenUsage`/`costUsd` are read straight off the settlement (already rehydrated from the
|
|
16704
|
+
* `outRef` blob by `next()`). Events are empty — a settled child is an opaque leaf result,
|
|
16705
|
+
* not a sandbox event stream — and the timing/cost fields project its conserved `Spend`.
|
|
16706
|
+
* Fail loud on a `down` settlement: only a `done` child is an iteration.
|
|
16707
|
+
*/
|
|
16708
|
+
declare function settledToIteration<Out>(settled: Settled<Out>): Iteration<unknown, Out>;
|
|
16709
|
+
//#endregion
|
|
18143
16710
|
//#region src/runtime/supervise/search-spec.d.ts
|
|
18144
16711
|
/**
|
|
18145
16712
|
* One multi-agent research configuration: seven orthogonal axes, all data.
|
|
@@ -18190,7 +16757,8 @@ interface SearchSpec {
|
|
|
18190
16757
|
readonly analysts?: ReadonlyArray<string>;
|
|
18191
16758
|
};
|
|
18192
16759
|
readonly stop: {
|
|
18193
|
-
/** Re-entered turns in a row without progress before
|
|
16760
|
+
/** Re-entered turns in a row without progress before each further continuation waits a
|
|
16761
|
+
* barren pause (`continuation.maxBarren`). */
|
|
18194
16762
|
readonly maxBarren: number;
|
|
18195
16763
|
/** End the run when a window of settlements lifts the best score by no more than `minDelta`. */
|
|
18196
16764
|
readonly plateau?: {
|
|
@@ -18314,6 +16882,25 @@ interface FencedSqlRunContext extends RunContext {
|
|
|
18314
16882
|
*/
|
|
18315
16883
|
declare function createFencedSqlRunContext(db: SqlAdapter, runId: string, options?: SqlRunContextOptions): Promise<FencedSqlRunContext>;
|
|
18316
16884
|
//#endregion
|
|
16885
|
+
//#region src/runtime/supervise/supervisor-root-handle.d.ts
|
|
16886
|
+
/**
|
|
16887
|
+
* Mint a `RootHandle` plus its supervisor-private control. The handle is the substrate a
|
|
16888
|
+
* chat/pi-viz client attaches to (Q2): `view()` reads the live tree, `signal()` delivers
|
|
16889
|
+
* an out-of-band message, `abort()` cascades. Before `run` binds it (and after `run`
|
|
16890
|
+
* unbinds it) the handle is fail-loud: a client that talks to a handle that is not
|
|
16891
|
+
* driving a live run gets a typed error, never a silent no-op.
|
|
16892
|
+
*/
|
|
16893
|
+
declare function createRootHandle<Out>(): SteerableRootHandle<Out>;
|
|
16894
|
+
//#endregion
|
|
16895
|
+
//#region src/runtime/supervise/supervisor-run.d.ts
|
|
16896
|
+
/** The default recursion-depth ceiling. The conserved pool is what bounds a tree's depth: every
|
|
16897
|
+
* level draws its slice from the level above, so a tree ends when its slices run out. This
|
|
16898
|
+
* ceiling only stops a runaway recursion that keeps spawning tiny slices, so it sits well above
|
|
16899
|
+
* any depth a budget can usefully pay for. */
|
|
16900
|
+
declare const DEFAULT_MAX_DEPTH = 16;
|
|
16901
|
+
/** Create a supervisor that owns one recursive agent execution tree. */
|
|
16902
|
+
declare function createSupervisor<Task, Out>(): Supervisor<Task, Out>;
|
|
16903
|
+
//#endregion
|
|
18317
16904
|
//#region src/runtime/supervise/trace-evidence.d.ts
|
|
18318
16905
|
/** Schema version for content-addressed worker tool-trace artifacts. */
|
|
18319
16906
|
declare const WORKER_TOOL_TRACE_SCHEMA_VERSION: 1;
|
|
@@ -18322,10 +16909,6 @@ interface WorkerToolTraceArtifact {
|
|
|
18322
16909
|
readonly schemaVersion: typeof WORKER_TOOL_TRACE_SCHEMA_VERSION;
|
|
18323
16910
|
readonly spans: ReadonlyArray<ToolSpan>;
|
|
18324
16911
|
}
|
|
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
16912
|
/** Validate a stored trace artifact before an analyst or replay trusts it. */
|
|
18330
16913
|
declare function parseWorkerToolTraceArtifact(value: unknown, traceRef?: string): WorkerToolTraceArtifact;
|
|
18331
16914
|
//#endregion
|
|
@@ -18527,6 +17110,97 @@ declare function readWorkerInteractiveBinding(eventDir: string, workerId: string
|
|
|
18527
17110
|
*/
|
|
18528
17111
|
declare function attachWorker(eventDir: string, workerId: string, options: AttachWorkerOptions): Promise<WorkerInteractiveSession>;
|
|
18529
17112
|
//#endregion
|
|
17113
|
+
//#region src/runtime/supervise/worktree-cli-executor.d.ts
|
|
17114
|
+
/** Terminal artifact of one worktree-CLI run — the canonical worktree-harness result (the captured
|
|
17115
|
+
* diff + the harness's run record + the derived checks). */
|
|
17116
|
+
type WorktreePatchArtifact = WorktreeHarnessResult;
|
|
17117
|
+
/** @experimental */
|
|
17118
|
+
interface WorktreeCliExecutorOptions {
|
|
17119
|
+
/** Absolute path to the git checkout the worktree is cut from. */
|
|
17120
|
+
repoRoot: string;
|
|
17121
|
+
/**
|
|
17122
|
+
* The supervisor-authored prompt/model plus materializable structural resources.
|
|
17123
|
+
* `model.default` selects the one-shot model. Routing-only model hints, placement concerns,
|
|
17124
|
+
* provider extensions, and `resources.failOnError` fail before execution because this path
|
|
17125
|
+
* cannot honor them. Harness-specific values the materializer cannot preserve also fail closed.
|
|
17126
|
+
*/
|
|
17127
|
+
profile: AgentProfile;
|
|
17128
|
+
/** Default instruction for direct `execute(undefined, signal)` calls. An execution-time task
|
|
17129
|
+
* is authoritative. Omit when the caller always supplies the task to `execute`. */
|
|
17130
|
+
taskPrompt?: string;
|
|
17131
|
+
/** Unique id for the worktree path + branch. Defaults to a fresh UUID. */
|
|
17132
|
+
runId?: string;
|
|
17133
|
+
/** Override the base ref the worktree is cut from (default `HEAD`). */
|
|
17134
|
+
baseRef?: string;
|
|
17135
|
+
/** Optional wall-clock cap per harness subprocess (ms). Omit it for no timer. */
|
|
17136
|
+
harnessTimeoutMs?: number;
|
|
17137
|
+
/** Run Codex with an ephemeral session, isolated config/instructions, network disabled, and
|
|
17138
|
+
* JSONL usage capture. Requires `profile.harness: 'codex'`; metered by default. */
|
|
17139
|
+
codexReproducible?: boolean;
|
|
17140
|
+
/** Absolute host paths denied to reproducible Codex (for benchmark answer copies, credentials,
|
|
17141
|
+
* or other task-specific ambient state). */
|
|
17142
|
+
codexReadDeniedPaths?: ReadonlyArray<string>;
|
|
17143
|
+
/**
|
|
17144
|
+
* Shell command run in the live worktree to derive the tests-PASS signal (e.g. `pnpm test`).
|
|
17145
|
+
* Its exit code becomes `artifact.checks.tests.passed`. Omit to skip (no signal derived).
|
|
17146
|
+
*/
|
|
17147
|
+
testCmd?: string;
|
|
17148
|
+
/** Shell command run in the live worktree to derive the typecheck-PASS signal (e.g. `pnpm typecheck`). */
|
|
17149
|
+
typecheckCmd?: string;
|
|
17150
|
+
/** Wall-clock cap per verification command (ms). Default = `harnessTimeoutMs` or 5 min. */
|
|
17151
|
+
checkTimeoutMs?: number;
|
|
17152
|
+
/** Cap on each check's captured output. Default 16k. */
|
|
17153
|
+
checkOutputCap?: number;
|
|
17154
|
+
/** Test seam — inject a git runner so unit tests drive the worktree helpers without git. */
|
|
17155
|
+
runGit?: GitRunner;
|
|
17156
|
+
/** Test seam — inject the harness runner so unit tests script a `LocalHarnessResult`. */
|
|
17157
|
+
runHarness?: typeof runLocalHarness;
|
|
17158
|
+
/** Test seam — inject the verification-command runner so unit tests script test/typecheck
|
|
17159
|
+
* outcomes without spawning a real shell. Defaults to a `/bin/sh -c` spawn in the worktree. */
|
|
17160
|
+
runCommand?: WorktreeCheckRunner;
|
|
17161
|
+
/**
|
|
17162
|
+
* Exclude this leaf's spend from accounting. Defaults to `true` for ordinary CLI runs and
|
|
17163
|
+
* `false` for `codexReproducible`, which captures real token usage. A metered custom runner must
|
|
17164
|
+
* likewise return `LocalHarnessResult.usage`.
|
|
17165
|
+
*/
|
|
17166
|
+
budgetExempt?: boolean;
|
|
17167
|
+
/** @internal Kernel-minted attempt identity threaded by the built-in registry. */
|
|
17168
|
+
executionAttemptId?: string;
|
|
17169
|
+
}
|
|
17170
|
+
/**
|
|
17171
|
+
* Build a worktree-CLI leaf `Executor`. Per-spawn (a fresh worktree + abort + teardown each), so a
|
|
17172
|
+
* fanout of N profiles = N parallel worktrees that never clobber each other.
|
|
17173
|
+
*
|
|
17174
|
+
* Fail-loud: an empty `repoRoot`, an incomplete/unsupported profile, a separate harness override,
|
|
17175
|
+
* or an explicitly empty `taskPrompt` throws at construction. Calling `execute(undefined, signal)`
|
|
17176
|
+
* without a configured prompt throws before a worktree is created. `resultArtifact()` before
|
|
17177
|
+
* `execute()` resolves throws.
|
|
17178
|
+
*
|
|
17179
|
+
* @experimental
|
|
17180
|
+
*/
|
|
17181
|
+
declare function createWorktreeCliExecutor(options: WorktreeCliExecutorOptions): Executor<WorktreePatchArtifact>;
|
|
17182
|
+
//#endregion
|
|
17183
|
+
//#region src/runtime/supervise/patch-checks.d.ts
|
|
17184
|
+
/** @experimental The per-task constraints the mechanical gate enforces. */
|
|
17185
|
+
interface CoderCheckConstraints {
|
|
17186
|
+
/** Default 400. Hard cap; gate fails when exceeded. */
|
|
17187
|
+
maxDiffLines?: number;
|
|
17188
|
+
/** Literal path prefixes the patch must not touch. */
|
|
17189
|
+
forbiddenPaths?: string[];
|
|
17190
|
+
}
|
|
17191
|
+
//#endregion
|
|
17192
|
+
//#region src/runtime/supervise/patch-deliverable.d.ts
|
|
17193
|
+
/** @experimental */
|
|
17194
|
+
interface PatchDeliverableOptions extends CoderCheckConstraints {
|
|
17195
|
+
/**
|
|
17196
|
+
* Which verification signals the gate REQUIRES to be present-and-passing. A required signal
|
|
17197
|
+
* that the artifact never derived (the command was not configured on the executor) fails the
|
|
17198
|
+
* gate closed. Unlisted signals default to passed-when-absent (the executor simply didn't run
|
|
17199
|
+
* that command). Default `[]` — gate on no-op / secret / forbidden / diff-size only.
|
|
17200
|
+
*/
|
|
17201
|
+
require?: ReadonlyArray<'tests' | 'typecheck'>;
|
|
17202
|
+
}
|
|
17203
|
+
//#endregion
|
|
18530
17204
|
//#region src/runtime/supervise/worktree-fanout.d.ts
|
|
18531
17205
|
/** @experimental One authored profile in a worktree fanout. Its exact `harness` field chooses the
|
|
18532
17206
|
* local CLI; the supervisor authors the complete profile per sub-task. */
|
|
@@ -18756,19 +17430,6 @@ declare function boxSurfaceReader(box: SurfaceReadBox, options?: BoxSurfaceReade
|
|
|
18756
17430
|
*/
|
|
18757
17431
|
declare function fsSurfaceReader(root: string): SurfaceReader;
|
|
18758
17432
|
//#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
17433
|
//#region src/runtime/verifier-environment.d.ts
|
|
18773
17434
|
interface VerifierEnvironmentOptions {
|
|
18774
17435
|
name: string;
|
|
@@ -19294,7 +17955,8 @@ interface CoordinationTools {
|
|
|
19294
17955
|
readonly unavailable?: string;
|
|
19295
17956
|
}): CheckRead;
|
|
19296
17957
|
/** Every `report_blocked` whose probe failed too, in report order. A blocked tool is evidence,
|
|
19297
|
-
* not a terminal condition: the run goes on, and
|
|
17958
|
+
* not a terminal condition: the run goes on, and turns without progress pace it with longer
|
|
17959
|
+
* barren pauses until the check, the deadline, the budget or a cancel ends it. */
|
|
19298
17960
|
blocked(): ReadonlyArray<BlockedToolReport>;
|
|
19299
17961
|
}
|
|
19300
17962
|
/** One `report_blocked` whose probe failed too.
|
|
@@ -19348,6 +18010,9 @@ interface DriverAttemptRecord {
|
|
|
19348
18010
|
readonly contract?: DriverContractState;
|
|
19349
18011
|
/** True when this COMPLETED attempt's unmet contract sent the loop back with a continuation. */
|
|
19350
18012
|
readonly reprompted?: boolean;
|
|
18013
|
+
/** With `reprompted`: the pause taken before that continuation because the barren streak had
|
|
18014
|
+
* reached `continuation.maxBarren`. The run's journal holds its `barren-pause` row. */
|
|
18015
|
+
readonly barrenPauseMs?: number;
|
|
19351
18016
|
/** For a completed attempt that left work open: how long the manager then waited, with no
|
|
19352
18017
|
* model turn, before the wake that started the next attempt. */
|
|
19353
18018
|
readonly waitedMs?: number;
|
|
@@ -19355,10 +18020,10 @@ interface DriverAttemptRecord {
|
|
|
19355
18020
|
* the manager has no continuation policy, or when the continuation was sent. */
|
|
19356
18021
|
readonly repromptRefusedBy?: DriverRepromptRefusal;
|
|
19357
18022
|
}
|
|
19358
|
-
/** Why a completed drive with an unmet contract was not re-entered. `
|
|
19359
|
-
* `
|
|
19360
|
-
*
|
|
19361
|
-
type DriverRepromptRefusal = 'closed' | Extract<DriverAttemptStop, 'aborted' | 'budget-exhausted' | 'deadline' | 'max-attempts'
|
|
18023
|
+
/** Why a completed drive with an unmet contract was not re-entered. `closed` means the run was
|
|
18024
|
+
* already closed: the manager's own `stop` or a progress stop rule. A barren streak is never a
|
|
18025
|
+
* refusal: it pauses the next continuation (`barrenPauseMs`). */
|
|
18026
|
+
type DriverRepromptRefusal = 'closed' | Extract<DriverAttemptStop, 'aborted' | 'budget-exhausted' | 'deadline' | 'max-attempts'>;
|
|
19362
18027
|
/**
|
|
19363
18028
|
* How one driver failure is answered.
|
|
19364
18029
|
*
|
|
@@ -19371,30 +18036,6 @@ type DriverRepromptRefusal = 'closed' | Extract<DriverAttemptStop, 'aborted' | '
|
|
|
19371
18036
|
* budget, and cancellation bound the pauses.
|
|
19372
18037
|
*/
|
|
19373
18038
|
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
18039
|
/**
|
|
19399
18040
|
* What one driver loop did, counted from its attempt records: the numbers a run's settle record
|
|
19400
18041
|
* carries so a reader can tell genuine continuations from failure retries without the journal.
|
|
@@ -19449,8 +18090,6 @@ interface DriverContinuationRecord extends DriverLoopRecord {
|
|
|
19449
18090
|
* Empty for a manager with no check. */
|
|
19450
18091
|
readonly continuations: ReadonlyArray<ContinuationEntry>;
|
|
19451
18092
|
}
|
|
19452
|
-
/** Count a loop's attempt records into its {@link DriverLoopRecord}. */
|
|
19453
|
-
declare function summarizeDriverAttempts(records: ReadonlyArray<DriverAttemptRecord>): DriverLoopRecord;
|
|
19454
18093
|
//#endregion
|
|
19455
18094
|
//#region src/runtime/supervise/contracts/supervisor-result.d.ts
|
|
19456
18095
|
/** Provider-observed model identity for the root manager's settled inference turns.
|
|
@@ -20313,32 +18952,6 @@ interface RuntimeFailureCause {
|
|
|
20313
18952
|
/** The upstream or provider machine code the failure carried, when it carried one. */
|
|
20314
18953
|
readonly providerCode?: string;
|
|
20315
18954
|
}
|
|
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
18955
|
//#endregion
|
|
20343
18956
|
//#region src/types.d.ts
|
|
20344
18957
|
/** @stable */
|
|
@@ -20877,5 +19490,5 @@ interface KnowledgeReadinessDecision {
|
|
|
20877
19490
|
nonBlockingGapIds: string[];
|
|
20878
19491
|
}
|
|
20879
19492
|
//#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-
|
|
19493
|
+
export { NoWinnerError as $, CoordinationEvent as $_, strategyTournament as $a, RetainedInteractiveAdmissionHook as $b, TrajectoryNode as $c, formatPromptHandle as $d, CoordinationLog as $f, PairwiseOptions as $g, researcherProfile as $h, ChatTransportExecutorOptions as $i, PursuitVersions as $l, DelegateRunCtx as $m, SqlRunContextOptions as $n, createScopeAnalyst as $o, SharedBoxCloseReceipt as $p, GraphRunRecord as $r, depthStrategy as $s, createVerifierEnvironment as $t, WorkerSpawnRetryAttempt as $u, createPeerMailbox as $v, LoopTraceEvent as $x, defaultRedactor as $y, TraceRootArtifact as A, RetainedRunCancelOptions as AS, OtelSpan as A_, filterAuthoredAsserts as Aa, HeldEnvironment as Ab, AssertTraceDerivedFindings as Ac, BudgetReadout as Ad, RunCancelRequest as Af, CodexRolloutStoreRef as Ag, DelegationError as Ah, SpawnJournal as Ai, LeaderboardScenario as Al, SandboxToolPartState as Am, settledWorkerOut as An, PrivateCasDurableStore as Ao, createExecutorRegistry as Ap, RemoteWorkerEvents as Ar, InProcessSandboxClientOptions as As, AgentEnvironmentStatus as At, EdgeDeliveryOutcome as Au, ContinuityMode as Av, ExecutorProgressEvent as Ax, runLocalHarness as Ay, Handle as B, RetainedRunStartMaterial as BS, RuntimeTelemetryOptions as B_, AgentTurnUsage as Ba, TraceSource as Bb, FanoutWinnerSelector as Bc, RootStreamRecord as Bd, FinalizeContext as Bf, CodeModeTool as Bg, ResearchOutputShape as Bh, SupervisorOpts as Bi, declaredCheckDigest as Bl, RouterRouting as Bm, WorkspaceRun as Bn, renderCorpusToInstructions as Bo, SandboxSeam as Bp, loadProfile as Br, materializeLocalMcp as Bs, CreateAgentEnvironmentInput$1 as Bt, runGraph as Bu, AUTHORITY_MARKERS as Bv, LoopEndedPayload as Bx, SpawnForestEvent as By, RuntimeFailureCause as C, RecoverRetainedRunResult as CS, SandboxEvidenceContext as C_, StructuralRolloutResult as Ca, EnvironmentTeardownReceipt as Cb, ObservationAnalysis as Cc, SupervisorSpanOutcome as Cd, ProgressView as Cf, deterministicCompletion as Cg, DelegateCodeArgs as Ch, GraphDesignerExtraTools as Ci, DefinedLeaderboard as Cl, envKeyProvider as Cm, readWorkerInteractiveBinding as Cn, recoverRetainedInteractiveRun as Co, McpServer as Cp, supervisorRunDir as Cr, LocalSandboxClientOptions as Cs, SuperviseProfileEntry as Ct, projectPursuit as Cu, QuestionPolicy as Cv, ProviderWorkspaceAttemptProvenance as Cx, AnalyzeOnSettleRoute as Cy, RetainedPendingCause as D, RetainedInteractiveStartedAdmission as DS, OtelExportConfig as D_, composeCheckSources as Da, ExecutorCancellationRequest as Db, defaultAnalystInstruction as Dc, DeadlineCheckIn as Dd, anyOf as Df, CodexRolloutIdentity as Dg, DelegateUiAuditArgs as Dh, delegate as Di, LeaderboardFlagSpec as Dl, secretEnvOfMcpServer as Dm, WorkerEvidenceInput as Dn, profileChatClient as Do, DelegateHandlerOptions as Dp, RemoteSupervisorAgent as Dr, inlineSandboxClient as Ds, AgentEnvironmentEvent$1 as Dt, ObserverRecordKind as Du, AuthorizeDownMessage as Dv, ProviderWorkspaceEntryMetadata as Dx, CodexExecutionEvidence as Dy, EvidencePendingEvent as E, RetainedInteractiveIntentAdmission as ES, OtelAttribute as E_, compareCheckOutcomes as Ea, ExecutorCancellation as Eb, ObserveOptions as Ec, WorkerTraceResolver as Ed, allWorkersStalled as Ef, CodexForkBoundary as Eg, DelegateResearchConfig as Eh, defaultDelegateBudget as Ei, LeaderboardBenchmarkAdapter as El, resolveSecretEnv 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, questionEscalationTargets as Ev, ProviderWorkspaceCaptureResult as Ex, DefinedAnalystRecord as Ey, ResourceLimit as F, RetainedRunEventOptions as FS, padTraceId as F_, selectBestIndex as Fa, WorkerInteractiveUnavailableReason as Fb, EqualKArm as Fc, ReservationShortfall as Fd, ReentryContinuity as Ff, harnessUsageIsEmpty as Fg, DelegationResultPayload as Fh, RootSegment as Fi, DeclaredCheckPlacement as Fl, SandboxUsageLedger as Fm, withUntrackedArtifacts as Fn, trajectoryReport as Fo, CliWorktreeBridgeSeam as Fp, SupervisorCleanupReceipt as Fr, McpListedTool as Fs, AgentSessionStatus$1 as Ft, GraphResult as Fu, WorkerResumeContext as Fv, DefaultVerdict$2 as Fx, SqlRunOwnershipError as Fy, Settled as G, sanitizeKnowledgeReadinessReport as G_, EvolutionAuthor as Ga, ExecutorProgress as Gb, PanelSpec as Gc, PromptHandle as Gd, CoordinationMcpHandle as Gf, createCodeModeTools as Gg, UiFindingSeverity as Gh, Scope as Gi, IsolatedCheckOptions as Gl, ToolLoopCompactionOptions as Gm, TrajectoryAnalysis as Gn, pipeline as Go, createSteerableSandboxSession as Gp, InteractiveWorkerEnvironment as Gr, AgenticTool as Gs, PlacementInfo as Gt, workerFromBackend as Gu, PeerMailLimits as Gv, LoopPlanDescription as Gx, loadSpawnForest as Gy, NodeSnapshot as H, StartRetainedRunInEnvironmentOptions as HS, SanitizedKnowledgeRequirement as H_, StreamAgentTurnOptions as Ha, ActivityLog as Hb, LoopUntilState as Hc, readRootStreamReceipt as Hd, SupervisorFinalizer as Hf, CodeModeToolsOptions as Hg, UiAuditorDelegationOutput as Hh, ReenteredWorkers as Hi, readDeclaredCheck as Hl, ToolLoopCallContext as Hm, jjWorkspace as Hn, flatWidenGate as Ho, SandboxSteeringOptions as Hp, profileRegistry as Hr, AgenticRunResult as Hs, ExecRequest as Ht, supervise as Hu, PEER_MAIL_WIRE_KEY as Hv, LoopIterationEndedPayload as Hx, SpawnForestMissingTree as Hy, ResourceSpend as I, RetainedRunHandle as IS, RuntimeEventCollector as I_, structuralRollout as Ia, WorkerTraceEvidence as Ib, EqualKOnCostOptions as Ic, ReservationStage as Id, ReentryTaskInput as If, readCodexRolloutSession as Ig, DelegationStatus as Ih, RootSegmentEntry as Ii, DeclaredCheckStateCapture as Il, extractLlmCallEvent as Im, GitWorkspaceOptions as In, definePersona as Io, CliWorktreeSeam as Ip, provisionSupervisor as Ir, McpSpawnFault as Is, AgentTurnResult$2 as It, GraphTopology as Iu, MapItemFailurePolicy as Iv, Driver as Ix, openSqlRunStore as Iy, SpawnRejection as J, WorktreeCommandResult as J_, StrategyEvolutionConfig as Ja, WorkerProgress as Jb, RenderCorpusToInstructionsOptions as Jc, analyzesFindingsReportPrompt as Jd, CoordinationTransportOptions as Jf, GroupOf as Jg, KnowledgeUpdate as Jh, WorkerEventCursor as Ji, JudgedPursuitVersion as Jl, FeedbackEvent as Jm, parseWorkerToolTraceArtifact as Jn, widen as Jo, InboxLease as Jp, InteractiveWorkerResult as Jr, RunAgenticOptions as Js, SandboxInstance$1 as Jt, SuperviseOptions as Ju, PeerMailRefusal as Jv, LoopSandboxPlacement as Jx, FileSpawnJournal as Jy, SpawnOpts as K, InPlaceHarnessResult as K_, EvolutionReport as Ka, ScopeProgressInput as Kb, PanelVerdict as Kc, PromptRegistry as Kd, CoordinationPublicAddress as Kf, runCodeMode as Kg, UiLens as Kh, UnconfirmedTeardown as Ki, IsolatedCheckResult as Kl, ToolLoopMessageRecord as Km, analyzeTrace as Kn, selectValidWinner as Ko, AuthorityInboxMessage as Kp, InteractiveWorkerKeyInput as Kr, ArtifactHandle as Ks, ResourceRequest as Kt, AuthorizedSpawn as Ku, PeerMailOutcome as Kv, LoopPlanPayload as Kx, FileResultBlobStore as Ky, Spend as L, RetainedRunIntentAdmission as LS, RuntimeStreamEventCollector as L_, visibleCheckScore as La, WorkerTraceUnavailableReason as Lb, EqualKVerdict as Lc, ReservationTicket as Ld, UNPROVEN_CONTINUITY as Lf, HarnessUsage as Lg, DelegationStatusResult as Lh, RootSignal as Li, assertDeclaredCheck as Ll, sumSandboxUsage as Lm, Shell as Ln, runPersonified as Lo, ProviderSeam as Lp, ProfileRegistryDir as Lr, StdioMcpConnection as Ls, AnalystFinding$1 as Lt, RunGraphOptions as Lu, MapOnSettleRoute as Lv, ExecCtx as Lx, SqlAdapter as Ly, Budget as M, RetainedRunDispatchedAdmission as MS, createOtelExporter as M_, officialChecksFromMeta as Ma, HeldRelease as Mb, Corpus as Mc, ReservationFloor as Md, cancelRun as Mf, CodexStoreDelta as Mg, DelegationHistoryArgs as Mh, WorkspaceCheckpointMarker as Mi, LeaderboardSpec as Ml, mapSandboxEvent as Mm, CopyOptions as Mn, PrivateCasOptions as Mo, createExecutor as Mp, ProvisionSupervisorConnection as Mr, HttpMcpServerSpec as Ms, AgentProfile$2 as Mt, GraphEdge as Mu, DownMessageDeliveryAttempt as Mv, TokenUsageProvenance as Mx, LocalHarness as My, BudgetOverspend as N, RetainedRunEffect as NS, loopEventToOtelSpan as N_, resolveEntrySymbol as Na, Runtime as Nb, CorpusFilter as Nc, ReservationHolder as Nd, readRunCancelRequest as Nf, addHarnessUsage as Ng, DelegationHistoryEntry as Nh, RecursiveReservationPolicy as Ni, defineLeaderboard as Nl, mapSandboxToolEvent as Nm, UntrackedCopyStats as Nn, createPrivateCasArtifactPort as No, CliInPlaceSeam as Np, ProvisionSupervisorRequest as Nr, LocalMcpMaterialization as Ns, AgentSession as Nt, GraphEdgeCapError as Nu, DownMessageDeliveryOutcome as Nv, UsageEvent as Nx, CodexTokenUsage as Ny, TRACE_ROOT_SCHEMA as O, RetainedRunAdmission as OS, OtelExportStats as O_, defaultExtractCandidate as Oa, ExecutorResult as Ob, observe as Oc, BudgetPool as Od, noProgressFor as Of, CodexRolloutSession as Og, DelegateUiAuditConfig as Oh, ResultBlobStore as Oi, LeaderboardIterationInfo as Ol, SandboxLeafOut as Om, closingWorkerNote as On, profileOptimizerModelCall as Oo, DelegateResult as Op, RemoteSupervisorReader as Or, InProcessOnPrompt as Os, AgentEnvironmentProvider$1 as Ot, observerRecordDigest as Ou, AuthorizedDownMessage as Ov, ProviderWorkspaceRetentionContext as Ox, LocalHarnessResult as Oy, BudgetViolation as P, RetainedRunEnvironmentAdmission as PS, padSpanId as P_, sandboxCheckRunner as Pa, WorkerInteractiveSession as Pb, CorpusRecord as Pc, ReservationRejection as Pd, readRunCancellation as Pf, createCodexRolloutStoreReader as Pg, DelegationProgress as Ph, RootHandle as Pi, DeclaredCheck as Pl, SandboxServedBackend as Pm, copyUntrackedIntoClone as Pn, equalKOnCost as Po, CliSeam as Pp, ProvisionedSupervisor as Pr, MaterializeLocalMcpOptions as Ps, AgentSessionRef as Pt, GraphNode as Pu, DownMessageEvent as Pv, AgentRunSpec as Px, CodexExecutionPolicy as Py, FleetYield as Q, AwaitWakeInput as Q_, runStrategyEvolution as Qa, RecoverRetainedInteractiveRunOptions as Qb, SteerContext as Qc, dumbContinuationPassPrompt as Qd, CoordinationDeliveryEvidence as Qf, LeaderboardRow as Qg, ResearcherProfileOptions as Qh, ChatSessionStore as Qi, PursuitVersionStop as Ql, CoderReviewer as Qm, FencedSqlRunContext as Qn, buildSteerContext as Qo, DEFAULT_SHARED_BOX_WORKERS as Qp, GraphRegistryDir as Qr, breadthStrategy as Qs, VerifierEnvironmentOptions as Qt, ResolvedWorkerSpawnRetry as Qu, claimsAuthority as Qv, LoopTraceEmitter as Qx, Redactor as Qy, SpendChannel as R, RetainedRunReplayPoint as RS, RuntimeStreamEventSink as R_, AgentTurnBackend as Ra, SessionMessageLike as Rb, FanoutOptions as Rc, ReserveOptions as Rd, composeReentryTask as Rf, decodeHarnessUsage as Rg, FeedbackRating as Rh, SteerableRootHandle as Ri, checkProgramDigest as Rl, RouterResponseReceipt as Rm, Workspace as Rn, FileCorpus as Ro, RouterSeam as Rp, ProfileRunRecord as Rr, StdioMcpServerSpec as Rs, CheckpointRef as Rt, RunGraphTestOptions as Ru, MapSpawnMarker as Rv, Iteration as Rx, materializeTreeView as Ry, RuntimeStreamEvent as S, RecoverRetainedRunOptions as SS, runAgentRounds as S_, StructuralRolloutPolicy as Sa, UnknownMaterializationReason as Sb, Observation as Sc, SupervisorSpanOptions as Sd, PlateauOptions as Sf, completionAuthorizes as Sg, SubmitOutput as Sh, DesignerToolsEnv as Si, providerAsSandboxClient as Sl, ResolvedMcpServerLaunch as Sm, attachWorker as Sn, reconnectRetainedInteractiveRun as So, resolveSpawnResourcePaths as Sp, safeWorkerFile as Sr, superviseDispatch as Ss, SpawnRefusalCause as St, PursuitStatus as Su, QuestionOption as Sv, ProviderNativeCapturePhase as Sx, AnalystRunContext as Sy, RuntimeFailureOwner as T, RetainedInteractiveEnvironmentAdmission as TS, SandboxEvidenceRetentionPort as T_, canDisplace as Ta, ExecutorAccounting as Tb, ObserveInput as Tc, createSupervisorSpanRecorder as Td, StopRule as Tf, stopSentinel as Tg, DelegateResearchArgs as Th, DelegateOptions as Ti, LeaderboardBenchTask as Tl, resolveMcpServerLaunch 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, QuestionUrgency as Tv, ProviderWorkspaceCaptureReceipt as Tx, AuthoredAnalystLimits as Ty, NodeStatus as U, StartRetainedRunOptions as US, createRuntimeEventCollector as U_, collectAgentTurn as Ua, ActivityNote as Ub, Panel as Uc, defaultEdgeTraversalCap as Ud, bestDelivered as Uf, CodeModeToolset as Ug, UiFinding as Uh, ResumedKeyState as Ui, IsolatedCheckBox as Ul, ToolLoopChat as Um, localShell as Un, loopUntil as Uo, SteerableSandboxArgs as Up, profileRunsForName as Ur, AgenticSurface as Us, ExecResult as Ut, superviseFleetCapabilities as Uu, PeerMailEnvelope as Uv, LoopIterationStartedPayload as Ux, SpawnForestNode as Uy, NodeId as V, RetainedRunTurnInput as VS, SanitizedKnowledgeReadinessReport as V_, CollectedAgentTurn as Va, createPushTraceSource as Vb, LoopUntilSpec as Vc, readRootStream as Vd, FinalizerSettled as Vf, CodeModeToolContext as Vg, UiAuditLensFilter as Vh, Agent as Vi, declaredCheckJudge as Vl, ToolSpec 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, DEFAULT_PEER_MAIL_LIMITS as Vv, LoopIterationDispatchPayload as Vx, SpawnForestInDoubtNode as Vy, RetainedExecutionState as W, createRuntimeStreamEventCollector as W_, streamAgentTurn as Wa, DEFAULT_STALL_AFTER_MS as Wb, PanelJudge as Wc, GraphRouteError as Wd, CoordinationAuthentication as Wf, RunCodeModeOptions as Wg, UiFindingScreenshot as Wh, ResumedWork as Wi, IsolatedCheckBoxEvidence as Wl, ToolLoopCompaction as Wm, runInWorkspace as Wn, panel as Wo, SteerableSandboxSession as Wp, recordProfileRun as Wr, AgenticTask as Ws, ForkRequest as Wt, superviseWithTestBrain as Wu, PeerMailEvent as Wv, LoopLineageOptions as Wx, SpawnForestTree as Wy, SubtreeSummary as X, WorktreeProfileMaterializationReceipt as X_, TournamentCell as Xa, readWorkerProgress as Xb, ScopeAnalyzeInput as Xc, delegatesWorkerBriefPrompt as Xd, CoordinationHttpAudit as Xf, Leaderboard as Xg, ResearchSource as Xh, WorkerEventPage as Xi, NextPursuitVersionInput as Xl, CoderDelegate as Xm, createSupervisor as Xn, RegistryAnalyzeProjection as Xo, PeerInboxMessage as Xp, InPlaceCliExecutorOptions as Xr, StrategyShotResult as Xs, computeFindingId$1 as Xt, WorkerSlots as Xu, PeerMailbox as Xv, LoopTeardownFailedPayload as Xx, InMemorySpawnJournal as Xy, SubtreeResult as Y, WorktreeHarnessResult as Y_, StrategyTournament as Ya, createActivityLog as Yb, ScopeAnalyst as Yc, createPromptRegistry as Yd, serveCoordinationMcp as Yf, Interval as Yg, ResearchOutput as Yh, WorkerEventEntry as Yi, NextPursuitVersion as Yl, FeedbackStore 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, PeerMailSendInput as Yv, LoopStartedPayload as Yx, InMemoryResultBlobStore as Yy, TreeView as Z, GitRunner as Z_, TournamentRow as Za, ReconnectRetainedInteractiveRunOptions as Zb, ScopeWidenGate as Zc, dumbContinuationFailPrompt as Zd, CoordinationRejectReason as Zf, LeaderboardOptions as Zg, ResearchTask as Zh, ChatCompletionsTransport as Zi, PursuitVersionChain as Zl, CoderReview as Zm, createRootHandle as Zn, assertTraceDerivedFindings as Zo, DEFAULT_SHARED_BOX_RESOURCES as Zp, createInPlaceCliExecutor as Zr, SurfaceScore as Zs, makeFinding$1 as Zt, createWorkerSlots as Zu, PeerMailboxOptions as Zv, LoopTokenUsage as Zx, contentAddress as Zy, RunAgentTaskOptions as _, NativeContextContinuationExecution as _S, WaterfallCollector as __, CheckSource as _a, MaterializedExecutionIdentity as _b, HarvestCorpusOptions as _c, RunContextLease as _d, SupervisorToolInvocationContext as _f, verdictFromJudgeScore as _g, DelegationResumeTick as _h, RollingDispatchOptions as _i, RunPersonifiedOptions as _l, ProviderPlacement as _m, WorktreePatchArtifact as _n, recoverRetainedRun as _o, ResolvedSpawnResourcePath as _p, cancelWorker as _r, LoopOptionsForDispatch as _s, PeerAuditAccess as _t, PursuitNodeTiming as _u, QuestionDecision as _v, RetainedHarnessTranscriptCapture as _x, AnalystAssignmentRecord as _y, AgentKnowledgeProvider as a, SandboxClient as aS, renderLeaderboardHtml as a_, AuthoredProfile as aa, NotFoundError as ab, ShotSpec as ac, withWorkerSpawnRetry as ad, CoordinationToolFace as af, DelegationPersistenceError as ag, FleetHandle as ah, graphRegistry as ai, WidenDecision as al, ROUTER_CLIENT_HEADER as am, SurfaceReader as an, SandboxRunAbortError as ao, ContinuationPanel as ap, SearchSpecOwnedOption as ar, sanitizeMcpToolSchema as as, DriverAttemptRecord as at, SupervisePursuitError as au, WorkerWatchOptions as av, HarnessTranscriptCapture as ax, McpToolAnnotations as ay, RuntimeSession as b, ReconnectRetainedRunOptions as bS, createWaterfallCollector as b_, StructuralRolloutConfig as ba, ProfileMaterializationReceipt as bb, HarvestReport as bc, withRunContext as bd, AllWorkersStalledOptions as bf, CompletionPolicy as bg, DelegationTaskQueueOptions as bh, rollingDispatch as bi, ShapeRegistry as bl, BridgeSeam as bm, WorkerInteractiveBinding as bn, ClaimRetainedInteractiveControlOptions as bo, SpawnResourceReader as bp, readWorkerSteerAcknowledgement as br, loopCampaignDispatch as bs, SpawnPreflightContext as bt, PursuitRunProjection as bu, QuestionEscalationTarget as bv, retainHarnessTranscript as bx, AnalystLensOutput as by, AgentTaskContext as c, Validator as cS, renderPairwiseMarkdown as c_, asAuthoredProfile as ca, ExecutorContext as cb, StrategyCtx as cc, SeatSegment as cd, DriveHarnessOwnerContext as cf, FileDelegationStoreOptions as cg, createFleetWorkspaceExecutor as ch, loadGraph as ci, WinnerStrategy as cl, AgentEnvironmentProviderRef as cm, fsSurfaceReader as cn, SandboxLineage as co, ContinuationPolicy as cp, searchPresets as cr, BenchmarkLift as cs, DriverFailureClass as ct, superviseGraphPursuit as cu, GateRequest as cv, HarnessTranscriptUnavailable as cx, BusEvent as cy, AgentTaskStatus as d, RuntimeRunHandle as dS, AnytimeTaskCurve as d_, profileRichnessFinding as da, SpawnModelSubstitution as db, assertStrategyContract as dc, SeatStage as dd, ResolveSupervisorTools as df, CheckUnavailableError as dg, RunDetachedTurnOptions as dh, recordGraphRun as di, LoopShape as dl, resolveAgentEnvironmentProvider 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, RouteGate as dv, captureHarnessTranscript as dx, EventBus as dy, LoopWinner as eS, PairwiseVerdict as e_, ChatTransportTool as ea, AgentEvalError$1 as eb, refine as ec, WorkerSpawnRetryHooks as ed, kernelPromptRegistry as ef, TraceContext as eg, DetachedSessionDelegateOptions as eh, GraphSelection as ei, TrajectoryReport as el, SharedBoxPlacement as em, BoxSurfaceReaderOptions as en, Deliverable as eo, FileCoordinationLog as ep, createFencedSqlRunContext as er, registryScopeAnalyst as es, ProviderModelAttemptEvidence as et, SettledPursuitVersion as eu, EventAcknowledgement as ev, RetainedInteractiveEnvironmentInput as ex, isPeerMailEnvelope as ey, BackendErrorDetail as f, RuntimeRunOptions as fS, anytimeReport as f_, supervisorInstructions as fa, AgentExecutionRef as fb, authorStrategy as fc, SelectSeat as fd, SupervisorAgentDeps as ff, CheckVerdict as fg, runDetachedTurn as fh, storedGraphDigests as fi, Outcome as fl, ProviderExecutorOptions as fm, failuresAnalyst as fn, acquireSandbox as fo, admitContinuationPolicy as fp, ScopeArgs as fr, Environment as fs, CoordinationTools as ft, PursuitObserverDelivery as fu, RouteMatch as fv, harnessTranscriptArtifact as fx, PublishOptions as fy, OpenAIChatToolChoice as g, startRuntimeRun as gS, renderAnytimeTable as g_, CheckRunner as ga, ExecutorNodeContext as gb, strategyAuthorSystemPrompt as gc, RunContext as gd, SupervisorToolDescriptor as gf, mapExecutorResult as gg, DelegationResumeDriver as gh, DispatchUnit as gi, RunPersonified as gl, UnavailablePausePolicy as gm, WorktreeCliExecutorOptions as gn, reconnectRetainedRun as go, ResolveSpawnResourcePathsResult as gp, WriteWorkerSteerOptions as gr, LoopDispatchOptions as gs, MakeWorkerAgent as gt, PursuitNodeProjection as gu, Question as gv, HarnessTranscriptReadOptions as gx, watchTrace as gy, OpenAIChatTool as h, RuntimeRunStatus as hS, plateauLength as h_, CheckRunContext as ha, ExecutorMaterialization as hb, strategyAuthorContract as hc, InMemoryRunContextOptions as hd, SupervisorNodeContextSeed as hf, gateOnDeliverable as hg, DelegationResumeContext as hh, DispatchStopReason as hi, PersonaExecutors as hl, providerAsExecutor as hm, worktreeFanout as hn, createS3PrivateCasStore as ho, DriverRetryPolicy as hp, WorkerSteerRequest as hr, LoopCampaignDispatchOptions as hs, GraphSubtasks as ht, PursuitNodePlatform as hu, EscalateQuestion as hv, HarnessTranscriptReadLimits as hx, defaultToolDetectors as hy, AgentExecutionBackend as i, RunProvenance as iS, pairwiseSignificance as i_, createChatSessionStore as ia, JudgeError as ib, AuthoredStrategy as ic, retryPreSpawnRefusals as id, supervisorAgentWithTestBrain as if, composeLoopTraceEmitters as ig, DelegationExecutor as ih, graphFromStored as ii, Widen as il, sharedBoxPlacement as im, SurfaceReadOutcome as in, SandboxRun as io, ContinuationEntry as ip, SearchSpecInputs as ir, createMcpEnvironment as is, SupervisedResult as it, SuperviseGraphPursuitOptions as iu, ToolOutcomeEvent as iv, HarnessTranscriptArtifact as ix, JsonRpcResponse as iy, TraceSummary as j, RetainedRunCancellation as jS, buildLoopOtelSpans as j_, modelAuthoredChecks as ja, HeldForContinuation as jb, CombinatorShape as jc, LeakedReservation as jd, RunCancellation as jf, CodexRolloutTurn as jg, DelegationFeedbackSnapshot as jh, TraceRootReceipt as ji, LeaderboardScore as jl, createSandboxToolPartState as jm, spendFromUsageEvents as jn, PrivateCasOffloadReport as jo, ExecutorConfig as jp, connectRemoteSupervisor as jr, inProcessSandboxClient as js, AgentEnvironmentSummary as jt, EdgeTraversal as ju, DownMessageAuthorizationInput as jv, ExecutorToolCall as jx, LOCAL_HARNESSES as jy, TRACE_SUMMARY_SCHEMA as k, RetainedRunAdmissionHook as kS, OtelExporter as k_, defaultStructuralRolloutPolicy as ka, ExecutorTeardownWarning as kb, renderReport as kc, BudgetPoolRestore as kd, plateau as kf, CodexRolloutStoreReader as kg, DelegateUiAuditRoute as kh, SpawnEvent as ki, LeaderboardRunContext as kl, SandboxOutputMarker as km, composeWorkerEvidence as kn, PrivateCasArtifactPort as ko, createDelegateHandler as kp, RemoteSupervisorTree as kr, InProcessPromptCtx as ks, AgentEnvironmentQuery as kt, AgentGraph as ku, ContinuationInstruction as kv, ProviderWorkspaceRetentionPort as kx, RunLocalHarnessOptions as ky, AgentTaskRunResult as l, RuntimeRunCompleteInput as lS, AnytimeReport as l_, assessAuthoredProfile as la, ExecutorFactory as lb, StrategyResult as lc, SeatSelection as ld, ObserveSupervisorNodeEvent as lf, CoderOutput as lg, createSiblingSandboxExecutor as lh, lookupGraph as li, DefinePersona as ll, AgentEnvironmentProviderRegistry as lm, harvestSurfaceDiffs as ln, SandboxLineageHandle as lo, ContinuationProfile as lp, searchSpecDigest as lr, BenchmarkReport as ls, DriverRepromptRefusal as lt, supervisePursuit as lu, JsonScalar as lv, HarnessTranscriptUnavailableReason as lx, BusRecord as ly, OpenAIChatResponseFormat as m, RuntimeRunRow as mS, bestSoFar as m_, CheckOutcome as ma, ExecutorExecutionBinding as mb, sampleThenRefine as mc, InMemoryRunContext as md, SupervisorNodeContext as mf, ExecutorResultMapping as mg, DelegationRecord as mh, DispatchReport as mi, PersonaContext as ml, ProviderPromptOptions as mm, WorktreeFanoutOptions as mn, S3PrivateCasStoreOptions as mo, DriverReentry as mp, WorkerSteerAcknowledgement as mr, runBenchmark as ms, GraphSubtaskPreparation as mt, PursuitNodeCost as mu, ChildQuestionInbox as mv, HarnessTranscriptMetadata as mx, WatchTraceOptions as my, AgentBackendContext as n, MountRecorder as nS, ScoreOf as n_, chatTransportExecutor as na, BackendTransportError as nb, sample as nc, isPreSpawnExecutorFailure as nd, promptHandle as nf, readTraceContextFromEnv as ng, UiAuditorDelegate as nh, digestOfGraph as ni, Verify as nl, SharedBoxStats 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, ManagerReentryState as nv, RetainedInteractiveStartMaterial as nx, peerMailVerbNames as ny, AgentRuntimeEvent as o, SelectionReceipt as oS, renderLeaderboardMarkdown as o_, ProfileRichness as oa, ValidationError as ob, Strategy as oc, SuperviseRegistry as od, CoordinationVerbs as of, DelegationStore as og, FleetWorkspaceExecutorOptions as oh, graphRunsFor as oi, WidenLineage as ol, sharedBoxRefusal as om, WatchedSurface as on, TurnResult as oo, ContinuationPanelInput as op, assertSearchSpec as or, BenchmarkCell as os, DriverAttemptStop as ot, SupervisePursuitOptions as ou, DecideGate as ov, HarnessTranscriptEvidence as ox, McpToolDescriptor as oy, KnowledgeReadinessDecision as p, RuntimeRunPersistenceAdapter as pS, areaUnderCurve as p_, CheckExecChannel as pa, ExecutionBindingReceipt as pb, defineStrategy as pc, subscriptionUsageLimitSignal as pd, SupervisorAgentTestDeps as pf, DeliverableSpec as pg, DelegationArgs as ph, taskShapeDigest as pi, Persona as pl, ProviderLeafOut as pm, AuthoredHarness as pn, S3PrivateCasStore as po, DriverContractState as pp, WorkerCancellation as pr, printBenchmarkReport as ps, CoordinationToolsOptions as pt, PursuitCostProvenance as pu, RouteWhen as pv, persistHarnessTranscript as px, createEventBus as py, SpawnPrior as q, WorktreeCheckRunner as q_, EvolutionStrategy as qa, TeamProgress as qb, PipelineStage as qc, RegisteredPrompt as qd, CoordinationReadAccess as qf, AxisScoresOf as qg, KnowledgeItem as qh, WidenGate as qi, runIsolatedCheck as ql, ToolLoopToolCall as qm, WorkerToolTraceArtifact as qn, verify as qo, Inbox as qp, InteractiveWorkerOptions as qr, CorpusReadbackOptions as qs, SandboxEvent$1 as qt, AuthorizedSpawnContext as qu, PeerMailReadout as qv, LoopResult as qx, replaySpawnTree as qy, AgentBackendInput as r, OutputAdapter as rS, leaderboard as r_, chatWorkerSeam as ra, ConfigError as rb, AuthorStrategyOptions as rc, resolveWorkerSpawnRetry as rd, supervisorAgent as rf, DelegationTraceSpan as rg, detachedSessionDelegate as rh, graphDigest as ri, VerifySpec as rl, SharedWorkerIdentity as rm, SurfaceReadBox as rn, OpenSandboxRunPromptOptions as ro, ContinuationAppend as rp, SearchSpec as rr, McpEnvironmentOptions as rs, RootStreamReceipt as rt, assertPursuitVersions as ru, ManagerWake as rv, StartRetainedInteractiveRunOptions as rx, JsonRpcMessage as ry, AgentRuntimeEventSink as s, ValidationCtx as sS, renderLeaderboardSvg as s_, ProfileRichnessThresholds as sa, AgentSpec as sb, StrategyArtifacts as sc, SuperviseRegistryTable as sd, DriveHarness as sf, FileDelegationStore as sg, SiblingSandboxExecutorOptions as sh, listGraphRuns as si, WidenSpec as sl, sharedWorkerClientName as sm, boxSurfaceReader as sn, openSandboxRun as so, ContinuationPanelResult as sp, compileSearchSpec as sr, BenchmarkConfig as ss, DriverContinuationRecord as st, SupervisedPursuitResult as su, GateDecision as sv, HarnessTranscriptFile as sx, McpTransport as sy, AgentAdapter as t, MountManifestEntry as tS, ProfileKeyOf as t_, ChatWorkerSeamOptions as ta, AgentEvalErrorCode as tb, runAgentic as tc, WorkerSpawnRetryPolicy as td, naiveContinuationPrompt as tf, createPropagatingTraceEmitter as tg, DetachedWinnerSelection as th, StoredGraph as ti, TrajectoryReportOptions as tl, SharedBoxPlacementOptions as tm, HarvestSurfaceDiffsOptions as tn, OpenSandboxRunBeforeStartContext as to, PriorCoordination as tp, CompiledSearchSpec as tr, observationFromRegistry as ts, ProviderModelExecutionEvidence as tt, VersionJudge as tu, LeadMessage as tv, RetainedInteractiveRunHandle as tx, peerMailTools as ty, AgentTaskSpec as u, RuntimeRunCost as uS, AnytimeStrategySummary as u_, defaultProfileRichnessThresholds as ua, ExecutorRegistry as ub, adaptiveRefine as uc, SeatSelectionInput as ud, ResolveDriveHarness as uf, CoderTask as ug, DetachedTurn as uh, pickBestGraph as ui, DefinePersonaInput as ul, createAgentEnvironmentProviderRegistry as um, AnalystAuthoring as un, createSandboxLineage as uo, PanelFinding as up, settledToIteration as ur, BenchmarkStrategySummary as us, BlockedToolReport as ut, PursuitFork as uu, RouteFlow as uv, ReadableEnvironment as ux, BusStats as uy, RunAgentTaskStreamOptions as v, NativeContextContinuationHandle as vS, WaterfallReport as v_, CheckSourceCtx as va, MaterializedModelIdentity as vb, HarvestError as vc, createFileRunContext as vd, ManagerWakePolicy as vf, CompletionAnalyst as vg, DelegationRunContext as vh, freeSlots as vi, ShapeBudget as vl, BridgeHarnessStore as vm, createWorktreeCliExecutor as vn, startRetainedRun as vo, SpawnResourceBytes as vp, legacySupervisorRunDir as vr, SuperviseDispatchOptions as vs, SettledWorker as vt, PursuitNodeUsage as vu, QuestionEscalationOutcome as vv, RetainedHarnessTranscriptDescriptor as vx, AnalystFindingEvent as vy, RuntimeFailureCode as w, RetainedInteractiveAdmission as wS, SandboxEvidenceReceipt as w_, VisibleCheck as wa, Executor as wb, ObservationError as wc, SupervisorSpanRecorder as wd, StopDecision as wf, sentinelCompletion as wg, DelegateCodeConfig as wh, graphDesignerExtraTools as wi, LeaderboardBenchScore as wl, mcpSecretEnvMetadataKey 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, QuestionRecord as wv, ProviderWorkspaceCaptureProvenance as wx, AuthoredAnalystDefinition as wy, RuntimeSessionStore as x, RecoverRetainedRunIntentOptions as xS, RunAgentRoundsOptions as x_, StructuralRolloutMessage as xa, RootMaterialization as xb, harvestCorpus as xc, SupervisorSpanAttributes as xd, NoProgressForOptions as xf, CompletionVerdict as xg, SubmitInput as xh, DesignerRunGraphEnv as xi, ProviderAsSandboxClientOptions as xl, KeyProvider as xm, WorkerInteractiveProviderSource as xn, claimRetainedInteractiveControl as xo, environmentReader as xp, readWorkerSteerRequests as xr, loopDispatch as xs, SpawnRefusal as xt, PursuitRunTotals as xu, QuestionLevel as xv, ProviderCheckpointCaptureContext as xx, AnalystRegistry$1 as xy, RuntimeCanonicalStreamEvent as y, NativeContextContinuationInput as yS, WaterfallSpan as y_, RepairStop as ya, NodeExecutionIdentity as yb, HarvestFailure as yc, createInMemoryRunContext as yd, SupervisorProfile as yf, CompletionEvidence as yg, DelegationTaskQueue as yh, queueOf as yi, ShapeContext as yl, BridgeModelCredential as ym, AttachWorkerOptions as yn, startRetainedRunInEnvironment as yo, SpawnResourceRead as yp, readWorkerCancellation as yr, SuperviseOptionsForDispatch as ys, SpawnPreflight as yt, PursuitProjection as yu, QuestionEscalationRecord as yv, resolveHarnessTranscriptCapture as yx, AnalystKind as yy, SpendGap as z, RetainedRunSnapshot as zS, RuntimeStreamEventSummary as z_, AgentTurnInput$1 as za, ToolStepInput as zb, FanoutSynthesis as zc, createBudgetPool as zd, DeliveredOutput as zf, CodeModeStore as zg, FeedbackRefersTo as zh, Supervisor as zi, declaredCheckDeliverable as zl, RouterTransportConfig as zm, WorkspaceCommit as zn, InMemoryCorpus as zo, RouterToolsSeam as zp, bestProfileFor as zr, connectStdioMcp as zs, CheckpointRequest as zt, TraversalContinuity as zu, MapTraversalEvent as zv, LoopDecisionPayload as zx, SpawnForest as zy };
|
|
19494
|
+
//# sourceMappingURL=types-DZ6L0Bv3.d.ts.map
|