@tangle-network/agent-runtime 0.126.0 → 0.131.0

package/dist/mcp/index.d.ts

@@ -1,10 +1,10 @@
-import { $c as ContinuationInstruction, $u as DelegationResumeDriver, Ad as FeedbackRating, Al as DelegateError, Au as coderTaskFromArgs, Bd as DelegationTraceCollector, Bu as DetachedTurn, Cd as DelegationHistoryResult, Cl as McpServerOptions, Cu as CoderReview, Dd as DelegationStatus, Dl as DELEGATE_INPUT_SCHEMA, Du as DetachedWinnerSelection, Ed as DelegationResultPayload, El as DELEGATE_DESCRIPTION, Eu as DetachedSessionDelegateOptions, Fd as UiAuditorDelegationOutput, Fu as FleetWorkspaceExecutorOptions, Gd as createDelegationTraceCollector, Gu as createDetachedTurnResumeDriver, Hd as buildDelegationTraceSpans, Hu as DriveTurnCapableBox, Id as CappedDelegationTrace, Iu as SiblingSandboxExecutorOptions, Jc as AnalystFindingEvent, Jd as DelegationStore, Ju as parseDetachedSessionRef, Kd as DelegationPersistenceError, Ku as detachedTurnEvents, Ld as DELEGATION_TRACE_MAX_BYTES, Lu as createFleetWorkspaceExecutor, Md as ResearchOutputShape, Ml as DelegateResult, Mu as settleDetachedCoderTurn, Nd as ResearchSource, Nl as createDelegateHandler, Nu as DelegationExecutor, Od as DelegationStatusArgs, Ol as DELEGATE_TOOL_NAME, Ou as SettleDetachedCoderTurnOptions, Pd as UiAuditLensFilter, Pl as validateDelegateArgs, Pu as FleetHandle, Qc as AuthorizedDownMessage, Qu as DelegationResumeContext, Rd as DELEGATION_TRACE_MAX_SPANS, Ru as createSiblingSandboxExecutor, Sd as DelegationHistoryEntry, Sl as McpServer, Su as CoderDelegate, Td as DelegationProgress, Tl as createMcpServer, Tu as DelegateRunCtx, Ud as capDelegationTrace, Uu as DriveTurnTick, Vd as DelegationTraceSpan, Vu as DetachedTurnResumeDriverOptions, Wd as composeLoopTraceEmitters, Wu as RunDetachedTurnOptions, Xd as FileDelegationStoreOptions, Xu as DelegationArgs, Yc as AnalystRegistry, Yd as FileDelegationStore, Yu as runDetachedTurn, Zc as AuthorizeDownMessage, Zd as InMemoryDelegationStore, Zu as DelegationRecord, _d as DelegateUiAuditResult, _l as WorkerSpawnContext, _u as McpTransport, ad as SubmitOutput, al as DownMessageDeliveryAttempt, au as CreateWorktreeOptions, bd as DelegationFeedbackSnapshot, bl as createCoordinationTools, bu as InMemoryFeedbackStore, cd as DelegateCodeConfig, cl as MakeWorkerAgent, cu as GitRunner, dd as DelegateFeedbackResult, dl as QuestionLevel, du as captureWorktreeDiff, ed as DelegationResumeTick, el as CoordinationEvent, fd as DelegateResearchArgs, fl as QuestionOption, fu as createWorktree, gd as DelegateUiAuditConfig, gl as SettledWorker, gu as McpToolDescriptor, hd as DelegateUiAuditArgs, hl as QuestionUrgency, hu as JsonRpcResponse, id as SubmitInput, il as DownMessageAuthorizationInput, jd as FeedbackRefersTo, jl as DelegateHandlerOptions, ju as detachedSessionDelegate, kd as DelegationStatusResult, kl as DelegateArgs, ku as UiAuditorDelegate, ld as DelegateCodeResult, ll as Question, lu as RemoveWorktreeOptions, md as DelegateResearchResult, ml as QuestionRecord, mu as JsonRpcMessage, nd as DelegationTaskQueue, nl as CoordinationToolsOptions, od as hashIdempotencyInput, ol as DownMessageDeliveryOutcome, ou as DiffOptions, pd as DelegateResearchConfig, pl as QuestionPolicy, pu as removeWorktree, qd as DelegationStateCorruptError, qu as formatDetachedSessionRef, rd as DelegationTaskQueueOptions, rl as DEFAULT_AWAIT_EVENT_TIMEOUT_MS, sd as DelegateCodeArgs, sf as CoderOutput, sl as DownMessageEvent, su as DiffResult, td as DelegationRunContext, tl as CoordinationTools, ud as DelegateFeedbackArgs, ul as QuestionDecision, uu as WorktreeHandle, vd as DelegateUiAuditRoute, vl as WorkerWatchOptions, vu as FeedbackEvent, wd as DelegationProfile, wl as createInProcessTransport, wu as CoderReviewer, xd as DelegationHistoryArgs, xu as eventToSnapshot, yd as DelegationError, yu as FeedbackStore, zd as DelegationTraceCaps, zu as DetachedSessionRefParts } from "../index-EdjCQBV9.js";
-import { E as SandboxClient, h as LoopSandboxPlacement } from "../types-DnNGJ5Gz.js";
-import { Bt as mergeTraceEnv, Ht as traceContextToEnv, Rt as TraceContext, Vt as readTraceContextFromEnv, zt as createPropagatingTraceEmitter } from "../environment-provider-PM9PeW_J.js";
+import { E as SandboxClient, h as LoopSandboxPlacement } from "../types-ebIY0dMG.js";
+import { $l as McpTransport, $u as DelegateUiAuditResult, Ad as DelegationStore, Al as SettledWorker, Au as parseDetachedSessionRef, Bl as createMcpServer, Bu as SubmitInput, Cd as DelegationTraceSpan, Cl as Question, Cu as DetachedTurnResumeDriverOptions, Dd as createDelegationTraceCollector, Dl as QuestionPolicy, Du as createDetachedTurnResumeDriver, Ed as composeLoopTraceEmitters, El as QuestionOption, Eu as RunDetachedTurnOptions, Fl as createCoordinationTools, Fu as DelegationResumeDriver, Gl as DelegateError, Gu as DelegateCodeResult, Hl as DELEGATE_INPUT_SCHEMA, Hu as hashIdempotencyInput, Iu as DelegationResumeTick, Jl as createDelegateHandler, Ju as DelegateResearchArgs, Kl as DelegateHandlerOptions, Ku as DelegateFeedbackArgs, Ll as McpServer, Lu as DelegationRunContext, Md as FileDelegationStoreOptions, Ml as WorkerSpawnContext, Mu as DelegationArgs, Nd as InMemoryDelegationStore, Nl as WorkerWatchOptions, Nu as DelegationRecord, Od as DelegationPersistenceError, Ol as QuestionRecord, Ou as detachedTurnEvents, Pu as DelegationResumeContext, Ql as McpToolDescriptor, Qu as DelegateUiAuditConfig, Rl as McpServerOptions, Ru as DelegationTaskQueue, Sd as DelegationTraceCollector, Sl as MakeWorkerAgent, Su as DetachedTurn, Td as capDelegationTrace, Tl as QuestionLevel, Tu as DriveTurnTick, Ud as CoderOutput, Ul as DELEGATE_TOOL_NAME, Uu as DelegateCodeArgs, Vl as DELEGATE_DESCRIPTION, Vu as SubmitOutput, Wl as DelegateArgs, Wu as DelegateCodeConfig, Xl as JsonRpcMessage, Xu as DelegateResearchResult, Yl as validateDelegateArgs, Yu as DelegateResearchConfig, Zl as JsonRpcResponse, Zu as DelegateUiAuditArgs, _d as UiAuditorDelegationOutput, _l as DEFAULT_AWAIT_EVENT_TIMEOUT_MS, _u as FleetWorkspaceExecutorOptions, ad as DelegationHistoryResult, au as CoderReview, bd as DELEGATION_TRACE_MAX_SPANS, bl as DownMessageDeliveryOutcome, bu as createSiblingSandboxExecutor, cd as DelegationResultPayload, cl as AnalystRegistry, cu as DetachedSessionDelegateOptions, dd as DelegationStatusResult, dl as AuthorizedDownMessage, du as UiAuditorDelegate, ed as DelegateUiAuditRoute, eu as FeedbackEvent, fd as FeedbackRating, fl as ContinuationInstruction, fu as coderTaskFromArgs, gd as UiAuditLensFilter, gl as CoordinationToolsOptions, gu as FleetHandle, hd as ResearchSource, hl as CoordinationTools, hu as DelegationExecutor, id as DelegationHistoryEntry, iu as CoderDelegate, jd as FileDelegationStore, ju as runDetachedTurn, kd as DelegationStateCorruptError, kl as QuestionUrgency, ku as formatDetachedSessionRef, ld as DelegationStatus, lu as DetachedWinnerSelection, md as ResearchOutputShape, ml as CoordinationEvent, mu as settleDetachedCoderTurn, nd as DelegationFeedbackSnapshot, nu as InMemoryFeedbackStore, od as DelegationProfile, ou as CoderReviewer, pd as FeedbackRefersTo, pu as detachedSessionDelegate, ql as DelegateResult, qu as DelegateFeedbackResult, rd as DelegationHistoryArgs, ru as eventToSnapshot, sd as DelegationProgress, sl as AnalystFindingEvent, su as DelegateRunCtx, td as DelegationError, tu as FeedbackStore, ud as DelegationStatusArgs, ul as AuthorizeDownMessage, uu as SettleDetachedCoderTurnOptions, vd as CappedDelegationTrace, vl as DownMessageAuthorizationInput, vu as SiblingSandboxExecutorOptions, wd as buildDelegationTraceSpans, wl as QuestionDecision, wu as DriveTurnCapableBox, xd as DelegationTraceCaps, xl as DownMessageEvent, xu as DetachedSessionRefParts, yd as DELEGATION_TRACE_MAX_BYTES, yl as DownMessageDeliveryAttempt, yu as createFleetWorkspaceExecutor, zl as createInProcessTransport, zu as DelegationTaskQueueOptions } from "../index-CoO7atyo.js";
+import { at as mergeTraceEnv, it as createPropagatingTraceEmitter, ot as readTraceContextFromEnv, rt as TraceContext, st as traceContextToEnv } from "../types-C6Q-J0Dt.js";
 import { o as UiLens } from "../substrate-BcnuSHXm.js";
