@cat-factory/contracts 0.284.0 → 0.285.0

package/dist/binary-capabilities.js

@@ -0,0 +1,361 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// What a generative binary integration can DO beyond producing a content type, and the per-step
+// GENERATION OPTIONS each of those abilities unlocks.
+//
+// `binary-modalities.ts` answers what an integration makes. This module answers what it can be
+// ASKED FOR while making it: a reference image to condition on, an edit of something that already
+// exists, a seed, a negative prompt, a transparent background. The four image APIs a deployment
+// is most likely to register (Flux, Nano Banana, Grok Imagine, Retro Diffusion) agree on almost
+// none of that, and the disagreement is not a quality difference a description can carry: a step
+// that hands a reference image to an integration with no image input does not produce a worse
+// picture, it produces an error at the end of a paid run, or (worse) a picture that silently
+// ignored the reference.
+//
+// Its own leaf module, imported by both `binary-generators.ts` (what a definition DECLARES) and
+// `binary-outputs.ts` (what a step ASKS FOR), for the reason `binary-modalities.ts` is one: the
+// two import each other's neighbours and a vocabulary this small has no business creating a
+// cycle. It is read by the backend, which admits the run and composes the agent's brief, and by
+// the SPA, which offers the controls in the first place, so the coverage rule lives here where
+// both import the same implementation rather than agreeing by hand.
+// ---------------------------------------------------------------------------
+/**
+ * A CAPABILITY a generative binary integration declares, as a closed vocabulary.
+ *
+ * Closed for the same reason {@link binaryModalitySchema} is: it decides things. A capability
+ * gates a per-step generation option (a control the builder shows, a paragraph the brief writes,
+ * a requirement admission refuses), so `referenceImage` and `reference-image` would be two
+ * capabilities that look identical to a reader and silently never match.
+ *
+ * **A member earns its place only when the PLATFORM exposes something because of it.** That is a
+ * higher bar than "the providers differ", and it is what keeps this from becoming the
+ * discriminator field the design record refuses (`style`, `resolutionRange`, `intendedUse`).
+ * Those were refused because they do not PARTITION a deliverable, so no predicate could be
+ * computed from them and a rule built on one would refuse correctly-configured steps by the taste
+ * of whoever wrote the picklist. A capability partitions exactly: an API either accepts an input
+ * image or it does not, either takes a mask or it does not, and the answer is a fact about the
+ * endpoint rather than an opinion about the art. So `covered` / `uncovered` is computable here,
+ * which is the same property that lets `modalities` and `mediaTypes` carry admission rules.
+ *
+ * It also decides nothing about WHICH of two integrations to call. That question stays exactly
+ * where the design record put it (the step's `generatorIds`, its format requirement, and its own
+ * prompt); this only says what may be ASKED of whichever one is called. A capability that told
+ * two producers of one modality apart without unlocking an option would be the refused
+ * discriminator wearing a new name.
+ *
+ * Anything that does not clear the bar stays prose in `description` / `guidance`, which is where
+ * "good at pixel art", "expensive above 2K" and "rate limited to 5/min" belong.
+ */
+export const binaryGeneratorCapabilitySchema = v.picklist([
+    /**
+     * Accepts an input image the generation is conditioned on: image-to-image, a style reference,
+     * a character reference. Unlocks `generation.referenceImages`.
+     */
+    'reference-image',
+    /**
+     * Composes SEVERAL reference images in ONE call (subject plus style, or two subjects fused).
+     * Its own member rather than a count on the one above, because the difference is structural:
+     * an integration that takes exactly one input image cannot be asked twice and have the results
+     * combined, so a step handing it three references is not degraded, it is unserved.
+     */
+    'multi-reference',
+    /**
+     * Revises a supplied artifact from a natural-language instruction, with no mask. Unlocks
+     * `generation.edit` in `instruction` mode.
+     */
+    'instruction-edit',
+    /**
+     * Revises the REGION of a supplied artifact named by a mask (inpainting / outpainting).
+     * Unlocks `generation.edit` in `mask` mode. Kept apart from the instruction edit above because
+     * the two need different inputs and almost no integration has both: a step that must repaint
+     * one corner cannot be served by an API that only rewrites whole images from a sentence.
+     */
+    'mask-edit',
+    /** Accepts a NEGATIVE prompt (what to keep out). Unlocks `generation.negativePrompt`. */
+    'negative-prompt',
+    /**
+     * Accepts a SEED, so a generation can be reproduced or deliberately varied. Unlocks
+     * `generation.seed`, and it is what makes several candidates from ONE integration comparable
+     * rather than accidental.
+     */
+    'seed',
+    /** Accepts an explicit aspect ratio or output size. Unlocks `generation.aspectRatio`. */
+    'aspect-ratio',
+    /**
+     * Returns SEVERAL candidates for one prompt in ONE call. Exposes no control of its own: it
+     * changes what the candidate brief ASKS FOR (request `n` in a single call, rather than
+     * repeating the call with a different seed), and a brief that got that wrong would either
+     * multiply the bill or ask for a parameter the endpoint rejects.
+     */
+    'candidate-batch',
+    /** Can upscale its own output to a larger render. Unlocks `generation.upscale`. */
+    'upscale',
+    /**
+     * Can return an alpha channel / cut-out subject. Unlocks
+     * `generation.transparentBackground`, which is a requirement rather than a preference for
+     * anything composited (a sprite, an icon, a product cut-out).
+     */
+    'transparent-background',
+    /**
+     * Can produce a SEAMLESSLY TILING image. Unlocks `generation.tileable`. A tile that does not
+     * tile is not a lesser tile: it is unusable for the one job it exists for, which is what puts
+     * this on the axis with a predicate rather than in a description.
+     */
+    'tileable',
+]);
+const BINARY_CAPABILITY_SET = new Set(binaryGeneratorCapabilitySchema.options);
+/**
+ * Whether a value is still a member of the vocabulary, DERIVED from the picklist.
+ *
+ * Unlike {@link isBinaryModality} this vocabulary is not persisted on a step: capabilities are
+ * declared in a deployment's own code, so a build that retires a member also stops emitting it.
+ * The guard exists for the ONE seam where that is not true: a MOTHERSHIP-MODE node resolves its
+ * integrations from a process that may be a build AHEAD of it, so a capability this build has
+ * never heard of can arrive over `/internal/binary-generators` and reach a `Record` lookup or a
+ * `switch`. Narrow with this first and describe the negative case as the unknown value it is.
+ */
+export function isBinaryGeneratorCapability(value) {
+    return BINARY_CAPABILITY_SET.has(value);
+}
+/**
+ * Where an artifact the step points a generator AT already lives: a reference image, the source
+ * of an edit, a mask.
+ *
+ * The platform deliberately does NOT fetch it. It is named to the agent in the brief, and the
+ * agent reads it exactly as it calls the generation API itself, which is the same division of
+ * labour the rest of this feature runs on: the platform states, the agent acts, and nothing here
+ * touches bytes. `service` names one of the step's own foundational services when the artifact
+ * lives in the org's estate rather than at a URL, so a private object store needs no public link.
+ */
+export const binaryAssetRefSchema = v.object({
+    /** Where it lives, in `service`'s addressing when one is named, else an absolute URL. */
+    location: v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(2048)),
+    /**
+     * The foundational service the location is addressed in. Absent ⇒ `location` is a URL the
+     * agent can fetch directly. Not validated against the step's own selection: a reference can
+     * legitimately live in a service the step does not otherwise use, and the brief names whatever
+     * is here so a wrong id is visible rather than silently dropped.
+     */
+    service: v.optional(v.pipe(v.string(), v.trim(), v.maxLength(64), v.regex(/^[a-z0-9][a-z0-9-]*$/))),
+    /** What this is, in the step author's words, folded into the brief verbatim. */
+    note: v.optional(v.pipe(v.string(), v.trim(), v.maxLength(500))),
+});
+/**
+ * A reference image plus the ROLE it plays, because "here is an image" is not an instruction.
+ * The same file means "match this palette", "this is the character" or "start from this and
+ * change it" depending on the answer, and every one of the four reference-capable APIs takes a
+ * different parameter for each.
+ */
+export const binaryReferenceImageSchema = v.object({
+    // Spelled out rather than spread from {@link binaryAssetRefSchema}'s entries. A spread composes
+    // the two schemas' inference at every use site, and this shape sits four levels down inside the
+    // workspace snapshot (`WorkspaceSnapshot` → pipeline → step options → binary output →
+    // generation → here), which is deep enough that the extra level tips `tsc` into "type
+    // instantiation is excessively deep" in a consumer several packages away. Three duplicated
+    // fields is a cheaper price than a build that fails somewhere with no visible connection to
+    // this file; the two are kept in step by the shared doc note above.
+    location: v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(2048)),
+    service: v.optional(v.pipe(v.string(), v.trim(), v.maxLength(64), v.regex(/^[a-z0-9][a-z0-9-]*$/))),
+    note: v.optional(v.pipe(v.string(), v.trim(), v.maxLength(500))),
+    role: v.picklist([
+        /** Match its look: palette, rendering, line weight. */
+        'style',
+        /** This is the thing depicted: the character, the product, the prop. */
+        'subject',
+        /** Match its layout: framing, pose, camera. */
+        'composition',
+        /** Start FROM this image and change it (image-to-image at low strength). */
+        'base',
+    ]),
+});
+/**
+ * The step REVISES existing artifacts rather than making new ones.
+ *
+ * A named schema rather than an inline object inside the options bag below, for the reason the
+ * reference-image shape is spelled out: this nests two more object levels under an already-deep
+ * chain, and a named const is where `tsc` can stop re-instantiating it.
+ */
+export const binaryEditRequestSchema = v.object({
+    /**
+     * `instruction` rewrites a whole artifact from a sentence; `mask` repaints only the region a
+     * mask names. Two capabilities, because almost no integration has both.
+     */
+    mode: v.picklist(['instruction', 'mask']),
+    /** What to change, folded into the brief verbatim. */
+    instruction: v.optional(v.pipe(v.string(), v.trim(), v.maxLength(2000))),
+    /**
+     * The artifact to revise. Absent ⇒ the step's scope services say which existing asset each
+     * generation revises, which is the ordinary case for a step that re-renders an inventory.
+     */
+    source: v.optional(binaryAssetRefSchema),
+    /** The mask, for `mask` mode. Absent in `mask` mode is a gap the brief STATES. */
+    mask: v.optional(binaryAssetRefSchema),
+});
+/**
+ * The per-step GENERATION OPTIONS: the parameters a step wants every generation to carry, each
+ * gated by the capability that makes it answerable ({@link BINARY_OPTION_CAPABILITIES}).
+ *
+ * They are a statement about the WORK, exactly like `modalities` and `mediaTypes` beside them,
+ * and they are checked the same way: a step asking for something nothing it selected can do is
+ * refused at admission rather than discovering it at the end of a paid run. What they are NOT is
+ * a passthrough of any vendor's request body. Everything here is a fact about the deliverable
+ * that more than one of the registered APIs can express in its own parameters, and the agent
+ * translates it on the call it writes; a knob only one vendor has (`prompt_upsampling`,
+ * `safety_tolerance`, a sampler name) stays in that integration's `guidance`, where it can say
+ * what it means, rather than becoming a field every other integration ignores.
+ */
+/**
+ * The raw object schema. Exported ONLY so the drift guard in `binary-capabilities.test.ts` can
+ * infer its output type and compare it against the hand-written {@link BinaryGenerationOptions};
+ * every other consumer takes {@link binaryGenerationOptionsSchema}, whose whole purpose is to
+ * stop that inference from happening at each use site. See the interface's note for why.
+ */
+export const binaryGenerationOptionsObject = v.object({
+    /**
+     * Images every generation is conditioned on. Needs `reference-image`; more than one also needs
+     * `multi-reference`, since an API that takes a single input image cannot compose two.
+     */
+    referenceImages: v.optional(v.pipe(v.array(binaryReferenceImageSchema), v.maxLength(8))),
+    /**
+     * The step REVISES existing artifacts rather than making new ones. Needs `instruction-edit` or
+     * `mask-edit` depending on `mode`.
+     */
+    edit: v.optional(binaryEditRequestSchema),
+    /** What to keep out. Needs `negative-prompt`. */
+    negativePrompt: v.optional(v.pipe(v.string(), v.trim(), v.maxLength(2000))),
+    /**
+     * A fixed seed, so the run is reproducible. Needs `seed`.
+     *
+     * A step comparing candidates deliberately does NOT get its seed varied for it: a fixed seed
+     * across integrations is how two renders of one subject are told apart by the integration
+     * rather than by luck, and the brief says so.
+     */
+    seed: v.optional(v.pipe(v.number(), v.integer(), v.minValue(0), v.maxValue(4294967295))),
+    /** `16:9`, `1:1`, `3:2`. Needs `aspect-ratio`. */
+    aspectRatio: v.optional(v.pipe(v.string(), v.trim(), v.maxLength(16), v.regex(/^[1-9][0-9]{0,3}:[1-9][0-9]{0,3}$/, 'must be an aspect ratio of the form W:H'))),
+    /** Render at this multiple of the integration's native size. Needs `upscale`. */
+    upscale: v.optional(v.pipe(v.number(), v.integer(), v.minValue(2), v.maxValue(8))),
+    /** Deliver an alpha channel rather than a background. Needs `transparent-background`. */
+    transparentBackground: v.optional(v.literal(true)),
+    /** Deliver a seamlessly tiling image. Needs `tileable`. */
+    tileable: v.optional(v.literal(true)),
+});
+/**
+ * The generation options as a SCHEMA, typed against the interface above so consumers stop
+ * re-inferring it. `unknown` on the input side is what a parser accepts anyway, and nothing in
+ * this repo reads `InferInput` of a step's options.
+ */
+export const binaryGenerationOptionsSchema = binaryGenerationOptionsObject;
+/**
+ * Which option needs which capability, as the ONE table both sides read.
+ *
+ * A `Record` over the option keys rather than a chain of `if`s at each reader, so an option added
+ * to the schema without a capability fails the typecheck here instead of shipping as a control
+ * nothing checks. `referenceImages` maps to a LIST because its requirement grows with its length,
+ * and `edit` maps to one of two by its mode, which is why the derivation below is a function and
+ * not a lookup.
+ */
+export const BINARY_OPTION_CAPABILITIES = {
+    referenceImages: ['reference-image', 'multi-reference'],
+    edit: ['instruction-edit', 'mask-edit'],
+    negativePrompt: ['negative-prompt'],
+    seed: ['seed'],
+    aspectRatio: ['aspect-ratio'],
+    upscale: ['upscale'],
+    transparentBackground: ['transparent-background'],
+    tileable: ['tileable'],
+};
+/**
+ * The capabilities a step's generation options actually REQUIRE, in a stable order.
+ *
+ * Derived rather than declared, so a step never carries a requirement it does not exercise: a
+ * `referenceImages` list of one needs `reference-image` and NOT `multi-reference`, and an `edit`
+ * needs exactly the one capability its mode names. Deriving it is also what keeps the refusal
+ * honest in the other direction, since a requirement nobody stated cannot be silently dropped by
+ * an integration that does not declare it.
+ *
+ * Deliberately NOT extended with `candidate-batch` for a comparison step: an integration without
+ * it can still produce several candidates by repeating the call, so a refusal there would reject
+ * a selection that works. The brief states which of the two the agent should do.
+ */
+export function requiredBinaryCapabilities(options) {
+    if (!options)
+        return [];
+    const required = [];
+    const references = options.referenceImages ?? [];
+    if (references.length > 0)
+        required.push('reference-image');
+    if (references.length > 1)
+        required.push('multi-reference');
+    if (options.edit) {
+        required.push(options.edit.mode === 'mask' ? 'mask-edit' : 'instruction-edit');
+    }
+    if (options.negativePrompt)
+        required.push('negative-prompt');
+    if (options.seed !== undefined)
+        required.push('seed');
+    if (options.aspectRatio)
+        required.push('aspect-ratio');
+    if (options.upscale !== undefined)
+        required.push('upscale');
+    if (options.transparentBackground)
+        required.push('transparent-background');
+    if (options.tileable)
+        required.push('tileable');
+    return required;
+}
+/**
+ * Judge `required` against what `selected` declares it can do.
+ *
+ * The same THREE outcomes as {@link binaryFormatCoverage}, and deliberately the same rule, because
+ * the two axes are in the same position: a declaration that pins nothing down is an explicit
+ * documented state ("only the coarse facts are known") rather than a denial. That reading is what
+ * lets this ship without breaking a single integration registered before capabilities existed:
+ * they declare none, so every requirement against them is UNVERIFIABLE, the run is admitted, and
+ * the gap is stated to the agent in its brief and to the composer in the picker. Refusing there
+ * would retroactively invalidate every registration in existence; calling it covered would be a
+ * clean bill of health nobody issued on the surface that decides whether the run may start.
+ *
+ * Kept as its own function rather than a generic over the format one: they read different fields
+ * of different shapes, and a shared generic would be a parameterised `some`/`has` that saves four
+ * lines and hides which axis a caller is asking about.
+ */
+export function binaryCapabilityCoverage(required, selected) {
+    const declared = new Set(selected.flatMap((generator) => generator.capabilities ?? []));
+    // An EMPTY selection declares nothing and hides nothing: with no integration to be silent, a
+    // capability requirement is uncovered outright, exactly as a format requirement already is.
+    const undeclared = selected.some((generator) => (generator.capabilities ?? []).length === 0);
+    const uncovered = [];
+    const unverifiable = [];
+    for (const capability of required) {
+        if (declared.has(capability))
+            continue;
+        if (undeclared)
+            unverifiable.push(capability);
+        else
+            uncovered.push(capability);
+    }
+    return { uncovered, unverifiable };
+}
+/**
+ * The integrations that declare each required capability, so a surface can say WHICH of a
+ * step's selection will actually honour an option rather than only that something will.
+ *
+ * The question a person asks the moment a step holds two producers of one modality and one
+ * option: an aspect ratio honoured by one of them and ignored by the other is not a covered
+ * requirement in any useful sense, and coverage alone cannot say so. Ids come out in selection
+ * order and a capability with no declarer is absent, never an empty list, so "nobody" and "not
+ * asked" stay different answers.
+ */
+export function binaryCapabilityProviders(required, selected) {
+    const out = [];
+    for (const capability of required) {
+        const generatorIds = selected
+            .filter((generator) => (generator.capabilities ?? []).includes(capability))
+            .map((generator) => generator.id);
+        if (generatorIds.length > 0)
+            out.push({ capability, generatorIds });
+    }
+    return out;
+}
+//# sourceMappingURL=binary-capabilities.js.map

