deepline 0.2.60 → 0.2.62

package/dist/bundling-sources/sdk/src/errors.ts

@@ -4,7 +4,10 @@ import {
   ToolExecutionError,
   brandAsProviderTransientError,
   brandAsToolExecutionError,
+  getProviderUnavailableReason,
+  isProviderUnavailable,
   isProviderTransientFailure,
+  isProviderWaterfallUnavailableError,
   type ProviderTransientErrorCategory,
   type ToolExecutionErrorCategory,
   type ToolExecutionFailureV1,
@@ -18,7 +21,12 @@ export {
   DeeplineError,
   ProviderTransientError,
   ToolExecutionError,
+  getProviderUnavailableReason,
+  isProviderUnavailable,
+  isProviderWaterfallUnavailableError,
   type ProviderTransientErrorCategory,
+  type ProviderUnavailableError,
+  type ProviderUnavailableReason,
   type ToolExecutionErrorCategory,
   type ToolExecutionFailureV1,
   type ToolExecutionErrorOrigin,

package/dist/bundling-sources/sdk/src/index.ts

@@ -126,6 +126,9 @@ export {
   DeeplineError,
   ProviderTransientError,
   ToolExecutionError,
+  getProviderUnavailableReason,
+  isProviderUnavailable,
+  isProviderWaterfallUnavailableError,
   AuthError,
   RateLimitError,
   ToolRateLimitError,
@@ -133,6 +136,8 @@ export {
 } from './errors.js';
 export type {
   ProviderTransientErrorCategory,
+  ProviderUnavailableError,
+  ProviderUnavailableReason,
   ToolExecutionErrorCategory,
   ToolExecutionFailureV1,
   ToolExecutionErrorOrigin,

package/dist/bundling-sources/sdk/src/play.ts

@@ -140,6 +140,7 @@ import type {
   PlayAuthoringRuntimeContext,
   PlayAuthoringRuntimeStepOptions,
   PlayAuthoringStepOptions,
+  PlayAuthoringStepProgramOptions,
   PlayAuthoringStepProgram,
   PlayAuthoringStepProgramOutput,
   PlayAuthoringStepProgramResolver,
@@ -333,6 +334,9 @@ export type StepOptions<Row, Value = unknown> = PlayAuthoringStepOptions<
   Value
 >;
 
+/** Explicitly mark a step program as a provider fallback waterfall. */
+export type StepProgramOptions = PlayAuthoringStepProgramOptions;
+
 export type StepProgram<
   Input,
   Output,
@@ -720,6 +724,7 @@ class DeeplineStepProgram<Input, Output, ReturnValue> implements StepProgram<
   constructor(
     readonly steps: readonly PlayStepProgramStep[],
     readonly returnResolver?: StepResolver<Output, ReturnValue>,
+    readonly continueOnProviderUnavailable = false,
   ) {}
 
   step<Name extends string, Value>(
@@ -774,13 +779,18 @@ class DeeplineStepProgram<Input, Output, ReturnValue> implements StepProgram<
         Output & Record<Name, Value | null>,
         ReturnValue
       >,
+      this.continueOnProviderUnavailable,
     );
   }
 
   return<Value>(
     resolver: StepResolver<Output, Value>,
   ): StepProgram<Input, Output, Value> {
-    return new DeeplineStepProgram(this.steps, resolver);
+    return new DeeplineStepProgram(
+      this.steps,
+      resolver,
+      this.continueOnProviderUnavailable,
+    );
   }
 }
 
@@ -794,8 +804,14 @@ function isConditionalStepResolver(
   );
 }
 
-export function steps<TInput>(): StepProgram<TInput, TInput, TInput> {
-  return new DeeplineStepProgram<TInput, TInput, TInput>([]);
+export function steps<TInput>(
+  options: StepProgramOptions = {},
+): StepProgram<TInput, TInput, TInput> {
+  return new DeeplineStepProgram<TInput, TInput, TInput>(
+    [],
+    undefined,
+    options.continueOnProviderUnavailable === true,
+  );
 }
 
 export function runIf<Row, Value>(

package/dist/bundling-sources/sdk/src/release.ts

@@ -160,7 +160,7 @@ export const SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: '0.2.60',
+  version: '0.2.62',
   contracts: {
     api: {
       name: 'sdk-http-api',

package/dist/bundling-sources/shared_libs/play-runtime/context.ts

@@ -100,6 +100,7 @@ import {
   normalizePlayContractCompatibility,
 } from '@shared_libs/plays/contracts';
 import {
+  isProviderUnavailable,
   serializeToolExecutionFailure,
   TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
   TOOL_EXECUTION_ERROR_SCHEMA_HEADER,
@@ -1666,6 +1667,23 @@ function isRuntimeConditionalStepResolver(
   );
 }
 
+/**
+ * Prebuilt source is also typechecked by the deployed SDK, which can lag the
+ * runtime. A tagged `runIf` keeps that source compatible with older `steps()`
+ * declarations while retaining the explicit per-program waterfall opt-in.
+ */
+function continuesOnProviderUnavailable(program: RuntimeStepProgram): boolean {
+  return (
+    program.continueOnProviderUnavailable === true ||
+    program.steps.some(
+      (step) =>
+        isRuntimeConditionalStepResolver(step.resolver) &&
+        (step.resolver.when as { __deeplineProviderWaterfall?: unknown })
+          .__deeplineProviderWaterfall === true,
+    )
+  );
+}
+
 const CTX_MAP_MIGRATION_MESSAGE =
   'ctx.map(...) has been replaced by ctx.dataset(...). Use ctx.dataset("rows", rows).withColumn("field", resolver).run().';
 const DATASET_STEP_MIGRATION_MESSAGE =
@@ -7810,6 +7828,8 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
     program: RuntimeStepProgram,
   ): MapFieldDefinition<Record<string, unknown>> {
     const definition: MapFieldDefinition<Record<string, unknown>> = {};
+    const continueOnProviderUnavailable =
+      continuesOnProviderUnavailable(program);
     for (const step of program.steps) {
       const resolver: MapFieldResolver<
         Record<string, unknown>,
@@ -7820,14 +7840,27 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
         currentRow: Record<string, unknown>,
         index: number,
         previousCell?: PreviousCell,
-      ) =>
-        await this.executeStepProgramStep(
-          step,
-          currentRow,
-          index,
-          [step.name],
-          previousCell,
-        );
+      ) => {
+        try {
+          return await this.executeStepProgramStep(
+            step,
+            currentRow,
+            index,
+            [step.name],
+            previousCell,
+          );
+        } catch (error) {
+          if (
+            (!continueOnProviderUnavailable &&
+              step.continueOnProviderUnavailable !== true) ||
+            (!(error instanceof ProviderExhaustedError) &&
+              !isProviderUnavailable(error))
+          ) {
+            throw error;
+          }
+          return null;
+        }
+      };
       definition[step.name] = resolver;
     }
     Object.defineProperty(definition, STEP_PROGRAM_MAP_DEFINITION, {
@@ -7849,8 +7882,12 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
     // Steps this program has not run yet. Hoisted per program, not rebuilt per
     // step, and shrunk as each step produces.
     const pendingStepNames = new Set(program.steps.map((step) => step.name));
+    const waterfallAttempts: Record<string, Record<string, unknown>> = {};
+    const continueOnProviderUnavailable =
+      continuesOnProviderUnavailable(program);
     for (const step of program.steps) {
       const stepPath = [...path, step.name];
+      const stageExecution = { skipped: false };
       // ADR 0019: a step's read-set is the row as it stands *now*, which
       // includes every earlier step's output. Sibling steps are not part of the
       // row's column order, so a step cell keeps an explicit array where a
@@ -7878,6 +7915,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
                   index,
                   stepPath,
                   undefined,
+                  stageExecution,
                 ),
               {
                 semanticKey: stableDigest(
@@ -7895,30 +7933,63 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
               index,
               stepPath,
               undefined,
+              stageExecution,
             );
       let value: unknown;
       try {
         value = await runStep();
       } catch (error) {
-        // PROVIDER_EXHAUSTED is a step MISS, not a program abort. The pacer
-        // skipped this provider (no spend, no dispatch); resolve the step as an
-        // empty result so the row falls through to the next step's `runIf` chain
-        // exactly as it would for a provider miss. Any OTHER error keeps its
-        // existing propagation (row-isolation / abort semantics unchanged).
-        if (!(error instanceof ProviderExhaustedError)) throw error;
+        // A provider admission, transient upstream failure, or exhausted
+        // managed provider account is a visible unavailable leg, not a row
+        // abort. Persist the failure on this stage, then make its value a
+        // normal miss so existing `runIf` waterfalls advance without every
+        // author hand-writing error handling.
+        if (
+          !continueOnProviderUnavailable ||
+          (!(error instanceof ProviderExhaustedError) &&
+            !isProviderUnavailable(error))
+        ) {
+          throw error;
+        }
+        const unavailableAttempt =
+          error instanceof ProviderExhaustedError
+            ? {
+                provider: error.provider,
+                operation: null,
+                code: error.code,
+                category: 'rate_limit',
+                retryable: true,
+                statusCode: null,
+                requestId: null,
+                retryAfterMs: null,
+              }
+            : {
+                provider: error.provider ?? null,
+                operation: error.operation ?? null,
+                code: error.code ?? null,
+                category: error.category ?? null,
+                retryable: error.retryable === true,
+                statusCode: error.statusCode ?? null,
+                requestId: error.requestId ?? null,
+                retryAfterMs: error.retryAfterMs ?? null,
+              };
         value = null;
+        waterfallAttempts[step.name] = {
+          status: 'unavailable',
+          ...unavailableAttempt,
+          error: this.formatRuntimeError(error),
+        };
         const rowStore = rowContext.getStore();
-        const fieldName = stepPath.join('.');
         if (rowStore) {
           this.emitScopedFieldMetaUpdate({
             rowId: rowStore.rowId,
             key: rowStore.rowKey ?? null,
             tableNamespace: rowStore.tableNamespace ?? null,
-            fieldName,
+            fieldName: stepPath.join('.'),
             status: 'failed',
             rowStatus: 'running',
             stage: 'failed',
-            provider: null,
+            provider: error.provider,
             error: this.formatRuntimeError(error),
             dataPatch: {},
           });
@@ -7928,6 +7999,11 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
         currentRow = cloneCsvAliasedRow(currentRow, { [step.name]: value });
         continue;
       }
+      waterfallAttempts[step.name] = stageExecution.skipped
+        ? { status: 'skipped' }
+        : value === null
+          ? { status: 'no_result' }
+          : { status: 'completed', result: value };
       produced[step.name] = value;
       pendingStepNames.delete(step.name);
       const rowStore = rowContext.getStore();
@@ -7952,9 +8028,32 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
       currentRow = cloneCsvAliasedRow(currentRow, { [step.name]: value });
     }
     if (typeof program.returnResolver === 'function') {
-      return await program.returnResolver(currentRow, this, index);
+      const result = await program.returnResolver(currentRow, this, index);
+      return continueOnProviderUnavailable
+        ? this.appendWaterfallAttempts(result, waterfallAttempts)
+        : result;
     }
-    return produced;
+    return continueOnProviderUnavailable
+      ? this.appendWaterfallAttempts(produced, waterfallAttempts)
+      : produced;
+  }
+
+  private appendWaterfallAttempts(
+    result: unknown,
+    waterfallAttempts: Record<string, Record<string, unknown>>,
+  ): unknown {
+    if (
+      result === null ||
+      typeof result !== 'object' ||
+      Array.isArray(result) ||
+      Object.prototype.hasOwnProperty.call(result, 'waterfall_attempts')
+    ) {
+      return result;
+    }
+    return {
+      ...(result as Record<string, unknown>),
+      waterfall_attempts: waterfallAttempts,
+    };
   }
 
   private async executeStepProgramStep(
@@ -7963,6 +8062,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
     index: number,
     path: string[],
     previousCell?: PreviousCell,
+    stageExecution?: { skipped: boolean },
   ): Promise<unknown> {
     const resolver = step.resolver;
     const store = rowContext.getStore();
@@ -8024,6 +8124,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
             dataPatch: {},
           });
         }
+        if (stageExecution) stageExecution.skipped = true;
         return elseValue;
       }
       return await runWithStepScope(

package/dist/bundling-sources/shared_libs/play-runtime/ctx-types.ts

@@ -1041,6 +1041,8 @@ export type RuntimeConditionalStepResolver<
 
 export type RuntimeStepProgramStep = {
   name: string;
+  /** Copied from a `withColumns()` waterfall program for per-leg fallback. */
+  continueOnProviderUnavailable?: boolean;
   recompute?: boolean;
   recomputeOnError?: boolean;
   staleAfterSeconds?: number;
@@ -1054,6 +1056,8 @@ export type RuntimeStepProgram = {
   kind: 'steps';
   steps: readonly RuntimeStepProgramStep[];
   returnResolver?: RuntimeStepResolver;
+  /** Opt in to treating provider unavailability as a miss and advancing. */
+  continueOnProviderUnavailable?: boolean;
 };
 
 export type { PlayDataset, PlayDatasetInput, PlayDatasetRow };

package/dist/bundling-sources/shared_libs/play-runtime/step-program-dataset-builder.ts

@@ -56,6 +56,7 @@ export type StepProgramDatasetStep<TResolver> = {
 export type StepProgramDatasetProgram<TStep> = {
   kind: 'steps';
   steps: readonly TStep[];
+  continueOnProviderUnavailable?: boolean;
 };
 
 export type StepProgramDatasetConditionalResolver<TResolver> = {
@@ -91,6 +92,29 @@ export function isStepProgramDatasetConditionalResolver<TResolver>(
   );
 }
 
+function continuesOnProviderUnavailable<TStep>(
+  program: StepProgramDatasetProgram<TStep>,
+): boolean {
+  return (
+    program.continueOnProviderUnavailable === true ||
+    program.steps.some(
+      (step) =>
+        isStepProgramDatasetConditionalResolver(
+          (step as StepProgramDatasetStep<unknown>).resolver,
+        ) &&
+        (
+          (
+            step as StepProgramDatasetStep<
+              StepProgramDatasetConditionalResolver<unknown>
+            >
+          ).resolver.when as {
+            __deeplineProviderWaterfall?: unknown;
+          }
+        ).__deeplineProviderWaterfall === true,
+    )
+  );
+}
+
 export class StepProgramDatasetBuilder<
   TStep extends StepProgramDatasetStep<TResolver>,
   TResolver,
@@ -147,7 +171,16 @@ export class StepProgramDatasetBuilder<
     if (!isStepProgramDatasetProgram<TStep>(program)) {
       throw new Error(this.messages.invalidColumnsProgram);
     }
-    this.program.steps = [...this.program.steps, ...program.steps];
+    const continueOnProviderUnavailable =
+      continuesOnProviderUnavailable(program);
+    this.program.steps = [
+      ...this.program.steps,
+      ...program.steps.map((step) =>
+        continueOnProviderUnavailable
+          ? ({ ...step, continueOnProviderUnavailable: true } as TStep)
+          : step,
+      ),
+    ];
     return this;
   }
 

package/dist/bundling-sources/shared_libs/plays/authoring-contract.ts

@@ -495,6 +495,11 @@ export type PlayAuthoringStepOptions<Row, Value = unknown> = {
   readonly staleAfterSeconds?: number;
 };
 
+/** Explicitly mark a step program as a provider fallback waterfall. */
+export type PlayAuthoringStepProgramOptions = {
+  readonly continueOnProviderUnavailable?: boolean;
+};
+
 export type PlayAuthoringStepProgram<
   Input,
   Output,
@@ -504,6 +509,7 @@ export type PlayAuthoringStepProgram<
   readonly kind: 'steps';
   readonly steps: readonly PlayAuthoringStepProgramStep<TContext>[];
   readonly returnResolver?: PlayAuthoringStepResolver<Output, Return, TContext>;
+  readonly continueOnProviderUnavailable?: boolean;
   readonly __inputType?: (input: Input) => void;
   step<Name extends string, Value>(
     name: Name,
@@ -2378,7 +2384,8 @@ export const PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   'export type DatasetColumnDefinition<Row, Value> = { readonly run: (input: DatasetColumnRunInput<Row, Value>) => Value | Promise<Value>; readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean> };',
   "export type ConditionalStepResolver<Row, Value, Else = null> = { readonly kind: 'conditional'; readonly when: (row: Row, index: number) => boolean | Promise<boolean>; readonly run: StepResolver<Row, Value>; readonly elseValue: Else; else<ValueElse>(value: ValueElse): ConditionalStepResolver<Row, Value, ValueElse>; };",
   'export type StepOptions<Row, Value = unknown> = { readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean>; readonly recompute?: boolean; readonly recomputeOnError?: boolean; readonly staleAfterSeconds?: number };',
-  "export type StepProgram<Input, Output, Return = Output> = { readonly kind: 'steps'; readonly steps: readonly PlayStepProgramStep[]; readonly returnResolver?: StepResolver<Output, Return>; readonly __inputType?: (input: Input) => void; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | ConditionalStepResolver<Output, Value> | StepProgramResolver<Output, Value>): StepProgram<Input, Output & Record<Name, Value>, Return>; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | StepProgramResolver<Output, Value>, options: StepOptions<Output, Value>): StepProgram<Input, Output & Record<Name, Value | null>, Return>; return<Value>(resolver: StepResolver<Output, Value>): StepProgram<Input, Output, Value>; };",
+  'export type StepProgramOptions = { readonly continueOnProviderUnavailable?: boolean };',
+  "export type StepProgram<Input, Output, Return = Output> = { readonly kind: 'steps'; readonly steps: readonly PlayStepProgramStep[]; readonly returnResolver?: StepResolver<Output, Return>; readonly continueOnProviderUnavailable?: boolean; readonly __inputType?: (input: Input) => void; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | ConditionalStepResolver<Output, Value> | StepProgramResolver<Output, Value>): StepProgram<Input, Output & Record<Name, Value>, Return>; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | StepProgramResolver<Output, Value>, options: StepOptions<Output, Value>): StepProgram<Input, Output & Record<Name, Value | null>, Return>; return<Value>(resolver: StepResolver<Output, Value>): StepProgram<Input, Output, Value>; };",
   "export type StepProgramResolver<Input, Return> = { readonly kind: 'steps'; readonly steps: readonly PlayStepProgramStep[]; readonly returnResolver?: StepResolver<never, Return>; readonly __inputType?: (input: Input) => void };",
   "export type RunnableStepProgram<Input, Return> = Pick<StepProgram<Input, never, Return>, 'kind' | 'steps' | 'returnResolver' | '__inputType'>;",
   "export type RunnableColumnStepProgram<Return> = Pick<StepProgramResolver<unknown, Return>, 'kind' | 'steps' | 'returnResolver'>;",

package/dist/bundling-sources/shared_libs/tool-execution-error.ts

@@ -367,6 +367,58 @@ export class ProviderTransientError extends ToolExecutionError {
   }
 }
 
+/** Why a provider cannot serve the current read request. */
+export type ProviderUnavailableReason =
+  | ProviderTransientErrorCategory
+  | 'account_capacity';
+
+/**
+ * A provider-owned failure that permits a read waterfall to try its next
+ * provider. This does not include invalid credentials, caller input, or
+ * Deepline billing failures.
+ */
+export type ProviderUnavailableError =
+  | ProviderTransientError
+  | (ToolExecutionError & {
+      readonly origin: 'provider';
+      readonly code: 'PROVIDER_ACCOUNT_CAPACITY';
+    });
+
+/**
+ * Return the provider-specific reason a read cannot run right now.
+ *
+ * `null` means this error must stay loud: it is caller input, an invalid
+ * customer credential, Deepline billing, or an internal failure.
+ */
+export function getProviderUnavailableReason(
+  error: unknown,
+): ProviderUnavailableReason | null {
+  if (error instanceof ProviderTransientError) return error.category;
+  if (
+    error instanceof ToolExecutionError &&
+    error.origin === 'provider' &&
+    error.code === 'PROVIDER_ACCOUNT_CAPACITY'
+  ) {
+    return 'account_capacity';
+  }
+  return null;
+}
+
+/**
+ * Whether a provider cannot serve this read right now.
+ *
+ * Use this in an explicit `catch` to advance a read-only waterfall. For
+ * diagnostics, use `getProviderUnavailableReason(error)`.
+ */
+export function isProviderUnavailable(
+  error: unknown,
+): error is ProviderUnavailableError {
+  return getProviderUnavailableReason(error) !== null;
+}
+
+/** @deprecated Use isProviderUnavailable. */
+export const isProviderWaterfallUnavailableError = isProviderUnavailable;
+
 /** Brand an internal compatibility error after its normalized fields exist. */
 export function brandAsProviderTransientError(value: object): void {
   applyBrand(value, PROVIDER_TRANSIENT_ERROR_BRAND);

package/dist/cli/index.js

@@ -1044,7 +1044,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.60",
+  version: "0.2.62",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -16550,7 +16550,8 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   "export type DatasetColumnDefinition<Row, Value> = { readonly run: (input: DatasetColumnRunInput<Row, Value>) => Value | Promise<Value>; readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean> };",
   "export type ConditionalStepResolver<Row, Value, Else = null> = { readonly kind: 'conditional'; readonly when: (row: Row, index: number) => boolean | Promise<boolean>; readonly run: StepResolver<Row, Value>; readonly elseValue: Else; else<ValueElse>(value: ValueElse): ConditionalStepResolver<Row, Value, ValueElse>; };",
   "export type StepOptions<Row, Value = unknown> = { readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean>; readonly recompute?: boolean; readonly recomputeOnError?: boolean; readonly staleAfterSeconds?: number };",
-  "export type StepProgram<Input, Output, Return = Output> = { readonly kind: 'steps'; readonly steps: readonly PlayStepProgramStep[]; readonly returnResolver?: StepResolver<Output, Return>; readonly __inputType?: (input: Input) => void; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | ConditionalStepResolver<Output, Value> | StepProgramResolver<Output, Value>): StepProgram<Input, Output & Record<Name, Value>, Return>; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | StepProgramResolver<Output, Value>, options: StepOptions<Output, Value>): StepProgram<Input, Output & Record<Name, Value | null>, Return>; return<Value>(resolver: StepResolver<Output, Value>): StepProgram<Input, Output, Value>; };",
+  "export type StepProgramOptions = { readonly continueOnProviderUnavailable?: boolean };",
+  "export type StepProgram<Input, Output, Return = Output> = { readonly kind: 'steps'; readonly steps: readonly PlayStepProgramStep[]; readonly returnResolver?: StepResolver<Output, Return>; readonly continueOnProviderUnavailable?: boolean; readonly __inputType?: (input: Input) => void; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | ConditionalStepResolver<Output, Value> | StepProgramResolver<Output, Value>): StepProgram<Input, Output & Record<Name, Value>, Return>; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | StepProgramResolver<Output, Value>, options: StepOptions<Output, Value>): StepProgram<Input, Output & Record<Name, Value | null>, Return>; return<Value>(resolver: StepResolver<Output, Value>): StepProgram<Input, Output, Value>; };",
   "export type StepProgramResolver<Input, Return> = { readonly kind: 'steps'; readonly steps: readonly PlayStepProgramStep[]; readonly returnResolver?: StepResolver<never, Return>; readonly __inputType?: (input: Input) => void };",
   "export type RunnableStepProgram<Input, Return> = Pick<StepProgram<Input, never, Return>, 'kind' | 'steps' | 'returnResolver' | '__inputType'>;",
   "export type RunnableColumnStepProgram<Return> = Pick<StepProgramResolver<unknown, Return>, 'kind' | 'steps' | 'returnResolver'>;",
@@ -36728,6 +36729,14 @@ function emitPassThrough(command, payload, options) {
 function client() {
   return new DeeplineClient();
 }
+function clientWithTimeout(timeoutSeconds) {
+  if (!timeoutSeconds) return client();
+  const seconds = Number(timeoutSeconds);
+  if (!Number.isFinite(seconds) || seconds <= 0) {
+    throw new Error("--timeout must be a positive number of seconds.");
+  }
+  return new DeeplineClient({ timeout: seconds * 1e3 });
+}
 function readStatus(payload) {
   if (!payload || typeof payload !== "object") return null;
   const record = payload;
@@ -36906,7 +36915,11 @@ async function handleCall(options) {
   const input2 = options.payload ? JSON.parse(options.payload) : {};
   if (options.mode) input2.__execution_mode = options.mode;
   body.input = input2;
-  emitPassThrough("call", await client().callWorkflow(body), options);
+  emitPassThrough(
+    "call",
+    await clientWithTimeout(options.timeout).callWorkflow(body),
+    options
+  );
 }
 async function handleRuns(id, options) {
   const limit = options.limit ? Number(options.limit) : void 0;
@@ -37009,7 +37022,7 @@ Notes:
     )
   ).action(handleSchema);
   withJsonOption2(
-    workflows.command("call").description("Queue a workflow run.").option("--workflow-id <id>", "Workflow id").option("--workflow-name <name>", "Workflow name").option("--payload <json>", "Run input JSON").option("--mode <mode>", "live | dry_run | smoke_test")
+    workflows.command("call").description("Queue a workflow run.").option("--workflow-id <id>", "Workflow id").option("--workflow-name <name>", "Workflow name").option("--payload <json>", "Run input JSON").option("--mode <mode>", "live | dry_run | smoke_test").option("--timeout <seconds>", "API read timeout in seconds.")
   ).action(handleCall);
   withJsonOption2(
     workflows.command("runs <id>").description("List a workflow\u2019s runs.").option("--limit <n>", "Max runs to return")
@@ -37247,25 +37260,6 @@ function detectSkillsAgents(input2) {
   ).map((marker) => marker.agent);
   return detected.length > 0 ? detected : ["*"];
 }
-async function fetchSkillCatalog(baseUrl) {
-  const response = await fetch(skillsIndexUrl(baseUrl));
-  if (!response.ok) {
-    throw new Error(
-      `Skill catalog request failed (status ${response.status}).`
-    );
-  }
-  const index = await response.json();
-  const skillNames = (index.skills ?? []).filter((skill) => skill.install_surface === "v1").map((skill) => skill.name).filter((name) => typeof name === "string" && Boolean(name)).sort((a, b) => a.localeCompare(b));
-  if (skillNames.length === 0) {
-    throw new Error(
-      "The Deepline skill catalog contains no installable skills."
-    );
-  }
-  return {
-    skillNames,
-    version: typeof index.version === "string" && index.version.trim() ? index.version.trim() : "unversioned"
-  };
-}
 function skillsStatePathForScope(baseUrl, scope, root) {
   return scope === "local" && root ? (0, import_node_path21.join)(root, ".deepline", "setup", "skills.json") : (0, import_node_path21.join)(sdkCliStateDirPath(baseUrl), "skills-install.json");
 }
@@ -37384,23 +37378,10 @@ async function runSkillsCommand(options, dependencies = {}) {
     return 2;
   }
   const baseUrl = autoDetectBaseUrl().replace(/\/$/, "");
-  let catalog;
-  try {
-    catalog = options.dryRun ? { skillNames: [...DEFAULT_SDK_SKILL_NAMES], version: "latest" } : await (dependencies.fetchCatalog ?? fetchSkillCatalog)(baseUrl);
-  } catch (error) {
-    printCommandEnvelope(
-      {
-        ok: false,
-        status: "failed",
-        code: "SKILLS_CATALOG_UNAVAILABLE",
-        exitCode: 5,
-        message: error instanceof Error ? error.message : String(error),
-        next: "Retry: deepline skills"
-      },
-      { json: options.json }
-    );
-    return 5;
-  }
+  const catalog = {
+    skillNames: [...DEFAULT_SDK_SKILL_NAMES],
+    version: SDK_VERSION
+  };
   const agents = options.agent ? [options.agent] : detectSkillsAgents({ scope, root });
   const plan = buildSkillsPlan({ baseUrl, scope, root, agents, ...catalog });
   if (options.dryRun) {

package/dist/cli/index.mjs

@@ -1030,7 +1030,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.60",
+  version: "0.2.62",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -16595,7 +16595,8 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   "export type DatasetColumnDefinition<Row, Value> = { readonly run: (input: DatasetColumnRunInput<Row, Value>) => Value | Promise<Value>; readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean> };",
   "export type ConditionalStepResolver<Row, Value, Else = null> = { readonly kind: 'conditional'; readonly when: (row: Row, index: number) => boolean | Promise<boolean>; readonly run: StepResolver<Row, Value>; readonly elseValue: Else; else<ValueElse>(value: ValueElse): ConditionalStepResolver<Row, Value, ValueElse>; };",
   "export type StepOptions<Row, Value = unknown> = { readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean>; readonly recompute?: boolean; readonly recomputeOnError?: boolean; readonly staleAfterSeconds?: number };",
-  "export type StepProgram<Input, Output, Return = Output> = { readonly kind: 'steps'; readonly steps: readonly PlayStepProgramStep[]; readonly returnResolver?: StepResolver<Output, Return>; readonly __inputType?: (input: Input) => void; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | ConditionalStepResolver<Output, Value> | StepProgramResolver<Output, Value>): StepProgram<Input, Output & Record<Name, Value>, Return>; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | StepProgramResolver<Output, Value>, options: StepOptions<Output, Value>): StepProgram<Input, Output & Record<Name, Value | null>, Return>; return<Value>(resolver: StepResolver<Output, Value>): StepProgram<Input, Output, Value>; };",
+  "export type StepProgramOptions = { readonly continueOnProviderUnavailable?: boolean };",
+  "export type StepProgram<Input, Output, Return = Output> = { readonly kind: 'steps'; readonly steps: readonly PlayStepProgramStep[]; readonly returnResolver?: StepResolver<Output, Return>; readonly continueOnProviderUnavailable?: boolean; readonly __inputType?: (input: Input) => void; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | ConditionalStepResolver<Output, Value> | StepProgramResolver<Output, Value>): StepProgram<Input, Output & Record<Name, Value>, Return>; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | StepProgramResolver<Output, Value>, options: StepOptions<Output, Value>): StepProgram<Input, Output & Record<Name, Value | null>, Return>; return<Value>(resolver: StepResolver<Output, Value>): StepProgram<Input, Output, Value>; };",
   "export type StepProgramResolver<Input, Return> = { readonly kind: 'steps'; readonly steps: readonly PlayStepProgramStep[]; readonly returnResolver?: StepResolver<never, Return>; readonly __inputType?: (input: Input) => void };",
   "export type RunnableStepProgram<Input, Return> = Pick<StepProgram<Input, never, Return>, 'kind' | 'steps' | 'returnResolver' | '__inputType'>;",
   "export type RunnableColumnStepProgram<Return> = Pick<StepProgramResolver<unknown, Return>, 'kind' | 'steps' | 'returnResolver'>;",
@@ -36799,6 +36800,14 @@ function emitPassThrough(command, payload, options) {
 function client() {
   return new DeeplineClient();
 }
+function clientWithTimeout(timeoutSeconds) {
+  if (!timeoutSeconds) return client();
+  const seconds = Number(timeoutSeconds);
+  if (!Number.isFinite(seconds) || seconds <= 0) {
+    throw new Error("--timeout must be a positive number of seconds.");
+  }
+  return new DeeplineClient({ timeout: seconds * 1e3 });
+}
 function readStatus(payload) {
   if (!payload || typeof payload !== "object") return null;
   const record = payload;
@@ -36977,7 +36986,11 @@ async function handleCall(options) {
   const input2 = options.payload ? JSON.parse(options.payload) : {};
   if (options.mode) input2.__execution_mode = options.mode;
   body.input = input2;
-  emitPassThrough("call", await client().callWorkflow(body), options);
+  emitPassThrough(
+    "call",
+    await clientWithTimeout(options.timeout).callWorkflow(body),
+    options
+  );
 }
 async function handleRuns(id, options) {
   const limit = options.limit ? Number(options.limit) : void 0;
@@ -37080,7 +37093,7 @@ Notes:
     )
   ).action(handleSchema);
   withJsonOption2(
-    workflows.command("call").description("Queue a workflow run.").option("--workflow-id <id>", "Workflow id").option("--workflow-name <name>", "Workflow name").option("--payload <json>", "Run input JSON").option("--mode <mode>", "live | dry_run | smoke_test")
+    workflows.command("call").description("Queue a workflow run.").option("--workflow-id <id>", "Workflow id").option("--workflow-name <name>", "Workflow name").option("--payload <json>", "Run input JSON").option("--mode <mode>", "live | dry_run | smoke_test").option("--timeout <seconds>", "API read timeout in seconds.")
   ).action(handleCall);
   withJsonOption2(
     workflows.command("runs <id>").description("List a workflow\u2019s runs.").option("--limit <n>", "Max runs to return")
@@ -37327,25 +37340,6 @@ function detectSkillsAgents(input2) {
   ).map((marker) => marker.agent);
   return detected.length > 0 ? detected : ["*"];
 }
-async function fetchSkillCatalog(baseUrl) {
-  const response = await fetch(skillsIndexUrl(baseUrl));
-  if (!response.ok) {
-    throw new Error(
-      `Skill catalog request failed (status ${response.status}).`
-    );
-  }
-  const index = await response.json();
-  const skillNames = (index.skills ?? []).filter((skill) => skill.install_surface === "v1").map((skill) => skill.name).filter((name) => typeof name === "string" && Boolean(name)).sort((a, b) => a.localeCompare(b));
-  if (skillNames.length === 0) {
-    throw new Error(
-      "The Deepline skill catalog contains no installable skills."
-    );
-  }
-  return {
-    skillNames,
-    version: typeof index.version === "string" && index.version.trim() ? index.version.trim() : "unversioned"
-  };
-}
 function skillsStatePathForScope(baseUrl, scope, root) {
   return scope === "local" && root ? join17(root, ".deepline", "setup", "skills.json") : join17(sdkCliStateDirPath(baseUrl), "skills-install.json");
 }
@@ -37464,23 +37458,10 @@ async function runSkillsCommand(options, dependencies = {}) {
     return 2;
   }
   const baseUrl = autoDetectBaseUrl().replace(/\/$/, "");
-  let catalog;
-  try {
-    catalog = options.dryRun ? { skillNames: [...DEFAULT_SDK_SKILL_NAMES], version: "latest" } : await (dependencies.fetchCatalog ?? fetchSkillCatalog)(baseUrl);
-  } catch (error) {
-    printCommandEnvelope(
-      {
-        ok: false,
-        status: "failed",
-        code: "SKILLS_CATALOG_UNAVAILABLE",
-        exitCode: 5,
-        message: error instanceof Error ? error.message : String(error),
-        next: "Retry: deepline skills"
-      },
-      { json: options.json }
-    );
-    return 5;
-  }
+  const catalog = {
+    skillNames: [...DEFAULT_SDK_SKILL_NAMES],
+    version: SDK_VERSION
+  };
   const agents = options.agent ? [options.agent] : detectSkillsAgents({ scope, root });
   const plan = buildSkillsPlan({ baseUrl, scope, root, agents, ...catalog });
   if (options.dryRun) {

package/dist/{compiler-manifest-TgaC4DeD.d.mts → compiler-manifest-DTbs7i9a.d.mts}

@@ -978,6 +978,33 @@ declare class ProviderTransientError extends ToolExecutionError {
     });
     static [Symbol.hasInstance](value: unknown): boolean;
 }
+/** Why a provider cannot serve the current read request. */
+type ProviderUnavailableReason = ProviderTransientErrorCategory | 'account_capacity';
+/**
+ * A provider-owned failure that permits a read waterfall to try its next
+ * provider. This does not include invalid credentials, caller input, or
+ * Deepline billing failures.
+ */
+type ProviderUnavailableError = ProviderTransientError | (ToolExecutionError & {
+    readonly origin: 'provider';
+    readonly code: 'PROVIDER_ACCOUNT_CAPACITY';
+});
+/**
+ * Return the provider-specific reason a read cannot run right now.
+ *
+ * `null` means this error must stay loud: it is caller input, an invalid
+ * customer credential, Deepline billing, or an internal failure.
+ */
+declare function getProviderUnavailableReason(error: unknown): ProviderUnavailableReason | null;
+/**
+ * Whether a provider cannot serve this read right now.
+ *
+ * Use this in an explicit `catch` to advance a read-only waterfall. For
+ * diagnostics, use `getProviderUnavailableReason(error)`.
+ */
+declare function isProviderUnavailable(error: unknown): error is ProviderUnavailableError;
+/** @deprecated Use isProviderUnavailable. */
+declare const isProviderWaterfallUnavailableError: typeof isProviderUnavailable;
 
 declare const SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS: readonly [1, 2, 3];
 type PlayAuthoringContractEdition = (typeof SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS)[number];
@@ -1182,10 +1209,15 @@ type PlayAuthoringStepOptions<Row, Value = unknown> = {
     /** Legacy cell staleness metadata accepted for older authored Plays. */
     readonly staleAfterSeconds?: number;
 };
+/** Explicitly mark a step program as a provider fallback waterfall. */
+type PlayAuthoringStepProgramOptions = {
+    readonly continueOnProviderUnavailable?: boolean;
+};
 type PlayAuthoringStepProgram<Input, Output, TContext, Return = Output> = {
     readonly kind: 'steps';
     readonly steps: readonly PlayAuthoringStepProgramStep<TContext>[];
     readonly returnResolver?: PlayAuthoringStepResolver<Output, Return, TContext>;
+    readonly continueOnProviderUnavailable?: boolean;
     readonly __inputType?: (input: Input) => void;
     step<Name extends string, Value>(name: Name, resolver: PlayAuthoringStepResolver<Output, Value, TContext> | PlayAuthoringConditionalStepResolver<Output, Value, TContext> | PlayAuthoringStepProgramResolver<Output, Value, TContext>): PlayAuthoringStepProgram<Input, Output & Record<Name, Value>, TContext, Return>;
     step<Name extends string, Value>(name: Name, resolver: PlayAuthoringStepResolver<Output, Value, TContext> | PlayAuthoringStepProgramResolver<Output, Value, TContext>, options: PlayAuthoringStepOptions<Output, Value>): PlayAuthoringStepProgram<Input, Output & Record<Name, Value | null>, TContext, Return>;
@@ -2743,4 +2775,4 @@ type PlayCompilerManifest = {
     authoringContract?: AdmittedPlayAuthoringContract;
 };
 
-export { type PlayDatasetInput as $, type PlayAuthoringFetchResponse as A, type PlayAuthoringInputContract as B, type PlayAuthoringStepProgramStep as C, DeeplineError as D, type PlayAuthoringRuntimeStepOptions as E, type PlaySqlListenerDeclaration as F, type PlaySqlListenerEvent as G, type PlaySqlListenerOperation as H, type PlaySqlQuery as I, type PlayAuthoringStepOptions as J, type PlayAuthoringStepProgram as K, type PlayAuthoringStepProgramResolver as L, type PlayAuthoringStepResolver as M, type PlayToolExecutionRequest as N, DEEPLINE_EXTRACTOR_TARGETS as O, type PlayAuthoringContractEdition as P, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS as Q, type DeeplineEmailStatusGetterValue as R, type DeeplineExtractorTarget as S, type ToolExecutionErrorSchemaVersion as T, type DeeplineGetterValue as U, type DeeplineGetterValueMap as V, JOB_CHANGE_STATUS_VALUES as W, type JobChangeStatus as X, PHONE_STATUS_VALUES as Y, type PhoneStatus as Z, type PlayDataset as _, type PlayArtifactKind as a, type PreviousCell as a0, ProviderTransientError as a1, type ProviderTransientErrorCategory as a2, type ToolExecutionErrorCategory as a3, type ToolExecutionErrorOrigin as a4, type ToolExecutionFailureV1 as a5, type ToolExecutionNetworkKind as a6, type ToolExecutionNetworkScope as a7, isDeeplineExtractorTarget as a8, type PlaySandboxRuntimeDeclaration as b, type PlayCompilerManifest as c, PLAY_ARTIFACT_KINDS as d, type PlayRuntimeBackendId as e, ToolExecutionError as f, type ToolExecutionErrorOptions as g, type PlayAuthoringColumnMap as h, type PlayAuthoringColumnResolver as i, type PlayAuthoringRuntimeContext as j, type PlayAuthoringConditionalStepResolver as k, type PlayAuthoringCsvInput as l, type PlayAuthoringCsvOptions as m, type PlayAuthoringDatasetBuilder as n, type PlayAuthoringDatasetColumnDefinition as o, type PlayAuthoringDatasetColumnRunInput as p, type ToolExecuteResult as q, type PlayAuthoringReferenceLike as r, type PlayReturnObject as s, type PlayAuthoringDefineConfig as t, type PlayAuthoringDefinedPlay as u, type PlayAuthoringFetchOptions as v, type PlayAuthoringFileInput as w, type PlayAuthoringBindings as x, type PlayAuthoringCallExecution as y, type PlayAuthoringCallOptions as z };
+export { type PlayDataset as $, type PlayAuthoringFetchResponse as A, type PlayAuthoringInputContract as B, type PlayAuthoringStepProgramStep as C, DeeplineError as D, type PlayAuthoringRuntimeStepOptions as E, type PlaySqlListenerDeclaration as F, type PlaySqlListenerEvent as G, type PlaySqlListenerOperation as H, type PlaySqlQuery as I, type PlayAuthoringStepOptions as J, type PlayAuthoringStepProgram as K, type PlayAuthoringStepProgramResolver as L, type PlayAuthoringStepResolver as M, type PlayToolExecutionRequest as N, type PlayAuthoringStepProgramOptions as O, type PlayAuthoringContractEdition as P, DEEPLINE_EXTRACTOR_TARGETS as Q, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS as R, type DeeplineEmailStatusGetterValue as S, type ToolExecutionErrorSchemaVersion as T, type DeeplineExtractorTarget as U, type DeeplineGetterValue as V, type DeeplineGetterValueMap as W, JOB_CHANGE_STATUS_VALUES as X, type JobChangeStatus as Y, PHONE_STATUS_VALUES as Z, type PhoneStatus as _, type PlayArtifactKind as a, type PlayDatasetInput as a0, type PreviousCell as a1, ProviderTransientError as a2, type ProviderTransientErrorCategory as a3, type ProviderUnavailableError as a4, type ProviderUnavailableReason as a5, type ToolExecutionErrorCategory as a6, type ToolExecutionErrorOrigin as a7, type ToolExecutionFailureV1 as a8, type ToolExecutionNetworkKind as a9, type ToolExecutionNetworkScope as aa, getProviderUnavailableReason as ab, isDeeplineExtractorTarget as ac, isProviderUnavailable as ad, isProviderWaterfallUnavailableError as ae, type PlaySandboxRuntimeDeclaration as b, type PlayCompilerManifest as c, PLAY_ARTIFACT_KINDS as d, type PlayRuntimeBackendId as e, ToolExecutionError as f, type ToolExecutionErrorOptions as g, type PlayAuthoringColumnMap as h, type PlayAuthoringColumnResolver as i, type PlayAuthoringRuntimeContext as j, type PlayAuthoringConditionalStepResolver as k, type PlayAuthoringCsvInput as l, type PlayAuthoringCsvOptions as m, type PlayAuthoringDatasetBuilder as n, type PlayAuthoringDatasetColumnDefinition as o, type PlayAuthoringDatasetColumnRunInput as p, type ToolExecuteResult as q, type PlayAuthoringReferenceLike as r, type PlayReturnObject as s, type PlayAuthoringDefineConfig as t, type PlayAuthoringDefinedPlay as u, type PlayAuthoringFetchOptions as v, type PlayAuthoringFileInput as w, type PlayAuthoringBindings as x, type PlayAuthoringCallExecution as y, type PlayAuthoringCallOptions as z };

package/dist/{compiler-manifest-TgaC4DeD.d.ts → compiler-manifest-DTbs7i9a.d.ts}

@@ -978,6 +978,33 @@ declare class ProviderTransientError extends ToolExecutionError {
     });
     static [Symbol.hasInstance](value: unknown): boolean;
 }
+/** Why a provider cannot serve the current read request. */
+type ProviderUnavailableReason = ProviderTransientErrorCategory | 'account_capacity';
+/**
+ * A provider-owned failure that permits a read waterfall to try its next
+ * provider. This does not include invalid credentials, caller input, or
+ * Deepline billing failures.
+ */
+type ProviderUnavailableError = ProviderTransientError | (ToolExecutionError & {
+    readonly origin: 'provider';
+    readonly code: 'PROVIDER_ACCOUNT_CAPACITY';
+});
+/**
+ * Return the provider-specific reason a read cannot run right now.
+ *
+ * `null` means this error must stay loud: it is caller input, an invalid
+ * customer credential, Deepline billing, or an internal failure.
+ */
+declare function getProviderUnavailableReason(error: unknown): ProviderUnavailableReason | null;
+/**
+ * Whether a provider cannot serve this read right now.
+ *
+ * Use this in an explicit `catch` to advance a read-only waterfall. For
+ * diagnostics, use `getProviderUnavailableReason(error)`.
+ */
+declare function isProviderUnavailable(error: unknown): error is ProviderUnavailableError;
+/** @deprecated Use isProviderUnavailable. */
+declare const isProviderWaterfallUnavailableError: typeof isProviderUnavailable;
 
 declare const SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS: readonly [1, 2, 3];
 type PlayAuthoringContractEdition = (typeof SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS)[number];
@@ -1182,10 +1209,15 @@ type PlayAuthoringStepOptions<Row, Value = unknown> = {
     /** Legacy cell staleness metadata accepted for older authored Plays. */
     readonly staleAfterSeconds?: number;
 };
+/** Explicitly mark a step program as a provider fallback waterfall. */
+type PlayAuthoringStepProgramOptions = {
+    readonly continueOnProviderUnavailable?: boolean;
+};
 type PlayAuthoringStepProgram<Input, Output, TContext, Return = Output> = {
     readonly kind: 'steps';
     readonly steps: readonly PlayAuthoringStepProgramStep<TContext>[];
     readonly returnResolver?: PlayAuthoringStepResolver<Output, Return, TContext>;
+    readonly continueOnProviderUnavailable?: boolean;
     readonly __inputType?: (input: Input) => void;
     step<Name extends string, Value>(name: Name, resolver: PlayAuthoringStepResolver<Output, Value, TContext> | PlayAuthoringConditionalStepResolver<Output, Value, TContext> | PlayAuthoringStepProgramResolver<Output, Value, TContext>): PlayAuthoringStepProgram<Input, Output & Record<Name, Value>, TContext, Return>;
     step<Name extends string, Value>(name: Name, resolver: PlayAuthoringStepResolver<Output, Value, TContext> | PlayAuthoringStepProgramResolver<Output, Value, TContext>, options: PlayAuthoringStepOptions<Output, Value>): PlayAuthoringStepProgram<Input, Output & Record<Name, Value | null>, TContext, Return>;
@@ -2743,4 +2775,4 @@ type PlayCompilerManifest = {
     authoringContract?: AdmittedPlayAuthoringContract;
 };
 
-export { type PlayDatasetInput as $, type PlayAuthoringFetchResponse as A, type PlayAuthoringInputContract as B, type PlayAuthoringStepProgramStep as C, DeeplineError as D, type PlayAuthoringRuntimeStepOptions as E, type PlaySqlListenerDeclaration as F, type PlaySqlListenerEvent as G, type PlaySqlListenerOperation as H, type PlaySqlQuery as I, type PlayAuthoringStepOptions as J, type PlayAuthoringStepProgram as K, type PlayAuthoringStepProgramResolver as L, type PlayAuthoringStepResolver as M, type PlayToolExecutionRequest as N, DEEPLINE_EXTRACTOR_TARGETS as O, type PlayAuthoringContractEdition as P, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS as Q, type DeeplineEmailStatusGetterValue as R, type DeeplineExtractorTarget as S, type ToolExecutionErrorSchemaVersion as T, type DeeplineGetterValue as U, type DeeplineGetterValueMap as V, JOB_CHANGE_STATUS_VALUES as W, type JobChangeStatus as X, PHONE_STATUS_VALUES as Y, type PhoneStatus as Z, type PlayDataset as _, type PlayArtifactKind as a, type PreviousCell as a0, ProviderTransientError as a1, type ProviderTransientErrorCategory as a2, type ToolExecutionErrorCategory as a3, type ToolExecutionErrorOrigin as a4, type ToolExecutionFailureV1 as a5, type ToolExecutionNetworkKind as a6, type ToolExecutionNetworkScope as a7, isDeeplineExtractorTarget as a8, type PlaySandboxRuntimeDeclaration as b, type PlayCompilerManifest as c, PLAY_ARTIFACT_KINDS as d, type PlayRuntimeBackendId as e, ToolExecutionError as f, type ToolExecutionErrorOptions as g, type PlayAuthoringColumnMap as h, type PlayAuthoringColumnResolver as i, type PlayAuthoringRuntimeContext as j, type PlayAuthoringConditionalStepResolver as k, type PlayAuthoringCsvInput as l, type PlayAuthoringCsvOptions as m, type PlayAuthoringDatasetBuilder as n, type PlayAuthoringDatasetColumnDefinition as o, type PlayAuthoringDatasetColumnRunInput as p, type ToolExecuteResult as q, type PlayAuthoringReferenceLike as r, type PlayReturnObject as s, type PlayAuthoringDefineConfig as t, type PlayAuthoringDefinedPlay as u, type PlayAuthoringFetchOptions as v, type PlayAuthoringFileInput as w, type PlayAuthoringBindings as x, type PlayAuthoringCallExecution as y, type PlayAuthoringCallOptions as z };
+export { type PlayDataset as $, type PlayAuthoringFetchResponse as A, type PlayAuthoringInputContract as B, type PlayAuthoringStepProgramStep as C, DeeplineError as D, type PlayAuthoringRuntimeStepOptions as E, type PlaySqlListenerDeclaration as F, type PlaySqlListenerEvent as G, type PlaySqlListenerOperation as H, type PlaySqlQuery as I, type PlayAuthoringStepOptions as J, type PlayAuthoringStepProgram as K, type PlayAuthoringStepProgramResolver as L, type PlayAuthoringStepResolver as M, type PlayToolExecutionRequest as N, type PlayAuthoringStepProgramOptions as O, type PlayAuthoringContractEdition as P, DEEPLINE_EXTRACTOR_TARGETS as Q, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS as R, type DeeplineEmailStatusGetterValue as S, type ToolExecutionErrorSchemaVersion as T, type DeeplineExtractorTarget as U, type DeeplineGetterValue as V, type DeeplineGetterValueMap as W, JOB_CHANGE_STATUS_VALUES as X, type JobChangeStatus as Y, PHONE_STATUS_VALUES as Z, type PhoneStatus as _, type PlayArtifactKind as a, type PlayDatasetInput as a0, type PreviousCell as a1, ProviderTransientError as a2, type ProviderTransientErrorCategory as a3, type ProviderUnavailableError as a4, type ProviderUnavailableReason as a5, type ToolExecutionErrorCategory as a6, type ToolExecutionErrorOrigin as a7, type ToolExecutionFailureV1 as a8, type ToolExecutionNetworkKind as a9, type ToolExecutionNetworkScope as aa, getProviderUnavailableReason as ab, isDeeplineExtractorTarget as ac, isProviderUnavailable as ad, isProviderWaterfallUnavailableError as ae, type PlaySandboxRuntimeDeclaration as b, type PlayCompilerManifest as c, PLAY_ARTIFACT_KINDS as d, type PlayRuntimeBackendId as e, ToolExecutionError as f, type ToolExecutionErrorOptions as g, type PlayAuthoringColumnMap as h, type PlayAuthoringColumnResolver as i, type PlayAuthoringRuntimeContext as j, type PlayAuthoringConditionalStepResolver as k, type PlayAuthoringCsvInput as l, type PlayAuthoringCsvOptions as m, type PlayAuthoringDatasetBuilder as n, type PlayAuthoringDatasetColumnDefinition as o, type PlayAuthoringDatasetColumnRunInput as p, type ToolExecuteResult as q, type PlayAuthoringReferenceLike as r, type PlayReturnObject as s, type PlayAuthoringDefineConfig as t, type PlayAuthoringDefinedPlay as u, type PlayAuthoringFetchOptions as v, type PlayAuthoringFileInput as w, type PlayAuthoringBindings as x, type PlayAuthoringCallExecution as y, type PlayAuthoringCallOptions as z };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest } from './compiler-manifest-TgaC4DeD.mjs';
-export { O as DEEPLINE_EXTRACTOR_TARGETS, Q as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, R as DeeplineEmailStatusGetterValue, S as DeeplineExtractorTarget, U as DeeplineGetterValue, V as DeeplineGetterValueMap, W as JOB_CHANGE_STATUS_VALUES, X as JobChangeStatus, Y as PHONE_STATUS_VALUES, Z as PhoneStatus, _ as PlayDataset, $ as PlayDatasetInput, a0 as PreviousCell, a1 as ProviderTransientError, a2 as ProviderTransientErrorCategory, a3 as ToolExecutionErrorCategory, a4 as ToolExecutionErrorOrigin, a5 as ToolExecutionFailureV1, a6 as ToolExecutionNetworkKind, a7 as ToolExecutionNetworkScope, a8 as isDeeplineExtractorTarget } from './compiler-manifest-TgaC4DeD.mjs';
+import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest, O as PlayAuthoringStepProgramOptions } from './compiler-manifest-DTbs7i9a.mjs';
+export { Q as DEEPLINE_EXTRACTOR_TARGETS, R as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, S as DeeplineEmailStatusGetterValue, U as DeeplineExtractorTarget, V as DeeplineGetterValue, W as DeeplineGetterValueMap, X as JOB_CHANGE_STATUS_VALUES, Y as JobChangeStatus, Z as PHONE_STATUS_VALUES, _ as PhoneStatus, $ as PlayDataset, a0 as PlayDatasetInput, a1 as PreviousCell, a2 as ProviderTransientError, a3 as ProviderTransientErrorCategory, a4 as ProviderUnavailableError, a5 as ProviderUnavailableReason, a6 as ToolExecutionErrorCategory, a7 as ToolExecutionErrorOrigin, a8 as ToolExecutionFailureV1, a9 as ToolExecutionNetworkKind, aa as ToolExecutionNetworkScope, ab as getProviderUnavailableReason, ac as isDeeplineExtractorTarget, ad as isProviderUnavailable, ae as isProviderWaterfallUnavailableError } from './compiler-manifest-DTbs7i9a.mjs';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;
@@ -3908,6 +3908,8 @@ type ConditionalStepResolver<Row, Value, Else = null> = PlayAuthoringConditional
  * @sdkReference runtime 110
  */
 type StepOptions<Row, Value = unknown> = PlayAuthoringStepOptions<Row, Value>;
+/** Explicitly mark a step program as a provider fallback waterfall. */
+type StepProgramOptions = PlayAuthoringStepProgramOptions;
 type StepProgram<Input, Output, Return = Output> = PlayAuthoringStepProgram<Input, Output, DeeplinePlayRuntimeContext, Return>;
 type StepProgramResolver<Input, Return> = PlayAuthoringStepProgramResolver<Input, Return, DeeplinePlayRuntimeContext>;
 type PlayStepProgramStep = PlayAuthoringStepProgramStep<DeeplinePlayRuntimeContext>;
@@ -4189,7 +4191,7 @@ type PlayInputContract<TInput> = PlayAuthoringInputContract<TInput>;
  * @sdkReference runtime 020
  */
 type DefinePlayConfig<TInput, TOutput extends PlayReturnObject> = PlayAuthoringDefineConfig<TInput, TOutput, DeeplinePlayRuntimeContext>;
-declare function steps<TInput>(): StepProgram<TInput, TInput, TInput>;
+declare function steps<TInput>(options?: StepProgramOptions): StepProgram<TInput, TInput, TInput>;
 declare function runIf<Row, Value>(predicate: (row: Row, index: number) => boolean | Promise<boolean>, resolver: StepResolver<Row, Value>): ConditionalStepResolver<Row, Value, null>;
 /**
  * A defined play: both a callable function and a named play handle.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest } from './compiler-manifest-TgaC4DeD.js';
-export { O as DEEPLINE_EXTRACTOR_TARGETS, Q as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, R as DeeplineEmailStatusGetterValue, S as DeeplineExtractorTarget, U as DeeplineGetterValue, V as DeeplineGetterValueMap, W as JOB_CHANGE_STATUS_VALUES, X as JobChangeStatus, Y as PHONE_STATUS_VALUES, Z as PhoneStatus, _ as PlayDataset, $ as PlayDatasetInput, a0 as PreviousCell, a1 as ProviderTransientError, a2 as ProviderTransientErrorCategory, a3 as ToolExecutionErrorCategory, a4 as ToolExecutionErrorOrigin, a5 as ToolExecutionFailureV1, a6 as ToolExecutionNetworkKind, a7 as ToolExecutionNetworkScope, a8 as isDeeplineExtractorTarget } from './compiler-manifest-TgaC4DeD.js';
+import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest, O as PlayAuthoringStepProgramOptions } from './compiler-manifest-DTbs7i9a.js';
+export { Q as DEEPLINE_EXTRACTOR_TARGETS, R as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, S as DeeplineEmailStatusGetterValue, U as DeeplineExtractorTarget, V as DeeplineGetterValue, W as DeeplineGetterValueMap, X as JOB_CHANGE_STATUS_VALUES, Y as JobChangeStatus, Z as PHONE_STATUS_VALUES, _ as PhoneStatus, $ as PlayDataset, a0 as PlayDatasetInput, a1 as PreviousCell, a2 as ProviderTransientError, a3 as ProviderTransientErrorCategory, a4 as ProviderUnavailableError, a5 as ProviderUnavailableReason, a6 as ToolExecutionErrorCategory, a7 as ToolExecutionErrorOrigin, a8 as ToolExecutionFailureV1, a9 as ToolExecutionNetworkKind, aa as ToolExecutionNetworkScope, ab as getProviderUnavailableReason, ac as isDeeplineExtractorTarget, ad as isProviderUnavailable, ae as isProviderWaterfallUnavailableError } from './compiler-manifest-DTbs7i9a.js';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;
@@ -3908,6 +3908,8 @@ type ConditionalStepResolver<Row, Value, Else = null> = PlayAuthoringConditional
  * @sdkReference runtime 110
  */
 type StepOptions<Row, Value = unknown> = PlayAuthoringStepOptions<Row, Value>;
+/** Explicitly mark a step program as a provider fallback waterfall. */
+type StepProgramOptions = PlayAuthoringStepProgramOptions;
 type StepProgram<Input, Output, Return = Output> = PlayAuthoringStepProgram<Input, Output, DeeplinePlayRuntimeContext, Return>;
 type StepProgramResolver<Input, Return> = PlayAuthoringStepProgramResolver<Input, Return, DeeplinePlayRuntimeContext>;
 type PlayStepProgramStep = PlayAuthoringStepProgramStep<DeeplinePlayRuntimeContext>;
@@ -4189,7 +4191,7 @@ type PlayInputContract<TInput> = PlayAuthoringInputContract<TInput>;
  * @sdkReference runtime 020
  */
 type DefinePlayConfig<TInput, TOutput extends PlayReturnObject> = PlayAuthoringDefineConfig<TInput, TOutput, DeeplinePlayRuntimeContext>;
-declare function steps<TInput>(): StepProgram<TInput, TInput, TInput>;
+declare function steps<TInput>(options?: StepProgramOptions): StepProgram<TInput, TInput, TInput>;
 declare function runIf<Row, Value>(predicate: (row: Row, index: number) => boolean | Promise<boolean>, resolver: StepResolver<Row, Value>): ConditionalStepResolver<Row, Value, null>;
 /**
  * A defined play: both a callable function and a named play handle.

package/dist/index.js

@@ -68,9 +68,12 @@ __export(src_exports, {
   formatPlayBootstrapFinderKindsForSentence: () => formatPlayBootstrapFinderKindsForSentence,
   formatPlayBootstrapTemplates: () => formatPlayBootstrapTemplates,
   getDefinedPlayMetadata: () => getDefinedPlayMetadata,
+  getProviderUnavailableReason: () => getProviderUnavailableReason,
   isDeeplineExtractorTarget: () => isDeeplineExtractorTarget,
   isPlayBootstrapFinderKind: () => isPlayBootstrapFinderKind,
   isPlayBootstrapTemplate: () => isPlayBootstrapTemplate,
+  isProviderUnavailable: () => isProviderUnavailable,
+  isProviderWaterfallUnavailableError: () => isProviderWaterfallUnavailableError,
   resolveConfig: () => resolveConfig,
   runIf: () => runIf,
   steps: () => steps,
@@ -231,6 +234,17 @@ var ProviderTransientError = class _ProviderTransientError extends ToolExecution
     return hasBrand(value, PROVIDER_TRANSIENT_ERROR_BRAND);
   }
 };
+function getProviderUnavailableReason(error) {
+  if (error instanceof ProviderTransientError) return error.category;
+  if (error instanceof ToolExecutionError && error.origin === "provider" && error.code === "PROVIDER_ACCOUNT_CAPACITY") {
+    return "account_capacity";
+  }
+  return null;
+}
+function isProviderUnavailable(error) {
+  return getProviderUnavailableReason(error) !== null;
+}
+var isProviderWaterfallUnavailableError = isProviderUnavailable;
 function brandAsProviderTransientError(value) {
   applyBrand(value, PROVIDER_TRANSIENT_ERROR_BRAND);
 }
@@ -763,7 +777,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.60",
+  version: "0.2.62",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -7804,12 +7818,14 @@ var DeeplineConditionalStepResolver = class _DeeplineConditionalStepResolver {
   }
 };
 var DeeplineStepProgram = class _DeeplineStepProgram {
-  constructor(steps2, returnResolver) {
+  constructor(steps2, returnResolver, continueOnProviderUnavailable = false) {
     this.steps = steps2;
     this.returnResolver = returnResolver;
+    this.continueOnProviderUnavailable = continueOnProviderUnavailable;
   }
   steps;
   returnResolver;
+  continueOnProviderUnavailable;
   kind = "steps";
   step(name, resolver, options) {
     if (!name.trim()) {
@@ -7833,18 +7849,27 @@ var DeeplineStepProgram = class _DeeplineStepProgram {
           resolver: stepResolver
         }
       ],
-      this.returnResolver
+      this.returnResolver,
+      this.continueOnProviderUnavailable
     );
   }
   return(resolver) {
-    return new _DeeplineStepProgram(this.steps, resolver);
+    return new _DeeplineStepProgram(
+      this.steps,
+      resolver,
+      this.continueOnProviderUnavailable
+    );
   }
 };
 function isConditionalStepResolver(value) {
   return value !== null && typeof value === "object" && value.kind === "conditional";
 }
-function steps() {
-  return new DeeplineStepProgram([]);
+function steps(options = {}) {
+  return new DeeplineStepProgram(
+    [],
+    void 0,
+    options.continueOnProviderUnavailable === true
+  );
 }
 function runIf(predicate, resolver) {
   return new DeeplineConditionalStepResolver(predicate, resolver, null);
@@ -8657,9 +8682,12 @@ function extractSummaryFields(payload) {
   formatPlayBootstrapFinderKindsForSentence,
   formatPlayBootstrapTemplates,
   getDefinedPlayMetadata,
+  getProviderUnavailableReason,
   isDeeplineExtractorTarget,
   isPlayBootstrapFinderKind,
   isPlayBootstrapTemplate,
+  isProviderUnavailable,
+  isProviderWaterfallUnavailableError,
   resolveConfig,
   runIf,
   steps,

package/dist/index.mjs

@@ -157,6 +157,17 @@ var ProviderTransientError = class _ProviderTransientError extends ToolExecution
     return hasBrand(value, PROVIDER_TRANSIENT_ERROR_BRAND);
   }
 };
+function getProviderUnavailableReason(error) {
+  if (error instanceof ProviderTransientError) return error.category;
+  if (error instanceof ToolExecutionError && error.origin === "provider" && error.code === "PROVIDER_ACCOUNT_CAPACITY") {
+    return "account_capacity";
+  }
+  return null;
+}
+function isProviderUnavailable(error) {
+  return getProviderUnavailableReason(error) !== null;
+}
+var isProviderWaterfallUnavailableError = isProviderUnavailable;
 function brandAsProviderTransientError(value) {
   applyBrand(value, PROVIDER_TRANSIENT_ERROR_BRAND);
 }
@@ -689,7 +700,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.60",
+  version: "0.2.62",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -7730,12 +7741,14 @@ var DeeplineConditionalStepResolver = class _DeeplineConditionalStepResolver {
   }
 };
 var DeeplineStepProgram = class _DeeplineStepProgram {
-  constructor(steps2, returnResolver) {
+  constructor(steps2, returnResolver, continueOnProviderUnavailable = false) {
     this.steps = steps2;
     this.returnResolver = returnResolver;
+    this.continueOnProviderUnavailable = continueOnProviderUnavailable;
   }
   steps;
   returnResolver;
+  continueOnProviderUnavailable;
   kind = "steps";
   step(name, resolver, options) {
     if (!name.trim()) {
@@ -7759,18 +7772,27 @@ var DeeplineStepProgram = class _DeeplineStepProgram {
           resolver: stepResolver
         }
       ],
-      this.returnResolver
+      this.returnResolver,
+      this.continueOnProviderUnavailable
     );
   }
   return(resolver) {
-    return new _DeeplineStepProgram(this.steps, resolver);
+    return new _DeeplineStepProgram(
+      this.steps,
+      resolver,
+      this.continueOnProviderUnavailable
+    );
   }
 };
 function isConditionalStepResolver(value) {
   return value !== null && typeof value === "object" && value.kind === "conditional";
 }
-function steps() {
-  return new DeeplineStepProgram([]);
+function steps(options = {}) {
+  return new DeeplineStepProgram(
+    [],
+    void 0,
+    options.continueOnProviderUnavailable === true
+  );
 }
 function runIf(predicate, resolver) {
   return new DeeplineConditionalStepResolver(predicate, resolver, null);
@@ -8588,9 +8610,12 @@ export {
   formatPlayBootstrapFinderKindsForSentence,
   formatPlayBootstrapTemplates,
   getDefinedPlayMetadata,
+  getProviderUnavailableReason,
   isDeeplineExtractorTarget,
   isPlayBootstrapFinderKind,
   isPlayBootstrapTemplate,
+  isProviderUnavailable,
+  isProviderWaterfallUnavailableError,
   resolveConfig,
   runIf,
   steps,

package/dist/install-integrity.json

@@ -225,8 +225,8 @@
     "dist/cli/index.d.ts",
     "dist/cli/index.js",
     "dist/cli/index.mjs",
-    "dist/compiler-manifest-TgaC4DeD.d.mts",
-    "dist/compiler-manifest-TgaC4DeD.d.ts",
+    "dist/compiler-manifest-DTbs7i9a.d.mts",
+    "dist/compiler-manifest-DTbs7i9a.d.ts",
     "dist/helpers.d.mts",
     "dist/helpers.d.ts",
     "dist/helpers.js",

package/dist/plays/bundle-play-file.d.mts

@@ -1,5 +1,5 @@
-import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-TgaC4DeD.mjs';
-export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-TgaC4DeD.mjs';
+import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-DTbs7i9a.mjs';
+export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-DTbs7i9a.mjs';
 import '@sinclair/typebox';
 
 type PlayPackageImport = {

package/dist/plays/bundle-play-file.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-TgaC4DeD.js';
-export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-TgaC4DeD.js';
+import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-DTbs7i9a.js';
+export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-DTbs7i9a.js';
 import '@sinclair/typebox';
 
 type PlayPackageImport = {

package/dist/plays/bundle-play-file.mjs

@@ -3942,7 +3942,8 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   "export type DatasetColumnDefinition<Row, Value> = { readonly run: (input: DatasetColumnRunInput<Row, Value>) => Value | Promise<Value>; readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean> };",
   "export type ConditionalStepResolver<Row, Value, Else = null> = { readonly kind: 'conditional'; readonly when: (row: Row, index: number) => boolean | Promise<boolean>; readonly run: StepResolver<Row, Value>; readonly elseValue: Else; else<ValueElse>(value: ValueElse): ConditionalStepResolver<Row, Value, ValueElse>; };",
   "export type StepOptions<Row, Value = unknown> = { readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean>; readonly recompute?: boolean; readonly recomputeOnError?: boolean; readonly staleAfterSeconds?: number };",
-  "export type StepProgram<Input, Output, Return = Output> = { readonly kind: 'steps'; readonly steps: readonly PlayStepProgramStep[]; readonly returnResolver?: StepResolver<Output, Return>; readonly __inputType?: (input: Input) => void; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | ConditionalStepResolver<Output, Value> | StepProgramResolver<Output, Value>): StepProgram<Input, Output & Record<Name, Value>, Return>; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | StepProgramResolver<Output, Value>, options: StepOptions<Output, Value>): StepProgram<Input, Output & Record<Name, Value | null>, Return>; return<Value>(resolver: StepResolver<Output, Value>): StepProgram<Input, Output, Value>; };",
+  "export type StepProgramOptions = { readonly continueOnProviderUnavailable?: boolean };",
+  "export type StepProgram<Input, Output, Return = Output> = { readonly kind: 'steps'; readonly steps: readonly PlayStepProgramStep[]; readonly returnResolver?: StepResolver<Output, Return>; readonly continueOnProviderUnavailable?: boolean; readonly __inputType?: (input: Input) => void; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | ConditionalStepResolver<Output, Value> | StepProgramResolver<Output, Value>): StepProgram<Input, Output & Record<Name, Value>, Return>; step<Name extends string, Value>(name: Name, resolver: StepResolver<Output, Value> | StepProgramResolver<Output, Value>, options: StepOptions<Output, Value>): StepProgram<Input, Output & Record<Name, Value | null>, Return>; return<Value>(resolver: StepResolver<Output, Value>): StepProgram<Input, Output, Value>; };",
   "export type StepProgramResolver<Input, Return> = { readonly kind: 'steps'; readonly steps: readonly PlayStepProgramStep[]; readonly returnResolver?: StepResolver<never, Return>; readonly __inputType?: (input: Input) => void };",
   "export type RunnableStepProgram<Input, Return> = Pick<StepProgram<Input, never, Return>, 'kind' | 'steps' | 'returnResolver' | '__inputType'>;",
   "export type RunnableColumnStepProgram<Return> = Pick<StepProgramResolver<unknown, Return>, 'kind' | 'steps' | 'returnResolver'>;",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.2.60",
+  "version": "0.2.62",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",