@bastani/atomic 0.9.16-alpha.2 → 0.9.16-alpha.3

package/dist/builtin/workflows/src/runs/foreground/executor-stage-replay.ts

@@ -1,156 +0,0 @@
-import type { GraphFrontierTracker } from "../../engine/graph-inference.js";
-import type { EngineStageRuntimeOptions } from "../../engine/options.js";
-import { appendStageEnd, appendStageStart } from "../../shared/persistence-session-entries.js";
-import type { Store } from "../../shared/store.js";
-import type { StageSnapshot } from "../../shared/store-types.js";
-import { elapsedStageMs } from "../../shared/timing.js";
-import { stageReplayFields } from "./executor-lifecycle.js";
-import type { WorkflowExitCleanup } from "./executor-types.js";
-import type { InternalStageContext } from "./stage-runner.js";
-
-export function createReplayStageContext(input: {
-	readonly runId: string;
-	readonly name: string;
-	readonly stageId: string;
-	readonly stageSnapshot: StageSnapshot;
-	readonly replaySource: StageSnapshot;
-	readonly activeStore: Store;
-	readonly opts: EngineStageRuntimeOptions;
-	readonly tracker: GraphFrontierTracker;
-	readonly registerWorkflowExitCleanup: (stageId: string, cleanup: WorkflowExitCleanup) => () => void;
-	readonly workflowExitSkippedReason: (reason?: string) => string;
-	readonly throwIfWorkflowExitSelected: () => void;
-}): InternalStageContext {
-	const { runId, name, stageId, stageSnapshot, replaySource } = input;
-	let replayFinalized = false;
-	let unregisterWorkflowExitCleanup = (): void => {};
-	let stageStartEntryAppended = false;
-
-	const appendStageStartOnce = (): void => {
-		if (!input.opts.persistence || stageStartEntryAppended) return;
-		stageStartEntryAppended = true;
-		appendStageStart(input.opts.persistence, {
-			runId,
-			stageId,
-			name,
-			parentIds: stageSnapshot.parentIds,
-			...stageReplayFields(stageSnapshot),
-			ts: stageSnapshot.startedAt ?? Date.now(),
-		});
-	};
-
-	const appendReplayStageEnd = (): void => {
-		if (!input.opts.persistence) return;
-		appendStageEnd(input.opts.persistence, {
-			runId,
-			stageId,
-			status: stageSnapshot.status,
-			durationMs: stageSnapshot.durationMs ?? 0,
-			...(stageSnapshot.status === "completed" && stageSnapshot.result !== undefined
-				? { summary: stageSnapshot.result }
-				: {}),
-			...(stageSnapshot.skippedReason !== undefined ? { skippedReason: stageSnapshot.skippedReason } : {}),
-			...(stageSnapshot.sessionId !== undefined ? { sessionId: stageSnapshot.sessionId } : {}),
-			...(stageSnapshot.sessionFile !== undefined ? { sessionFile: stageSnapshot.sessionFile } : {}),
-			...stageReplayFields(stageSnapshot),
-		});
-	};
-
-	const finalizeReplayStage = (status: "completed" | "skipped", reason?: string): void => {
-		if (replayFinalized) return;
-		replayFinalized = true;
-		unregisterWorkflowExitCleanup();
-		stageSnapshot.status = status;
-		if (status === "skipped") {
-			delete stageSnapshot.result;
-			stageSnapshot.skippedReason = input.workflowExitSkippedReason(reason);
-		}
-		stageSnapshot.endedAt = Date.now();
-		stageSnapshot.durationMs = elapsedStageMs(stageSnapshot, stageSnapshot.endedAt);
-		input.activeStore.recordStageEnd(runId, stageSnapshot);
-		input.opts.onStageEnd?.(runId, stageSnapshot);
-		appendReplayStageEnd();
-		input.tracker.onSettle(stageId);
-	};
-
-	input.activeStore.recordStageStart(runId, stageSnapshot);
-	input.opts.onStageStart?.(runId, stageSnapshot);
-	appendStageStartOnce();
-	unregisterWorkflowExitCleanup = input.registerWorkflowExitCleanup(stageId, {
-		skipForWorkflowExit(reason?: string): void {
-			finalizeReplayStage("skipped", reason);
-		},
-	});
-
-	const replayResult = replaySource.result ?? "";
-	const replayText = async (): Promise<string> => {
-		await Promise.resolve();
-		input.throwIfWorkflowExitSelected();
-		finalizeReplayStage("completed");
-		return replayResult;
-	};
-	const rejectReplayMutation = (action: string): never => {
-		throw new Error(`atomic-workflows: replayed stage "${name}" cannot ${action}`);
-	};
-
-	return {
-		name,
-		prompt: replayText,
-		complete: replayText,
-		sendUserMessage: async () => rejectReplayMutation("send a user message"),
-		__sendUserMessage: async () => rejectReplayMutation("send a user message"),
-		steer: async () => rejectReplayMutation("steer"),
-		followUp: async () => rejectReplayMutation("follow up"),
-		subscribe: () => () => {},
-		__subscribeDeliveryActivity: () => () => {},
-		get sessionFile() {
-			return replaySource.sessionFile;
-		},
-		get sessionId() {
-			return replaySource.sessionId ?? "";
-		},
-		setModel: async () => rejectReplayMutation("set model"),
-		setThinkingLevel: () => rejectReplayMutation("set thinking level"),
-		cycleModel: async () => rejectReplayMutation("cycle model"),
-		cycleThinkingLevel: () => rejectReplayMutation("cycle thinking level"),
-		get agent() {
-			return undefined as never;
-		},
-		get model() {
-			return replaySource.model as never;
-		},
-		get thinkingLevel() {
-			return undefined as never;
-		},
-		get messages() {
-			return [] as never;
-		},
-		get isStreaming() {
-			return false;
-		},
-		navigateTree: async () => rejectReplayMutation("navigate conversation tree"),
-		compact: async () => rejectReplayMutation("compact"),
-		abortCompaction: () => rejectReplayMutation("abort compaction"),
-		abort: async () => rejectReplayMutation("abort"),
-		__dispose: async () => {},
-		__getLastAssistantText: () => replayResult,
-		getLastAssistantText: () => replayResult,
-		__ensureSession: async () => {},
-		__ensureSessionFromFile: async () => {},
-		__sealGeneration: () => {},
-		__closeGeneration: async () => {},
-		__sessionMeta: () => ({ sessionId: replaySource.sessionId, sessionFile: replaySource.sessionFile }),
-		__agentSession: () => undefined,
-		__pendingMessageCount: () => 0,
-		__modelFallbackMeta: () => ({
-			...(replaySource.model !== undefined ? { model: replaySource.model } : {}),
-			...(replaySource.fastMode === true ? { fastMode: replaySource.fastMode } : {}),
-			...(replaySource.attemptedModels !== undefined ? { attemptedModels: replaySource.attemptedModels } : {}),
-			...(replaySource.modelAttempts !== undefined ? { modelAttempts: replaySource.modelAttempts } : {}),
-		}),
-		__requestPause: async () => rejectReplayMutation("pause"),
-		__resume: async () => rejectReplayMutation("resume"),
-		__isPaused: () => false,
-		__structuredOutputFinalized: () => false,
-	};
-}

