thumbnailgpt 1.0.7 → 1.0.9

package/README.md

@@ -15,14 +15,14 @@ Generate, iterate, download, and manage viral, high-CTR YouTube thumbnails direc
 
 ## Highlights
 
-- ⚡ **Zero-Install Execution**: Run any command immediately via `npx thumbnailgpt`.
-- 🎨 **Multi-Resolution Rendering**: Generate in standard **1K** (10 credits), HD **2K** (20 credits), or Ultra-HD **4K** (30 credits).
-- 📐 **Dual Aspect Ratios**: Native support for **16:9** (YouTube standard) and **9:16** (YouTube Shorts / TikTok / Reels).
-- 👤 **Creator Persona Consistency**: Feature your trained creator persona across any generation using `--persona <id>`.
-- 🔄 **Conversational Iteration**: Thread your edits using `--chat <chatId>` to refine text, lighting, facial expression, or background details.
-- 💬 **Interactive Terminal REPL**: Full interactive terminal chat session with live preview links (`thumbnailgpt chat`).
-- 🤖 **Scripting & Automation Ready**: Output raw image URLs with `--url-only` or machine-readable JSON with `--json` for shell pipes, webhooks, and GitHub Actions.
-- 🛡️ **Account Deletion Guardrails**: Enforces production security; destructive deletions are restricted to the web dashboard to prevent accidental loss from automated scripts or autonomous AI agents.
+- **Zero-Install Execution**: Run any command immediately via `npx thumbnailgpt`.
+- **Multi-Resolution Rendering**: Generate in standard **1K**, HD **2K**, or Ultra-HD **4K**.
+- **Dual Aspect Ratios**: Native support for **16:9** (YouTube standard) and **9:16** (YouTube Shorts / TikTok / Reels).
+- **Creator Persona Consistency**: Feature your trained creator persona across any generation using `--persona <id>`.
+- **Conversational Iteration**: Thread your edits using `--chat <chatId>` to refine text, lighting, facial expression, or background details.
+- **Interactive Terminal REPL**: Full interactive terminal chat session with live preview links (`thumbnailgpt chat`).
+- **Scripting & Automation Ready**: Output raw image URLs with `--url-only` or machine-readable JSON with `--json` for shell pipes, webhooks, and GitHub Actions.
+- **Account Deletion Guardrails**: Enforces production security; destructive deletions are restricted to the web dashboard to prevent accidental loss from automated scripts or autonomous AI agents.
 
 ---
 
@@ -62,20 +62,16 @@ npx thumbnailgpt login
 npx thumbnailgpt login --key tgpt_live_YOUR_API_KEY
 ```
 
-### 2. Verify Your Account & Credit Balance
+### 2. Verify Your Account Status
 ```bash
 npx thumbnailgpt whoami
 ```
 *Output:*
 ```text
-  Logged in as:       user@example.com
-  Subscription:       active
-  Available Credits:  583 credits
-
-  Pricing Tiers:
-    1K (Standard):    10 credits
-    2K (HD):          20 credits
-    4K (Ultra HD):    30 credits
+  ThumbnailGPT Account
+  Account:            user@example.com
+  Plan Status:        ACTIVE
+  Credits:            583 available
 ```
 
 ### 3. Generate a Thumbnail
@@ -84,7 +80,7 @@ npx thumbnailgpt generate "Extreme 100 Days Hardcore Survival in Minecraft" --re
 ```
 *Output:*
 ```text
-✔ Generation complete! (14s)
+Generation complete (14s)
 
   Thumbnail URL: https://assets.thumbnailgpt.com/generations/.../thumbnail.png
   Chat Thread:   https://thumbnailgpt.com/studio/3c9d1e5f-...
@@ -109,7 +105,7 @@ npx thumbnailgpt generate [options] <prompt>
 | Flag | Short | Default | Description |
 | :--- | :---: | :---: | :--- |
 | `--ratio <ratio>` | `-r` | `16:9` | Aspect ratio: `16:9` (YouTube standard) or `9:16` (Shorts / Reels) |
-| `--res <resolution>` | `-q` | `1K` | Resolution quality: `1K` (10 credits), `2K` (20 credits), or `4K` (30 credits) |
+| `--res <resolution>` | `-q` | `1K` | Resolution quality: `1K`, `2K`, or `4K` |
 | `--ref <urls...>` | | | Up to 5 public image URLs or base64 data URIs as visual references |
 | `--yt <url>` | | | YouTube video URL to extract title, context, and current thumbnail |
 | `--persona <personaId>` | `-p` | | Creator Persona UUID to feature in the generated thumbnail |
@@ -172,10 +168,9 @@ npx thumbnailgpt chat 3c9d1e5f-c648-4b3c-a6f0-811d073c22c2
 ```
 
 Commands available inside interactive chat mode:
-- Type your prompt prompt to iterate.
+- Type your prompt to iterate.
 - `/url` — Display the latest generated thumbnail URL.
 - `/open` — Open the current thumbnail in your default web browser.
-- `/cost` — View credit cost tiers.
 - `/help` — Display interactive mode shortcuts.
 - `/exit` or `exit` — Exit interactive session.
 
@@ -183,7 +178,7 @@ Commands available inside interactive chat mode:
 
 ### `thumbnailgpt whoami`
 
-Display your authenticated email, subscription tier, available credit balance, and generation pricing tiers.
+Display your authenticated email, subscription status, and available balance.
 
 ```bash
 npx thumbnailgpt whoami
@@ -304,17 +299,17 @@ Now you can instruct Claude or Cursor:
 
 To prevent accidental data loss or unauthorized bulk deletions by third-party scripts and autonomous AI agents:
 - Destructive deletions (`DELETE` operations) are disabled over Personal API Keys, the CLI, and the MCP server.
-- Resource creation, iteration, credit checks, persona styling, and asset retrievals are fully enabled.
+- Resource creation, iteration, account balance checks, persona styling, and asset retrievals are fully enabled.
 - Deletions can be performed safely by the account owner inside the **[ThumbnailGPT Web Studio](https://thumbnailgpt.com/studio)**.
 
 ---
 
 ## Support & Resources
 
-- 🌐 **Web Studio**: [https://thumbnailgpt.com](https://thumbnailgpt.com)
-- 📖 **API & CLI Docs**: [https://thumbnailgpt.com/docs](https://thumbnailgpt.com/docs)
-- 🔑 **API Key Management**: [https://thumbnailgpt.com/studio?settings=api-key](https://thumbnailgpt.com/studio?settings=api-key)
-- 💬 **Support Email**: [support@thumbnailgpt.com](mailto:support@thumbnailgpt.com)
+- Web Studio: [https://thumbnailgpt.com](https://thumbnailgpt.com)
+- API & CLI Docs: [https://thumbnailgpt.com/docs](https://thumbnailgpt.com/docs)
+- API Key Management: [https://thumbnailgpt.com/studio?settings=api-key](https://thumbnailgpt.com/studio?settings=api-key)
+- Support Email: [support@thumbnailgpt.com](mailto:support@thumbnailgpt.com)
 
 ---
 

package/dist/client.d.ts

@@ -1,15 +1,15 @@
-import type { CreditBalanceResponse, StudioGenerateOptions, StudioDispatchResult, StudioConversationResponse, GenerationSettledResult, PersonaItem, ThumbnailItem } from "./types.js";
+import type { CreditBalanceResponse, StudioGenerateOptions, StudioDispatchResult, StudioConversationResponse, GenerationSettledResult, PersonaItem, ThumbnailItem, ListChatsResponse, ListPersonasResponse } from "./types.js";
 export declare class ThumbnailGPTClient {
     private apiKey;
     private apiUrl;
     constructor(apiKey?: string, apiUrl?: string);
     private request;
     /**
-     * Check current user credit balance and plan status
+     * Fetch current credit balance and subscription status
      */
     getCredits(): Promise<CreditBalanceResponse>;
     /**
-     * Dispatch a studio generation job
+     * Dispatch studio thumbnail generation task
      */
     dispatchStudio(options: StudioGenerateOptions): Promise<StudioDispatchResult>;
     /**
@@ -17,13 +17,21 @@ export declare class ThumbnailGPTClient {
      */
     getChat(chatId: string): Promise<StudioConversationResponse>;
     /**
-     * List recent studio conversations
+     * List recent studio conversations with pagination
      */
-    listChats(): Promise<any>;
+    listChats(options?: {
+        page?: number;
+        limit?: number;
+    }): Promise<ListChatsResponse>;
     /**
-     * Retrieve active, ready-to-use personas for the user.
-     * Only 'ready' personas are returned. Raw image URLs, character sheets,
-     * error traces, and database internals are strictly redacted.
+     * Retrieve active, ready-to-use personas for the user with pagination
+     */
+    listPersonas(options?: {
+        page?: number;
+        limit?: number;
+    }): Promise<ListPersonasResponse>;
+    /**
+     * Retrieve active, ready-to-use personas (returns array for backward compatibility)
      */
     getPersonas(): Promise<PersonaItem[]>;
     /**

package/dist/client.js

@@ -14,74 +14,51 @@ export class ThumbnailGPTClient {
     async request(endpoint, options = {}) {
         const url = `${this.apiUrl}${endpoint.startsWith("/") ? "" : "/"}${endpoint}`;
         const headers = {
-            "Content-Type": "application/json",
             Authorization: `Bearer ${this.apiKey}`,
-            Origin: this.apiUrl,
-            "User-Agent": "thumbnailgpt-cli/1.0.7",
+            "Content-Type": "application/json",
             ...options.headers,
         };
-        const res = await fetch(url, { ...options, headers });
-        const data = (await res.json().catch(() => ({})));
+        let res;
+        try {
+            res = await fetch(url, { ...options, headers });
+        }
+        catch (netErr) {
+            throw new Error(`Failed to reach ThumbnailGPT backend at ${this.apiUrl}: ${netErr.message}`);
+        }
         if (!res.ok) {
-            const errorMsg = data.error ||
-                data.message ||
-                `Request failed with status ${res.status}: ${res.statusText}`;
-            const err = new Error(errorMsg);
-            err.status = res.status;
-            err.data = data;
-            throw err;
+            let errMsg = `Request failed (${res.status} ${res.statusText})`;
+            try {
+                const errorJson = await res.json();
+                errMsg = errorJson.error || errorJson.message || errMsg;
+            }
+            catch {
+                // Fallback to text status
+            }
+            throw new Error(errMsg);
         }
-        return data;
+        return res.json();
     }
     /**
-     * Check current user credit balance and plan status
+     * Fetch current credit balance and subscription status
      */
     async getCredits() {
         return this.request("/api/credits/balance");
     }
     /**
-     * Dispatch a studio generation job
+     * Dispatch studio thumbnail generation task
      */
     async dispatchStudio(options) {
-        if (options.referenceImages && options.referenceImages.length > 5) {
-            throw new Error("A maximum of 5 reference images is allowed.");
-        }
-        const rawRefImages = (options.referenceImages || []).slice(0, 5);
-        const processedRefImages = [];
-        for (const img of rawRefImages) {
-            if (typeof img === "string") {
-                if (img.startsWith("http://") || img.startsWith("https://") || img.startsWith("data:")) {
-                    processedRefImages.push(img);
-                }
-                else if (fs.existsSync(img)) {
-                    const ext = path.extname(img).toLowerCase().replace(".", "");
-                    const mimeType = ext === "jpg" || ext === "jpeg"
-                        ? "image/jpeg"
-                        : ext === "png"
-                            ? "image/png"
-                            : ext === "webp"
-                                ? "image/webp"
-                                : "image/jpeg";
-                    const buffer = fs.readFileSync(img);
-                    const base64 = buffer.toString("base64");
-                    processedRefImages.push(`data:${mimeType};base64,${base64}`);
-                }
-                else {
-                    processedRefImages.push(img);
-                }
-            }
-        }
         return this.request("/api/studio", {
             method: "POST",
             body: JSON.stringify({
-                chatId: options.chatId,
                 feature: "recreate_thumbnail",
                 prompt: options.prompt,
+                chatId: options.chatId,
                 aspectRatio: options.aspectRatio || "16:9",
                 resolution: options.resolution || "1K",
-                referenceImages: processedRefImages,
-                youtubeUrl: options.youtubeUrl || undefined,
-                personaId: options.personaId || undefined,
+                referenceImages: options.referenceImages || [],
+                youtubeUrl: options.youtubeUrl,
+                personaId: options.personaId,
                 baseImage: options.baseImage,
             }),
         });
@@ -93,23 +70,36 @@ export class ThumbnailGPTClient {
         return this.request(`/api/studio/${chatId}`);
     }
     /**
-     * List recent studio conversations
+     * List recent studio conversations with pagination
      */
-    async listChats() {
-        return this.request("/api/studio");
+    async listChats(options) {
+        const page = Math.max(1, options?.page ?? 1);
+        const limit = Math.min(100, Math.max(1, options?.limit ?? 20));
+        return this.request(`/api/studio?page=${page}&limit=${limit}`);
+    }
+    /**
+     * Retrieve active, ready-to-use personas for the user with pagination
+     */
+    async listPersonas(options) {
+        const page = Math.max(1, options?.page ?? 1);
+        const limit = Math.min(50, Math.max(1, options?.limit ?? 20));
+        const res = await this.request(`/api/personas?page=${page}&limit=${limit}`);
+        return {
+            success: res.success ?? true,
+            personas: (res.personas || []).map((p) => ({
+                id: p.id,
+                name: p.name,
+                created_at: p.created_at,
+            })),
+            pagination: res.pagination,
+        };
     }
     /**
-     * Retrieve active, ready-to-use personas for the user.
-     * Only 'ready' personas are returned. Raw image URLs, character sheets,
-     * error traces, and database internals are strictly redacted.
+     * Retrieve active, ready-to-use personas (returns array for backward compatibility)
      */
     async getPersonas() {
-        const res = await this.request("/api/personas");
-        return (res.personas || []).map((p) => ({
-            id: p.id,
-            name: p.name,
-            created_at: p.created_at,
-        }));
+        const res = await this.listPersonas({ page: 1, limit: 50 });
+        return res.personas;
     }
     /**
      * Asynchronously dispatch and poll until completion
@@ -117,8 +107,8 @@ export class ThumbnailGPTClient {
     async generateAndWait(options, onProgress, timeoutSec = 120) {
         // 1. Credit Pre-check
         const credits = await this.getCredits();
-        const resolutionCosts = { "1K": 10, "2K": 20, "4K": 30 };
-        const required = resolutionCosts[options.resolution || "1K"] || 10;
+        const resolutionCosts = { "1K": 20, "2K": 30, "4K": 40 };
+        const required = resolutionCosts[options.resolution || "1K"] || 20;
         if (credits.credits < required) {
             throw new Error(`Insufficient credits. Required: ${required}, Available: ${credits.credits}. Top up at https://thumbnailgpt.com/pricing`);
         }

