@cat-factory/contracts 0.212.0 → 0.214.0

package/dist/binary-generators.d.ts

@@ -54,7 +54,7 @@ export declare const binaryGeneratorDefinitionSchema: v.ObjectSchema<{
      * The content types it produces. At least one: a generator that produces nothing is not a
      * generator, and an empty list would make it match every step's requirements by vacuity.
      */
-    readonly modalities: v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<["image", "audio", "video", "3d", "document"], undefined>, undefined>, v.MinLengthAction<("3d" | "audio" | "document" | "image" | "video")[], 1, undefined>]>;
+    readonly modalities: v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<["image", "audio", "video", "3d-model", "3d-scene", "document"], undefined>, undefined>, v.MinLengthAction<("3d-model" | "3d-scene" | "audio" | "document" | "image" | "video")[], 1, undefined>]>;
     /**
      * The concrete media types it can emit (`image/png`, `audio/mpeg`), when the integration
      * pins them down. Absent ⇒ only the coarse {@link modalities} are known, which the brief
@@ -133,7 +133,7 @@ export declare const registeredBinaryGeneratorSchema: v.ObjectSchema<{
     readonly name: v.StringSchema<undefined>;
     readonly summary: v.StringSchema<undefined>;
     /** What it produces — what the builder checks a step's declared content types against. */
-    readonly modalities: v.ArraySchema<v.PicklistSchema<["image", "audio", "video", "3d", "document"], undefined>, undefined>;
+    readonly modalities: v.ArraySchema<v.PicklistSchema<["image", "audio", "video", "3d-model", "3d-scene", "document"], undefined>, undefined>;
     /** The concrete formats it pins down, when it declares any. Shown as detail, never a filter. */
     readonly mediaTypes: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.ToLowerCaseAction, v.MinLengthAction<string, 3, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "must be a media type of the form type/subtype">]>, undefined>, undefined>;
 }, undefined>;

package/dist/binary-modalities.d.ts

@@ -14,20 +14,88 @@ import * as v from 'valibot';
  * is the whole integration, its media types and what a step can do with the result. A
  * deployment that must tell a music generator from a speech generator says so in the
  * definition's `mediaTypes` and its description.
+ *
+ * **3D is TWO members, and the reason is that nothing else can carry the distinction.** A single
+ * asset and a composed scene are different products of different integrations, and what a step
+ * does with the result is not comparable — one is attached to an entity, the other is loaded as
+ * an environment. That passes the audio-versus-video test on the ground that matters. It fails it
+ * on one: their MEDIA TYPES are identical. GLB, FBX, USDZ and `.blend` each carry either an
+ * object or a whole scene graph, so no format tells you which you were handed and
+ * {@link modalitiesOfMediaType} does not pretend otherwise. That is exactly why the split has to
+ * live HERE: if the container could say it, a media type would already have said it, and a step
+ * that must deliver a level could go on being admitted against a prop generator.
+ *
+ * What the split is NOT is a licence to slice the others by scope. `image` does not become
+ * sprite-versus-background, because a step's format requirement (`binaryOutput.mediaTypes`) is
+ * what distinguishes a PNG from a JPEG and a prompt is what distinguishes a sprite from a
+ * backdrop. A member earns its place only when neither of those can tell two deliverables apart.
  */
-export declare const binaryModalitySchema: v.PicklistSchema<["image", "audio", "video", "3d", "document"], undefined>;
+export declare const binaryModalitySchema: v.PicklistSchema<["image", "audio", "video", "3d-model", "3d-scene", "document"], undefined>;
 export type BinaryModality = v.InferOutput<typeof binaryModalitySchema>;
 /**
- * The {@link BinaryModality} a media type belongs to, or `null` when nothing here recognises it.
- *
- * `null` is a REAL answer and callers must keep it apart from a modality: it means the platform
- * does not know what this content is, which is different from knowing it is not an image. It is
- * what lets a registration's declared media types be checked against its declared modalities
- * (a generator claiming `audio` while listing `image/png` is a configuration error, not a
- * judgement call) and what lets a settled step's declared artifacts be CLASSIFIED in code rather
- * than by asking the model what kind of thing it just made.
+ * Whether a stored value is still a member of the vocabulary — DERIVED from the picklist, so it
+ * cannot drift from it the way a hand-written second list would.
+ *
+ * This vocabulary is closed but PERSISTED (`stepOptions.binaryOutput.modalities`), and those two
+ * facts together are what makes the guard necessary: a member retired from the union goes on
+ * existing in saved pipelines, as `3d` did when it split into `3d-model` and `3d-scene`. A reader
+ * that maps a modality through an exhaustive `Record` or `switch` is therefore total against the
+ * TYPE and partial against the DATA — the gap where a lookup returns `undefined` and a call on it
+ * throws. Narrow with this first, and render the negative case as the retired value it is: nothing
+ * can know which current member was meant, and guessing one would quietly rewrite a requirement
+ * that the split exists to make someone restate.
+ */
+export declare function isBinaryModality(value: string): value is BinaryModality;
+/**
+ * Every {@link BinaryModality} a media type is CONSISTENT with — empty when nothing here
+ * recognises it.
+ *
+ * A LIST rather than one answer, because for 3D there is genuinely more than one and saying so
+ * is the whole point. `model/gltf-binary` is a GLB; a GLB is one prop or an entire environment
+ * and the container does not record which. Returning `3d-model` for it would classify every
+ * delivered scene as an asset, and picking either would make the boot check below refuse a
+ * correct registration.
+ *
+ * Empty is a REAL answer and callers must keep it apart from a modality: it means the platform
+ * does not know what this content is, which is different from knowing it is not an image. Two
+ * things read this — a registration's declared media types are checked against its declared
+ * modalities (a generator claiming `audio` while listing `image/png` is a configuration error,
+ * not a judgement call), and a settled step's declared artifacts are CLASSIFIED in code rather
+ * than by asking the model what kind of thing it just made. Each has to say what it does with a
+ * MULTI-member answer: the first passes when the sets INTERSECT, the second declines to classify
+ * at all, because an ambiguous answer is not a verdict.
+ */
+export declare function modalitiesOfMediaType(value: string): BinaryModality[];
+/**
+ * The modality a media type UNAMBIGUOUSLY identifies, or `null` when it identifies none or more
+ * than one.
+ *
+ * For classifying something that already exists — a stored artifact — where a guess is worse than
+ * an absence. A `.glb` collapses `3d-model` and `3d-scene`, so it classifies as neither and the
+ * artifact carries no modality: "we cannot tell what this is" is not "this is not an image", and
+ * the step's own declaration is the only thing that ever knew which of the two was being made.
  */
 export declare function modalityOfMediaType(value: string): BinaryModality | null;