package/dist/binary-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-capabilities.js","sourceRoot":"","sources":["../src/binary-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,8EAA8E;AAC9E,gGAAgG;AAChG,sDAAsD;AACtD,EAAE;AACF,+FAA+F;AAC/F,kGAAkG;AAClG,gGAAgG;AAChG,gGAAgG;AAChG,iGAAiG;AACjG,8FAA8F;AAC9F,6FAA6F;AAC7F,yBAAyB;AACzB,EAAE;AACF,gGAAgG;AAChG,gGAAgG;AAChG,4FAA4F;AAC5F,gGAAgG;AAChG,+FAA+F;AAC/F,oEAAoE;AACpE,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,QAAQ,CAAC;IACxD;;;OAGG;IACH,iBAAiB;IACjB;;;;;OAKG;IACH,iBAAiB;IACjB;;;OAGG;IACH,kBAAkB;IAClB;;;;;OAKG;IACH,WAAW;IACX,yFAAyF;IACzF,iBAAiB;IACjB;;;;OAIG;IACH,MAAM;IACN,yFAAyF;IACzF,cAAc;IACd;;;;;OAKG;IACH,iBAAiB;IACjB,mFAAmF;IACnF,SAAS;IACT;;;;OAIG;IACH,wBAAwB;IACxB;;;;OAIG;IACH,UAAU;CACX,CAAC,CAAA;AAGF,MAAM,qBAAqB,GAAwB,IAAI,GAAG,CAAC,+BAA+B,CAAC,OAAO,CAAC,CAAA;AAEnG;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAa;IACvD,OAAO,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AACzC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,yFAAyF;IACzF,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACzE;;;;;OAKG;IACH,OAAO,EAAE,CAAC,CAAC,QAAQ,CACjB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAC/E;IACD,gFAAgF;IAChF,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;CACjE,CAAC,CAAA;AAGF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,gGAAgG;IAChG,gGAAgG;IAChG,sFAAsF;IACtF,sFAAsF;IACtF,2FAA2F;IAC3F,4FAA4F;IAC5F,oEAAoE;IACpE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACzE,OAAO,EAAE,CAAC,CAAC,QAAQ,CACjB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAC/E;IACD,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC;QACf,uDAAuD;QACvD,OAAO;QACP,wEAAwE;QACxE,SAAS;QACT,+CAA+C;QAC/C,aAAa;QACb,4EAA4E;QAC5E,MAAM;KACP,CAAC;CACH,CAAC,CAAA;AAGF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C;;;OAGG;IACH,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACzC,sDAAsD;IACtD,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACxE;;;OAGG;IACH,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACxC,kFAAkF;IAClF,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;CACvC,CAAC,CAAA;AAGF;;;;;;;;;;;;GAYG;AACH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD;;;OAGG;IACH,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF;;;OAGG;IACH,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACzC,iDAAiD;IACjD,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E;;;;;;OAMG;IACH,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IACxF,kDAAkD;IAClD,WAAW,EAAE,CAAC,CAAC,QAAQ,CACrB,CAAC,CAAC,IAAI,CACJ,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,IAAI,EAAE,EACR,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,EACf,CAAC,CAAC,KAAK,CAAC,mCAAmC,EAAE,yCAAyC,CAAC,CACxF,CACF;IACD,iFAAiF;IACjF,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,yFAAyF;IACzF,qBAAqB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,2DAA2D;IAC3D,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC,CAAC,CAAA;AA8BF;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GACxC,6BAA6B,CAAA;AAE/B;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAGnC;IACF,eAAe,EAAE,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IACvD,IAAI,EAAE,CAAC,kBAAkB,EAAE,WAAW,CAAC;IACvC,cAAc,EAAE,CAAC,iBAAiB,CAAC;IACnC,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,WAAW,EAAE,CAAC,cAAc,CAAC;IAC7B,OAAO,EAAE,CAAC,SAAS,CAAC;IACpB,qBAAqB,EAAE,CAAC,wBAAwB,CAAC;IACjD,QAAQ,EAAE,CAAC,UAAU,CAAC;CACvB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAA4C;IAE5C,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAA;IACvB,MAAM,QAAQ,GAAgC,EAAE,CAAA;IAChD,MAAM,UAAU,GAAG,OAAO,CAAC,eAAe,IAAI,EAAE,CAAA;IAChD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;IAC3D,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;IAC3D,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAA;IAChF,CAAC;IACD,IAAI,OAAO,CAAC,cAAc;QAAE,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;IAC5D,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACrD,IAAI,OAAO,CAAC,WAAW;QAAE,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IACtD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC3D,IAAI,OAAO,CAAC,qBAAqB;QAAE,QAAQ,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAA;IAC1E,IAAI,OAAO,CAAC,QAAQ;QAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAC/C,OAAO,QAAQ,CAAA;AACjB,CAAC;AAaD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAA8C,EAC9C,QAA4E;IAE5E,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAA;IACvF,6FAA6F;IAC7F,4FAA4F;IAC5F,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAA;IAC5F,MAAM,SAAS,GAAgC,EAAE,CAAA;IACjD,MAAM,YAAY,GAAgC,EAAE,CAAA;IACpD,KAAK,MAAM,UAAU,IAAI,QAAQ,EAAE,CAAC;QAClC,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAQ;QACtC,IAAI,UAAU;YAAE,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;;YACxC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACjC,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAA;AACpC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAA8C,EAC9C,QAAwF;IAExF,MAAM,GAAG,GAAwE,EAAE,CAAA;IACnF,KAAK,MAAM,UAAU,IAAI,QAAQ,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,QAAQ;aAC1B,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;aAC1E,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;QACnC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,CAAA;IACrE,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/binary-generators.d.ts

