@howells/motif-sdk 4.0.0 → 5.0.1

package/dist/index.d.cts

@@ -34,7 +34,8 @@ interface CreativeOption {
 interface LookOption extends CreativeOption {
   /**
    * Whether a mood may be combined with this look. Flat looks (surfaces,
-   * prints, paintings, studio objects) carry their own light and refuse one.
+   * paintings, illustrations, studio objects) carry their own light and
+   * refuse one.
    */
   acceptsMood: boolean;
   /** Default aspect ratio, e.g. `"3:2"`. */
@@ -70,10 +71,11 @@ export declare class CreativeOptionError extends Error implements CreativeOption
 /** Canonical creative field order used for prompt enrichment and schema output. */
 export declare const CREATIVE_FIELDS: readonly ["look", "mood"];
 /**
- * Built-in creative direction catalogue: twelve house looks and six light moods.
+ * Built-in creative direction catalogue: nine house looks and six light moods.
  *
  * Each option carries the exact prompt sentence appended when it is selected.
- * Looks also carry the aspect ratio and model they were tuned for.
+ * Looks also carry the aspect ratio and model they were tuned for. The five
+ * photographic looks come first, then the four flat ones.
  */
 export declare const CREATIVE_TAXONOMY: {
   readonly look: readonly [{
@@ -87,92 +89,68 @@ export declare const CREATIVE_TAXONOMY: {
   }, {
     readonly acceptsMood: true;
     readonly aspect: "1:1";
-    readonly clause: "Editorial still life on a warm bone plaster ground, chalky unglazed surfaces, a long soft shadow, generous empty space, shot on film with fine grain. No text, no logos, no people";
-    readonly description: "Objects and material samples on a plaster ground, for product and swatch shots.";
+    readonly clause: "Editorial still life in the register of Aesop and Kinfolk, on a warm bone plaster ground, chalky unglazed surfaces in muted mineral colour, a long soft shadow, generous empty space, shot on film with fine grain, restrained and materially rich. No text, no logos, no people";
+    readonly description: "Objects and products on a plaster ground, for product and editorial still life.";
     readonly id: "still-life";
-    readonly label: "Material still life";
+    readonly label: "Editorial still life";
     readonly model: "flux2-pro";
   }, {
     readonly acceptsMood: true;
     readonly aspect: "3:2";
-    readonly clause: "Interior photograph shot square-on at eye level on a 35mm lens, warm off-white plaster, wide oak floorboards, linen, brass and a little pattern, light, bright and layered, collected rather than styled, slightly imperfect and lived-in rather than showroom-perfect, photographic realism. No text, no logos, no people";
+    readonly clause: "Interior photograph in the register of House & Garden and Kinfolk, shot square-on at eye level on a 35mm lens, warm off-white plaster, wide oak floorboards, linen, brass and a little pattern, light, bright and layered, collected rather than styled, lived-in rather than showroom-perfect, soft natural daylight, shot on film with fine grain. No text, no logos, no people";
     readonly description: "Bright, collected rooms that feel lived in, for interior scenes.";
-    readonly id: "lived-in";
-    readonly label: "Lived-in interior";
+    readonly id: "interior";
+    readonly label: "Interior";
     readonly model: "flux2-pro";
   }, {
     readonly acceptsMood: true;
     readonly aspect: "4:5";
-    readonly clause: "Architectural editorial photograph at full room scale, honest materials meeting precise detailing, one hero element genuinely installed, plausible light and shadow, generous negative space, empty of people. No text, no logos";
-    readonly description: "Whole rooms with one product installed, for showing a material at scale.";
+    readonly clause: "Architectural photograph in the register of House & Garden and Kinfolk, a considered house seen from outside at editorial distance with its garden and setting, pale render, stone or timber meeting precise detailing, clipped planting, soft warm daylight and long shadow, generous negative space, immaculate and calm, shot on film with fine grain. No text, no logos, no people";
+    readonly description: "Buildings and their settings from outside, for architecture, property and place.";
     readonly id: "architectural";
-    readonly label: "Architectural scale";
+    readonly label: "Architectural exterior";
     readonly model: "banana";
-  }, {
-    readonly acceptsMood: true;
-    readonly aspect: "4:3";
-    readonly clause: "Amateur phone photo of a real home taken by the homeowner, slightly wonky framing, unstyled domestic photography, ordinary exposure. No text, no people";
-    readonly description: "Unstyled phone snapshots of real homes, for believable before and after shots.";
-    readonly id: "homeowner";
-    readonly label: "Homeowner snapshot";
-    readonly model: "seedream45";
   }, {
     readonly acceptsMood: true;
     readonly aspect: "1:1";
-    readonly clause: "Stylised architectural illustration of the room, colour laid as flat planes on walls, joinery and trim, fine hand-drawn line with a gentle gouache wash, clearly a drawing of a design decision rather than a photograph. No text, no people";
-    readonly description: "Line and gouache room drawings, for showing a colour scheme as a design idea.";
-    readonly experimental: true;
-    readonly id: "drawing";
-    readonly label: "Palette drawing";
-    readonly model: "gpt2";
+    readonly clause: "Editorial documentary portrait in the register of Kinfolk, muted warm palette, waist-up and unposed against a plain plaster or linen ground, plain clothing with no logos, soft natural light, shot on film with fine grain. No text";
+    readonly description: "Natural, unposed documentary portraits of people. Pair with a mood for the light.";
+    readonly id: "portrait";
+    readonly label: "Documentary portrait";
+    readonly model: "seedream45";
   }, {
     readonly acceptsMood: false;
     readonly aspect: "1:1";
-    readonly clause: "Straight-on orthographic photograph of the surface filling the entire frame edge to edge, even shadowless studio light, crisp macro texture, colour-accurate. No text, no logos";
-    readonly description: "Flat, edge-to-edge surface photographs, for textures and material swatches.";
-    readonly id: "plate";
-    readonly label: "Flat plate";
+    readonly clause: "A single matte object centred with generous empty space, soft diffused studio light, minimal and quiet in the register of Aesop, one committed muted mineral colour on a plain ground. No text, no logos, no people";
+    readonly description: "One object in one colour on a clean ground, for icons and simple product shots.";
+    readonly id: "object";
+    readonly label: "Studio object";
     readonly model: "flux2-pro";
   }, {
     readonly acceptsMood: false;
     readonly aspect: "1:1";
-    readonly clause: "Fine hand-engraved botanical plate with delicate hatching and dry brush, grey ink only, reaching near-black at its densest, on matte uncoated stock under flat even light, cropped mid-motif and running past all four edges, never simplified or cartoonish. No text";
-    readonly description: "Grey-ink botanical engravings that run off the edges, for patterns and backgrounds.";
-    readonly id: "engraved";
-    readonly label: "Engraved grey ink";
-    readonly model: "gpt2";
-  }, {
-    readonly acceptsMood: false;
-    readonly aspect: "2:3";
-    readonly clause: "Tightly cropped photograph of a single piece of late-1940s American printed matter, flat and square-on in even light, every pixel paper, letterpress and wood type, sun-faded ink, foxing, soft creases and thumbtack holes, era-correct typography, nothing that looks like a digital photo run through a filter";
-    readonly description: "Aged mid-century printed matter such as posters and cards, where the lettering matters.";
-    readonly id: "ephemera";
-    readonly label: "Period ephemera";
-    readonly model: "ideogram4";
+    readonly clause: "Straight-on orthographic photograph of the surface filling the entire frame edge to edge, even shadowless studio light, crisp macro texture, colour-accurate and quietly material. No text, no logos";
+    readonly description: "Flat, edge-to-edge surface photographs, for textures, backgrounds and material swatches.";
+    readonly id: "surface";
+    readonly label: "Flat surface";
+    readonly model: "flux2-pro";
   }, {
     readonly acceptsMood: false;
-    readonly aspect: "3:4";
-    readonly clause: "Physical mineral pigment and chalk gesso on coarse natural linen, two or three confident gestures, warm ivory, oatmeal, putty and soft charcoal, flat diffuse museum reproduction lighting, shown unframed. No text";
-    readonly description: "Loose abstract paintings on linen, for wall art and calm backgrounds.";
-    readonly id: "canvas";
-    readonly label: "Linen abstract";
+    readonly aspect: "3:2";
+    readonly clause: "Painted abstraction filling the frame edge to edge, mineral pigment and chalk gesso on coarse natural linen, two or three confident gestures, warm ivory, oatmeal, putty and soft charcoal, flat diffuse reproduction light. No text";
+    readonly description: "Painted abstraction edge to edge, for wall art, heroes and calm backgrounds.";
+    readonly id: "abstract";
+    readonly label: "Painted abstract";
     readonly model: "banana";
-  }, {
-    readonly acceptsMood: true;
-    readonly aspect: "1:1";
-    readonly clause: "Editorial documentary portrait, muted warm palette, waist-up, unposed, plain clothing with no logos. No text";
-    readonly description: "Natural, unposed documentary portraits of people. Pair with a mood for the light.";
-    readonly id: "portrait";
-    readonly label: "Documentary portrait";
-    readonly model: "seedream45";
   }, {
     readonly acceptsMood: false;
     readonly aspect: "1:1";
-    readonly clause: "A single matte object centred with generous empty space, soft diffused studio light, minimal and quiet, one committed colour. No text, no logos, no people";
-    readonly description: "One object in one colour on a clean ground, for icons and simple product shots.";
-    readonly id: "object";
-    readonly label: "Studio object";
-    readonly model: "flux2-pro";
+    readonly clause: "Stylised editorial illustration in the register of Kinfolk, colour laid as flat planes in a warm muted palette of ivory, putty, sage and charcoal, fine hand-drawn line with a gentle gouache wash, generous empty space, clearly a drawing rather than a photograph. No text, no logos";
+    readonly description: "Line and gouache illustration of any subject, for drawn editorial imagery.";
+    readonly experimental: true;
+    readonly id: "illustration";
+    readonly label: "Editorial illustration";
+    readonly model: "gpt2";
   }];
   readonly mood: readonly [{
     readonly clause: "soft natural daylight from a window out of frame, gentle falloff into the corners, low contrast, even diffused light with soft, held highlights";
@@ -208,7 +186,7 @@ export declare const CREATIVE_TAXONOMY: {
 };
 /** Every house look, in catalogue order. */
 export declare const LOOKS: readonly LookOption[];
-/** Stable id of a house look, e.g. `"lived-in"`. */
+/** Stable id of a house look, e.g. `"interior"`. */
 type LookId = (typeof CREATIVE_TAXONOMY.look)[number]["id"];
 /** Stable id of a light mood, e.g. `"overcast"`. */
 type MoodId = (typeof CREATIVE_TAXONOMY.mood)[number]["id"];
@@ -284,6 +262,15 @@ interface ImageSizeBounds {
   /** Both edges must be multiples of this. Motif uses 16 when absent. */
   multipleOf?: number;
 }
+interface JobStatus {
+  error?: string;
+  logs?: {
+    message: string;
+    timestamp: string;
+  }[];
+  queuePosition?: number;
+  status: "queued" | "processing" | "completed" | "failed";
+}
 /** ─── Configuration ──────────────────────────────────────────── */
 /** The network seam: a `fetch`-shaped function. */
 type FalFetch = (url: string, init: RequestInit) => Promise<Response>;
@@ -1057,6 +1044,38 @@ export declare function resolveTask(task: TaskId, request: TaskRequest, environm
  */
 export declare function tierChangesChoice(task: TaskId, request: Omit<TaskRequest, "tier">, environment: TaskEnvironment): boolean;
 //#endregion
+//#region src/task-stream.d.ts
+interface TaskStreamOptions {
+  signal?: AbortSignal;
+  /** Overall deadline covering connection and consumption, in milliseconds. */
+  timeout?: number;
+}
+interface EventMetadata {
+  event?: string;
+  id?: string;
+}
+type TaskStreamEvent = EventMetadata & ({
+  type: "images";
+  files: TaskFile[];
+  raw: unknown;
+} | {
+  type: "progress";
+  progress?: number;
+  message?: string;
+  raw: unknown;
+} | {
+  type: "provider";
+  data: unknown;
+});
+interface TaskStream {
+  plan: TaskPlan;
+  requestId?: string;
+  /** Single-use stream. EOF does not establish generation success. */
+  events: AsyncIterable<Result$1<TaskStreamEvent, MotifError>>;
+  /** Stops local consumption; does not guarantee provider cancellation or refund. */
+  abort: () => void;
+}
+//#endregion
 //#region src/tool-cost.d.ts
 /** Pixel dimensions of one file an endpoint returned. */
 interface OutputDimensions {
@@ -1177,7 +1196,12 @@ interface TaskInput {
   params?: Readonly<Record<string, unknown>>;
   /** Ask fal not to store IO payloads. */
   ephemeral?: boolean;
-  onProgress?: (status: string, queuePosition?: number) => void;
+  /**
+   * Called on each poll of fal's queue with its status ("queued",
+   * "processing", "completed", "failed") and, while queued, the place in line. Passing
+   * it runs a fal generation through the queue, since only the queue reports.
+   */
+  onProgress?: (status: JobStatus["status"], queuePosition?: number) => void;
 }
 interface TaskFile {
   /** Output key the URL came from, e.g. "image", "masks", "model_glb". */
@@ -1222,6 +1246,7 @@ interface MotifClient {
   /** Pure: resolve the Model, build the request, price it. No I/O. */
   plan: (task: TaskId, input: TaskInput, options?: PlanOptions) => Result$1<TaskPlan, MotifError>;
   run: (task: TaskId, input: TaskInput) => Promise<Result$1<TaskOutput, MotifError>>;
+  stream: (task: TaskId, input: TaskInput, options?: TaskStreamOptions) => Promise<Result$1<TaskStream, MotifError>>;
   animate: TaskFunction;
   ask: TaskFunction;
   cutout: TaskFunction;
@@ -1300,4 +1325,4 @@ export declare function getFalKeyFromEnv(input?: Record<string, unknown>): strin
 /** The OpenAI key, used by direct OpenAI routes such as gpt2 transparency. */
 export declare function getOpenAiKeyFromEnv(input?: Record<string, unknown>): string | undefined;
 //#endregion
-export { type AspectRatio, type Blocker, type Capability, type ChosenBy, type CreativeDirection, type CreativeField, type CreativeOption, type CreativeOptionErrorDetails, type CreativePromptResult, type CustomImageSize, type EnrichPromptOptions, type FalFetch, type ImageSizeBounds, type LookId, type LookOption, type ModelProfile, type MoodId, type MotifClient, type MotifClientConfig, type MotifEnv, type OutputDimensions, type PlanOptions, type PromptWarning, type PromptWarningRule, type RankedFrom, type RankedModel, type Resolution, type ResolvedCost, type Result, type ResultAsync, type TaskDefinition, type TaskEnvironment, type TaskFile, type TaskFunction, type TaskId, type TaskInput, type TaskMode, type TaskOutput, type TaskPlan, type TaskRequest, type TaskResolution, type TaskResolved, type TaskUnresolved, type Tier, type Unblocker, err, ok };
+export { type AspectRatio, type Blocker, type Capability, type ChosenBy, type CreativeDirection, type CreativeField, type CreativeOption, type CreativeOptionErrorDetails, type CreativePromptResult, type CustomImageSize, type EnrichPromptOptions, type FalFetch, type ImageSizeBounds, type LookId, type LookOption, type ModelProfile, type MoodId, type MotifClient, type MotifClientConfig, type MotifEnv, type OutputDimensions, type PlanOptions, type PromptWarning, type PromptWarningRule, type RankedFrom, type RankedModel, type Resolution, type ResolvedCost, type Result, type ResultAsync, type TaskDefinition, type TaskEnvironment, type TaskFile, type TaskFunction, type TaskId, type TaskInput, type TaskMode, type TaskOutput, type TaskPlan, type TaskRequest, type TaskResolution, type TaskResolved, type TaskStream, type TaskStreamEvent, type TaskStreamOptions, type TaskUnresolved, type Tier, type Unblocker, err, ok };

package/dist/index.d.ts

@@ -34,7 +34,8 @@ interface CreativeOption {
 interface LookOption extends CreativeOption {
   /**
    * Whether a mood may be combined with this look. Flat looks (surfaces,
-   * prints, paintings, studio objects) carry their own light and refuse one.
+   * paintings, illustrations, studio objects) carry their own light and
+   * refuse one.
    */
   acceptsMood: boolean;
   /** Default aspect ratio, e.g. `"3:2"`. */
@@ -70,10 +71,11 @@ export declare class CreativeOptionError extends Error implements CreativeOption
 /** Canonical creative field order used for prompt enrichment and schema output. */
 export declare const CREATIVE_FIELDS: readonly ["look", "mood"];
 /**
- * Built-in creative direction catalogue: twelve house looks and six light moods.
+ * Built-in creative direction catalogue: nine house looks and six light moods.
  *
  * Each option carries the exact prompt sentence appended when it is selected.
- * Looks also carry the aspect ratio and model they were tuned for.
+ * Looks also carry the aspect ratio and model they were tuned for. The five
+ * photographic looks come first, then the four flat ones.
  */
 export declare const CREATIVE_TAXONOMY: {
   readonly look: readonly [{
@@ -87,92 +89,68 @@ export declare const CREATIVE_TAXONOMY: {
   }, {
     readonly acceptsMood: true;
     readonly aspect: "1:1";
-    readonly clause: "Editorial still life on a warm bone plaster ground, chalky unglazed surfaces, a long soft shadow, generous empty space, shot on film with fine grain. No text, no logos, no people";
-    readonly description: "Objects and material samples on a plaster ground, for product and swatch shots.";
+    readonly clause: "Editorial still life in the register of Aesop and Kinfolk, on a warm bone plaster ground, chalky unglazed surfaces in muted mineral colour, a long soft shadow, generous empty space, shot on film with fine grain, restrained and materially rich. No text, no logos, no people";
+    readonly description: "Objects and products on a plaster ground, for product and editorial still life.";
     readonly id: "still-life";
-    readonly label: "Material still life";
+    readonly label: "Editorial still life";
     readonly model: "flux2-pro";
   }, {
     readonly acceptsMood: true;
     readonly aspect: "3:2";
-    readonly clause: "Interior photograph shot square-on at eye level on a 35mm lens, warm off-white plaster, wide oak floorboards, linen, brass and a little pattern, light, bright and layered, collected rather than styled, slightly imperfect and lived-in rather than showroom-perfect, photographic realism. No text, no logos, no people";
+    readonly clause: "Interior photograph in the register of House & Garden and Kinfolk, shot square-on at eye level on a 35mm lens, warm off-white plaster, wide oak floorboards, linen, brass and a little pattern, light, bright and layered, collected rather than styled, lived-in rather than showroom-perfect, soft natural daylight, shot on film with fine grain. No text, no logos, no people";
     readonly description: "Bright, collected rooms that feel lived in, for interior scenes.";
-    readonly id: "lived-in";
-    readonly label: "Lived-in interior";
+    readonly id: "interior";
+    readonly label: "Interior";
     readonly model: "flux2-pro";
   }, {
     readonly acceptsMood: true;
     readonly aspect: "4:5";
-    readonly clause: "Architectural editorial photograph at full room scale, honest materials meeting precise detailing, one hero element genuinely installed, plausible light and shadow, generous negative space, empty of people. No text, no logos";
-    readonly description: "Whole rooms with one product installed, for showing a material at scale.";
+    readonly clause: "Architectural photograph in the register of House & Garden and Kinfolk, a considered house seen from outside at editorial distance with its garden and setting, pale render, stone or timber meeting precise detailing, clipped planting, soft warm daylight and long shadow, generous negative space, immaculate and calm, shot on film with fine grain. No text, no logos, no people";
+    readonly description: "Buildings and their settings from outside, for architecture, property and place.";
     readonly id: "architectural";
-    readonly label: "Architectural scale";
+    readonly label: "Architectural exterior";
     readonly model: "banana";
-  }, {
-    readonly acceptsMood: true;
-    readonly aspect: "4:3";
-    readonly clause: "Amateur phone photo of a real home taken by the homeowner, slightly wonky framing, unstyled domestic photography, ordinary exposure. No text, no people";
-    readonly description: "Unstyled phone snapshots of real homes, for believable before and after shots.";
-    readonly id: "homeowner";
-    readonly label: "Homeowner snapshot";
-    readonly model: "seedream45";
   }, {
     readonly acceptsMood: true;
     readonly aspect: "1:1";
-    readonly clause: "Stylised architectural illustration of the room, colour laid as flat planes on walls, joinery and trim, fine hand-drawn line with a gentle gouache wash, clearly a drawing of a design decision rather than a photograph. No text, no people";
-    readonly description: "Line and gouache room drawings, for showing a colour scheme as a design idea.";
-    readonly experimental: true;
-    readonly id: "drawing";
-    readonly label: "Palette drawing";
-    readonly model: "gpt2";
+    readonly clause: "Editorial documentary portrait in the register of Kinfolk, muted warm palette, waist-up and unposed against a plain plaster or linen ground, plain clothing with no logos, soft natural light, shot on film with fine grain. No text";
+    readonly description: "Natural, unposed documentary portraits of people. Pair with a mood for the light.";
+    readonly id: "portrait";
+    readonly label: "Documentary portrait";
+    readonly model: "seedream45";
   }, {
     readonly acceptsMood: false;
     readonly aspect: "1:1";
-    readonly clause: "Straight-on orthographic photograph of the surface filling the entire frame edge to edge, even shadowless studio light, crisp macro texture, colour-accurate. No text, no logos";
-    readonly description: "Flat, edge-to-edge surface photographs, for textures and material swatches.";
-    readonly id: "plate";
-    readonly label: "Flat plate";
+    readonly clause: "A single matte object centred with generous empty space, soft diffused studio light, minimal and quiet in the register of Aesop, one committed muted mineral colour on a plain ground. No text, no logos, no people";
+    readonly description: "One object in one colour on a clean ground, for icons and simple product shots.";
+    readonly id: "object";
+    readonly label: "Studio object";
     readonly model: "flux2-pro";
   }, {
     readonly acceptsMood: false;
     readonly aspect: "1:1";
-    readonly clause: "Fine hand-engraved botanical plate with delicate hatching and dry brush, grey ink only, reaching near-black at its densest, on matte uncoated stock under flat even light, cropped mid-motif and running past all four edges, never simplified or cartoonish. No text";
-    readonly description: "Grey-ink botanical engravings that run off the edges, for patterns and backgrounds.";
-    readonly id: "engraved";
-    readonly label: "Engraved grey ink";
-    readonly model: "gpt2";
-  }, {
-    readonly acceptsMood: false;
-    readonly aspect: "2:3";
-    readonly clause: "Tightly cropped photograph of a single piece of late-1940s American printed matter, flat and square-on in even light, every pixel paper, letterpress and wood type, sun-faded ink, foxing, soft creases and thumbtack holes, era-correct typography, nothing that looks like a digital photo run through a filter";
-    readonly description: "Aged mid-century printed matter such as posters and cards, where the lettering matters.";
-    readonly id: "ephemera";
-    readonly label: "Period ephemera";
-    readonly model: "ideogram4";
+    readonly clause: "Straight-on orthographic photograph of the surface filling the entire frame edge to edge, even shadowless studio light, crisp macro texture, colour-accurate and quietly material. No text, no logos";
+    readonly description: "Flat, edge-to-edge surface photographs, for textures, backgrounds and material swatches.";
+    readonly id: "surface";
+    readonly label: "Flat surface";
+    readonly model: "flux2-pro";
   }, {
     readonly acceptsMood: false;
-    readonly aspect: "3:4";
-    readonly clause: "Physical mineral pigment and chalk gesso on coarse natural linen, two or three confident gestures, warm ivory, oatmeal, putty and soft charcoal, flat diffuse museum reproduction lighting, shown unframed. No text";
-    readonly description: "Loose abstract paintings on linen, for wall art and calm backgrounds.";
-    readonly id: "canvas";
-    readonly label: "Linen abstract";
+    readonly aspect: "3:2";
+    readonly clause: "Painted abstraction filling the frame edge to edge, mineral pigment and chalk gesso on coarse natural linen, two or three confident gestures, warm ivory, oatmeal, putty and soft charcoal, flat diffuse reproduction light. No text";
+    readonly description: "Painted abstraction edge to edge, for wall art, heroes and calm backgrounds.";
+    readonly id: "abstract";
+    readonly label: "Painted abstract";
     readonly model: "banana";
-  }, {
-    readonly acceptsMood: true;
-    readonly aspect: "1:1";
-    readonly clause: "Editorial documentary portrait, muted warm palette, waist-up, unposed, plain clothing with no logos. No text";
-    readonly description: "Natural, unposed documentary portraits of people. Pair with a mood for the light.";
-    readonly id: "portrait";
-    readonly label: "Documentary portrait";
-    readonly model: "seedream45";
   }, {
     readonly acceptsMood: false;
     readonly aspect: "1:1";
-    readonly clause: "A single matte object centred with generous empty space, soft diffused studio light, minimal and quiet, one committed colour. No text, no logos, no people";
-    readonly description: "One object in one colour on a clean ground, for icons and simple product shots.";
-    readonly id: "object";
-    readonly label: "Studio object";
-    readonly model: "flux2-pro";
+    readonly clause: "Stylised editorial illustration in the register of Kinfolk, colour laid as flat planes in a warm muted palette of ivory, putty, sage and charcoal, fine hand-drawn line with a gentle gouache wash, generous empty space, clearly a drawing rather than a photograph. No text, no logos";
+    readonly description: "Line and gouache illustration of any subject, for drawn editorial imagery.";
+    readonly experimental: true;
+    readonly id: "illustration";
+    readonly label: "Editorial illustration";
+    readonly model: "gpt2";
   }];
   readonly mood: readonly [{
     readonly clause: "soft natural daylight from a window out of frame, gentle falloff into the corners, low contrast, even diffused light with soft, held highlights";
@@ -208,7 +186,7 @@ export declare const CREATIVE_TAXONOMY: {
 };
 /** Every house look, in catalogue order. */
 export declare const LOOKS: readonly LookOption[];
-/** Stable id of a house look, e.g. `"lived-in"`. */
+/** Stable id of a house look, e.g. `"interior"`. */
 type LookId = (typeof CREATIVE_TAXONOMY.look)[number]["id"];
 /** Stable id of a light mood, e.g. `"overcast"`. */
 type MoodId = (typeof CREATIVE_TAXONOMY.mood)[number]["id"];
@@ -284,6 +262,15 @@ interface ImageSizeBounds {
   /** Both edges must be multiples of this. Motif uses 16 when absent. */
   multipleOf?: number;
 }
+interface JobStatus {
+  error?: string;
+  logs?: {
+    message: string;
+    timestamp: string;
+  }[];
+  queuePosition?: number;
+  status: "queued" | "processing" | "completed" | "failed";
+}
 /** ─── Configuration ──────────────────────────────────────────── */
 /** The network seam: a `fetch`-shaped function. */
 type FalFetch = (url: string, init: RequestInit) => Promise<Response>;
@@ -1057,6 +1044,38 @@ export declare function resolveTask(task: TaskId, request: TaskRequest, environm
  */
 export declare function tierChangesChoice(task: TaskId, request: Omit<TaskRequest, "tier">, environment: TaskEnvironment): boolean;
 //#endregion
+//#region src/task-stream.d.ts
+interface TaskStreamOptions {
+  signal?: AbortSignal;
+  /** Overall deadline covering connection and consumption, in milliseconds. */
+  timeout?: number;
+}
+interface EventMetadata {
+  event?: string;
+  id?: string;
+}
+type TaskStreamEvent = EventMetadata & ({
+  type: "images";
+  files: TaskFile[];
+  raw: unknown;
+} | {
+  type: "progress";
+  progress?: number;
+  message?: string;
+  raw: unknown;
+} | {
+  type: "provider";
+  data: unknown;
+});
+interface TaskStream {
+  plan: TaskPlan;
+  requestId?: string;
+  /** Single-use stream. EOF does not establish generation success. */
+  events: AsyncIterable<Result$1<TaskStreamEvent, MotifError>>;
+  /** Stops local consumption; does not guarantee provider cancellation or refund. */
+  abort: () => void;
+}
+//#endregion
 //#region src/tool-cost.d.ts
 /** Pixel dimensions of one file an endpoint returned. */
 interface OutputDimensions {
@@ -1177,7 +1196,12 @@ interface TaskInput {
   params?: Readonly<Record<string, unknown>>;
   /** Ask fal not to store IO payloads. */
   ephemeral?: boolean;
-  onProgress?: (status: string, queuePosition?: number) => void;
+  /**
+   * Called on each poll of fal's queue with its status ("queued",
+   * "processing", "completed", "failed") and, while queued, the place in line. Passing
+   * it runs a fal generation through the queue, since only the queue reports.
+   */
+  onProgress?: (status: JobStatus["status"], queuePosition?: number) => void;
 }
 interface TaskFile {
   /** Output key the URL came from, e.g. "image", "masks", "model_glb". */
@@ -1222,6 +1246,7 @@ interface MotifClient {
   /** Pure: resolve the Model, build the request, price it. No I/O. */
   plan: (task: TaskId, input: TaskInput, options?: PlanOptions) => Result$1<TaskPlan, MotifError>;
   run: (task: TaskId, input: TaskInput) => Promise<Result$1<TaskOutput, MotifError>>;
+  stream: (task: TaskId, input: TaskInput, options?: TaskStreamOptions) => Promise<Result$1<TaskStream, MotifError>>;
   animate: TaskFunction;
   ask: TaskFunction;
   cutout: TaskFunction;
@@ -1300,4 +1325,4 @@ export declare function getFalKeyFromEnv(input?: Record<string, unknown>): strin
 /** The OpenAI key, used by direct OpenAI routes such as gpt2 transparency. */
 export declare function getOpenAiKeyFromEnv(input?: Record<string, unknown>): string | undefined;
 //#endregion
-export { type AspectRatio, type Blocker, type Capability, type ChosenBy, type CreativeDirection, type CreativeField, type CreativeOption, type CreativeOptionErrorDetails, type CreativePromptResult, type CustomImageSize, type EnrichPromptOptions, type FalFetch, type ImageSizeBounds, type LookId, type LookOption, type ModelProfile, type MoodId, type MotifClient, type MotifClientConfig, type MotifEnv, type OutputDimensions, type PlanOptions, type PromptWarning, type PromptWarningRule, type RankedFrom, type RankedModel, type Resolution, type ResolvedCost, type Result, type ResultAsync, type TaskDefinition, type TaskEnvironment, type TaskFile, type TaskFunction, type TaskId, type TaskInput, type TaskMode, type TaskOutput, type TaskPlan, type TaskRequest, type TaskResolution, type TaskResolved, type TaskUnresolved, type Tier, type Unblocker, err, ok };
+export { type AspectRatio, type Blocker, type Capability, type ChosenBy, type CreativeDirection, type CreativeField, type CreativeOption, type CreativeOptionErrorDetails, type CreativePromptResult, type CustomImageSize, type EnrichPromptOptions, type FalFetch, type ImageSizeBounds, type LookId, type LookOption, type ModelProfile, type MoodId, type MotifClient, type MotifClientConfig, type MotifEnv, type OutputDimensions, type PlanOptions, type PromptWarning, type PromptWarningRule, type RankedFrom, type RankedModel, type Resolution, type ResolvedCost, type Result, type ResultAsync, type TaskDefinition, type TaskEnvironment, type TaskFile, type TaskFunction, type TaskId, type TaskInput, type TaskMode, type TaskOutput, type TaskPlan, type TaskRequest, type TaskResolution, type TaskResolved, type TaskStream, type TaskStreamEvent, type TaskStreamOptions, type TaskUnresolved, type Tier, type Unblocker, err, ok };