+/**
+ * A media type reduced to the `type/subtype` two people mean the same thing by — lowercased,
+ * trimmed, parameters dropped — or `null` when there is no `type/subtype` in it at all.
+ *
+ * The ONE definition of "the same format", because three places compare media types and two of
+ * them receive text nobody normalised. A step's declared formats and a generator's declared
+ * formats both come through {@link mediaTypeSchema}, which already lowercases and refuses
+ * parameters, so those two match on plain equality; a SETTLED artifact's `contentType` is the
+ * agent's own prose (`image/PNG`, `model/gltf-binary; charset=binary`) and matches nothing until
+ * it comes through here. A second copy of this reduction is how `model/GLTF-binary` becomes a
+ * format the platform reports as undelivered while the file sits exactly where it was asked for.
+ *
+ * Note what it deliberately does NOT do: it maps no synonyms. `model/obj` and
+ * `application/x-tgif` are the same file and stay different values here, because a step's format
+ * requirement is checked by EXACT match against what a generator declared, and a matcher that
+ * quietly accepted a near-neighbour would admit a GLB where an OBJ was required — which is the
+ * failure the requirement exists to prevent. The two sides agree by spelling the format the same
+ * way, and the brief tells the agent the exact string.
+ */
+export declare function normalizeMediaType(value: string): string | null;
 /**
  * A media type as `type/subtype` (parameters are NOT accepted — a generator declares what it
  * produces, not how one request happened to be encoded).

package/dist/binary-modalities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"binary-modalities.d.ts","sourceRoot":"","sources":["../src/binary-modalities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAY5B;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,4EAW/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAoBxE;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,uPAU3B,CAAA"}
+{"version":3,"file":"binary-modalities.d.ts","sourceRoot":"","sources":["../src/binary-modalities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAY5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,oBAAoB,8FAqB/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE;AAOD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,CAuBrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAGxE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI/D;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,uPAU3B,CAAA"}

package/dist/binary-modalities.js

@@ -23,6 +23,21 @@ import * as v from 'valibot';
  * is the whole integration, its media types and what a step can do with the result. A
  * deployment that must tell a music generator from a speech generator says so in the
  * definition's `mediaTypes` and its description.
+ *
+ * **3D is TWO members, and the reason is that nothing else can carry the distinction.** A single
+ * asset and a composed scene are different products of different integrations, and what a step
+ * does with the result is not comparable — one is attached to an entity, the other is loaded as
+ * an environment. That passes the audio-versus-video test on the ground that matters. It fails it
+ * on one: their MEDIA TYPES are identical. GLB, FBX, USDZ and `.blend` each carry either an
+ * object or a whole scene graph, so no format tells you which you were handed and
+ * {@link modalitiesOfMediaType} does not pretend otherwise. That is exactly why the split has to
+ * live HERE: if the container could say it, a media type would already have said it, and a step
+ * that must deliver a level could go on being admitted against a prop generator.
+ *
+ * What the split is NOT is a licence to slice the others by scope. `image` does not become
+ * sprite-versus-background, because a step's format requirement (`binaryOutput.mediaTypes`) is
+ * what distinguishes a PNG from a JPEG and a prompt is what distinguishes a sprite from a
+ * backdrop. A member earns its place only when neither of those can tell two deliverables apart.
  */
 export const binaryModalitySchema = v.picklist([
     /** Still images — `image/png`, `image/webp`, `image/jpeg`, `image/svg+xml`. */
@@ -31,49 +46,127 @@ export const binaryModalitySchema = v.picklist([
     'audio',
     /** Moving pictures, with or without an audio track — `video/mp4`, `video/webm`. */
     'video',
-    /** 3D geometry — `model/gltf-binary`, `model/obj`. */
-    '3d',
+    /**
+     * ONE 3D asset: a prop, a character, a part — the thing an inventory counts and a scene places.
+     * Its container is `model/gltf-binary`, `model/obj`, `application/x-blender`, and so on; which
+     * one matters to whoever opens it, and that is what `binaryOutput.mediaTypes` is for.
+     */
+    '3d-model',
+    /**
+     * A composed 3D scene: several assets with a hierarchy, and typically transforms, materials,
+     * cameras or lights. The SAME containers as {@link '3d-model'} — the difference is in what the
+     * file holds, which no media type states, so it is stated here or nowhere.
+     */
+    '3d-scene',
     /** A rendered, paginated document — `application/pdf`. */
     'document',
 ]);
 /**
- * The {@link BinaryModality} a media type belongs to, or `null` when nothing here recognises it.
+ * Whether a stored value is still a member of the vocabulary — DERIVED from the picklist, so it
+ * cannot drift from it the way a hand-written second list would.
  *
- * `null` is a REAL answer and callers must keep it apart from a modality: it means the platform
- * does not know what this content is, which is different from knowing it is not an image. It is
- * what lets a registration's declared media types be checked against its declared modalities
- * (a generator claiming `audio` while listing `image/png` is a configuration error, not a
- * judgement call) and what lets a settled step's declared artifacts be CLASSIFIED in code rather
- * than by asking the model what kind of thing it just made.
+ * This vocabulary is closed but PERSISTED (`stepOptions.binaryOutput.modalities`), and those two
+ * facts together are what makes the guard necessary: a member retired from the union goes on
+ * existing in saved pipelines, as `3d` did when it split into `3d-model` and `3d-scene`. A reader
+ * that maps a modality through an exhaustive `Record` or `switch` is therefore total against the
+ * TYPE and partial against the DATA — the gap where a lookup returns `undefined` and a call on it
+ * throws. Narrow with this first, and render the negative case as the retired value it is: nothing
+ * can know which current member was meant, and guessing one would quietly rewrite a requirement
+ * that the split exists to make someone restate.
  */
-export function modalityOfMediaType(value) {
-    const type = value.trim().toLowerCase().split(';')[0]?.trim() ?? '';
+export function isBinaryModality(value) {
+    return BINARY_MODALITY_SET.has(value);
+}
+const BINARY_MODALITY_SET = new Set(binaryModalitySchema.options);
+/** The 3D containers, which say the content is 3D and DELIBERATELY nothing more. */
+const THREE_D = ['3d-model', '3d-scene'];
+/**
+ * Every {@link BinaryModality} a media type is CONSISTENT with — empty when nothing here
+ * recognises it.
+ *
+ * A LIST rather than one answer, because for 3D there is genuinely more than one and saying so
+ * is the whole point. `model/gltf-binary` is a GLB; a GLB is one prop or an entire environment
+ * and the container does not record which. Returning `3d-model` for it would classify every
+ * delivered scene as an asset, and picking either would make the boot check below refuse a
+ * correct registration.
+ *
+ * Empty is a REAL answer and callers must keep it apart from a modality: it means the platform
+ * does not know what this content is, which is different from knowing it is not an image. Two
+ * things read this — a registration's declared media types are checked against its declared
+ * modalities (a generator claiming `audio` while listing `image/png` is a configuration error,
+ * not a judgement call), and a settled step's declared artifacts are CLASSIFIED in code rather
+ * than by asking the model what kind of thing it just made. Each has to say what it does with a
+ * MULTI-member answer: the first passes when the sets INTERSECT, the second declines to classify
+ * at all, because an ambiguous answer is not a verdict.
+ */
+export function modalitiesOfMediaType(value) {
+    const type = normalizeMediaType(value) ?? '';
     const [top, subtype] = type.split('/');
     if (!top || !subtype)
-        return null;
+        return [];
     if (top === 'image')
-        return 'image';
+        return ['image'];
     if (top === 'audio')
-        return 'audio';
+        return ['audio'];
     if (top === 'video')
-        return 'video';
+        return ['video'];
     if (top === 'model')
-        return '3d';
+        return THREE_D;
     if (top === 'application') {
         if (subtype === 'pdf')
-            return 'document';
+            return ['document'];
         // The 3D formats that predate `model/*` and are still what tooling emits: `sla` is STL, and
         // `x-tgif` is what the shared mime database maps `.obj` to (an old collision with the TGIF
         // drawing format, but it IS the type an OBJ file is served as, so recognising it is right).
-        // `octet-stream` stays null on purpose — it is the "no idea" type, and guessing `3d` from it
+        // `octet-stream` stays empty on purpose — it is the "no idea" type, and guessing 3D from it
         // would classify every unlabelled download as a model.
         if (subtype === 'octet-stream')
-            return null;
-        if (['gltf+json', 'x-gltf', 'sla', 'x-tgif'].includes(subtype))
-            return '3d';
-        return null;
+            return [];
+        // `x-blender` is the shared mime database's type for a `.blend` file, which is what an
+        // EDITABLE 3D deliverable looks like when the consumer is an artist rather than an engine —
+        // the same reason `sla` and `x-tgif` are here rather than only the registered `model/*` names.
+        if (['gltf+json', 'x-gltf', 'sla', 'x-tgif', 'x-blender'].includes(subtype))
+            return THREE_D;
+        return [];
     }
-    return null;
+    return [];
+}
+/**
+ * The modality a media type UNAMBIGUOUSLY identifies, or `null` when it identifies none or more
+ * than one.
+ *
+ * For classifying something that already exists — a stored artifact — where a guess is worse than
+ * an absence. A `.glb` collapses `3d-model` and `3d-scene`, so it classifies as neither and the
+ * artifact carries no modality: "we cannot tell what this is" is not "this is not an image", and
+ * the step's own declaration is the only thing that ever knew which of the two was being made.
+ */
+export function modalityOfMediaType(value) {
+    const modalities = modalitiesOfMediaType(value);
+    return modalities.length === 1 ? (modalities[0] ?? null) : null;
+}
+/**
+ * A media type reduced to the `type/subtype` two people mean the same thing by — lowercased,
+ * trimmed, parameters dropped — or `null` when there is no `type/subtype` in it at all.
+ *
+ * The ONE definition of "the same format", because three places compare media types and two of
+ * them receive text nobody normalised. A step's declared formats and a generator's declared
+ * formats both come through {@link mediaTypeSchema}, which already lowercases and refuses
+ * parameters, so those two match on plain equality; a SETTLED artifact's `contentType` is the
+ * agent's own prose (`image/PNG`, `model/gltf-binary; charset=binary`) and matches nothing until
+ * it comes through here. A second copy of this reduction is how `model/GLTF-binary` becomes a
+ * format the platform reports as undelivered while the file sits exactly where it was asked for.
+ *
+ * Note what it deliberately does NOT do: it maps no synonyms. `model/obj` and
+ * `application/x-tgif` are the same file and stay different values here, because a step's format
+ * requirement is checked by EXACT match against what a generator declared, and a matcher that
+ * quietly accepted a near-neighbour would admit a GLB where an OBJ was required — which is the
+ * failure the requirement exists to prevent. The two sides agree by spelling the format the same
+ * way, and the brief tells the agent the exact string.
+ */
+export function normalizeMediaType(value) {
+    const type = value.trim().toLowerCase().split(';')[0]?.trim() ?? '';
+    const [top, subtype] = type.split('/');
+    return top && subtype ? `${top}/${subtype}` : null;
 }
 /**
  * A media type as `type/subtype` (parameters are NOT accepted — a generator declares what it

package/dist/binary-modalities.js.map

@@ -1 +1 @@
-{"version":3,"file":"binary-modalities.js","sourceRoot":"","sources":["../src/binary-modalities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,8EAA8E;AAC9E,kGAAkG;AAClG,8FAA8F;AAC9F,0CAA0C;AAC1C,EAAE;AACF,kGAAkG;AAClG,gGAAgG;AAChG,kDAAkD;AAClD,8EAA8E;AAE9E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC7C,+EAA+E;IAC/E,OAAO;IACP,2FAA2F;IAC3F,OAAO;IACP,mFAAmF;IACnF,OAAO;IACP,sDAAsD;IACtD,IAAI;IACJ,0DAA0D;IAC1D,UAAU;CACX,CAAC,CAAA;AAGF;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACnE,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACtC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IACjC,IAAI,GAAG,KAAK,OAAO;QAAE,OAAO,OAAO,CAAA;IACnC,IAAI,GAAG,KAAK,OAAO;QAAE,OAAO,OAAO,CAAA;IACnC,IAAI,GAAG,KAAK,OAAO;QAAE,OAAO,OAAO,CAAA;IACnC,IAAI,GAAG,KAAK,OAAO;QAAE,OAAO,IAAI,CAAA;IAChC,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;QAC1B,IAAI,OAAO,KAAK,KAAK;YAAE,OAAO,UAAU,CAAA;QACxC,4FAA4F;QAC5F,2FAA2F;QAC3F,4FAA4F;QAC5F,6FAA6F;QAC7F,uDAAuD;QACvD,IAAI,OAAO,KAAK,cAAc;YAAE,OAAO,IAAI,CAAA;QAC3C,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAA;QAC3E,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CACnC,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,IAAI,EAAE,EACR,CAAC,CAAC,WAAW,EAAE,EACf,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACd,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAChB,CAAC,CAAC,KAAK,CACL,0DAA0D,EAC1D,+CAA+C,CAChD,CACF,CAAA"}
+{"version":3,"file":"binary-modalities.js","sourceRoot":"","sources":["../src/binary-modalities.ts"],"names":[],"mappings":"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"}

package/dist/binary-outputs.d.ts

@@ -43,7 +43,43 @@ export declare const binaryOutputConfigSchema: v.ObjectSchema<{
      * audio" is a statement about the WORK, and deriving it from the current selection would make
      * removing the audio generator look like a change of requirements rather than a break.
      */
-    readonly modalities: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<["image", "audio", "video", "3d", "document"], undefined>, undefined>, undefined>;
+    readonly modalities: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<["image", "audio", "video", "3d-model", "3d-scene", "document"], undefined>, undefined>, undefined>;
+    /**
+     * The concrete FORMATS this step must deliver, one notch finer than {@link modalities}, for the
+     * deliverables where the container IS the requirement rather than a rendering preference.
+     *
+     * 3D is why this exists. PNG versus WebP is a genre question and belongs in a prompt, but GLB,
+     * USDZ and FBX are all one modality and none of them substitutes for another: a Godot importer
+     * takes the first, a RealityKit pipeline the second, an art pipeline the third. A step whose
+     * mesh must load in the game can otherwise be admitted against an integration that cannot emit a
+     * loadable container, and the failure arrives at the end of a paid run as an asset nobody can
+     * open — which reads as a bad generation rather than as a selection nothing checked.
+     *
+     * Note the direction that gives this axis its scope: it is what the modality vocabulary does NOT
+     * have to split for. `3d-model` and `3d-scene` are two members precisely because no format tells
+     * them apart, and `image` stays one because a format tells PNG from JPEG — so a distinction any
+     * container can carry is stated HERE, and only what none can carry earns a modality.
+     *
+     * EVERY entry must be covered, not any one of them: a step needing a GLB for the engine AND an
+     * FBX the artists can open in Blender declares both, and both are checked. "Any of these will
+     * do" is deliberately not expressible — the agent has to name concrete formats on the vendor
+     * call, and a requirement that leaves it a choice hands that decision to the party with the
+     * least basis for making it. Declare the format you need, not the set you would accept.
+     *
+     * Checked by EXACT match against the {@link BinaryGeneratorDefinition.mediaTypes} a selected
+     * integration declares (both sides come through `mediaTypeSchema`, so case and parameters are
+     * already reconciled), and NOT translated into a modality: `modalityOfMediaType` recognises only
+     * the formats the platform happens to know, so inferring one here would make the strength of the
+     * check depend on whether we recognise the string — a requirement spelled with a brand-new
+     * container would silently lose the coarse check its neighbour keeps. The two lists are
+     * independent statements and both are enforced as written.
+     *
+     * Absent ⇒ no format requirement, which is the ordinary case and stays the ordinary case:
+     * {@link modalities} is the statement about the WORK. Like it, this is never defaulted from the
+     * current selection — deriving a requirement from what is selected would make REMOVING a
+     * generator look like a change of requirements rather than a break.
+     */
+    readonly mediaTypes: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.ToLowerCaseAction, v.MinLengthAction<string, 3, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "must be a media type of the form type/subtype">]>, undefined>, undefined>;
 }, undefined>;
 export type BinaryOutputConfig = v.InferOutput<typeof binaryOutputConfigSchema>;
 /** One stored artifact a binary-generating step declared in its reply's machine-read block. */
@@ -80,7 +116,7 @@ export declare const binaryOutputArtifactSchema: v.ObjectSchema<{
      * one the platform recognises: "we do not know what this is" and "this is not an image" are
      * different answers, and only the second could justify a warning.
      */
-    readonly modality: v.OptionalSchema<v.PicklistSchema<["image", "audio", "video", "3d", "document"], undefined>, undefined>;
+    readonly modality: v.OptionalSchema<v.PicklistSchema<["image", "audio", "video", "3d-model", "3d-scene", "document"], undefined>, undefined>;
 }, undefined>;
 export type BinaryOutputArtifact = v.InferOutput<typeof binaryOutputArtifactSchema>;
 /**
@@ -132,7 +168,7 @@ export declare const binaryOutputReportSchema: v.ObjectSchema<{
          * one the platform recognises: "we do not know what this is" and "this is not an image" are
          * different answers, and only the second could justify a warning.
          */
-        readonly modality: v.OptionalSchema<v.PicklistSchema<["image", "audio", "video", "3d", "document"], undefined>, undefined>;
+        readonly modality: v.OptionalSchema<v.PicklistSchema<["image", "audio", "video", "3d-model", "3d-scene", "document"], undefined>, undefined>;
     }, undefined>, undefined>;
     /** Distinct `service` ids named in entries that the resolved catalog does not contain. */
     readonly unknownServices: v.ArraySchema<v.StringSchema<undefined>, undefined>;
