@bastani/atomic 0.8.24-alpha.1 → 0.8.24-alpha.2

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## [Unreleased]
 
+## [0.8.24-alpha.2] - 2026-06-03
+
+### Added
+
+- Shipped externally-resolvable TypeScript types for the `@bastani/workflows` SDK through `@bastani/atomic`. New `./workflows`, `./workflows/builtin`, `./workflows/builtin/*`, and `./workflows/ambient` package exports resolve to declarations emitted from the lean authoring surface during the build, and a generated ambient bridge maps the documented bare `@bastani/workflows` specifier (and its `builtin/*` submodules) onto those exports. Installed packages now type-check `import { defineWorkflow, Type } from "@bastani/workflows"` and `@bastani/workflows/builtin/*` composition imports under `tsc` (`moduleResolution: NodeNext`) with no hand-authored `.d.ts`, no `declare module` shim, and no `paths` alias: packages that import `@bastani/atomic` pick the types up automatically, while pure workflow-only packages add one `compilerOptions.types: ["@bastani/atomic/workflows/ambient"]` (or `/// <reference types="@bastani/atomic/workflows/ambient" />`) opt-in. The runtime workflow loader, jiti virtual modules, and `atomic.workflows` discovery are unchanged ([#1208](https://github.com/bastani-inc/atomic/issues/1208)).
+- Added a `verify:workflow-types` script that packs `@bastani/atomic` and type-checks throwaway external consumer fixtures (workflow-only opt-in, reference directive, auto-include, and a negative control) so the issue #1208 acceptance test is repeatable ([#1208](https://github.com/bastani-inc/atomic/issues/1208)).
+
+### Changed
+
+- Documented the workflow SDK typing model in `docs/packages.md` and `docs/workflows.md`: the single ambient opt-in for pure workflow-only packages, automatic pickup for packages that import `@bastani/atomic`, and the requirement to list `@bastani/atomic` and `typebox` as peer dependencies ([#1208](https://github.com/bastani-inc/atomic/issues/1208)).
+
 ## [0.8.24-alpha.1] - 2026-06-02
 
 ### Breaking Changes

package/dist/builtin/intercom/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to the `pi-intercom` extension will be documented in this fi
 
 ## [Unreleased]
 
+## [0.8.24-alpha.2] - 2026-06-03
+
+### Changed
+
+- Bumped package version for the Atomic 0.8.24-alpha.2 prerelease.
+
 ## [0.8.24-alpha.1] - 2026-06-02
 
 ### Changed

package/dist/builtin/intercom/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/intercom",
-  "version": "0.8.24-alpha.1",
+  "version": "0.8.24-alpha.2",
   "private": true,
   "description": "Atomic extension providing a private coordination channel between parent and child agent sessions. Fork of: https://github.com/nicobailon/pi-intercom",
   "contributors": [

package/dist/builtin/mcp/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.24-alpha.2] - 2026-06-03
+
+### Changed
+
+- Bumped package version for the Atomic 0.8.24-alpha.2 prerelease.
+
 ## [0.8.24-alpha.1] - 2026-06-02
 
 ### Changed

package/dist/builtin/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/mcp",
-  "version": "0.8.24-alpha.1",
+  "version": "0.8.24-alpha.2",
   "private": true,
   "description": "Atomic extension that adapts MCP (Model Context Protocol) servers into the coding agent. Fork of: https://github.com/nicobailon/pi-mcp-adapter",
   "contributors": [

package/dist/builtin/subagents/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [0.8.24-alpha.2] - 2026-06-03
+
+### Changed
+
+- Bumped package version for the Atomic 0.8.24-alpha.2 prerelease.
+
 ## [0.8.24-alpha.1] - 2026-06-02
 
 ### Added

package/dist/builtin/subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/subagents",
-  "version": "0.8.24-alpha.1",
+  "version": "0.8.24-alpha.2",
   "private": true,
   "description": "Atomic extension for delegating tasks to subagents with chains, parallel execution, and TUI clarification. Fork of: https://github.com/nicobailon/pi-subagents",
   "contributors": [

package/dist/builtin/web-access/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.8.24-alpha.2] - 2026-06-03
+
+### Changed
+
+- Bumped package version for the Atomic 0.8.24-alpha.2 prerelease.
+
 ## [0.8.24-alpha.1] - 2026-06-02
 
 ### Changed

package/dist/builtin/web-access/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/web-access",
-  "version": "0.8.24-alpha.1",
+  "version": "0.8.24-alpha.2",
   "private": true,
   "description": "Atomic extension for web search, URL fetching, GitHub repo cloning, PDF/video extraction. Fork of: https://github.com/nicobailon/pi-web-access",
   "contributors": [

package/dist/builtin/workflows/CHANGELOG.md

@@ -6,6 +6,16 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.8.24-alpha.2] - 2026-06-03
+
+### Added
+
+- The `@bastani/workflows` authoring SDK types are now externally resolvable in installed packages through `@bastani/atomic`'s new `./workflows` exports and ambient bridge, so workflow files type-check `import { defineWorkflow, Type } from "@bastani/workflows"` (and `@bastani/workflows/builtin/*`) under `tsc` (NodeNext) without a hand-authored `.d.ts`, `declare module` shim, or `paths` alias. Workflow packages declare `@bastani/atomic` and `typebox` as peer dependencies; the package continues to distribute raw TypeScript with no build step, and the runtime virtual-module loader is unchanged ([#1208](https://github.com/bastani-inc/atomic/issues/1208)).
+
+### Fixed
+
+- Fixed builtin (and any) workflows falling back to the user's currently selected model instead of the stage's defined model. A fully-qualified `provider/model` id that the live model catalog did not list was treated as a hard "not available" failure; because candidate validation throws on any failure and the catalog resolver catches that throw and collapses the whole ordered candidate list down to the user's `currentModel`, a single absent cross-provider fallback discarded the defined primary plus every fallback. Provider-qualified ids are now trusted (passed through with the reasoning suffix split off the last colon), mirroring the subagent resolver, so the defined primary is used and only genuinely failing candidates fall through at runtime. Regressed when bundled workflow model lists were refreshed onto newer multi-provider ids alongside suffix-first reasoning levels ([#1199](https://github.com/bastani-inc/atomic/issues/1199)).
+
 ## [0.8.24-alpha.1] - 2026-06-02
 
 ### Breaking Changes

package/dist/builtin/workflows/ambient.d.ts

@@ -0,0 +1,36 @@
+// AUTO-GENERATED by scripts/copy-builtin-packages.ts (issue #1208). Do not edit by hand.
+//
+// Ambient bridge so the documented bare specifier `@bastani/workflows` (and its
+// `builtin/*` submodules) type-check in installed packages that depend only on
+// @bastani/atomic. Runtime resolution is unchanged: Atomic's jiti virtual-module
+// loader still supplies the real SDK when workflow files load; these declarations
+// only affect `tsc`. Each module is declared in exactly one file to avoid
+// TS2666 / duplicate-identifier errors.
+
+declare module "@bastani/workflows" {
+	export * from "@bastani/atomic/workflows";
+}
+
+declare module "@bastani/workflows/builtin" {
+	export * from "@bastani/atomic/workflows/builtin";
+}
+
+declare module "@bastani/workflows/builtin/deep-research-codebase" {
+	export * from "@bastani/atomic/workflows/builtin/deep-research-codebase";
+	export { default } from "@bastani/atomic/workflows/builtin/deep-research-codebase";
+}
+
+declare module "@bastani/workflows/builtin/goal" {
+	export * from "@bastani/atomic/workflows/builtin/goal";
+	export { default } from "@bastani/atomic/workflows/builtin/goal";
+}
+
+declare module "@bastani/workflows/builtin/open-claude-design" {
+	export * from "@bastani/atomic/workflows/builtin/open-claude-design";
+	export { default } from "@bastani/atomic/workflows/builtin/open-claude-design";
+}
+
+declare module "@bastani/workflows/builtin/ralph" {
+	export * from "@bastani/atomic/workflows/builtin/ralph";
+	export { default } from "@bastani/atomic/workflows/builtin/ralph";
+}

package/dist/builtin/workflows/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/workflows",
-  "version": "0.8.24-alpha.1",
+  "version": "0.8.24-alpha.2",
   "private": true,
   "description": "Atomic extension for multi-stage workflow authoring and execution.",
   "contributors": [

package/dist/builtin/workflows/src/authoring.d.ts

@@ -0,0 +1,197 @@
+import type { TAny, TArray, TArrayOptions, TBigInt, TBoolean, TEnum, TEnumValue, TInteger, TIntersect, TIntersectOptions, TLiteral, TLiteralValue, TNever, TNull, TNumber, TNumberOptions, TOmit, TObject, TObjectOptions, TPartial, TPick, TRecordAction, TRequired, TSchema, TSchemaOptions, TString, TStringOptions, TTuple, TTupleOptions, TUndefined, TUnion, TUnknown, TVoid, Type as TypeboxType, TKeysToIndexer } from "typebox";
+type PreserveOptions<T extends TSchema, O extends TSchemaOptions> = T & O;
+type TypeScriptEnumLike = Record<string, string | number>;
+type TypeScriptEnumValues<T extends TypeScriptEnumLike> = Extract<T[keyof T], TEnumValue>[];
+export declare const Type: Omit<typeof TypeboxType, "Any" | "Array" | "BigInt" | "Boolean" | "Enum" | "Integer" | "Intersect" | "Literal" | "Never" | "Null" | "Number" | "Omit" | "Partial" | "Pick" | "Object" | "Record" | "Required" | "String" | "Tuple" | "Undefined" | "Union" | "Unknown" | "Void"> & {
+    Any<const O extends TSchemaOptions>(options: O): PreserveOptions<TAny, O>;
+    Any(): TAny;
+    Array<Type extends TSchema, const O extends TArrayOptions>(items: Type, options: O): PreserveOptions<TArray<Type>, O>;
+    Array<Type extends TSchema>(items: Type): TArray<Type>;
+    BigInt<const O extends TSchemaOptions>(options: O): PreserveOptions<TBigInt, O>;
+    BigInt(): TBigInt;
+    Boolean<const O extends TSchemaOptions>(options: O): PreserveOptions<TBoolean, O>;
+    Boolean(): TBoolean;
+    Enum<Values extends TEnumValue[], const O extends TSchemaOptions>(values: readonly [...Values], options: O): PreserveOptions<TEnum<Values>, O>;
+    Enum<Values extends TEnumValue[]>(values: readonly [...Values]): TEnum<Values>;
+    Enum<Enum extends TypeScriptEnumLike, const O extends TSchemaOptions>(value: Enum, options: O): PreserveOptions<TEnum<TypeScriptEnumValues<Enum>>, O>;
+    Enum<Enum extends TypeScriptEnumLike>(value: Enum): TEnum<TypeScriptEnumValues<Enum>>;
+    Integer<const O extends TNumberOptions>(options: O): PreserveOptions<TInteger, O>;
+    Integer(): TInteger;
+    Intersect<Types extends TSchema[], const O extends TIntersectOptions>(types: [...Types], options: O): PreserveOptions<TIntersect<Types>, O>;
+    Intersect<Types extends TSchema[]>(types: [...Types]): TIntersect<Types>;
+    Literal<const Value extends TLiteralValue, const O extends TSchemaOptions>(value: Value, options: O): PreserveOptions<TLiteral<Value>, O>;
+    Literal<const Value extends TLiteralValue>(value: Value): TLiteral<Value>;
+    Never<const O extends TSchemaOptions>(options: O): PreserveOptions<TNever, O>;
+    Never(): TNever;
+    Null<const O extends TSchemaOptions>(options: O): PreserveOptions<TNull, O>;
+    Null(): TNull;
+    Number<const O extends TNumberOptions>(options: O): PreserveOptions<TNumber, O>;
+    Number(): TNumber;
+    Omit<Type extends TSchema, Indexer extends PropertyKey[], const O extends TSchemaOptions>(type: Type, indexer: readonly [...Indexer], options: O): PreserveOptions<TOmit<Type, TKeysToIndexer<Indexer>>, O>;
+    Omit<Type extends TSchema, Indexer extends PropertyKey[]>(type: Type, indexer: readonly [...Indexer]): TOmit<Type, TKeysToIndexer<Indexer>>;
+    Omit<Type extends TSchema, Indexer extends TSchema, const O extends TSchemaOptions>(type: Type, indexer: Indexer, options: O): PreserveOptions<TOmit<Type, Indexer>, O>;
+    Omit<Type extends TSchema, Indexer extends TSchema>(type: Type, indexer: Indexer): TOmit<Type, Indexer>;
+    Partial<Type extends TSchema, const O extends TSchemaOptions>(type: Type, options: O): PreserveOptions<TPartial<Type>, O>;
+    Partial<Type extends TSchema>(type: Type): TPartial<Type>;
+    Pick<Type extends TSchema, Indexer extends PropertyKey[], const O extends TSchemaOptions>(type: Type, indexer: readonly [...Indexer], options: O): PreserveOptions<TPick<Type, TKeysToIndexer<Indexer>>, O>;
+    Pick<Type extends TSchema, Indexer extends PropertyKey[]>(type: Type, indexer: readonly [...Indexer]): TPick<Type, TKeysToIndexer<Indexer>>;
+    Pick<Type extends TSchema, Indexer extends TSchema, const O extends TSchemaOptions>(type: Type, indexer: Indexer, options: O): PreserveOptions<TPick<Type, Indexer>, O>;
+    Pick<Type extends TSchema, Indexer extends TSchema>(type: Type, indexer: Indexer): TPick<Type, Indexer>;
+    Object<Properties extends Record<PropertyKey, TSchema>, const O extends TObjectOptions>(properties: Properties, options: O): PreserveOptions<TObject<Properties>, O>;
+    Object<Properties extends Record<PropertyKey, TSchema>>(properties: Properties): TObject<Properties>;
+    Record<Key extends TSchema, Value extends TSchema, const O extends TObjectOptions>(key: Key, value: Value, options: O): PreserveOptions<TRecordAction<Key, Value>, O>;
+    Record<Key extends TSchema, Value extends TSchema>(key: Key, value: Value): TRecordAction<Key, Value>;
+    Required<Type extends TSchema, const O extends TSchemaOptions>(type: Type, options: O): PreserveOptions<TRequired<Type>, O>;
+    Required<Type extends TSchema>(type: Type): TRequired<Type>;
+    String<const O extends TStringOptions>(options: O): PreserveOptions<TString, O>;
+    String(): TString;
+    Tuple<Types extends TSchema[], const O extends TTupleOptions>(types: [...Types], options: O): PreserveOptions<TTuple<Types>, O>;
+    Tuple<Types extends TSchema[]>(types: [...Types]): TTuple<Types>;
+    Undefined<const O extends TSchemaOptions>(options: O): PreserveOptions<TUndefined, O>;
+    Undefined(): TUndefined;
+    Union<Types extends TSchema[], const O extends TSchemaOptions>(anyOf: [...Types], options: O): PreserveOptions<TUnion<Types>, O>;
+    Union<Types extends TSchema[]>(anyOf: [...Types]): TUnion<Types>;
+    Unknown<const O extends TSchemaOptions>(options: O): PreserveOptions<TUnknown, O>;
+    Unknown(): TUnknown;
+    Void<const O extends TSchemaOptions>(options: O): PreserveOptions<TVoid, O>;
+    Void(): TVoid;
+};
+export type { Static, TSchema } from "typebox";
+export type { AgentSessionAdapter, CompleteAdapter, CompleteStageOpts, GitWorktreeSetupOptions, GitWorktreeSetupResult, PromptAdapter, PromptOptions, ResolvedInputs, RunResult, RunStatus, StageAdapters, StageStatus, StageOptions, StageContext, StageSnapshot, StageExecutionMeta, StageMcpOptions, StageOutputOptions, StagePromptOptions, StageSessionCreateOptions, StageSessionCreateResult, StageSessionRuntime, WorkflowAction, WorkflowArtifact, WorkflowChainOptions, WorkflowChainStep, WorkflowChildResult, WorkflowContextMode, WorkflowControlEvent, WorkflowCustomToolDefinition, WorkflowDetails, WorkflowDetailsMode, WorkflowDetailsStatus, WorkflowDirectOptions, WorkflowDirectTaskItem, WorkflowExecutionMode, WorkflowExecutionPolicy, WorkflowInputBindings, WorkflowInputSchema, WorkflowInputSchemaMap, WorkflowInputValues, WorkflowIntercomSummary, WorkflowMaxOutput, WorkflowMcpPort, WorkflowModelAttempt, WorkflowModelCatalogPort, WorkflowModelFallbackFields, WorkflowModelInfo, WorkflowModelUsage, WorkflowModelValue, WorkflowOutputMode, WorkflowOutputSchema, WorkflowOutputSchemaMap, WorkflowOutputValues, WorkflowParallelChainStep, WorkflowParallelOptions, WorkflowPersistencePort, WorkflowProgressSummary, WorkflowRunChildOptions, WorkflowRunOutput, WorkflowRuntimeConfig, WorkflowSerializableObject, WorkflowSerializablePrimitive, WorkflowSerializableValue, WorkflowSharedTaskDefaults, WorkflowTaskContext, WorkflowTaskContextInput, WorkflowTaskOptions, WorkflowTaskResult, WorkflowTaskSessionFields, WorkflowTaskSessionOptions, WorkflowTaskStep, WorkflowThinkingLevel, WorkflowUIAdapter, WorkflowUIContext, WorkflowWorktreeInputBinding, } from "./shared/authoring-contract.js";
+import type * as AuthoringContract from "./shared/authoring-contract.js";
+import type { GitWorktreeSetupOptions, GitWorktreeSetupResult, ResolvedInputs, RunResult, RunStatus, StageSnapshot, WorkflowDefinition as WorkflowContractDefinition, WorkflowDetails, WorkflowDirectOptions, WorkflowDirectTaskItem, WorkflowExecutionPolicy, WorkflowInputValues, WorkflowOutputValues, WorkflowSerializableObject, WorkflowChainStep } from "./shared/authoring-contract.js";
+declare const workflowDefinitionBrand: unique symbol;
+type WorkflowDefinitionBrand = {
+    readonly [workflowDefinitionBrand]: true;
+};
+export interface WorkflowDefinition<TInputs extends WorkflowInputValues = WorkflowInputValues, TOutputs extends WorkflowOutputValues = WorkflowOutputValues, TRunInputs extends WorkflowInputValues = TInputs, TDefinitionBrand extends object = WorkflowDefinitionBrand> extends WorkflowContractDefinition<TInputs, TOutputs, TRunInputs, TDefinitionBrand>, WorkflowDefinitionBrand {
+}
+export type WorkflowRunContext<TInputs extends WorkflowInputValues = WorkflowInputValues> = AuthoringContract.WorkflowRunContext<TInputs, WorkflowDefinitionBrand>;
+export type WorkflowRunFn<TInputs extends WorkflowInputValues = WorkflowInputValues, TOutputs extends WorkflowOutputValues = WorkflowOutputValues> = AuthoringContract.WorkflowRunFn<TInputs, TOutputs, WorkflowDefinitionBrand>;
+export type AnyWorkflowDefinition = WorkflowDefinition<WorkflowInputValues, WorkflowOutputValues, WorkflowInputValues>;
+export type WorkflowBuilder<TInputs extends WorkflowInputValues = {}, TOutputs extends WorkflowOutputValues = {}, TRunInputs extends WorkflowInputValues = TInputs> = AuthoringContract.WorkflowBuilder<TInputs, TOutputs, TRunInputs, WorkflowDefinitionBrand, WorkflowDefinition<TInputs, TOutputs, TRunInputs>>;
+export type CompletedWorkflowBuilder<TInputs extends WorkflowInputValues = {}, TOutputs extends WorkflowOutputValues = {}, TRunInputs extends WorkflowInputValues = TInputs> = AuthoringContract.CompletedWorkflowBuilder<TInputs, TOutputs, TRunInputs, WorkflowDefinitionBrand, WorkflowDefinition<TInputs, TOutputs, TRunInputs>>;
+export type RunContinuationOpts = AuthoringContract.RunContinuationOpts;
+export type WorkflowParentRunLink = AuthoringContract.WorkflowParentRunLink;
+export type RunOpts = Omit<AuthoringContract.RunOpts, "registry"> & {
+    readonly registry?: WorkflowRegistry;
+};
+export declare const INTERACTIVE_WORKFLOW_POLICY: WorkflowExecutionPolicy;
+export declare const NON_INTERACTIVE_WORKFLOW_POLICY: WorkflowExecutionPolicy;
+export declare function run<TInputs extends WorkflowInputValues, TOutputs extends WorkflowOutputValues, TRunInputs extends WorkflowInputValues = TInputs>(definition: WorkflowDefinition<TInputs, TOutputs, TRunInputs>, inputs: Readonly<NoInfer<TRunInputs>>, opts?: RunOpts): Promise<RunResult<TOutputs>>;
+export declare function runTask(task: WorkflowDirectTaskItem, runOptions?: RunOpts): Promise<WorkflowDetails>;
+export declare function runTask(task: WorkflowDirectTaskItem, options?: WorkflowDirectOptions, runOptions?: RunOpts): Promise<WorkflowDetails>;
+export declare function runParallel(tasks: readonly WorkflowDirectTaskItem[], options?: WorkflowDirectOptions, runOptions?: RunOpts): Promise<WorkflowDetails>;
+export declare function runChain(steps: readonly WorkflowChainStep[], options?: WorkflowDirectOptions, runOptions?: RunOpts): Promise<WorkflowDetails>;
+export declare function resolveInputs<TInputs extends WorkflowInputValues>(schema: Readonly<Record<keyof TInputs & string, TSchema>>, provided: Partial<TInputs>): ResolvedInputs<TInputs>;
+export declare function setupGitWorktree(options: GitWorktreeSetupOptions): GitWorktreeSetupResult;
+export interface WorkflowRegistry {
+    register<TInputs extends WorkflowInputValues, TOutputs extends WorkflowOutputValues>(definition: WorkflowDefinition<TInputs, TOutputs>): WorkflowRegistry;
+    merge(other: WorkflowRegistry): WorkflowRegistry;
+    get(name: string): AnyWorkflowDefinition | undefined;
+    has(name: string): boolean;
+    remove(name: string): WorkflowRegistry;
+    names(): string[];
+    all(): AnyWorkflowDefinition[];
+}
+/**
+ * @deprecated Removed imperative workflow API. This runtime value only throws
+ * a migration error; author workflows with defineWorkflow(...).compile().
+ */
+export declare const runWorkflow: never;
+export declare function defineWorkflow(name: string): WorkflowBuilder;
+export declare function createRegistry<TDefinitions extends readonly AnyWorkflowDefinition[] = readonly AnyWorkflowDefinition[]>(initial?: TDefinitions): WorkflowRegistry;
+export declare function normalizeWorkflowName(name: string): string;
+export declare function workflowNamesEqual(a: string, b: string): boolean;
+export declare class GraphFrontierTracker {
+    onSpawn(stageId: string, stageName: string): string[];
+    currentParents(): string[];
+    replaceParents(stageId: string, parentIds: readonly string[]): void;
+    onSettle(stageId: string): void;
+    getNodes(): StageNode[];
+    getParents(stageId: string): string[];
+    reset(): void;
+}
+export interface StageNode extends WorkflowSerializableObject {
+    readonly id: string;
+    readonly name: string;
+    readonly parentIds: readonly string[];
+}
+export type NoticeLevel = "info" | "warning" | "error";
+export type PromptKind = "input" | "confirm" | "select" | "editor";
+export interface PendingPrompt extends WorkflowSerializableObject {
+    readonly id: string;
+    readonly kind: PromptKind;
+    readonly message: string;
+    readonly choices?: readonly string[];
+    readonly initial?: string;
+    readonly createdAt: number;
+}
+export interface ToolEvent {
+    readonly name: string;
+    readonly input?: Record<string, unknown>;
+    readonly output?: string;
+    readonly startedAt?: number;
+    readonly endedAt?: number;
+}
+export interface WorkflowNotice extends WorkflowSerializableObject {
+    readonly id: string;
+    readonly runId?: string;
+    readonly stageId?: string;
+    readonly level: NoticeLevel;
+    readonly message: string;
+    readonly createdAt: number;
+    readonly requiresAck?: boolean;
+    readonly ackedAt?: number;
+}
+export interface WorkflowOverlayAdapter {
+    show(notice: WorkflowNotice): void;
+    hide(): void;
+}
+export interface RunSnapshot {
+    readonly id: string;
+    readonly name: string;
+    readonly status: RunStatus;
+    readonly stages: readonly StageSnapshot[];
+    readonly startedAt: number;
+    readonly endedAt?: number;
+    readonly durationMs?: number;
+    readonly result?: WorkflowOutputValues;
+    readonly error?: string;
+    readonly pendingPrompt?: PendingPrompt;
+}
+export interface StoreSnapshot {
+    readonly runs: readonly RunSnapshot[];
+    readonly notices: readonly WorkflowNotice[];
+    readonly version: number;
+}
+export interface Store {
+    runs(): readonly RunSnapshot[];
+    notices(): readonly WorkflowNotice[];
+    activeRunId(): string | null;
+    recordRunStart(run: RunSnapshot): void;
+    recordStageStart(runId: string, stage: StageSnapshot): void;
+    recordToolStart(runId: string, stageId: string, evt: ToolEvent): void;
+    recordToolEnd(runId: string, stageId: string, evt: ToolEvent): void;
+    recordStageEnd(runId: string, stage: StageSnapshot): void;
+    recordRunEnd(runId: string, status: RunStatus, result?: WorkflowOutputValues, error?: string): boolean;
+    removeRun(runId: string): boolean;
+    recordNotice(notice: WorkflowNotice): void;
+    ackNotice(id: string): boolean;
+}
+export declare function createStore(): Store;
+export declare const store: Store;
+export interface ActiveRunEntry {
+    readonly controller: AbortController;
+    readonly children: readonly AbortController[];
+}
+export interface CancellationRegistry {
+    register(runId: string, controller: AbortController): void;
+    registerChild(runId: string, controller: AbortController): void;
+    abort(runId: string, reason?: unknown): boolean;
+    abortAll(reason?: unknown): number;
+    unregister(runId: string): void;
+    isAborted(runId: string): boolean;
+}
+export declare function createCancellationRegistry(): CancellationRegistry;
+export declare const cancellationRegistry: CancellationRegistry;

package/dist/builtin/workflows/src/runs/shared/model-fallback.ts

@@ -112,7 +112,17 @@ function resolveStringModel(
   }
 
   if (baseModel.includes("/")) {
-    return { input, reason: "not available" };
+    // Trust an explicit provider/model id even when the live catalog does not
+    // list it, mirroring the subagent resolver (resolveModelCandidate's
+    // `if (model.includes("/")) return model;`). The workflow catalog
+    // (ctx.modelRegistry.getAvailable()) can legitimately be a partial view
+    // (auth/provider gating, freshly added models), so treating an absent
+    // fully-qualified id as a hard failure made buildModelCandidates throw and
+    // collapse the whole ordered candidate list down to just the user's
+    // currentModel — discarding the workflow's defined primary and fallbacks.
+    // Pass it through with the reasoning suffix split off; the runtime fallback
+    // loop skips it only if the SDK genuinely cannot create a session for it.
+    return makeCandidate(baseModel, baseModel, level);
   }
 
   const byBareId = models.filter((model) => model.id === baseModel);