package/dist/builtin/workflows/src/runs/foreground/executor-stage-types.ts

@@ -1,72 +0,0 @@
-import type { EngineStageRuntimeOptions } from "../../engine/options.js";
-import type { RunBudgetController } from "../../engine/run-budget.js";
-import type { Store } from "../../shared/store.js";
-import type { StageNotice, StageSnapshot } from "../../shared/store-types.js";
-import type { StageContext } from "../../shared/types.js";
-import type { WorkflowFailure } from "../../shared/workflow-failures.js";
-import type { WorkflowExitManager } from "./executor-exit-manager.js";
-import type { StageScheduler } from "./executor-scheduler.js";
-import type { ParallelFailFastScope, StageSessionCheckpointOptions } from "./executor-types.js";
-import type { StageControlRegistry } from "./stage-control-registry.js";
-import type { InternalStageContext } from "./stage-runner.js";
-
-export interface StageMcpScope {
-	apply(): void;
-	clear(): void;
-}
-
-export type ResumeContinuationReason = "resume" | "queued-user-message" | "paused-queued-user-message";
-
-export interface LiveStageMutableState {
-	activeAskUserQuestionAnonymousCalls: number;
-	askUserQuestionObservedThisTurn: boolean;
-	chatAnswerObservedThisTurn: boolean;
-	resumeContinuationPending: false | ResumeContinuationReason;
-	suppressQueuedUserMessageContinuation: boolean;
-	waitingForStageChatTurn: boolean;
-	/** Wakes the executor so a paused idle stage-chat can drain released work. */
-	wakeWaitingForStageChatTurn: (() => void) | undefined;
-	liveHandleReleased: boolean;
-	stageClosedByWorkflowExit: boolean;
-	stageFinalized: boolean;
-	skippedForParallelFailFast: boolean;
-	stageControlDropped: boolean;
-}
-
-export interface LiveStageRuntime {
-	readonly runId: string;
-	readonly stageId: string;
-	readonly name: string;
-	readonly stageSnapshot: StageSnapshot;
-	readonly innerCtx: InternalStageContext;
-	readonly activeStore: Store;
-	readonly opts: EngineStageRuntimeOptions;
-	readonly stageRegistry: StageControlRegistry;
-	readonly scheduler: StageScheduler;
-	readonly signal: AbortSignal;
-	readonly exit: WorkflowExitManager;
-	readonly budget: RunBudgetController;
-	readonly classifyExecutorFailure: (error: unknown) => WorkflowFailure;
-	readonly mcpScope: StageMcpScope;
-	readonly stageFailFastScope?: ParallelFailFastScope;
-	readonly state: LiveStageMutableState;
-	unregisterStageHandle: () => void;
-	dropStageControlHandle: () => void;
-	unregisterWorkflowExitCleanup: () => void;
-	readonly captureStageSessionMeta: (options?: StageSessionCheckpointOptions) => Promise<void>;
-	readonly startStageSessionHeartbeat: () => void;
-	readonly drainStageSessionHeartbeat: () => Promise<void>;
-	readonly raceStageSessionHeartbeat: <T>(work: Promise<T>) => Promise<T>;
-	readonly applyModelFallbackMeta: (meta: ReturnType<InternalStageContext["__modelFallbackMeta"]>) => void;
-	readonly appendStageStartOnce: () => void;
-	readonly finalizeStageSnapshot: () => Promise<boolean>;
-	readonly releaseLiveHandle: () => Promise<void>;
-	readonly dropStageControlForCompletion: () => Promise<void>;
-	readonly markSkippedForParallelFailFast: () => void;
-	readonly parallelFailFastError: () => unknown;
-	readonly throwIfStageMutationBlocked: () => void;
-}
-
-export type StageContextWithMeta = StageContext & Pick<InternalStageContext, "__modelFallbackMeta">;
-
-export type StageNoticeInput = Omit<StageNotice, "id" | "ts">;