@@ -144,6 +180,16 @@ export declare const binaryOutputReportSchema: v.ObjectSchema<{
      * agent claimed and a reader judges it.
      */
     readonly unknownGenerators: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    /**
+     * Set when the deployment's registered integrations could not be READ at settlement, so no
+     * claimed `generator` id could be checked against them (a mothership-mode node whose mothership
+     * was unreachable). Its own field rather than an empty {@link unknownGenerators}, for the
+     * reason that runs through this whole feature: "every id checked out" and "nothing could be
+     * checked" are the same value and opposite facts, and only one of them is evidence. The
+     * artifacts themselves — and the STORAGE half's verdict, which resolves against a different
+     * catalog and is unaffected — are recorded either way, because what could be derived must be.
+     */
+    readonly generatorsUnverified: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
     /** Entries dropped because they were not an object with `service` + `location` strings. */
     readonly invalidEntries: v.NumberSchema<undefined>;
     /** Valid entries dropped past the per-report cap. */

package/dist/binary-outputs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"binary-outputs.d.ts","sourceRoot":"","sources":["../src/binary-outputs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAmB5B;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;IACnC;;;;OAIG;;IAEH;;;;;;OAMG;;IAEH;;;;;;;;;OASG;;IAEH;;;;;;;;;;OAUG;;aAEH,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E,+FAA+F;AAC/F,eAAO,MAAM,0BAA0B;IACrC;;;;;OAKG;;IAEH;;;OAGG;;IAEH,8FAA8F;;IAE9F,uEAAuE;;IAEvE,oDAAoD;;IAEpD;;;;;;OAMG;;IAEH;;;;;OAKG;;aAEH,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEnF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,wBAAwB;;QAnDnC;;;;;WAKG;;QAEH;;;WAGG;;QAEH,8FAA8F;;QAE9F,uEAAuE;;QAEvE,oDAAoD;;QAEpD;;;;;;WAMG;;QAEH;;;;;WAKG;;;IAsBH,0FAA0F;;IAE1F;;;;;;OAMG;;IAEH,2FAA2F;;IAE3F,qDAAqD;;IAErD,0FAA0F;;IAE1F,qEAAqE;;aAErE,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA"}
+{"version":3,"file":"binary-outputs.d.ts","sourceRoot":"","sources":["../src/binary-outputs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAmB5B;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;IACnC;;;;OAIG;;IAEH;;;;;;OAMG;;IAEH;;;;;;;;;OASG;;IAEH;;;;;;;;;;OAUG;;IAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;;aAEH,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E,+FAA+F;AAC/F,eAAO,MAAM,0BAA0B;IACrC;;;;;OAKG;;IAEH;;;OAGG;;IAEH,8FAA8F;;IAE9F,uEAAuE;;IAEvE,oDAAoD;;IAEpD;;;;;;OAMG;;IAEH;;;;;OAKG;;aAEH,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEnF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,wBAAwB;;QAnDnC;;;;;WAKG;;QAEH;;;WAGG;;QAEH,8FAA8F;;QAE9F,uEAAuE;;QAEvE,oDAAoD;;QAEpD;;;;;;WAMG;;QAEH;;;;;WAKG;;;IAsBH,0FAA0F;;IAE1F;;;;;;OAMG;;IAEH;;;;;;;;OAQG;;IAEH,2FAA2F;;IAE3F,qDAAqD;;IAErD,0FAA0F;;IAE1F,qEAAqE;;aAErE,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA"}

package/dist/binary-outputs.js

@@ -1,5 +1,5 @@
 import * as v from 'valibot';
-import { binaryModalitySchema } from './binary-modalities.js';
+import { binaryModalitySchema, mediaTypeSchema } from './binary-modalities.js';
 // Wire vocabulary for BINARY-OUTPUT agent steps (docs/initiatives/binary-output-foundational-storage.md):
 // a step whose kind GENERATES binary artifacts (image generation is the canonical example) and
 // stores them through a FOUNDATIONAL SERVICE the step selected from the workspace's catalog —
@@ -53,6 +53,42 @@ export const binaryOutputConfigSchema = v.object({
      * removing the audio generator look like a change of requirements rather than a break.
      */
     modalities: v.optional(v.array(binaryModalitySchema)),
+    /**
+     * The concrete FORMATS this step must deliver, one notch finer than {@link modalities}, for the
+     * deliverables where the container IS the requirement rather than a rendering preference.
+     *
+     * 3D is why this exists. PNG versus WebP is a genre question and belongs in a prompt, but GLB,
+     * USDZ and FBX are all one modality and none of them substitutes for another: a Godot importer
+     * takes the first, a RealityKit pipeline the second, an art pipeline the third. A step whose
+     * mesh must load in the game can otherwise be admitted against an integration that cannot emit a
+     * loadable container, and the failure arrives at the end of a paid run as an asset nobody can
+     * open — which reads as a bad generation rather than as a selection nothing checked.
+     *
+     * Note the direction that gives this axis its scope: it is what the modality vocabulary does NOT
+     * have to split for. `3d-model` and `3d-scene` are two members precisely because no format tells
+     * them apart, and `image` stays one because a format tells PNG from JPEG — so a distinction any
+     * container can carry is stated HERE, and only what none can carry earns a modality.
+     *
+     * EVERY entry must be covered, not any one of them: a step needing a GLB for the engine AND an
+     * FBX the artists can open in Blender declares both, and both are checked. "Any of these will
+     * do" is deliberately not expressible — the agent has to name concrete formats on the vendor
+     * call, and a requirement that leaves it a choice hands that decision to the party with the
+     * least basis for making it. Declare the format you need, not the set you would accept.
+     *
+     * Checked by EXACT match against the {@link BinaryGeneratorDefinition.mediaTypes} a selected
+     * integration declares (both sides come through `mediaTypeSchema`, so case and parameters are
+     * already reconciled), and NOT translated into a modality: `modalityOfMediaType` recognises only
+     * the formats the platform happens to know, so inferring one here would make the strength of the
+     * check depend on whether we recognise the string — a requirement spelled with a brand-new
+     * container would silently lose the coarse check its neighbour keeps. The two lists are
+     * independent statements and both are enforced as written.
+     *
+     * Absent ⇒ no format requirement, which is the ordinary case and stays the ordinary case:
+     * {@link modalities} is the statement about the WORK. Like it, this is never defaulted from the
+     * current selection — deriving a requirement from what is selected would make REMOVING a
+     * generator look like a change of requirements rather than a break.
+     */
+    mediaTypes: v.optional(v.array(mediaTypeSchema)),
 });
 /** One stored artifact a binary-generating step declared in its reply's machine-read block. */
 export const binaryOutputArtifactSchema = v.object({
@@ -117,6 +153,16 @@ export const binaryOutputReportSchema = v.object({
      * agent claimed and a reader judges it.
      */
     unknownGenerators: v.array(v.string()),
+    /**
+     * Set when the deployment's registered integrations could not be READ at settlement, so no
+     * claimed `generator` id could be checked against them (a mothership-mode node whose mothership
+     * was unreachable). Its own field rather than an empty {@link unknownGenerators}, for the
+     * reason that runs through this whole feature: "every id checked out" and "nothing could be
+     * checked" are the same value and opposite facts, and only one of them is evidence. The
+     * artifacts themselves — and the STORAGE half's verdict, which resolves against a different
+     * catalog and is unaffected — are recorded either way, because what could be derived must be.
+     */
+    generatorsUnverified: v.optional(v.literal(true)),
     /** Entries dropped because they were not an object with `service` + `location` strings. */
     invalidEntries: v.number(),
     /** Valid entries dropped past the per-report cap. */

package/dist/binary-outputs.js.map

@@ -1 +1 @@
-{"version":3,"file":"binary-outputs.js","sourceRoot":"","sources":["../src/binary-outputs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAE7D,0GAA0G;AAC1G,+FAA+F;AAC/F,8FAA8F;AAC9F,+FAA+F;AAC/F,gGAAgG;AAChG,gGAAgG;AAChG,6EAA6E;AAE7E,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CACtB,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,IAAI,EAAE,EACR,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACd,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,EACf,CAAC,CAAC,KAAK,CAAC,sBAAsB,EAAE,4BAA4B,CAAC,CAC9D,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C;;;;OAIG;IACH,gBAAgB,EAAE,SAAS;IAC3B;;;;;;OAMG;IACH,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjD;;;;;;;;;OASG;IACH,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC5C;;;;;;;;;;OAUG;IACH,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;CACtD,CAAC,CAAA;AAGF,+FAA+F;AAC/F,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD;;;;;OAKG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB;;;OAGG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,8FAA8F;IAC9F,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,uEAAuE;IACvE,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACnC,oDAAoD;IACpD,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACnC;;;;;;OAMG;IACH,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;CAC3C,CAAC,CAAA;AAGF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC;IAC3C,0FAA0F;IAC1F,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACpC;;;;;;OAMG;IACH,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACtC,2FAA2F;IAC3F,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,qDAAqD;IACrD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,0FAA0F;IAC1F,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACpC,qEAAqE;IACrE,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;CACpC,CAAC,CAAA"}
+{"version":3,"file":"binary-outputs.js","sourceRoot":"","sources":["../src/binary-outputs.ts"],"names":[],"mappings":"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"}

package/dist/entities.d.ts

@@ -1177,7 +1177,8 @@ export declare const stepOptionsSchema: v.ObjectSchema<{
         readonly storageServiceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>, v.RegexAction<string, "must be a lower-kebab slug">]>;
         readonly contextServiceIds: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>, v.RegexAction<string, "must be a lower-kebab slug">]>, undefined>, undefined>;
         readonly generatorIds: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>, v.RegexAction<string, "must be a lower-kebab slug">]>, undefined>, undefined>;
-        readonly modalities: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<["image", "audio", "video", "3d", "document"], undefined>, undefined>, undefined>;
+        readonly modalities: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<["image", "audio", "video", "3d-model", "3d-scene", "document"], undefined>, undefined>, undefined>;
+        readonly mediaTypes: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.ToLowerCaseAction, v.MinLengthAction<string, 3, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "must be a media type of the form type/subtype">]>, undefined>, undefined>;
     }, undefined>, undefined>;
 }, undefined>;
 export type StepOptions = v.InferOutput<typeof stepOptionsSchema>;
@@ -1364,7 +1365,8 @@ export declare const pipelineSchema: v.ObjectSchema<{
             readonly storageServiceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>, v.RegexAction<string, "must be a lower-kebab slug">]>;
             readonly contextServiceIds: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>, v.RegexAction<string, "must be a lower-kebab slug">]>, undefined>, undefined>;
             readonly generatorIds: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>, v.RegexAction<string, "must be a lower-kebab slug">]>, undefined>, undefined>;