package/dist/index.js

@@ -55,7 +55,7 @@ const program = new Command();
 program
     .name("thumbnailgpt")
     .description("Official CLI for ThumbnailGPT — Generate, iterate, and manage thumbnails from your terminal")
-    .version("1.0.7");
+    .version("1.0.9");
 // 1. Auth Login
 program
     .command("login")
@@ -108,9 +108,11 @@ program
         const credits = await client.getCredits();
         spinner.stop();
         console.log(pc.bold("\nThumbnailGPT Account"));
+        if (credits.email) {
+            console.log(`${pc.gray("Account:")}      ${pc.white(pc.bold(credits.email))}`);
+        }
         console.log(`${pc.gray("Plan Status:")}  ${pc.cyan(credits.subscription_status.toUpperCase())}`);
-        console.log(`${pc.gray("Credits:")}      ${pc.green(pc.bold(String(credits.credits)))} available`);
-        console.log(`${pc.gray("Cost Tiers:")}  1K = 10 cr | 2K = 20 cr | 4K = 30 cr\n`);
+        console.log(`${pc.gray("Credits:")}      ${pc.green(pc.bold(String(credits.credits)))} available\n`);
     }
     catch (err) {
         handleError(err, spinner);
@@ -143,7 +145,7 @@ program
         }
         const res = (options.res || "1K").toUpperCase().trim();
         if (res !== "1K" && res !== "2K" && res !== "4K") {
-            console.error(pc.red(`\nError: Invalid resolution "${res}". Supported resolutions: 1K (10 credits), 2K (20 credits), 4K (30 credits)`));
+            console.error(pc.red(`\nError: Invalid resolution "${res}". Supported resolutions: 1K, 2K, 4K`));
             process.exit(1);
         }
         const client = new ThumbnailGPTClient();
