@glbgpt/cli 0.1.0-test.1

package/dist/src/index.js

@@ -0,0 +1,253 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { basename } from 'node:path';
+import { VERSION } from './version.js';
+/**
+ * glbgpt CLI entry (scaffold).
+ *
+ * Phase 1 focuses on the chat engine (see src/core). The interactive TUI, exec,
+ * login, and media commands are wired in subsequent steps. This entry establishes
+ * the command surface so `--help` reflects the product contract.
+ *
+ * All user-facing text is English.
+ */
+const program = new Command();
+// The CLI installs two bins — `glbgpt` and its alias `globalgpt` — so help/usage should
+// name whichever the user actually invoked (fall back to the canonical name).
+const invokedName = process.argv[1] ? basename(process.argv[1]).replace(/\.js$/, '') : 'glbgpt';
+program
+    .name(invokedName === 'globalgpt' ? 'globalgpt' : 'glbgpt')
+    .description('GlobalGPT in your terminal: chat, image and video generation.')
+    .version(VERSION);
+program
+    .command('login')
+    .description('Authorize with your GlobalGPT account in the browser')
+    .option('--no-browser', 'Print the authorization URL instead of opening a browser')
+    .option('--code', 'Paste a one-time login code instead (for headless/SSH)')
+    .action(async (opts) => {
+    const { runLogin } = await import('./commands/loginCommand.js');
+    await runLogin({ noBrowser: opts.browser === false, useCode: opts.code === true });
+});
+program
+    .command('logout')
+    .description('Sign out and remove stored credentials')
+    .action(async () => {
+    const { runLogout } = await import('./commands/loginCommand.js');
+    await runLogout();
+});
+program
+    .command('whoami')
+    .description('Show the signed-in account')
+    .action(async () => {
+    const { runWhoami } = await import('./commands/loginCommand.js');
+    await runWhoami();
+});
+const account = program
+    .command('account')
+    .description('Show account summary and recent spend')
+    .action(async () => {
+    const { runAccount } = await import('./commands/accountCommand.js');
+    await runAccount();
+});
+account
+    .command('transactions')
+    .description('Show recent spend')
+    .action(async () => {
+    const { runAccountTransactions } = await import('./commands/accountCommand.js');
+    await runAccountTransactions();
+});
+program
+    .command('exec [prompt]')
+    .description('Run a single non-interactive model call (for scripts and external agents)')
+    .option('-m, --model <model>', 'Chat model (default gpt-5.6-sol)')
+    .option('--system <text>', 'System prompt to steer the model')
+    .option('--file <path...>', 'Attach file contents as context (repeatable)')
+    .option('-i, --image <path-or-url...>', 'Attach an image for the model to see (repeatable)')
+    .option('--output-schema <file>', 'JSON Schema file for the final answer (structured output)')
+    .option('--json', 'Emit a single final result object to stdout')
+    .option('--jsonl', 'Emit streaming protocol events, one JSON per line')
+    .option('-o, --output-last-message <file>', 'Write the final message text to a file')
+    .action(async (prompt, opts) => {
+    const { runExec } = await import('./commands/execCommand.js');
+    const code = await runExec(prompt, {
+        model: opts.model,
+        system: opts.system,
+        file: opts.file,
+        image: opts.image,
+        outputSchema: opts.outputSchema,
+        json: opts.json,
+        jsonl: opts.jsonl,
+        outputLastMessage: opts.outputLastMessage,
+    });
+    process.exitCode = code;
+});
+program
+    .command('mcp')
+    .description('Run an MCP server (stdio) exposing GlobalGPT chat as a tool for external agents')
+    .action(async () => {
+    const { runMcpServer } = await import('./mcp/server.js');
+    await runMcpServer();
+});
+program
+    .command('resume [target]')
+    .description('Resume a previous conversation (last | <conversation-id>)')
+    .action(async (target) => {
+    const { runTui, loadResumeSession } = await import('./tui/run.js');
+    const resumed = await loadResumeSession(target);
+    if (!resumed) {
+        const which = target && target !== 'last' ? ` for id: ${target}` : '';
+        console.error(`No previous conversation found${which}.`);
+        process.exitCode = 1;
+        return;
+    }
+    await runTui({ session: resumed.session, timeline: resumed.timeline });
+});
+program
+    .command('image [prompt...]')
+    .description('Generate an image')
+    .option('-m, --model <model>', 'Model id (see `glbgpt model list`)')
+    .option('--aspect-ratio <ratio>', 'Aspect ratio, e.g. 16:9')
+    .option('--ar <ratio>', 'Alias for --aspect-ratio')
+    .option('--resolution <res>', 'Resolution, e.g. 2K')
+    .option('--res <res>', 'Alias for --resolution')
+    .option('-i, --image <path...>', 'Reference image path or URL (repeatable)')
+    .option('-n, --count <n>', 'Number of images', (v) => parseInt(v, 10))
+    .option('--seed <n>', 'Random seed', (v) => parseInt(v, 10))
+    .option('--negative-prompt <text>', 'Content to avoid')
+    .option('-o, --out <dir>', 'Output directory')
+    .option('--estimate', 'Show the price only; do not generate')
+    .option('--detach', 'Submit and print the task id without waiting')
+    .action(async (prompt, opts) => {
+    const { runImage } = await import('./commands/mediaCommand.js');
+    await runImage(prompt, {
+        model: opts.model,
+        aspectRatio: (opts.aspectRatio ?? opts.ar),
+        resolution: (opts.resolution ?? opts.res),
+        image: opts.image,
+        count: opts.count,
+        seed: opts.seed,
+        negativePrompt: opts.negativePrompt,
+        out: opts.out,
+        estimate: opts.estimate,
+        detach: opts.detach,
+    });
+});
+program
+    .command('video [prompt...]')
+    .description('Generate a video')
+    .option('-m, --model <model>', 'Model id (see `glbgpt model list video`)')
+    .option('--aspect-ratio <ratio>', 'Aspect ratio, e.g. 16:9')
+    .option('--ar <ratio>', 'Alias for --aspect-ratio')
+    .option('--resolution <res>', 'Resolution, e.g. 720p')
+    .option('--res <res>', 'Alias for --resolution')
+    .option('--duration <seconds>', 'Video length in seconds', (v) => parseInt(v, 10))
+    .option('--audio', 'Generate a soundtrack')
+    .option('--no-audio', 'Do not generate a soundtrack')
+    .option('-i, --image <path...>', 'Reference image path or URL (repeatable)')
+    .option('--start-image <path>', 'First frame (image-to-video)')
+    .option('--end-image <path>', 'Last frame')
+    .option('-o, --out <dir>', 'Output directory')
+    .option('--estimate', 'Show the price only; do not generate')
+    .option('--detach', 'Submit and print the task id without waiting')
+    .action(async (prompt, opts) => {
+    const { runVideo } = await import('./commands/mediaCommand.js');
+    await runVideo(prompt, {
+        model: opts.model,
+        aspectRatio: (opts.aspectRatio ?? opts.ar),
+        resolution: (opts.resolution ?? opts.res),
+        duration: opts.duration,
+        audio: opts.audio,
+        image: opts.image,
+        startImage: opts.startImage,
+        endImage: opts.endImage,
+        out: opts.out,
+        estimate: opts.estimate,
+        detach: opts.detach,
+    });
+});
+const model = program.command('model').description('List and inspect models');
+model
+    .command('list [type]')
+    .description('List available models (chat|image|video)')
+    .action(async (type) => {
+    const { runModelList } = await import('./commands/mediaCommand.js');
+    await runModelList(type);
+});
+model
+    .command('show <model>')
+    .description('Show a model\'s parameters and limits')
+    .action(async (id) => {
+    const { runModelShow } = await import('./commands/mediaCommand.js');
+    await runModelShow(id);
+});
+const task = program.command('task').description('Manage generation tasks');
+task
+    .command('list')
+    .description('List recent tasks')
+    .action(async () => {
+    const { runTaskList } = await import('./commands/mediaCommand.js');
+    await runTaskList();
+});
+task
+    .command('show <id>')
+    .description('Show a task (id or "last")')
+    .action(async (id) => {
+    const { runTaskShow } = await import('./commands/mediaCommand.js');
+    await runTaskShow(id);
+});
+task
+    .command('wait <id>')
+    .description('Wait for a task to finish (id or "last")')
+    .action(async (id) => {
+    const { runTaskWait } = await import('./commands/mediaCommand.js');
+    await runTaskWait(id);
+});
+task
+    .command('download <id>')
+    .description('Download a task result (id or "last")')
+    .option('-o, --out <dir>', 'Output directory')
+    .action(async (id, opts) => {
+    const { runTaskDownload } = await import('./commands/mediaCommand.js');
+    await runTaskDownload(id, opts.out);
+});
+const config = program.command('config').description('Manage persistent CLI settings');
+config
+    .command('list')
+    .description('Show all settings with their effective values')
+    .action(async () => {
+    const { runConfigList } = await import('./commands/configCommand.js');
+    await runConfigList();
+});
+config
+    .command('get <key>')
+    .description('Print one effective setting')
+    .action(async (key) => {
+    const { runConfigGet } = await import('./commands/configCommand.js');
+    await runConfigGet(key);
+});
+config
+    .command('set <key> <value>')
+    .description('Persist a setting (env vars still override)')
+    .action(async (key, value) => {
+    const { runConfigSet } = await import('./commands/configCommand.js');
+    await runConfigSet(key, value);
+});
+config
+    .command('unset <key>')
+    .description('Remove a persisted setting')
+    .action(async (key) => {
+    const { runConfigUnset } = await import('./commands/configCommand.js');
+    await runConfigUnset(key);
+});
+// Default: with no subcommand, `glbgpt` (optionally with a prompt) enters the chat TUI.
+program
+    .argument('[prompt...]', 'Start a chat TUI (optionally with an initial prompt)')
+    .action(async (prompt) => {
+    const { runTui } = await import('./tui/run.js');
+    await runTui({ initialPrompt: prompt.join(' ') });
+});
+program.parseAsync().catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/dist/src/mcp/server.d.ts