-            readonly modalities: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<["image", "audio", "video", "3d", "document"], undefined>, undefined>, undefined>;
+            readonly modalities: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<["image", "audio", "video", "3d-model", "3d-scene", "document"], undefined>, undefined>, undefined>;
+            readonly mediaTypes: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.ToLowerCaseAction, v.MinLengthAction<string, 3, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "must be a media type of the form type/subtype">]>, undefined>, undefined>;
         }, undefined>, undefined>;
     }, undefined>, undefined>, undefined>, undefined>;
     /**

package/dist/entities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../src/entities.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../src/entities.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -31,6 +31,28 @@ export type ApiErrorCode = (typeof API_ERROR_CODES)[number];
  */
 export declare const CONFLICT_REASONS: readonly ['providers_unconfigured', 'preset_unsatisfiable', 'dependencies_unmet', 'task_limit_reached', 'tester_infra_unsupported', 'binary_storage_unconfigured', 'agent_backend_unconfigured', 'run_not_retryable', 'no_pr_to_merge', 'github_not_connected', 'bootstrap_not_retryable', 'bootstrap_reference_missing', 'provision_type_unhandled', 'visual_pipeline_no_frontend', 'model_policy_blocked', 'model_policy_unsupported', 'deployer_required_before_tester', 'deployer_service_provisioning_incomplete', 'deployer_connection_test_failed', 'env_test_not_a_frame', 'env_test_infraless', 'env_test_not_provisionable', 'env_test_no_vcs', 'env_test_connection_failed', 'review_debt_warn', 'review_debt_blocked', 'prompt_revision_conflict', 'pipeline_schedule_attached', 'pipeline_schedule_requires_recurring', 'pipeline_schedule_intake_unconfigured', 'foundational_service_exists', 'binary_output_service_invalid', 'binary_output_generator_invalid', 'foundational_service_not_inherited'];
 export type ConflictReason = (typeof CONFLICT_REASONS)[number];