@@ -284,14 +286,25 @@ program
 const chats = program.command("chats").description("Manage chat conversations");
 chats
     .command("list")
-    .description("List recent chat conversations")
-    .action(async () => {
+    .description("List recent chat conversations with pagination")
+    .option("-p, --page <number>", "Page number", "1")
+    .option("-l, --limit <number>", "Items per page (max 100)", "20")
+    .option("--json", "Output response as raw JSON", false)
+    .action(async (opts) => {
     let spinner = null;
     try {
+        const page = Math.max(1, parseInt(opts.page, 10) || 1);
+        const limit = Math.min(100, Math.max(1, parseInt(opts.limit, 10) || 20));
+        if (!opts.json) {
+            spinner = ora("Fetching conversations...").start();
+        }
         const client = new ThumbnailGPTClient();
-        spinner = ora("Fetching conversations...").start();
-        const res = await client.listChats();
-        spinner.stop();
+        const res = await client.listChats({ page, limit });
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        spinner?.stop();
         const chatList = res.chats || [];
         if (chatList.length === 0) {
             console.log(pc.gray("No conversations found."));
@@ -302,6 +315,10 @@ chats
             console.log(`• ${pc.bold(c.title || "Untitled")} ${pc.gray(`(${c.id})`)}`);
             console.log(`  ${pc.gray("Updated:")} ${new Date(c.updated_at).toLocaleString()}`);
         });
+        if (res.pagination) {
+            const { page: currPage, totalPages, total, hasMore } = res.pagination;
+            console.log(pc.dim(`\nPage ${currPage} of ${totalPages} (${total} total conversations)${hasMore ? ` • Run with --page ${currPage + 1} to view more` : ""}`));
+        }
         console.log();
     }
     catch (err) {
@@ -410,14 +427,26 @@ const personasCmd = program
     .description("Inspect active creator personas for thumbnail generation");
 personasCmd
     .command("list")
-    .description("List your active creator personas (only ready personas are shown)")
-    .action(async () => {
+    .description("List your active creator personas with pagination (only ready personas are shown)")
+    .option("-p, --page <number>", "Page number", "1")
+    .option("-l, --limit <number>", "Items per page (max 50)", "20")
+    .option("--json", "Output response as raw JSON", false)
+    .action(async (opts) => {
     let spinner = null;
     try {
+        const page = Math.max(1, parseInt(opts.page, 10) || 1);
+        const limit = Math.min(50, Math.max(1, parseInt(opts.limit, 10) || 20));
+        if (!opts.json) {
+            spinner = ora("Fetching active personas...").start();
+        }
         const client = new ThumbnailGPTClient();
-        spinner = ora("Fetching active personas...").start();
-        const personas = await client.getPersonas();
-        spinner.stop();
+        const res = await client.listPersonas({ page, limit });
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        spinner?.stop();
+        const personas = res.personas || [];
         if (personas.length === 0) {
             console.log(pc.yellow("\nNo active personas found."));
             console.log(`Create your first persona in ThumbnailGPT at: ${pc.cyan("https://thumbnailgpt.com/studio")}\n`);
@@ -430,6 +459,10 @@ personasCmd
             console.log(`${pc.cyan(p.id)}  ${pc.bold(p.name)}  ${dateStr}`);
         });
         console.log(pc.dim("--------------------------------------------------------------------------------"));
+        if (res.pagination) {
+            const { page: currPage, totalPages, total, hasMore } = res.pagination;
+            console.log(pc.dim(`Page ${currPage} of ${totalPages} (${total} total personas)${hasMore ? ` • Run with --page ${currPage + 1} to view more` : ""}\n`));
+        }
         console.log(`Use in generation: ${pc.green('npx thumbnailgpt generate "..." --persona <id>')}\n`);
     }
     catch (err) {

package/dist/types.d.ts

@@ -22,6 +22,7 @@ export interface StudioDispatchResult {
     availableCredits?: number;
 }
 export interface CreditBalanceResponse {
+    email?: string;
     credits: number;
     subscription_status: string;
     error?: string;
@@ -72,3 +73,28 @@ export interface PersonaItem {
     name: string;
     created_at?: string;
 }
+export interface PaginationMetadata {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasMore: boolean;
+}
+export interface ListChatsResponse {
+    success: boolean;
+    chats: Array<{
+        id: string;
+        title: string;
+        created_at: string;
+        updated_at: string;
+        thumbnails?: ThumbnailItem[];
+    }>;
+    pagination?: PaginationMetadata;
+    error?: string;
+}
+export interface ListPersonasResponse {
+    success: boolean;
+    personas: PersonaItem[];
+    pagination?: PaginationMetadata;
+    error?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thumbnailgpt",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Official CLI for ThumbnailGPT — Generate, iterate, and manage viral YouTube thumbnails directly from your terminal",
   "type": "module",
   "main": "dist/index.js",