@@ -0,0 +1,38 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ChatBackend } from '../core/types.js';
+/** Arguments for the `glbgpt_chat` tool. */
+export interface ChatToolArgs {
+    prompt: string;
+    system?: string;
+    model?: string;
+    /** Image references the model should see: local paths, http(s) URLs, or data URLs. */
+    images?: string[];
+    response_schema?: Record<string, unknown>;
+}
+/** MCP CallToolResult shape (text content + optional error flag). */
+export interface ToolResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/** Injectable deps so the tool handler is unit-testable without a live transport. */
+export interface ChatToolDeps {
+    resolveToken?: () => Promise<string | null>;
+    backendFor?: (token: string) => ChatBackend;
+}
+/**
+ * The `glbgpt_chat` tool: one chat-only turn through the shared core. Never throws — every failure
+ * (not signed in, unknown model, network/turn error) becomes an `isError` tool result so the MCP
+ * client can surface it to its model.
+ */
+export declare function runChatTool(args: ChatToolArgs, deps?: ChatToolDeps): Promise<ToolResult>;
+/** Build the MCP server exposing the glbgpt tools. */
+export declare function buildMcpServer(deps?: ChatToolDeps): McpServer;
+/**
+ * Run the MCP server over stdio. Protocol travels on stdout, so nothing else may write there;
+ * diagnostics go to stderr. Runs until stdin closes.
+ */
+export declare function runMcpServer(): Promise<void>;

