egaki 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -2,6 +2,44 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.4.0
+
+1. **ChatGPT login for OpenAI image generation** — use your ChatGPT subscription in `egaki` without a separate OpenAI platform API key:
+
+   ```bash
+   egaki login --provider chatgpt
+   egaki image "a dreamy studio ghibli style bakery at sunrise" -m gpt-image-1.5 -o bakery.png
+   ```
+
+   OpenAI image requests authenticated this way now follow the same Codex backend flow used by ChatGPT instead of the normal Image API path.
+
+2. **ChatGPT-backed image editing** — edit existing images with OpenAI image models through the ChatGPT/Codex backend:
+
+   ```bash
+   egaki image "change the red jacket to a blue jacket" -m gpt-image-1.5 --input portrait.png -o portrait-blue.png
+   egaki image "turn this product shot into a clay render" -m gpt-image-1.5 --input product.png -o product-clay.png
+   ```
+
+   Multiple input images are supported. For this backend path, `egaki` now explicitly rejects unsupported options like `--seed`, `--mask`, and multi-image output instead of pretending they work.
+
+3. **Aspect ratio support for ChatGPT image generation** — supported ChatGPT/OpenAI aspect ratios now map to the backend's real size controls:
+
+   ```bash
+   egaki image "wide landscape matte painting" -m gpt-image-1.5 --aspect-ratio 3:2 -o wide.png
+   egaki image "book cover concept art" -m gpt-image-1.5 --aspect-ratio 2:3 -o cover.png
+   ```
+
+   Supported ratios on this path are `1:1`, `3:2`, and `2:3`.
+
+4. **`egaki models` now shows login availability** — model discovery output includes whether each provider is currently usable from your configured credentials:
+
+   ```bash
+   egaki models
+   egaki models --json | jq '.[] | {id, provider, auth}'
+   ```
+
+   The output now includes `auth.available` and `auth.source` (`env`, `stored`, `oauth`, or `none`) so you can see which model families are ready to use.
+
 ## 0.3.0
 
 1. **Google Vertex AI provider** — use Google Cloud billing instead of AI Studio by

package/README.md

@@ -20,6 +20,14 @@ egaki image "a watercolor fox reading a map" -o fox.png
 egaki video "a paper boat drifting on a calm lake at sunrise" -o boat.mp4
 ```
 
+### Quick start with ChatGPT auth
+
+```bash
+egaki login --provider chatgpt
+egaki image "a dreamy studio ghibli style bakery at sunrise" -m gpt-image-1.5 -o bakery.png
+egaki image "change the red jacket to a blue jacket" -m gpt-image-1.5 --input portrait.png -o portrait-blue.png
+```
+
 ## CLI examples
 
 ### Generate an image from text
@@ -34,6 +42,7 @@ egaki image "isometric floating city, detailed, soft colors" -m imagen-4.0-gener
 ```bash
 egaki image "add a red scarf and make it winter" --input portrait.jpg -o portrait-winter.png
 egaki image "turn this into a manga panel" --input https://example.com/photo.jpg -o manga.png
+egaki image "change the red square to a blue square" -m gpt-image-1.5 --input input.png -o output.png
 ```
 
 ### Inpainting with a mask
@@ -53,6 +62,7 @@ egaki image "minimal logo concepts for a cat cafe" -n 4 -o logo.png
 ```bash
 egaki image "cyberpunk alley at night" --aspect-ratio 16:9
 egaki image "polaroid-style travel photo" --aspect-ratio 4:5