package/dist/builtin/workflows/src/runs/foreground/executor-task-context.ts

@@ -1,2 +0,0 @@
-export type { WorkflowTaskRunners } from "../../engine/primitives/task.js";
-export { createWorkflowTaskRunners } from "../../engine/primitives/task.js";

package/dist/builtin/workflows/src/runs/foreground/executor-task-prompts.ts

@@ -1,226 +0,0 @@
-import { existsSync } from "node:fs";
-import { isAbsolute, resolve } from "node:path";
-import type {
-	StageOptions,
-	StagePromptOptions,
-	WorkflowChainOptions,
-	WorkflowMaxOutput,
-	WorkflowParallelOptions,
-	WorkflowTaskContextInput,
-	WorkflowTaskOptions,
-	WorkflowTaskStep,
-} from "../../shared/types.js";
-
-export function normalizeTaskContexts(
-	previous: WorkflowTaskOptions["previous"],
-): Array<{ readonly name?: string; readonly text: string }> {
-	if (previous === undefined) return [];
-	const items = Array.isArray(previous) ? previous : [previous];
-	return items
-		.map((item: WorkflowTaskContextInput) => {
-			if (typeof item === "string") return { text: item };
-			return item.name ? { name: item.name, text: item.text } : { text: item.text };
-		})
-		.filter((item) => item.text.trim().length > 0);
-}
-
-export function renderTaskContext(contexts: readonly { readonly name?: string; readonly text: string }[]): string {
-	if (contexts.length === 0) return "";
-	if (contexts.length === 1 && contexts[0]?.name === undefined) return contexts[0]!.text;
-	return contexts
-		.map((context, index) => {
-			const label = context.name ?? `context-${index + 1}`;
-			return `--- ${label} ---\n${context.text}`;
-		})
-		.join("\n\n");
-}
-
-export function applyTaskContext(prompt: string, previous: WorkflowTaskOptions["previous"]): string {
-	const contexts = normalizeTaskContexts(previous);
-	if (contexts.length === 0) return prompt;
-
-	const lastPrevious = contexts[contexts.length - 1]?.text ?? "";
-	const rendered = renderTaskContext(contexts);
-	let next = prompt.replace(/\{previous\}/g, lastPrevious);
-
-	if (next !== prompt) return next;
-	next += `\n\n---\nContext:\n${rendered}`;
-	return next;
-}
-
-export function taskPrompt(options: WorkflowTaskOptions): string {
-	const prompt = options.prompt ?? options.task;
-	if (prompt === undefined) {
-		throw new Error("atomic-workflows: ctx.task requires options.prompt or options.task");
-	}
-	return prompt;
-}
-
-export function taskPrevious(options: WorkflowTaskOptions): WorkflowTaskOptions["previous"] {
-	return options.previous;
-}
-
-export type WorkflowTaskExecutionOptions = WorkflowTaskOptions & { chainDir?: string };
-
-export function resolveWorkflowPath(filePath: string, baseDir: string | undefined): string {
-	if (isAbsolute(filePath)) return filePath;
-	return resolve(baseDir ?? process.cwd(), filePath);
-}
-
-export function taskBaseDir(options: Pick<WorkflowTaskExecutionOptions, "chainDir" | "cwd">): string | undefined {
-	if (typeof options.chainDir === "string" && options.chainDir.trim().length > 0) {
-		return resolveWorkflowPath(options.chainDir, process.cwd());
-	}
-	if (typeof options.cwd === "string" && options.cwd.length > 0) {
-		return resolveWorkflowPath(options.cwd, process.cwd());
-	}
-	return undefined;
-}
-
-export function taskReadInstruction(options: WorkflowTaskExecutionOptions): string {
-	if (options.reads === false || options.reads === undefined || options.reads.length === 0) return "";
-	const baseDir = taskBaseDir(options);
-	const files = options.reads.map((file) => resolveWorkflowPath(file, baseDir));
-	const missing = files.find((file) => !existsSync(file));
-	if (missing !== undefined) {
-		throw new Error(`atomic-workflows: referenced artifact does not exist: ${missing}`);
-	}
-	return `[Read from: ${files.join(", ")}]\n\n`;
-}
-
-export function taskPromptOptions(options: WorkflowTaskExecutionOptions): StagePromptOptions | undefined {
-	const baseDir = taskBaseDir(options);
-	const promptOptions: StagePromptOptions = {
-		...(options.output !== undefined ? { output: options.output } : {}),
-		...(options.outputMode !== undefined ? { outputMode: options.outputMode } : {}),
-		...(baseDir !== undefined ? { cwd: baseDir } : options.cwd !== undefined ? { cwd: options.cwd } : {}),
-		...(options.maxOutput !== undefined ? { maxOutput: options.maxOutput } : {}),
-		...(options.artifacts !== undefined ? { artifacts: options.artifacts } : {}),
-		...(options.sessionDir !== undefined ? { sessionDir: options.sessionDir } : {}),
-	};
-	return Object.keys(promptOptions).length === 0 ? undefined : promptOptions;
-}
-
-export function taskStageOptions(options: WorkflowTaskExecutionOptions): StageOptions {
-	const {
-		prompt: _prompt,
-		task: _task,
-		previous: _previous,
-		chainDir: _chainDir,
-		output: _output,
-		outputMode: _outputMode,
-		reads: _reads,
-		worktree: _worktree,
-		gitWorktreeDir: _gitWorktreeDir,
-		baseBranch: _baseBranch,
-		maxOutput: _maxOutput,
-		artifacts: _artifacts,
-		...stageOptions
-	} = options;
-	return stageOptions;
-}
-
-export function taskOptionsFromStep(
-	step: WorkflowTaskStep,
-	prompt: string,
-	previous?: WorkflowTaskOptions["previous"],
-): WorkflowTaskOptions {
-	const { name: _name, prompt: _prompt, task: _task, previous: _previous, ...stepOptions } = step;
-	return previous === undefined ? { ...stepOptions, prompt } : { ...stepOptions, prompt, previous };
-}
-
-export function replaceTaskPlaceholder(prompt: string, task: string): string {
-	return prompt.replace(/\{task\}/g, task);
-}
-
-export function chainStepPrompt(step: WorkflowTaskStep, index: number): string {
-	return step.prompt ?? step.task ?? (index === 0 ? "{task}" : "{previous}");
-}
-
-export function parallelFallbackTask(steps: readonly WorkflowTaskStep[], options?: WorkflowParallelOptions): string {
-	if (options?.task !== undefined) return options.task;
-	for (const step of steps) {
-		const task = step.prompt ?? step.task;
-		if (task !== undefined) return task;
-	}
-	return "";
-}
-
-export function normalizeMaxOutput(maxOutput: WorkflowMaxOutput | undefined): Required<WorkflowMaxOutput> {
-	return {
-		bytes: maxOutput?.bytes ?? 200 * 1024,
-		lines: maxOutput?.lines ?? 5000,
-	};
-}
-
-function truncateByLines(text: string, maxLines: number): { text: string; truncated: boolean } {
-	if (!Number.isFinite(maxLines) || maxLines <= 0) return { text: "", truncated: text.length > 0 };
-	const lines = text.split(/\r?\n/);
-	if (lines.length <= maxLines) return { text, truncated: false };
-	return {
-		text: lines.slice(0, maxLines).join("\n"),
-		truncated: true,
-	};
-}
-
-function truncateByBytes(text: string, maxBytes: number): { text: string; truncated: boolean } {
-	if (!Number.isFinite(maxBytes) || maxBytes <= 0) return { text: "", truncated: text.length > 0 };
-	if (Buffer.byteLength(text, "utf8") <= maxBytes) return { text, truncated: false };
-
-	let low = 0;
-	let high = text.length;
-	while (low < high) {
-		const mid = Math.ceil((low + high) / 2);
-		if (Buffer.byteLength(text.slice(0, mid), "utf8") <= maxBytes) {
-			low = mid;
-		} else {
-			high = mid - 1;
-		}
-	}
-	return { text: text.slice(0, low), truncated: true };
-}
-
-export function structuredTaskOutputText(value: unknown): string {
-	if (typeof value === "string") return value;
-	try {
-		return JSON.stringify(value, null, 2);
-	} catch (error) {
-		throw new Error(
-			`atomic-workflows: structured task output is not JSON-serializable: ${error instanceof Error ? error.message : String(error)}`,
-		);
-	}
-}
-
-export function truncateTaskOutput(text: string, maxOutput: WorkflowMaxOutput | undefined): string {
-	const limits = normalizeMaxOutput(maxOutput);
-	const byLines = truncateByLines(text, limits.lines);
-	const byBytes = truncateByBytes(byLines.text, limits.bytes);
-	if (!byLines.truncated && !byBytes.truncated) return text;
-	return `${byBytes.text}\n\n[workflow output truncated; limits: ${limits.bytes} bytes, ${limits.lines} lines]`;
-}
-
-export function withoutUndefinedProperties<T extends object>(value: T): Partial<T> {
-	return Object.fromEntries(Object.entries(value).filter(([, field]) => field !== undefined)) as Partial<T>;
-}
-
-export function sharedTaskDefaultsFromOptions(
-	options: WorkflowChainOptions | WorkflowParallelOptions,
-): Partial<WorkflowTaskExecutionOptions> {
-	const {
-		task: _task,
-		concurrency: _concurrency,
-		failFast: _failFast,
-		...taskDefaults
-	} = options as WorkflowParallelOptions;
-	return withoutUndefinedProperties(taskDefaults);
-}
-
-export function taskWithSharedDefaults(
-	taskOptions: WorkflowTaskOptions,
-	options: WorkflowChainOptions | WorkflowParallelOptions,
-): WorkflowTaskExecutionOptions {
-	return {
-		...sharedTaskDefaultsFromOptions(options),
-		...withoutUndefinedProperties(taskOptions),
-	} as WorkflowTaskExecutionOptions;
-}

