@howells/motif-sdk 7.0.0 → 7.1.0

package/README.md

@@ -34,7 +34,7 @@ Every Task function returns `Result<TaskOutput, MotifError>` from `neverthrow` a
 
 ## Curated Models and Tiers
 
-The Task client curates 23 generation Models, with separate rankings for generation and editing. Both follow Arena, read 29 October 2026. `TASKS.generate` and `TASKS.vary` expose the current choices, Tiers and evidence in `basis` and `rankedAt`. A generation with `references` uses the editing ranking.
+The Task client curates 23 generation Models, with separate rankings for generation and editing. Both follow Arena, read 29 October 2026. `TASKS.generate` and `TASKS.vary` expose the current choices, Tiers and evidence in `basis` and `rankedAt`. Sunburst and Flare run GPT Image 2.6; Arena has not scored 2.6 yet, so their benchmarks are the GPT Image 2.5 scores, and each carries a `note` saying so. A generation with `references` uses the editing ranking.
 
 | Tier                 | Generation default | Editing default   |
 | -------------------- | ------------------ | ----------------- |

package/dist/image.d.ts

@@ -1,11 +1,25 @@
+/**
+ * `@howells/motif-sdk/image` — provider-agnostic image generation + editing.
+ *
+ * ESM-only subpath export, built on the Vercel AI SDK image interface
+ * (`generateImage`, `@ai-sdk/*`). The caller names the provider and model;
+ * reuses the SDK's Result convention (`Result<T, MotifError>` — no
+ * thrown exceptions). Gemini is reached through OpenRouter.
+ *
+ * @example
+ * ```ts
+ * import { createMotifImage } from "@howells/motif-sdk/image";
+ *
+ * const img = createMotifImage({ defaultProvider: "openrouter" });
+ * const r = await img.generate({ model: "gemini-3.1-flash-image", prompt: "a bare concrete wall" });
+ * if (r.isOk()) console.log(r.value.images[0].mediaType, r.value.cost);
+ * ```
+ */
 import { ImageModel, generateImage } from "ai";
 import { Result } from "neverthrow";
-//#region src/types.d.ts
 /** ─── Configuration ──────────────────────────────────────────── */
 /** The network seam: a `fetch`-shaped function. */
 type FalFetch = (url: string, init: RequestInit) => Promise<Response>;
-//#endregion
-//#region src/errors.d.ts
 /**
  * `MotifError` and its coercion helper.
  *
@@ -24,8 +38,6 @@ declare class MotifError extends Error {
   readonly details?: Record<string, unknown>;
   constructor(message: string, status: number, code?: string, requestId?: string, details?: Record<string, unknown>);
 }
-//#endregion
-//#region src/image/types.d.ts
 /**
  * Image provider id. All four Phase 1b adapters are implemented
  * (`openrouter`, `openai`, `replicate`, `fal`); the type keeps an open union tail so
@@ -240,8 +252,6 @@ interface MotifImageClient {
    */
   bestOfN: (opts: BestOfNOptions) => Promise<Result<BestOfNResult, MotifError>>;
 }
-//#endregion
-//#region src/image/deps.d.ts
 /** A model resolver: builds an AI SDK `ImageModel` for a (provider, model, key). */
 type ResolveImageModel = (provider: ImageProviderId, modelId: string, apiKey?: string, fetch?: FalFetch) => ImageModel;
 /** Internal dependency-injection seam (default: real `generateImage` + adapters). */
@@ -249,8 +259,6 @@ interface MotifImageDeps {
   generateImage?: typeof generateImage;
   resolveModel?: ResolveImageModel;
 }
-//#endregion
-//#region src/image/provider.d.ts
 /**
  * A single image provider. A thin wrapper over the provider's `@ai-sdk/*` image
  * model, plus the metadata the layer needs to resolve keys and meter spend.
@@ -292,24 +300,14 @@ export declare const PROVIDERS: Record<ImageProviderId, ImageProviderAdapter>;
  * provider (callers catch this into a `Result.err`).
  */
 export declare function getProviderAdapter(provider: ImageProviderId): ImageProviderAdapter;
