egaki 0.5.0 → 0.7.0

package/dist/cli/generate.test.js

@@ -0,0 +1,131 @@
+// Tests for the programmatic generation API (generate.ts).
+// Tests the error-as-value pattern and validation logic without
+// making actual API calls (no credentials needed).
+import { describe, it, expect } from 'vitest';
+import { generateImage, generateVideo, calculateCost, buildImageProviderOptions, buildVideoProviderOptions, ValidationError, } from './generate.js';
+describe('generateImage', () => {
+    it('returns ValidationError for unknown model', async () => {
+        const result = await generateImage({
+            prompt: 'test',
+            model: 'nonexistent-model-xyz',
+        });
+        expect(result).toBeInstanceOf(ValidationError);
+        expect(result.message).toMatch(/Unknown model/);
+    });
+});
+describe('generateVideo', () => {
+    it('returns Error for unknown model', async () => {
+        const result = await generateVideo({
+            prompt: 'test',
+            model: 'nonexistent-model-xyz',
+        });
+        expect(result).toBeInstanceOf(Error);
+        expect(result.message).toMatch(/Unknown model/);
+    });
+    it('returns Error when using image model as video model', async () => {
+        const result = await generateVideo({
+            prompt: 'test',
+            model: 'imagen-4.0-generate-001',
+        });
+        expect(result).toBeInstanceOf(Error);
+        expect(result.message).toMatch(/not a video model/);
+    });
+    it('returns Error when reference-to-video mode has no reference images', async () => {
+        const result = await generateVideo({
+            prompt: 'test',
+            model: 'veo-3.1-fast-generate-001',
+            mode: 'reference-to-video',
+        });
+        expect(result).toBeInstanceOf(ValidationError);
+        expect(result.message).toMatch(/referenceImages is required/);
+    });
+    it('returns Error when edit-video mode has no videoUrl', async () => {
+        const result = await generateVideo({
+            prompt: 'test',
+            model: 'grok-imagine-video',
+            mode: 'edit-video',
+            inputImage: new Uint8Array([1, 2, 3]),
+        });
+        expect(result).toBeInstanceOf(ValidationError);
+        expect(result.message).toMatch(/videoUrl is required/);
+    });
+});
+describe('calculateCost', () => {
+    it('calculates per-image cost', () => {
+        const cost = calculateCost({ type: 'per-image', perImage: 0.04 }, {}, 3);
+        expect(cost).toBeCloseTo(0.12);
+    });
+    it('calculates per-token cost', () => {
+        const cost = calculateCost({ type: 'per-token', inputPerM: 1.25, outputPerM: 5.0 }, { inputTokens: 1000, outputTokens: 500 });
+        // (1000 * 1.25 + 500 * 5.0) / 1_000_000 = 0.00375
+        expect(cost).toBeCloseTo(0.00375);
+    });
+    it('calculates per-video-second cost', () => {
+        const cost = calculateCost({
+            type: 'per-video-second',
+            defaultDurationSec: 5,
+            tiers: [{ costPerSecond: 0.05 }],
+        }, { durationSeconds: 10 });
+        expect(cost).toBeCloseTo(0.5);
+    });
+    it('uses default duration when none specified', () => {
+        const cost = calculateCost({
+            type: 'per-video-second',
+            defaultDurationSec: 5,
+            tiers: [{ costPerSecond: 0.05 }],
+        }, {});
+        expect(cost).toBeCloseTo(0.25);
+    });
+    it('returns null for unknown cost type', () => {
+        const cost = calculateCost({ type: 'unknown' }, {});
+        expect(cost).toBeNull();
+    });
+});
+describe('buildImageProviderOptions', () => {
+    it('builds google options with person generation', () => {
+        const opts = buildImageProviderOptions('google', {
+            allowPeople: true,
+            aspectRatio: '16:9',
+        });
+        expect(opts.google).toEqual({
+            personGeneration: 'allow_all',
+            aspectRatio: '16:9',
+        });
+    });
+    it('builds xai options with quality', () => {
+        const opts = buildImageProviderOptions('xai', {
+            allowPeople: false,
+            quality: 'high',
+            resolution: '4k',
+        });
+        expect(opts.xai).toEqual({
+            quality: 'high',
+            resolution: '4k',
+        });
+    });
+    it('returns empty for unknown provider', () => {
+        const opts = buildImageProviderOptions('unknown-provider', {
+            allowPeople: false,
+        });
+        expect(opts).toEqual({});
+    });
+});
+describe('buildVideoProviderOptions', () => {
+    it('builds xai edit-video options', () => {
+        const opts = buildVideoProviderOptions('xai', {
+            mode: 'edit-video',
+            videoUrl: 'https://example.com/video.mp4',
+            model: 'grok-imagine-video',
+        });
+        expect(opts?.xai).toEqual({
+            mode: 'edit-video',
+            videoUrl: 'https://example.com/video.mp4',
+        });
+    });
+    it('returns undefined for provider with no options', () => {
+        const opts = buildVideoProviderOptions('google', {
+            model: 'veo-3.1-fast-generate-001',
+        });
+        expect(opts).toBeUndefined();
+    });
+});

