@howells/motif-sdk 5.4.0 → 7.0.0

package/dist/index.d.cts

@@ -117,7 +117,7 @@ export declare const CREATIVE_TAXONOMY: {
     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 model: "seedream5";
   }, {
     readonly acceptsMood: false;
     readonly aspect: "1:1";
@@ -150,7 +150,7 @@ export declare const CREATIVE_TAXONOMY: {
     readonly experimental: true;
     readonly id: "illustration";
     readonly label: "Editorial illustration";
-    readonly model: "gpt2";
+    readonly model: "flare";
   }];
   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";
@@ -533,7 +533,7 @@ export declare const TASKS: {
     readonly summary: "Remove an object, person, text or clutter from an image and fill the gap.";
   };
   readonly generate: {
-    readonly basis: "Order follows Arena text-to-image (https://arena.ai/leaderboard/image/text-to-image), read 2026-10-29 (MOT-72). Sunburst and Flare lead quality at the benchmarked max setting. Balanced starts with Nano Banana 2.1 on preliminary Arena evidence, then Grok Image 2 and Muse Image. Models not yet on the board follow the ranked ones in their Tier, in their previous order. The Artificial Analysis v2 snapshot of 2026-10-07 stays as recorded benchmark data. Fast keeps Nano Banana 2 Lite, budget Grok and Seedream 5 Lite, and FLUX.2 Turbo. Design, transparency and tuned Look routes are capability exceptions. Generation with References uses the separate editing ranking. Older routes are explicit/pin/Look-only.";
+    readonly basis: "Order follows Arena text-to-image (https://arena.ai/leaderboard/image/text-to-image), read 2026-10-29. Sunburst and Flare lead quality at the benchmarked max setting. Balanced starts with Nano Banana 2.1 on preliminary Arena evidence, then Grok Image 2 and Muse Image. Models not yet on the board follow the ranked ones in their Tier, in their previous order. The Artificial Analysis v2 snapshot of 2026-10-07 stays as recorded benchmark data. Fast keeps Nano Banana 2 Lite, budget Grok and Seedream 5 Lite, and FLUX.2 Turbo. Design, transparency and tuned Look routes are capability exceptions. Generation with References uses the separate editing ranking. Older routes are explicit/pin/Look-only.";
     readonly models: readonly RankedModel[];
     readonly notFor: "Variations of an image you already have (vary), or a consistent set of images (series run).";
     readonly rankedAt: "2026-10-29";
@@ -946,7 +946,7 @@ export declare const TASKS: {
     readonly summary: "Trace a raster image to a clean SVG.";
   };
   readonly vary: {
-    readonly basis: "Order follows Arena image edit, single image (https://arena.ai/leaderboard/image/image-edit/single-image), read 2026-10-29 (MOT-72). Editing order differs from generation: Grok Image 2 leads balanced, ahead of Nano Banana 2.1, and Seedream 5 Pro outranks GPT Image 1.5. Arena scores Krea 3 only at its Ultra setting, which costs $0.27 to $0.35 an edit and ignores the requested size, so krea3, which runs fal's default setting, is ranked as unscored. Models not yet on the board follow the ranked ones in their Tier, in their previous order. The Artificial Analysis v2 snapshot of 2026-10-07 stays as recorded benchmark data. Sunburst and Flare use max quality. vary reuses a previously chosen Model when explicitly supplied, including retained legacy routes.";
+    readonly basis: "Order follows Arena image edit, single image (https://arena.ai/leaderboard/image/image-edit/single-image), read 2026-10-29. Editing order differs from generation: Grok Image 2 leads balanced, ahead of Nano Banana 2.1, and Seedream 5 Pro outranks GPT Image 1.5. Arena scores Krea 3 only at its Ultra setting, which costs $0.27 to $0.35 an edit and ignores the requested size, so krea3, which runs fal's default setting, is ranked as unscored. Models not yet on the board follow the ranked ones in their Tier, in their previous order. The Artificial Analysis v2 snapshot of 2026-10-07 stays as recorded benchmark data. Sunburst and Flare use max quality. vary reuses a previously chosen Model when explicitly supplied, including retained legacy routes.";
     readonly models: readonly RankedModel[];
     readonly notFor: "A specific change to an image described in words (generate with a reference), or a set of different scenes in one style (series run).";
     readonly rankedAt: "2026-10-29";
@@ -1030,8 +1030,6 @@ interface TaskUnresolved {
 type TaskResolution = TaskResolved | TaskUnresolved;
 interface ModelProfile {
   readonly capabilities: ReadonlySet<Capability>;
-  /** Capabilities reachable only when this key variable is set. */
-  readonly keyedCapabilities: ReadonlyMap<Capability, string>;
   /** Key variables the Model needs for any request. */
   readonly keys: readonly string[];
   readonly maxReferences: number;
@@ -1140,8 +1138,6 @@ export declare function sumCosts(costs: readonly (number | null)[]): {
 interface MotifClientConfig {
   /** Falls back to FAL_KEY. */
   falKey?: string;
-  /** Falls back to OPENAI_API_KEY. Used only by Models routed through OpenAI. */
-  openAiKey?: string;
   /** Models pinned per Task, as `resolveTask` takes them. */
   pins?: TaskEnvironment["pins"];
   /** The one network seam. Defaults to global fetch. Retries and timeouts still apply. */
@@ -1259,8 +1255,8 @@ interface TaskPlan {
   queued: boolean;
   /** Projected: before the call. */
   cost: ResolvedCost;
-  /** The provider carrying the request. "openai" only for a transparency route. */
-  provider: "fal" | "openai";
+  /** The provider carrying the request. */
+  provider: "fal";
 }
 interface TaskOutput extends Omit<TaskPlan, "body" | "cost" | "queued"> {
   files: TaskFile[];
@@ -1311,7 +1307,7 @@ interface MotifClient {
    */
   resume: (task: TaskId, input: TaskInput, requestId: string) => Promise<Result$1<TaskOutput, MotifError>>;
 }
-/** Create the Task client. Keys fall back to FAL_KEY and OPENAI_API_KEY. */
+/** Create the Task client. The key falls back to FAL_KEY. */
 export declare function createMotif(config?: MotifClientConfig): MotifClient;
 //#endregion
 //#region src/task-plan-shared.d.ts
@@ -1357,13 +1353,10 @@ export declare function promptWarnings(prompt: string, context?: {
 export declare const motifEnvSchema: import("@howells/envy").EnvSchema<{
   readonly optional: {
     FAL_KEY: z.ZodString;
-    OPENAI_API_KEY: z.ZodString;
   };
 }>;
 type MotifEnv = ReturnType<typeof motifEnvSchema.parse>;
 export declare function parseMotifEnv(input?: Record<string, unknown>): MotifEnv;
 export declare function getFalKeyFromEnv(input?: Record<string, unknown>): string | undefined;
-/** 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 TaskStream, type TaskStreamEvent, type TaskStreamOptions, type TaskUnresolved, type Tier, type Unblocker, err, ok };

package/dist/index.d.ts

@@ -117,7 +117,7 @@ export declare const CREATIVE_TAXONOMY: {
     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 model: "seedream5";
   }, {
     readonly acceptsMood: false;
     readonly aspect: "1:1";
@@ -150,7 +150,7 @@ export declare const CREATIVE_TAXONOMY: {
     readonly experimental: true;
     readonly id: "illustration";
     readonly label: "Editorial illustration";
-    readonly model: "gpt2";
+    readonly model: "flare";
   }];
   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";
@@ -533,7 +533,7 @@ export declare const TASKS: {
     readonly summary: "Remove an object, person, text or clutter from an image and fill the gap.";
   };
   readonly generate: {
-    readonly basis: "Order follows Arena text-to-image (https://arena.ai/leaderboard/image/text-to-image), read 2026-10-29 (MOT-72). Sunburst and Flare lead quality at the benchmarked max setting. Balanced starts with Nano Banana 2.1 on preliminary Arena evidence, then Grok Image 2 and Muse Image. Models not yet on the board follow the ranked ones in their Tier, in their previous order. The Artificial Analysis v2 snapshot of 2026-10-07 stays as recorded benchmark data. Fast keeps Nano Banana 2 Lite, budget Grok and Seedream 5 Lite, and FLUX.2 Turbo. Design, transparency and tuned Look routes are capability exceptions. Generation with References uses the separate editing ranking. Older routes are explicit/pin/Look-only.";
+    readonly basis: "Order follows Arena text-to-image (https://arena.ai/leaderboard/image/text-to-image), read 2026-10-29. Sunburst and Flare lead quality at the benchmarked max setting. Balanced starts with Nano Banana 2.1 on preliminary Arena evidence, then Grok Image 2 and Muse Image. Models not yet on the board follow the ranked ones in their Tier, in their previous order. The Artificial Analysis v2 snapshot of 2026-10-07 stays as recorded benchmark data. Fast keeps Nano Banana 2 Lite, budget Grok and Seedream 5 Lite, and FLUX.2 Turbo. Design, transparency and tuned Look routes are capability exceptions. Generation with References uses the separate editing ranking. Older routes are explicit/pin/Look-only.";
     readonly models: readonly RankedModel[];
     readonly notFor: "Variations of an image you already have (vary), or a consistent set of images (series run).";
     readonly rankedAt: "2026-10-29";
@@ -946,7 +946,7 @@ export declare const TASKS: {
     readonly summary: "Trace a raster image to a clean SVG.";
   };
   readonly vary: {
-    readonly basis: "Order follows Arena image edit, single image (https://arena.ai/leaderboard/image/image-edit/single-image), read 2026-10-29 (MOT-72). Editing order differs from generation: Grok Image 2 leads balanced, ahead of Nano Banana 2.1, and Seedream 5 Pro outranks GPT Image 1.5. Arena scores Krea 3 only at its Ultra setting, which costs $0.27 to $0.35 an edit and ignores the requested size, so krea3, which runs fal's default setting, is ranked as unscored. Models not yet on the board follow the ranked ones in their Tier, in their previous order. The Artificial Analysis v2 snapshot of 2026-10-07 stays as recorded benchmark data. Sunburst and Flare use max quality. vary reuses a previously chosen Model when explicitly supplied, including retained legacy routes.";
+    readonly basis: "Order follows Arena image edit, single image (https://arena.ai/leaderboard/image/image-edit/single-image), read 2026-10-29. Editing order differs from generation: Grok Image 2 leads balanced, ahead of Nano Banana 2.1, and Seedream 5 Pro outranks GPT Image 1.5. Arena scores Krea 3 only at its Ultra setting, which costs $0.27 to $0.35 an edit and ignores the requested size, so krea3, which runs fal's default setting, is ranked as unscored. Models not yet on the board follow the ranked ones in their Tier, in their previous order. The Artificial Analysis v2 snapshot of 2026-10-07 stays as recorded benchmark data. Sunburst and Flare use max quality. vary reuses a previously chosen Model when explicitly supplied, including retained legacy routes.";
     readonly models: readonly RankedModel[];
     readonly notFor: "A specific change to an image described in words (generate with a reference), or a set of different scenes in one style (series run).";
     readonly rankedAt: "2026-10-29";
@@ -1030,8 +1030,6 @@ interface TaskUnresolved {
 type TaskResolution = TaskResolved | TaskUnresolved;
 interface ModelProfile {
   readonly capabilities: ReadonlySet<Capability>;
-  /** Capabilities reachable only when this key variable is set. */
-  readonly keyedCapabilities: ReadonlyMap<Capability, string>;
   /** Key variables the Model needs for any request. */
   readonly keys: readonly string[];
   readonly maxReferences: number;
@@ -1140,8 +1138,6 @@ export declare function sumCosts(costs: readonly (number | null)[]): {
 interface MotifClientConfig {
   /** Falls back to FAL_KEY. */
   falKey?: string;
-  /** Falls back to OPENAI_API_KEY. Used only by Models routed through OpenAI. */
-  openAiKey?: string;
   /** Models pinned per Task, as `resolveTask` takes them. */
   pins?: TaskEnvironment["pins"];
   /** The one network seam. Defaults to global fetch. Retries and timeouts still apply. */
@@ -1259,8 +1255,8 @@ interface TaskPlan {
   queued: boolean;
   /** Projected: before the call. */
   cost: ResolvedCost;
-  /** The provider carrying the request. "openai" only for a transparency route. */
-  provider: "fal" | "openai";
+  /** The provider carrying the request. */
+  provider: "fal";
 }
 interface TaskOutput extends Omit<TaskPlan, "body" | "cost" | "queued"> {
   files: TaskFile[];
@@ -1311,7 +1307,7 @@ interface MotifClient {
    */
   resume: (task: TaskId, input: TaskInput, requestId: string) => Promise<Result$1<TaskOutput, MotifError>>;
 }
-/** Create the Task client. Keys fall back to FAL_KEY and OPENAI_API_KEY. */
+/** Create the Task client. The key falls back to FAL_KEY. */
 export declare function createMotif(config?: MotifClientConfig): MotifClient;
 //#endregion
 //#region src/task-plan-shared.d.ts
@@ -1357,13 +1353,10 @@ export declare function promptWarnings(prompt: string, context?: {
 export declare const motifEnvSchema: import("@howells/envy").EnvSchema<{
   readonly optional: {
     FAL_KEY: z.ZodString;
-    OPENAI_API_KEY: z.ZodString;
   };
 }>;
 type MotifEnv = ReturnType<typeof motifEnvSchema.parse>;
 export declare function parseMotifEnv(input?: Record<string, unknown>): MotifEnv;
 export declare function getFalKeyFromEnv(input?: Record<string, unknown>): string | undefined;
-/** 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 TaskStream, type TaskStreamEvent, type TaskStreamOptions, type TaskUnresolved, type Tier, type Unblocker, err, ok };