@glbgpt/cli 0.1.0-test.1

package/dist/src/util/hyperlink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperlink.js","sourceRoot":"","sources":["../../../src/util/hyperlink.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wFAAwF;AACxF,oFAAoF;AACpF,6EAA6E;AAC7E,MAAM,mBAAmB,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;AAEnH,MAAM,UAAU,kBAAkB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACrE,IAAI,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,eAAe,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACpE,IAAI,mBAAmB,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,IAAI,mBAAmB,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7H,IAAI,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,mCAAmC;IACxG,IAAI,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,CAAC,wBAAwB;IAC7F,IAAI,GAAG,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC,CAAC,mBAAmB;IACpD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,GAAW,EAAE,MAAyB,OAAO,CAAC,GAAG;IACvF,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,WAAW,GAAG,OAAO,IAAI,cAAc,CAAC;AACjD,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,OAAO,CAAC,SAAiB;IACvC,OAAO,UAAU,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;AAC/D,CAAC"}

package/dist/src/util/imageRef.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Resolve an image reference (exec --image, MCP image input, TUI @path) into a URL the
+ * chat API accepts as an image_url part:
+ * - http(s) and data: URLs pass through untouched (the backend/upstream fetches them);
+ * - anything else is treated as a local file and inlined as a data URL
+ *   (png/jpg/gif/webp only, ≤ 8MB).
+ *
+ * Throws ImageRefError with a user-facing message on anything unusable.
+ */
+export declare class ImageRefError extends Error {
+}
+export declare const MAX_IMAGE_BYTES: number;
+/** File extensions we treat as attachable images (single source — popup/tokenizer/clipboard agree). */
+export declare const IMAGE_EXT: RegExp;
+export declare function resolveImageRef(ref: string, readFile?: (p: string) => Promise<Buffer>): Promise<string>;

package/dist/src/util/imageRef.js

@@ -0,0 +1,46 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+/**
+ * Resolve an image reference (exec --image, MCP image input, TUI @path) into a URL the
+ * chat API accepts as an image_url part:
+ * - http(s) and data: URLs pass through untouched (the backend/upstream fetches them);
+ * - anything else is treated as a local file and inlined as a data URL
+ *   (png/jpg/gif/webp only, ≤ 8MB).
+ *
+ * Throws ImageRefError with a user-facing message on anything unusable.
+ */
+export class ImageRefError extends Error {
+}
+export const MAX_IMAGE_BYTES = 8 * 1024 * 1024;
+/** File extensions we treat as attachable images (single source — popup/tokenizer/clipboard agree). */
+export const IMAGE_EXT = /\.(png|jpe?g|gif|webp)$/i;
+const MIME = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+};
+export async function resolveImageRef(ref, readFile = (p) => fs.readFile(p)) {
+    if (/^(https?:|data:)/i.test(ref))
+        return ref;
+    const ext = path.extname(ref).toLowerCase();
+    const mime = MIME[ext];
+    if (!mime) {
+        throw new ImageRefError(`Cannot attach ${ref}: only png/jpg/gif/webp images are supported.`);
+    }
+    const filePath = ref.startsWith('~/') ? path.join(os.homedir(), ref.slice(2)) : ref;
+    let data;
+    try {
+        data = await readFile(filePath);
+    }
+    catch {
+        throw new ImageRefError(`Cannot attach ${ref}: file not found or unreadable.`);
+    }
+    if (data.length === 0 || data.length > MAX_IMAGE_BYTES) {
+        throw new ImageRefError(`Cannot attach ${ref}: file is empty or larger than 8MB.`);
+    }
+    return `data:${mime};base64,${data.toString('base64')}`;
+}
+//# sourceMappingURL=imageRef.js.map

package/dist/src/util/imageRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageRef.js","sourceRoot":"","sources":["../../../src/util/imageRef.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB;;;;;;;;GAQG;AAEH,MAAM,OAAO,aAAc,SAAQ,KAAK;CAAG;AAE3C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/C,uGAAuG;AACvG,MAAM,CAAC,MAAM,SAAS,GAAG,0BAA0B,CAAC;AAEpD,MAAM,IAAI,GAA2B;IACnC,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;CACtB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAW,EACX,WAA2C,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEhE,IAAI,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAE9C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,aAAa,CAAC,iBAAiB,GAAG,+CAA+C,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACpF,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,aAAa,CAAC,iBAAiB,GAAG,iCAAiC,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;QACvD,MAAM,IAAI,aAAa,CAAC,iBAAiB,GAAG,qCAAqC,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,QAAQ,IAAI,WAAW,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC1D,CAAC"}

package/dist/src/util/inlineImage.d.ts