+egaki image "wide landscape matte painting" -m gpt-image-1.5 --aspect-ratio 3:2 -o wide.png
 ```
 
 ### Use Google Cloud billing via Vertex AI
@@ -209,6 +219,7 @@ egaki image "mascot variations, flat vector look" \
 egaki supports **both** authentication modes:
 
 - **BYOK (bring your own keys):** add provider keys with `egaki login` per provider.
+- **ChatGPT auth:** log in with `egaki login --provider chatgpt` to use the ChatGPT/Codex backend for supported OpenAI image generation and editing flows.
 - **Egaki subscription:** use one `egaki_...` key to access all supported models without managing keys for each provider.
 - **Google vs Vertex:** bare model IDs (e.g. `imagen-4.0-generate-001`) use Google AI Studio. Prefix with `vertex/` (e.g. `vertex/imagen-4.0-generate-001`) to route through Vertex AI / Google Cloud billing.
 
@@ -226,6 +237,10 @@ egaki login --provider egaki --key egaki_...
 egaki login --provider google --key AIza...
 egaki login --provider vertex --key AIza...
 
+# ChatGPT OAuth for Codex-backed image generation/editing
+egaki login --provider chatgpt
+egaki image "turn this product shot into a clay render" -m gpt-image-1.5 --input product.png -o product-clay.png
+
 # Check subscription usage / cancel
 egaki usage
 egaki unsubscribe

package/dist/chatgpt-auth.d.ts

@@ -0,0 +1,25 @@
+export type ChatGptAuth = {
+    email?: string;
+    accountId?: string;
+    plan?: string;
+    refresh: string;
+    access: string;
+    expires: number;
+};
+/** Extract the ChatGPT plan type (e.g. "plus", "pro") from the access token. */
+export declare function extractPlanType(auth: ChatGptAuth): string | undefined;
+/**
+ * Run the full ChatGPT OAuth browser flow with clack UI.
+ * Returns the ChatGptAuth object to be stored in credentials.json.
+ */
+export declare function chatGptOAuthLogin(): Promise<ChatGptAuth>;
+/**
+ * Refresh an expired ChatGPT access token using the refresh token.
+ * Returns the updated auth object, or an Error if refresh fails.
+ */
+export declare function refreshChatGptToken(auth: ChatGptAuth): Promise<ChatGptAuth | Error>;
+/**
+ * Refresh the auth object if needed and return the full updated state.
+ */
+export declare function getValidChatGptAuth(auth: ChatGptAuth, onRefresh?: (updated: ChatGptAuth) => void): Promise<ChatGptAuth | Error>;
+//# sourceMappingURL=chatgpt-auth.d.ts.map

package/dist/chatgpt-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatgpt-auth.d.ts","sourceRoot":"","sources":["../src/chatgpt-auth.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAgGD,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAOrE;AA8JD;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,WAAW,CAAC,CA8C9D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC,CAyBzF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,WAAW,EACjB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,GACzC,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC,CAS9B"}

package/dist/chatgpt-auth.js

@@ -3,8 +3,8 @@
 // Tokens are stored inside credentials.json under the 'chatgpt' key as a
 // structured object (not a plain string like other providers).
 //
-// The access token is a standard OpenAI bearer token that works with the
-// Image API, so we can inject it as OPENAI_API_KEY for the SDK to pick up.
+// Tokens are stored so egaki can reuse the ChatGPT login for Codex-style
+// backend requests and refresh them when needed.
 import { createServer } from 'node:http';
 import { spawn } from 'node:child_process';
 import { spinner, log, note } from '@clack/prompts';
@@ -55,6 +55,13 @@ function extractEmail(tokens) {
     return ((typeof idClaims?.email === 'string' ? idClaims.email : undefined) ??
         (typeof accessClaims?.email === 'string' ? accessClaims.email : undefined));
 }
+function extractPlanTypeFromTokens(tokens) {
+    const idClaims = tokens.id_token ? parseJwtClaims(tokens.id_token) : undefined;
+    const accessClaims = parseJwtClaims(tokens.access_token);
+    const idAuth = idClaims?.['https://api.openai.com/auth'];
+    const accessAuth = accessClaims?.['https://api.openai.com/auth'];
+    return idAuth?.chatgpt_plan_type ?? accessAuth?.chatgpt_plan_type;
+}
 function extractAccountId(tokens) {
     const idClaims = tokens.id_token ? parseJwtClaims(tokens.id_token) : undefined;
     const accessClaims = parseJwtClaims(tokens.access_token);
@@ -71,6 +78,8 @@ function extractAccountId(tokens) {
 }
 /** Extract the ChatGPT plan type (e.g. "plus", "pro") from the access token. */
 export function extractPlanType(auth) {
+    if (auth.plan)
+        return auth.plan;
     const claims = parseJwtClaims(auth.access);
     const authClaim = claims?.['https://api.openai.com/auth'];
     return authClaim?.chatgpt_plan_type;
@@ -81,7 +90,7 @@ function buildAuthorizeUrl(pkce, state) {
         response_type: 'code',
         client_id: CLIENT_ID,
         redirect_uri: REDIRECT_URI,
-        scope: 'openid profile email offline_access',
+        scope: 'openid profile email offline_access api.connectors.read api.connectors.invoke',
         code_challenge: pkce.challenge,
         code_challenge_method: 'S256',
         id_token_add_organizations: 'true',
@@ -236,6 +245,7 @@ export async function chatGptOAuthLogin() {
     const auth = {
         email: extractEmail(tokens),
         accountId: extractAccountId(tokens),
+        plan: extractPlanTypeFromTokens(tokens),
         refresh: tokens.refresh_token,
         access: tokens.access_token,
         expires: now + (tokens.expires_in ?? 3600) * 1000,
@@ -266,6 +276,7 @@ export async function refreshChatGptToken(auth) {
         const json = (await response.json());
         return {
             ...auth,
+            plan: extractPlanTypeFromTokens(json) ?? auth.plan,
             access: json.access_token,
             refresh: json.refresh_token ?? auth.refresh,
             expires: Date.now() + (json.expires_in ?? 3600) * 1000,
@@ -276,19 +287,15 @@ export async function refreshChatGptToken(auth) {
     }
 }
 /**
- * Get a valid access token from a ChatGptAuth object.
- * Auto-refreshes if expired. Returns the token string or an Error.
- * If the auth was refreshed, the `onRefresh` callback is called with
- * the updated auth so the caller can persist it.
+ * Refresh the auth object if needed and return the full updated state.
  */
-export async function getValidAccessToken(auth, onRefresh) {
-    // Token still valid (with 60s buffer)
+export async function getValidChatGptAuth(auth, onRefresh) {
     if (auth.expires > Date.now() + 60_000) {
-        return auth.access;
+        return auth;
     }
     const refreshed = await refreshChatGptToken(auth);
     if (refreshed instanceof Error)
         return refreshed;
     onRefresh?.(refreshed);
-    return refreshed.access;
+    return refreshed;
 }

package/dist/cli.js

@@ -14,12 +14,14 @@ import { generateImage as aiGenerateImage, generateText, experimental_generateVi
 import fs from 'node:fs';
 import path from 'node:path';
 import pc from 'picocolors';
+import { createParser } from 'eventsource-parser';
 import pkg from '../package.json' with { type: 'json' };
-import { injectCredentialsToEnv, PROVIDERS } from './credentials.js';
-import { IMAGE_MODELS, VIDEO_MODELS, DEFAULT_MODEL, DEFAULT_VIDEO_MODEL, getModelConfig, createImageModel, createTextModel, createVideoModel, } from './models.js';
+import { injectCredentialsToEnv, PROVIDERS, getChatGptAuth, saveChatGptAuth, getKeyStatus, } from './credentials.js';
+import { IMAGE_MODELS, VIDEO_MODELS, DEFAULT_MODEL, DEFAULT_VIDEO_MODEL, getModelConfig, createImageModel, createTextModel, createVideoModel, shouldUseResponsesApi, } from './models.js';
 import { VIDEO_CATALOG } from './video-model-catalog.js';
 import { loginInteractive, loginNonInteractive, showLoginStatus, removeLogin, readKeyFromStdin, } from './login.js';
 import { subscribeInteractive, subscribeNonInteractive, unsubscribe, showUsage, } from './subscription.js';
+import { getValidChatGptAuth } from './chatgpt-auth.js';
 const cli = goke('egaki');
 process.title = 'egaki';
 // Print clean error output for unhandled rejections (e.g. AI SDK APICallError).
@@ -73,8 +75,13 @@ cli
     }
     // Non-interactive: --provider + --key or stdin
     if (options.provider) {
+        // ChatGPT uses browser OAuth — skip key reading
+        if (options.provider === 'chatgpt') {
+            await loginNonInteractive({ provider: options.provider, key: '' });
+            return;
+        }
         const key = options.key || (await readKeyFromStdin());
-        loginNonInteractive({ provider: options.provider, key });
+        await loginNonInteractive({ provider: options.provider, key });
         return;
     }
     // Interactive mode
@@ -178,29 +185,52 @@ cli
     .example('# Pipe to another tool')
     .example('egaki image "logo design" --stdout | convert - -resize 512x512 logo.png')
     .action(async (prompt, options) => {
-    // Inject stored API keys as env vars before calling the AI SDK
+    // Inject stored API keys as env vars before calling the AI SDK.
     injectCredentialsToEnv();
-    const model = options.model;
-    const outputPath = options.output;
+    // goke infers schema .default() values via Zod's input type, which leaves
+    // options.model / options.output / options.count as `T | undefined` even
+    // though the runtime always resolves them. Apply the same defaults here.
+    const model = options.model ?? DEFAULT_MODEL;
+    const outputPath = options.output ?? 'egaki-output.png';
+    const count = options.count ?? 1;
     const config = getModelConfig(model);
+    const parsedAspectRatio = parseAspectRatioOption(options.aspectRatio);
     if (!options.stdout) {
         console.error(pc.dim(`Model: ${model}`));
         console.error(pc.dim(`Prompt: ${prompt}`));
-        console.error(pc.dim(config.strategy === 'image'
-            ? 'Mode: Image API (generateImage)'
-            : 'Mode: Text+Image (generateText)'));
     }
     const inputImages = await readInputImages(options.input);
     const maskImage = options.mask
         ? await readInputSource(options.mask)
         : undefined;
-    if (config.strategy === 'image') {
+    // When using ChatGPT OAuth with OpenAI image models, route through the
+    // Responses API + imageGeneration tool instead of the Image API.
+    // The Codex OAuth client lacks the `api.model.images.request` scope.
+    const useResponsesApi = config.strategy === 'image' && shouldUseResponsesApi(model);
+    if (useResponsesApi) {
+        if (!options.stdout) {
+            console.error(pc.dim('Mode: Responses API (ChatGPT OAuth)'));
+        }
+        await generateWithResponsesApi({
+            prompt,
+            model,
+            outputPath,
+            count,
+            aspectRatio: parsedAspectRatio,
+            seed: options.seed,
+            inputImages,
+            maskImage,
+            json: options.json || false,
+            stdout: options.stdout || false,
+        });
+    }
+    else if (config.strategy === 'image') {
         await generateWithImageModel({
             prompt,
             model,
             outputPath,
-            count: options.count,
-            aspectRatio: options.aspectRatio,
+            count,
+            aspectRatio: parsedAspectRatio,
             seed: options.seed,
             inputImages,
             maskImage,
@@ -261,8 +291,10 @@ cli
     .example('egaki video "waves crashing on cliffs" -n 2 -o waves.mp4')
     .action(async (prompt, options) => {
     injectCredentialsToEnv();
-    const model = options.model;
-    const outputPath = options.output;
+    // Apply the same .default(...) values goke's input-type inference drops.
+    const model = options.model ?? DEFAULT_VIDEO_MODEL;
+    const outputPath = options.output ?? 'egaki-output.mp4';
+    const count = options.count ?? 1;
     const config = getModelConfig(model);
     if (config.strategy !== 'video') {
         console.error(pc.red(`Model ${model} is not a video model`));
@@ -280,7 +312,7 @@ cli
         prompt,
         model,
         outputPath,
-        count: options.count,
+        count,
         aspectRatio: options.aspectRatio,
         resolution: options.resolution,
         duration: options.duration,
@@ -306,6 +338,7 @@ cli
     .action(async (options) => {
     const { CATALOG } = await import('./model-catalog.js');
     const yaml = await import('js-yaml');
+    const providerStatuses = Object.fromEntries(Object.keys(PROVIDERS).map((provider) => [provider, getKeyStatus(provider)]));
     let models = options.type === 'video'
         ? VIDEO_CATALOG
         : options.type === 'image'
@@ -323,6 +356,7 @@ cli
         name: m.name,
         ...(m.description ? { description: m.description } : {}),
         provider: m.provider,
+        auth: providerStatuses[m.provider] ?? { available: false, source: 'none' },
         strategy: m.strategy,
         released: m.released,
         cost: formatCatalogCost(m.cost),
@@ -529,6 +563,148 @@ async function generateWithTextModel({ prompt, model, outputPath, inputImages, i
         console.log(JSON.stringify(output, null, 2));
     }
 }
+// Generate using the OpenAI Responses API with imageGeneration tool.
+// Used when auth comes from ChatGPT OAuth (no Image API scope).
+async function generateWithResponsesApi({ prompt, model, outputPath, count, aspectRatio, seed, inputImages, maskImage, json, stdout, }) {
+    if (count !== 1) {
+        console.error(pc.red('ChatGPT image generation currently supports exactly one output image.'));
+        process.exit(1);
+    }
+    if (seed !== undefined) {
+        console.error(pc.red('ChatGPT image generation does not support --seed.'));
+        process.exit(1);
+    }
+    if (maskImage) {
+        console.error(pc.red('ChatGPT image generation does not support --mask yet.'));
+        process.exit(1);
+    }
+    const size = aspectRatio ? chatGptImageSizeFromAspectRatio(aspectRatio) : undefined;
+    if (aspectRatio && !size) {
+        console.error(pc.red('ChatGPT image generation only supports --aspect-ratio 1:1, 3:2, or 2:3.'));
+        process.exit(1);
+    }
+    const storedAuth = getChatGptAuth();
+    if (!storedAuth?.accountId) {
+        console.error(pc.red('Missing ChatGPT account metadata. Please run `egaki login --provider chatgpt` again.'));
+        process.exit(1);
+    }
+    const auth = await getValidChatGptAuth(storedAuth, saveChatGptAuth);
+    if (auth instanceof Error) {
+        console.error(pc.red(auth.message));
+        process.exit(1);
+    }
+    if (!stdout) {
+        console.error(pc.cyan('Generating...'));
+    }
+    const content = [
+        { type: 'input_text', text: prompt },
+        ...inputImages.map((image) => ({
+            type: 'input_image',
+            image_url: imageBytesToDataUrl(image),
+        })),
+    ];
+    const response = await fetch('https://chatgpt.com/backend-api/codex/responses', {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${auth.access}`,
+            'ChatGPT-Account-ID': auth.accountId,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            model: 'gpt-5.4',
+            instructions: 'You are Codex.',
+            input: [
+                {
+                    type: 'message',
+                    role: 'user',
+                    content,
+                },
+            ],
+            tools: [
+                {
+                    type: 'image_generation',
+                    model,
+                    size: 'auto',
+                    quality: 'auto',
+                    output_format: 'png',
+                    output_compression: 100,
+                    moderation: 'auto',
+                    ...(size ? { size } : {}),
+                },
+            ],
+            tool_choice: 'auto',
+            parallel_tool_calls: true,
+            stream: true,
+            store: false,
+            include: [],
+        }),
+    });
+    if (!response.ok || !response.body) {
+        const body = await response.text().catch(() => '');
+        console.error(pc.red(`ChatGPT image generation failed: ${response.status}`));
+        if (body)
+            console.error(pc.dim(body));
+        process.exit(1);
+    }
+    let imageBase64;
+    let revisedPrompt = null;
+    const processSseMessage = (message) => {
+        if (!message.data)
+            return;
+        try {
+            const event = JSON.parse(message.data);
+            if (event.type === 'response.image_generation_call.partial_image' &&
+                event.partial_image_b64 &&
+                !imageBase64) {
+                imageBase64 = event.partial_image_b64;
+            }
+            if (event.type === 'response.output_item.done' &&
+                event.item?.type === 'image_generation_call') {
+                if (event.item.result)
+                    imageBase64 = event.item.result;
+                revisedPrompt = event.item.revised_prompt ?? revisedPrompt;
+            }
+        }
+        catch {
+            // Ignore keepalive and partial parse noise.
+        }
+    };
+    const parser = createParser({
+        onEvent: processSseMessage,
+    });
+    const decoder = new TextDecoder();
+    for await (const chunk of response.body) {
+        parser.feed(decoder.decode(chunk, { stream: true }));
+    }
+    parser.feed(decoder.decode());
+    if (!imageBase64) {
+        console.error(pc.red('No images generated.'));
+        process.exit(1);
+    }
+    const imageBytes = Buffer.from(imageBase64, 'base64');
+    const mediaType = 'image/png';
+    if (stdout) {
+        process.stdout.write(imageBytes);
+        return;
+    }
+    const savedFiles = [];
+    const filePath = ensureExtension(outputPath, extensionFromMediaType(mediaType));
+    fs.writeFileSync(filePath, imageBytes);
+    console.error(pc.green(`Saved: ${filePath}`));
+    savedFiles.push(filePath);
+    if (revisedPrompt && !json) {
+        console.error(pc.dim(`Revised prompt: ${revisedPrompt}`));
+    }
+    if (json) {
+        const output = {
+            model,
+            files: savedFiles,
+            count: 1,
+            revisedPrompt,
+        };
+        console.log(JSON.stringify(output, null, 2));
+    }
+}
 // Generate using experimental_generateVideo (video models)
 async function generateWithVideoModel({ prompt, model, outputPath, count, aspectRatio, resolution, duration, fps, seed, inputImage, json, stdout, }) {
     const videoModel = await createVideoModel(model);
@@ -648,6 +824,40 @@ function extensionFromMediaType(mediaType) {
     };
     return map[mediaType] || (mediaType.startsWith('video/') ? '.mp4' : '.png');
 }