-//#endregion
-//#region src/image/openrouter.d.ts
 /** Env var read for the OpenRouter API key when `apiKey` is not supplied in config. */
 export declare const OPENROUTER_API_KEY_ENV = "OPENROUTER_API_KEY";
-//#endregion
-//#region src/image/openai.d.ts
 /** Env var read for the OpenAI API key when `apiKey` is not supplied in config. */
 export declare const OPENAI_API_KEY_ENV = "OPENAI_API_KEY";
-//#endregion
-//#region src/image/replicate.d.ts
 /** Env var read for the Replicate API token when `apiToken` is not in config. */
 export declare const REPLICATE_API_KEY_ENV = "REPLICATE_API_TOKEN";
-//#endregion
-//#region src/image/fal.d.ts
 /** Env var read for the fal key when `apiKey` is not supplied in config. */
 export declare const FAL_API_KEY_ENV = "FAL_KEY";
-//#endregion
-//#region src/image/cost.d.ts
 /**
  * Extract a provider-reported total cost from a `generateImage` result's
  * `providerMetadata`, if the provider surfaces a numeric `cost`. The shape is
@@ -323,8 +321,6 @@ export declare function providerPricePerImageUsd(provider: ImageProviderId, mode
  * then the static table (× image count), then unknown.
  */
 export declare function costForImages(provider: ImageProviderId, modelId: string, providerMetadata: unknown, imageCount: number): ImageCost;
-//#endregion
-//#region src/image/index.d.ts
 /**
  * Create a provider-agnostic image client.
  *
@@ -333,5 +329,4 @@ export declare function costForImages(provider: ImageProviderId, modelId: string
  *   and the built-in provider adapters; tests inject fakes here to run offline.
  */
 export declare function createMotifImage(config?: MotifImageConfig, deps?: MotifImageDeps): MotifImageClient;
-//#endregion
 export type { BestOfNOptions, BestOfNResult, EditImageOptions, GenerateImageOptions, ImageCost, ImageCostSource, ImageJudge, ImageProviderAdapter, ImageProviderId, MotifImageClient, MotifImageConfig, MotifImageFile, MotifImageResult };

package/dist/image.js

@@ -3,7 +3,7 @@ import { err, ok } from "neverthrow";
 import { createFal } from "@ai-sdk/fal";
 import { createOpenAI } from "@ai-sdk/openai";
 import { createReplicate } from "@ai-sdk/replicate";
-//#region src/errors.ts
+// src/errors.ts
 /**
 * `MotifError` and its coercion helper.
 *
@@ -49,8 +49,7 @@ function falHttpError(status, body, requestId) {
 	if (isFalAccountLocked(status, body)) return new MotifError(`fal account is locked because it is out of credit (fal said: ${body})`, status, ACCOUNT_LOCKED, requestId);
 	return new MotifError(`Request failed: ${status} ${body}`, status, void 0, requestId);
 }
-//#endregion
-//#region src/models.ts
+// src/models.ts
 const AA_IMAGE_LEADERBOARD_SNAPSHOT = "2026-10-07";
 const AA_IMAGE_SOURCES = ["https://artificialanalysis.ai/image/leaderboard/text-to-image", "https://artificialanalysis.ai/image/leaderboard/editing"];
 const FAL_PRICING_CHECKED_AT = "2026-05-12";
@@ -1219,8 +1218,7 @@ const MODELS = {
 	"ideogram3-transparent",
 	"recraft41"
 ].filter((id) => MODELS[id]?.supportsEdit === true);
-//#endregion
-//#region src/capabilities.ts
+// src/capabilities.ts
 /** Generation options a model can refuse, with the registry test for each. */
 const OPTION_CAPABILITIES = {
 	aspect: (config) => (config.sizeMode ?? "aspect_ratio") !== "none",
@@ -1377,8 +1375,7 @@ Object.keys(OPTION_CAPABILITIES).filter(isModelOption);
 		}
 	]
 }).look;