package/dist/cli/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/cli/login.ts"],"names":[],"mappings":"AA4BA,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkGtD;AAED,wBAAsB,mBAAmB,CAAC,EACxC,QAAQ,EACR,GAAG,GACJ,EAAE;IACD,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChB;AAED,wBAAgB,eAAe,IAAI,IAAI,CA2DtC;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAalD;AAGD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAMxD"}

package/dist/{login.js → cli/login.js}

@@ -4,8 +4,9 @@
 // ChatGPT OAuth uses a browser flow instead of pasting a key.
 import { intro, outro, select, password, isCancel, cancel, log, note, } from '@clack/prompts';
 import pc from 'picocolors';
-import { PROVIDERS, saveProviderKey, removeProviderKey, getKeyStatus, getChatGptAuth, saveChatGptAuth, } from './credentials.js';
+import { PROVIDERS, saveProviderKey, removeProviderKey, getKeyStatus, getChatGptAuth, saveChatGptAuth, getXaiAuth, saveXaiAuth, } from './credentials.js';
 import { chatGptOAuthLogin, extractPlanType } from './chatgpt-auth.js';
+import { xaiOAuthLogin } from './xai-auth.js';
 export async function loginInteractive() {
     intro(pc.bold('egaki login'));
     const providerOptions = Object.entries(PROVIDERS).map(([key, info]) => {
@@ -18,9 +19,17 @@ export async function loginInteractive() {
                 return pc.green('(saved)');
             }
             if (status.source === 'oauth') {
-                const auth = getChatGptAuth();
-                const email = auth?.email;
-                return pc.green(`(signed in${email ? ` as ${email}` : ''})`);
+                if (key === 'chatgpt') {
+                    const auth = getChatGptAuth();
+                    const email = auth?.email;
+                    return pc.green(`(signed in${email ? ` as ${email}` : ''})`);
+                }
+                if (key === 'xai-oauth') {
+                    const auth = getXaiAuth();
+                    const email = auth?.email;
+                    return pc.green(`(signed in${email ? ` as ${email}` : ''})`);
+                }
+                return pc.green('(signed in)');
             }
             return pc.dim('(not configured)');
         })();
@@ -54,6 +63,13 @@ export async function loginInteractive() {
         outro('Done — ChatGPT OAuth saved');
         return;
     }
+    // xAI Grok Build uses browser OAuth
+    if (provider === 'xai-oauth') {
+        const auth = await xaiOAuthLogin();
+        saveXaiAuth(auth);
+        outro('Done — xAI OAuth saved');
+        return;
+    }
     log.info(`${pc.dim('Env var:')} ${info.envVar} ${pc.dim('(also used by the CLI when set)')}`);
     log.info(`${pc.dim('Get key:')} ${info.hint}`);
     const key = await password({
@@ -87,6 +103,13 @@ export async function loginNonInteractive({ provider, key, }) {
         console.log(pc.green('ChatGPT OAuth saved'));
         return;
     }
+    // xAI Grok Build uses browser OAuth — key flag is not needed
+    if (provider === 'xai-oauth') {
+        const auth = await xaiOAuthLogin();
+        saveXaiAuth(auth);
+        console.log(pc.green('xAI OAuth saved'));
+        return;
+    }
     if (!key || key.trim().length === 0) {
         console.error(pc.red('API key cannot be empty'));
         process.exit(1);
@@ -117,6 +140,24 @@ export function showLoginStatus() {
             }
             continue;
         }
+        if (key === 'xai-oauth') {
+            const auth = getXaiAuth();
+            if (auth) {
+                const email = auth.email ?? 'unknown';
+                const expired = auth.expires < Date.now();
+                const expiryLabel = expired
+                    ? pc.yellow('(token expired, will auto-refresh)')
+                    : pc.dim('(token valid)');
+                console.log(`${pc.green('*')} ${info.label} ${pc.green('(signed in)')}`);
+                console.log(pc.dim(`  account: ${email}`));
+                console.log(`  ${expiryLabel}`);
+            }
+            else {
+                console.log(`${pc.dim('-')} ${info.label} ${pc.dim('(not signed in)')}`);
+                console.log(pc.dim(`  run: egaki login → select xAI Grok Build`));
+            }
+            continue;
+        }
         const icon = status.available ? pc.green('*') : pc.dim('-');
         const source = (() => {
             if (status.source === 'env') {

package/dist/cli/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":""}

package/dist/cli/main.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+// Entrypoint that imports the CLI instance and runs it.
+// cli.ts defines all commands but does not call parse() so that
+// other tools (like goke's generateDocs) can import the CLI without
+// triggering argument parsing.
+import { cli } from './cli.js';
+await cli.parse();

package/dist/cli/model-catalog.d.ts

@@ -0,0 +1,141 @@
+export type PerImageCost = {
+    type: 'per-image';
+    /** USD per image at default quality/resolution */
+    perImage: number;
+};
+export type PerTokenCost = {
+    type: 'per-token';
+    /** USD per million input tokens */
+    inputPerM: number;
+    /** USD per million output tokens */
+    outputPerM: number;
+};
+export type VideoDurationPricingTier = {
+    /** USD per second for this variant */
+    costPerSecond: number;
+    /** Optional resolution discriminator (e.g. 720p, 1080p, 4k) */
+    resolution?: string;
+    /** Optional mode discriminator (e.g. std, pro) */
+    mode?: string;
+    /** Optional audio discriminator */
+    audio?: boolean;
+    /** Optional discriminator for whether image/video input is present (i2v/r2v vs t2v) */
+    hasVideoInput?: boolean;
+};
+export type PerVideoSecondCost = {
+    type: 'per-video-second';
+    /** Fallback duration when request does not specify one (seconds) */
+    defaultDurationSec: number;
+    tiers: VideoDurationPricingTier[];
+};
+export type UnknownCost = {
+    type: 'unknown';
+};
+export type ModelCost = PerImageCost | PerTokenCost;
+export type VideoModelCost = PerVideoSecondCost | UnknownCost;
+export type AnyCost = ModelCost | VideoModelCost;
+export type ProviderOption = {
+    /** CLI flag name, e.g. 'quality', 'output-format' */
+    flag: string;
+    /** The key sent to providerOptions.{provider}.{key} */
+    providerKey: string;
+    /** Human description for --help */
+    description: string;
+    /** Enum values if constrained, shown in flag description */
+    values?: string[];
+    /** Server-side default when not specified */
+    defaultValue?: string;
+    /** Value type */
+    type: 'string' | 'number' | 'boolean';
+    /** Whether this flag accepts multiple values (array) */
+    array?: boolean;
+};
+export type ModelFeatures = {
+    /** supports input images for editing */
+    editing: boolean;
+    /** supports mask for inpainting */
+    inpainting: boolean;
+    /** supported aspect ratios */
+    aspectRatios: string[];
+    /** supported WIDTHxHEIGHT sizes (OpenAI models) */
+    sizes?: string[];
+    /** supports deterministic seed */
+    seed: boolean;
+    /** supports generating n > 1 images */
+    multipleImages: boolean;
+};
+export type VideoModelFeatures = {
+    /** Supports text prompt to video generation */
+    textToVideo: boolean;
+    /** Supports image-to-video prompt object ({ image, text }) */
+    imageToVideo: boolean;
+    /** Optional capabilities exposed by provider */
+    capabilities: Array<'t2v' | 'i2v' | 'r2v' | 'motion-control' | 'editing' | 'extension'>;
+    /** Optional supported aspect ratios */
+    aspectRatios?: string[];
+    /** Optional supported resolutions */
+    resolutions?: string[];
+    /** Optional duration range in seconds */
+    durationRangeSec?: {
+        min: number;
+        max: number;
+    };
+    seed: boolean;
+    multipleVideos: boolean;
+};
+export type ImageModelEntry = {
+    id: string;
+    name: string;
+    description?: string;
+    provider: string;
+    strategy: 'image' | 'text';
+    /** Release date in YYYY-MM-DD or YYYY-MM format */
+    released: string;
+    cost: ModelCost;
+    features: ModelFeatures;
+    /** Provider-specific options passable via providerOptions.{provider} */
+    providerOptions?: ProviderOption[];
+};
+export type VideoModelEntry = {
+    id: string;
+    name: string;
+    description?: string;
+    provider: string;
+    strategy: 'video';
+    released: string;
+    cost: VideoModelCost;
+    features: VideoModelFeatures;
+    /** Provider-specific options passable via providerOptions.{provider} */
+    providerOptions?: ProviderOption[];
+};
+/** @deprecated Use ImageModelEntry instead */
+export type ModelEntry = ImageModelEntry;
+export type { SpeechModelEntry } from './speech-catalog.js';
+export type AnyModelEntry = ImageModelEntry | VideoModelEntry;
+export declare const CATALOG: ModelEntry[];
+export declare const VIDEO_CATALOG: VideoModelEntry[];
+/**
+ * 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 declare function getProviderValuesForFlag(flag: string, catalogs?: AnyModelEntry[][]): Map<string, string[]>;
+/**
+ * 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 declare function describeProviderValues(flag: string, catalogs?: AnyModelEntry[][]): string;
+/**
+ * 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 declare function findProviderOption(entry: AnyModelEntry, flag: string): ProviderOption | undefined;
+export declare function findModel(id: string): ImageModelEntry | undefined;
+export declare function findVideoModel(id: string): VideoModelEntry | undefined;
+export declare function findAnyModel(id: string): AnyModelEntry | undefined;
+export { SPEECH_CATALOG, findSpeechModel } from './speech-catalog.js';
+export { TRANSCRIPTION_CATALOG, findTranscriptionModel } from './transcription-catalog.js';
+export type { TranscriptionModelEntry } from './transcription-catalog.js';
+//# sourceMappingURL=model-catalog.d.ts.map

package/dist/cli/model-catalog.d.ts.map

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