@jini-ai/integrations 0.1.0

package/dist/media-providers/task-store.js

@@ -0,0 +1,160 @@
+/**
+ * `MediaTaskStore` — the async task-tracking port for request-now,
+ * poll-later media generation. Generalized from OD's
+ * `apps/daemon/src/media/tasks.ts`, which is a `better-sqlite3`-coupled,
+ * synchronous CRUD module keyed on `projectId` (an OD domain noun) with a
+ * hardcoded SQL schema. Per extraction-plan.md §2.6 ("ports are async-only
+ * from day one") and the pattern already established by
+ * `@jini-ai/daemon`'s `EventLog` (see `packages/daemon/src/event-log.ts`), this
+ * is a from-scratch storage-agnostic port + in-memory reference
+ * implementation — not a lift — reproducing the same lifecycle semantics
+ * (queued → running → done|failed|interrupted, boot-time reconciliation of
+ * orphaned in-flight tasks, TTL-based terminal-task pruning) without a SQL
+ * schema or an OD project reference. A durable adapter (a future
+ * `@jini-ai/sqlite` addition) implements the same interface — see
+ * `source-map.md`.
+ */
+const VALID_STATUSES = new Set([
+    'queued',
+    'running',
+    'done',
+    'failed',
+    'interrupted',
+]);
+const TERMINAL_STATUSES = new Set(['done', 'failed', 'interrupted']);
+// CR-013: `assertValidStatus` alone only proves enum membership, not that a
+// transition is legal — it allowed e.g. `done` -> `running`. This is the
+// actual lifecycle graph the store's own docs claim
+// (queued -> running -> done|failed|interrupted); same-state is included so
+// a caller can `update()` progress/file without also having to re-derive the
+// current status, but nothing can leave a terminal state once reached.
+const ALLOWED_TRANSITIONS = {
+    // `queued` may go straight to a terminal state too (a caller isn't
+    // required to make a separate "now running" update before finishing).
+    queued: new Set(['queued', 'running', 'done', 'failed', 'interrupted']),
+    running: new Set(['running', 'done', 'failed', 'interrupted']),
+    done: new Set(['done']),
+    failed: new Set(['failed']),
+    interrupted: new Set(['interrupted']),
+};
+function cloneTask(task) {
+    return {
+        ...task,
+        progress: [...task.progress],
+        file: task.file == null ? null : structuredClone(task.file),
+        error: task.error == null ? null : { ...task.error },
+    };
+}
+const INTERRUPTED_ERROR = {
+    message: 'media task interrupted by daemon restart',
+    code: 'DAEMON_RESTART',
+};
+/** Creates the in-memory reference `MediaTaskStore`. No persistence — state is lost on process exit. */
+export function createInMemoryMediaTaskStore() {
+    const tasks = new Map();
+    return {
+        async create(input) {
+            if (tasks.has(input.id)) {
+                throw new Error(`media task "${input.id}" already exists`);
+            }
+            const status = input.status ?? 'queued';
+            assertValidStatus(status);
+            const now = Date.now();
+            const startedAt = input.startedAt ?? now;
+            const task = {
+                id: input.id,
+                ownerRef: input.ownerRef,
+                status,
+                progress: input.progress ? [...input.progress] : [],
+                file: input.file == null ? null : structuredClone(input.file),
+                error: input.error == null ? null : { ...input.error },
+                startedAt,
+                endedAt: null,
+                createdAt: now,
+                updatedAt: now,
+                ...(input.surface !== undefined ? { surface: input.surface } : {}),
+                ...(input.model !== undefined ? { model: input.model } : {}),
+            };
+            tasks.set(task.id, task);
+            return cloneTask(task);
+        },
+        async get(id) {
+            const task = tasks.get(id);
+            return task ? cloneTask(task) : null;
+        },
+        async update(id, patch) {
+            const existing = tasks.get(id);
+            if (!existing)
+                return null;
+            const status = patch.status ?? existing.status;
+            assertValidStatus(status);
+            // CR-013: enum membership alone doesn't prove the transition is legal
+            // (e.g. `done` -> `running`) — check the actual lifecycle graph too.
+            if (!ALLOWED_TRANSITIONS[existing.status].has(status)) {
+                throw new RangeError(`Invalid media task transition: "${existing.status}" -> "${status}"`);
+            }
+            const surface = 'surface' in patch ? (patch.surface ?? undefined) : existing.surface;
+            const model = 'model' in patch ? (patch.model ?? undefined) : existing.model;
+            const next = {
+                id: existing.id,
+                ownerRef: existing.ownerRef,
+                status,
+                progress: patch.progress ? [...patch.progress] : existing.progress,
+                file: 'file' in patch ? (patch.file == null ? null : structuredClone(patch.file)) : existing.file,
+                error: 'error' in patch ? (patch.error == null ? null : { ...patch.error }) : existing.error,
+                startedAt: existing.startedAt,
+                endedAt: 'endedAt' in patch ? (patch.endedAt ?? null) : existing.endedAt,
+                createdAt: existing.createdAt,
+                updatedAt: Date.now(),
+                ...(surface !== undefined ? { surface } : {}),
+                ...(model !== undefined ? { model } : {}),
+            };
+            tasks.set(id, next);
+            return cloneTask(next);
+        },
+        async listByOwner(ownerRef, options = {}) {
+            const includeTerminal = options.includeTerminal === true;
+            return [...tasks.values()]
+                .filter((t) => t.ownerRef === ownerRef)
+                .filter((t) => includeTerminal || !TERMINAL_STATUSES.has(t.status))
+                .sort((a, b) => b.startedAt - a.startedAt)
+                .map(cloneTask);
+        },
+        async delete(id) {
+            tasks.delete(id);
+        },
+        async reconcileOnBoot(options) {
+            if (!Number.isFinite(options.terminalTtlMs) || options.terminalTtlMs < 0) {
+                throw new RangeError(`Invalid terminalTtlMs: ${options.terminalTtlMs} must be a non-negative finite number`);
+            }
+            const now = options.now ?? Date.now();
+            const cutoff = now - options.terminalTtlMs;
+            let interrupted = 0;
+            let deleted = 0;
+            for (const task of [...tasks.values()]) {
+                if (task.status === 'queued' || task.status === 'running') {
+                    tasks.set(task.id, {
+                        ...task,
+                        status: 'interrupted',
+                        error: INTERRUPTED_ERROR,
+                        endedAt: task.endedAt ?? now,
+                        updatedAt: now,
+                    });
+                    interrupted += 1;
+                    continue;
+                }
+                if (TERMINAL_STATUSES.has(task.status) && (task.endedAt ?? task.updatedAt) < cutoff) {
+                    tasks.delete(task.id);
+                    deleted += 1;
+                }
+            }
+            return { interrupted, deleted };
+        },
+    };
+}
+function assertValidStatus(status) {
+    if (!VALID_STATUSES.has(status)) {
+        throw new RangeError(`Invalid media task status: "${status}"`);
+    }
+}
+//# sourceMappingURL=task-store.js.map