package/dist/src/mcp/server.js

@@ -0,0 +1,99 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { HttpChatBackend } from '../core/httpChatBackend.js';
+import { runChatTurn } from '../core/runChat.js';
+import { resolveToken as defaultResolveToken } from '../auth/token.js';
+import { apiBaseUrl } from '../config/env.js';
+import { ensureCatalog } from '../core/catalog.js';
+import { getDefaultChatModel, resolveChatModel } from '../tui/models.js';
+import { resolveImageRef } from '../util/imageRef.js';
+import { VERSION as SERVER_VERSION } from '../version.js';
+function textResult(text, isError = false) {
+    return { content: [{ type: 'text', text }], isError: isError || undefined };
+}
+/**
+ * The `glbgpt_chat` tool: one chat-only turn through the shared core. Never throws — every failure
+ * (not signed in, unknown model, network/turn error) becomes an `isError` tool result so the MCP
+ * client can surface it to its model.
+ */
+export async function runChatTool(args, deps = {}) {
+    const token = await (deps.resolveToken ?? defaultResolveToken)();
+    // Server-driven model catalog (memoized; cache applies now, refresh in background).
+    await ensureCatalog({ baseUrl: apiBaseUrl(), token });
+    if (!token) {
+        return textResult('Not signed in. Run `glbgpt login` first (or set GLBGPT_TOKEN).', true);
+    }
+    let model;
+    try {
+        model = args.model?.trim() ? resolveChatModel(args.model.trim()) : getDefaultChatModel();
+    }
+    catch (err) {
+        return textResult(errText(err), true);
+    }
+    const responseFormat = args.response_schema
+        ? { type: 'json_schema', json_schema: { name: 'output', strict: true, schema: args.response_schema } }
+        : undefined;
+    // Vision: turn image references (local paths / URLs) into content parts.
+    let prompt = args.prompt;
+    if (args.images && args.images.length > 0) {
+        const parts = [{ type: 'text', text: args.prompt }];
+        for (const ref of args.images) {
+            try {
+                parts.push({ type: 'image_url', image_url: { url: await resolveImageRef(ref) } });
+            }
+            catch (err) {
+                return textResult(errText(err), true);
+            }
+        }
+        prompt = parts;
+    }
+    const backend = deps.backendFor?.(token) ?? new HttpChatBackend({ baseUrl: apiBaseUrl(), token });
+    try {
+        const result = await runChatTurn({ backend, model, prompt, system: args.system, responseFormat });
+        const text = result.structured != null ? JSON.stringify(result.structured, null, 2) : result.content;
+        return textResult(text);
+    }
+    catch (err) {
+        return textResult(errText(err), true);
+    }
+}
+/** Build the MCP server exposing the glbgpt tools. */
+export function buildMcpServer(deps = {}) {
+    const server = new McpServer({ name: 'glbgpt', version: SERVER_VERSION });
+    server.registerTool('glbgpt_chat', {
+        title: 'GlobalGPT chat',
+        description: "Ask GlobalGPT's cheap, fast chat models a single question and get the answer. Optionally " +
+            'set a system prompt, choose a model, attach images for the model to see (local paths or ' +
+            'URLs), or pass a JSON Schema (response_schema) to get structured JSON back. Requires a ' +
+            'prior `glbgpt login` (or the GLBGPT_TOKEN env var).',
+        inputSchema: {
+            prompt: z.string().describe('The question or instruction for the model.'),
+            system: z.string().optional().describe('Optional system prompt to steer the model.'),
+            model: z.string().optional().describe('Chat model id (default gpt-5.6-sol).'),
+            images: z
+                .array(z.string())
+                .optional()
+                .describe('Images for the model to see: local file paths, http(s) URLs, or data URLs.'),
+            response_schema: z
+                .record(z.string(), z.any())
+                .optional()
+                .describe('Optional JSON Schema; when set, the model returns matching structured JSON.'),
+        },
+    }, (args) => runChatTool(args, deps));
+    return server;
+}
+/**
+ * Run the MCP server over stdio. Protocol travels on stdout, so nothing else may write there;
+ * diagnostics go to stderr. Runs until stdin closes.
+ */
+export async function runMcpServer() {
+    const server = buildMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write('glbgpt MCP server ready (stdio). Exposing tool: glbgpt_chat.\n');
+}
+function errText(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=server.js.map

package/dist/src/mcp/server.js.map

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

package/dist/src/media/aiApiClient.d.ts

@@ -0,0 +1,53 @@
+/**
+ * HTTP client for the yanfa generation endpoints (/ai-api/ai/*).
+ *
+ * Response envelopes differ:
+ * - estimatePrice → a raw object `{ sellable, credits, reasonCode, ... }` (no code wrapper).
+ * - submit / task-get → `{ code, message, ...payload }` with `code === 1` on success; `code === 402`
+ *   signals a payment/quota block (with `data.subCode`).
+ */
+export interface EstimateResult {
+    sellable: boolean;
+    credits: number;
+    reasonCode: string | null;
+    platformModelKey?: string | null;
+    platformRobotId?: string | null;
+}
+export interface TaskInfo {
+    taskId: string;
+    status: 'processing' | 'pending_retry' | 'success' | 'failed' | string;
+    outputFileUrl?: string | null;
+    failedReason?: string | null;
+    errorCode?: string | null;
+    mediaType?: number | null;
+    mediaW?: number | null;
+    mediaH?: number | null;
+}
+/** Payment/quota block (HTTP 200 body code 402). subCode: 4002 balance, 4009 PRO, 4010 UNLIMITED, … */
+export declare class PaymentRequiredError extends Error {
+    readonly subCode?: number | undefined;
+    constructor(message: string, subCode?: number | undefined);
+}
+export interface AiApiClientOptions {
+    baseUrl: string;
+    token: string;
+    fetchImpl?: typeof fetch;
+}
+export declare class AiApiClient {
+    private readonly baseUrl;
+    private token;
+    private readonly fetchImpl;
+    private readonly host;
+    constructor(opts: AiApiClientOptions);
+    /** Hot-swap the JWT (used by the in-chat /login re-auth). */
+    setToken(token: string): void;
+    /** Read-only price check (no pre-freeze). */
+    estimatePrice(model: string, params: Record<string, unknown>): Promise<EstimateResult>;
+    /** Submit a generation task; returns the task id. Throws PaymentRequiredError on a 402 body. */
+    submit(submitPath: string, body: Record<string, unknown>): Promise<string>;
+    /** Poll a task's status. */
+    getTask(taskId: string): Promise<TaskInfo>;
+    /** Upload a local image file; returns the hosted URL. */
+    uploadImage(agentId: string, filePath: string): Promise<string>;
+    private postJson;
+}

package/dist/src/media/aiApiClient.js

@@ -0,0 +1,97 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { fetchOrDescribe, hostOf } from '../util/retry.js';
+/** Payment/quota block (HTTP 200 body code 402). subCode: 4002 balance, 4009 PRO, 4010 UNLIMITED, … */
+export class PaymentRequiredError extends Error {
+    subCode;
+    constructor(message, subCode) {
+        super(message);
+        this.subCode = subCode;
+        this.name = 'PaymentRequiredError';
+    }
+}
+export class AiApiClient {
+    baseUrl;
+    token;
+    fetchImpl;
+    host;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/+$/, '');
+        this.token = opts.token;
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+        this.host = hostOf(this.baseUrl);
+    }
+    /** Hot-swap the JWT (used by the in-chat /login re-auth). */
+    setToken(token) {
+        this.token = token;
+    }
+    /** Read-only price check (no pre-freeze). */
+    async estimatePrice(model, params) {
+        const json = await this.postJson('/ai-api/ai/bill/estimatePrice', { productNo: 'glbgpt', model, params });
+        return {
+            sellable: Boolean(json.sellable),
+            credits: Number(json.credits ?? 0),
+            reasonCode: json.reasonCode ?? null,
+            platformModelKey: json.platformModelKey,
+            platformRobotId: json.platformRobotId,
+        };
+    }
+    /** Submit a generation task; returns the task id. Throws PaymentRequiredError on a 402 body. */
+    async submit(submitPath, body) {
+        const json = await this.postJson(submitPath, { ...body, device: { deviceType: 'pc', osplatform: 'cli' } });
+        if (json.code === 402) {
+            throw new PaymentRequiredError(json.message ?? 'Payment required.', json.data?.subCode);
+        }
+        if (typeof json.taskId !== 'string' || !json.taskId) {
+            throw new Error(json.message ?? 'Submit failed: no task id returned.');
+        }
+        return json.taskId;
+    }
+    /** Poll a task's status. */
+    async getTask(taskId) {
+        const json = await this.postJson('/ai-api/ai/task/get', { taskId });
+        const t = json.task;
+        if (!t) {
+            throw new Error(json.message ?? 'Task not found.');
+        }
+        return {
+            taskId,
+            status: t.status,
+            outputFileUrl: t.outputFileUrl,
+            failedReason: t.failedReasonShort ?? t.failedReasonRaw ?? t.failedReason,
+            errorCode: t.errorCode,
+            mediaType: t.mediaType,
+            mediaW: t.mediaW,
+            mediaH: t.mediaH,
+        };
+    }
+    /** Upload a local image file; returns the hosted URL. */
+    async uploadImage(agentId, filePath) {
+        const buf = await fs.readFile(filePath);
+        const form = new FormData();
+        form.append('agentId', agentId);
+        form.append('files', new Blob([buf]), path.basename(filePath));
+        const res = await fetchOrDescribe(this.fetchImpl, `${this.baseUrl}/ai-api/ai/storage/upload`, { method: 'POST', headers: { Authorization: `Bearer ${this.token}` }, body: form }, this.host);
+        const json = await res.json();
+        const url = json?.files?.[0]?.url;
+        if (typeof url !== 'string' || !url) {
+            throw new Error(json?.message ?? `Upload failed for ${filePath}.`);
+        }
+        return url;
+    }
+    async postJson(pathname, body) {
+        const res = await fetchOrDescribe(this.fetchImpl, `${this.baseUrl}${pathname}`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${this.token}` },
+            body: JSON.stringify(body),
+        }, this.host);
+        const text = await res.text();
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            throw new Error(`Unexpected response from ${pathname}: ${text.slice(0, 200) || `HTTP ${res.status}`}`);
+        }
+    }
+}
+//# sourceMappingURL=aiApiClient.js.map

package/dist/src/media/aiApiClient.js.map

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

package/dist/src/media/errors.d.ts

@@ -0,0 +1,7 @@
+import { PaymentRequiredError } from './aiApiClient.js';
+/** A 402 payment/quota block raised at submit time. */
+export declare function describePaymentRequired(err: PaymentRequiredError): string;
+/** An estimate that came back not sellable, keyed by reasonCode. */
+export declare function describeNotSellable(reasonCode: string | null | undefined): string;
+/** A failed generation task, classifying the structured errorCode and preserving the raw reason. */
+export declare function describeTaskFailure(errorCode?: string | null, failedReason?: string | null): string;

package/dist/src/media/errors.js

@@ -0,0 +1,70 @@
+/**
+ * Human-readable, actionable messages for media generation failures.
+ *
+ * Mappings have a basis in the backend contract (verified 2026-07-15):
+ * - 402 subCodes are set in GlbgptLifeCycleService.fillInsufficientSubCode.
+ * - estimate reasonCodes come from the bill service (insufficient_funds / invalid_user_or_model).
+ * - task errorCodes are freeform-prefixed (ANYWHERE_CONTENT_REJECTED, ANYWHERE_INSUFFICIENT_CREDITS,
+ *   ANYWHERE_INPUT_DOWNLOAD_FAILED, ANYWHERE_PROVIDER_ERROR, ...), so they are classified by keyword
+ *   rather than exact match, and the raw reason is preserved when it adds detail.
+ */
+const TOP_UP = 'Top up at glbgpt.com to continue.';
+/** A 402 payment/quota block raised at submit time. */
+export function describePaymentRequired(err) {
+    switch (err.subCode) {
+        case 4002:
+            return `Insufficient credit balance. ${TOP_UP}`;
+        case 4003:
+            return `Your plan's quota is used up for the current period; a new plan starts soon.${detail(err.message)}`;
+        case 4004:
+            return `Your plan isn't active for this period yet.${detail(err.message)}`;
+        case 4009:
+            return 'This model requires a PRO plan. Upgrade at glbgpt.com.';
+        case 4010:
+            return 'This model requires an Unlimited plan. Upgrade at glbgpt.com.';
+        default:
+            return err.message?.trim() || 'Payment or plan requirement not met.';
+    }
+}
+/** An estimate that came back not sellable, keyed by reasonCode. */
+export function describeNotSellable(reasonCode) {
+    switch (reasonCode) {
+        case 'insufficient_funds':
+            return `Insufficient credit balance. ${TOP_UP}`;
+        case 'invalid_user_or_model':
+            return "This model isn't available for your account.";
+        default:
+            return `Not available for this account or these parameters${reasonCode ? ` (${reasonCode})` : ''}.`;
+    }
+}
+/** A failed generation task, classifying the structured errorCode and preserving the raw reason. */
+export function describeTaskFailure(errorCode, failedReason) {
+    const code = (errorCode ?? '').toUpperCase();
+    const raw = failedReason?.trim() || '';
+    if (/CONTENT|REJECT|MODERAT|SAFETY|POLICY|NSFW/.test(code)) {
+        return `Rejected by content safety — try rephrasing the prompt or using a different reference image.${detail(raw)}`;
+    }
+    if (/INSUFFICIENT|CREDIT|BALANCE|FUNDS/.test(code)) {
+        return `Insufficient credit balance. ${TOP_UP}`;
+    }
+    if (/DOWNLOAD|INPUT/.test(code)) {
+        return `A reference image or URL couldn't be downloaded — make sure it is publicly accessible.${detail(raw)}`;
+    }
+    if (/PROVIDER|UPSTREAM/.test(code)) {
+        return `The model provider returned an error — please try again in a moment.${detail(raw)}`;
+    }
+    if (/NETWORK|TIMEOUT/.test(code)) {
+        return `The generation timed out or hit a network error — please try again.${detail(raw)}`;
+    }
+    // No recognized code: fall back to the backend's own reason (never fabricate).
+    return raw || 'Generation failed.';
+}
+/** Append a truncated raw detail in parentheses when it adds information. */
+function detail(raw) {
+    const text = raw?.trim();
+    if (!text)
+        return '';
+    const clipped = text.length > 160 ? `${text.slice(0, 159)}…` : text;
+    return ` (${clipped})`;
+}
+//# sourceMappingURL=errors.js.map