-import { a as LOCAL_HARNESSES, c as RunLocalHarnessOptions, d as parseCodexTokenUsage, f as runLocalHarness, i as DEFAULT_LOCAL_HARNESS, l as harnessSupportsReasoningEffort, n as CodexExecutionPolicy, o as LocalHarness, r as CodexTokenUsage, s as LocalHarnessResult, t as CodexExecutionEvidence, u as localHarnessExecutable } from "../local-harness-BIajef4A.js";
+import { A as LocalHarness, B as GitRunner, D as CodexTokenUsage, E as CodexExecutionPolicy, F as parseCodexTokenUsage, G as removeWorktree, H as WorktreeHandle, I as runLocalHarness, L as CreateWorktreeOptions, M as RunLocalHarnessOptions, N as harnessSupportsReasoningEffort, O as DEFAULT_LOCAL_HARNESS, P as localHarnessExecutable, R as DiffOptions, T as CodexExecutionEvidence, U as captureWorktreeDiff, V as RemoveWorktreeOptions, W as createWorktree, j as LocalHarnessResult, k as LOCAL_HARNESSES, z as DiffResult } from "../runtime-D-QfLbSd.js";
 import { a as KbGateResult, i as FactJudgeVerdict, n as FactCandidate, o as createKbGate, r as FactJudge, t as CreateKbGateOptions } from "../kb-gate-C8z2juK8.js";
-import { n as mcpToolsForRuntimeMcpSubset, t as mcpToolsForRuntimeMcp } from "../openai-tools-B68JaOCx.js";
+import { n as mcpToolsForRuntimeMcpSubset, t as mcpToolsForRuntimeMcp } from "../openai-tools-D3oMyVGl.js";
 import { AgentProfileMcpServer } from "@tangle-network/agent-interface";
 //#region src/mcp/codex-diagnostics.d.ts
 /** Bounded, credential-redacted process context attached when reproducible Codex output fails
@@ -62,8 +62,6 @@ declare function detectExecutor(args: DetectExecutorArgs): Promise<DelegationExe
 interface InProcessExecutorOptions {
   /** Absolute path to the git repo (the workspace). Worktrees go under `<repoRoot>/.agent-worktrees/`. */
   repoRoot: string;
-  /** Harnesses to round-robin across `create()` calls. One entry = no fanout. Default `['claude-code']`. */
-  harnesses?: ReadonlyArray<LocalHarness>;
   /** Optional per-delegation test command run in the worktree after the harness exits. */
   testCmd?: string;
   /** Optional per-delegation typecheck command. Same shape as `testCmd`. */