package/dist/media-providers/task-store.js.map

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

package/dist/media-providers/tokens.d.ts

@@ -0,0 +1,7 @@
+import type { CapabilityRegistry } from './capability-registry.js';
+import type { MediaPolicy } from './policy.js';
+import type { MediaTaskStore } from './task-store.js';
+export declare const CapabilityRegistryToken: import("@jini-ai/core").Token<CapabilityRegistry, string>;
+export declare const MediaTaskStoreToken: import("@jini-ai/core").Token<MediaTaskStore, string>;
+export declare const MediaPolicyToken: import("@jini-ai/core").Token<MediaPolicy, string>;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/media-providers/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/media-providers/tokens.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,eAAO,MAAM,uBAAuB,2DAA6D,CAAC;AAClG,eAAO,MAAM,mBAAmB,uDAAgD,CAAC;AACjF,eAAO,MAAM,gBAAgB,oDAA0C,CAAC"}

package/dist/media-providers/tokens.js

@@ -0,0 +1,13 @@
+/**
+ * Typed DI tokens for `@jini-ai/integrations/media-providers`'s ports, following the exact pattern
+ * `@jini-ai/core`'s `token()` establishes (see `packages/core/src/token.ts`)
+ * and the naming convention `@jini-ai/daemon`'s `src/tokens.ts` already set
+ * (bare-interface-name-suffixed-`Token`, not extraction-plan §2.2's
+ * illustrative bare-name pseudocode, which would shadow the interface names
+ * in this codebase's actual precedent).
+ */
+import { token } from '@jini-ai/core';
+export const CapabilityRegistryToken = token('jini.media.capabilityRegistry');
+export const MediaTaskStoreToken = token('jini.media.taskStore');
+export const MediaPolicyToken = token('jini.media.policy');
+//# sourceMappingURL=tokens.js.map

