@civitai/app-sdk 0.67.0 → 0.68.0

package/README.md

@@ -169,6 +169,10 @@ own key:
   `'chat-completion'`, …). The wire enum is derived from the host's step registry, so an
   unregistered id is rejected fail-closed at the schema, and `params` are validated by that
   step's own `.strict()` schema.
+  An estimate the host has no price quote for fails with no `cost` and `snapshot.errorCode`
+  `step_quote_rejected` (refused; the same body will fail again), `step_quote_unavailable` (no
+  usable answer; the one a retry can clear) or `step_quote_unpriced` (an answer without a price).
+  The submit is unchanged. An older host prices that estimate at the step's declared estimate.
 - **`WorkflowBodyPassThroughStep`** (`step` ABSENT) — names an **orchestrator `$type`** directly
   and the host forwards `input` unmodified. There is no registry lookup, no param schema, no
   prompt audit and no AIR scan; what bounds it is a denylist of platform-internal `$type`s

package/dist/blocks/types.d.ts

@@ -1756,6 +1756,10 @@ export interface BlockWorkflowSnapshot {
      * `workflow_quote_*` codes, which are ESTIMATE-ONLY (`estimate()` and a
      * batch-estimate cell): `submit()` of the same body defines no such refusal
      * and proceeds, reserved at the ceiling.
+     * A REGISTERED `step` body ({@link WorkflowBodyStep}) the host has no price
+     * quote for gets one of the three `step_quote_*` codes, also ESTIMATE-ONLY
+     * (`estimate()` and a batch-estimate cell); its `submit()` is unchanged. The
+     * pass-through `step` arm does not set them.
      *
      * The values the host sends today ({@link KnownBlockWorkflowErrorCode}):
      *  - `'training-quote-rejected'` — the orchestrator refused the request
@@ -1808,6 +1812,24 @@ export interface BlockWorkflowSnapshot {
      * Each `workflow_quote_*` reply is `{ workflowId: 'failed', status: 'failed',
      * error, errorCode }` with NO `cost`. A host that predates these codes
      * resolves the estimate instead, with the spend ceiling as `cost.total`.
+     *  - `'step_quote_rejected'` — ESTIMATE only, registered `step` body. The
+     *    orchestrator refused the request; resending the same body will not help.
+     *    `error` reads `No price quote for this step: the orchestrator rejected
+     *    the request: <reason>` when the reason is safe to show, else `No price
+     *    quote for this step: the orchestrator rejected the request; check the
+     *    step inputs and references (retrying the same body will not help)`.
+     *  - `'step_quote_unavailable'` — ESTIMATE only, registered `step` body. No
+     *    usable answer (an outage, a timeout, a rate limit, …). The one
+     *    `step_quote_*` code a retry of the same body can clear. `error` reads
+     *    `No price quote for this step: none could be obtained; try again`.
+     *  - `'step_quote_unpriced'` — ESTIMATE only, registered `step` body. The
+     *    orchestrator answered without a price. `error` reads `No price quote for
+     *    this step: the orchestrator answered without one`.
+     *
+     * Each `step_quote_*` reply is `{ workflowId: 'failed', status: 'failed',
+     * error, errorCode }` with NO `cost`. A host that predates these codes
+     * resolves the estimate instead, priced at the step's declared estimate, so
+     * there a registered-step estimate may not be a quote.
      *
      * 🔴 AN UNKNOWN VALUE IS POSSIBLE: the host may add codes, and the SDK's
      * inbound validator accepts any string here. Handle an unrecognised code as a
@@ -2230,7 +2252,7 @@ export type ModelSubstitutionReason = 'wrong-workflow' | 'unrecognized' | 'gated
  * and the SDK's inbound validator accepts any string. Handle an unrecognised
  * code as a generic failure.
  */
-export type KnownBlockWorkflowErrorCode = 'training-quote-rejected' | 'training-quote-unavailable' | 'training-quote-unpriced' | 'daily-limit-exceeded' | 'workflow_step_denied' | 'workflow_ref_invalid' | 'workflow_too_many_steps' | 'workflow_repeat_unbounded' | 'workflow_quote_rejected' | 'workflow_quote_unavailable' | 'workflow_quote_unpriced';
+export type KnownBlockWorkflowErrorCode = 'training-quote-rejected' | 'training-quote-unavailable' | 'training-quote-unpriced' | 'daily-limit-exceeded' | 'workflow_step_denied' | 'workflow_ref_invalid' | 'workflow_too_many_steps' | 'workflow_repeat_unbounded' | 'workflow_quote_rejected' | 'workflow_quote_unavailable' | 'workflow_quote_unpriced' | 'step_quote_rejected' | 'step_quote_unavailable' | 'step_quote_unpriced';
 /** One entry of {@link BlockWorkflowSnapshot.modelSubstitutions}. */
 export interface BlockModelSubstitution {
     /** The checkpoint version id the block asked for. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@civitai/app-sdk",
-  "version": "0.67.0",
+  "version": "0.68.0",
   "description": "OAuth + PKCE, encrypted-cookie sessions, scopes, and orchestrator helpers for building third-party Civitai apps.",
   "license": "MIT",
   "type": "module",