bazaar.it 0.1.0 → 0.2.0

package/README.md

@@ -1,5 +1,491 @@
-# bazaar.it
+# BAZ CLI
 
-AI-powered motion graphics from the command line.
+**AI-powered video generation from your terminal.**
 
-Visit [bazaar.it](https://bazaar.it) for more info.
+```
+██████╗  █████╗ ███████╗
+██╔══██╗██╔══██╗╚══███╔╝
+██████╔╝███████║  ███╔╝
+██╔══██╗██╔══██║ ███╔╝
+██████╔╝██║  ██║███████╗
+╚═════╝ ╚═╝  ╚═╝╚══════╝
+```
+
+Programmatic access to Bazaar video generation for external agents, automation, and power users.
+
+## Installation
+
+```bash
+# From npm
+npm install -g bazaar.it
+
+# From repo (recommended for development)
+cd cli
+npm install
+npm run build
+
+# Link globally (optional)
+npm link
+```
+
+Or run directly with tsx during development:
+```bash
+npx tsx src/index.ts <command>
+```
+
+## Quick Start
+
+```bash
+# 1. Authenticate
+baz auth login <your-api-key>
+
+# 2. Set a project
+baz project list
+baz project create --name "My Video Project" --format landscape
+baz project use <project-id>
+
+# 3. Generate!
+baz prompt "Create an intro scene with the text 'Hello World' in neon colors"
+
+# Agent-friendly mode
+export BAZ_AGENT=1
+baz prompt "Create an intro scene with the text 'Hello World' in neon colors"
+```
+
+## Interactive Mode (REPL)
+
+Run `baz` without arguments to enter interactive mode:
+
+```bash
+$ baz
+
+██████╗  █████╗ ███████╗
+██╔══██╗██╔══██╗╚══███╔╝
+██████╔╝███████║  ███╔╝
+██╔══██╗██╔══██║ ███╔╝
+██████╔╝██║  ██║███████╗
+╚═════╝ ╚═╝  ╚═╝╚══════╝
+
+AI-powered video generation v0.1.0
+─────────────────────────────────────
+Type a command or prompt. Use 'help' for commands.
+
+baz> project list
+baz> prompt "Create an intro scene"
+baz> exit
+```
+
+Features:
+- Tab completion for commands
+- Persistent session state
+- History navigation with arrow keys
+- Commands work without `baz` prefix
+
+## Commands
+
+### Authentication
+
+```bash
+# Login with API key
+baz auth login <api-key>
+
+# Check authentication status
+baz auth status
+
+# Logout
+baz auth logout
+```
+
+**Get an API Key:**
+1. **For humans**: Generate at https://bazaar.it/settings/api-keys
+2. **For service accounts**: Use the admin script:
+   ```bash
+   npx tsx scripts/create-service-account.ts maya@bazaar.it "Maya Bot" "Maya CLI"
+   ```
+
+### Projects
+
+```bash
+# List your projects
+baz project list
+
+# Create a new project
+baz project create --name "My Video Project"
+baz project create --name "TikTok Hook" --format portrait
+
+# Set active project (used by default for all commands)
+baz project use <project-id>
+
+# Show current project
+baz project current
+```
+
+### Prompts
+
+The main command for AI video generation:
+
+```bash
+# Basic prompt
+baz prompt "Create a 10 second intro with a blue gradient background"
+
+# With images attached
+baz prompt "Recreate this design" --image ./design.png --image ./logo.png
+
+# With URL context (fetches and analyzes the URL)
+baz prompt "Create a video based on this article" --url https://example.com/article
+
+# Agent-max mode (more thorough, takes longer)
+baz prompt "Complex animation sequence" --max
+
+# Read prompt from file
+baz prompt "Use the script" --file ./script.txt
+
+# Show full agent response
+baz prompt "Create something cool" --verbose
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--mode <mode>` | Generation mode: `agent` (default), `agent-max`, `multi-scene` |
+| `--max` | Shorthand for `--mode agent-max` |
+| `--file <path>` | Read prompt from a file |
+| `--image <path>` | Attach image(s) — can use multiple times |
+| `--url <url>` | Attach URL(s) for context — can use multiple times |
+| `--verbose` | Show agent's full response text |
+| `--no-stream` | Disable streaming output |
+
+### Scenes
+
+```bash
+# List all scenes in active project
+baz scenes list
+
+# Get scene details
+baz scenes list
+
+# Get scene TSX code
+baz scenes code <scene-id>
+
+# Get scene code
+baz scenes code <scene-id>
+```
+
+### Media Upload
+
+Upload files to your project's media library:
+
+```bash
+# Upload an image
+baz media upload ./image.png
+
+# Upload a video
+baz media upload ./video.mp4
+
+# Upload with custom name
+baz media upload ./file.png --name "my-logo.png"
+```
+
+**Supported formats:**
+- **Images**: jpg, png, gif, webp, avif, heic (max 50MB)
+- **Videos**: mp4, webm, mov, avi, mkv (max 2GB)
+- **Audio**: mp3, wav, ogg, flac, aac, m4a (max 500MB)
+
+### Export
+
+```bash
+# Start export
+baz export start
+
+# Check export status
+baz export status <job-id>
+
+# Wait for completion
+baz export status <job-id> --wait
+
+# List recent exports
+baz export list
+```
+
+### Status
+
+```bash
+# Show overall status (auth, project, timeline)
+baz status
+```
+
+### State & Verification
+
+```bash
+# Snapshot state for agents/automation
+baz state --json
+
+# Structural validation (overlaps, invalid durations, compile errors)
+baz project validate --json
+
+# Criteria verification
+baz verify --criteria "logo visible,CTA present,duration <= 60s" --json
+```
+
+### MCP Manifest
+
+```bash
+# MCP-style manifest for integrations
+baz mcp
+baz mcp schema
+```
+
+Example output:
+```
+Project Status
+────────────────────────────────────────────────────────────
+
+  Project:  My Product Demo
+  ID:       f0ba67dc...
+
+┌─────────────────────────────────────────────────────────┐
+│  Scenes: 5     Tracks: 2     Duration: 0:45     ✓ OK   │
+└─────────────────────────────────────────────────────────┘
+
+  Timeline:
+  Track 0  │▓▓▓▓Intro▓▓▓▓▓▓▓Main▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓Outro▓▓│
+  Track 1  │          ▓▓▓▓Logo▓▓▓▓                    │
+           └──────────────────────────────────────────┘
+            0:00                0:22                 0:45
+```
+
+### Logs (Beta)
+
+Query runtime logs:
+
+```bash
+# Show recent logs
+baz logs
+
+# Show only errors
+baz logs --errors
+
+# Search logs
+baz logs --search "error"
+
+# Filter by API path
+baz logs --path /api/generate-stream
+
+# Custom time range
+baz logs --since 24h --limit 100
+
+# Filter by current project
+baz logs --project
+```
+
+## Agent Capabilities
+
+The agent has access to the same tools as the web app:
+
+### Scene Operations
+- **Create scenes** — Add new scenes with animations, text, images
+- **Edit scenes** — Modify existing scene code, styling, timing
+- **Delete scenes** — Remove scenes from the project
+- **Trim scenes** — Adjust start time and duration
+
+### Media Generation
+- **Generate images** — AI image generation (DALL-E, etc.)
+- **Generate video** — AI video generation (Seedance, Veo 3)
+- **Generate voiceover** — Text-to-speech with multiple voices
+- **Generate music** — AI background music generation
+- **Remove backgrounds** — Extract subjects from images
+
+### Gathering Tools
+- **Fetch URLs** — Extract content from web pages
+- **Take screenshots** — Capture web pages as images
+- **Summarize** — AI-powered content summarization
+
+### Planning & Orchestration
+- **Video plans** — Create multi-scene video outlines
+- **Recipes** — Reusable templates for video generation
+- **Workflows** — Multi-step automation pipelines
+
+## Output Modes
+
+### Streaming (default)
+
+Shows real-time progress:
+
+```
+Mode: agent
+Project: abc123
+
+[2s] 🧠 Analyzing your request...
+✔ [3s] 🧠 Analyzing your request...
+[4s] 🎬 Creating scene
+✔ [8s] 🎬 Creating scene
+[8s]    ✅ Created: "Intro Scene"
+
+┌────────────────────────────────────────────────┐
+│ ✓ Done! (1 scene in 15s)                       │
+└────────────────────────────────────────────────┘
+```
+
+### JSON Mode
+
+For programmatic parsing:
+
+```bash
+baz prompt "..." --json
+```
+
+Returns:
+```json
+{
+  "success": true,
+  "scenesCreated": ["scene-id-1"],
+  "scenesUpdated": [],
+  "errors": [],
+  "elapsed": "15s",
+  "steps": 4
+}
+```
+
+## Global Options
+
+```
+--json              Output as JSON (for scripting)
+--verbose           Show detailed output
+--config <path>     Custom config file path
+--api-url <url>     Override API URL
+--project-id <id>   Override active project
+```
+
+## Configuration
+
+Config stored at `~/.bazaar/config.json`:
+
+```json
+{
+  "apiKey": "baz_...",
+  "apiUrl": "https://bazaar.it",
+  "activeProjectId": "abc123"
+}
+```
+
+Environment variables override config file:
+- `BAZ_API_KEY` — API key
+- `BAZ_API_URL` — API URL
+- `BAZ_PROJECT_ID` — Active project
+- `BAZ_AGENT=1` — Agent auto-mode (default `--json`, `--compact`, `--events-only`, and `--stream-json` on prompt/loop)
+
+## Examples
+
+### URL to Video
+
+```bash
+# Turn any webpage into a video
+baz prompt "Create a video summary of this article" \
+  --url https://example.com/blog/post
+
+# Multiple URLs for comparison
+baz prompt "Compare these products" \
+  --url https://example.com/product-a \
+  --url https://example.com/product-b
+```
+
+### Batch Processing
+
+```bash
+# Generate and capture result
+result=$(baz prompt "Create intro scene" --json)
+scene_id=$(echo "$result" | jq -r '.scenesCreated[0]')
+echo "Created scene: $scene_id"
+```
+
+### CI/CD Integration
+
+```bash
+#!/bin/bash
+set -e
+
+export BAZ_API_KEY="$BAZAAR_API_KEY"
+
+# Generate video from PR description
+baz prompt "Create demo video: $PR_DESCRIPTION" --project-id "$PROJECT_ID"
+
+# Export when ready
+baz export --json > export-result.json
+```
+
+### Complex Workflow
+
+```bash
+baz prompt "Create a 30 second promotional video for https://example.com \
+  including their logo, brand colors, and key messaging" --max
+```
+
+## Troubleshooting
+
+### "Unauthorized" Error
+
+```bash
+baz auth status
+baz auth login <api-key>
+```
+
+### "No active project"
+
+```bash
+baz project list
+baz project use <project-id>
+```
+
+### "Insufficient balance"
+
+Check balance at https://bazaar.it/settings/billing
+
+### Connection Issues
+
+```bash
+baz auth status --api-url https://bazaar.it
+```
+
+## Error Codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success |
+| `10` | Transient error (retryable) |
+| `11` | Resource/capacity error |
+| `12` | Semantic/content-policy error |
+| `13` | Authentication error |
+| `64` | Input/not-found error |
+| `65` | Validation error |
+| `1` | Fatal/unclassified error |
+
+## Development
+
+```bash
+npm run typecheck    # Type check
+npm run dev          # Run in dev mode
+npm run build        # Build for production
+```
+
+## License
+
+Copyright © 2024 Bazaar.it. All rights reserved.
+### Capabilities
+
+```bash
+# Describe CLI capabilities (JSON for agents)
+baz capabilities --json
+```
+
+### Loop (Basic OODA)
+
+```bash
+# Iterate prompt → review with optional requirements
+baz loop "Create a 15s intro for Acme" --requirements "logo visible, CTA present"
+
+# Use agent mode + NDJSON for bots
+BAZ_AGENT=1 baz loop "Create a 15s intro" --requirements "logo visible, CTA present"
+
+# Stop on failure and set a time budget
+baz loop "Create a 15s intro" --requirements "logo visible" --stop-on-fail --budget 90s
+```

package/bin/baz.js

@@ -1,2 +1,7 @@
 #!/usr/bin/env node
-console.log("bazaar.it CLI — coming soon. Visit https://bazaar.it for more info.");
+
+// This is the entry point for the CLI
+// When running in development, use: npx tsx cli/src/index.ts
+// When built, this file runs the compiled JS
+
+import('../dist/index.js');

package/dist/commands/auth.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const authCommand: Command;

package/dist/commands/auth.js

@@ -0,0 +1,109 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { loadConfig, saveConfig, hasAuth, getConfigPath } from '../lib/config.js';
+import { success, error, info, output } from '../lib/output.js';
+export const authCommand = new Command('auth')
+    .description('Manage authentication');
+/**
+ * baz auth login
+ */
+authCommand
+    .command('login')
+    .description('Configure API key for authentication')
+    .argument('[api-key]', 'API key (or set BAZ_API_KEY env var)')
+    .action(async (apiKey) => {
+    // If no key provided, check environment
+    const key = apiKey || process.env.BAZ_API_KEY;
+    if (!key) {
+        console.log(chalk.cyan('Bazaar CLI Authentication'));
+        console.log();
+        console.log('To authenticate, you need an API key.');
+        console.log();
+        console.log('Options:');
+        console.log('  1. Pass directly: baz auth login <your-api-key>');
+        console.log('  2. Environment:   export BAZ_API_KEY=<your-api-key>');
+        console.log();
+        console.log(chalk.gray('Get your API key at https://bazaar.it/api'));
+        process.exit(1);
+    }
+    // Validate key format
+    if (!key.startsWith('baz_sk_')) {
+        error('Invalid API key format', 'API keys should start with "baz_sk_"');
+        process.exit(1);
+    }
+    // Save to config first (needed for the validation request)
+    saveConfig({ apiKey: key });
+    // Validate key against server
+    const config = loadConfig();
+    try {
+        const url = `${config.apiUrl}/api/trpc/apiKey.list`;
+        const res = await fetch(url, {
+            method: 'GET',
+            headers: { 'x-api-key': key },
+        });
+        if (res.ok) {
+            success('Authenticated successfully');
+            console.log(`  Key saved to ${chalk.gray(getConfigPath())}`);
+        }
+        else if (res.status === 401) {
+            saveConfig({ apiKey: undefined });
+            error('Invalid API key', 'The key was not recognized by the server. Check for typos or generate a new key.');
+            process.exit(1);
+        }
+        else {
+            // Non-auth error (500, network issue) — save key anyway, warn
+            info(`Key saved, but server returned ${res.status}. Run "baz auth status" to verify later.`);
+        }
+    }
+    catch (err) {
+        // Network error — save key anyway, warn
+        info('Key saved, but could not reach the server to verify. Check your connection.');
+    }
+});
+/**
+ * baz auth status
+ */
+authCommand
+    .command('status')
+    .description('Show current authentication status')
+    .action(async (options, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const config = loadConfig({
+        configPath: globalOpts.config,
+        apiUrl: globalOpts.apiUrl,
+    });
+    const data = {
+        authenticated: hasAuth(config),
+        apiUrl: config.apiUrl,
+        activeProjectId: config.activeProjectId || null,
+        configFile: getConfigPath(),
+    };
+    if (globalOpts.json) {
+        output(data, { json: true });
+        return;
+    }
+    console.log(chalk.cyan('Bazaar CLI Status'));
+    console.log();
+    if (hasAuth(config)) {
+        console.log(chalk.green('✓'), 'Authenticated');
+        console.log(`  API Key: ${chalk.gray('baz_sk_****' + (config.apiKey?.slice(-4) || ''))}`);
+    }
+    else {
+        console.log(chalk.red('✗'), 'Not authenticated');
+        console.log(chalk.gray('  Run: baz auth login <api-key>'));
+    }
+    console.log();
+    console.log(`API URL: ${config.apiUrl}`);
+    console.log(`Active Project: ${config.activeProjectId || chalk.gray('none')}`);
+    console.log(`Config: ${getConfigPath()}`);
+});
+/**
+ * baz auth logout
+ */
+authCommand
+    .command('logout')
+    .description('Clear stored credentials')
+    .action(async () => {
+    saveConfig({ apiKey: undefined });
+    success('Logged out. API key removed from config.');
+});

package/dist/commands/capabilities.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const capabilitiesCommand: Command;

package/dist/commands/capabilities.js

@@ -0,0 +1,44 @@
+import { Command } from 'commander';
+import { output } from '../lib/output.js';
+import { CLI_VERSION } from '../lib/version.js';
+const PROTOCOL_VERSION = '1.0';
+export const capabilitiesCommand = new Command('capabilities')
+    .description('Describe CLI capabilities and protocol support')
+    .action(async (options, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const agentModeEnv = process.env.BAZ_AGENT === '1';
+    const jsonOutput = globalOpts.json || agentModeEnv;
+    const data = {
+        name: 'baz',
+        version: CLI_VERSION,
+        protocolVersion: PROTOCOL_VERSION,
+        agentMode: agentModeEnv,
+        commands: [
+            'auth', 'project', 'prompt', 'scenes', 'export', 'media', 'logs',
+            'status', 'recipe', 'review', 'context', 'capabilities', 'loop',
+            'state', 'verify', 'mcp',
+        ],
+        modes: ['agent', 'agent-max', 'multi-scene'],
+        outputs: {
+            json: true,
+            streamJson: true,
+            summary: true,
+        },
+        features: {
+            planOnly: true,
+            requirements: true,
+            reviewSummary: true,
+            stateSnapshot: true,
+            projectValidate: true,
+            verifyCriteria: true,
+            mcpManifest: true,
+            directCodeEdit: true,
+            loop: {
+                stopOnFail: true,
+                budget: true,
+                oodaEvents: true,
+            },
+        },
+    };
+    output(data, { json: jsonOutput, compact: globalOpts.compact || agentModeEnv });
+});

package/dist/commands/context.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Context Commands - Project context for agent handshake
+ *
+ * Store and retrieve flexible context for projects:
+ * - Goals, requirements, specs
+ * - Reference URLs, videos
+ * - Uploaded files (PDFs, images)
+ * - Any other context the agent needs
+ *
+ * The AI uses this context when generating content.
+ */
+import { Command } from 'commander';
+export declare const contextCommand: Command;