@bastani/atomic 0.9.41-alpha.3 → 0.9.42-alpha.1

package/dist/builtin/workflows/README.md

@@ -504,6 +504,16 @@ For authored workflows, choose thinking effort by stage role and failure cost ra
 
 When pi exposes its model registry, workflow runs validate user-specified `model` / `fallbackModels` before starting model-backed work and report all unavailable or ambiguous IDs together. Bare model IDs are accepted only when they resolve uniquely or match the current provider; otherwise use `provider/model`. Fallback attempts may send the same prompt/context to a different provider, so choose fallbacks that fit your cost, privacy, and data-handling requirements.
 
+### Rate-limit-aware fallback
+
+A 429 puts its configured provider account on a cooldown shared by every stage in the process. The chain prefers a ready candidate; when all eligible candidates are cooling down, it waits for the earliest deadline and rechecks. `Retry-After` seconds and HTTP dates take precedence over local exponential backoff with jitter. Local backoff is capped at 60 seconds, but a longer server deadline is respected.
+
+Retries remain bounded by the session's `retry.enabled` and `retry.maxRetries`. Custom adapters without retry settings allow two rate-limit retries per candidate. Pausing, quitting, or cancelling interrupts a cooldown wait. Workflow and structured-output time limits still include time spent waiting.
+
+Stage metadata and task results expose `rateLimits`: configured provider IDs, process-wide `rateLimitCount`, `cooldownUntil`, and `waitingUntil` while the fallback scheduler waits. The model-facing `workflow status` listing names waiting stages and their provider counts. Timestamps use Unix milliseconds; historical records do not restore active cooldowns after restart.
+
+For optional per-provider rolling request budgets, call `configureProviderRequestBudget(provider, { maxRequests, intervalMs })` from `@bastani/atomic` before model work. Pass `undefined` to remove a budget. Budgets apply across model runtimes in the same process. HTTP-based OpenAI, Anthropic, Azure, Mistral, pi-messages, and explicit Codex SSE transports count each HTTP attempt; other transports count stream starts rather than their internal retries. Separate configured provider IDs have independent budgets even when they point to the same account. See [provider rate limits](../coding-agent/docs/workflows.md#provider-rate-limits) for an example and limitations.
+
 ### `createRegistry` — grouping workflows
 
 ```typescript

package/dist/builtin/workflows/builtin/{chunk-txbc93t6.js → chunk-3s95f7ry.js}

@@ -37,7 +37,7 @@ import {
   parseFailureDiagnostics,
   summarizeReviewConvergence,
   reverify_consolidated_batch
-} from "./chunk-8x61e0s7.js";
+} from "./chunk-frqxd4d1.js";
 import {
   VERIFICATION_SCALE
 } from "./chunk-n1910xc4.js";

package/dist/builtin/workflows/builtin/{chunk-n2gkzkty.js → chunk-edhf30ef.js}

@@ -39,7 +39,7 @@ import {
   reviewerFailureText,
   summarizeReviewConvergence,
   reverify_consolidated_batch
-} from "./chunk-8x61e0s7.js";
+} from "./chunk-frqxd4d1.js";
 import {
   fold_usage
 } from "./chunk-tgt0s5e5.js";

package/dist/builtin/workflows/builtin/{chunk-8x61e0s7.js → chunk-frqxd4d1.js}

@@ -1494,10 +1494,11 @@ function createPendingStageDeliveryStoreMethods(context) {
         const result = queueStageMessage(receipt === undefined ? run.pendingStageMessages ?? [] : [...run.pendingStageMessages ?? [], receipt], input, senderGroup, runGroup, stageIdentity);
         if (result.ok && !result.deduplicated) {
           const messages = await persistTransition(backend, input.runId, result.messages, context);
-          run.pendingStageMessages = [...messages];
+          const live = context.findRun(input.runId) ?? run;
+          live.pendingStageMessages = [...messages];
           context.bumpAndNotify();
         }
-        return result.ok ? { ...result, messages: run.pendingStageMessages ?? [] } : result;
+        return result.ok ? { ...result, messages: (context.findRun(input.runId) ?? run).pendingStageMessages ?? [] } : result;
       });
     },
     async validateLiveStageMessage(input) {
@@ -1539,7 +1540,8 @@ function createPendingStageDeliveryStoreMethods(context) {
         if (next === current)
           return false;
         const messages = await persistTransition(backend, runId, next, context);
-        run.pendingStageMessages = [...messages];
+        const live = context.findRun(runId) ?? run;
+        live.pendingStageMessages = [...messages];
         context.bumpAndNotify();
         return true;
       });
@@ -1554,7 +1556,8 @@ function createPendingStageDeliveryStoreMethods(context) {
         if (next === current)
           return false;
         const messages = await persistTransition(backend, runId, next, context);
-        run.pendingStageMessages = [...messages];
+        const live = context.findRun(runId) ?? run;
+        live.pendingStageMessages = [...messages];
         context.bumpAndNotify();
         return true;
       });
@@ -1569,7 +1572,8 @@ function createPendingStageDeliveryStoreMethods(context) {
         if (next === current)
           return false;
         const messages = await persistTransition(backend, runId, next, context);
-        run.pendingStageMessages = [...messages];
+        const live = context.findRun(runId) ?? run;
+        live.pendingStageMessages = [...messages];
         context.bumpAndNotify();
         return true;
       });
@@ -1583,10 +1587,11 @@ function createPendingStageDeliveryStoreMethods(context) {
         const result = queueStickyStageMessage(receipt === undefined ? run.pendingStageMessages ?? [] : [...run.pendingStageMessages ?? [], receipt], input, senderGroup, runGroup);
         if (result.ok && !result.deduplicated) {
           const messages = await persistTransition(backend, input.runId, result.messages, context);
-          run.pendingStageMessages = [...messages];
+          const live = context.findRun(input.runId) ?? run;
+          live.pendingStageMessages = [...messages];
           context.bumpAndNotify();
         }
-        return result.ok ? { ...result, messages: run.pendingStageMessages ?? [] } : result;
+        return result.ok ? { ...result, messages: (context.findRun(input.runId) ?? run).pendingStageMessages ?? [] } : result;
       });
     },
     async recordPendingStageMessageDeliveries(runId, messageId, records, deliveredAt, backend) {
@@ -1613,7 +1618,8 @@ function createPendingStageDeliveryStoreMethods(context) {
         if (next === current)
           return false;
         const messages = await persistTransition(backend, runId, next, context);
-        run.pendingStageMessages = [...messages];
+        const live = context.findRun(runId) ?? run;
+        live.pendingStageMessages = [...messages];
         context.bumpAndNotify();
         return true;
       });
@@ -1629,7 +1635,8 @@ function createPendingStageDeliveryStoreMethods(context) {
         if (next === current)
           return false;
         const messages = await persistTransition(backend, runId, next, context);
-        run.pendingStageMessages = [...messages];
+        const live = context.findRun(runId) ?? run;
+        live.pendingStageMessages = [...messages];
         context.bumpAndNotify();
         return true;
       });
@@ -2399,6 +2406,8 @@ function createStageStoreMethods(context) {
         existing.sessionFile = stage.sessionFile;
       if (stage.modelAttempts !== undefined)
         existing.modelAttempts = stage.modelAttempts;
+      if (stage.rateLimits !== undefined)
+        existing.rateLimits = stage.rateLimits;
       if (stage.routerSelection !== undefined)
         existing.routerSelection = Object.freeze({ ...stage.routerSelection });
       existing.failureKind = stage.failureKind;

package/dist/builtin/workflows/builtin/goal.js

@@ -1,7 +1,7 @@
 import {
   goal_default
-} from "./chunk-txbc93t6.js";
-import"./chunk-8x61e0s7.js";
+} from "./chunk-3s95f7ry.js";
+import"./chunk-frqxd4d1.js";
 import"./chunk-2377r57g.js";
 import"./chunk-z0d03ktm.js";
 import"./chunk-n1910xc4.js";

package/dist/builtin/workflows/builtin/index.js

@@ -16,8 +16,8 @@ import {
 } from "./chunk-z3pajrfs.js";
 import {
   goal_default
-} from "./chunk-txbc93t6.js";
-import"./chunk-8x61e0s7.js";
+} from "./chunk-3s95f7ry.js";
+import"./chunk-frqxd4d1.js";
 import"./chunk-z0d03ktm.js";
 import {
   open_claude_design_default
@@ -27,7 +27,7 @@ import {
 } from "./chunk-dcxscfnb.js";
 import {
   ralph_default
-} from "./chunk-n2gkzkty.js";
+} from "./chunk-edhf30ef.js";
 import {
   tournament_default
 } from "./chunk-49kkbdpr.js";

package/dist/builtin/workflows/builtin/ralph.js

@@ -1,7 +1,7 @@
 import {
   ralph_default
-} from "./chunk-n2gkzkty.js";
-import"./chunk-8x61e0s7.js";
+} from "./chunk-edhf30ef.js";
+import"./chunk-frqxd4d1.js";
 import"./chunk-2377r57g.js";
 import"./chunk-z0d03ktm.js";
 import"./chunk-n1910xc4.js";

package/dist/builtin/workflows/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/workflows",
-  "version": "0.9.41-alpha.3",
+  "version": "0.9.42-alpha.1",
   "private": true,
   "description": "Atomic extension for multi-stage workflow authoring and execution.",
   "contributors": [
@@ -50,6 +50,7 @@
   ],
   "files": [
     "src/**/*.ts",
+    "src/**/*.mjs",
     "builtin/**/*.ts",
     "builtin/**/*.d.ts",
     "skills/**/*",
@@ -85,6 +86,7 @@
   },
   "peerDependencies": {
     "@bastani/atomic": "*",
+    "@bastani/atomic-natives": "*",
     "@earendil-works/pi-tui": "^1.4.0",
     "typebox": "*"
   },
@@ -92,6 +94,9 @@
     "@bastani/atomic": {
       "optional": true
     },
+    "@bastani/atomic-natives": {
+      "optional": true
+    },
     "@earendil-works/pi-tui": {
       "optional": true
     }

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

@@ -8,7 +8,7 @@ export type { RunJournalOption, RunJournalSettings } from "./durable/journal/res
 export { resolveRunJournal } from "./durable/journal/resolution.js";
 export { openSqlRunJournal, SqlRunJournal } from "./durable/journal/sqlite-run-journal.js";
 export * from "./durable/journal/types.js";
-export type { AgentSessionAdapter, CompleteAdapter, CompleteStageOpts, EffectiveBudget, GitWorktreeSetupOptions, GitWorktreeSetupResult, PromptAdapter, PromptOptions, ResolvedInputs, RunResult, RunStatus, StageAdapters, StageContext, StageExecutionMeta, StageMcpOptions, StageOptions, StageOutputOptions, StagePromptOptions, StageSendUserMessageOptions, StageSessionCreateOptions, StageSessionCreateResult, StageSessionEvent, StageSessionRuntime, StageSnapshot, StageStatus, StageUserMessageContent, StageUserMessageDelivery, ToolNodeSnapshot, WorkflowAction, WorkflowArtifact, WorkflowBudget, WorkflowChainOptions, WorkflowChildResult, WorkflowContextMode, WorkflowControlEvent, WorkflowCustomToolDefinition, WorkflowCustomUiComponent, WorkflowCustomUiFactory, WorkflowCustomUiKeybindings, WorkflowCustomUiOptions, WorkflowCustomUiOverlayHandle, WorkflowCustomUiOverlayOptions, WorkflowCustomUiTheme, WorkflowCustomUiTui, WorkflowDetails, WorkflowDetailsMode, WorkflowDetailsStatus, WorkflowExecutionMode, WorkflowExecutionPolicy, WorkflowExitOptions, WorkflowExitStatus, WorkflowInputBindings, WorkflowInputSchema, WorkflowInputSchemaMap, WorkflowInputValues, WorkflowIntercomSummary, WorkflowMaxOutput, WorkflowMcpPort, WorkflowModelAttempt, WorkflowModelCatalogPort, WorkflowModelFallbackFields, WorkflowModelInfo, WorkflowModelUsage, WorkflowModelValue, WorkflowOutputMode, WorkflowOutputSchema, WorkflowOutputSchemaMap, WorkflowOutputValues, WorkflowParallelFailure, WorkflowParallelOptions, WorkflowPersistencePort, WorkflowProgressSummary, WorkflowRunChildArgs, WorkflowRunChildOptions, WorkflowRunChildOptionsArgument, WorkflowRunOutput, WorkflowRuntimeConfig, WorkflowSerializableObject, WorkflowSerializablePrimitive, WorkflowSerializableValue, WorkflowSharedTaskDefaults, WorkflowTaskContext, WorkflowTaskContextInput, WorkflowTaskOptions, WorkflowTaskResult, WorkflowTaskSessionFields, WorkflowTaskSessionOptions, WorkflowTaskStep, WorkflowThinkingLevel, WorkflowToolContext, WorkflowToolError, WorkflowToolFailure, WorkflowToolOptions, WorkflowToolOutcome, WorkflowToolPrimitive, WorkflowToolReturnOptions, WorkflowToolSuccess, WorkflowToolThrowOptions, WorkflowUIAdapter, WorkflowUIContext, WorkflowWorktreeInputBinding, } from "./shared/authoring-contract.js";
+export type { AgentSessionAdapter, CompleteAdapter, CompleteStageOpts, EffectiveBudget, GitWorktreeSetupOptions, GitWorktreeSetupResult, PromptAdapter, PromptOptions, ResolvedInputs, RunResult, RunStatus, StageAdapters, StageContext, StageExecutionMeta, StageMcpOptions, StageOptions, StageOutputOptions, StagePromptOptions, StageSendUserMessageOptions, StageSessionCreateOptions, StageSessionCreateResult, StageSessionEvent, StageSessionRuntime, StageSnapshot, StageStatus, StageUserMessageContent, StageUserMessageDelivery, ToolNodeSnapshot, WorkflowAction, WorkflowArtifact, WorkflowBudget, WorkflowChainOptions, WorkflowChildResult, WorkflowContextMode, WorkflowControlEvent, WorkflowCustomToolDefinition, WorkflowCustomUiComponent, WorkflowCustomUiFactory, WorkflowCustomUiKeybindings, WorkflowCustomUiOptions, WorkflowCustomUiOverlayHandle, WorkflowCustomUiOverlayOptions, WorkflowCustomUiTheme, WorkflowCustomUiTui, WorkflowDetails, WorkflowDetailsMode, WorkflowDetailsStatus, WorkflowExecutionMode, WorkflowExecutionPolicy, WorkflowExitOptions, WorkflowExitStatus, WorkflowInputBindings, WorkflowInputSchema, WorkflowInputSchemaMap, WorkflowInputValues, WorkflowIntercomSummary, WorkflowMaxOutput, WorkflowMcpPort, WorkflowModelAttempt, WorkflowModelCatalogPort, WorkflowModelFallbackFields, WorkflowModelInfo, WorkflowModelUsage, WorkflowModelValue, WorkflowOutputMode, WorkflowOutputSchema, WorkflowOutputSchemaMap, WorkflowOutputValues, WorkflowParallelFailure, WorkflowParallelOptions, WorkflowPersistencePort, WorkflowProgressSummary, WorkflowProviderRateLimit, WorkflowRunChildArgs, WorkflowRunChildOptions, WorkflowRunChildOptionsArgument, WorkflowRunOutput, WorkflowRuntimeConfig, WorkflowSerializableObject, WorkflowSerializablePrimitive, WorkflowSerializableValue, WorkflowSharedTaskDefaults, WorkflowTaskContext, WorkflowTaskContextInput, WorkflowTaskOptions, WorkflowTaskResult, WorkflowTaskSessionFields, WorkflowTaskSessionOptions, WorkflowTaskStep, WorkflowThinkingLevel, WorkflowToolContext, WorkflowToolError, WorkflowToolFailure, WorkflowToolOptions, WorkflowToolOutcome, WorkflowToolPrimitive, WorkflowToolReturnOptions, WorkflowToolSuccess, WorkflowToolThrowOptions, WorkflowUIAdapter, WorkflowUIContext, WorkflowWorktreeInputBinding, } from "./shared/authoring-contract.js";
 import type * as AuthoringContract from "./shared/authoring-contract.js";
 import type { AuthoredWorkflowSpec as SharedAuthoredWorkflowSpec, WorkflowInputsFromSchemas, WorkflowOutputsFromSchemas, WorkflowProvidedInputsFromSchemas } from "./shared/workflow-authoring-types.js";
 export type { WorkflowInputsFromSchemas, WorkflowOutputsFromSchemas, WorkflowProvidedInputsFromSchemas, } from "./shared/workflow-authoring-types.js";
@@ -36,6 +36,8 @@ export type RunOpts = Omit<AuthoringContract.RunOpts, "registry"> & {
 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<WorkflowRunInputArgument<TRunInputs>>>, opts?: RunOpts): Promise<RunResult<TOutputs>>;
+export declare function loadWorkerWorkflow(path: string, exportName?: string): Promise<AnyWorkflowDefinition>;
+export type { LocalWorkerOptions, WorkflowAdmissionOptions } from "./workers/public-options.js";
 /**
  * Build the default stage-session adapter: each stage runs an in-process Atomic
  * `createAgentSession` session. `baseOptions` apply to every stage; stage options

package/dist/builtin/workflows/src/durable/journal/internal.d.ts

@@ -1,3 +1,4 @@
+import type { SqliteExecutor } from "@bastani/atomic/storage";
 import type { RunJournal } from "./types.js";
 export declare const JOURNAL_READ_PAGE_SIZE = 256;
 /** A run's latest event. A run whose history was deleted and recorded again ends with a different event. */
@@ -15,3 +16,15 @@ export interface RunJournalVersions {
 export declare function registerRunJournalVersions(journal: RunJournal, versions: RunJournalVersions): void;
 /** Change tracking for a journal that registered it; other journals are re-read in full. */
 export declare function runJournalVersions(journal: RunJournal): RunJournalVersions | undefined;
+export type JournalAppendGuard = (tx: SqliteExecutor, runId: string) => Promise<void>;
+export interface SqlPoolStorage {
+    transaction<T>(body: (tx: SqliteExecutor) => Promise<T>): Promise<T>;
+    withAppendGuard<T>(guard: JournalAppendGuard, action: () => Promise<T>): Promise<T>;
+    readonly tables: Readonly<{
+        runs: string;
+        events: string;
+        leases: string;
+    }>;
+}
+export declare function registerSqlPoolStorage(journal: RunJournal, storage: SqlPoolStorage): void;
+export declare function sqlPoolStorage(journal: RunJournal): SqlPoolStorage | undefined;

package/dist/builtin/workflows/src/durable/journal/resolution.d.ts

@@ -4,6 +4,8 @@ export type { RunJournalOption };
 export interface RunJournalSettings {
     workflows?: string[] | {
         journal?: StorageSettingsSelection;
+        localWorkers?: import("../../workers/public-options.js").LocalWorkerOptions;
+        admission?: import("../../workers/public-options.js").WorkflowAdmissionOptions;
     };
     storage?: StorageSettingsSelection;
 }

package/dist/builtin/workflows/src/durable/journal/sql-run-journal.d.ts

@@ -8,6 +8,7 @@ export declare class SqlRunJournal implements RunJournal {
     private readonly database;
     private readonly tables;
     private readonly legacy;
+    private readonly appendGuard;
     private constructor();
     static open(database: SqliteDatabase, options?: {
         readonly prefix?: string;