egaki 0.5.0 → 0.6.0

package/dist/model-catalog.js

@@ -1,10 +1,26 @@
-// Single source of truth for all image generation models.
+// Single source of truth for all image and video generation models.
 // Every model's provider, pricing, features, and generation strategy lives here.
 // Other modules derive their data from this catalog — no separate registries.
 //
 // To add a model: add an entry to CATALOG with the right shared fragment spread.
 // To update pricing: change the cost field on the model entry.
 // To add a provider: create a new shared fragment and add models using it.
+//
+// Provider option schemas are sourced from the @ai-sdk/* packages and upstream API docs.
+// Each shared fragment has a URL comment pointing to the source of truth so options
+// are easy to verify and update when providers change their APIs.
+//
+// Sources:
+//   xAI image:  node_modules/@ai-sdk/xai/dist/index.d.ts → xaiImageModelOptions
+//               https://docs.x.ai/docs/api-reference#create-image
+//   xAI video:  node_modules/@ai-sdk/xai/dist/index.d.ts → XaiVideoModelOptions
+//               https://docs.x.ai/docs/api-reference#create-video
+//   OpenAI:     node_modules/@ai-sdk/openai/dist/index.d.ts → imageGeneration args
+//               https://platform.openai.com/docs/api-reference/images
+//   Fal image:  https://ai-sdk.dev/providers/ai-sdk-providers/fal
+//               node_modules/@ai-sdk/fal/dist/index.d.ts → FalImageModelOptions
+//   Fal video:  node_modules/@ai-sdk/fal/dist/index.d.ts → FalVideoModelOptions
+//               https://ai-sdk.dev/providers/ai-sdk-providers/fal
 // ─── shared fragments ────────────────────────────────────────────────────────
 // Spread these into model entries to avoid repeating common fields.
 const googleImagen = {
@@ -29,17 +45,31 @@ const googleText = {
         multipleImages: false,
     },
 };
+// Source: node_modules/@ai-sdk/openai/dist/index.d.ts → imageGeneration args
+// Docs:   https://platform.openai.com/docs/api-reference/images/create
+const openaiImageProviderOptions = [
+    { flag: 'quality', providerKey: 'quality', description: 'Image quality', values: ['auto', 'low', 'medium', 'high'], defaultValue: 'auto', type: 'string' },
+    { flag: 'output-format', providerKey: 'outputFormat', description: 'Output format', values: ['png', 'jpeg', 'webp'], defaultValue: 'png', type: 'string' },
+];
 const openaiImage = {
     provider: 'openai',
     strategy: 'image',
+    providerOptions: openaiImageProviderOptions,
 };
 const replicateImage = {
     provider: 'replicate',
     strategy: 'image',
 };
+// Source: node_modules/@ai-sdk/fal/dist/index.d.ts → FalImageModelOptions (lazy passthrough)
+// Docs:   https://ai-sdk.dev/providers/ai-sdk-providers/fal#provider-options
+const falImageProviderOptions = [
+    { flag: 'output-format', providerKey: 'outputFormat', description: 'Output format', values: ['png', 'jpeg'], type: 'string' },
+    { flag: 'negative-prompt', providerKey: 'negativePrompt', description: 'What to avoid in the image', type: 'string' },
+];
 const falImage = {
     provider: 'fal',
     strategy: 'image',
+    providerOptions: falImageProviderOptions,
 };
 const bflImage = {
     provider: 'bfl',
@@ -49,10 +79,33 @@ const recraftImage = {
     provider: 'recraft',
     strategy: 'image',
 };
+// Source: node_modules/@ai-sdk/xai/dist/index.d.ts → xaiImageModelOptions
+// Docs:   https://docs.x.ai/docs/api-reference#create-image
+const xaiImageProviderOptions = [
+    { flag: 'quality', providerKey: 'quality', description: 'Image quality', values: ['low', 'medium', 'high'], defaultValue: 'medium', type: 'string' },
+    { flag: 'resolution', providerKey: 'resolution', description: 'Output resolution', values: ['1k', '2k'], defaultValue: '1k', type: 'string' },
+    { flag: 'output-format', providerKey: 'output_format', description: 'Output format', values: ['png', 'jpeg'], defaultValue: 'png', type: 'string' },
+];
 const xaiImage = {
     provider: 'xai',
     strategy: 'image',
+    providerOptions: xaiImageProviderOptions,
 };
+// Source: node_modules/@ai-sdk/xai/dist/index.d.ts → XaiVideoModelOptions
+// Docs:   https://docs.x.ai/docs/api-reference#create-video
+const xaiVideoProviderOptions = [
+    { flag: 'resolution', providerKey: 'resolution', description: 'Output resolution', values: ['480p', '720p'], defaultValue: '720p', type: 'string' },
+    { flag: 'mode', providerKey: 'mode', description: 'Video operation mode', values: ['edit-video', 'extend-video', 'reference-to-video'], type: 'string' },
+    // video-url is not a CLI flag; it's set internally from --input in edit/extend modes.
+    // Kept here so findProviderOption() can verify the model supports it and resolve the correct providerKey.
+    { flag: 'video-url', providerKey: 'videoUrl', description: 'Source video URL for editing or extension (internal)', type: 'string' },
+    { flag: 'reference-images', providerKey: 'referenceImageUrls', description: 'Reference images for R2V (1-7 files or URLs)', type: 'string', array: true },
+];
+// Source: node_modules/@ai-sdk/fal/dist/index.d.ts → FalVideoModelOptions
+// Docs:   https://ai-sdk.dev/providers/ai-sdk-providers/fal
+const falVideoProviderOptions = [
+    { flag: 'negative-prompt', providerKey: 'negativePrompt', description: 'What to avoid in the video', type: 'string' },
+];
 const vertexImagen = {
     provider: 'vertex',
     strategy: 'image',
@@ -994,8 +1047,379 @@ export const CATALOG = [
         },
     },
 ];