@@ -0,0 +1,13 @@
+/** Whether the attached terminal understands OSC 1337 inline images. */
+export declare function supportsInlineImages(env?: NodeJS.ProcessEnv): boolean;
+/** Build the OSC 1337 escape sequence for one image buffer. */
+export declare function inlineImageSequence(data: Buffer, name: string): string;
+/**
+ * Print an inline preview of a downloaded file to stderr when everything lines up
+ * (supported terminal, TTY, image extension, sane size). Never throws.
+ */
+export declare function maybePrintInlinePreview(filePath: string, opts?: {
+    env?: NodeJS.ProcessEnv;
+    write?: (s: string) => void;
+    isTty?: boolean;
+}): Promise<boolean>;

package/dist/src/util/inlineImage.js

@@ -0,0 +1,56 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+/**
+ * Inline image previews via the iTerm2 OSC 1337 protocol (also spoken by WezTerm).
+ *
+ * Used by the top-level image/video/task commands after a download: the escape sequence goes
+ * to STDERR so stdout keeps its machine-readable contract (the local path only). Anything
+ * unsupported — other terminals, non-image files, huge files, non-TTY stderr — degrades to
+ * printing nothing extra.
+ */
+const IMAGE_EXTS = new Set(['.png', '.jpg', '.jpeg', '.gif', '.webp']);
+/** Skip inlining beyond this size — encoding + rendering a huge raster stalls the terminal. */
+const MAX_INLINE_BYTES = 5 * 1024 * 1024;
+/** Rendered height in text rows. */
+const PREVIEW_ROWS = 12;
+/** Whether the attached terminal understands OSC 1337 inline images. */
+export function supportsInlineImages(env = process.env) {
+    const program = env.TERM_PROGRAM ?? '';
+    return program === 'iTerm.app' || program === 'WezTerm';
+}
+/** Build the OSC 1337 escape sequence for one image buffer. */
+export function inlineImageSequence(data, name) {
+    const args = [
+        `name=${Buffer.from(name).toString('base64')}`,
+        `size=${data.length}`,
+        'inline=1',
+        `height=${PREVIEW_ROWS}`,
+        'preserveAspectRatio=1',
+    ].join(';');
+    return `\x1b]1337;File=${args}:${data.toString('base64')}\x07`;
+}
+/**
+ * Print an inline preview of a downloaded file to stderr when everything lines up
+ * (supported terminal, TTY, image extension, sane size). Never throws.
+ */
+export async function maybePrintInlinePreview(filePath, opts = {}) {
+    const env = opts.env ?? process.env;
+    const isTty = opts.isTty ?? process.stderr.isTTY === true;
+    const write = opts.write ?? ((s) => process.stderr.write(s));
+    if (!isTty || !supportsInlineImages(env))
+        return false;
+    if (!IMAGE_EXTS.has(path.extname(filePath).toLowerCase()))
+        return false;
+    try {
+        const stat = await fs.stat(filePath);
+        if (stat.size === 0 || stat.size > MAX_INLINE_BYTES)
+            return false;
+        const data = await fs.readFile(filePath);
+        write(`${inlineImageSequence(data, path.basename(filePath))}\n`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=inlineImage.js.map

package/dist/src/util/inlineImage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlineImage.js","sourceRoot":"","sources":["../../../src/util/inlineImage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;GAOG;AAEH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACvE,+FAA+F;AAC/F,MAAM,gBAAgB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AACzC,oCAAoC;AACpC,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB,wEAAwE;AACxE,MAAM,UAAU,oBAAoB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACvE,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;IACvC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,SAAS,CAAC;AAC1D,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,IAAY;IAC5D,MAAM,IAAI,GAAG;QACX,QAAQ,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAC9C,QAAQ,IAAI,CAAC,MAAM,EAAE;QACrB,UAAU;QACV,UAAU,YAAY,EAAE;QACxB,uBAAuB;KACxB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACZ,OAAO,kBAAkB,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,QAAgB,EAChB,OAAkF,EAAE;IAEpF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAErE,IAAI,CAAC,KAAK,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACvD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IACxE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,gBAAgB;YAAE,OAAO,KAAK,CAAC;QAClE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,KAAK,CAAC,GAAG,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/src/util/openBrowser.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Open a URL in the user's default browser. Best-effort and non-blocking; if it fails,
+ * the caller should still print the URL so the user can open it manually.
+ */
+export declare function openBrowser(url: string): void;

package/dist/src/util/openBrowser.js

@@ -0,0 +1,23 @@
+import { spawn } from 'node:child_process';
+/**
+ * Open a URL in the user's default browser. Best-effort and non-blocking; if it fails,
+ * the caller should still print the URL so the user can open it manually.
+ */
+export function openBrowser(url) {
+    const platform = process.platform;
+    const [cmd, args] = platform === 'darwin'
+        ? ['open', [url]]
+        : platform === 'win32'
+            ? // `start "" "<url>"`: the quoted title + quoted URL keep `&` from truncating the command.
+                ['cmd', ['/c', 'start', '""', `"${url}"`]]
+            : ['xdg-open', [url]];
+    try {
+        const child = spawn(cmd, args, { stdio: 'ignore', detached: true, windowsVerbatimArguments: platform === 'win32' });
+        child.on('error', () => { });
+        child.unref();
+    }
+    catch {
+        // Ignore; the caller prints the URL as a fallback.
+    }
+}
+//# sourceMappingURL=openBrowser.js.map

package/dist/src/util/openBrowser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openBrowser.js","sourceRoot":"","sources":["../../../src/util/openBrowser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GACf,QAAQ,KAAK,QAAQ;QACnB,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC,CAAC,QAAQ,KAAK,OAAO;YACpB,CAAC,CAAC,0FAA0F;gBAC1F,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;YAC5C,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,wBAAwB,EAAE,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;QACpH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC5B,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;IACrD,CAAC;AACH,CAAC"}

package/dist/src/util/retry.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Bounded retry with exponential backoff, for transient network failures.
+ *
+ * Safety: callers must only wrap operations that are safe to repeat. In particular a streaming
+ * request may be retried only *before* the first response byte is consumed — once bytes flow,
+ * replaying the call would double-bill. Non-idempotent writes (e.g. a media `submit`) must not be
+ * wrapped at all.
+ */
+export interface RetryOptions {
+    /** Max retries after the first attempt (default 3 → up to 4 total attempts). */
+    retries?: number;
+    /** Base backoff in ms; attempt n waits ~base * 2^n with jitter (default 300). */
+    baseMs?: number;
+    /** Injected sleep (tests pass a no-op). */
+    sleep?: (ms: number) => Promise<void>;
+    /** Injected jitter factor in [0,1) (tests pass a constant). Default random. */
+    jitter?: () => number;
+    /** Retry a returned value (e.g. an HTTP 502 Response). Throws are always retried. */
+    isRetryableResult?: (result: unknown) => boolean;
+    /** Which thrown errors to retry (default: isTransientNetworkError). Lets callers exclude user aborts. */
+    isRetryableError?: (err: unknown) => boolean;
+}
+/**
+ * Run `fn`, retrying on a thrown transient error or a retryable result, with exponential backoff.
+ * The last attempt's value is returned (or its error thrown) without further retries.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, opts?: RetryOptions): Promise<T>;
+/**
+ * Whether a thrown error is a transient, connection-level network failure that is safe to retry
+ * (before any response is consumed): DNS/TLS/connection resets, aborts/timeouts, and undici's
+ * generic `fetch failed` TypeError whose cause carries a network errno.
+ */
+export declare function isTransientNetworkError(err: unknown): boolean;
+/** A friendly, actionable description of a network failure, including the host and retry count. */
+export declare function describeNetworkError(err: unknown, host: string, retries: number): string;
+/** Host portion of a base URL, for user-facing error messages (falls back to the raw string). */
+export declare function hostOf(baseUrl: string): string;
+/**
+ * Perform a fetch, translating a transient network throw into a friendly, host-qualified message.
+ * Does NOT retry — use {@link withRetry} for that. For one-shot/idempotent calls that only need a
+ * readable error instead of a bare `fetch failed`.
+ */
+export declare function fetchOrDescribe(fetchImpl: typeof fetch, url: string, init: RequestInit, host: string): Promise<Response>;

package/dist/src/util/retry.js

@@ -0,0 +1,116 @@
+/**
+ * Bounded retry with exponential backoff, for transient network failures.
+ *
+ * Safety: callers must only wrap operations that are safe to repeat. In particular a streaming
+ * request may be retried only *before* the first response byte is consumed — once bytes flow,
+ * replaying the call would double-bill. Non-idempotent writes (e.g. a media `submit`) must not be
+ * wrapped at all.
+ */
+const defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/**
+ * Run `fn`, retrying on a thrown transient error or a retryable result, with exponential backoff.
+ * The last attempt's value is returned (or its error thrown) without further retries.
+ */
+export async function withRetry(fn, opts = {}) {
+    const retries = opts.retries ?? 3;
+    const baseMs = opts.baseMs ?? 300;
+    const sleep = opts.sleep ?? defaultSleep;
+    const jitter = opts.jitter ?? Math.random;
+    const isRetryableResult = opts.isRetryableResult ?? (() => false);
+    const isRetryableError = opts.isRetryableError ?? isTransientNetworkError;
+    let lastError;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        try {
+            const result = await fn();
+            if (attempt < retries && isRetryableResult(result)) {
+                await sleep(backoffMs(baseMs, attempt, jitter));
+                continue;
+            }
+            return result;
+        }
+        catch (err) {
+            lastError = err;
+            if (attempt < retries && isRetryableError(err)) {
+                await sleep(backoffMs(baseMs, attempt, jitter));
+                continue;
+            }
+            throw err;
+        }
+    }
+    // Unreachable (the loop returns or throws), but satisfies the type checker.
+    throw lastError;
+}
+function backoffMs(baseMs, attempt, jitter) {
+    const exp = baseMs * 2 ** attempt;
+    return Math.round(exp * (1 + jitter()));
+}
+/**
+ * Whether a thrown error is a transient, connection-level network failure that is safe to retry
+ * (before any response is consumed): DNS/TLS/connection resets, aborts/timeouts, and undici's
+ * generic `fetch failed` TypeError whose cause carries a network errno.
+ */
+export function isTransientNetworkError(err) {
+    if (!(err instanceof Error))
+        return false;
+    if (err.name === 'AbortError' || err.name === 'TimeoutError')
+        return true;
+    const code = networkErrno(err);
+    if (code && TRANSIENT_CODES.has(code))
+        return true;
+    // undici wraps low-level failures as a TypeError "fetch failed" with a `.cause`.
+    return err.message === 'fetch failed';
+}
+const TRANSIENT_CODES = new Set([
+    'ECONNRESET',
+    'ECONNREFUSED',
+    'ENOTFOUND',
+    'EAI_AGAIN',
+    'ETIMEDOUT',
+    'EPIPE',
+    'ECONNABORTED',
+    'UND_ERR_CONNECT_TIMEOUT',
+    'UND_ERR_SOCKET',
+]);
+function networkErrno(err) {
+    const withCode = err;
+    if (typeof withCode.code === 'string')
+        return withCode.code;
+    const cause = withCode.cause;
+    if (cause instanceof Error)
+        return networkErrno(cause);
+    if (cause && typeof cause.code === 'string') {
+        return cause.code;
+    }
+    return undefined;
+}
+/** A friendly, actionable description of a network failure, including the host and retry count. */
+export function describeNetworkError(err, host, retries) {
+    const detail = err instanceof Error ? networkErrno(err) ?? err.message : String(err);
+    const tries = retries > 0 ? ` (after ${retries} ${retries === 1 ? 'retry' : 'retries'})` : '';
+    return `Network error reaching ${host}: ${detail}${tries}. Check your connection and try again.`;
+}
+/** Host portion of a base URL, for user-facing error messages (falls back to the raw string). */
+export function hostOf(baseUrl) {
+    try {
+        return new URL(baseUrl).host;
+    }
+    catch {
+        return baseUrl;
+    }
+}
+/**
+ * Perform a fetch, translating a transient network throw into a friendly, host-qualified message.
+ * Does NOT retry — use {@link withRetry} for that. For one-shot/idempotent calls that only need a
+ * readable error instead of a bare `fetch failed`.
+ */
+export async function fetchOrDescribe(fetchImpl, url, init, host) {
+    try {
+        return await fetchImpl(url, init);
+    }
+    catch (err) {
+        if (isTransientNetworkError(err))
+            throw new Error(describeNetworkError(err, host, 0));
+        throw err;
+    }
+}
+//# sourceMappingURL=retry.js.map

package/dist/src/util/retry.js.map

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

package/dist/src/version.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The CLI version, read from package.json at runtime (npm always ships package.json at the
+ * tarball root, so `../../package.json` resolves from dist/src/*). Single source — bump the
+ * version in package.json only.
+ */
+export declare const VERSION: string;

package/dist/src/version.js

@@ -0,0 +1,16 @@
+import { readFileSync } from 'node:fs';
+/**
+ * The CLI version, read from package.json at runtime (npm always ships package.json at the
+ * tarball root, so `../../package.json` resolves from dist/src/*). Single source — bump the
+ * version in package.json only.
+ */
+export const VERSION = (() => {
+    try {
+        const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
+        return typeof pkg.version === 'string' ? pkg.version : '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+})();
+//# sourceMappingURL=version.js.map

package/dist/src/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAW,CAAC,GAAG,EAAE;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7F,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC,CAAC,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@glbgpt/cli",
+  "version": "0.1.0-test.1",
+  "description": "GlobalGPT 官方终端客户端（对话 TUI / 图片视频生成 / exec）",
+  "type": "module",
+  "bin": {
+    "glbgpt": "dist/src/index.js",
+    "globalgpt": "dist/src/index.js"
+  },
+  "files": [
+    "dist/src/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "test"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run test && tsc -p tsconfig.build.json",
+    "prepack": "tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "cli-highlight": "^2.1.11",
+    "commander": "^12.1.0",
+    "ink": "^7.1.0",
+    "marked": "^18.0.6",
+    "react": "^19.2.7",
+    "wrap-ansi": "^10.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.2.17",
+    "ink-testing-library": "^4.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  }
+}