package/dist/builtin/workflows/src/runs/foreground/executor-types.ts

@@ -1,186 +0,0 @@
-import type { ToolAdmissionBoundary } from "../../engine/run-tool-admission-boundary.js";
-import type { ToolControlRegistry } from "../../engine/run-tool-control-registry.js";
-import type * as AuthoringContract from "../../shared/authoring-contract.js";
-import type { Store } from "../../shared/store.js";
-import type {
-	RunSnapshot,
-	RunStatus,
-	StageSnapshot,
-	ToolNodeSnapshot,
-	WorkflowOverlayAdapter,
-} from "../../shared/store-types.js";
-import type {
-	WorkflowExecutionMode,
-	WorkflowInputValues,
-	WorkflowMcpPort,
-	WorkflowModelCatalogPort,
-	WorkflowOutputValues,
-	WorkflowPersistencePort,
-	WorkflowRuntimeConfig,
-	WorkflowUIAdapter,
-} from "../../shared/types.js";
-import type { WorkflowRegistry } from "../../workflows/registry.js";
-import type { CancellationRegistry } from "../background/cancellation-registry.js";
-import type { GitWorktreeSetupCache } from "../shared/worktree.js";
-import type { StageControlRegistry } from "./stage-control-registry.js";
-import type { StageAdapters } from "./stage-runner.js";
-
-export interface ResolvedInputs extends WorkflowInputValues {}
-
-export interface RunContinuationOpts {
-	readonly source: RunSnapshot;
-	readonly resumeFromStageId?: string;
-}
-
-export interface StageSessionCheckpointOptions {
-	readonly forceDurable?: boolean;
-	/** Await and surface the persistence result without bypassing duration bucketing. */
-	readonly awaitDurable?: boolean;
-}
-export interface RunOpts
-	extends Omit<
-		AuthoringContract.RunOpts,
-		| "adapters"
-		| "store"
-		| "cancellation"
-		| "overlay"
-		| "registry"
-		| "stageControlRegistry"
-		| "toolControlRegistry"
-		| "toolAdmissionBoundary"
-		| "continuation"
-		| "onRunStart"
-		| "onStageStart"
-		| "onStageEnd"
-		| "onRunEnd"
-		| "ui"
-	> {
-	adapters?: StageAdapters;
-	/** Invocation working directory exposed to workflow definitions as ctx.cwd. */
-	cwd?: string;
-	/** HIL adapter injected by the pi runtime or test harness. */
-	ui?: WorkflowUIAdapter;
-	/** Runtime execution mode. Controls child session policy metadata. */
-	executionMode?: WorkflowExecutionMode;
-	/** Host-resolved non-default session directory inherited by stages without explicit sessionDir. */
-	defaultSessionDir?: string;
-	/** Internal detached-run mode: surface ctx.ui.* as node-local workflow prompt stages. */
-	usePromptNodesForUi?: boolean;
-	/** Readiness-gate confirmation seam (#1099). */
-	confirmStageReadiness?: (request: {
-		readonly runId: string;
-		readonly stageId: string;
-		readonly stageName: string;
-		readonly signal: AbortSignal;
-	}) => Promise<boolean>;
-	/** Store override (for testing; defaults to singleton store) */
-	store?: Store;
-	/** Persistence port for writing session entries (run.start, stage.start, etc.). */
-	persistence?: WorkflowPersistencePort;
-	/** MCP scope-gating port; forwards per-stage allow/deny to the MCP adapter. */
-	mcp?: WorkflowMcpPort;
-	/** Cancellation registry; the executor registers an ActiveRunController per run. */
-	cancellation?: CancellationRegistry;
-	/** Overlay adapter for displaying run progress in the UI layer. */
-	overlay?: WorkflowOverlayAdapter;
-	/** AbortSignal that requests cancellation from the caller side. */
-	signal?: AbortSignal;
-	/** Yield to the next event-loop turn before invoking user workflow code. */
-	deferWorkflowStart?: boolean;
-	/**
-	 * Invoked once the run has persisted `run.start`, registered its durable
-	 * invocation metadata, and is about to execute the workflow body. Callers
-	 * can finalize a source claim only after this startup-admission signal.
-	 */
-	onWorkflowStartReady?: () => void;
-	/** Resolved runtime configuration. */
-	config?: WorkflowRuntimeConfig;
-	/** Optional model catalog used for fallback validation/resolution. */
-	models?: WorkflowModelCatalogPort;
-	/** Registry metadata forwarded to workflow runs launched from discovery/tooling. */
-	registry?: WorkflowRegistry;
-	/** Current nesting depth of this workflow run. */
-	depth?: number;
-	/** Live stage-control registry. */
-	stageControlRegistry?: StageControlRegistry;
-	/** Live tool-node control registry used to abort in-flight `ctx.tool` calls. */
-	toolControlRegistry?: ToolControlRegistry;
-	/**
-	 * Root-shared `ctx.tool` admission boundary. Set only by the engine when it
-	 * hands a nested run the boundary its root created.
-	 */
-	toolAdmissionBoundary?: ToolAdmissionBoundary;
-	/** Pre-allocated runId. */
-	runId?: string;
-	/** Internal reusable-worktree cache shared with direct output persistence. */
-	gitWorktreeSetupCache?: GitWorktreeSetupCache;
-	/** Replay completed stages from a failed source run, then resume at this stage. */
-	continuation?: RunContinuationOpts;
-	/**
-	 * Durable workflow backend override (for testing). Defaults to the global
-	 * backend resolved by `getDurableBackend()`.
-	 *
-	 * cross-ref: issue #1498 — DBOS-backed cross-session resumability.
-	 */
-	durableBackend?: import("../../durable/backend.js").DurableWorkflowBackend;
-	/** Internal physical backend used to reconstruct full nested topology through stacked scopes. */
-	durableRootBackend?: import("../../durable/backend.js").DurableWorkflowBackend;
-	/**
-	 * Durable scope for a child workflow run. When set, the child's internal
-	 * `ctx.tool`/`ctx.ui`/`ctx.stage` checkpoints are routed under the root
-	 * workflow id with a stable boundary prefix so an interrupted child does
-	 * not re-execute completed side effects on parent resume.
-	 *
-	 * cross-ref: issue #1498.
-	 */
-	durableScope?: import("../../durable/scoped-backend.js").DurableScope;
-	/** Internal parent linkage for nested ctx.workflow(...) runs. */
-	parentRun?: {
-		readonly runId: string;
-		readonly stageId: string;
-		readonly rootRunId: string;
-	};
-	/** Internal root budget scope shared by nested workflow runs. */
-	rootBudget?: import("../../engine/run-budget.js").RunBudgetController;
-	onRunStart?: (snapshot: RunSnapshot) => void;
-	onStageStart?: (runId: string, snapshot: StageSnapshot) => void;
-	onStageEnd?: (runId: string, snapshot: StageSnapshot) => unknown;
-	onStageSession?: (runId: string, snapshot: StageSnapshot, options?: StageSessionCheckpointOptions) => unknown;
-	onRunEnd?: (
-		runId: string,
-		status: RunStatus,
-		result?: WorkflowOutputValues,
-		error?: string,
-		exitReason?: string,
-	) => void;
-}
-
-export interface RunResult<TOutputs extends WorkflowOutputValues = WorkflowOutputValues> {
-	readonly runId: string;
-	readonly status: RunStatus;
-	readonly result?: Partial<TOutputs>;
-	readonly error?: string;
-	/** Tool node whose rejection supplied the selected terminal failure. */
-	readonly failedToolNodeId?: string;
-	/** True when the run reached its terminal status through ctx.exit(). */
-	readonly exited?: boolean;
-	readonly exitReason?: string;
-	readonly stages: StageSnapshot[];
-	/** Always populated by the runtime; optional for legacy structural literals. */
-	readonly toolNodes?: ToolNodeSnapshot[];
-}
-
-export interface ParallelFailFastStage {
-	readonly skip: () => Promise<void>;
-}
-
-export interface ParallelFailFastScope {
-	failed: boolean;
-	firstFailure?: unknown;
-	readonly activeStages: Map<string, ParallelFailFastStage>;
-	readonly parentIds?: readonly string[];
-}
-
-export interface WorkflowExitCleanup {
-	skipForWorkflowExit(reason?: string): void | Promise<void>;
-}

package/dist/builtin/workflows/src/runs/foreground/executor.ts

@@ -1,25 +0,0 @@
-/**
- * Foreground workflow executor public surface.
- *
- * The implementation is split by responsibility across sibling modules so raw
- * TypeScript distribution keeps every authored source under the file-length
- * gate while preserving this historical import path.
- */
-
-export { raceAbort } from "./executor-abort.js";
-export type { ReadinessDecision } from "./executor-hil.js";
-export {
-	askReadinessViaStageBroker,
-	interpretReadinessResult,
-	READINESS_GATE_ADVANCE_LABEL,
-	READINESS_GATE_CHAT_MESSAGE,
-	READINESS_GATE_QUESTION_PARAMS,
-	RESUME_CONTINUATION_PROMPT,
-	readinessResultMeansAdvance,
-	readinessStayMessage,
-	shouldInjectResumeContinuation,
-	toolResultHasChatAnswer,
-} from "./executor-hil.js";
-export { resolveAndValidateInputs, resolveInputs } from "./executor-inputs.js";
-export { run } from "./executor-run.js";
-export type { ResolvedInputs, RunContinuationOpts, RunOpts, RunResult } from "./executor-types.js";