@@ -207,11 +205,11 @@ interface ResolvedMemoryEnv {
 declare function resolveMemoryFromEnv(env: Record<string, string | undefined>): ResolvedMemoryEnv;
 //#endregion
 //#region src/mcp/tools/delegate-feedback.d.ts
-/** MCP tool name for the `delegate_feedback` feedback-recording tool. @experimental */
+/** MCP tool name for the `delegate_feedback` feedback-recording tool. @stable */
 declare const DELEGATE_FEEDBACK_TOOL_NAME = "delegate_feedback";
-/** Human-readable description of the `delegate_feedback` MCP tool, injected into the tool manifest. @experimental */
+/** Human-readable description of the `delegate_feedback` MCP tool, injected into the tool manifest. @stable */
 declare const DELEGATE_FEEDBACK_DESCRIPTION: string;
-/** JSON Schema for `delegate_feedback` tool arguments (`refersTo`, `rating`, `by`, optional fields). @experimental */
+/** JSON Schema for `delegate_feedback` tool arguments (`refersTo`, `rating`, `by`, optional fields). @stable */
 declare const DELEGATE_FEEDBACK_INPUT_SCHEMA: {
   readonly type: "object";
   readonly properties: {
@@ -262,16 +260,16 @@ declare const DELEGATE_FEEDBACK_INPUT_SCHEMA: {
   readonly required: readonly ["refersTo", "rating", "by"];
   readonly additionalProperties: false;
 };
-/** Parse and validate raw MCP tool input into typed `DelegateFeedbackArgs`; throws `TypeError` on bad input. @experimental */
+/** Parse and validate raw MCP tool input into typed `DelegateFeedbackArgs`; throws `TypeError` on bad input. @stable */
 declare function validateDelegateFeedbackArgs(raw: unknown): DelegateFeedbackArgs;
-/** @experimental */
+/** @stable */
 interface DelegateFeedbackHandlerOptions {
   queue: DelegationTaskQueue;
   store: FeedbackStore;
   generateId?: () => string;
   now?: () => string;
 }
-/** Build the MCP tool handler that persists feedback events and attaches them to delegation records. @experimental */
+/** Build the MCP tool handler that persists feedback events and attaches them to delegation records. @stable */
 declare function createDelegateFeedbackHandler(options: DelegateFeedbackHandlerOptions): (raw: unknown) => Promise<DelegateFeedbackResult>;
 //#endregion
 //#region src/mcp/tools/delegate-ui-audit.d.ts
@@ -377,11 +375,11 @@ interface DelegateUiAuditHandlerOptions {
 declare function createDelegateUiAuditHandler(options: DelegateUiAuditHandlerOptions): (raw: unknown) => Promise<DelegateUiAuditResult>;
 //#endregion
 //#region src/mcp/tools/delegation-history.d.ts
-/** MCP tool name for the `delegation_history` read-past-delegations tool. @experimental */
+/** MCP tool name for the `delegation_history` read-past-delegations tool. @stable */
 declare const DELEGATION_HISTORY_TOOL_NAME = "delegation_history";
-/** Human-readable description of the `delegation_history` MCP tool, injected into the tool manifest. @experimental */
+/** Human-readable description of the `delegation_history` MCP tool, injected into the tool manifest. @stable */
 declare const DELEGATION_HISTORY_DESCRIPTION: string;
-/** JSON Schema for `delegation_history` tool arguments (optional `namespace`, `profile`, `since`, `limit`). @experimental */
+/** JSON Schema for `delegation_history` tool arguments (optional `namespace`, `profile`, `since`, `limit`). @stable */
 declare const DELEGATION_HISTORY_INPUT_SCHEMA: {
   readonly type: "object";
   readonly properties: {
@@ -404,21 +402,21 @@ declare const DELEGATION_HISTORY_INPUT_SCHEMA: {
   };
   readonly additionalProperties: false;
 };
-/** Parse and validate raw MCP tool input into typed `DelegationHistoryArgs`; throws `TypeError` on bad input. @experimental */
+/** Parse and validate raw MCP tool input into typed `DelegationHistoryArgs`; throws `TypeError` on bad input. @stable */
 declare function validateDelegationHistoryArgs(raw: unknown): DelegationHistoryArgs;
-/** @experimental */
+/** @stable */
 interface DelegationHistoryHandlerOptions {
   queue: DelegationTaskQueue;
 }
-/** Build the MCP tool handler that reads filtered past delegations from a `DelegationTaskQueue`. @experimental */
+/** Build the MCP tool handler that reads filtered past delegations from a `DelegationTaskQueue`. @stable */
 declare function createDelegationHistoryHandler(options: DelegationHistoryHandlerOptions): (raw: unknown) => Promise<DelegationHistoryResult>;
 //#endregion
 //#region src/mcp/tools/delegation-status.d.ts
-/** MCP tool name for the `delegation_status` synchronous-poll tool. @experimental */
+/** MCP tool name for the `delegation_status` synchronous-poll tool. @stable */
 declare const DELEGATION_STATUS_TOOL_NAME = "delegation_status";
-/** Human-readable description of the `delegation_status` MCP tool, injected into the tool manifest. @experimental */
+/** Human-readable description of the `delegation_status` MCP tool, injected into the tool manifest. @stable */
 declare const DELEGATION_STATUS_DESCRIPTION: string;
-/** JSON Schema for `delegation_status` tool arguments (`taskId` + optional `includeTrace`). @experimental */
+/** JSON Schema for `delegation_status` tool arguments (`taskId` + optional `includeTrace`). @stable */
 declare const DELEGATION_STATUS_INPUT_SCHEMA: {
   readonly type: "object";
   readonly properties: {
@@ -434,18 +432,14 @@ declare const DELEGATION_STATUS_INPUT_SCHEMA: {
   readonly required: readonly ["taskId"];
   readonly additionalProperties: false;
 };
-/** Parse and validate raw MCP tool input into typed `DelegationStatusArgs`; throws `TypeError` on bad input. @experimental */
+/** Parse and validate raw MCP tool input into typed `DelegationStatusArgs`; throws `TypeError` on bad input. @stable */
 declare function validateDelegationStatusArgs(raw: unknown): DelegationStatusArgs;
-/** @experimental */
+/** @stable */
 interface DelegationStatusHandlerOptions {
   queue: DelegationTaskQueue;
 }
-/** Build the MCP tool handler that polls a `DelegationTaskQueue` for task status. @experimental */
+/** Build the MCP tool handler that polls a `DelegationTaskQueue` for task status. @stable */
 declare function createDelegationStatusHandler(options: DelegationStatusHandlerOptions): (raw: unknown) => Promise<DelegationStatusResult>;
 //#endregion
-//#region src/mcp/index.d.ts
-/** @deprecated Use `McpToolDescriptor`; both names are the same protocol contract. */
-type StdioToolDescriptor = McpToolDescriptor;
-//#endregion
-export { type AgentMemorySpec, type AnalystFindingEvent, type AnalystRegistry, type AuthorizeDownMessage, type AuthorizedDownMessage, type CappedDelegationTrace, type CoderDelegate, type CoderOutput, type CoderReview, type CoderReviewer, CodexExecutionDiagnosticError, type CodexExecutionEvidence, type CodexExecutionFailureDiagnostic, type CodexExecutionPolicy, type CodexTokenUsage, type ContinuationInstruction, type CoordinationEvent, type CoordinationTools, type CoordinationToolsOptions, type CreateKbGateOptions, type CreateMemoryToolServerOptions, type CreateWorktreeOptions, DEFAULT_AWAIT_EVENT_TIMEOUT_MS, DEFAULT_LOCAL_HARNESS, DELEGATE_DESCRIPTION, DELEGATE_FEEDBACK_DESCRIPTION, DELEGATE_FEEDBACK_INPUT_SCHEMA, DELEGATE_FEEDBACK_TOOL_NAME, DELEGATE_INPUT_SCHEMA, DELEGATE_TOOL_NAME, DELEGATE_UI_AUDIT_DESCRIPTION, DELEGATE_UI_AUDIT_INPUT_SCHEMA, DELEGATE_UI_AUDIT_TOOL_NAME, DELEGATION_HISTORY_DESCRIPTION, DELEGATION_HISTORY_INPUT_SCHEMA, DELEGATION_HISTORY_TOOL_NAME, DELEGATION_STATUS_DESCRIPTION, DELEGATION_STATUS_INPUT_SCHEMA, DELEGATION_STATUS_TOOL_NAME, DELEGATION_TRACE_MAX_BYTES, DELEGATION_TRACE_MAX_SPANS, type DelegateArgs, type DelegateCodeArgs, type DelegateCodeConfig, type DelegateCodeResult, type DelegateError, type DelegateFeedbackArgs, type DelegateFeedbackHandlerOptions, type DelegateFeedbackResult, type DelegateHandlerOptions, type DelegateResearchArgs, type DelegateResearchConfig, type DelegateResearchResult, type DelegateResult, type DelegateRunCtx, type DelegateUiAuditArgs, type DelegateUiAuditConfig, type DelegateUiAuditHandlerOptions, type DelegateUiAuditResult, type DelegateUiAuditRoute, type DelegationArgs, type DelegationError, type DelegationExecutor, type DelegationFeedbackSnapshot, type DelegationHistoryArgs, type DelegationHistoryEntry, type DelegationHistoryHandlerOptions, type DelegationHistoryResult, DelegationPersistenceError, type DelegationProfile, type DelegationProgress, type DelegationRecord, type DelegationResultPayload, type DelegationResumeContext, type DelegationResumeDriver, type DelegationResumeTick, type DelegationRunContext, DelegationStateCorruptError, type DelegationStatus, type DelegationStatusArgs, type DelegationStatusHandlerOptions, type DelegationStatusResult, type DelegationStore, DelegationTaskQueue, type DelegationTaskQueueOptions, type DelegationTraceCaps, type DelegationTraceCollector, type DelegationTraceSpan, type DetachedSessionDelegateOptions, type DetachedSessionRefParts, type DetachedTurn, type DetachedTurnResumeDriverOptions, type DetachedWinnerSelection, type DetectExecutorArgs, type DiffOptions, type DiffResult, type DownMessageAuthorizationInput, type DownMessageDeliveryAttempt, type DownMessageDeliveryOutcome, type DownMessageEvent, type DriveTurnCapableBox, type DriveTurnTick, type FactCandidate, type FactJudge, type FactJudgeVerdict, type FeedbackEvent, type FeedbackRating, type FeedbackRefersTo, type FeedbackStore, FileDelegationStore, type FileDelegationStoreOptions, type FleetHandle, type FleetWorkspaceExecutorOptions, type GitRunner, InMemoryDelegationStore, InMemoryFeedbackStore, type InProcessExecutorDescribePlacement, type InProcessExecutorOptions, type JsonRpcMessage, type JsonRpcResponse, type KbGateResult, LOCAL_HARNESSES, type LocalHarness, type LocalHarnessResult, MEMORY_FILE_ENV, MEMORY_ITEMS_ENV, MEMORY_LOG_ENV, MEMORY_NAME_ENV, type MakeWorkerAgent, type McpServer, type McpServerOptions, type McpToolDescriptor, type McpTransport, type MemoryItem, type Question, type QuestionDecision, type QuestionLevel, type QuestionOption, type QuestionPolicy, type QuestionRecord, type QuestionUrgency, type RemoveWorktreeOptions, type ResearchOutputShape, type ResearchSource, type ResolvedMemoryEnv, type RunDetachedTurnOptions, type RunLocalHarnessOptions, type SettleDetachedCoderTurnOptions, type SettledWorker, type SiblingSandboxExecutorOptions, StdioToolDescriptor, type StdioToolServer, type StdioToolServerOptions, type SubmitInput, type SubmitOutput, type TraceContext, type UiAuditLensFilter, type UiAuditorDelegate, type UiAuditorDelegationOutput, type WorkerSpawnContext, type WorkerWatchOptions, type WorktreeHandle, buildDelegationTraceSpans, capDelegationTrace, captureWorktreeDiff, coderTaskFromArgs, composeLoopTraceEmitters, createCoordinationTools, createDelegateFeedbackHandler, createDelegateHandler, createDelegateUiAuditHandler, createDelegationHistoryHandler, createDelegationStatusHandler, createDelegationTraceCollector, createDetachedTurnResumeDriver, createFleetWorkspaceExecutor, createInProcessExecutor, createInProcessTransport, createKbGate, createMcpServer, createMemoryToolServer, createPropagatingTraceEmitter, createSiblingSandboxExecutor, createStdioToolServer, createWorktree, detachedSessionDelegate, detachedTurnEvents, detectExecutor, eventToSnapshot, formatDetachedSessionRef, harnessSupportsReasoningEffort, hashIdempotencyInput, localHarnessExecutable, mcpToolsForRuntimeMcp, mcpToolsForRuntimeMcpSubset, mergeTraceEnv, parseCodexTokenUsage, parseDetachedSessionRef, parseMemoryItems, readMemoryItemsFile, readTraceContextFromEnv, removeWorktree, resolveMemoryFromEnv, runDetachedTurn, runLocalHarness, settleDetachedCoderTurn, traceContextToEnv, validateDelegateArgs, validateDelegateFeedbackArgs, validateDelegateUiAuditArgs, validateDelegationHistoryArgs, validateDelegationStatusArgs };
+export { type AgentMemorySpec, type AnalystFindingEvent, type AnalystRegistry, type AuthorizeDownMessage, type AuthorizedDownMessage, type CappedDelegationTrace, type CoderDelegate, type CoderOutput, type CoderReview, type CoderReviewer, CodexExecutionDiagnosticError, type CodexExecutionEvidence, type CodexExecutionFailureDiagnostic, type CodexExecutionPolicy, type CodexTokenUsage, type ContinuationInstruction, type CoordinationEvent, type CoordinationTools, type CoordinationToolsOptions, type CreateKbGateOptions, type CreateMemoryToolServerOptions, type CreateWorktreeOptions, DEFAULT_AWAIT_EVENT_TIMEOUT_MS, DEFAULT_LOCAL_HARNESS, DELEGATE_DESCRIPTION, DELEGATE_FEEDBACK_DESCRIPTION, DELEGATE_FEEDBACK_INPUT_SCHEMA, DELEGATE_FEEDBACK_TOOL_NAME, DELEGATE_INPUT_SCHEMA, DELEGATE_TOOL_NAME, DELEGATE_UI_AUDIT_DESCRIPTION, DELEGATE_UI_AUDIT_INPUT_SCHEMA, DELEGATE_UI_AUDIT_TOOL_NAME, DELEGATION_HISTORY_DESCRIPTION, DELEGATION_HISTORY_INPUT_SCHEMA, DELEGATION_HISTORY_TOOL_NAME, DELEGATION_STATUS_DESCRIPTION, DELEGATION_STATUS_INPUT_SCHEMA, DELEGATION_STATUS_TOOL_NAME, DELEGATION_TRACE_MAX_BYTES, DELEGATION_TRACE_MAX_SPANS, type DelegateArgs, type DelegateCodeArgs, type DelegateCodeConfig, type DelegateCodeResult, type DelegateError, type DelegateFeedbackArgs, type DelegateFeedbackHandlerOptions, type DelegateFeedbackResult, type DelegateHandlerOptions, type DelegateResearchArgs, type DelegateResearchConfig, type DelegateResearchResult, type DelegateResult, type DelegateRunCtx, type DelegateUiAuditArgs, type DelegateUiAuditConfig, type DelegateUiAuditHandlerOptions, type DelegateUiAuditResult, type DelegateUiAuditRoute, type DelegationArgs, type DelegationError, type DelegationExecutor, type DelegationFeedbackSnapshot, type DelegationHistoryArgs, type DelegationHistoryEntry, type DelegationHistoryHandlerOptions, type DelegationHistoryResult, DelegationPersistenceError, type DelegationProfile, type DelegationProgress, type DelegationRecord, type DelegationResultPayload, type DelegationResumeContext, type DelegationResumeDriver, type DelegationResumeTick, type DelegationRunContext, DelegationStateCorruptError, type DelegationStatus, type DelegationStatusArgs, type DelegationStatusHandlerOptions, type DelegationStatusResult, type DelegationStore, DelegationTaskQueue, type DelegationTaskQueueOptions, type DelegationTraceCaps, type DelegationTraceCollector, type DelegationTraceSpan, type DetachedSessionDelegateOptions, type DetachedSessionRefParts, type DetachedTurn, type DetachedTurnResumeDriverOptions, type DetachedWinnerSelection, type DetectExecutorArgs, type DiffOptions, type DiffResult, type DownMessageAuthorizationInput, type DownMessageDeliveryAttempt, type DownMessageDeliveryOutcome, type DownMessageEvent, type DriveTurnCapableBox, type DriveTurnTick, type FactCandidate, type FactJudge, type FactJudgeVerdict, type FeedbackEvent, type FeedbackRating, type FeedbackRefersTo, type FeedbackStore, FileDelegationStore, type FileDelegationStoreOptions, type FleetHandle, type FleetWorkspaceExecutorOptions, type GitRunner, InMemoryDelegationStore, InMemoryFeedbackStore, type InProcessExecutorDescribePlacement, type InProcessExecutorOptions, type JsonRpcMessage, type JsonRpcResponse, type KbGateResult, LOCAL_HARNESSES, type LocalHarness, type LocalHarnessResult, MEMORY_FILE_ENV, MEMORY_ITEMS_ENV, MEMORY_LOG_ENV, MEMORY_NAME_ENV, type MakeWorkerAgent, type McpServer, type McpServerOptions, type McpToolDescriptor, type McpTransport, type MemoryItem, type Question, type QuestionDecision, type QuestionLevel, type QuestionOption, type QuestionPolicy, type QuestionRecord, type QuestionUrgency, type RemoveWorktreeOptions, type ResearchOutputShape, type ResearchSource, type ResolvedMemoryEnv, type RunDetachedTurnOptions, type RunLocalHarnessOptions, type SettleDetachedCoderTurnOptions, type SettledWorker, type SiblingSandboxExecutorOptions, type StdioToolServer, type StdioToolServerOptions, type SubmitInput, type SubmitOutput, type TraceContext, type UiAuditLensFilter, type UiAuditorDelegate, type UiAuditorDelegationOutput, type WorkerSpawnContext, type WorkerWatchOptions, type WorktreeHandle, buildDelegationTraceSpans, capDelegationTrace, captureWorktreeDiff, coderTaskFromArgs, composeLoopTraceEmitters, createCoordinationTools, createDelegateFeedbackHandler, createDelegateHandler, createDelegateUiAuditHandler, createDelegationHistoryHandler, createDelegationStatusHandler, createDelegationTraceCollector, createDetachedTurnResumeDriver, createFleetWorkspaceExecutor, createInProcessExecutor, createInProcessTransport, createKbGate, createMcpServer, createMemoryToolServer, createPropagatingTraceEmitter, createSiblingSandboxExecutor, createStdioToolServer, createWorktree, detachedSessionDelegate, detachedTurnEvents, detectExecutor, eventToSnapshot, formatDetachedSessionRef, harnessSupportsReasoningEffort, hashIdempotencyInput, localHarnessExecutable, mcpToolsForRuntimeMcp, mcpToolsForRuntimeMcpSubset, mergeTraceEnv, parseCodexTokenUsage, parseDetachedSessionRef, parseMemoryItems, readMemoryItemsFile, readTraceContextFromEnv, removeWorktree, resolveMemoryFromEnv, runDetachedTurn, settleDetachedCoderTurn, traceContextToEnv, validateDelegateArgs, validateDelegateFeedbackArgs, validateDelegateUiAuditArgs, validateDelegationHistoryArgs, validateDelegationStatusArgs };
 //# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.js

@@ -1,13 +1,15 @@
-import { u as ValidationError } from "../errors-DEAvWQPy.js";
-import { l as throwAbort, n as deleteBoxSafe, s as sleep, u as throwIfAborted } from "../util-MVgdwuIS.js";
-import { Ct as runWorktreeHarness, Dt as removeWorktree, Et as createWorktree, Gt as harnessSupportsReasoningEffort, Ht as DEFAULT_LOCAL_HARNESS, Jt as runLocalHarness, Kt as localHarnessExecutable, S as traceContextToEnv, Tt as captureWorktreeDiff, Ut as LOCAL_HARNESSES, Yt as CodexExecutionDiagnosticError, b as mergeTraceEnv, qt as parseCodexTokenUsage, x as readTraceContextFromEnv, y as createPropagatingTraceEmitter } from "../supervisor-DpjO0Gmy.js";
-import { S as runCoderChecks, tt as selectValidWinner } from "../runtime-BzXz7OjS.js";
-import { A as DELEGATE_DESCRIPTION, At as createSandboxForSpec, B as DELEGATION_TRACE_MAX_SPANS, C as createDelegateUiAuditHandler, D as DELEGATE_FEEDBACK_TOOL_NAME, E as DELEGATE_FEEDBACK_INPUT_SCHEMA, G as DelegationPersistenceError, H as capDelegationTrace, J as InMemoryDelegationStore, K as DelegationStateCorruptError, L as DelegationTaskQueue, M as DELEGATE_TOOL_NAME, Mt as runAgentRounds, N as createDelegateHandler, O as createDelegateFeedbackHandler, P as validateDelegateArgs, R as hashIdempotencyInput, S as DELEGATE_UI_AUDIT_TOOL_NAME, T as DELEGATE_FEEDBACK_DESCRIPTION, U as composeLoopTraceEmitters, V as buildDelegationTraceSpans, W as createDelegationTraceCollector, X as eventToSnapshot, Y as InMemoryFeedbackStore, _ as DELEGATION_HISTORY_TOOL_NAME, b as DELEGATE_UI_AUDIT_DESCRIPTION, c as createInProcessTransport, d as DELEGATION_STATUS_INPUT_SCHEMA, dt as DEFAULT_AWAIT_EVENT_TIMEOUT_MS, f as DELEGATION_STATUS_TOOL_NAME, g as DELEGATION_HISTORY_INPUT_SCHEMA, h as DELEGATION_HISTORY_DESCRIPTION, j as DELEGATE_INPUT_SCHEMA, k as validateDelegateFeedbackArgs, l as createMcpServer, m as validateDelegationStatusArgs, p as createDelegationStatusHandler, pt as createCoordinationTools, q as FileDelegationStore, u as DELEGATION_STATUS_DESCRIPTION, v as createDelegationHistoryHandler, w as validateDelegateUiAuditArgs, x as DELEGATE_UI_AUDIT_INPUT_SCHEMA, y as validateDelegationHistoryArgs, z as DELEGATION_TRACE_MAX_BYTES } from "../supervise-Ds8FtyI9.js";
+import { i as ConfigError, u as ValidationError } from "../errors-DEAvWQPy.js";
+import { l as throwAbort, n as deleteBoxSafe, s as sleep, u as throwIfAborted } from "../util-Bw6srryQ.js";
+import { t as assertExecutableAgentProfile } from "../model-policy-CqziaqS1.js";
+import { At as removeWorktree, Dt as runWorktreeHarness, Ft as parseCodexTokenUsage, It as CodexExecutionDiagnosticError, Mt as LOCAL_HARNESSES, Nt as harnessSupportsReasoningEffort, Ot as captureWorktreeDiff, Pt as localHarnessExecutable, Q as runAgentRounds, X as createSandboxForSpec, at as mergeTraceEnv, it as createPropagatingTraceEmitter, jt as DEFAULT_LOCAL_HARNESS, kt as createWorktree, ot as readTraceContextFromEnv, st as traceContextToEnv } from "../supervisor-CV6Jh28D.js";
+import { S as runCoderChecks, et as selectValidWinner } from "../runtime-hiAABiTk.js";
+import { $ as DELEGATION_TRACE_MAX_BYTES, A as DELEGATION_HISTORY_INPUT_SCHEMA, B as DELEGATE_FEEDBACK_INPUT_SCHEMA, C as createMcpServer, D as createDelegationStatusHandler, Dt as createCoordinationTools, E as DELEGATION_STATUS_TOOL_NAME, F as DELEGATE_UI_AUDIT_INPUT_SCHEMA, G as DELEGATE_INPUT_SCHEMA, H as createDelegateFeedbackHandler, I as DELEGATE_UI_AUDIT_TOOL_NAME, J as validateDelegateArgs, K as DELEGATE_TOOL_NAME, L as createDelegateUiAuditHandler, M as createDelegationHistoryHandler, N as validateDelegationHistoryArgs, O as validateDelegationStatusArgs, P as DELEGATE_UI_AUDIT_DESCRIPTION, Q as hashIdempotencyInput, R as validateDelegateUiAuditArgs, S as createInProcessTransport, T as DELEGATION_STATUS_INPUT_SCHEMA, Tt as DEFAULT_AWAIT_EVENT_TIMEOUT_MS, U as validateDelegateFeedbackArgs, V as DELEGATE_FEEDBACK_TOOL_NAME, W as DELEGATE_DESCRIPTION, Z as DelegationTaskQueue, at as DelegationPersistenceError, ct as InMemoryDelegationStore, et as DELEGATION_TRACE_MAX_SPANS, it as createDelegationTraceCollector, j as DELEGATION_HISTORY_TOOL_NAME, k as DELEGATION_HISTORY_DESCRIPTION, lt as InMemoryFeedbackStore, nt as capDelegationTrace, ot as DelegationStateCorruptError, q as createDelegateHandler, rt as composeLoopTraceEmitters, st as FileDelegationStore, tt as buildDelegationTraceSpans, ut as eventToSnapshot, w as DELEGATION_STATUS_DESCRIPTION, z as DELEGATE_FEEDBACK_DESCRIPTION } from "../supervise-iPN27pO0.js";
 import { t as createStdioToolServer } from "../tool-server-RcWgLIsL.js";
 import { t as createKbGate } from "../kb-gate-DpaSwXVx.js";
-import { n as mcpToolsForRuntimeMcpSubset, t as mcpToolsForRuntimeMcp } from "../openai-tools-Bp1KSkP6.js";
+import { n as mcpToolsForRuntimeMcpSubset, t as mcpToolsForRuntimeMcp } from "../openai-tools-ru75mLjq.js";
 import { t as coderTaskToPrompt } from "../coder-yhVWbdWc.js";
-import { a as createMemoryToolServer, c as resolveMemoryFromEnv, i as MEMORY_NAME_ENV, n as MEMORY_ITEMS_ENV, o as parseMemoryItems, r as MEMORY_LOG_ENV, s as readMemoryItemsFile, t as MEMORY_FILE_ENV } from "../memory-server-DL6cE2Ag.js";
+import { a as createMemoryToolServer, c as resolveMemoryFromEnv, i as MEMORY_NAME_ENV, n as MEMORY_ITEMS_ENV, o as parseMemoryItems, r as MEMORY_LOG_ENV, s as readMemoryItemsFile, t as MEMORY_FILE_ENV } from "../memory-server-5HEJH672.js";
+import { agentProfileSchema } from "@tangle-network/agent-interface";
 import { randomUUID } from "node:crypto";
 //#region src/mcp/executor.ts
 /**
@@ -99,7 +101,7 @@ function readId(box) {
 * carries the local coding-harness CLIs (claude / codex / opencode), delegations spawn the harness
 * AS A SUBPROCESS against a git worktree on the SAME filesystem instead of provisioning a sibling
 * sandbox. Zero provisioning latency; worker diffs land in-place; multi-harness fanout = N parallel
-* subprocesses in N parallel worktrees (round-robin `harnesses`).
+* subprocesses in N parallel worktrees. Each authored profile selects its own harness.
 *
 * This is a THIN adapter over `runWorktreeHarness` (`./worktree-harness`) — the SAME core the
 * `Scope` leaf `createWorktreeCliExecutor` uses. It only adapts the core to the `SandboxClient`
@@ -123,7 +125,6 @@ const DEFAULT_POSTCHECK_TIMEOUT_MS = 120 * 1e3;
 * @experimental
 */
 function createInProcessExecutor(options) {
-	const harnesses = options.harnesses && options.harnesses.length > 0 ? [...options.harnesses] : [DEFAULT_LOCAL_HARNESS];
 	const runPostCheck = options.runPostCheck ?? defaultRunPostCheck;
 	const runCommand = async ({ command, cwd, signal }) => {
 		try {
@@ -139,26 +140,30 @@ function createInProcessExecutor(options) {
 			};
 		}
 	};
-	let callIndex = 0;
 	return {
 		client: {
 			async create(opts) {
+				const rawProfile = (opts?.backend)?.profile;
+				if (rawProfile === void 0) throw new ConfigError("in-process executor: backend.profile is required and must select the exact harness, provider, and model");
+				const profile = agentProfileSchema.parse(rawProfile);
+				assertExecutableAgentProfile(profile, "in-process executor");
+				const harness = profile.harness;
+				if (!LOCAL_HARNESSES.includes(harness)) throw new ConfigError(`in-process executor: AgentProfile.harness ${JSON.stringify(harness)} is not a local harness; expected ${LOCAL_HARNESSES.join(", ")}`);
+				if (opts?.backend?.type !== void 0 && opts.backend.type !== harness) throw new ConfigError(`in-process executor: backend.type ${JSON.stringify(opts.backend.type)} conflicts with AgentProfile.harness ${JSON.stringify(harness)}`);
+				const localHarness = harness;
 				const runId = randomUUID();
-				const harness = harnesses[callIndex % harnesses.length];
-				callIndex += 1;
-				const profile = (opts?.backend)?.profile ?? { name: `in-process-${harness}` };
 				return {
 					id: `in-process-${runId}`,
 					__inProcess: {
 						runId,
-						harness
+						harness: localHarness
 					},
 					async *streamPrompt(message, promptOpts) {
 						const taskPrompt = typeof message === "string" ? message : message.map((p) => typeof p === "object" && p && "text" in p ? String(p.text) : "").join("\n");
 						const run = await runWorktreeHarness({
 							repoRoot: options.repoRoot,
 							profile,
-							harness,
+							harness: localHarness,
 							taskPrompt,
 							runId,
 							harnessTimeoutMs: options.harnessTimeoutMs ?? DEFAULT_HARNESS_TIMEOUT_MS,
@@ -176,9 +181,9 @@ function createInProcessExecutor(options) {
 								type: "in_process.harness.started",
 								data: {
 									runId,
-									harness,
+									harness: localHarness,
 									worktreePath: run.worktree.path,
-									command: harness
+									command: localHarness
 								}
 							};
 							const h = run.result.harness;
@@ -199,7 +204,7 @@ function createInProcessExecutor(options) {
 								data: {
 									result: run.result,
 									source: "in-process-executor",
-									harness,
+									harness: localHarness,
 									runId
 								}
 							};
@@ -222,7 +227,7 @@ function createInProcessExecutor(options) {
 		},
 		placement: "in-process",
 		describe() {
-			return `in-process (repoRoot=${options.repoRoot}, harnesses=[${harnesses.join(",")}]${options.testCmd ? `, testCmd="${options.testCmd}"` : ""}${options.typecheckCmd ? `, typecheckCmd="${options.typecheckCmd}"` : ""})`;
+			return `in-process (repoRoot=${options.repoRoot}, harness=profile-selected${options.testCmd ? `, testCmd="${options.testCmd}"` : ""}${options.typecheckCmd ? `, typecheckCmd="${options.typecheckCmd}"` : ""})`;
 		}
 	};
 }
@@ -289,7 +294,6 @@ async function detectExecutor(args) {
 		if (!repoRoot) throw new Error("agent-runtime-mcp: AGENT_RUNTIME_IN_SANDBOX=1 requires AGENT_RUNTIME_REPO_ROOT to point at the workspace root");
 		return createInProcessExecutor({
 			repoRoot,
-			harnesses: parseHarnesses(env.AGENT_RUNTIME_LOCAL_HARNESSES),
 			testCmd: env.AGENT_RUNTIME_TEST_CMD?.trim() || void 0,
 			typecheckCmd: env.AGENT_RUNTIME_TYPECHECK_CMD?.trim() || void 0
 		});
@@ -301,13 +305,6 @@ async function detectExecutor(args) {
 		excludeMachineIds: parseList(env.TANGLE_FLEET_EXCLUDE_MACHINES)
 	});
 }
-function parseHarnesses(raw) {
-	if (!raw) return void 0;
-	const parts = raw.split(",").map((s) => s.trim()).filter(Boolean);
-	if (parts.length === 0) return void 0;
-	for (const part of parts) if (!LOCAL_HARNESSES.includes(part)) throw new Error(`agent-runtime-mcp: AGENT_RUNTIME_LOCAL_HARNESSES contains unknown harness "${part}". Expected: ${LOCAL_HARNESSES.join(", ")}.`);
-	return parts;
-}
 async function defaultResolveFleet(sandboxClient, fleetId) {
 	const fleets = sandboxClient.fleets;
 	if (!fleets || typeof fleets.get !== "function") throw new Error("agent-runtime-mcp: the configured sandbox client does not expose `.fleets.get`; upgrade @tangle-network/sandbox to >= 0.2.1 or unset TANGLE_FLEET_ID.");
@@ -330,38 +327,32 @@ function parseList(raw) {
 }
 //#endregion
 //#region src/mcp/detached-coder.ts
-const DEFAULT_MAX_DIFF_LINES = 400;
 /**
-* The minimal default worker profile (§1.5: the system authors profiles — there is no hardcoded
-* coder). Model-only by construction: no skills, no tool grants, no standing prompt. Callers that
-* want a richer worker pass their own `AgentProfile` via `CoderRunSpecOptions.profile`. `harness` /
-* `model` / `systemPrompt` are layered onto whichever profile is used.
+*
+* Sandbox-session coder decode layer. The sandbox-session delegate (`./delegates`) and the
+* cross-restart resume driver run the in-box harness over a `SandboxClient` and need to
+* (a) build an `AgentRunSpec` from the caller-authored exact worker
+* profile, (b) decode the harness event stream into a structured `CoderOutput`, and (c) gate it with
+* the shared mechanical checks. This sandbox-session path is kept separate from the generic recursive
+* path: `worktreeFanout` instead settles the raw `WorktreePatchArtifact` and gates via
+* `patchDelivered`. Prefer `worktreeFanout` / `worktreeLoopRunner` for NEW local-repo coding.
+*
+* The decode tolerates two `result`-event shapes:
+*   1. the in-process executor's raw worktree-harness result (`{ branch, patch, stats, checks }`),
+*      projected onto `CoderOutput`; and
+*   2. an LLM-emitted JSON block (`{ branch, patch, testResult, typecheckResult, diffStats }`),
+*      lifted onto `data.result` or scanned out of the assistant transcript (any harness shape).
+*
+* @experimental
 */
-function minimalCoderProfile() {
-	return { name: "coder" };
-}
-/** Build the authored `AgentProfile` for one harness on the sandbox-session path: the caller's
-*  profile (or the minimal model-only default), with the per-run harness/model/prompt overrides. */
-function coderRunProfile(options) {
-	const harness = options.harness ?? "claude-code";
-	const name = options.name ?? `coder-${harness}`;
-	const base = options.profile ?? minimalCoderProfile();
-	return {
-		...base,
-		name,
-		...options.systemPrompt ? { prompt: { systemPrompt: options.systemPrompt } } : {},
-		model: options.model ? { default: options.model } : base.model,
-		metadata: {
-			...base.metadata,
-			backendType: harness
-		}
-	};
-}
+const DEFAULT_MAX_DIFF_LINES = 400;
 /** @experimental Build the `AgentRunSpec<CoderTask>` the sandbox-session `runAgentRounds` path drives. */
-function coderRunSpec(options = {}) {
+function coderRunSpec(options) {
+	const profile = agentProfileSchema.parse(options.profile);
+	assertExecutableAgentProfile(profile, "coderRunSpec");
 	return {
-		name: options.name ?? `coder-${options.harness ?? "claude-code"}`,
-		profile: coderRunProfile(options),
+		name: options.name ?? profile.name,
+		profile,
 		taskToPrompt: coderTaskToPrompt
 	};
 }
@@ -373,18 +364,9 @@ const coderOutputAdapter = { parse: parseCoderEvents };
 *
 * @experimental
 */
-function multiHarnessCoderFanout(options = {}) {
-	const harnesses = options.harnesses && options.harnesses.length > 0 ? options.harnesses : [
-		"claude-code",
-		"codex",
-		"opencode/zai-coding-plan/glm-5.1"
-	];
-	const models = options.models ?? [];
-	const agentRuns = harnesses.map((harness, i) => coderRunSpec({
-		...options.profile ? { profile: options.profile } : {},
-		harness,
-		model: models[i]
-	}));
+function multiHarnessCoderFanout(options) {
+	if (!options.profiles || options.profiles.length === 0) throw new ConfigError("multiHarnessCoderFanout: at least one exact profile is required");
+	const agentRuns = options.profiles.map((profile) => coderRunSpec({ profile }));
 	return {
 		agentRuns,
 		output: coderOutputAdapter,
@@ -717,7 +699,7 @@ async function runDetachedTurn(options) {
 * the trace sinks (OTEL exporter, delegation journal) observe detached work
 * exactly like a streamed `runAgentRounds` run. `runId` = the deterministic session
 * id; cost/token figures are structurally unavailable on the `driveTurn`
-* surface and emitted as 0 under the `'detached-turn'` driver tag.
+* surface, so zero observed subtotals carry explicit unknown flags.
 */
 function createDetachedTurnTrace(options) {
 	const emitter = options.traceEmitter;
@@ -782,7 +764,13 @@ function createDetachedTurnTrace(options) {
 					iterationIndex: 0,
 					agentRunName,
 					costUsd: 0,
+					costUsdKnown: false,
 					durationMs: endMs - startMs,
+					tokenUsage: {
+						input: 0,
+						output: 0,
+						tokensKnown: false
+					},
 					...error !== void 0 ? { error } : {}
 				}
 			});
@@ -793,6 +781,7 @@ function createDetachedTurnTrace(options) {
 				payload: {
 					...error === void 0 ? { winnerIterationIndex: 0 } : {},
 					totalCostUsd: 0,
+					costUsdKnown: false,
 					durationMs: endMs - startMs,
 					iterations: 1
 				}
@@ -891,26 +880,26 @@ function createDetachedTurnResumeDriver(options) {
 * @experimental
 */
 function detachedSessionDelegate(options) {
+	if (!options.workerProfile) throw new ConfigError("detachedSessionDelegate: workerProfile is required");
+	const workerProfile = coderRunSpec({ profile: options.workerProfile }).profile;
+	const fanoutProfiles = options.fanoutProfiles?.map((profile) => coderRunSpec({ profile }).profile);
+	if (fanoutProfiles?.length === 0) throw new ConfigError("detachedSessionDelegate: fanoutProfiles must not be empty");
 	const executor = resolveExecutor(options);
 	const sandboxClient = executor.client;
-	const fanoutHarnesses = options.fanoutHarnesses;
 	const maxConcurrency = options.maxConcurrency ?? 4;
 	const traceEmitter = options.traceEmitter;
 	return async (args, ctx) => {
 		const task = coderTaskFromArgs(args);
 		const variants = Math.max(1, Math.trunc(args.variants ?? 1));
+		const selectedFanoutProfiles = variants <= 1 ? void 0 : fanoutProfiles ?? Array.from({ length: variants }, () => workerProfile);
+		if (selectedFanoutProfiles && selectedFanoutProfiles.length < variants) throw new ConfigError(`detachedSessionDelegate: ${variants} variants requested but only ${selectedFanoutProfiles.length} exact fanout profiles were configured`);
 		const loopEmitter = composeLoopTraceEmitters(traceEmitter, ctx.traceEmitter);
 		ctx.report({
 			iteration: 0,
 			phase: "starting"
 		});
 		if (variants <= 1) {
-			const agentRunSpec = coderRunSpec({
-				...options.workerProfile ? { profile: options.workerProfile } : {},
-				...options.harness ? { harness: options.harness } : {},
-				...options.model ? { model: options.model } : {},
-				...options.systemPrompt ? { systemPrompt: options.systemPrompt } : {}
-			});
+			const agentRunSpec = coderRunSpec({ profile: workerProfile });
 			const output = coderOutputAdapter;
 			const validator = createCoderValidator(task);
 			if (ctx.detachedSessionRef !== void 0 && ctx.updateDetachedSessionRef) {
@@ -935,8 +924,6 @@ function detachedSessionDelegate(options) {
 					task,
 					sessionId,
 					signal: ctx.signal,
-					...options.harness ? { harness: options.harness } : {},
-					...options.model ? { model: options.model } : {},
 					...options.reviewer ? { reviewer: options.reviewer } : {}
 				});
 				ctx.report({
@@ -972,11 +959,7 @@ function detachedSessionDelegate(options) {
 			});
 			return chosen;
 		}
-		const fanout = multiHarnessCoderFanout({
-			...options.workerProfile ? { profile: options.workerProfile } : {},
-			...fanoutHarnesses && fanoutHarnesses.length > 0 ? { harnesses: fanoutHarnesses.slice(0, variants) } : {},
-			...options.fanoutModels ? { models: options.fanoutModels.slice(0, variants) } : {}
-		});
+		const fanout = multiHarnessCoderFanout({ profiles: selectedFanoutProfiles.slice(0, variants) });
 		const agentRuns = fanout.agentRuns.slice(0, variants);
 		const chosen = await pickCoderWinner({
 			iterations: (await runAgentRounds({
@@ -1136,6 +1119,6 @@ const singleShotDriver = {
 	}
 };
 //#endregion
-export { CodexExecutionDiagnosticError, DEFAULT_AWAIT_EVENT_TIMEOUT_MS, DEFAULT_LOCAL_HARNESS, DELEGATE_DESCRIPTION, DELEGATE_FEEDBACK_DESCRIPTION, DELEGATE_FEEDBACK_INPUT_SCHEMA, DELEGATE_FEEDBACK_TOOL_NAME, DELEGATE_INPUT_SCHEMA, DELEGATE_TOOL_NAME, DELEGATE_UI_AUDIT_DESCRIPTION, DELEGATE_UI_AUDIT_INPUT_SCHEMA, DELEGATE_UI_AUDIT_TOOL_NAME, DELEGATION_HISTORY_DESCRIPTION, DELEGATION_HISTORY_INPUT_SCHEMA, DELEGATION_HISTORY_TOOL_NAME, DELEGATION_STATUS_DESCRIPTION, DELEGATION_STATUS_INPUT_SCHEMA, DELEGATION_STATUS_TOOL_NAME, DELEGATION_TRACE_MAX_BYTES, DELEGATION_TRACE_MAX_SPANS, DelegationPersistenceError, DelegationStateCorruptError, DelegationTaskQueue, FileDelegationStore, InMemoryDelegationStore, InMemoryFeedbackStore, LOCAL_HARNESSES, MEMORY_FILE_ENV, MEMORY_ITEMS_ENV, MEMORY_LOG_ENV, MEMORY_NAME_ENV, buildDelegationTraceSpans, capDelegationTrace, captureWorktreeDiff, coderTaskFromArgs, composeLoopTraceEmitters, createCoordinationTools, createDelegateFeedbackHandler, createDelegateHandler, createDelegateUiAuditHandler, createDelegationHistoryHandler, createDelegationStatusHandler, createDelegationTraceCollector, createDetachedTurnResumeDriver, createFleetWorkspaceExecutor, createInProcessExecutor, createInProcessTransport, createKbGate, createMcpServer, createMemoryToolServer, createPropagatingTraceEmitter, createSiblingSandboxExecutor, createStdioToolServer, createWorktree, detachedSessionDelegate, detachedTurnEvents, detectExecutor, eventToSnapshot, formatDetachedSessionRef, harnessSupportsReasoningEffort, hashIdempotencyInput, localHarnessExecutable, mcpToolsForRuntimeMcp, mcpToolsForRuntimeMcpSubset, mergeTraceEnv, parseCodexTokenUsage, parseDetachedSessionRef, parseMemoryItems, readMemoryItemsFile, readTraceContextFromEnv, removeWorktree, resolveMemoryFromEnv, runDetachedTurn, runLocalHarness, settleDetachedCoderTurn, traceContextToEnv, validateDelegateArgs, validateDelegateFeedbackArgs, validateDelegateUiAuditArgs, validateDelegationHistoryArgs, validateDelegationStatusArgs };
+export { CodexExecutionDiagnosticError, DEFAULT_AWAIT_EVENT_TIMEOUT_MS, DEFAULT_LOCAL_HARNESS, DELEGATE_DESCRIPTION, DELEGATE_FEEDBACK_DESCRIPTION, DELEGATE_FEEDBACK_INPUT_SCHEMA, DELEGATE_FEEDBACK_TOOL_NAME, DELEGATE_INPUT_SCHEMA, DELEGATE_TOOL_NAME, DELEGATE_UI_AUDIT_DESCRIPTION, DELEGATE_UI_AUDIT_INPUT_SCHEMA, DELEGATE_UI_AUDIT_TOOL_NAME, DELEGATION_HISTORY_DESCRIPTION, DELEGATION_HISTORY_INPUT_SCHEMA, DELEGATION_HISTORY_TOOL_NAME, DELEGATION_STATUS_DESCRIPTION, DELEGATION_STATUS_INPUT_SCHEMA, DELEGATION_STATUS_TOOL_NAME, DELEGATION_TRACE_MAX_BYTES, DELEGATION_TRACE_MAX_SPANS, DelegationPersistenceError, DelegationStateCorruptError, DelegationTaskQueue, FileDelegationStore, InMemoryDelegationStore, InMemoryFeedbackStore, LOCAL_HARNESSES, MEMORY_FILE_ENV, MEMORY_ITEMS_ENV, MEMORY_LOG_ENV, MEMORY_NAME_ENV, buildDelegationTraceSpans, capDelegationTrace, captureWorktreeDiff, coderTaskFromArgs, composeLoopTraceEmitters, createCoordinationTools, createDelegateFeedbackHandler, createDelegateHandler, createDelegateUiAuditHandler, createDelegationHistoryHandler, createDelegationStatusHandler, createDelegationTraceCollector, createDetachedTurnResumeDriver, createFleetWorkspaceExecutor, createInProcessExecutor, createInProcessTransport, createKbGate, createMcpServer, createMemoryToolServer, createPropagatingTraceEmitter, createSiblingSandboxExecutor, createStdioToolServer, createWorktree, detachedSessionDelegate, detachedTurnEvents, detectExecutor, eventToSnapshot, formatDetachedSessionRef, harnessSupportsReasoningEffort, hashIdempotencyInput, localHarnessExecutable, mcpToolsForRuntimeMcp, mcpToolsForRuntimeMcpSubset, mergeTraceEnv, parseCodexTokenUsage, parseDetachedSessionRef, parseMemoryItems, readMemoryItemsFile, readTraceContextFromEnv, removeWorktree, resolveMemoryFromEnv, runDetachedTurn, settleDetachedCoderTurn, traceContextToEnv, validateDelegateArgs, validateDelegateFeedbackArgs, validateDelegateUiAuditArgs, validateDelegationHistoryArgs, validateDelegationStatusArgs };
 
 //# sourceMappingURL=index.js.map