npm - thumbnailgpt - Versions diffs - 1.0.5 → 1.0.7 - Mend

thumbnailgpt 1.0.5 → 1.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/README.md CHANGED Viewed

@@ -1,137 +1,323 @@
-# ThumbnailGPT CLI & MCP Server
+# ThumbnailGPT CLI
-The official command-line interface and [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for **[ThumbnailGPT](https://thumbnailgpt.com)**.
+[![npm version](https://img.shields.io/npm/v/thumbnailgpt.svg?color=ff5500)](https://www.npmjs.com/package/thumbnailgpt)
+[![npm downloads](https://img.shields.io/npm/dm/thumbnailgpt.svg?color=blue)](https://www.npmjs.com/package/thumbnailgpt)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Node Version](https://img.shields.io/node/v/thumbnailgpt.svg)](https://nodejs.org)
-Create viral, high-CTR YouTube thumbnails directly from your terminal or AI code assistants (Cursor, Claude Desktop, Windsurf).
+The official command-line interface for **[ThumbnailGPT](https://thumbnailgpt.com)** — the AI-powered YouTube thumbnail generation engine built for creators, growth teams, and automated video workflows.
+Generate, iterate, download, and manage viral, high-CTR YouTube thumbnails directly from your terminal or CI/CD pipelines.
+[Web Studio](https://thumbnailgpt.com) • [Hosted MCP Server](https://mcp.thumbnailgpt.com) • [Documentation](https://thumbnailgpt.com/docs) • [Get API Key](https://thumbnailgpt.com/studio?settings=api-key)
+---
+## 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.
+---
+## Installation
+### Run Directly via `npx` (Recommended)
+You do not need to install anything globally. Simply run:
+```bash
+npx thumbnailgpt <command>
+```
+### Or Install Globally
+```bash
+# npm
+npm install -g thumbnailgpt
+# pnpm
+pnpm add -g thumbnailgpt
+# bun
+bun add -g thumbnailgpt
+```
 ---
-## Quick Start (Zero Install)
+## Quickstart
-You can run commands directly using `npx`:
+### 1. Authenticate
+Obtain your Personal API Key from your **[ThumbnailGPT Settings](https://thumbnailgpt.com/studio?settings=api-key)** (`tgpt_live_...`):
 ```bash
-# 1. Log in with your Personal API Key (get one from https://thumbnailgpt.com/settings)
 npx thumbnailgpt login
+```
+*Or authenticate non-interactively:*
+```bash
+npx thumbnailgpt login --key tgpt_live_YOUR_API_KEY
+```
-# 2. Check your credit balance & user identity
+### 2. Verify Your Account & Credit Balance
+```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
+```
-# 3. Generate a thumbnail
-npx thumbnailgpt generate "Surviving 24 Hours in Arctic Snow" --resolution 2K --output ./thumb.webp
+### 3. Generate a Thumbnail
+```bash
+npx thumbnailgpt generate "Extreme 100 Days Hardcore Survival in Minecraft" --res 2K
+```
+*Output:*
+```text
+✔ Generation complete! (14s)
+  Thumbnail URL: https://assets.thumbnailgpt.com/generations/.../thumbnail.png
+  Chat Thread:   https://thumbnailgpt.com/studio/3c9d1e5f-...
+  Chat ID:       3c9d1e5f-c648-4b3c-a6f0-811d073c22c2
+  Thumbnail ID:  e97b4f21-12a8-48b2-89f4-5d9c2e0b1a4f
 ```
 ---
-## MCP Server Setup (Cursor & Claude Desktop)
+## Command Reference
-The package includes a built-in stdio MCP server.
+### `thumbnailgpt generate <prompt>`
-### 1. Cursor IDE Setup
-Add to your project's `.cursor/mcp.json` or your global Cursor settings:
+Generate a new YouTube thumbnail from visual instructions, or iterate on an existing thread.
-```json
-{
-  "mcpServers": {
-    "thumbnailgpt": {
-      "command": "npx",
-      "args": ["-y", "thumbnailgpt", "mcp"],
-      "env": {
-        "THUMBNAILGPT_API_KEY": "tgpt_live_YOUR_KEY_HERE"
-      }
-    }
-  }
-}
+```bash
+npx thumbnailgpt generate [options] <prompt>
 ```
-### 2. Claude Desktop Setup
-Add to `claude_desktop_config.json`:
+#### Options
-```json
-{
-  "mcpServers": {
-    "thumbnailgpt": {
-      "command": "npx",
-      "args": ["-y", "thumbnailgpt", "mcp"],
-      "env": {
-        "THUMBNAILGPT_API_KEY": "tgpt_live_YOUR_KEY_HERE"
-      }
-    }
-  }
-}
+| 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) |
+| `--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 |
+| `--chat <chatId>` | `-c` | | Existing chat conversation UUID to continue and iterate upon |
+| `--url-only` | `-u` | `false` | Print strictly the hosted CDN image URL (ideal for shell scripts) |
+| `--json` | | `false` | Output the full response as formatted JSON |
+| `--async` | | `false` | Dispatch generation job and exit immediately without waiting |
+#### Examples
+**Ultra-HD 4K Thumbnail:**
+```bash
+npx thumbnailgpt generate "Cyberpunk Underground Hacker Room neon cyan and magenta" --res 4K
+```
+**YouTube Shorts (9:16) with Reference Image:**
+```bash
+npx thumbnailgpt generate "Shocked screaming expression with money flying" \
+  --ratio 9:16 \
+  --ref "https://example.com/my-face.png"
+```
+**Feature Your Creator Persona:**
+```bash
+# First, list your active personas to grab your persona UUID:
+npx thumbnailgpt personas list
+# Generate featuring that persona:
+npx thumbnailgpt generate "Standing in front of a $10,000,000 superyacht" --persona <PERSONA_UUID>
+```
+**Recreate & Upgrade an Existing YouTube Video Thumbnail:**
+```bash
+npx thumbnailgpt generate "Make the facial expression more dramatic and double the contrast" \
+  --yt "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
 ```
-### Exposed MCP Tools:
-- `thumbnailgpt_generate`: Synthesize YouTube thumbnails with custom prompts, aspect ratios (`16:9`, `9:16`), resolutions (`1K`, `2K`, `4K`), reference images, and creator persona IDs (`personaId`).
-- `thumbnailgpt_get_personas`: Retrieve verified active creator personas (`id`, `name`). Raw image assets and unready personas are strictly protected and never exposed.
-- `thumbnailgpt_get_credits`: Query available credits and subscription status.
-- `thumbnailgpt_list_chats`: List recent Studio conversation sessions.
-- `thumbnailgpt_get_chat`: Retrieve full message history and generated thumbnail URLs.
+**Iterative Refinement (Conversational Chaining):**
+```bash
+# Initial generation:
+npx thumbnailgpt generate "Cozy cabin in snowy mountains during sunset"
+# Output returns Chat ID: 3c9d1e5f-c648-4b3c-a6f0-811d073c22c2
+# Tweak the existing thumbnail:
+npx thumbnailgpt generate "Add smoke rising from chimney and warm glowing windows" --chat 3c9d1e5f-c648-4b3c-a6f0-811d073c22c2
+```
 ---
-## CLI Commands Reference
+### `thumbnailgpt chat [chatId]`
+Launch an interactive conversational session directly in your terminal. Perfect for creative brainstorming and rapid multi-turn iterations.
-### Authentication
 ```bash
-# Interactive login
-npx thumbnailgpt login
+# Start a fresh creative session:
+npx thumbnailgpt chat
+# Or resume an existing conversation thread:
+npx thumbnailgpt chat 3c9d1e5f-c648-4b3c-a6f0-811d073c22c2
+```
-# Clear saved credentials
-npx thumbnailgpt logout
+Commands available inside interactive chat mode:
+- Type your prompt 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.
-# Print active profile & balance
+---
+### `thumbnailgpt whoami`
+Display your authenticated email, subscription tier, available credit balance, and generation pricing tiers.
+```bash
 npx thumbnailgpt whoami
 ```
-### Creator Personas
+---
+### `thumbnailgpt chats`
+Inspect and manage your generation conversation history.
 ```bash
-# List your active creator personas (only ready personas with safe IDs/names are shown)
-npx thumbnailgpt personas list
+# List recent conversation threads
+npx thumbnailgpt chats list
-# New personas can only be trained in the Web UI
-npx thumbnailgpt personas add
+# View messages and generated thumbnails for a specific thread
+npx thumbnailgpt chats show <chatId>
+# Deletion guidance
+npx thumbnailgpt chats delete <chatId>
 ```
-### Generate Thumbnails
+---
+### `thumbnailgpt thumbnails`
+Inspect metadata and retrieve URLs for generated thumbnails.
 ```bash
-# Standard 16:9 1K thumbnail
-npx thumbnailgpt generate "Extreme Minecraft Hardcore Survival"
+# Retrieve full metadata (prompt, dimensions, resolution, creation date)
+npx thumbnailgpt thumbnails get <thumbnailId>
+# Output hosted CDN image URL directly
+npx thumbnailgpt thumbnails url <thumbnailId>
+# Deletion guidance
+npx thumbnailgpt thumbnails delete <thumbnailId>
+```
+---
-# Generate thumbnail featuring your trained creator persona
-npx thumbnailgpt generate "24-Hour Survival Challenge" --persona <personaId>
+### `thumbnailgpt personas`
-# 4K resolution saved to local file
-npx thumbnailgpt generate "Cyberpunk Underground Hacker Room" --resolution 4K --output ./thumb.webp
+Manage your custom trained AI creator personas.
-# 9:16 Shorts format with reference image URL
-npx thumbnailgpt generate "Shocked reaction expression" --aspect 9:16 --ref "https://example.com/face.png"
+```bash
+# List all active personas with their IDs and avatar URLs
+npx thumbnailgpt personas list
-# Recreate thumbnail from YouTube video URL
-npx thumbnailgpt generate "Upgrade lighting and contrast" --youtube "https://youtube.com/watch?v=VIDEO_ID"
+# Instructions for training new creator personas
+npx thumbnailgpt personas add
 ```
-### Interactive Studio Mode
+---
+## Automation & Scripting Recipes
+### Download Thumbnail Directly to Disk
+Combine `--url-only` with `curl` or `wget` to generate and download in a single line:
 ```bash
-# Launch interactive conversation session in terminal
-npx thumbnailgpt studio
+curl -s -o thumbnail.png $(npx thumbnailgpt generate "Surviving 24 Hours on a Desert Island" --url-only)
+```
-# List all past studio conversations
-npx thumbnailgpt chats list
+### Headless CI / CD & Environment Authentication
+In automated runners, GitHub Actions, or Docker containers, authenticate by setting the `THUMBNAILGPT_API_KEY` environment variable instead of running `thumbnailgpt login`:
-# View messages and image URLs of a specific conversation
-npx thumbnailgpt chats show <chatId>
+```bash
+export THUMBNAILGPT_API_KEY="tgpt_live_YOUR_KEY"
+npx thumbnailgpt generate "Weekly Tech News Round-up" --res 2K --url-only
+```
+### JSON Processing with `jq`
+Extract the thumbnail URL, chat ID, and generation time programmatically:
+```bash
+npx thumbnailgpt generate "MrBeast Style $1,000,000 Challenge" --json | jq '{url: .imageUrl, chatId: .chatId}'
 ```
 ---
 ## Environment Variables
-- `THUMBNAILGPT_API_KEY`: Your Personal API Key (`tgpt_live_...`). If set, overrides the stored login credentials.
-- `THUMBNAILGPT_API_URL`: Custom backend gateway URL (defaults to `https://thumbnailgpt.com`).
+| Variable | Description | Default |
+| :--- | :--- | :--- |
+| `THUMBNAILGPT_API_KEY` | Personal API Key (`tgpt_live_...`). Takes precedence over saved credentials. | Stored in system keychain |
+| `THUMBNAILGPT_API_URL` | Backend endpoint for enterprise or staging instances. | `https://thumbnailgpt.com` |
+---
+## Model Context Protocol (MCP) Companion
+Are you using an AI coding assistant like **Cursor**, **Claude Desktop**, or **Windsurf**?
+ThumbnailGPT provides a hosted, remote Model Context Protocol (MCP) server running at **`https://mcp.thumbnailgpt.com`**.
+Add this to your Cursor (`~/.cursor/mcp.json`) or Claude Desktop configuration:
+```json
+{
+  "mcpServers": {
+    "thumbnailgpt": {
+      "url": "https://mcp.thumbnailgpt.com",
+      "headers": {
+        "Authorization": "Bearer tgpt_live_YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+Now you can instruct Claude or Cursor:
+> *"Create a 2K high-CTR YouTube thumbnail for our new podcast episode about Next.js 16"*
+---
+## Security & Account Protection
+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.
+- 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)
 ---
 ## License
-MIT © [ThumbnailGPT](https://thumbnailgpt.com)
+[MIT](LICENSE) © [ThumbnailGPT](https://thumbnailgpt.com)

package/bin/thumbnailgpt.js CHANGED Viewed

@@ -1,6 +1,6 @@
-#!/usr/bin/env node
-import("../dist/index.js").catch((err) => {
-  console.error("Failed to run thumbnailgpt CLI:", err);
-  process.exit(1);
-});
+#!/usr/bin/env node
+import("../dist/index.js").catch((err) => {
+  console.error("Failed to run thumbnailgpt CLI:", err);
+  process.exit(1);
+});

package/dist/client.d.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-import type { CreditBalanceResponse, StudioGenerateOptions, StudioDispatchResult, StudioConversationResponse, GenerationSettledResult, PersonaItem } from "./types.js";
+import type { CreditBalanceResponse, StudioGenerateOptions, StudioDispatchResult, StudioConversationResponse, GenerationSettledResult, PersonaItem, ThumbnailItem } from "./types.js";
 export declare class ThumbnailGPTClient {
     private apiKey;
     private apiUrl;
@@ -30,6 +30,18 @@ export declare class ThumbnailGPTClient {
      * Asynchronously dispatch and poll until completion
      */
     generateAndWait(options: StudioGenerateOptions, onProgress?: (elapsedSec: number, status: string) => void, timeoutSec?: number): Promise<GenerationSettledResult>;
+    /**
+     * Delete a chat conversation and all associated messages
+     */
+    deleteChat(chatId: string): Promise<void>;
+    /**
+     * Get thumbnail details by ID
+     */
+    getThumbnail(thumbnailId: string): Promise<ThumbnailItem>;
+    /**
+     * Delete a specific thumbnail by ID
+     */
+    deleteThumbnail(thumbnailId: string): Promise<void>;
     /**
      * Download image to local filesystem
      */

package/dist/client.js CHANGED Viewed

@@ -8,7 +8,7 @@ export class ThumbnailGPTClient {
         this.apiKey = (apiKey || getApiKey() || "").trim();
         this.apiUrl = (apiUrl || getApiUrl() || "").replace(/\/$/, "");
         if (!this.apiKey) {
-            throw new Error("Missing ThumbnailGPT API Key. Run 'thumbnailgpt login' or set the THUMBNAILGPT_API_KEY environment variable.");
+            throw new Error("Missing ThumbnailGPT API Key. Run 'thumbnailgpt login' or set the THUMBNAILGPT_API_KEY environment variable. Get your API key at https://thumbnailgpt.com/studio?settings=api-key");
         }
     }
     async request(endpoint, options = {}) {
@@ -16,6 +16,8 @@ export class ThumbnailGPTClient {
         const headers = {
             "Content-Type": "application/json",
             Authorization: `Bearer ${this.apiKey}`,
+            Origin: this.apiUrl,
+            "User-Agent": "thumbnailgpt-cli/1.0.7",
             ...options.headers,
         };
         const res = await fetch(url, { ...options, headers });
@@ -41,6 +43,34 @@ export class ThumbnailGPTClient {
      * Dispatch a studio generation job
      */
     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({
@@ -49,9 +79,9 @@ export class ThumbnailGPTClient {
                 prompt: options.prompt,
                 aspectRatio: options.aspectRatio || "16:9",
                 resolution: options.resolution || "1K",
-                referenceImages: options.referenceImages || [],
-                youtubeUrl: options.youtubeUrl,
-                personaId: options.personaId,
+                referenceImages: processedRefImages,
+                youtubeUrl: options.youtubeUrl || undefined,
+                personaId: options.personaId || undefined,
                 baseImage: options.baseImage,
             }),
         });
@@ -149,6 +179,29 @@ export class ThumbnailGPTClient {
             error: `Generation timed out after ${timeoutSec}s. Check status later with 'thumbnailgpt chats show ${chatId}'`,
         };
     }
+    /**
+     * Delete a chat conversation and all associated messages
+     */
+    async deleteChat(chatId) {
+        await this.request(`/api/studio/${chatId}`, {
+            method: "DELETE",
+        });
+    }
+    /**
+     * Get thumbnail details by ID
+     */
+    async getThumbnail(thumbnailId) {
+        const res = await this.request(`/api/thumbnails/${thumbnailId}`);
+        return res.thumbnail;
+    }
+    /**
+     * Delete a specific thumbnail by ID
+     */
+    async deleteThumbnail(thumbnailId) {
+        await this.request(`/api/thumbnails/${thumbnailId}`, {
+            method: "DELETE",
+        });
+    }
     /**
      * Download image to local filesystem
      */

package/dist/index.js CHANGED Viewed

@@ -4,12 +4,58 @@ import ora from "ora";
 import pc from "picocolors";
 import { setApiKey, clearApiKey, setApiUrl } from "./config.js";
 import { ThumbnailGPTClient } from "./client.js";
-import { runMcpServer } from "./mcp.js";
+/**
+ * Safely handle errors in CLI commands without crashing libuv timers or exposing internal server details
+ */
+function handleError(err, spinner) {
+    if (spinner) {
+        try {
+            spinner.stop();
+        }
+        catch { }
+    }
+    const rawMsg = String(err?.message || err || "").trim();
+    const status = Number(err?.status || 0);
+    let friendlyMessage = rawMsg;
+    // Mask database, internal, or raw HTML errors
+    if (status === 401 ||
+        rawMsg.toLowerCase().includes("api key") ||
+        rawMsg.toLowerCase().includes("unauthorized") ||
+        rawMsg.toLowerCase().includes("revoked")) {
+        friendlyMessage = "Authentication failed: Invalid, expired, or revoked API key. Please run 'thumbnailgpt login' to update your key.";
+    }
+    else if (status === 403 || rawMsg.toLowerCase().includes("forbidden")) {
+        friendlyMessage = "Access restricted: You do not have permission to access this resource.";
+    }
+    else if (status === 429 ||
+        rawMsg.toLowerCase().includes("rate limit") ||
+        rawMsg.toLowerCase().includes("too many requests")) {
+        friendlyMessage = "Request rate limit reached. Please wait a moment before trying again.";
+    }
+    else if (status >= 500 ||
+        rawMsg.toLowerCase().includes("internal server error") ||
+        rawMsg.toLowerCase().includes("service unavailable")) {
+        friendlyMessage = "ThumbnailGPT services are temporarily busy. Please try again in a few moments.";
+    }
+    else if (rawMsg.includes("ECONNREFUSED") ||
+        rawMsg.includes("ENOTFOUND") ||
+        rawMsg.includes("fetch failed")) {
+        friendlyMessage = "Unable to connect to ThumbnailGPT. Please check your internet connection.";
+    }
+    else if (rawMsg.includes("<!DOCTYPE") ||
+        rawMsg.includes("<html") ||
+        rawMsg.includes("SQL") ||
+        rawMsg.includes("Postgres")) {
+        friendlyMessage = "An unexpected error occurred. Please try again or visit https://thumbnailgpt.com for status updates.";
+    }
+    console.error(pc.red(`\nError: ${friendlyMessage}\n`));
+    process.exitCode = 1;
+}
 const program = new Command();
 program
     .name("thumbnailgpt")
-    .description("Official CLI and MCP server for ThumbnailGPT Studio")
-    .version("1.0.5");
+    .description("Official CLI for ThumbnailGPT — Generate, iterate, and manage thumbnails from your terminal")
+    .version("1.0.7");
 // 1. Auth Login
 program
     .command("login")
@@ -22,7 +68,7 @@ program
     }
     if (options.key) {
         setApiKey(options.key);
-        console.log(pc.green("✔ API key saved successfully!"));
+        console.log(pc.green("API key saved successfully."));
         return;
     }
     const rl = readline.createInterface({
@@ -30,16 +76,16 @@ program
         output: process.stdout,
     });
     console.log(pc.bold("\nThumbnailGPT Authentication"));
-    console.log(pc.gray("Generate an API key in your Web Studio at: Settings -> Developers -> API Keys & MCP\n"));
+    console.log(pc.gray("Get your API key at: ") + pc.cyan("https://thumbnailgpt.com/studio?settings=api-key\n"));
     rl.question(pc.cyan("Enter your Personal API Key (tgpt_live_...): "), (key) => {
         rl.close();
         const trimmed = key.trim();
         if (!trimmed.startsWith("tgpt_live_")) {
-            console.error(pc.red("\n❌ Invalid format. API keys begin with 'tgpt_live_'"));
+            console.error(pc.red("\nInvalid format. API keys begin with 'tgpt_live_'"));
             process.exit(1);
         }
         setApiKey(trimmed);
-        console.log(pc.green("\n✔ Logged in successfully! Key saved to local config."));
+        console.log(pc.green("\nLogged in successfully. Key saved to local config."));
     });
 });
 // 2. Auth Logout
@@ -48,16 +94,17 @@ program
     .description("Log out and clear stored API key")
     .action(() => {
     clearApiKey();
-    console.log(pc.green("✔ Logged out. Stored credentials cleared."));
+    console.log(pc.green("Logged out. Stored credentials cleared."));
 });
 // 3. Whoami / Credits
 program
     .command("whoami")
     .description("Display your account and available credit balance")
     .action(async () => {
+    let spinner = null;
     try {
         const client = new ThumbnailGPTClient();
-        const spinner = ora("Fetching account details...").start();
+        spinner = ora("Fetching account details...").start();
         const credits = await client.getCredits();
         spinner.stop();
         console.log(pc.bold("\nThumbnailGPT Account"));
@@ -66,8 +113,7 @@ program
         console.log(`${pc.gray("Cost Tiers:")}  1K = 10 cr | 2K = 20 cr | 4K = 30 cr\n`);
     }
     catch (err) {
-        console.error(pc.red(`\n❌ Error: ${err.message}`));
-        process.exit(1);
+        handleError(err, spinner);
     }
 });
 // 4. One-shot Generate
@@ -78,15 +124,31 @@ program
     .option("-q, --res <resolution>", "Resolution: 1K, 2K, or 4K", "1K")
     .option("--ref <urls...>", "Reference image file paths or URLs (max 5)")
     .option("--yt <url>", "YouTube video URL for reference")
-    .option("-c, --chat <chatId>", "Continue an existing studio conversation thread")
-    .option("-p, --persona <personaId>", "Creator Persona UUID to feature in the thumbnail")
-    .option("-o, --out <filepath>", "Download result directly to file (e.g. ./thumb.png)")
+    .option("-p, --persona <personaId>", "Persona UUID to feature in the thumbnail")
+    .option("-c, --chat <chatId>", "Continue an existing chat conversation thread")
+    .option("-u, --url-only", "Output only the hosted thumbnail URL")
+    .option("--json", "Output response as raw JSON")
     .option("--async", "Dispatch job and return immediately without waiting")
     .action(async (prompt, options) => {
+    let spinner = null;
     try {
+        if (options.ref && options.ref.length > 5) {
+            console.error(pc.red("\nError: A maximum of 5 reference images is allowed."));
+            process.exit(1);
+        }
+        const ratio = (options.ratio || "16:9").trim();
+        if (ratio !== "16:9" && ratio !== "9:16") {
+            console.error(pc.red(`\nError: Invalid aspect ratio "${ratio}". Supported ratios: 16:9, 9:16`));
+            process.exit(1);
+        }
+        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)`));
+            process.exit(1);
+        }
         const client = new ThumbnailGPTClient();
         if (options.async) {
-            const spinner = ora("Dispatching to ThumbnailGPT Studio...").start();
+            spinner = !options.json && !options.urlOnly ? ora("Dispatching to ThumbnailGPT...").start() : null;
             const dispatch = await client.dispatchStudio({
                 prompt,
                 chatId: options.chat,
@@ -96,13 +158,18 @@ program
                 youtubeUrl: options.yt,
                 personaId: options.persona,
             });
-            spinner.succeed("Generation dispatched successfully!");
+            if (options.json) {
+                console.log(JSON.stringify(dispatch, null, 2));
+                return;
+            }
+            if (spinner)
+                spinner.succeed("Generation dispatched successfully.");
             console.log(`\n${pc.bold("Chat ID:")}       ${dispatch.chatId}`);
             console.log(`${pc.bold("Thumbnail ID:")}  ${dispatch.thumbnailId || "Pending"}`);
             console.log(`Check status with: ${pc.cyan(`thumbnailgpt chats show ${dispatch.chatId}`)}\n`);
             return;
         }
-        const spinner = ora("Validating credits & dispatching...").start();
+        spinner = !options.json && !options.urlOnly ? ora("Validating credits & dispatching...").start() : null;
         const result = await client.generateAndWait({
             prompt,
             chatId: options.chat,
@@ -112,43 +179,61 @@ program
             youtubeUrl: options.yt,
             personaId: options.persona,
         }, (elapsedSec) => {
-            spinner.text = `Synthesizing thumbnail with AI [${elapsedSec}s elapsed]...`;
+            if (spinner) {
+                spinner.text = `Synthesizing thumbnail with AI [${elapsedSec}s elapsed]...`;
+            }
         });
         if (!result.success || !result.imageUrl) {
-            spinner.fail(`Generation failed: ${result.error}`);
+            if (spinner)
+                spinner.fail(`Generation failed: ${result.error}`);
+            else
+                console.error(pc.red(`Generation failed: ${result.error}`));
             process.exit(1);
         }
-        spinner.succeed(pc.green("Thumbnail generated successfully!"));
-        console.log(`\n${pc.bold("Image URL:")}       ${pc.cyan(result.imageUrl)}`);
-        console.log(`${pc.bold("Chat ID:")}         ${result.chatId}`);
-        console.log(`${pc.bold("Credits Left:")}    ${result.creditsRemaining ?? "N/A"}`);
-        console.log(`${pc.bold("Web Studio:")}      https://thumbnailgpt.com/studio/${result.chatId}`);
-        if (options.out) {
-            const downloadSpinner = ora(`Downloading to ${options.out}...`).start();
-            const savedPath = await client.downloadImage(result.imageUrl, options.out);
-            downloadSpinner.succeed(`Saved to ${pc.green(savedPath)}`);
+        if (options.urlOnly) {
+            console.log(result.imageUrl);
+            return;
         }
-        console.log();
+        if (options.json) {
+            console.log(JSON.stringify({
+                success: true,
+                imageUrl: result.imageUrl,
+                chatId: result.chatId,
+                thumbnailId: result.thumbnailId,
+                creditsRemaining: result.creditsRemaining,
+            }, null, 2));
+            return;
+        }
+        if (spinner)
+            spinner.succeed(pc.green("Thumbnail generated successfully."));
+        console.log(`\n${pc.bold("Hosted Image URL:")} ${pc.cyan(result.imageUrl)}`);
+        console.log(`${pc.bold("Chat ID:")}          ${result.chatId}`);
+        if (result.thumbnailId) {
+            console.log(`${pc.bold("Thumbnail ID:")}     ${result.thumbnailId}`);
+        }
+        console.log(`${pc.bold("Credits Left:")}     ${result.creditsRemaining ?? "N/A"}`);
+        console.log(`${pc.bold("Web App:")}          https://thumbnailgpt.com/studio/${result.chatId}\n`);
     }
     catch (err) {
-        console.error(pc.red(`\n❌ Error: ${err.message}`));
-        process.exit(1);
+        handleError(err, spinner);
     }
 });
-// 5. Interactive Studio TUI REPL
+// 5. Interactive Chat REPL
 program
-    .command("studio [initialChatId]")
-    .description("Launch an interactive conversation Studio session in your terminal")
+    .command("chat [initialChatId]")
+    .alias("interactive")
+    .alias("studio")
+    .description("Launch an interactive chat session in your terminal")
     .action(async (initialChatId) => {
     try {
         const client = new ThumbnailGPTClient();
         let currentChatId = initialChatId;
         console.clear();
-        console.log(pc.bold(pc.yellow("✦ ThumbnailGPT Studio CLI ✦")));
+        console.log(pc.bold("ThumbnailGPT CLI"));
         const credits = await client.getCredits();
         console.log(`${pc.gray("Credits:")} ${pc.green(String(credits.credits))} • ${pc.gray("Plan:")} ${credits.subscription_status}`);
         if (currentChatId) {
-            console.log(`${pc.gray("Resuming thread:")} ${currentChatId}`);
+            console.log(`${pc.gray("Resuming chat:")} ${currentChatId}`);
         }
         console.log(pc.gray("Type your prompt or visual tweak. Press Ctrl+C anytime to exit.\n"));
         const rl = readline.createInterface({
@@ -156,7 +241,7 @@ program
             output: process.stdout,
         });
         const askPrompt = () => {
-            rl.question(pc.cyan("\nstudio > "), async (input) => {
+            rl.question(pc.cyan("\nthumbnailgpt > "), async (input) => {
                 const text = input.trim();
                 if (!text) {
                     askPrompt();
@@ -177,10 +262,10 @@ program
                     }
                     else {
                         currentChatId = result.chatId;
-                        spinner.succeed(pc.green("Thumbnail updated!"));
+                        spinner.succeed(pc.green("Thumbnail updated."));
                         console.log(`${pc.bold("Image:")}      ${pc.cyan(result.imageUrl)}`);
                         console.log(`${pc.bold("Remaining:")}  ${result.creditsRemaining} credits`);
-                        console.log(`${pc.gray("Web Studio:")} https://thumbnailgpt.com/studio/${currentChatId}`);
+                        console.log(`${pc.gray("Web App:")}    https://thumbnailgpt.com/studio/${currentChatId}`);
                     }
                 }
                 catch (err) {
@@ -192,19 +277,19 @@ program
         askPrompt();
     }
     catch (err) {
-        console.error(pc.red(`\n❌ Error: ${err.message}`));
-        process.exit(1);
+        handleError(err);
     }
 });
 // 6. Chats Subcommand
-const chats = program.command("chats").description("Manage studio conversations");
+const chats = program.command("chats").description("Manage chat conversations");
 chats
     .command("list")
-    .description("List recent studio conversations")
+    .description("List recent chat conversations")
     .action(async () => {
+    let spinner = null;
     try {
         const client = new ThumbnailGPTClient();
-        const spinner = ora("Fetching conversations...").start();
+        spinner = ora("Fetching conversations...").start();
         const res = await client.listChats();
         spinner.stop();
         const chatList = res.chats || [];
@@ -212,7 +297,7 @@ chats
             console.log(pc.gray("No conversations found."));
             return;
         }
-        console.log(pc.bold("\nRecent Studio Conversations:\n"));
+        console.log(pc.bold("\nRecent Conversations:\n"));
         chatList.forEach((c) => {
             console.log(`• ${pc.bold(c.title || "Untitled")} ${pc.gray(`(${c.id})`)}`);
             console.log(`  ${pc.gray("Updated:")} ${new Date(c.updated_at).toLocaleString()}`);
@@ -220,17 +305,17 @@ chats
         console.log();
     }
     catch (err) {
-        console.error(pc.red(`\n❌ Error: ${err.message}`));
-        process.exit(1);
+        handleError(err, spinner);
     }
 });
 chats
     .command("show <chatId>")
     .description("View conversation history and thumbnails")
     .action(async (chatId) => {
+    let spinner = null;
     try {
         const client = new ThumbnailGPTClient();
-        const spinner = ora("Fetching thread...").start();
+        spinner = ora("Fetching thread...").start();
         const res = await client.getChat(chatId);
         spinner.stop();
         console.log(pc.bold(`\nThread: ${res.chat?.title || chatId}\n`));
@@ -247,11 +332,79 @@ chats
         console.log();
     }
     catch (err) {
-        console.error(pc.red(`\n❌ Error: ${err.message}`));
-        process.exit(1);
+        handleError(err, spinner);
+    }
+});
+chats
+    .command("delete <chatId>")
+    .description("Permanently delete a chat conversation thread (restricted to web app)")
+    .action((chatId) => {
+    console.log(pc.yellow("\nSecurity Notice: Destructive deletions are disabled via the CLI to protect your account and generation history."));
+    console.log(`Please delete conversations directly in the ThumbnailGPT web application at:\n${pc.cyan(`https://thumbnailgpt.com/studio/${chatId}`)}\n`);
+});
+// 7. Thumbnails Management
+const thumbnailsCmd = program
+    .command("thumbnails")
+    .description("Manage and download generated thumbnails");
+thumbnailsCmd
+    .command("get <thumbnailId>")
+    .description("Get detailed information about a thumbnail by ID")
+    .action(async (thumbnailId) => {
+    let spinner = null;
+    try {
+        const client = new ThumbnailGPTClient();
+        spinner = ora("Fetching thumbnail details...").start();
+        const thumb = await client.getThumbnail(thumbnailId);
+        spinner.stop();
+        console.log(pc.bold("\nThumbnail Details:"));
+        console.log(pc.dim("--------------------------------------------------------------------------------"));
+        console.log(`${pc.bold("ID:")}           ${thumb.id}`);
+        console.log(`${pc.bold("Status:")}       ${thumb.status === "completed" || thumb.status === "success" ? pc.green(thumb.status) : pc.yellow(thumb.status || "unknown")}`);
+        console.log(`${pc.bold("Prompt:")}       ${thumb.prompt || "(no prompt)"}`);
+        console.log(`${pc.bold("Ratio:")}        ${thumb.aspect_ratio || "16:9"}`);
+        console.log(`${pc.bold("Resolution:")}   ${thumb.resolution || "1K"}`);
+        if (thumb.chat_id) {
+            console.log(`${pc.bold("Chat ID:")}      ${thumb.chat_id}`);
+        }
+        if (thumb.thumbnail_url) {
+            console.log(`${pc.bold("Image URL:")}    ${pc.cyan(thumb.thumbnail_url)}`);
+        }
+        if (thumb.error_reason) {
+            console.log(`${pc.bold("Error:")}        ${pc.red(thumb.error_reason)}`);
+        }
+        console.log(`${pc.bold("Created:")}      ${new Date(thumb.created_at).toLocaleString()}`);
+        console.log(pc.dim("--------------------------------------------------------------------------------\n"));
+    }
+    catch (err) {
+        handleError(err, spinner);
+    }
+});
+thumbnailsCmd
+    .command("url <thumbnailId>")
+    .description("Get the hosted image URL for a thumbnail")
+    .action(async (thumbnailId) => {
+    try {
+        const client = new ThumbnailGPTClient();
+        const thumb = await client.getThumbnail(thumbnailId);
+        if (!thumb.thumbnail_url) {
+            console.error(pc.yellow(`Thumbnail is not ready yet (status: ${thumb.status || "processing"})`));
+            process.exitCode = 1;
+            return;
+        }
+        console.log(thumb.thumbnail_url);
+    }
+    catch (err) {
+        handleError(err);
     }
 });
-// 7. Creator Personas
+thumbnailsCmd
+    .command("delete <thumbnailId>")
+    .description("Permanently delete a thumbnail by ID (restricted to web app)")
+    .action((thumbnailId) => {
+    console.log(pc.yellow("\nSecurity Notice: Destructive deletions are disabled via the CLI to protect your account."));
+    console.log(`Please manage or delete your thumbnails directly in the ThumbnailGPT web application at:\n${pc.cyan("https://thumbnailgpt.com/studio")}\n`);
+});
+// 8. Creator Personas
 const personasCmd = program
     .command("personas")
     .description("Inspect active creator personas for thumbnail generation");
@@ -259,14 +412,15 @@ personasCmd
     .command("list")
     .description("List your active creator personas (only ready personas are shown)")
     .action(async () => {
+    let spinner = null;
     try {
         const client = new ThumbnailGPTClient();
-        const spinner = ora("Fetching active personas...").start();
+        spinner = ora("Fetching active personas...").start();
         const personas = await client.getPersonas();
         spinner.stop();
         if (personas.length === 0) {
             console.log(pc.yellow("\nNo active personas found."));
-            console.log(`Train your first persona in the Web Studio at: ${pc.cyan("https://thumbnailgpt.com/studio")}\n`);
+            console.log(`Create your first persona in ThumbnailGPT at: ${pc.cyan("https://thumbnailgpt.com/studio")}\n`);
             return;
         }
         console.log(pc.bold("\nActive Creator Personas:"));
@@ -279,8 +433,7 @@ personasCmd
         console.log(`Use in generation: ${pc.green('npx thumbnailgpt generate "..." --persona <id>')}\n`);
     }
     catch (err) {
-        console.error(pc.red(`\n❌ Error: ${err.message}`));
-        process.exit(1);
+        handleError(err, spinner);
     }
 });
 personasCmd
@@ -289,14 +442,7 @@ personasCmd
     .action(() => {
     console.log(pc.bold("\nTraining New Creator Personas:"));
     console.log("For quality and privacy, persona creation requires interactive multi-angle photo upload");
-    console.log("and face consistency training, which is exclusively supported in the Web Studio.");
-    console.log(`\n👉 Create your persona at: ${pc.cyan("https://thumbnailgpt.com/studio")}\n`);
-});
-// 8. MCP Server Mode
-program
-    .command("mcp")
-    .description("Run the ThumbnailGPT MCP server via standard I/O (stdio)")
-    .action(async () => {
-    await runMcpServer();
+    console.log("and face consistency training, supported in the ThumbnailGPT web application.");
+    console.log(`\nCreate your persona at: ${pc.cyan("https://thumbnailgpt.com/studio")}\n`);
 });
 program.parse(process.argv);

package/dist/types.d.ts CHANGED Viewed

@@ -33,6 +33,8 @@ export interface ThumbnailItem {
     status?: string;
     error_reason?: string;
     prompt?: string;
+    aspect_ratio?: string;
+    resolution?: string;
     created_at: string;
 }
 export interface ChatMessageItem {

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "thumbnailgpt",
-  "version": "1.0.5",
-  "description": "Official CLI and Model Context Protocol (MCP) server for ThumbnailGPT",
+  "version": "1.0.7",
+  "description": "Official CLI for ThumbnailGPT — Generate, iterate, and manage viral YouTube thumbnails directly from your terminal",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,22 +17,33 @@
     "build": "tsc",
     "prepublishOnly": "npm run build",
     "start": "node dist/index.js",
-    "mcp": "node dist/index.js mcp"
+    "test": "tsx test-production.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vivekrao007/thumbnailgpt-v3.git",
+    "directory": "cli"
+  },
+  "homepage": "https://thumbnailgpt.com",
+  "bugs": {
+    "url": "https://thumbnailgpt.com"
   },
   "keywords": [
     "thumbnailgpt",
-    "mcp",
-    "model-context-protocol",
+    "youtube-thumbnails",
     "youtube",
-    "thumbnails",
+    "thumbnail",
+    "cli",
     "ai",
-    "claude-desktop",
-    "cursor"
+    "flux",
+    "image-generation",
+    "content-creator",
+    "terminal",
+    "mcp"
   ],
-  "author": "ThumbnailGPT",
+  "author": "ThumbnailGPT <support@thumbnailgpt.com>",
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.6.1",
     "commander": "^13.1.0",
     "conf": "^13.1.0",
     "ora": "^8.2.0",

package/dist/mcp.d.ts DELETED Viewed

	@@ -1 +0,0 @@
1	- export declare function runMcpServer(): Promise<void>;

package/dist/mcp.js DELETED Viewed

@@ -1,231 +0,0 @@
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { ThumbnailGPTClient } from "./client.js";
-import { getApiKey } from "./config.js";
-export async function runMcpServer() {
-    const apiKey = getApiKey();
-    if (!apiKey) {
-        console.error(JSON.stringify({
-            error: "Missing THUMBNAILGPT_API_KEY. Set it in your environment or run 'thumbnailgpt login'.",
-        }));
-        process.exit(1);
-    }
-    const client = new ThumbnailGPTClient(apiKey);
-    const server = new Server({
-        name: "thumbnailgpt-mcp",
-        version: "1.0.5",
-    }, {
-        capabilities: {
-            tools: {},
-        },
-    });
-    // 1. List available tools
-    server.setRequestHandler(ListToolsRequestSchema, async () => {
-        return {
-            tools: [
-                {
-                    name: "thumbnailgpt_generate",
-                    description: "Create or iteratively refine high-CTR YouTube thumbnails using ThumbnailGPT Studio. Supports aspect ratios, reference images, creator personas, and resolution tiers.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            prompt: {
-                                type: "string",
-                                description: "Detailed instructions for thumbnail creation, style direction, text overlays, or visual tweaks.",
-                            },
-                            chatId: {
-                                type: "string",
-                                description: "Optional UUID of an existing conversation thread to iterate on. Omit to start a new chat.",
-                            },
-                            aspectRatio: {
-                                type: "string",
-                                enum: ["16:9", "9:16"],
-                                default: "16:9",
-                                description: "16:9 for YouTube standard videos, 9:16 for Shorts / Reels.",
-                            },
-                            resolution: {
-                                type: "string",
-                                enum: ["1K", "2K", "4K"],
-                                default: "1K",
-                                description: "1K (10 credits), 2K (20 credits), 4K (30 credits).",
-                            },
-                            referenceImages: {
-                                type: "array",
-                                items: { type: "string" },
-                                description: "Up to 5 reference image URLs or base64 strings.",
-                            },
-                            youtubeUrl: {
-                                type: "string",
-                                description: "Optional YouTube video URL for context.",
-                            },
-                            baseImage: {
-                                type: "string",
-                                description: "Base image URL for inpainting / iterations.",
-                            },
-                            personaId: {
-                                type: "string",
-                                description: "Optional UUID of an active Creator Persona to feature in the thumbnail. Get available persona IDs with thumbnailgpt_get_personas.",
-                            },
-                        },
-                        required: ["prompt"],
-                    },
-                },
-                {
-                    name: "thumbnailgpt_get_personas",
-                    description: "Retrieve active, ready-to-use creator personas. Returns safe identifiers (id, name, created_at). Image URLs, internal storage paths, and failed personas are strictly omitted for privacy and security. (Note: New personas can only be trained in the Web UI at https://thumbnailgpt.com/studio).",
-                    inputSchema: {
-                        type: "object",
-                        properties: {},
-                    },
-                },
-                {
-                    name: "thumbnailgpt_get_credits",
-                    description: "Retrieve current ThumbnailGPT available credit balance, subscription status, and resolution cost tiers.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {},
-                    },
-                },
-                {
-                    name: "thumbnailgpt_list_chats",
-                    description: "List recent ThumbnailGPT studio conversations and thumbnail sessions.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {},
-                    },
-                },
-                {
-                    name: "thumbnailgpt_get_chat",
-                    description: "Retrieve full message history and generated thumbnails for a studio conversation.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            chatId: {
-                                type: "string",
-                                description: "UUID of the conversation thread to inspect.",
-                            },
-                        },
-                        required: ["chatId"],
-                    },
-                },
-            ],
-        };
-    });
-    // 2. Handle tool execution
-    server.setRequestHandler(CallToolRequestSchema, async (request) => {
-        const { name, arguments: args } = request.params;
-        try {
-            if (name === "thumbnailgpt_get_credits") {
-                const credits = await client.getCredits();
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: JSON.stringify({
-                                availableCredits: credits.credits,
-                                subscriptionStatus: credits.subscription_status,
-                                costs: { "1K": "10 credits", "2K": "20 credits", "4K": "30 credits" },
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-            if (name === "thumbnailgpt_get_personas") {
-                const personas = await client.getPersonas();
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: JSON.stringify({
-                                personas,
-                                count: personas.length,
-                                guidance: "Pass the persona 'id' to thumbnailgpt_generate as 'personaId' to render the creator in the thumbnail. To create new personas, use the Web UI at https://thumbnailgpt.com/studio.",
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-            if (name === "thumbnailgpt_generate") {
-                const prompt = args?.prompt || "";
-                const chatId = args?.chatId;
-                const aspectRatio = args?.aspectRatio || "16:9";
-                const resolution = args?.resolution || "1K";
-                const referenceImages = args?.referenceImages;
-                const youtubeUrl = args?.youtubeUrl;
-                const baseImage = args?.baseImage;
-                const personaId = args?.personaId;
-                const result = await client.generateAndWait({
-                    prompt,
-                    chatId,
-                    aspectRatio,
-                    resolution,
-                    referenceImages,
-                    youtubeUrl,
-                    baseImage,
-                    personaId,
-                });
-                if (!result.success || !result.imageUrl) {
-                    return {
-                        isError: true,
-                        content: [
-                            {
-                                type: "text",
-                                text: `❌ Thumbnail generation failed: ${result.error || "Unknown error"}\nChat ID: ${result.chatId}`,
-                            },
-                        ],
-                    };
-                }
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `✅ Thumbnail successfully generated!\n\n` +
-                                `**Preview**: ![Generated Thumbnail](${result.imageUrl})\n\n` +
-                                `**Direct Image URL**: ${result.imageUrl}\n` +
-                                `**Conversation Thread ID**: \`${result.chatId}\` (pass this \`chatId\` to iterate or refine)\n` +
-                                `**Remaining Credits**: ${result.creditsRemaining ?? "N/A"}\n` +
-                                `**Web Studio Link**: https://thumbnailgpt.com/studio/${result.chatId}`,
-                        },
-                    ],
-                };
-            }
-            if (name === "thumbnailgpt_list_chats") {
-                const chats = await client.listChats();
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: JSON.stringify(chats, null, 2),
-                        },
-                    ],
-                };
-            }
-            if (name === "thumbnailgpt_get_chat") {
-                const chatId = args?.chatId;
-                const thread = await client.getChat(chatId);
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: JSON.stringify(thread, null, 2),
-                        },
-                    ],
-                };
-            }
-            return {
-                isError: true,
-                content: [{ type: "text", text: `Unknown tool: ${name}` }],
-            };
-        }
-        catch (err) {
-            return {
-                isError: true,
-                content: [{ type: "text", text: `Error: ${err.message || String(err)}` }],
-            };
-        }
-    });
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    console.error("ThumbnailGPT MCP server running on stdio");
-}