+/**
+ * Machine-readable reasons behind a 503 (`error.details.reason` on an `UnavailableError`), for
+ * the ones a USER can reach — the SPA keys an exhaustive `Record<UnavailableReason, …>` of
+ * message keys off this, exactly as it does for {@link CONFLICT_REASONS}.
+ *
+ * A 503 without a reason is left to the status class's generic copy, and that copy has to say
+ * something — today "this deployment has not configured the capability this action needs". For
+ * an outage that is the WRONG claim, and precisely the misattribution the reasons below exist to
+ * prevent one layer down: a node whose mothership is unreachable would tell an operator their
+ * deployment is misconfigured, sending them to a build with nothing wrong in it. So a 503 whose
+ * cause is "reachable, just not right now" belongs here rather than on the generic fallback.
+ *
+ *  - `binary_generators_unreachable`   — the deployment's generative binary integrations could
+ *                                        not be read. On a mothership-mode node they are read
+ *                                        from the mothership, and run admission refuses rather
+ *                                        than resolving a step's `generatorIds` against an
+ *                                        unknown set. Retryable; nothing is misconfigured.
+ *  - `foundational_builtins_unreachable` — the same shape for the deployment's `builtin`
+ *                                        foundational-services tier.
+ */
+export declare const UNAVAILABLE_REASONS: readonly ['binary_generators_unreachable', 'foundational_builtins_unreachable'];
+export type UnavailableReason = (typeof UNAVAILABLE_REASONS)[number];
 /**
  * Machine-readable reasons a `review` task's target pull request is refused at creation
  * (`error.details.reason` on the 422). Same contract as {@link CONFLICT_REASONS} — the code is

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,YAC7B,WAAW,EACX,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,WAAW,EACX,aAAa,EACb,cAAc,EACd,cAAc,CACN,CAAA;AAEV,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjE;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,iJAA+C,CAAA;AAE3E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAE3D;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,YAC3B,wBAAwB,EAKxB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,6BAA6B,EAC7B,4BAA4B,EAC5B,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,6BAA6B,EAG7B,0BAA0B,EAG1B,6BAA6B,EAG7B,sBAAsB,EAGtB,0BAA0B,EAI1B,iCAAiC,EAKjC,0CAA0C,EAK1C,iCAAiC,EAGjC,sBAAsB,EAGtB,oBAAoB,EAGpB,4BAA4B,EAG5B,iBAAiB,EAMjB,4BAA4B,EAK5B,kBAAkB,EAIlB,qBAAqB,EAKrB,0BAA0B,EAO1B,4BAA4B,EAG5B,sCAAsC,EAItC,uCAAuC,EAKvC,6BAA6B,EAS7B,+BAA+B,EAY/B,iCAAiC,EAOjC,oCAAoC,CAC5B,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,YAAI,qBAAqB,EAAE,yBAAyB,CAAU,CAAA;AAEhG,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAA"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,YAC7B,WAAW,EACX,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,WAAW,EACX,aAAa,EACb,cAAc,EACd,cAAc,CACN,CAAA;AAEV,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjE;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,iJAA+C,CAAA;AAE3E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAE3D;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,YAC3B,wBAAwB,EAKxB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,6BAA6B,EAC7B,4BAA4B,EAC5B,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,6BAA6B,EAG7B,0BAA0B,EAG1B,6BAA6B,EAG7B,sBAAsB,EAGtB,0BAA0B,EAI1B,iCAAiC,EAKjC,0CAA0C,EAK1C,iCAAiC,EAGjC,sBAAsB,EAGtB,oBAAoB,EAGpB,4BAA4B,EAG5B,iBAAiB,EAMjB,4BAA4B,EAK5B,kBAAkB,EAIlB,qBAAqB,EAKrB,0BAA0B,EAO1B,4BAA4B,EAG5B,sCAAsC,EAItC,uCAAuC,EAKvC,6BAA6B,EAS7B,+BAA+B,EAY/B,iCAAiC,EAOjC,oCAAoC,CAC5B,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,mBAAmB,YAC9B,+BAA+B,EAC/B,mCAAmC,CAC3B,CAAA;AAEV,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,YAAI,qBAAqB,EAAE,yBAAyB,CAAU,CAAA;AAEhG,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAA"}