package/dist/media-providers/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/media-providers/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAKtC,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAqB,+BAA+B,CAAC,CAAC;AAClG,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAiB,sBAAsB,CAAC,CAAC;AACjF,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAc,mBAAmB,CAAC,CAAC"}

package/dist/media-providers/types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * `@jini-ai/integrations/media-providers` core type system — the provider/model catalogue shape and the
+ * pure, transport-free request-building types layered on top of it.
+ *
+ * Ported from OD's `apps/daemon/src/media/models.ts` (catalogue
+ * shape) and `apps/daemon/src/media-adapters/types.ts` (capability +
+ * request-builder shape) — see `source-map.md` for the full provenance.
+ * Neither origin file carries any OD domain noun; this is a product-neutral
+ * multi-vendor media-generation type system, not an OD concept.
+ */
+/** The three kinds of media this package's catalogue covers. */
+export type MediaSurface = 'image' | 'video' | 'audio';
+/** Sub-kind of `'audio'` — audio generation splits into three distinct model families. */
+export type AudioKind = 'music' | 'speech' | 'sfx';
+/**
+ * A third-party media-generation vendor (e.g. OpenAI, Fal.ai, ElevenLabs).
+ * Reference/catalogue data, not a live connection — a host resolves
+ * `credentialsRequired`/`defaultBaseUrl` into its own credential storage.
+ */
+export interface MediaProvider {
+    readonly id: string;
+    readonly label: string;
+    readonly hint: string;
+    /** Whether this package ships a working request-shape for this provider (vs. a planned/future entry). */
+    readonly integrated: boolean;
+    readonly defaultBaseUrl?: string;
+    readonly docsUrl?: string;
+    readonly credentialsRequired?: boolean;
+    readonly settingsVisible?: boolean;
+    readonly supportsCustomModel?: boolean;
+    readonly customModelPlaceholder?: string;
+}
+/** A specific generation model offered by a `MediaProvider`. */
+export interface MediaModel {
+    readonly id: string;
+    readonly label: string;
+    readonly hint: string;
+    readonly provider: string;
+    /** Capability tags, e.g. `t2i`/`i2i`/`inpaint`/`t2v`/`i2v`/`tts`. Open-ended by design — see `source-map.md`. */
+    readonly caps: readonly string[];
+    readonly default?: boolean;
+}
+/**
+ * Request-shape family, keyed off the resolved upstream model name. Each
+ * family is a distinct wire shape a real vendor gateway expects — see
+ * `video-request.ts` for the branching logic and `source-map.md` for the
+ * vendor-verification notes this was ported with.
+ */
+export type MediaFamily = 'seedance' | 'wan' | 'veo' | 'generic';
+export type MediaType = 'video' | 'image' | 'audio';
+/** A vendor-specific parameter a caller may pass through, with an optional default. */
+export interface ExtraBodyParamDef {
+    readonly name: string;
+    readonly type: 'string' | 'number' | 'boolean';
+    readonly default?: string | number | boolean;
+    readonly description?: string;
+}
+/**
+ * Per-model capability description — the data a `CapabilityRegistry` holds.
+ * Field names deliberately align with OpenRouter's `GET /api/v1/videos/models`
+ * shape so a future remote-fetched catalogue is a data-source swap, not a
+ * reshape (see `source-map.md`).
+ */
+export interface ModelCapability {
+    /** Catalogue id (vendor-aggregator prefixes stripped — see `normalizeModelId`). */
+    readonly id: string;
+    /** Upstream model name for text-to-X / base generation. */
+    readonly apiModel: string;
+    /** Upstream model name used when a reference image is present (image-to-X). */
+    readonly apiModelI2V?: string;
+    readonly mediaType: MediaType;
+    readonly caps: readonly string[];
+    /** Explicit family override; when omitted the family is derived from the wire model name — see `deriveVideoFamily`. */
+    readonly family?: MediaFamily;
+    readonly baseUrl?: string;
+    readonly supportedDurations?: readonly number[];
+    readonly supportedSizes?: readonly string[];
+    readonly supportedAspectRatios?: readonly string[];
+    readonly supportedResolutions?: readonly string[];
+    /** Reference-frame roles the model accepts, e.g. `['first_frame']`. Empty/absent means no image-to-X support. */
+    readonly supportedFrameImages?: readonly string[];
+    readonly generateAudio?: boolean;
+    readonly seed?: boolean;
+    readonly allowedPassthroughParameters?: readonly string[];
+    readonly extraBodyDefaults?: readonly ExtraBodyParamDef[];
+}
+/**
+ * Unified video-generation request input. The caller resolves any reference
+ * image to a data URL before calling — this package performs no I/O.
+ */
+export interface VideoBuildInput {
+    readonly prompt: string;
+    readonly durationSeconds?: number;
+    readonly aspectRatio?: string;
+    readonly size?: string;
+    readonly resolution?: string;
+    readonly imageRef?: {
+        readonly dataUrl: string;
+    };
+    readonly extraImageRefs?: readonly {
+        readonly dataUrl: string;
+    }[];
+    readonly generateAudio?: boolean;
+    readonly seed?: number;
+    readonly passthrough?: Readonly<Record<string, unknown>>;
+}
+/** Result of `buildVideoRequest` — transport-free; the caller attaches auth + base URL and performs the fetch. */
+export interface BuiltVideoRequest {
+    readonly wireModel: string;
+    readonly family: MediaFamily;
+    readonly pathSuffix: string;
+    readonly contentType: string;
+    readonly body: Record<string, unknown>;
+    readonly hasReference: boolean;
+}
+/** Best-effort normalized shape of an async-submit / poll response across vendor families. */
+export interface NormalizedVideoResponse {
+    readonly id?: string;
+    readonly status?: string;
+    readonly url?: string;
+    readonly error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/media-providers/types.d.ts.map

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

package/dist/media-providers/types.js

@@ -0,0 +1,12 @@
+/**
+ * `@jini-ai/integrations/media-providers` core type system — the provider/model catalogue shape and the
+ * pure, transport-free request-building types layered on top of it.
+ *
+ * Ported from OD's `apps/daemon/src/media/models.ts` (catalogue
+ * shape) and `apps/daemon/src/media-adapters/types.ts` (capability +
+ * request-builder shape) — see `source-map.md` for the full provenance.
+ * Neither origin file carries any OD domain noun; this is a product-neutral
+ * multi-vendor media-generation type system, not an OD concept.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/media-providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/media-providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/media-providers/video-request.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Video request builder — pure, transport-free. Ported verbatim from Open
+ * Design's `apps/daemon/src/media-adapters/video.ts` (layer ②: family
+ * branching on top of the `CapabilityRegistry`'s `ModelCapability` data).
+ * No fetch, no auth, no OD nouns — the caller resolves any reference image
+ * to a data URL beforehand and attaches auth + base URL afterward; this
+ * module only shapes the request body per vendor wire family:
+ *
+ *   • `seedance` (ByteDance Ark) — multimodal `content[]` array (text +
+ *     image_url{url,role:first_frame}); duration/ratio/resolution fields.
+ *   • `wan` (Alibaba DashScope/wanx-backed) —
+ *     `{ input:{ prompt, media[] }, parameters:{ resolution, duration, ... } }`.
+ *   • `veo` (Google Veo via a Gemini predictLongRunning shim) — flat JSON;
+ *     `seconds` MUST be a number and the only size hint is `size`.
+ *   • `generic` (Sora and similar) — flat JSON with `seconds` as a string.
+ *
+ * See `source-map.md` for the vendor-verification notes each snapping
+ * function was ported with — they encode real, tested API quirks, not
+ * arbitrary defaults.
+ */
+import type { BuiltVideoRequest, MediaFamily, ModelCapability, NormalizedVideoResponse, VideoBuildInput } from './types.js';
+/** Resolves the upstream model name: the i2v variant when a reference image is present. */
+export declare function resolveWireModel(cap: ModelCapability, hasReference: boolean): string;
+/** Derives the request family from the resolved upstream model name (or an explicit `cap.family` override). */
+export declare function deriveVideoFamily(wireModel: string, cap?: ModelCapability): MediaFamily;
+/**
+ * Snaps a requested duration to the model's allowed set (e.g. Veo 4/6/8, wan
+ * 5/10). Falls back to a 3-12 clamp when the model declares no constraint.
+ * Ties prefer the shorter value (array order wins on an exact tie distance).
+ */
+export declare function snapDuration(cap: ModelCapability, requested: number | undefined): number;
+/**
+ * Seedance and wan accept resolution only as a quality token
+ * (`480p`/`720p`/`1080p`), never a `WxH` pixel string. Normalizes whichever
+ * the caller supplied to the nearest lowercase token by short side
+ * (720→720p, 1080→1080p, ...); defaults to `720p` when nothing usable is
+ * supplied. (The `wan` family upper-cases the result itself.)
+ */
+export declare function snapResolutionToken(resolution: string | undefined, size: string | undefined): string;
+/**
+ * Veo (via the verified gateway's Gemini predictLongRunning shim) only
+ * accepts a handful of `size` values — anything mapping outside 720p/1080p
+ * (e.g. a 1:1 `1024x1024`) 400s. Snaps to the nearest valid Veo size by
+ * orientation; defaults to landscape 720p.
+ */
+export declare function snapVeoSize(size: string | undefined): string;
+/**
+ * Snaps a requested `size` to the model's declared `supportedSizes` by
+ * orientation (portrait matches portrait, else landscape). Returns the size
+ * unchanged when the model declares no constraint; falls back to the first
+ * supported size when the input is missing/unparseable.
+ */
+export declare function snapSizeToSupported(size: string | undefined, supported: readonly string[] | undefined): string | undefined;
+/**
+ * Builds the upstream video request body for a model. Pure: no fetch, no
+ * auth. Caller: `POST \`${baseUrl}${pathSuffix}\`` with auth headers +
+ * `JSON.stringify(body)`.
+ */
+export declare function buildVideoRequest(cap: ModelCapability, input: VideoBuildInput): BuiltVideoRequest;
+/** Best-effort normalization of an async-submit / poll response across vendor families. */
+export declare function normalizeVideoResponse(raw: unknown): NormalizedVideoResponse;
+//# sourceMappingURL=video-request.d.ts.map

package/dist/media-providers/video-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-request.d.ts","sourceRoot":"","sources":["../../src/media-providers/video-request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE5H,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,CAEpF;AAED,+GAA+G;AAC/G,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,eAAe,GAAG,WAAW,CAOvF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAOxF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAWpG;AAID;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAM5D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAa1H;AA6BD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,GAAG,iBAAiB,CA0DjG;AAED,2FAA2F;AAC3F,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,uBAAuB,CAuB5E"}

package/dist/media-providers/video-request.js

@@ -0,0 +1,219 @@
+/** Resolves the upstream model name: the i2v variant when a reference image is present. */
+export function resolveWireModel(cap, hasReference) {
+    return hasReference && cap.apiModelI2V ? cap.apiModelI2V : cap.apiModel;
+}
+/** Derives the request family from the resolved upstream model name (or an explicit `cap.family` override). */
+export function deriveVideoFamily(wireModel, cap) {
+    if (cap?.family)
+        return cap.family;
+    const m = wireModel.toLowerCase();
+    if (m.startsWith('doubao-seedance-'))
+        return 'seedance';
+    if (m.startsWith('wan') || m.startsWith('happyhorse'))
+        return 'wan';
+    if (m.startsWith('veo'))
+        return 'veo';
+    return 'generic';
+}
+/**
+ * Snaps a requested duration to the model's allowed set (e.g. Veo 4/6/8, wan
+ * 5/10). Falls back to a 3-12 clamp when the model declares no constraint.
+ * Ties prefer the shorter value (array order wins on an exact tie distance).
+ */
+export function snapDuration(cap, requested) {
+    const req = Number.isFinite(requested) ? requested : 5;
+    const allowed = cap.supportedDurations;
+    if (!allowed || allowed.length === 0) {
+        return Math.min(12, Math.max(3, Math.round(req)));
+    }
+    return allowed.reduce((best, v) => (Math.abs(v - req) < Math.abs(best - req) ? v : best), allowed[0]);
+}
+/**
+ * Seedance and wan accept resolution only as a quality token
+ * (`480p`/`720p`/`1080p`), never a `WxH` pixel string. Normalizes whichever
+ * the caller supplied to the nearest lowercase token by short side
+ * (720→720p, 1080→1080p, ...); defaults to `720p` when nothing usable is
+ * supplied. (The `wan` family upper-cases the result itself.)
+ */
+export function snapResolutionToken(resolution, size) {
+    const token = (resolution || '').trim().toLowerCase();
+    if (/^(480|720|1080)p$/.test(token))
+        return token;
+    const m = /^(\d+)\s*[x×]\s*(\d+)$/i.exec((size || resolution || '').trim());
+    if (m) {
+        const shortSide = Math.min(parseInt(m[1], 10), parseInt(m[2], 10));
+        if (shortSide <= 480)
+            return '480p';
+        if (shortSide <= 720)
+            return '720p';
+        return '1080p';
+    }
+    return '720p';
+}
+const VEO_VALID_SIZES = new Set(['1280x720', '720x1280', '1920x1080', '1080x1920']);
+/**
+ * Veo (via the verified gateway's Gemini predictLongRunning shim) only
+ * accepts a handful of `size` values — anything mapping outside 720p/1080p
+ * (e.g. a 1:1 `1024x1024`) 400s. Snaps to the nearest valid Veo size by
+ * orientation; defaults to landscape 720p.
+ */
+export function snapVeoSize(size) {
+    const s = (size || '').trim().toLowerCase().replace('×', 'x');
+    if (VEO_VALID_SIZES.has(s))
+        return s;
+    const m = /^(\d+)\s*x\s*(\d+)$/.exec(s);
+    if (m)
+        return parseInt(m[2], 10) > parseInt(m[1], 10) ? '720x1280' : '1280x720';
+    return '1280x720';
+}
+/**
+ * Snaps a requested `size` to the model's declared `supportedSizes` by
+ * orientation (portrait matches portrait, else landscape). Returns the size
+ * unchanged when the model declares no constraint; falls back to the first
+ * supported size when the input is missing/unparseable.
+ */
+export function snapSizeToSupported(size, supported) {
+    if (!supported || supported.length === 0)
+        return size;
+    const norm = (v) => v.trim().toLowerCase().replace('×', 'x');
+    const s = norm(size || '');
+    const exact = supported.find((v) => norm(v) === s);
+    if (exact)
+        return exact;
+    const dims = /^(\d+)\s*x\s*(\d+)$/.exec(s);
+    const portrait = dims ? parseInt(dims[2], 10) > parseInt(dims[1], 10) : false;
+    const match = supported.find((v) => {
+        const vm = /^(\d+)\s*x\s*(\d+)$/.exec(norm(v));
+        return vm ? parseInt(vm[2], 10) > parseInt(vm[1], 10) === portrait : false;
+    });
+    return match || supported[0];
+}
+/** Applies `extraBodyDefaults`, then overlays caller passthrough filtered by `allowedPassthroughParameters`. */
+function mergeExtraBody(body, cap, passthrough) {
+    for (const def of cap.extraBodyDefaults ?? []) {
+        if (def.default !== undefined)
+            body[def.name] = def.default;
+    }
+    if (passthrough && cap.allowedPassthroughParameters?.length) {
+        const allow = new Set(cap.allowedPassthroughParameters);
+        for (const [k, v] of Object.entries(passthrough)) {
+            if (allow.has(k) && v !== undefined)
+                body[k] = v;
+        }
+    }
+}
+/** Builds the seedance multimodal content array (text + reference images). */
+function buildSeedanceContent(input) {
+    const content = [{ type: 'text', text: input.prompt }];
+    if (input.imageRef?.dataUrl) {
+        content.push({ type: 'image_url', image_url: { url: input.imageRef.dataUrl }, role: 'first_frame' });
+    }
+    for (const ref of input.extraImageRefs ?? []) {
+        if (ref?.dataUrl) {
+            content.push({ type: 'image_url', image_url: { url: ref.dataUrl }, role: 'reference_image' });
+        }
+    }
+    return content;
+}
+/**
+ * Builds the upstream video request body for a model. Pure: no fetch, no
+ * auth. Caller: `POST \`${baseUrl}${pathSuffix}\`` with auth headers +
+ * `JSON.stringify(body)`.
+ */
+export function buildVideoRequest(cap, input) {
+    const hasReference = Boolean(input.imageRef?.dataUrl);
+    const wireModel = resolveWireModel(cap, hasReference);
+    const family = deriveVideoFamily(wireModel, cap);
+    const seconds = snapDuration(cap, input.durationSeconds);
+    let body;
+    if (family === 'seedance') {
+        body = {
+            model: wireModel,
+            prompt: input.prompt,
+            duration: seconds,
+            content: buildSeedanceContent(input),
+            resolution: snapResolutionToken(input.resolution, input.size),
+        };
+        if (input.aspectRatio)
+            body.ratio = input.aspectRatio;
+        if (typeof input.generateAudio === 'boolean')
+            body.generate_audio = input.generateAudio;
+        if (typeof input.seed === 'number')
+            body.seed = input.seed;
+    }
+    else if (family === 'wan') {
+        const wanInput = { prompt: input.prompt };
+        if (hasReference) {
+            wanInput.media = [{ type: 'first_frame', url: input.imageRef.dataUrl }];
+        }
+        const parameters = {
+            resolution: snapResolutionToken(input.resolution, input.size).toUpperCase(),
+            duration: seconds,
+            prompt_extend: true,
+            watermark: false,
+        };
+        if (input.aspectRatio)
+            parameters.aspect_ratio = input.aspectRatio;
+        if (typeof input.seed === 'number')
+            parameters.seed = input.seed;
+        body = { model: wireModel, input: wanInput, parameters };
+    }
+    else if (family === 'veo') {
+        body = {
+            model: wireModel,
+            prompt: input.prompt,
+            seconds,
+            size: snapVeoSize(input.size),
+        };
+        if (typeof input.generateAudio === 'boolean')
+            body.generate_audio = input.generateAudio;
+        if (typeof input.seed === 'number')
+            body.seed = input.seed;
+    }
+    else {
+        body = {
+            model: wireModel,
+            prompt: input.prompt,
+            seconds: String(seconds),
+        };
+        const genericSize = snapSizeToSupported(input.size, cap.supportedSizes);
+        if (genericSize)
+            body.size = genericSize;
+        if (input.resolution)
+            body.resolution = input.resolution;
+        if (hasReference)
+            body.input_reference = input.imageRef.dataUrl;
+        if (typeof input.generateAudio === 'boolean')
+            body.generate_audio = input.generateAudio;
+        if (typeof input.seed === 'number')
+            body.seed = input.seed;
+    }
+    mergeExtraBody(body, cap, input.passthrough);
+    return { wireModel, family, pathSuffix: '/videos', contentType: 'application/json', body, hasReference };
+}
+/** Best-effort normalization of an async-submit / poll response across vendor families. */
+export function normalizeVideoResponse(raw) {
+    const d = (raw ?? {});
+    const data = d.data;
+    const dataArray = Array.isArray(d.data) ? d.data : undefined;
+    const unsignedUrls = Array.isArray(d.unsigned_urls) ? d.unsigned_urls : undefined;
+    const id = d.id ?? d.task_id ?? data?.id ?? data?.task_id;
+    const status = d.status ?? data?.status;
+    const url = d.video_url ?? d.url ?? d.output_url ?? data?.video_url ?? data?.url ?? dataArray?.[0]?.url ?? unsignedUrls?.[0];
+    const errorObj = d.error;
+    const error = (typeof errorObj === 'object' && errorObj ? errorObj.message : undefined) ??
+        (typeof errorObj === 'string' ? errorObj : undefined) ??
+        d.failure_reason ??
+        d.message;
+    const result = {};
+    if (id !== undefined && id !== null)
+        result.id = String(id);
+    if (status !== undefined && status !== null)
+        result.status = String(status);
+    if (url !== undefined && url !== null)
+        result.url = String(url);
+    if (error !== undefined && error !== null)
+        result.error = String(error);
+    return result;
+}
+//# sourceMappingURL=video-request.js.map