gobananas-cli 1.0.1

package/dist/commands/mcp-help.js

@@ -0,0 +1,264 @@
+/**
+ * MCP Help Command
+ *
+ * Get help from the MCP server about available tools and workflows.
+ */
+import { Command } from 'commander';
+import { createTransport, getTransportName } from '../transport/index.js';
+import * as output from '../utils/output.js';
+import { getSecurityWarning } from '../config/config.js';
+export function createMcpHelpCommand() {
+    const cmd = new Command('mcp-help')
+        .description('Get help from the Go Bananas MCP server')
+        .argument('[tool]', 'Get help for a specific tool (e.g., generate_image)')
+        .option('-c, --category <name>', 'Filter by category (generation, editing, characters, products, styles, analytics)')
+        .option('-w, --workflow <name>', 'Get workflow guidance (consistent_characters, conversational_editing, product_marketing, style_branding)')
+        .option('--json', 'Output raw JSON response')
+        .action(async (tool, options) => {
+        const securityWarning = getSecurityWarning();
+        if (securityWarning) {
+            output.warning(securityWarning);
+        }
+        const spin = output.spinner('Fetching help...');
+        try {
+            const transport = await createTransport();
+            spin.text = `Connected via ${getTransportName(transport.type)}. Loading help...`;
+            const params = {};
+            if (tool) {
+                params.toolName = tool;
+            }
+            if (options.category) {
+                params.category = options.category;
+            }
+            if (options.workflow) {
+                params.workflow = options.workflow;
+            }
+            let result;
+            if (transport.type === 'mcp' && transport.mcp) {
+                const mcpResult = await transport.mcp.getHelp(params);
+                const text = mcpResult.content?.[0]?.text || '';
+                try {
+                    result = JSON.parse(text);
+                }
+                catch {
+                    // If not JSON, display as markdown/text
+                    spin.stop();
+                    if (options.json) {
+                        output.json({ text });
+                    }
+                    else {
+                        console.log(text);
+                    }
+                    return;
+                }
+            }
+            else if (transport.rest) {
+                // REST doesn't have a help endpoint, show local help
+                spin.stop();
+                showLocalHelp(tool, options.category, options.workflow);
+                return;
+            }
+            else {
+                throw new Error('No transport available');
+            }
+            spin.stop();
+            if (options.json) {
+                output.json(result);
+            }
+            else {
+                displayHelpResult(result);
+            }
+        }
+        catch (err) {
+            spin.stop();
+            output.error(err instanceof Error ? err.message : 'Failed to get help');
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+/**
+ * Display help result in formatted output
+ */
+function displayHelpResult(data) {
+    // Overview
+    if (data.overview) {
+        console.log(data.overview);
+        return;
+    }
+    // Tool-specific help
+    const tool = data.tool;
+    if (tool) {
+        output.header(`Tool: ${tool.name}`);
+        console.log();
+        console.log(tool.description);
+        const params = tool.parameters;
+        if (params && params.length > 0) {
+            output.newline();
+            output.header('Parameters');
+            for (const param of params) {
+                const required = param.required ? ' (required)' : '';
+                console.log(`  • ${param.name}${required}: ${param.type}`);
+                if (param.description) {
+                    console.log(`    ${param.description}`);
+                }
+            }
+        }
+        const examples = tool.examples;
+        if (examples && examples.length > 0) {
+            output.newline();
+            output.header('Examples');
+            for (const example of examples) {
+                console.log(`  ${example}`);
+            }
+        }
+        const related = tool.relatedTools;
+        if (related && related.length > 0) {
+            output.newline();
+            output.info(`Related tools: ${related.join(', ')}`);
+        }
+        return;
+    }
+    // Category help
+    const category = data.category;
+    if (category) {
+        output.header(`Category: ${category.name}`);
+        const tools = category.tools;
+        if (tools) {
+            output.newline();
+            for (const t of tools) {
+                console.log(`  • ${t.name}: ${t.description}`);
+            }
+        }
+        return;
+    }
+    // Workflow help
+    const workflow = data.workflow;
+    if (workflow) {
+        output.header(`Workflow: ${workflow.name}`);
+        console.log();
+        console.log(workflow.description);
+        const steps = workflow.steps;
+        if (steps && steps.length > 0) {
+            output.newline();
+            output.header('Steps');
+            for (let i = 0; i < steps.length; i++) {
+                console.log(`  ${i + 1}. ${steps[i]}`);
+            }
+        }
+        const examples = workflow.examples;
+        if (examples && examples.length > 0) {
+            output.newline();
+            output.header('Examples');
+            for (const example of examples) {
+                console.log(`  ${example}`);
+            }
+        }
+        return;
+    }
+    // Fallback: just display raw data
+    output.json(data);
+}
+/**
+ * Show local help when REST doesn't support help endpoint
+ */
+function showLocalHelp(tool, category, workflow) {
+    if (tool) {
+        output.info(`Help for tool "${tool}" is only available via MCP transport.`);
+        output.tip('Use "gb config transport mcp" to switch to MCP mode.');
+        return;
+    }
+    if (category) {
+        const categories = {
+            generation: ['generate_image', 'generate_with_character', 'generate_with_multiple_characters', 'generate_with_product'],
+            editing: ['edit_image', 'edit_uploaded_image', 'continue_editing', 'upload_image_for_editing'],
+            characters: ['create_character', 'update_character', 'delete_character', 'list_characters', 'get_character'],
+            products: ['create_product_reference', 'delete_product_reference', 'list_product_references', 'get_product_reference'],
+            styles: ['create_style_preset', 'update_style_preset', 'delete_style_preset', 'list_style_presets'],
+            analytics: ['get_usage_stats', 'get_account_summary', 'get_session_history', 'search_images', 'get_image_info'],
+        };
+        const tools = categories[category];
+        if (tools) {
+            output.header(`Category: ${category}`);
+            output.newline();
+            for (const t of tools) {
+                console.log(`  • ${t}`);
+            }
+        }
+        else {
+            output.error(`Unknown category: ${category}`);
+            output.info('Available categories: generation, editing, characters, products, styles, analytics');
+        }
+        return;
+    }
+    if (workflow) {
+        const workflows = {
+            consistent_characters: {
+                description: 'Create consistent characters across multiple scenes',
+                steps: [
+                    '1. Generate initial character image: gb generate "your character description"',
+                    '2. Save the character: gb char create "CharName" --prompt "description" --refs <image-id>',
+                    '3. Generate scenes: gb char use "CharName" "scene description"',
+                ],
+            },
+            conversational_editing: {
+                description: 'Iteratively edit images in a conversation',
+                steps: [
+                    '1. Generate initial image: gb generate "your prompt"',
+                    '2. Continue editing: gb continue "add more clouds"',
+                    '3. Keep refining: gb continue "make it brighter"',
+                ],
+            },
+            product_marketing: {
+                description: 'Generate marketing images with product references',
+                steps: [
+                    '1. Save product: gb prod create "ProductName" --url "https://..."',
+                    '2. Generate scenes: gb prod use "ProductName" "on a wooden desk"',
+                ],
+            },
+            style_branding: {
+                description: 'Maintain consistent style across generations',
+                steps: [
+                    '1. Create style preset: gb style create "BrandStyle" --prompt "style description"',
+                    '2. Use in generation: gb generate "subject" --style-preset "BrandStyle"',
+                ],
+            },
+        };
+        const wf = workflows[workflow];
+        if (wf) {
+            output.header(`Workflow: ${workflow}`);
+            console.log();
+            console.log(wf.description);
+            output.newline();
+            for (const step of wf.steps) {
+                console.log(`  ${step}`);
+            }
+        }
+        else {
+            output.error(`Unknown workflow: ${workflow}`);
+            output.info('Available workflows: consistent_characters, conversational_editing, product_marketing, style_branding');
+        }
+        return;
+    }
+    // Default overview
+    output.header('Go Bananas CLI Help');
+    console.log();
+    console.log('Use mcp-help to get detailed documentation from the server.');
+    output.newline();
+    output.header('Categories');
+    console.log('  • generation - Image generation tools');
+    console.log('  • editing    - Image editing tools');
+    console.log('  • characters - Character reference management');
+    console.log('  • products   - Product reference management');
+    console.log('  • styles     - Style preset management');
+    console.log('  • analytics  - Usage stats and account info');
+    output.newline();
+    output.header('Workflows');
+    console.log('  • consistent_characters   - Multi-scene character consistency');
+    console.log('  • conversational_editing  - Iterative image refinement');
+    console.log('  • product_marketing       - Product-based marketing images');
+    console.log('  • style_branding          - Consistent style across images');
+    output.newline();
+    output.tip('Run "gb mcp-help <tool-name>" for specific tool documentation.');
+}
+//# sourceMappingURL=mcp-help.js.map

package/dist/commands/mcp-help.js.map

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

package/dist/commands/mcp.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP Proxy Command
+ *
+ * Runs a stdio MCP server that proxies requests to the remote Go Bananas MCP endpoint.
+ * Intended for MCP clients that require stdio (Claude Desktop, Cursor, Codex, etc).
+ */
+import { Command } from 'commander';
+export declare function createMcpProxyCommand(): Command;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/commands/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,wBAAgB,qBAAqB,IAAI,OAAO,CAqB/C"}

package/dist/commands/mcp.js

@@ -0,0 +1,25 @@
+/**
+ * MCP Proxy Command
+ *
+ * Runs a stdio MCP server that proxies requests to the remote Go Bananas MCP endpoint.
+ * Intended for MCP clients that require stdio (Claude Desktop, Cursor, Codex, etc).
+ */
+import { Command } from 'commander';
+import { runGoBananasMcpStdioProxy } from '../mcp/stdio-proxy.js';
+export function createMcpProxyCommand() {
+    const cmd = new Command('mcp').description('Run the Go Bananas MCP stdio proxy');
+    cmd
+        .option('--server-url <url>', 'Base URL for Go Bananas server (default: config/serverUrl)')
+        .option('--api-key <key>', 'Go Bananas API key (default: GO_BANANAS_API_KEY/MCP_API_KEY/config)')
+        .option('--transport <mode>', 'Upstream transport: auto, streamable-http, or sse (default: auto)', 'auto')
+        .action(async (options) => {
+        const transport = options.transport;
+        await runGoBananasMcpStdioProxy({
+            serverUrl: options.serverUrl,
+            apiKey: options.apiKey,
+            transport,
+        });
+    });
+    return cmd;
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,yBAAyB,EAA8B,MAAM,uBAAuB,CAAC;AAE9F,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,oCAAoC,CAAC,CAAC;IAEjF,GAAG;SACA,MAAM,CAAC,oBAAoB,EAAE,4DAA4D,CAAC;SAC1F,MAAM,CAAC,iBAAiB,EAAE,qEAAqE,CAAC;SAChG,MAAM,CACL,oBAAoB,EACpB,mEAAmE,EACnE,MAAM,CACP;SACA,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,SAAS,GAAG,OAAO,CAAC,SAAkC,CAAC;QAC7D,MAAM,yBAAyB,CAAC;YAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS;SACV,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/commands/product.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Product Commands
+ *
+ * Commands for managing and using product references for marketing.
+ */
+import { Command } from 'commander';
+export declare function createProductCommand(): Command;
+//# sourceMappingURL=product.d.ts.map

package/dist/commands/product.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.d.ts","sourceRoot":"","sources":["../../src/commands/product.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,oBAAoB,IAAI,OAAO,CAkT9C"}

package/dist/commands/product.js

@@ -0,0 +1,316 @@
+/**
+ * Product Commands
+ *
+ * Commands for managing and using product references for marketing.
+ */
+import { Command } from 'commander';
+import { createTransport } from '../transport/index.js';
+import { downloadImage } from '../utils/file-handler.js';
+import * as output from '../utils/output.js';
+export function createProductCommand() {
+    const cmd = new Command('product')
+        .alias('prod')
+        .description('Manage product references for marketing image generation');
+    // List products
+    cmd
+        .command('list')
+        .alias('ls')
+        .description('List all saved product references')
+        .option('-s, --search <query>', 'Search by name, description, or tags')
+        .option('-p, --page <number>', 'Page number', '1')
+        .option('--page-size <number>', 'Items per page', '20')
+        .option('--json', 'Output raw JSON response')
+        .action(async (options) => {
+        const spin = output.spinner('Loading products...');
+        try {
+            const transport = await createTransport();
+            let result;
+            if (transport.type === 'mcp' && transport.mcp) {
+                const mcpResult = await transport.mcp.listProductReferences({
+                    search: options.search,
+                    page: parseInt(options.page, 10),
+                    pageSize: parseInt(options.pageSize, 10),
+                });
+                result = { raw: mcpResult.content?.[0]?.text };
+            }
+            else if (transport.rest) {
+                const restResult = await transport.rest.listProducts({
+                    search: options.search,
+                    page: parseInt(options.page, 10),
+                    pageSize: parseInt(options.pageSize, 10),
+                });
+                result = restResult;
+            }
+            else {
+                throw new Error('No transport available');
+            }
+            spin.stop();
+            if (options.json) {
+                output.json(result);
+            }
+            else {
+                const r = result;
+                if (r.raw) {
+                    console.log(r.raw);
+                }
+                else if (r.data && Array.isArray(r.data)) {
+                    output.header(`Products (${r.data.length})`);
+                    for (const prod of r.data) {
+                        output.productInfo(prod);
+                    }
+                    if (r.pagination) {
+                        const p = r.pagination;
+                        if (p.hasMore) {
+                            output.newline();
+                            output.info(`Use --page ${(p.page || 1) + 1} to see more.`);
+                        }
+                    }
+                }
+                else {
+                    output.info('No products found. Use "gb prod create" to save one!');
+                }
+            }
+        }
+        catch (err) {
+            spin.stop();
+            output.error(err instanceof Error ? err.message : 'Failed to list products');
+            process.exit(1);
+        }
+    });
+    // Get product details
+    cmd
+        .command('get <nameOrId>')
+        .description('Get details of a specific product')
+        .option('--json', 'Output raw JSON response')
+        .action(async (nameOrId, options) => {
+        const spin = output.spinner('Loading product...');
+        try {
+            const transport = await createTransport();
+            const params = isNaN(parseInt(nameOrId, 10))
+                ? { productName: nameOrId }
+                : { id: parseInt(nameOrId, 10) };
+            let result;
+            if (transport.type === 'mcp' && transport.mcp) {
+                const mcpResult = await transport.mcp.getProductReference(params);
+                result = { raw: mcpResult.content?.[0]?.text };
+            }
+            else if (transport.rest) {
+                const restResult = await transport.rest.getProduct(nameOrId);
+                result = restResult;
+            }
+            else {
+                throw new Error('No transport available');
+            }
+            spin.stop();
+            if (options.json) {
+                output.json(result);
+            }
+            else {
+                const r = result;
+                if (r.raw) {
+                    console.log(r.raw);
+                }
+                else if (r.data) {
+                    const prod = r.data;
+                    output.header(`Product: ${prod.productName || prod.name}`);
+                    output.keyValue('ID', prod.id);
+                    if (prod.productDescription)
+                        output.keyValue('Description', prod.productDescription);
+                    output.keyValue('Source URL', prod.productUrl);
+                    output.keyValue('Times Used', prod.timesUsed);
+                    if (prod.tags)
+                        output.keyValue('Tags', prod.tags);
+                    if (prod.fullUrl)
+                        output.keyValue('Image URL', prod.fullUrl);
+                }
+            }
+        }
+        catch (err) {
+            spin.stop();
+            output.error(err instanceof Error ? err.message : 'Failed to get product');
+            process.exit(1);
+        }
+    });
+    // Create product
+    cmd
+        .command('create <name>')
+        .description('Save a product image from a URL')
+        .requiredOption('-u, --url <url>', 'URL of the product image')
+        .option('-d, --description <text>', 'Product description')
+        .option('--tags <tags>', 'Comma-separated tags')
+        .option('--json', 'Output raw JSON response')
+        .action(async (name, options) => {
+        const spin = output.spinner('Saving product reference...');
+        try {
+            const transport = await createTransport();
+            const params = {
+                productName: name,
+                productUrl: options.url,
+                productDescription: options.description,
+                tags: options.tags,
+            };
+            let result;
+            if (transport.type === 'mcp' && transport.mcp) {
+                const mcpResult = await transport.mcp.createProductReference(params);
+                result = { raw: mcpResult.content?.[0]?.text };
+            }
+            else if (transport.rest) {
+                const restResult = await transport.rest.createProduct(params);
+                result = restResult;
+            }
+            else {
+                throw new Error('No transport available');
+            }
+            spin.stop();
+            if (options.json) {
+                output.json(result);
+            }
+            else {
+                const r = result;
+                if (r.raw) {
+                    console.log(r.raw);
+                }
+                else {
+                    output.success(`Product "${name}" saved successfully!`);
+                    if (r.data) {
+                        const prod = r.data;
+                        output.keyValue('ID', prod.id);
+                    }
+                    output.newline();
+                    output.tip(`Use "gb prod use '${name}' '<scene>'" to generate marketing images`);
+                }
+            }
+        }
+        catch (err) {
+            spin.stop();
+            output.error(err instanceof Error ? err.message : 'Failed to create product');
+            process.exit(1);
+        }
+    });
+    // Delete product
+    cmd
+        .command('delete <nameOrId>')
+        .alias('rm')
+        .description('Delete a saved product reference')
+        .option('--json', 'Output raw JSON response')
+        .action(async (nameOrId, options) => {
+        const spin = output.spinner('Deleting product...');
+        try {
+            const transport = await createTransport();
+            const params = isNaN(parseInt(nameOrId, 10))
+                ? { productName: nameOrId }
+                : { id: parseInt(nameOrId, 10) };
+            let result;
+            if (transport.type === 'mcp' && transport.mcp) {
+                const mcpResult = await transport.mcp.deleteProductReference(params);
+                result = { raw: mcpResult.content?.[0]?.text };
+            }
+            else if (transport.rest) {
+                await transport.rest.deleteProduct(nameOrId);
+                result = { deleted: true };
+            }
+            else {
+                throw new Error('No transport available');
+            }
+            spin.stop();
+            if (options.json) {
+                output.json(result);
+            }
+            else {
+                const r = result;
+                if (r.raw) {
+                    console.log(r.raw);
+                }
+                else {
+                    output.success(`Product "${nameOrId}" deleted successfully!`);
+                }
+            }
+        }
+        catch (err) {
+            spin.stop();
+            output.error(err instanceof Error ? err.message : 'Failed to delete product');
+            process.exit(1);
+        }
+    });
+    // Generate with product
+    cmd
+        .command('use <nameOrId> <scene>')
+        .alias('gen')
+        .description('Generate a marketing image with a saved product')
+        .option('--details <text>', 'Additional scene details')
+        .option('-a, --aspect <ratio>', 'Aspect ratio')
+        .option('--negative <prompt>', 'Negative prompt')
+        .option('-n, --count <number>', 'Number of images (1-4)', '1')
+        .option('-d, --download', 'Download the generated image')
+        .option('-o, --output <path>', 'Output path for downloaded image')
+        .option('--json', 'Output raw JSON response')
+        .action(async (nameOrId, scene, options) => {
+        const spin = output.spinner('Generating marketing image...');
+        try {
+            const transport = await createTransport();
+            const isId = !isNaN(parseInt(nameOrId, 10));
+            const params = {
+                ...(isId ? { productId: parseInt(nameOrId, 10) } : { productName: nameOrId }),
+                scenePrompt: scene,
+                additionalDetails: options.details,
+                aspectRatio: options.aspect,
+                negativePrompt: options.negative,
+                numberOfImages: parseInt(options.count, 10),
+            };
+            let result;
+            if (transport.type === 'mcp' && transport.mcp) {
+                const mcpResult = await transport.mcp.generateWithProduct(params);
+                const text = mcpResult.content?.[0]?.text || '';
+                const urlMatch = text.match(/https?:\/\/[^\s)]+/);
+                const idMatch = text.match(/ID:\s*(\d+)/);
+                result = {
+                    url: urlMatch?.[0],
+                    id: idMatch ? parseInt(idMatch[1], 10) : undefined,
+                    raw: text,
+                };
+            }
+            else if (transport.rest) {
+                const restResult = await transport.rest.generateWithProduct(params);
+                result = restResult.data;
+            }
+            else {
+                throw new Error('No transport available');
+            }
+            spin.stop();
+            if (options.json) {
+                output.json(result);
+            }
+            else {
+                const r = result;
+                output.success('Marketing image generated!');
+                if (r.id)
+                    output.keyValue('ID', r.id);
+                const url = (r.url || r.fullUrl);
+                if (url)
+                    output.keyValue('URL', url);
+                if (options.download && url) {
+                    output.newline();
+                    const downloadSpin = output.spinner('Downloading image...');
+                    try {
+                        const savedPath = await downloadImage(url, options.output);
+                        downloadSpin.succeed(`Saved to: ${savedPath}`);
+                    }
+                    catch (err) {
+                        downloadSpin.fail(`Download failed: ${err instanceof Error ? err.message : 'Unknown error'}`);
+                    }
+                }
+                if (r.raw && !url) {
+                    output.newline();
+                    console.log(r.raw);
+                }
+            }
+        }
+        catch (err) {
+            spin.stop();
+            output.error(err instanceof Error ? err.message : 'Failed to generate with product');
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=product.js.map