@cueframe/kernel 0.2.32 → 0.2.34

package/dist/_members/errors/registry.d.ts

@@ -5,6 +5,8 @@ export interface ErrorSpec {
     category: ErrorCategory;
     retryable: boolean;
     httpStatus: number;
+    /** Overrides the derived wait; see `retryAfterSecondsFor`. */
+    retryAfterSeconds?: number;
 }
 export declare const ERROR_CODES: {
     readonly unauthorized: {
@@ -1649,6 +1651,8 @@ export declare class CueframeError extends Error {
 export declare function encodeError(e: CueframeError): string;
 export declare function decodeError(msg: string): CueframeError | null;
 export declare function scrubSensitive(s: string): string;
+/** Seconds to wait before retrying, or undefined when retrying will not help. */
+export declare function retryAfterSecondsFor(code: ErrorCode): number | undefined;
 export declare function toWireEnvelope(e: Envelope, opts?: {
     trusted?: boolean;
 }): Envelope;

package/dist/_members/render-harness/assetRefs.d.ts

@@ -0,0 +1,26 @@
+/**
+ * What counts as a reference to something OUTSIDE this document.
+ *
+ * Two guards ask that question about card HTML — `cardAssetAdmission`'s CSS/HTML
+ * walk and `renderInputAssets`'s `suspiciousUnannotatedAsset` sweep — and they
+ * disagreed. The walk knew that `url(#local-id)` is a same-document fragment;
+ * the sweep matched a bare `url(` and refused it.
+ *
+ * The visible cost: an inline `<svg>` using `clip-path="url(#mark-clip)"` passed
+ * the guard that understands SVG and was refused by the one that does not, so the
+ * org's own logo could not be inlined without rewriting it (CUE-31 sibling,
+ * reported 2026-09-17). A fragment reference is the OPPOSITE of remote — it
+ * cannot leave the document — and every guard has to agree on that.
+ *
+ * One definition, imported by both.
+ */
+/** `url(#id)`, `href="#id"` — resolves inside this document, never over a network. */
+export declare function isFragmentReference(value: string): boolean;
+/** Every `url(...)` payload in a CSS value, unquoted. */
+export declare function cssUrlPayloads(value: string): string[];
+/**
+ * Does this CSS value reach outside the document? True only when it carries a
+ * `url()` whose payload is not a same-document fragment.
+ */
+export declare function hasNonFragmentCssUrl(value: string): boolean;
+//# sourceMappingURL=assetRefs.d.ts.map

package/dist/_members/render-harness/assetRefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetRefs.d.ts","sourceRoot":"","sources":["../src/assetRefs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAEtD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAI3D"}

package/dist/_members/render-harness/cardAssetAdmission.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cardAssetAdmission.d.ts","sourceRoot":"","sources":["../src/cardAssetAdmission.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA+GzD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAQhE"}
+{"version":3,"file":"cardAssetAdmission.d.ts","sourceRoot":"","sources":["../src/cardAssetAdmission.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA4GzD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAQhE"}

package/dist/_members/render-harness/cardFonts.d.ts

@@ -0,0 +1,13 @@
+/** The `font-family` stacks a card's HTML declares, deduplicated. */
+export declare function cardFontFamilyStacks(html: string): string[];
+/**
+ * The bundled families a card's HTML names, in the order a renderer should load them.
+ *
+ * The loader half of the same question `assertCardFontsAdmitted` gates on, off the
+ * same extraction, so the faces a card is ALLOWED to name and the faces a renderer
+ * actually registers cannot drift apart. Entries that are not bundled (a generic,
+ * a system face) are dropped: there is nothing to load for them.
+ */
+export declare function cardBundledFamilies(html: string): string[];
+export declare function assertCardFontsAdmitted(html: string, locator: string): void;
+//# sourceMappingURL=cardFonts.d.ts.map

package/dist/_members/render-harness/cardFonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cardFonts.d.ts","sourceRoot":"","sources":["../src/cardFonts.ts"],"names":[],"mappings":"AAqEA,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAI3D;AAmCD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ1D;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAa3E"}

package/dist/_members/render-harness/cardRender.d.ts

@@ -5,6 +5,7 @@ export declare function generateCardRootSource(opts: {
     width: number;
     height: number;
     fps: number;
+    renderEntryRoot: string;
 }): string;
 export declare function generateCardEntrySource(): string;
 export declare function buildCardWebpackOverride(renderEntryRoot: string): (config: any) => any;

package/dist/_members/render-harness/cardRender.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cardRender.d.ts","sourceRoot":"","sources":["../src/cardRender.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AACvD,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAE1D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA6BnG;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAED,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,IACtD,QAAQ,GAAG,SAOpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA0D7F"}
+{"version":3,"file":"cardRender.d.ts","sourceRoot":"","sources":["../src/cardRender.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AACvD,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAE1D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CAkDT;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAED,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,IACtD,QAAQ,GAAG,SAOpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAgE7F"}

package/dist/_members/render-harness/css-tree-subpaths.d.ts

@@ -9,3 +9,8 @@ declare module 'css-tree/walker' {
   const walk: typeof import('css-tree').walk;
   export default walk;
 }
+
+declare module 'css-tree/generator' {
+  const generate: typeof import('css-tree').generate;
+  export default generate;
+}

package/dist/_members/render-harness/renderInputAssets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderInputAssets.d.ts","sourceRoot":"","sources":["../src/renderInputAssets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,OAAO,GACP,cAAc,GACd,MAAM,GACN,YAAY,GACZ,gBAAgB,CAAC;AAErB,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAM/C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,IAAI,MAAM,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AA8GD,wBAAiB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC,SAAS,CAAC,CAoDpE;AAsBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,QAAQ,EAAE,CAYhE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CA2C3D"}
+{"version":3,"file":"renderInputAssets.d.ts","sourceRoot":"","sources":["../src/renderInputAssets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,OAAO,GACP,cAAc,GACd,MAAM,GACN,YAAY,GACZ,gBAAgB,CAAC;AAErB,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAM/C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,IAAI,MAAM,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAkHD,wBAAiB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC,SAAS,CAAC,CAoDpE;AAsBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,QAAQ,EAAE,CAYhE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CA2C3D"}

package/dist/authoring.js

@@ -48,7 +48,7 @@ import {
   formatPlanSteps,
   initCodeGenPrompts
 } from "./chunk-Y4HPN4BC.js";
-import "./chunk-Q244EHRI.js";
+import "./chunk-GMVUJYPM.js";
 import {
   cssLayoutVars
 } from "./chunk-W5W3FDDI.js";
@@ -62,7 +62,7 @@ import "./chunk-WPZKOVYF.js";
 import "./chunk-B7J5UUUV.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-WYKUWRQG.js";
+import "./chunk-A3MXR6JI.js";
 import "./chunk-7PA7FGLD.js";
 import {
   collectSceneClipIssues,

package/dist/{chunk-LLC6TCH5.js → chunk-3GNTA646.js}

@@ -1,7 +1,7 @@
 import {
   CueframeError,
   encodeError
-} from "./chunk-WYKUWRQG.js";
+} from "./chunk-A3MXR6JI.js";
 
 // ../execution/core/src/render/vcam/constants.ts
 var P_MIN = 0.5;

package/dist/{chunk-LEJ5QXHP.js → chunk-4RREA7VA.js}

@@ -1,6 +1,10 @@
+import {
+  cssUrlPayloads,
+  isFragmentReference
+} from "./chunk-OSMXQV5V.js";
 import {
   CueframeError
-} from "./chunk-WYKUWRQG.js";
+} from "./chunk-A3MXR6JI.js";
 
 // ../execution/render-harness/src/cardAssetAdmission.ts
 import parseCss from "css-tree/parser";
@@ -41,9 +45,6 @@ var CSS_VALUE_ATTRIBUTES = /* @__PURE__ */ new Set([
   "mask",
   "stroke"
 ]);
-function isFragmentReference(value) {
-  return value.trim().startsWith("#");
-}
 function refuse(locator, reason) {
   throw new CueframeError(
     "card_external_asset_forbidden",
@@ -84,8 +85,8 @@ function assertNodeAssetFree(node, locator) {
       }
       if (name === "style") assertCssAssetFree(attr.value, "declarationList", locator);
       if (CSS_VALUE_ATTRIBUTES.has(name)) {
-        for (const match of attr.value.matchAll(/url\(\s*(['"]?)(.*?)\1\s*\)/gi)) {
-          if (!isFragmentReference(match[2] ?? "")) {
+        for (const payload of cssUrlPayloads(attr.value)) {
+          if (!isFragmentReference(payload)) {
             refuse(locator, `contains an unmanifested ${name} url() asset reference`);
           }
         }

package/dist/{chunk-3OOMVQ6I.js → chunk-5YO4LAB7.js}

@@ -312,7 +312,7 @@ Call wait_job(kind="compose", id="${j.composeJobId}", projectId="${a.projectId}"
     name: "apply_composition",
     operationId: "applyComposition",
     pathArgs: { projectId: "id" },
-    description: 'Atomically apply an array of CompositionOps to a project composition. All ops succeed or none do (transactional). Pass `if_match` for optimistic-concurrency control (409 stale_etag on mismatch) and `dry_run: true` to validate the batch without persisting. Use this to seed a composition (add media clips) or make targeted edits (set a crop intent, reorder clips, set the format). CAPTIONS: attach content with {type:"captions.fromTranscript", mediaId, window?} \u2014 the server slices the cached word-timed transcript, rebases times, and sentence-splits into segments (no pasting words; 422 media_no_transcript if the media has no speech); style it with {type:"setCaptionStyle", style}; or set explicit words with {type:"setCaptions", segments, style?} (e.g. translations or your own VO timings). Brand is NOT set here \u2014 it lives on the project (create_project / update_project with brandKitId \u2014 or PATCH /projects/:id over REST). CARDS: a {kind:"card", html, tokens} clip projects each `tokens` KEY `x` to the CSS custom property `--cf-x`, so the html must read it as `var(--cf-x)` \u2014 write `tokens:{"plate":"#0af"}` + `background:var(--cf-plate)`. Do NOT put dashes in the key: `"--plate"` becomes `--cf---plate` and your `var(--plate)` then resolves to NOTHING, which CSS silently degrades to a transparent background and black text. Responses carry `warnings[]` when a card reads a var nothing defines. SCENE SHOTS: for a 3D product shot \u2014 a tilted page screenshot, a lit laptop/phone showing a real screenshot, two-colour type, a colour-field backdrop, focus/grain/vignette and a camera move \u2014 use {type:"scene.add", clipId, newTrack|trackId, startTime, duration, scene, assets} and revise it with {type:"scene.update", clipId, scene?, assets?, startTime?, duration?}. You author a scene SPEC, never wrapper TSX; the server registers the component for you. There is NO built-in scene primitive in list_catalog \u2014 READ cueframe://scene-shot first for the JSON schema, the canonical V2 world-objects recipe with nested groups, slabs, pages, phones, laptops, world/screen text, admitted surfaces, camera motion, lighting, and the current resource limits.',
+    description: 'Atomically apply an array of CompositionOps to a project composition. All ops succeed or none do (transactional). Pass `if_match` for optimistic-concurrency control (409 stale_etag on mismatch) and `dry_run: true` to validate the batch without persisting. Ops land on the project\'s ACTIVE composition unless you pass `composition_id` (mutually exclusive with `session_id`), which targets a specific one \u2014 that is how you author a second composition minted with new_composition and run an A/B. Use this to seed a composition (add media clips) or make targeted edits (set a crop intent, reorder clips, set the format). CAPTIONS: attach content with {type:"captions.fromTranscript", mediaId, window?} \u2014 the server slices the cached word-timed transcript, rebases times, and sentence-splits into segments (no pasting words; 422 media_no_transcript if the media has no speech); style it with {type:"setCaptionStyle", style}; or set explicit words with {type:"setCaptions", segments, style?} (e.g. translations or your own VO timings). Brand is NOT set here \u2014 it lives on the project (create_project / update_project with brandKitId \u2014 or PATCH /projects/:id over REST). CARDS: a {kind:"card", html, tokens} clip projects each `tokens` KEY `x` to the CSS custom property `--cf-x`, so the html must read it as `var(--cf-x)` \u2014 write `tokens:{"plate":"#0af"}` + `background:var(--cf-plate)`. Do NOT put dashes in the key: `"--plate"` becomes `--cf---plate` and your `var(--plate)` then resolves to NOTHING, which CSS silently degrades to a transparent background and black text. Responses carry `warnings[]` when a card reads a var nothing defines. SCENE SHOTS: for a 3D product shot \u2014 a tilted page screenshot, a lit laptop/phone showing a real screenshot, two-colour type, a colour-field backdrop, focus/grain/vignette and a camera move \u2014 use {type:"scene.add", clipId, newTrack|trackId, startTime, duration, scene, assets} and revise it with {type:"scene.update", clipId, scene?, assets?, startTime?, duration?}. You author a scene SPEC, never wrapper TSX; the server registers the component for you. There is NO built-in scene primitive in list_catalog \u2014 READ cueframe://scene-shot first for the JSON schema, the canonical V2 world-objects recipe with nested groups, slabs, pages, phones, laptops, world/screen text, admitted surfaces, camera motion, lighting, and the current resource limits.',
     okFormat: (j, a) => {
       const warns = formatWarnings(j);
       if (j && typeof j.valid === "boolean") {
@@ -569,7 +569,7 @@ etag: ${j.etag}`
     name: "get_composition",
     operationId: "getComposition",
     pathArgs: { projectId: "id" },
-    description: "READ BACK the project's active composition as JSON \u2014 the edit itself: tracks, clips, card HTML, reframe segments, captions, markers, format. This is what create_render encodes, so it is also what you hand to validate_composition (which needs a full inline composition body), what you diff after an edit, and what you archive/share so someone else can re-render the SAME video. Read-only and free. Authoring stays op-based (apply_composition) \u2014 do not round-trip this object back as a write. A composition too large to fit one MCP result degrades to a STRUCTURAL SUMMARY (every track and clip still listed; card html and caption words elided as lengths) with a header saying so \u2014 read it over REST if you need the verbatim body.",
+    description: "READ BACK a composition as JSON \u2014 the edit itself: tracks, clips, card HTML, reframe segments, captions, markers, format. This is what create_render encodes, so it is also what you hand to validate_composition (which needs a full inline composition body), what you diff after an edit, and what you archive/share so someone else can re-render the SAME video. Read-only and free. Authoring stays op-based (apply_composition) \u2014 do not round-trip this object back as a write. A composition too large to fit one MCP result degrades to a STRUCTURAL SUMMARY (every track and clip still listed; card html and caption words elided as lengths) with a header saying so \u2014 read it over REST if you need the verbatim body. Defaults to the project's ACTIVE composition; pass `compositionId` to read a specific one (the same id apply_composition takes as `composition_id`, and preview_frame / create_render take as compositionId) so an A/B variant can be read back, not just written.",
     okFormat: (j) => formatComposition(j),
     annotations: { readOnlyHint: true }
   },

package/dist/{chunk-WYKUWRQG.js → chunk-A3MXR6JI.js}

@@ -440,6 +440,34 @@ function scrubAll(obj) {
   for (const [k, v] of Object.entries(obj)) out[k] = scrubVal(v);
   return Object.keys(out).length ? out : void 0;
 }
+var DEFAULT_RETRY_AFTER_SECONDS = 30;
+var BUSY_RETRY_AFTER_SECONDS = 5;
+var PROVIDER_RETRY_AFTER_SECONDS = 60;
+var RETRY_AFTER_OVERRIDES = {
+  idempotency_conflict: BUSY_RETRY_AFTER_SECONDS,
+  resource_import_in_flight: BUSY_RETRY_AFTER_SECONDS,
+  capture_busy: BUSY_RETRY_AFTER_SECONDS,
+  snapshot_stale: BUSY_RETRY_AFTER_SECONDS,
+  too_many_active_sessions: BUSY_RETRY_AFTER_SECONDS,
+  rate_limited: PROVIDER_RETRY_AFTER_SECONDS,
+  billing_unavailable: PROVIDER_RETRY_AFTER_SECONDS,
+  render_provider_unreachable: PROVIDER_RETRY_AFTER_SECONDS,
+  render_provider_start_failed: PROVIDER_RETRY_AFTER_SECONDS,
+  render_pipeline_unavailable: PROVIDER_RETRY_AFTER_SECONDS,
+  sighted_provider_unreachable: PROVIDER_RETRY_AFTER_SECONDS,
+  lambda_infra_failed: PROVIDER_RETRY_AFTER_SECONDS,
+  pipeline_unavailable: PROVIDER_RETRY_AFTER_SECONDS,
+  mux_unavailable: PROVIDER_RETRY_AFTER_SECONDS,
+  import_unavailable: PROVIDER_RETRY_AFTER_SECONDS,
+  import_source_unreachable: PROVIDER_RETRY_AFTER_SECONDS,
+  generator_unavailable: PROVIDER_RETRY_AFTER_SECONDS,
+  service_unavailable: PROVIDER_RETRY_AFTER_SECONDS
+};
+function retryAfterSecondsFor(code) {
+  const spec = ERROR_CODES[code];
+  if (!spec?.retryable) return void 0;
+  return spec.retryAfterSeconds ?? RETRY_AFTER_OVERRIDES[code] ?? DEFAULT_RETRY_AFTER_SECONDS;
+}
 function toWireEnvelope(e, opts) {
   const trusted = opts?.trusted ?? false;
   let message;
@@ -455,7 +483,10 @@ function toWireEnvelope(e, opts) {
     fix = pickScrub(e.fix, FIX_ALLOW);
   }
   const locator = pickScrub(e.locator, LOCATOR_ALLOW);
-  return { ...e, message, fix, locator };
+  const thrown = typeof fix?.retryAfter === "number" ? fix.retryAfter : void 0;
+  const retryAfter = thrown ?? retryAfterSecondsFor(e.code);
+  const withRetry = retryAfter === void 0 ? fix : { ...fix ?? {}, retryAfter };
+  return { ...e, message, fix: withRetry, locator };
 }
 
 export {
@@ -464,5 +495,6 @@ export {
   encodeError,
   decodeError,
   scrubSensitive,
+  retryAfterSecondsFor,
   toWireEnvelope
 };