@glbgpt/cli 0.1.0-test.1

package/dist/src/media/taskLedger.js

@@ -0,0 +1,44 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { configDir } from '../config/paths.js';
+/** Append-only local task ledger at ~/.config/glbgpt/tasks.jsonl. */
+export class TaskLedger {
+    file;
+    constructor(file = path.join(configDir(), 'tasks.jsonl')) {
+        this.file = file;
+    }
+    async append(rec) {
+        await fs.mkdir(path.dirname(this.file), { recursive: true });
+        await fs.appendFile(this.file, JSON.stringify(rec) + '\n', 'utf8');
+    }
+    async list(limit = 20) {
+        let text;
+        try {
+            text = await fs.readFile(this.file, 'utf8');
+        }
+        catch {
+            return [];
+        }
+        const records = text
+            .split('\n')
+            .filter((l) => l.trim())
+            .map((l) => {
+            try {
+                return JSON.parse(l);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((r) => r !== null);
+        return records.reverse().slice(0, limit);
+    }
+    /** Resolve "last" or a task id to a record. */
+    async resolve(idOrLast) {
+        const records = await this.list(1000);
+        if (idOrLast === 'last')
+            return records[0] ?? null;
+        return records.find((r) => r.taskId === idOrLast) ?? null;
+    }
+}
+//# sourceMappingURL=taskLedger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"taskLedger.js","sourceRoot":"","sources":["../../../src/media/taskLedger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAW/C,qEAAqE;AACrE,MAAM,OAAO,UAAU;IACQ;IAA7B,YAA6B,OAAe,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,aAAa,CAAC;QAApD,SAAI,GAAJ,IAAI,CAAgD;IAAG,CAAC;IAErF,KAAK,CAAC,MAAM,CAAC,GAAe;QAC1B,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE;QACnB,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,OAAO,GAAG,IAAI;aACjB,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACvB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAe,CAAC;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAC9C,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,MAAM;YAAE,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QACnD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC;IAC5D,CAAC;CACF"}

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

@@ -0,0 +1,52 @@
+import type { AiApiClient } from './aiApiClient.js';
+export type TaskEvent = {
+    type: 'task_progress';
+    taskId: string;
+    elapsedMs: number;
+    status: string;
+} | {
+    type: 'task_done';
+    taskId: string;
+    localPath: string;
+    outputUrl: string;
+    mediaType?: number | null;
+} | {
+    type: 'task_failed';
+    taskId: string;
+    reason: string;
+};
+export interface TaskMeta {
+    model?: string;
+    prompt?: string;
+}
+export interface TaskManagerOptions {
+    outputDir: string;
+    pollMs?: number;
+    timeoutMs?: number;
+    /** Injectable downloader (url → destPath). Defaults to fetch + write. */
+    download?: (url: string, destPath: string) => Promise<void>;
+    /** Injectable sleep (for tests). */
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * Polls generation tasks to completion and downloads results.
+ *
+ * `register(taskId)` returns a promise that resolves when the task finishes (done/failed/timeout) and
+ * also emits progress/done/failed events to subscribers, so the top-level command can await while the
+ * TUI reacts to the same stream.
+ */
+export declare class TaskManager {
+    private readonly client;
+    private readonly opts;
+    private readonly subscribers;
+    private readonly pollMs;
+    private readonly timeoutMs;
+    private readonly download;
+    private readonly sleep;
+    constructor(client: AiApiClient, opts: TaskManagerOptions);
+    subscribe(cb: (e: TaskEvent) => void): () => void;
+    /** Poll a task to completion, downloading the result on success. Resolves with the terminal event. */
+    register(taskId: string, meta?: TaskMeta): Promise<TaskEvent>;
+    private downloadResult;
+    private emit;
+}

package/dist/src/media/taskManager.js

@@ -0,0 +1,130 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { describeTaskFailure } from './errors.js';
+/**
+ * Polls generation tasks to completion and downloads results.
+ *
+ * `register(taskId)` returns a promise that resolves when the task finishes (done/failed/timeout) and
+ * also emits progress/done/failed events to subscribers, so the top-level command can await while the
+ * TUI reacts to the same stream.
+ */
+export class TaskManager {
+    client;
+    opts;
+    subscribers = new Set();
+    pollMs;
+    timeoutMs;
+    download;
+    sleep;
+    constructor(client, opts) {
+        this.client = client;
+        this.opts = opts;
+        this.pollMs = opts.pollMs ?? 2500;
+        this.timeoutMs = opts.timeoutMs ?? 12 * 60_000;
+        this.download = opts.download ?? defaultDownload;
+        this.sleep = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+    }
+    subscribe(cb) {
+        this.subscribers.add(cb);
+        return () => this.subscribers.delete(cb);
+    }
+    /** Poll a task to completion, downloading the result on success. Resolves with the terminal event. */
+    async register(taskId, meta = {}) {
+        const start = Date.now();
+        for (;;) {
+            let info;
+            try {
+                info = await this.client.getTask(taskId);
+            }
+            catch (err) {
+                return this.emit({ type: 'task_failed', taskId, reason: err instanceof Error ? err.message : String(err) });
+            }
+            if (info.status === 'success') {
+                if (!info.outputFileUrl) {
+                    return this.emit({ type: 'task_failed', taskId, reason: 'Task succeeded but returned no output URL.' });
+                }
+                try {
+                    const localPath = await this.downloadResult(taskId, info, meta);
+                    return this.emit({ type: 'task_done', taskId, localPath, outputUrl: info.outputFileUrl, mediaType: info.mediaType });
+                }
+                catch (err) {
+                    // A download failure must never reject register() (that would crash the TUI's fire-and-forget path).
+                    return this.emit({ type: 'task_failed', taskId, reason: `Download failed: ${err instanceof Error ? err.message : String(err)}` });
+                }
+            }
+            if (info.status === 'failed') {
+                return this.emit({ type: 'task_failed', taskId, reason: describeTaskFailure(info.errorCode, info.failedReason) });
+            }
+            // processing / pending_retry → keep waiting
+            const elapsedMs = Date.now() - start;
+            this.emit({ type: 'task_progress', taskId, elapsedMs, status: info.status });
+            if (elapsedMs >= this.timeoutMs) {
+                return this.emit({ type: 'task_failed', taskId, reason: 'Timed out waiting for the task.' });
+            }
+            await this.sleep(this.pollMs);
+        }
+    }
+    async downloadResult(taskId, info, meta) {
+        await fs.mkdir(this.opts.outputDir, { recursive: true });
+        const ext = extFor(info.outputFileUrl, info.mediaType);
+        const base = `glbgpt-${meta.model ?? 'image'}-${taskId.slice(0, 8)}`;
+        const dest = path.join(this.opts.outputDir, `${base}.${ext}`);
+        await this.download(info.outputFileUrl, dest);
+        // The CDN URL often lacks a real extension; correct it from the file's magic bytes.
+        const sniffed = await sniffExt(dest);
+        if (sniffed && sniffed !== ext) {
+            const corrected = path.join(this.opts.outputDir, `${base}.${sniffed}`);
+            await fs.rename(dest, corrected);
+            return corrected;
+        }
+        return dest;
+    }
+    emit(e) {
+        for (const cb of this.subscribers)
+            cb(e);
+        return e;
+    }
+}
+function extFor(url, mediaType) {
+    const m = url.split('?')[0].match(/\.([a-z0-9]{2,4})$/i);
+    if (m)
+        return m[1].toLowerCase();
+    return mediaType === 2 ? 'mp4' : 'png';
+}
+/** Detect a media extension from a file's magic bytes; undefined if unrecognized. */
+async function sniffExt(filePath) {
+    let buf;
+    try {
+        const fh = await fs.open(filePath, 'r');
+        try {
+            const b = Buffer.alloc(16);
+            const { bytesRead } = await fh.read(b, 0, 16, 0);
+            buf = b.subarray(0, bytesRead);
+        }
+        finally {
+            await fh.close();
+        }
+    }
+    catch {
+        return undefined;
+    }
+    if (buf.length >= 3 && buf[0] === 0xff && buf[1] === 0xd8 && buf[2] === 0xff)
+        return 'jpg';
+    if (buf.length >= 8 && buf[0] === 0x89 && buf[1] === 0x50 && buf[2] === 0x4e && buf[3] === 0x47)
+        return 'png';
+    if (buf.length >= 3 && buf[0] === 0x47 && buf[1] === 0x49 && buf[2] === 0x46)
+        return 'gif';
+    if (buf.length >= 12 && buf.toString('ascii', 0, 4) === 'RIFF' && buf.toString('ascii', 8, 12) === 'WEBP')
+        return 'webp';
+    if (buf.length >= 12 && buf.toString('ascii', 4, 8) === 'ftyp')
+        return 'mp4';
+    return undefined;
+}
+async function defaultDownload(url, destPath) {
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`Download failed (HTTP ${res.status}) for ${url}`);
+    const buf = Buffer.from(await res.arrayBuffer());
+    await fs.writeFile(destPath, buf);
+}
+//# sourceMappingURL=taskManager.js.map

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

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

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

@@ -0,0 +1,80 @@
+/**
+ * Unified media generation types.
+ *
+ * Users and the model only ever see the canonical param names here; each model's per-endpoint
+ * heterogeneity lives behind {@link ModelSpec.buildBody}. Parameter values are validated against the
+ * model's declared support (competitor-style: a clear error with allowed values), not silently clamped.
+ */
+/** Canonical image-generation params (already normalized; images are uploaded URLs). */
+export interface MediaGenParams {
+    prompt: string;
+    /** Canonical aspect ratio, e.g. "16:9" or "Auto". Validated per model. */
+    aspectRatio?: string;
+    /** Canonical image resolution tier: 0.5K/1K/2K/4K. Validated per model. */
+    resolution?: string;
+    /** Reference/source image URLs (local files are uploaded before this point). */
+    images?: string[];
+    /** Batch count. */
+    n?: number;
+    seed?: number;
+    negativePrompt?: string;
+    /** img2img strength 0..1. */
+    strength?: number;
+    watermark?: boolean;
+    /** Video length in seconds. */
+    duration?: number;
+    /** Generate a soundtrack (kling sound / seedance generate_audio / wan audio toggle). */
+    generateAudio?: boolean;
+    /** First frame (image-to-video). */
+    startImage?: string;
+    /** Last frame. */
+    endImage?: string;
+}
+/** What a model supports — drives `model show` and local validation. */
+export interface ModelParamSupport {
+    aspectRatios?: string[];
+    resolutions?: string[];
+    /** Resolution used when the user omits it (some estimate keys require a resolution). */
+    defaultResolution?: string;
+    maxImages?: number;
+    supportsSeed?: boolean;
+    supportsNegativePrompt?: boolean;
+    supportsStrength?: boolean;
+    supportsWatermark?: boolean;
+    /** Max batch count (image n). */
+    maxCount?: number;
+    /** Supported durations in seconds (as strings, matching the model's set). */
+    durations?: string[];
+    /** Duration used when omitted (video estimate keys often depend on it). */
+    defaultDuration?: number;
+    supportsAudio?: boolean;
+    supportsStartEndFrame?: boolean;
+    /** The model cannot run text-only: a source image is required (e.g. grok-imagine-video-1.5). */
+    requiresImage?: boolean;
+}
+/** A curated model entry: display + routing + support + the canonical→endpoint mapping. */
+export interface ModelSpec {
+    id: string;
+    displayName: string;
+    type: 'image' | 'video';
+    /** yanfa numeric agent id. */
+    agentId: string;
+    /** Submit endpoint path under the API base. */
+    submitPath: string;
+    /** Model string for POST /ai-api/ai/bill/estimatePrice. */
+    estimateModel: string;
+    /**
+     * Param-dependent estimate id override (e.g. t2v vs i2v catalog ids). When present it wins
+     * over {@link estimateModel} — estimate and submit MUST price the same variant.
+     */
+    estimateModelFor?(params: MediaGenParams): string;
+    support: ModelParamSupport;
+    /** Map canonical params to this endpoint's submit body. */
+    buildBody(params: MediaGenParams): Record<string, unknown>;
+    /** Build the params object for estimatePrice (canonical → estimate params). */
+    buildEstimateParams(params: MediaGenParams): Record<string, unknown>;
+}
+/** Thrown when a param is not supported by the chosen model; message lists allowed values. */
+export declare class ParamValidationError extends Error {
+    constructor(message: string);
+}

package/dist/src/media/types.js

@@ -0,0 +1,15 @@
+/**
+ * Unified media generation types.
+ *
+ * Users and the model only ever see the canonical param names here; each model's per-endpoint
+ * heterogeneity lives behind {@link ModelSpec.buildBody}. Parameter values are validated against the
+ * model's declared support (competitor-style: a clear error with allowed values), not silently clamped.
+ */
+/** Thrown when a param is not supported by the chosen model; message lists allowed values. */
+export class ParamValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ParamValidationError';
+    }
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/media/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8EH,8FAA8F;AAC9F,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/dist/src/tui/App.d.ts

@@ -0,0 +1,34 @@
+import React from 'react';
+import type { ChatController } from './chatController.js';
+import type { ConfirmationBridge } from './confirmationBridge.js';
+import type { Session } from '../core/session.js';
+import type { SessionSummary } from '../core/sessionStore.js';
+import type { InputHistory } from './inputHistory.js';
+/** Session loading hooks for `/resume` (wired by run.tsx; absent in minimal test setups). */
+export interface SessionPickerDeps {
+    listSessions: () => Promise<SessionSummary[]>;
+    loadSession: (id: string) => Promise<{
+        session: Session;
+        timeline?: unknown[];
+    } | null>;
+}
+/**
+ * Chat TUI (phase 1). A thin view over {@link ChatController}: it renders the timeline,
+ * handles slash commands and the `/model` selector, and forwards user input to the
+ * controller. All engine behavior (turn loop, tools) lives in core.
+ *
+ * All user-facing text is English; the model replies in the user's own language.
+ */
+export declare function App({ controller, confirmationBridge, sessionPicker, firstRun, fetchAccountLine, inputHistory, readClipboard, }: {
+    controller: ChatController;
+    confirmationBridge?: ConfirmationBridge;
+    sessionPicker?: SessionPickerDeps;
+    /** Show the one-time command navigation (no prior sessions on disk). */
+    firstRun?: boolean;
+    /** Async plan/credits line for the welcome block (best-effort). */
+    fetchAccountLine?: () => Promise<string | null>;
+    /** Persistent ↑/↓ input recall (wired by run.tsx). */
+    inputHistory?: InputHistory;
+    /** Clipboard-image reader override (tests). */
+    readClipboard?: () => Promise<string | null>;
+}): React.ReactElement;