-//#endregion
-//#region src/tool-registry/analysis.ts
+// src/tool-registry/analysis.ts
 const ANALYSIS_TOOLS = {
 	"got-ocr": {
 		category: "analysis",
@@ -1492,8 +1489,7 @@ const ANALYSIS_TOOLS = {
 		task: "vision moderation"
 	}
 };
-//#endregion
-//#region src/tool-registry/assets.ts
+// src/tool-registry/assets.ts
 const ASSET_TOOLS = {
 	"hunyuan3d-v3": {
 		category: "3d",
@@ -1811,8 +1807,7 @@ const ASSET_TOOLS = {
 		task: "single-image 3D reconstruction"
 	}
 };
-//#endregion
-//#region src/tool-registry/background.ts
+// src/tool-registry/background.ts
 const BACKGROUND_TOOLS = {
 	"ben-v2": {
 		category: "background",
@@ -2187,8 +2182,7 @@ const BACKGROUND_TOOLS = {
 		task: "video enhancement"
 	}
 };
-//#endregion
-//#region src/tool-registry/editing.ts
+// src/tool-registry/editing.ts
 const EDITING_TOOLS = {
 	"bria-eraser": {
 		category: "erase",
@@ -2459,8 +2453,7 @@ const EDITING_TOOLS = {
 		task: "virtual garment try-on"
 	}
 };
-//#endregion
-//#region src/tool-registry/structure.ts
+// src/tool-registry/structure.ts
 const STRUCTURE_TOOLS = {
 	"depth-anything": {
 		category: "preprocess",
@@ -2852,8 +2845,7 @@ const STRUCTURE_TOOLS = {
 		task: "depth preprocessing"
 	}
 };
-//#endregion
-//#region src/tools.ts
+// src/tools.ts
 const FAL_TOOLS = {
 	...ANALYSIS_TOOLS,
 	...ASSET_TOOLS,
@@ -2862,8 +2854,7 @@ const FAL_TOOLS = {
 	...STRUCTURE_TOOLS
 };
 Object.keys(FAL_TOOLS);
-//#endregion
-//#region src/image/fetch.ts
+// src/image/fetch.ts
 function urlOf(input) {
 	if (typeof input === "string") return input;
 	return input instanceof URL ? input.href : input.url;
@@ -2873,8 +2864,7 @@ function toProviderFetch(fetch) {
 	if (fetch === void 0) return {};
 	return { fetch: async (input, init) => await fetch(urlOf(input), init ?? {}) };
 }
-//#endregion
-//#region src/image/fal.ts
+// src/image/fal.ts
 /**
 * fal provider adapter.
 *
@@ -2960,8 +2950,7 @@ const falAdapter = {
 	resolveModel: resolveModel$3,
 	priceUsdByModel: FAL_IMAGE_PRICE_USD
 };
-//#endregion
-//#region src/image/openai.ts
+// src/image/openai.ts
 /**
 * OpenAI (gpt-image) provider adapter.
 *
@@ -3007,8 +2996,7 @@ const openaiAdapter = {
 	resolveModel: resolveModel$2,
 	priceUsdByModel: OPENAI_IMAGE_PRICE_USD
 };
-//#endregion
-//#region src/image/openrouter.ts
+// src/image/openrouter.ts
 /** Env var read for the OpenRouter API key when `apiKey` is not supplied in config. */
 const OPENROUTER_API_KEY_ENV = "OPENROUTER_API_KEY";
 const OPENROUTER_IMAGES_URL = "https://openrouter.ai/api/v1/images";
@@ -3171,8 +3159,7 @@ const openrouterAdapter = {
 	resolveModel: resolveModel$1,
 	priceUsdByModel: OPENROUTER_IMAGE_PRICE_USD
 };
-//#endregion
-//#region src/image/replicate.ts
+// src/image/replicate.ts
 /**
 * Replicate provider adapter.
 *
@@ -3207,8 +3194,7 @@ function resolveModel(modelId, apiKey, fetch) {
 		...toProviderFetch(fetch)
 	}).image(modelId);
 }
-//#endregion
-//#region src/image/provider.ts
+// src/image/provider.ts
 /**
 * The provider registry. Every id in {@link ImageProviderId}'s closed part maps
 * to its adapter; the open union tail means a lookup can still miss, so access
@@ -3234,8 +3220,7 @@ function getProviderAdapter(provider) {
 	if (adapter === void 0) throw new MotifError(`Unsupported image provider: ${provider}`, 0);
 	return adapter;
 }
-//#endregion
-//#region src/image/cost.ts
+// src/image/cost.ts
 /**
 * Per-call cost tracking for the image layer.
 *
@@ -3305,8 +3290,7 @@ function costForCalls(provider, modelId, callMetadata, imageCount) {
 		source: "unknown"
 	};
 }
-//#endregion
-//#region src/image/index.ts
+// src/image/index.ts
 /**
 * `@howells/motif-sdk/image` — provider-agnostic image generation + editing.
 *
@@ -3578,5 +3562,4 @@ function toMotifError(error) {
 	if (isFalAccountLocked(status, body)) return falHttpError(status, body);
 	return new MotifError(message, status, code);
 }
-//#endregion
 export { FAL_API_KEY_ENV, OPENAI_API_KEY_ENV, OPENROUTER_API_KEY_ENV, PROVIDERS, REPLICATE_API_KEY_ENV, costForImages, costFromProviderMetadata, createMotifImage, getProviderAdapter, providerPricePerImageUsd };

package/dist/index.cjs

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let neverthrow = require("neverthrow");
 let _howells_envy = require("@howells/envy");
 let zod = require("zod");
-//#region src/aspects.ts
+// src/aspects.ts
 /** Ordered by popularity: square first, then common ratios */
 const ASPECT_RATIOS = [
 	"auto",
@@ -237,8 +237,7 @@ const FORMAT_PRESETS = {
 		label: "Wide"
 	}
 };
-//#endregion
-//#region src/creative.ts
+// src/creative.ts
 const CONTROL_CHAR_REGEX = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g;
 const TRAILING_PERIODS_REGEX = /\.+$/;
 /**
@@ -480,8 +479,7 @@ function enrichPrompt(options) {
 		prompt: clauses.length ? joinSentences([basePrompt, ...clauses].filter((part) => part !== "")) : basePrompt
 	};
 }
-//#endregion
-//#region src/errors.ts
+// src/errors.ts
 /**
 * `MotifError` and its coercion helper.
 *
@@ -538,8 +536,7 @@ function toMotifError(error) {
 	if (error instanceof MotifError) return error;
 	return new MotifError(error instanceof Error ? error.message : String(error), 0, error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : void 0);
 }
-//#endregion
-//#region src/task-plan-shared.ts
+// src/task-plan-shared.ts
 /**
 * Helpers every request builder in the Task planner shares: refusing fields a
 * Model can't carry, and merging `params` without letting them replace what
@@ -619,8 +616,7 @@ function mergeParams(body, params, owned) {
 		...params
 	});
 }
-//#endregion
-//#region src/prompt-warnings.ts
+// src/prompt-warnings.ts
 const EDIT_VERB_REGEX = /^\s*(remove|erase|extend|outpaint)\b/i;
 /** The CLI verb that does each edit directly, keyed by the prompt's first word. */
 const EDIT_VERBS = {
@@ -686,8 +682,7 @@ function promptWarnings(prompt, context = {}) {
 	});
 	return warnings;
 }
-//#endregion
-//#region src/env.ts
+// src/env.ts
 const motifEnvSchema = (0, _howells_envy.defineEnv)({ optional: { FAL_KEY: zod.z.string().min(1) } });
 function parseMotifEnv(input = process.env) {
 	return motifEnvSchema.parse(input);
@@ -695,8 +690,7 @@ function parseMotifEnv(input = process.env) {
 function getFalKeyFromEnv(input = process.env) {
 	return parseMotifEnv(input).FAL_KEY;
 }
-//#endregion
-//#region src/models.ts
+// src/models.ts
 const AA_IMAGE_LEADERBOARD_SNAPSHOT = "2026-10-07";
 const AA_IMAGE_SOURCES = ["https://artificialanalysis.ai/image/leaderboard/text-to-image", "https://artificialanalysis.ai/image/leaderboard/editing"];
 const FAL_PRICING_CHECKED_AT = "2026-05-12";
@@ -1867,8 +1861,7 @@ const GENERATION_MODELS = [
 	"recraft41"
 ];
 GENERATION_MODELS.filter((id) => MODELS[id]?.supportsEdit === true);
-//#endregion
-//#region src/cost.ts
+// src/cost.ts
 /**
 * Estimate cost based on model and settings. `editImages` is the number of
 * input images on an edit, for Models whose edits cost more than generation.
@@ -1898,8 +1891,7 @@ function estimateVideoCost(durationSeconds = 5, generateAudio = true, model = "k
 	if (model === "kling-turbo") return .14 * durationSeconds;
 	return (generateAudio ? .168 : .112) * durationSeconds;
 }
-//#endregion
-//#region src/fal-parse.ts
+// src/fal-parse.ts
 /**
 * Boundary parsing for fal.ai HTTP responses.
 *
@@ -2004,8 +1996,7 @@ function requestIdFromBody(text) {
 	if (!isRecord$1(parsed)) return;
 	return asString(parsed.request_id) ?? asString(parsed.requestId) ?? asString(parsed.trace_id);
 }
-//#endregion
-//#region src/capabilities.ts
+// src/capabilities.ts
 /**
 * Which generation options each model accepts, derived from the registry.
 *
@@ -2095,8 +2086,7 @@ var UnsupportedOptionError = class extends Error {
 		this.supportedOptions = supported;
 	}
 };
-//#endregion
-//#region src/generate.ts
+// src/generate.ts
 const GPT_IMAGE_SIZES = [
 	"auto",
 	"1024x1024",
@@ -2291,8 +2281,7 @@ function buildGenerateBody(options) {
 		endpoint
 	};
 }
-//#endregion
-//#region src/tool-registry/analysis.ts
+// src/tool-registry/analysis.ts
 const ANALYSIS_TOOLS = {
 	"got-ocr": {
 		category: "analysis",
@@ -2406,8 +2395,7 @@ const ANALYSIS_TOOLS = {
 		task: "vision moderation"
 	}
 };
-//#endregion
-//#region src/tool-registry/assets.ts
+// src/tool-registry/assets.ts
 const ASSET_TOOLS = {
 	"hunyuan3d-v3": {
 		category: "3d",
@@ -2725,8 +2713,7 @@ const ASSET_TOOLS = {
 		task: "single-image 3D reconstruction"
 	}
 };
-//#endregion
-//#region src/tool-registry/background.ts
+// src/tool-registry/background.ts
 const BACKGROUND_TOOLS = {
 	"ben-v2": {
 		category: "background",
@@ -3101,8 +3088,7 @@ const BACKGROUND_TOOLS = {
 		task: "video enhancement"
 	}
 };
-//#endregion
-//#region src/tool-registry/editing.ts
+// src/tool-registry/editing.ts
 const EDITING_TOOLS = {
 	"bria-eraser": {
 		category: "erase",
@@ -3373,8 +3359,7 @@ const EDITING_TOOLS = {
 		task: "virtual garment try-on"
 	}
 };
-//#endregion
-//#region src/tool-registry/structure.ts
+// src/tool-registry/structure.ts
 const STRUCTURE_TOOLS = {
 	"depth-anything": {
 		category: "preprocess",
@@ -3766,8 +3751,7 @@ const STRUCTURE_TOOLS = {
 		task: "depth preprocessing"
 	}
 };
-//#endregion
-//#region src/tools.ts
+// src/tools.ts
 const FAL_TOOLS = {
 	...ANALYSIS_TOOLS,
 	...ASSET_TOOLS,
@@ -3795,8 +3779,7 @@ function buildFalToolRequest(options) {
 		tool
 	};
 }
-//#endregion
-//#region src/server-tools.ts
+// src/server-tools.ts
 /**
 * Tool execution bodies for `FalClient`, both synchronous and queued.
 *
@@ -3926,8 +3909,7 @@ async function runToolQueued(exec, options, onProgress) {
 	if (request.isErr()) return (0, neverthrow.err)(request.error);
 	return (await runRequestQueued(exec, request.value, onProgress)).map(({ data }) => data);
 }
-//#endregion
-//#region src/server.ts
+// src/server.ts
 const FAL_BASE_URL = "https://fal.run";
 const FAL_QUEUE_URL = "https://queue.fal.run";
 const FAL_API_URL = "https://api.fal.ai";
@@ -4244,8 +4226,7 @@ var FalClient = class {
 		});
 	}
 };
-//#endregion
-//#region src/source-size.ts
+// src/source-size.ts
 const DATA_URL_REGEX = /^data:[^;,]*;base64,(.*)$/s;
 function decodeBase64(data) {
 	try {
@@ -4343,8 +4324,7 @@ function dataUrlImageSize(url) {
 	const size = pngSize(bytes) ?? jpegSize(bytes) ?? webpSize(bytes);
 	return size !== void 0 && size.width > 0 && size.height > 0 ? size : void 0;
 }
-//#endregion
-//#region src/tool-cost.ts
+// src/tool-cost.ts
 /**
 * What a tool run costs, before it happens and after.
 *
@@ -4528,8 +4508,8 @@ function sumCosts(costs) {
 		unknown
 	};
 }
-//#endregion
-//#region src/image-benchmarks.ts
+// src/image-benchmarks.ts
+const MEASURED_ON_2_5 = "Measured on GPT Image 2.5. Motif runs GPT Image 2.6, which Arena has not scored yet.";
 const BOARDS = {
 	"text-to-image": {
 		sunburst: {
@@ -4537,6 +4517,7 @@ const BOARDS = {
 			rank: 1,
 			uncertainty: 5,
 			evaluatedModel: "GPT-Image-2.5 Sunburst",
+			note: MEASURED_ON_2_5,
 			preliminary: true,
 			votes: 40323
 		},
@@ -4545,6 +4526,7 @@ const BOARDS = {
 			rank: 2,
 			uncertainty: 5,
 			evaluatedModel: "GPT-Image-2.5 Flare",
+			note: MEASURED_ON_2_5,
 			preliminary: true,
 			votes: 39218
 		},
@@ -4634,6 +4616,7 @@ const BOARDS = {
 			rank: 1,
 			uncertainty: 5,
 			evaluatedModel: "GPT-Image-2.5 Sunburst",
+			note: MEASURED_ON_2_5,
 			preliminary: true
 		},
 		flare: {
@@ -4641,6 +4624,7 @@ const BOARDS = {
 			rank: 2,
 			uncertainty: 5,
 			evaluatedModel: "GPT-Image-2.5 Flare",
+			note: MEASURED_ON_2_5,
 			preliminary: true
 		},
 		"grok-image-2": {
@@ -4710,8 +4694,7 @@ function imageModelBenchmark(model, task) {
 		task
 	};
 }
-//#endregion
-//#region src/tasks.ts
+// src/tasks.ts
 /**
 * The Task registry: every job Motif does, with the Models that can do it
 * ranked best-first and tagged with the Tier each belongs to.
@@ -5588,8 +5571,7 @@ const TASK_IDS = Object.keys(TASKS).filter(isTaskId);
 function isTaskId(value) {
 	return Object.hasOwn(TASKS, value);
 }
-//#endregion
-//#region src/tool-parameters.generated.ts
+// src/tool-parameters.generated.ts
 const FAL_TOOL_PARAMETERS = {
 	"ben-v2": [{
 		key: "seed",
@@ -7746,8 +7728,7 @@ const FAL_TOOL_PARAMETERS = {
 function falToolParameters(tool) {
 	return FAL_TOOL_PARAMETERS[tool] ?? [];
 }
-//#endregion
-//#region src/resolve.ts
+// src/resolve.ts
 /**
 * Model choice: the one place a Model is chosen, for the CLI and the SDK.
 *
@@ -7782,6 +7763,7 @@ function generationProfile(config) {
 	if (config.supportsNegativePrompt === true) capabilities.add("negativePrompt");
 	if (config.supportsOutputFormat === true) capabilities.add("outputFormat");
 	return {
+		name: config.name,
 		aspects: config.supportedAspects,
 		capabilities,
 		keys: [FAL_KEY],
@@ -7815,6 +7797,7 @@ function toolProfile(tool) {
 	const takesReference = "referenceField" in config;
 	if (takesReference) capabilities.add("references");
 	return {
+		name: config.name,
 		capabilities,
 		keys: [FAL_KEY],
 		maxReferences: takesReference ? 1 : 0
@@ -8055,8 +8038,7 @@ function tierChangesChoice(task, request, environment) {
 	}
 	return chosen.size > 1;
 }
-//#endregion
-//#region src/task-output.ts
+// src/task-output.ts
 function isPlainRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -8181,8 +8163,7 @@ function labelUrls(urls, labels) {
 		return names !== void 0 && names.length === totals.get(key) ? names[occurrence] : void 0;
 	});
 }
-//#endregion
-//#region src/task-plan-pricing.ts
+// src/task-plan-pricing.ts
 /**
 * What a generation request bills and which body keys the caller owns. Both
 * read the body as sent, `params` included, because fal bills that body.
@@ -8261,8 +8242,7 @@ function checkParamsImageSize(config, model, task, params) {
 		task
 	});
 }
-//#endregion
-//#region src/task-plan-tools.ts
+// src/task-plan-tools.ts
 /**
 * Request bodies for fal tool Models: map each TaskInput field onto the key
 * the tool's generated parameter list names, refuse what it doesn't list, and
@@ -8611,8 +8591,7 @@ function toolPlan(task, model, input) {
 		queued: "queued" in tool
 	});
 }
-//#endregion
-//#region src/task-plan-video.ts
+// src/task-plan-video.ts
 /**
 * Request bodies for video Models: Kling v3 Pro and Kling v3 Turbo Pro, which
 * take the start frame under different keys and bill by the second.
@@ -8693,8 +8672,7 @@ function turboVideoPlan(task, endpoint, input) {
 		queued: true
 	});
 }
-//#endregion
-//#region src/task-plan.ts
+// src/task-plan.ts
 /**
 * `plan()` for the Task client: resolve the Model, build the request body the
 * Model's kind needs, and price it. Pure: no I/O.
@@ -8995,8 +8973,7 @@ function upscalerPlan(task, model, input) {
 		queued: false
 	});
 }
-//#endregion
-//#region src/task-stream.ts
+// src/task-stream.ts
 const MAX_EVENT_CHARACTERS = 16777216;
 const JSON_START = /^[[{]/;
 function parsePayload(text) {
@@ -9275,8 +9252,7 @@ function createFrames(requestId) {
 function enforceBufferLimit(length, requestId) {
 	if (length > MAX_EVENT_CHARACTERS) throw new MotifError("Stream event exceeds the buffer limit.", 0, "STREAM_EVENT_TOO_LARGE", requestId);
 }
-//#endregion
-//#region src/task-client.ts
+// src/task-client.ts
 /**
 * The Task client: one function per Task. `createMotif()` returns a client
 * whose `generate`, `erase`, `upscale` and the rest resolve the Model through
@@ -9452,7 +9428,6 @@ function createMotif(config = {}) {
 		}
 	};
 }
-//#endregion
 exports.ACCOUNT_LOCKED = ACCOUNT_LOCKED;
 exports.ASPECT_RATIOS = ASPECT_RATIOS;
 exports.CREATIVE_FIELDS = CREATIVE_FIELDS;