@@ -80,6 +80,22 @@ export declare const binaryGeneratorDefinitionSchema: v.ObjectSchema<{
      * states as such rather than implying every format of that modality is available.
      */
     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>;
+    /**
+     * What it can be ASKED FOR while generating: a reference image, a mask edit, a seed, a
+     * transparent background (see `binary-capabilities.ts`). This is what decides which per-step
+     * generation options the builder offers, what the brief tells the agent it may send, and which
+     * option requirements admission refuses.
+     *
+     * Absent is a DOCUMENTED state and the honest default for a definition nobody has audited: it
+     * means "only the coarse facts are known", exactly as an absent {@link mediaTypes} does, so
+     * every option requirement against it is reported as unverifiable rather than refused. Declare
+     * it once the endpoint's parameters are actually known, and the step gains a real check.
+     *
+     * The vocabulary is closed and deliberately narrow: a capability belongs here only when the
+     * platform exposes something because of it. A vendor knob nobody else has stays in
+     * {@link guidance}, where a sentence can say what it does.
+     */
+    readonly capabilities: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<["reference-image", "multi-reference", "instruction-edit", "mask-edit", "negative-prompt", "seed", "aspect-ratio", "candidate-batch", "upscale", "transparent-background", "tileable"], undefined>, undefined>, undefined>;
     /**
      * The API's base URL. Stated to the agent so it does not have to infer one from the contract,
      * and refused at registration unless it is `https` (or loopback) — the credential above rides
@@ -174,6 +190,17 @@ export declare const registeredBinaryGeneratorSchema: v.ObjectSchema<{
     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>;
+    /**
+     * What it can be asked for while generating. Unlike the two fields above this one does more
+     * than label a candidate: the builder shows a step's generation options against it, so a
+     * projection that omitted it would leave the SPA offering a reference-image field for an
+     * endpoint that takes no image, and the refusal would arrive at run start.
+     *
+     * Still identity-grade, so it stays inside the rule the omissions here follow: it is what the
+     * integration IS, not how to reach it. The credential key name, the endpoint and the contracts
+     * remain absent, because a workspace viewer has no business learning them.
+     */
+    readonly capabilities: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<["reference-image", "multi-reference", "instruction-edit", "mask-edit", "negative-prompt", "seed", "aspect-ratio", "candidate-batch", "upscale", "transparent-background", "tileable"], undefined>, undefined>, undefined>;
 }, undefined>;
 export type RegisteredBinaryGenerator = v.InferOutput<typeof registeredBinaryGeneratorSchema>;
 export declare function binaryGeneratorDefinitionIssues(definition: unknown): string[];

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