+// ─── video catalog ───────────────────────────────────────────────────────────
+const commonVideoRatios = ['16:9', '9:16', '1:1', '4:3', '3:4'];
+export const VIDEO_CATALOG = [
+    {
+        id: 'veo-3.1-generate-001',
+        name: 'Veo 3.1',
+        provider: 'google',
+        strategy: 'video',
+        released: '2026-01',
+        cost: {
+            type: 'per-video-second',
+            defaultDurationSec: 8,
+            tiers: [
+                { resolution: '720p', audio: false, costPerSecond: 0.2 },
+                { resolution: '720p', audio: true, costPerSecond: 0.4 },
+                { resolution: '1080p', audio: false, costPerSecond: 0.2 },
+                { resolution: '1080p', audio: true, costPerSecond: 0.4 },
+                { resolution: '4k', audio: false, costPerSecond: 0.4 },
+                { resolution: '4k', audio: true, costPerSecond: 0.6 },
+            ],
+        },
+        features: {
+            textToVideo: true,
+            imageToVideo: false,
+            capabilities: ['t2v'],
+            aspectRatios: ['16:9', '9:16'],
+            resolutions: ['720p', '1080p', '4k'],
+            durationRangeSec: { min: 4, max: 8 },
+            seed: true,
+            multipleVideos: true,
+        },
+    },
+    {
+        id: 'veo-3.1-fast-generate-001',
+        name: 'Veo 3.1 Fast',
+        provider: 'google',
+        strategy: 'video',
+        released: '2026-01',
+        cost: {
+            type: 'per-video-second',
+            defaultDurationSec: 8,
+            tiers: [
+                { resolution: '720p', audio: false, costPerSecond: 0.1 },
+                { resolution: '720p', audio: true, costPerSecond: 0.15 },
+                { resolution: '1080p', audio: false, costPerSecond: 0.1 },
+                { resolution: '1080p', audio: true, costPerSecond: 0.15 },
+                { resolution: '4k', audio: false, costPerSecond: 0.3 },
+                { resolution: '4k', audio: true, costPerSecond: 0.35 },
+            ],
+        },
+        features: {
+            textToVideo: true,
+            imageToVideo: false,
+            capabilities: ['t2v'],
+            aspectRatios: ['16:9', '9:16'],
+            resolutions: ['720p', '1080p', '4k'],
+            durationRangeSec: { min: 4, max: 8 },
+            seed: true,
+            multipleVideos: true,
+        },
+    },
+    {
+        id: 'veo-3.0-generate-001',
+        name: 'Veo 3.0',
+        provider: 'google',
+        strategy: 'video',
+        released: '2025-12',
+        cost: {
+            type: 'per-video-second',
+            defaultDurationSec: 8,
+            tiers: [
+                { resolution: '720p', audio: false, costPerSecond: 0.2 },
+                { resolution: '720p', audio: true, costPerSecond: 0.4 },
+                { resolution: '1080p', audio: false, costPerSecond: 0.2 },
+                { resolution: '1080p', audio: true, costPerSecond: 0.4 },
+            ],
+        },
+        features: {
+            textToVideo: true,
+            imageToVideo: false,
+            capabilities: ['t2v'],
+            aspectRatios: ['16:9', '9:16'],
+            resolutions: ['720p', '1080p'],
+            durationRangeSec: { min: 4, max: 8 },
+            seed: true,
+            multipleVideos: true,
+        },
+    },
+    {
+        id: 'veo-3.0-fast-generate-001',
+        name: 'Veo 3.0 Fast',
+        provider: 'google',
+        strategy: 'video',
+        released: '2025-12',
+        cost: {
+            type: 'per-video-second',
+            defaultDurationSec: 8,
+            tiers: [
+                { resolution: '720p', audio: false, costPerSecond: 0.1 },
+                { resolution: '720p', audio: true, costPerSecond: 0.15 },
+                { resolution: '1080p', audio: false, costPerSecond: 0.1 },
+                { resolution: '1080p', audio: true, costPerSecond: 0.15 },
+            ],
+        },
+        features: {
+            textToVideo: true,
+            imageToVideo: false,
+            capabilities: ['t2v'],
+            aspectRatios: ['16:9', '9:16'],
+            resolutions: ['720p', '1080p'],
+            durationRangeSec: { min: 4, max: 8 },
+            seed: true,
+            multipleVideos: true,
+        },
+    },
+    // ── Vertex: Veo ──────────────────────────────────────────────────────
+    {
+        id: 'vertex/veo-3.1-generate-001',
+        name: 'Veo 3.1 (Vertex)',
+        provider: 'vertex',
+        strategy: 'video',
+        released: '2026-01',
+        cost: {
+            type: 'per-video-second',
+            defaultDurationSec: 8,
+            tiers: [
+                { resolution: '720p', audio: false, costPerSecond: 0.2 },
+                { resolution: '720p', audio: true, costPerSecond: 0.4 },
+                { resolution: '1080p', audio: false, costPerSecond: 0.2 },
+                { resolution: '1080p', audio: true, costPerSecond: 0.4 },
+                { resolution: '4k', audio: false, costPerSecond: 0.4 },
+                { resolution: '4k', audio: true, costPerSecond: 0.6 },
+            ],
+        },
+        features: {
+            textToVideo: true,
+            imageToVideo: false,
+            capabilities: ['t2v'],
+            aspectRatios: ['16:9', '9:16'],
+            resolutions: ['720p', '1080p', '4k'],
+            durationRangeSec: { min: 4, max: 8 },
+            seed: true,
+            multipleVideos: true,
+        },
+    },
+    {
+        id: 'vertex/veo-3.1-fast-generate-001',
+        name: 'Veo 3.1 Fast (Vertex)',
+        provider: 'vertex',
+        strategy: 'video',
+        released: '2026-01',
+        cost: {
+            type: 'per-video-second',
+            defaultDurationSec: 8,
+            tiers: [
+                { resolution: '720p', audio: false, costPerSecond: 0.1 },
+                { resolution: '720p', audio: true, costPerSecond: 0.15 },
+                { resolution: '1080p', audio: false, costPerSecond: 0.1 },
+                { resolution: '1080p', audio: true, costPerSecond: 0.15 },
+                { resolution: '4k', audio: false, costPerSecond: 0.3 },
+                { resolution: '4k', audio: true, costPerSecond: 0.35 },
+            ],
+        },
+        features: {
+            textToVideo: true,
+            imageToVideo: false,
+            capabilities: ['t2v'],
+            aspectRatios: ['16:9', '9:16'],
+            resolutions: ['720p', '1080p', '4k'],
+            durationRangeSec: { min: 4, max: 8 },
+            seed: true,
+            multipleVideos: true,
+        },
+    },
+    {
+        id: 'grok-imagine-video',
+        name: 'Grok Imagine Video',
+        provider: 'xai',
+        strategy: 'video',
+        released: '2026-03',
+        cost: {
+            type: 'per-video-second',
+            defaultDurationSec: 5,
+            tiers: [
+                { resolution: '480p', costPerSecond: 0.05 },
+                { resolution: '720p', costPerSecond: 0.07 },
+            ],
+        },
+        features: {
+            textToVideo: true,
+            imageToVideo: true,
+            capabilities: ['t2v', 'i2v', 'editing', 'extension', 'r2v'],
+            aspectRatios: ['1:1', '16:9', '9:16', '4:3', '3:4', '3:2', '2:3'],
+            resolutions: ['480p', '720p'],
+            durationRangeSec: { min: 1, max: 15 },
+            seed: false,
+            multipleVideos: false,
+        },
+        providerOptions: xaiVideoProviderOptions,
+    },
+    {
+        id: 'kling-v2.6-t2v',
+        name: 'Kling v2.6 T2V',
+        provider: 'klingai',
+        strategy: 'video',
+        released: '2025-12',
+        cost: {
+            type: 'per-video-second',
+            defaultDurationSec: 5,
+            tiers: [
+                { mode: 'std', costPerSecond: 0.042 },
+                { mode: 'pro', audio: false, costPerSecond: 0.07 },
+                { mode: 'pro', audio: true, costPerSecond: 0.14 },
+            ],
+        },
+        features: {
+            textToVideo: true,
+            imageToVideo: false,
+            capabilities: ['t2v'],
+            aspectRatios: commonVideoRatios,
+            durationRangeSec: { min: 5, max: 10 },
+            seed: false,
+            multipleVideos: false,
+        },
+    },
+    {
+        id: 'wan-v2.6-t2v',
+        name: 'Wan v2.6 T2V',
+        provider: 'alibaba',
+        strategy: 'video',
+        released: '2026-01',
+        cost: {
+            type: 'per-video-second',
+            defaultDurationSec: 5,
+            tiers: [
+                { resolution: '720p', costPerSecond: 0.1 },
+                { resolution: '1080p', costPerSecond: 0.15 },
+            ],
+        },
+        features: {
+            textToVideo: true,
+            imageToVideo: false,
+            capabilities: ['t2v'],
+            resolutions: ['720p', '1080p'],
+            durationRangeSec: { min: 2, max: 15 },
+            seed: false,
+            multipleVideos: false,
+        },
+    },
+    // ── Fal video models ─────────────────────────────────────────────────
+    {
+        id: 'luma-ray-2',
+        name: 'Luma Ray 2 (Fal)',
+        provider: 'fal',
+        strategy: 'video',
+        released: '2025-11',
+        cost: { type: 'unknown' },
+        features: {
+            textToVideo: true,
+            imageToVideo: true,
+            capabilities: ['t2v', 'i2v'],
+            aspectRatios: commonVideoRatios,
+            seed: true,
+            multipleVideos: false,
+        },
+        providerOptions: falVideoProviderOptions,
+    },
+    {
+        id: 'minimax-video',
+        name: 'MiniMax Video (Fal)',
+        provider: 'fal',
+        strategy: 'video',
+        released: '2025-10',
+        cost: { type: 'unknown' },
+        features: {
+            textToVideo: true,
+            imageToVideo: false,
+            capabilities: ['t2v'],
+            aspectRatios: commonVideoRatios,
+            seed: false,
+            multipleVideos: false,
+        },
+        providerOptions: falVideoProviderOptions,
+    },
+    {
+        id: 'hunyuan-video',
+        name: 'Hunyuan Video (Fal)',
+        provider: 'fal',
+        strategy: 'video',
+        released: '2025-09',
+        cost: { type: 'unknown' },
+        features: {
+            textToVideo: true,
+            imageToVideo: true,
+            capabilities: ['t2v', 'i2v'],
+            aspectRatios: commonVideoRatios,
+            seed: true,
+            multipleVideos: false,
+        },
+        providerOptions: falVideoProviderOptions,
+    },
+];
+// ─── provider option helpers ─────────────────────────────────────────────────
+/**
+ * Collect the valid values for a CLI flag across all providers in the catalog.
+ * Returns a map of provider name → enum values array. Only includes providers
+ * that declare values for the given flag. Used by cli.ts to auto-generate
+ * flag descriptions like "xAI: low, medium, high. OpenAI: auto, low, medium, high".
+ */
+export function getProviderValuesForFlag(flag, catalogs = [CATALOG, VIDEO_CATALOG]) {
+    const result = new Map();
+    for (const catalog of catalogs) {
+        for (const entry of catalog) {
+            if (!entry.providerOptions)
+                continue;
+            for (const opt of entry.providerOptions) {
+                if (opt.flag === flag && opt.values?.length && !result.has(entry.provider)) {
+                    result.set(entry.provider, opt.values);
+                }
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Build a human-readable description suffix listing provider-specific values
+ * for a flag. Includes default values when available.
+ * Example: "xai: low, medium, high (default: medium). openai: auto, low, medium, high (default: auto)"
+ */
+export function describeProviderValues(flag, catalogs) {
+    const allCatalogs = catalogs ?? [CATALOG, VIDEO_CATALOG];
+    // collect {provider → {values, defaultValue}} for this flag
+    const providerInfo = new Map();
+    for (const catalog of allCatalogs) {
+        for (const entry of catalog) {
+            if (!entry.providerOptions)
+                continue;
+            for (const opt of entry.providerOptions) {
+                if (opt.flag === flag && opt.values?.length && !providerInfo.has(entry.provider)) {
+                    providerInfo.set(entry.provider, {
+                        values: opt.values,
+                        defaultValue: opt.defaultValue,
+                    });
+                }
+            }
+        }
+    }
+    if (providerInfo.size === 0)
+        return '';
+    return [...providerInfo.entries()]
+        .map(([provider, info]) => {
+        const vals = info.values.join(', ');
+        const def = info.defaultValue ? ` (default: ${info.defaultValue})` : '';
+        return `${provider}: ${vals}${def}`;
+    })
+        .join('. ');
+}
+/**
+ * Find the ProviderOption definition for a given flag and provider from a model entry.
+ * Returns undefined if the model doesn't support this flag.
+ */
+export function findProviderOption(entry, flag) {
+    return entry.providerOptions?.find((opt) => opt.flag === flag);
+}
 // ─── lookup helpers ──────────────────────────────────────────────────────────
-const catalogIndex = new Map(CATALOG.map((m) => [m.id, m]));
+const imageCatalogIndex = new Map(CATALOG.map((m) => [m.id, m]));
+const videoCatalogIndex = new Map(VIDEO_CATALOG.map((m) => [m.id, m]));
 export function findModel(id) {
-    return catalogIndex.get(id);
+    return imageCatalogIndex.get(id);
+}
+export function findVideoModel(id) {
+    return videoCatalogIndex.get(id);
+}
+export function findAnyModel(id) {
+    return imageCatalogIndex.get(id) ?? videoCatalogIndex.get(id);
 }

package/dist/models.d.ts

@@ -1,8 +1,8 @@
 import type { ImageModel, LanguageModel } from 'ai';
-import type { ModelEntry } from './model-catalog.js';
-import type { VideoModelEntry } from './video-model-catalog.js';
-export type AnyModelEntry = ModelEntry | VideoModelEntry;
-export type { ModelEntry, VideoModelEntry };
+import { type ImageModelEntry, type VideoModelEntry, type AnyModelEntry } from './model-catalog.js';
+export type { ImageModelEntry, VideoModelEntry, AnyModelEntry };
+/** @deprecated Use ImageModelEntry instead */
+export type ModelEntry = ImageModelEntry;
 export declare const IMAGE_MODELS: [string, ...string[]];
 export declare const VIDEO_MODELS: [string, ...string[]];
 export declare const DEFAULT_MODEL = "nano-banana-pro-preview";

package/dist/models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,IAAI,CAAA;AAInD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE/D,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,eAAe,CAAA;AACxD,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,CAAA;AAE3C,eAAO,MAAM,YAAY,EAA+B,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;AAC7E,eAAO,MAAM,YAAY,EAAqC,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;AAYnF,eAAO,MAAM,aAAa,4BAA4B,CAAA;AACtD,eAAO,MAAM,mBAAmB,8BAA8B,CAAA;AAE9D,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAO7D;AAuBD,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAiD5D;AAgDD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAI9D;AAOD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAsC3E;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC,CAqCxB;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAyCpE"}
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,IAAI,CAAA;AAWnD,OAAO,EAML,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAA;AAE3B,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,CAAA;AAC/D,8CAA8C;AAC9C,MAAM,MAAM,UAAU,GAAG,eAAe,CAAA;AAExC,eAAO,MAAM,YAAY,EAA+B,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;AAC7E,eAAO,MAAM,YAAY,EAAqC,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;AAYnF,eAAO,MAAM,aAAa,4BAA4B,CAAA;AACtD,eAAO,MAAM,mBAAmB,8BAA8B,CAAA;AAE9D,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAO7D;AAyHD,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CA+C5D;AAoCD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAI9D;AAgED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA0B3E;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA8B7E;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CA+BpE"}