+function inferImageMediaType(image) {
+    if (image.length >= 8 && image[0] === 0x89 && image[1] === 0x50 && image[2] === 0x4e && image[3] === 0x47) {
+        return 'image/png';
+    }
+    if (image.length >= 3 && image[0] === 0xff && image[1] === 0xd8 && image[2] === 0xff) {
+        return 'image/jpeg';
+    }
+    if (image.length >= 12 &&
+        image[0] === 0x52 && image[1] === 0x49 && image[2] === 0x46 && image[3] === 0x46 &&
+        image[8] === 0x57 && image[9] === 0x45 && image[10] === 0x42 && image[11] === 0x50) {
+        return 'image/webp';
+    }
+    if (image.length >= 6 &&
+        image[0] === 0x47 && image[1] === 0x49 && image[2] === 0x46 && image[3] === 0x38) {
+        return 'image/gif';
+    }
+    return 'image/png';
+}
+function imageBytesToDataUrl(image) {
+    const mediaType = inferImageMediaType(image);
+    return `data:${mediaType};base64,${Buffer.from(image).toString('base64')}`;
+}
+function chatGptImageSizeFromAspectRatio(aspectRatio) {
+    switch (aspectRatio) {
+        case '1:1':
+            return '1024x1024';
+        case '3:2':
+            return '1536x1024';
+        case '2:3':
+            return '1024x1536';
+        default:
+            return undefined;
+    }
+}
 function normalizeResolutionKey(input) {
     if (!input)
         return undefined;
@@ -660,6 +870,15 @@ function normalizeResolutionKey(input) {
         return '480p';
     return normalized;
 }
+function isAspectRatio(input) {
+    return /^\d+:\d+$/.test(input);
+}
+function parseAspectRatioOption(input) {
+    if (!input || !isAspectRatio(input)) {
+        return undefined;
+    }
+    return input;
+}
 function ensureExtension(filePath, ext) {
     const parsed = path.parse(filePath);
     if (parsed.ext) {

package/dist/credentials.d.ts

@@ -1,18 +1,31 @@
-export declare const PROVIDERS: Record<string, {
+import type { ChatGptAuth } from './chatgpt-auth.js';
+export type ProviderInfo = {
     envVar: string;
     label: string;
     hint: string;
-}>;
+    /** If true, this provider uses OAuth instead of a plain API key */
+    oauth?: boolean;
+};
+export declare const PROVIDERS: Record<string, ProviderInfo>;
 export declare const EGAKI_GATEWAY_URL = "https://egaki.org/v3/ai";
-export type Credentials = Record<string, string>;
+/** A credential value is either a plain API key string or a ChatGPT OAuth object. */
+export type CredentialValue = string | ChatGptAuth;
+export type Credentials = Record<string, CredentialValue>;
 export declare function readCredentials(): Credentials;
 export declare function writeCredentials(creds: Credentials): void;
 export declare function saveProviderKey(provider: string, key: string): void;
+export declare function saveChatGptAuth(auth: ChatGptAuth): void;
+export declare function getChatGptAuth(): ChatGptAuth | undefined;
 export declare function removeProviderKey(provider: string): void;
 export declare function getProviderKey(provider: string): string | undefined;
 export declare function injectCredentialsToEnv(): void;
+/**
+ * Returns true when the current run should use the ChatGPT/Codex backend flow
+ * for OpenAI image models instead of a direct OpenAI API key.
+ */
+export declare function shouldUseChatGptBackend(): boolean;
 export declare function getKeyStatus(provider: string): {
     available: boolean;
-    source: 'env' | 'stored' | 'none';
+    source: 'env' | 'stored' | 'oauth' | 'none';
 };
 //# sourceMappingURL=credentials.d.ts.map

package/dist/credentials.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,SAAS,EAAE,MAAM,CAC5B,MAAM,EACN;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAgChD,CAAA;AAED,eAAO,MAAM,iBAAiB,4BAA4B,CAAA;AAa1D,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEhD,wBAAgB,eAAe,IAAI,WAAW,CAO7C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAOzD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAInE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIxD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGnE;AAKD,wBAAgB,sBAAsB,IAAI,IAAI,CAW7C;AAID,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC9C,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;CAClC,CAaA"}
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,mEAAmE;IACnE,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAKD,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAqClD,CAAA;AAED,eAAO,MAAM,iBAAiB,4BAA4B,CAAA;AAa1D,qFAAqF;AACrF,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,CAAA;AAClD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;AAEzD,wBAAgB,eAAe,IAAI,WAAW,CAO7C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAOzD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAInE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAIvD;AAED,wBAAgB,cAAc,IAAI,WAAW,GAAG,SAAS,CAOxD;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIxD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAInE;AAKD,wBAAgB,sBAAsB,IAAI,IAAI,CAa7C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD;AAID,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC9C,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAA;CAC5C,CAuBA"}