@@ -1 +1 @@
-{"version":3,"file":"binary-generators.d.ts","sourceRoot":"","sources":["../src/binary-generators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAsC5B;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B;IAC1C;;;;;;;;;;;;;OAaG;;IAYH;;;;;;;;;OASG;;IAcH;;;;OAIG;;IAEH;;;;;OAKG;;aAEH,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAE7F;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B;IAC1C,iFAAiF;;;IAGjF,2DAA2D;;IAE3D;;;OAGG;;IAEH;;;OAGG;;IAEH;;;;OAIG;;IAEH;;;;OAIG;;IAEH;;;;OAIG;;;QAxGH;;;;;;;;;;;;;WAaG;;QAYH;;;;;;;;;WASG;;QAcH;;;;WAIG;;QAEH;;;;;WAKG;;;IAgDH;;;;OAIG;;;;;;;aAEH,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAE7F;;;;;;;;GAQG;AACH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,+BAA+B;;;;IAI1C,0FAA0F;;IAE1F,gGAAgG;;aAEhG,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAE7F,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE,CAO7E"}
+{"version":3,"file":"binary-generators.d.ts","sourceRoot":"","sources":["../src/binary-generators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAuC5B;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B;IAC1C;;;;;;;;;;;;;OAaG;;IAYH;;;;;;;;;OASG;;IAcH;;;;OAIG;;IAEH;;;;;OAKG;;aAEH,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAE7F;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B;IAC1C,iFAAiF;;;IAGjF,2DAA2D;;IAE3D;;;OAGG;;IAEH;;;OAGG;;IAEH;;;;OAIG;;IAEH;;;;;;;;;;;;;;OAcG;;IAEH;;;;OAIG;;IAEH;;;;OAIG;;;QAxHH;;;;;;;;;;;;;WAaG;;QAYH;;;;;;;;;WASG;;QAcH;;;;WAIG;;QAEH;;;;;WAKG;;;IAgEH;;;;OAIG;;;;;;;aAEH,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAE7F;;;;;;;;GAQG;AACH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,+BAA+B;;;;IAI1C,0FAA0F;;IAE1F,gGAAgG;;IAEhG;;;;;;;;;OASG;;aAEH,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAE7F,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE,CAO7E"}

package/dist/binary-generators.js

@@ -1,4 +1,5 @@
 import * as v from 'valibot';
+import { binaryGeneratorCapabilitySchema } from './binary-capabilities.js';
 import { binaryModalitySchema, mediaTypeSchema } from './binary-modalities.js';
 import { uploadApiContractSchema } from './foundational-services.js';
 import { isReservedPlatformEnvKey, isToolchainEnvName, reservedEnvKeyMessage, toolchainEnvNameMessage, } from './reserved-env-keys.js';
@@ -102,6 +103,22 @@ export const binaryGeneratorDefinitionSchema = v.object({
      * states as such rather than implying every format of that modality is available.
      */
     mediaTypes: v.optional(v.array(mediaTypeSchema)),
+    /**
+     * What it can be ASKED FOR while generating: a reference image, a mask edit, a seed, a
+     * transparent background (see `binary-capabilities.ts`). This is what decides which per-step
+     * generation options the builder offers, what the brief tells the agent it may send, and which
+     * option requirements admission refuses.
+     *
+     * Absent is a DOCUMENTED state and the honest default for a definition nobody has audited: it
+     * means "only the coarse facts are known", exactly as an absent {@link mediaTypes} does, so
+     * every option requirement against it is reported as unverifiable rather than refused. Declare
+     * it once the endpoint's parameters are actually known, and the step gains a real check.
+     *
+     * The vocabulary is closed and deliberately narrow: a capability belongs here only when the
+     * platform exposes something because of it. A vendor knob nobody else has stays in
+     * {@link guidance}, where a sentence can say what it does.
+     */
+    capabilities: v.optional(v.array(binaryGeneratorCapabilitySchema)),
     /**
      * The API's base URL. Stated to the agent so it does not have to infer one from the contract,
      * and refused at registration unless it is `https` (or loopback) — the credential above rides
@@ -150,6 +167,17 @@ export const registeredBinaryGeneratorSchema = v.object({
     modalities: v.array(binaryModalitySchema),
     /** The concrete formats it pins down, when it declares any. Shown as detail, never a filter. */
     mediaTypes: v.optional(v.array(mediaTypeSchema)),
+    /**
+     * What it can be asked for while generating. Unlike the two fields above this one does more
+     * than label a candidate: the builder shows a step's generation options against it, so a
+     * projection that omitted it would leave the SPA offering a reference-image field for an
+     * endpoint that takes no image, and the refusal would arrive at run start.
+     *
+     * Still identity-grade, so it stays inside the rule the omissions here follow: it is what the
+     * integration IS, not how to reach it. The credential key name, the endpoint and the contracts
+     * remain absent, because a workspace viewer has no business learning them.
+     */
+    capabilities: v.optional(v.array(binaryGeneratorCapabilitySchema)),
 });
 export function binaryGeneratorDefinitionIssues(definition) {
     const parsed = v.safeParse(binaryGeneratorDefinitionSchema, definition);

package/dist/binary-generators.js.map

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

package/dist/binary-outputs.d.ts

@@ -80,6 +80,37 @@ export declare const binaryOutputConfigSchema: v.ObjectSchema<{
      * 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>;
+    /**
+     * The parameters every generation on this step carries: a reference image, an edit
+     * instruction, a seed, a negative prompt, a transparent background (see
+     * `binary-capabilities.ts`).
+     *
+     * A THIRD axis beside the two above, and the one that says what to ask FOR rather than what
+     * must come back. Each option is gated by the capability that makes it answerable, and the
+     * gate has the same three outcomes the format check does: an option nothing selected can do is
+     * refused at admission, an option nothing has DECLARED either way is admitted with the gap
+     * stated. That third state is what lets this exist at all without invalidating every
+     * integration registered before capabilities did.
+     *
+     * Absent ⇒ the step's prompt is the whole instruction, which stays the ordinary case. These
+     * are for the facts a prompt cannot carry: an agent told "match the reference" with no
+     * reference, or told to seed a run by an API that takes no seed, has been told nothing.
+     */
+    readonly generation: v.OptionalSchema<v.GenericSchema<unknown, import("./binary-capabilities.js").BinaryGenerationOptions>, undefined>;
+    /**
+     * This step generates COMPARABLE CANDIDATES and parks for a human to keep one (or several
+     * under distinct ids) rather than letting the agent commit to one producer unobserved. See
+     * `binary-candidates.ts`.
+     *
+     * Absent ⇒ the step generates its deliverables directly, which is the ordinary case and stays
+     * it: a comparison costs a human interrupt and at least one extra generation per subject, and
+     * it is worth that exactly where the choice between two producers of one content type is a
+     * judgement somebody wants to make with the pictures in front of them.
+     */
+    readonly comparison: v.OptionalSchema<v.ObjectSchema<{
+        readonly perGenerator: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 4, undefined>]>, undefined>;
+        readonly multiSelect: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+    }, 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. */

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;;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"}
+{"version":3,"file":"binary-outputs.d.ts","sourceRoot":"","sources":["../src/binary-outputs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAqB5B;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;IACnC;;;;OAIG;;IAEH;;;;;;OAMG;;IAEH;;;;;;;;;OASG;;IAEH;;;;;;;;;;OAUG;;IAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;;IAEH;;;;;;;;;;;;;;;OAeG;;IAEH;;;;;;;;;OASG;;;;;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,4 +1,6 @@
 import * as v from 'valibot';
+import { binaryGenerationOptionsSchema } from './binary-capabilities.js';
+import { binaryCandidateComparisonSchema } from './binary-candidates.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
@@ -89,6 +91,34 @@ export const binaryOutputConfigSchema = v.object({
      * generator look like a change of requirements rather than a break.
      */
     mediaTypes: v.optional(v.array(mediaTypeSchema)),
+    /**
+     * The parameters every generation on this step carries: a reference image, an edit
+     * instruction, a seed, a negative prompt, a transparent background (see
+     * `binary-capabilities.ts`).
+     *
+     * A THIRD axis beside the two above, and the one that says what to ask FOR rather than what
+     * must come back. Each option is gated by the capability that makes it answerable, and the
+     * gate has the same three outcomes the format check does: an option nothing selected can do is
+     * refused at admission, an option nothing has DECLARED either way is admitted with the gap
+     * stated. That third state is what lets this exist at all without invalidating every
+     * integration registered before capabilities did.
+     *
+     * Absent ⇒ the step's prompt is the whole instruction, which stays the ordinary case. These
+     * are for the facts a prompt cannot carry: an agent told "match the reference" with no
+     * reference, or told to seed a run by an API that takes no seed, has been told nothing.
+     */
+    generation: v.optional(binaryGenerationOptionsSchema),
+    /**
+     * This step generates COMPARABLE CANDIDATES and parks for a human to keep one (or several
+     * under distinct ids) rather than letting the agent commit to one producer unobserved. See
+     * `binary-candidates.ts`.
+     *
+     * Absent ⇒ the step generates its deliverables directly, which is the ordinary case and stays
+     * it: a comparison costs a human interrupt and at least one extra generation per subject, and
+     * it is worth that exactly where the choice between two producers of one content type is a
+     * judgement somebody wants to make with the pictures in front of them.
+     */
+    comparison: v.optional(binaryCandidateComparisonSchema),
 });
 /** One stored artifact a binary-generating step declared in its reply's machine-read block. */
 export const binaryOutputArtifactSchema = v.object({

package/dist/binary-outputs.js.map

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

package/dist/entities.d.ts

@@ -1233,6 +1233,11 @@ export declare const stepOptionsSchema: v.ObjectSchema<{
         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-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>;
+        readonly generation: v.OptionalSchema<v.GenericSchema<unknown, import("./binary-capabilities.js").BinaryGenerationOptions>, undefined>;
+        readonly comparison: v.OptionalSchema<v.ObjectSchema<{
+            readonly perGenerator: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 4, undefined>]>, undefined>;
+            readonly multiSelect: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        }, undefined>, undefined>;
     }, undefined>, undefined>;
     /**
      * `deployer` steps only. Declares that the environments THIS step provisions are meant to
@@ -1455,6 +1460,11 @@ export declare const pipelineSchema: v.ObjectSchema<{
             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-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>;
+            readonly generation: v.OptionalSchema<v.GenericSchema<unknown, import("./binary-capabilities.js").BinaryGenerationOptions>, undefined>;
+            readonly comparison: v.OptionalSchema<v.ObjectSchema<{
+                readonly perGenerator: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 4, undefined>]>, undefined>;
+                readonly multiSelect: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            }, undefined>, undefined>;
         }, undefined>, undefined>;
         /**
          * `deployer` steps only. Declares that the environments THIS step provisions are meant to