opencode-agora 0.2.2 → 0.4.0

package/dist/cli/commands-meta.js

@@ -0,0 +1,600 @@
+/**
+ * Renders a command manual page using the provided styler.
+ * Used by both `agora help <command>` (scriptable) and the interactive menu (TTY).
+ */
+export function renderManual(meta, style) {
+    const lines = [
+        style.accent(meta.name),
+        meta.summary,
+        '',
+        `${style.dim('Usage:')}`,
+        ...meta.usage.split('\n').map((line) => `  ${line}`)
+    ];
+    if (meta.flags && meta.flags.length > 0) {
+        const flagWidth = Math.max(...meta.flags.map((f) => f.flag.length));
+        lines.push('');
+        lines.push(style.dim('Flags:'));
+        for (const f of meta.flags) {
+            lines.push(`  ${f.flag.padEnd(flagWidth)}  ${style.dim(f.description)}`);
+        }
+    }
+    if (meta.examples && meta.examples.length > 0) {
+        lines.push('');
+        lines.push(style.dim('Examples:'));
+        for (const ex of meta.examples) {
+            lines.push(`  ${ex}`);
+        }
+    }
+    if (meta.details) {
+        lines.push('');
+        lines.push(meta.details);
+    }
+    return lines.join('\n');
+}
+export const COMMANDS = [
+    // Marketplace
+    {
+        name: 'search',
+        group: 'Marketplace',
+        summary: 'Search the marketplace for packages and workflows',
+        usage: 'agora search <query> [--category mcp|prompt|workflow|skill] [--limit 10] [--json]',
+        details: 'Searches all marketplace items by keyword. Use --category to filter by kind. ' +
+            'Add --api to query the live Agora API; without it, the bundled offline data is used.',
+        flags: [
+            { flag: '--category, -c', description: 'Filter by category: mcp, prompt, workflow, skill' },
+            { flag: '--limit, -n', description: 'Maximum number of results (default 10)' },
+            { flag: '--json', description: 'Output results as JSON' }
+        ],
+        examples: [
+            'agora search filesystem',
+            'agora search filesystem --api',
+            'agora search github --category mcp --limit 5'
+        ]
+    },
+    {
+        name: 'browse',
+        group: 'Marketplace',
+        summary: 'View full details for a single marketplace item',
+        usage: 'agora browse <id> [--type package|workflow] [--json]',
+        details: 'Fetches and displays the full metadata for a package or workflow by its id. ' +
+            'Use --type to disambiguate when an id is shared by multiple kinds.',
+        flags: [
+            { flag: '--type, -t', description: 'Item kind: package or workflow' },
+            { flag: '--json', description: 'Output as JSON' }
+        ],
+        examples: ['agora browse mcp-github', 'agora browse mcp-github --type package']
+    },
+    {
+        name: 'trending',
+        group: 'Marketplace',
+        summary: 'Show trending packages and workflows',
+        usage: 'agora trending [all|packages|workflows] [--limit 5] [--json]',
+        details: 'Lists the most-starred marketplace items. Pass a category filter as the first positional ' +
+            'argument, or use --category.',
+        flags: [
+            {
+                flag: '--category, -c',
+                description: 'Category filter: all, packages, workflows (default all)'
+            },
+            { flag: '--limit, -n', description: 'Maximum number of results (default 5)' },
+            { flag: '--json', description: 'Output as JSON' }
+        ],
+        examples: ['agora trending', 'agora trending packages', 'agora trending --limit 10']
+    },
+    {
+        name: 'workflows',
+        group: 'Marketplace',
+        summary: 'List and search AI workflow templates',
+        usage: 'agora workflows [query] [--limit 10] [--json]',
+        details: 'Searches the workflow subset of the marketplace. Provide an optional keyword to narrow results.',
+        flags: [
+            { flag: '--limit, -n', description: 'Maximum number of results (default 10)' },
+            { flag: '--json', description: 'Output as JSON' }
+        ],
+        examples: ['agora workflows', 'agora workflows tdd', 'agora workflows security --json']
+    },
+    {
+        name: 'similar',
+        group: 'Marketplace',
+        summary: 'Find similar marketplace items by tag overlap',
+        usage: 'agora similar <id> [--limit 5] [--type package|workflow] [--json]',
+        details: 'Computes tag-IDF-weighted Jaccard similarity between marketplace items. ' +
+            'Ranks by similarity score, tiebroken by install count. ' +
+            'Use --type to restrict to packages or workflows.',
+        flags: [
+            { flag: '--type, -t', description: 'Item kind: package or workflow (default all)' },
+            { flag: '--limit, -n', description: 'Maximum number of results (default 5)' },
+            { flag: '--json', description: 'Output as JSON' }
+        ],
+        examples: [
+            'agora similar mcp-postgres',
+            'agora similar mcp-github --limit 3',
+            'agora similar wf-tdd-cycle --type workflow'
+        ]
+    },
+    {
+        name: 'compare',
+        group: 'Marketplace',
+        summary: 'Compare two or more marketplace items side by side',
+        usage: 'agora compare <id1> <id2> [<id3>...] [--type package|workflow] [--json]',
+        details: 'Renders a box-drawn table comparing items across attributes: name, author, installs, ' +
+            'stars, category, tags, npmPackage. Shared tags are highlighted in the accent colour.',
+        flags: [
+            { flag: '--type, -t', description: 'Item kind: package or workflow (default all)' },
+            { flag: '--json', description: 'Output as JSON' }
+        ],
+        examples: [
+            'agora compare mcp-postgres mcp-supabase',
+            'agora compare mcp-github mcp-gitlab mcp-git'
+        ]
+    },
+    {
+        name: 'chat',
+        group: 'Marketplace',
+        summary: 'Chat with an AI assistant about the Agora marketplace',
+        usage: 'agora chat [message] [--continue] [--session <id>] [--model <model>]',
+        details: 'Starts an interactive OpenCode TUI session with a free model. ' +
+            'Pass a message for one-shot mode (scriptable). ' +
+            'The TUI gives you a full REPL with conversation history, editing, and /agora commands.',
+        flags: [
+            { flag: '--model, -m', description: 'Model to use (default: deepseek-v4-flash-free)' },
+            { flag: '--continue', description: 'Continue the last conversation' },
+            { flag: '--session, -s', description: 'Continue a specific session by ID' },
+            { flag: '--json', description: 'Output raw JSON events (one-shot mode only)' }
+        ],
+        examples: [
+            'agora chat',
+            'agora chat "what MCP servers are for postgres?"',
+            'agora chat --continue "follow up question"',
+            'agora chat -m nemotron-3-super-free'
+        ]
+    },
+    {
+        name: 'install',
+        group: 'Marketplace',
+        summary: 'Install a package into your OpenCode config',
+        usage: 'agora install <id> [--write] [--config path] [--json]',
+        details: 'Generates an install plan for a marketplace package. Without --write the plan is previewed only. ' +
+            'With --write, opencode.json is updated and any required npm packages are installed.',
+        flags: [
+            { flag: '--write', description: 'Apply the install plan (update config + run npm install)' },
+            { flag: '--config', description: 'Path to opencode.json (auto-detected by default)' },
+            { flag: '--type, -t', description: 'Item kind: package or workflow' },
+            { flag: '--json', description: 'Output plan as JSON' }
+        ],
+        examples: [
+            'agora install mcp-github',
+            'agora install mcp-github --write',
+            'agora install mcp-github --write --config ./opencode.json'
+        ]
+    },
+    // Setup
+    {
+        name: 'init',
+        group: 'Setup',
+        summary: 'Scaffold Agora into the current project',
+        usage: 'agora init [--dry-run] [--json] [--mcp]',
+        details: 'Scans the current directory, generates an opencode.json with recommended MCP servers, ' +
+            'and installs the /agora slash command. Use --dry-run to preview without writing.',
+        flags: [
+            { flag: '--dry-run', description: 'Preview what would be written without applying changes' },
+            { flag: '--json', description: 'Output the generated config as JSON' },
+            { flag: '--mcp', description: 'Also register the Agora MCP server in the config' }
+        ],
+        examples: ['agora init', 'agora init --dry-run', 'agora init --mcp']
+    },
+    {
+        name: 'use',
+        group: 'Setup',
+        summary: 'Apply a workflow template as an OpenCode skill',
+        usage: 'agora use <workflow-id> [--json]',
+        details: 'Copies a workflow from the marketplace into .opencode/skills/ and registers it in opencode.json ' +
+            'so OpenCode can load it on the next restart.',
+        flags: [{ flag: '--json', description: 'Output result as JSON' }],
+        examples: ['agora use wf-tdd-cycle', 'agora use wf-security-audit']
+    },
+    {
+        name: 'menu',
+        group: 'Setup',
+        summary: 'Browse commands interactively (the old menu)',
+        usage: 'agora menu',
+        details: 'Opens the interactive command browser powered by @clack/prompts.',
+        examples: ['agora menu']
+    },
+    {
+        name: 'tui',
+        group: 'Setup',
+        summary: 'Open the full-screen Agora TUI (Home · Market · Comm · News · Settings)',
+        usage: 'agora tui',
+        details: 'Opens the keyboard-driven TUI with five pages, switched by 1-5 or Tab. ' +
+            "j/k navigates, Enter drills in, Esc backs out, ? toggles help, q quits. " +
+            'Pages: Home (recommendation engine), Marketplace (browse + install preview), ' +
+            'Community (boards/threads/reader against fixtures until backend lands), ' +
+            'News (ranked feed against fixtures until news adapters land), ' +
+            'Settings (account, display, news sources, community defaults).',
+        examples: ['agora tui']
+    },
+    {
+        name: 'config',
+        group: 'Setup',
+        summary: 'Inspect or validate your OpenCode configuration',
+        usage: 'agora config doctor [--config path] [--json]',
+        details: 'Runs a health-check on opencode.json: reports path, validity, MCP server count, and registered plugins.',
+        flags: [
+            { flag: '--config', description: 'Explicit path to opencode.json' },
+            { flag: '--json', description: 'Output report as JSON' }
+        ],
+        examples: ['agora config doctor', 'agora config doctor --config ./opencode.json --json']
+    },
+    // Library
+    {
+        name: 'save',
+        group: 'Library',
+        summary: 'Save a marketplace item to your local library',
+        usage: 'agora save <id> [--data-dir path] [--json]',
+        details: 'Persists a package or workflow reference in the Agora state file so you can recall it later ' +
+            'with `agora saved`.',
+        flags: [
+            { flag: '--data-dir', description: 'Override the Agora data directory' },
+            { flag: '--type, -t', description: 'Item kind: package or workflow' },
+            { flag: '--json', description: 'Output result as JSON' }
+        ],
+        examples: ['agora save wf-security-audit', 'agora save mcp-github --data-dir ~/.agora']
+    },
+    {
+        name: 'saved',
+        group: 'Library',
+        summary: 'List saved marketplace items',
+        usage: 'agora saved [query] [--data-dir path] [--json]',
+        details: 'Shows all items in your local library. Provide a keyword to filter the list.',
+        flags: [
+            { flag: '--data-dir', description: 'Override the Agora data directory' },
+            { flag: '--json', description: 'Output list as JSON' }
+        ],
+        examples: ['agora saved', 'agora saved github', 'agora saved --json']
+    },
+    {
+        name: 'remove',
+        group: 'Library',
+        summary: 'Remove an item from your saved library',
+        usage: 'agora remove <id> [--data-dir path] [--json]',
+        details: 'Deletes a saved item from the Agora state file by its id.',
+        flags: [
+            { flag: '--data-dir', description: 'Override the Agora data directory' },
+            { flag: '--json', description: 'Output result as JSON' }
+        ],
+        examples: ['agora remove wf-security-audit', 'agora remove mcp-github']
+    },
+    // Learn
+    {
+        name: 'tutorials',
+        group: 'Learn',
+        summary: 'List available step-by-step tutorials',
+        usage: 'agora tutorials [query] [--level beginner|intermediate|advanced] [--limit 20] [--json]',
+        details: 'Browses the tutorial catalog. Filter by keyword and skill level. ' +
+            'Use `agora tutorial <id>` to start a specific tutorial.',
+        flags: [
+            { flag: '--level', description: 'Skill level: beginner, intermediate, or advanced' },
+            { flag: '--limit, -n', description: 'Maximum number of results (default 20)' },
+            { flag: '--json', description: 'Output as JSON' }
+        ],
+        examples: ['agora tutorials', 'agora tutorials mcp', 'agora tutorials --level beginner']
+    },
+    {
+        name: 'tutorial',
+        group: 'Learn',
+        summary: 'Read a tutorial step-by-step',
+        usage: 'agora tutorial <id> [step] [--json]',
+        details: 'Displays a single tutorial step. Omit the step number to start from step 1. ' +
+            'Increment the step number to advance through the tutorial.',
+        flags: [
+            { flag: '--step', description: 'Step number to display (default 1)' },
+            { flag: '--json', description: 'Output step as JSON' }
+        ],
+        examples: [
+            'agora tutorial tut-mcp-basics',
+            'agora tutorial tut-mcp-basics 2',
+            'agora tutorial tut-mcp-basics --json'
+        ]
+    },
+    // Community
+    {
+        name: 'discuss',
+        group: 'Community',
+        summary: 'Post a new community discussion',
+        usage: 'agora discuss --title <title> (--content <text>|--content-file path) [--category question|idea|showcase|discussion]',
+        details: 'Creates a new discussion thread via the Agora API. Requires --api-url and a token ' +
+            '(via --token, AGORA_TOKEN, or `agora auth login`).',
+        flags: [
+            { flag: '--title', description: 'Discussion title (required)' },
+            { flag: '--content', description: 'Discussion body as inline text' },
+            { flag: '--content-file', description: 'Read discussion body from a file' },
+            {
+                flag: '--category, -c',
+                description: 'Category: question, idea, showcase, discussion (default discussion)'
+            },
+            { flag: '--json', description: 'Output created discussion as JSON' }
+        ],
+        examples: [
+            'agora discuss --title "MCP question" --content "How are you composing servers?" --category question',
+            'agora discuss --title "My workflow" --content-file ./prompt.md --category showcase'
+        ]
+    },
+    {
+        name: 'discussions',
+        group: 'Community',
+        summary: 'Browse community discussions',
+        usage: 'agora discussions [query] [--category question|idea|showcase|discussion] [--json]',
+        details: 'Lists community discussion threads from the Agora API. Requires --api-url. ' +
+            'Filter by keyword or category.',
+        flags: [
+            {
+                flag: '--category, -c',
+                description: 'Category filter: question, idea, showcase, or discussion'
+            },
+            { flag: '--json', description: 'Output as JSON' }
+        ],
+        examples: [
+            'agora discussions',
+            'agora discussions --category question',
+            'agora discussions mcp --json'
+        ]
+    },
+    {
+        name: 'review',
+        group: 'Community',
+        summary: 'Post a rating and review for a marketplace item',
+        usage: 'agora review <id> --rating 5 --content <text>',
+        details: 'Submits a review to the Agora API. Requires --api-url and a token ' +
+            '(via --token, AGORA_TOKEN, or `agora auth login`). Rating must be 1–5.',
+        flags: [
+            { flag: '--rating, -r', description: 'Star rating 1–5 (required)' },
+            { flag: '--content', description: 'Review text (required)' },
+            { flag: '--type, -t', description: 'Item kind: package or workflow (auto-detected)' },
+            { flag: '--json', description: 'Output created review as JSON' }
+        ],
+        examples: [
+            'agora review mcp-github --rating 5 --content "Works well"',
+            'agora review wf-security-audit --rating 4 --content "Solid workflow" --type workflow'
+        ]
+    },
+    {
+        name: 'reviews',
+        group: 'Community',
+        summary: 'List reviews for a marketplace item',
+        usage: 'agora reviews [id] [--type package|workflow] [--api-url url] [--json]',
+        details: 'Fetches reviews from the Agora API. Requires --api-url. ' +
+            'Omit the id to list all recent reviews.',
+        flags: [
+            { flag: '--type, -t', description: 'Item kind: package or workflow' },
+            { flag: '--json', description: 'Output as JSON' }
+        ],
+        examples: [
+            'agora reviews mcp-github --api-url https://agora.example.com',
+            'agora reviews --json'
+        ]
+    },
+    {
+        name: 'profile',
+        group: 'Community',
+        summary: 'View a community member profile',
+        usage: 'agora profile <username> [--json]',
+        details: 'Retrieves a user profile from the Agora API. Requires --api-url. ' +
+            'Displays packages, workflows, and discussion counts.',
+        flags: [
+            { flag: '--username', description: 'Username (alternative to positional argument)' },
+            { flag: '--json', description: 'Output as JSON' }
+        ],
+        examples: ['agora profile alice', 'agora profile alice --api-url https://agora.example.com']
+    },
+    {
+        name: 'publish',
+        group: 'Community',
+        summary: 'Publish a package or workflow to the marketplace',
+        usage: 'agora publish package --name <name> --description <text> --npm <package> [--token token]\n' +
+            '  agora publish workflow --name <name> --description <text> --prompt-file <path> [--token token]',
+        details: 'Submits a new package or workflow to the Agora API. Requires --api-url and a token ' +
+            '(via --token, AGORA_TOKEN, or `agora auth login`).',
+        flags: [
+            { flag: '--name', description: 'Item name (required)' },
+            { flag: '--description, -d', description: 'Short description (required)' },
+            { flag: '--npm', description: 'npm package name (required for MCP packages)' },
+            {
+                flag: '--prompt-file',
+                description: 'Path to workflow prompt file (required for workflows)'
+            },
+            { flag: '--prompt', description: 'Workflow prompt as inline text' },
+            { flag: '--version', description: 'Package version (default 1.0.0)' },
+            { flag: '--category, -c', description: 'Category (default mcp)' },
+            { flag: '--tags', description: 'Comma-separated tags' },
+            { flag: '--repo, --repository', description: 'Repository URL' },
+            { flag: '--model', description: 'Preferred model for workflow' },
+            { flag: '--json', description: 'Output published item as JSON' }
+        ],
+        examples: [
+            'agora publish package --name @you/server --description "MCP server" --npm @you/server',
+            'agora publish workflow --name "My Workflow" --description "Review workflow" --prompt-file ./prompt.md'
+        ]
+    },
+    {
+        name: 'news',
+        group: 'Marketplace',
+        summary: 'Browse ranked tech news from HN, Reddit, GitHub, arXiv',
+        usage: 'agora news [query] [--source hn|reddit|gh|arxiv] [--limit 20] [--refresh] [--json]',
+        details: 'Fetches and ranks news stories from multiple sources using a recency-engagement-topic scoring algorithm. ' +
+            'Cached locally in ~/.config/agora/news-cache.jsonl. ' +
+            'Use --refresh to force re-fetch; --source to filter by source; a positional query to search titles and tags.',
+        flags: [
+            { flag: '--source, -s', description: 'Source filter: hn, reddit, gh, arxiv' },
+            { flag: '--limit, -n', description: 'Maximum number of results (default 20)' },
+            { flag: '--refresh', description: 'Force re-fetch all enabled sources' },
+            { flag: '--json', description: 'Output as JSON' }
+        ],
+        examples: [
+            'agora news',
+            'agora news mcp',
+            'agora news --source hn --limit 5',
+            'agora news --refresh'
+        ]
+    },
+    {
+        name: 'community',
+        group: 'Community',
+        summary: 'Browse community boards and threads',
+        usage: 'agora community [board] [--sort top|new|active] [--json]',
+        details: 'Without a board, lists all available boards with thread counts. ' +
+            'With a board (e.g. mcp, agents), lists threads in that board sorted by activity. ' +
+            'Use `agora thread <id>` to read a specific thread.',
+        flags: [
+            { flag: '--sort', description: 'Sort order: top, new, active (default active)' },
+            { flag: '--json', description: 'Output as JSON' }
+        ],
+        examples: [
+            'agora community',
+            'agora community mcp',
+            'agora community agents --sort top'
+        ]
+    },
+    {
+        name: 'thread',
+        group: 'Community',
+        summary: 'Read a community thread with replies',
+        usage: 'agora thread <id> [--json]',
+        details: 'Displays a full thread with its reply tree.',
+        flags: [{ flag: '--json', description: 'Output as JSON' }],
+        examples: ['agora thread t-mcp-1']
+    },
+    {
+        name: 'post',
+        group: 'Community',
+        summary: 'Create a new community thread',
+        usage: 'agora post --board <board> --title <title> (--content <text>|--content-file <path>) [--json]',
+        details: 'Posts a new thread to a community board. Requires --api-url and a token ' +
+            '(via --token, AGORA_TOKEN, or `agora auth login`). ' +
+            'Boards: mcp, agents, tools, workflows, show, ask, meta.',
+        flags: [
+            { flag: '--board, -b', description: 'Target board (required)' },
+            { flag: '--title', description: 'Thread title (required)' },
+            { flag: '--content', description: 'Thread body as inline text' },
+            { flag: '--content-file', description: 'Read body from a file' },
+            { flag: '--json', description: 'Output created thread as JSON' }
+        ],
+        examples: [
+            'agora post --board mcp --title "My question" --content "How do I?"',
+            'agora post --board show --title "My project" --content-file ./readme.md'
+        ]
+    },
+    {
+        name: 'reply',
+        group: 'Community',
+        summary: 'Reply to a thread or another reply',
+        usage: 'agora reply <id> (--content <text>|--content-file <path>) [--parent-id <id>] [--json]',
+        details: 'Posts a reply to an existing thread or reply. ' +
+            'Requires --api-url and a token.',
+        flags: [
+            { flag: '--content', description: 'Reply body as inline text' },
+            { flag: '--content-file', description: 'Read body from a file' },
+            { flag: '--parent-id', description: 'Optional parent reply id for nested replies' },
+            { flag: '--json', description: 'Output as JSON' }
+        ],
+        examples: [
+            'agora reply t-mcp-1 --content "Great point!"',
+            'agora reply r-mcp-1-1 --content "Thanks"'
+        ]
+    },
+    {
+        name: 'vote',
+        group: 'Community',
+        summary: 'Upvote or downvote a thread or reply',
+        usage: 'agora vote <id> --up|--down [--type discussion|reply] [--json]',
+        details: 'Cast a vote on a community item. Requires --api-url and a token.',
+        flags: [
+            { flag: '--up', description: 'Upvote' },
+            { flag: '--down', description: 'Downvote' },
+            { flag: '--type', description: 'Target type: discussion or reply (default discussion)' },
+            { flag: '--json', description: 'Output as JSON' }
+        ],
+        examples: ['agora vote t-mcp-1 --up', 'agora vote r-mcp-1-1 --down']
+    },
+    {
+        name: 'flag',
+        group: 'Community',
+        summary: 'Flag a thread, reply, or marketplace item',
+        usage: 'agora flag <id> [--reason spam|harassment|undisclosed-llm|malicious|other] [--type discussion|reply|package|workflow] [--notes <text>] [--json]',
+        details: 'Flags content for moderator review. Community items require --api-url and a token. ' +
+            'Marketplace items (packages/workflows) can be flagged without API auth.',
+        flags: [
+            { flag: '--reason', description: 'Reason: spam, harassment, undisclosed-llm, malicious, other' },
+            { flag: '--type', description: 'Target type: discussion, reply, package, workflow' },
+            { flag: '--notes', description: 'Optional notes for moderators' },
+            { flag: '--json', description: 'Output as JSON' }
+        ],
+        examples: [
+            'agora flag t-mcp-1 --reason spam',
+            'agora flag mcp-github --reason malicious'
+        ]
+    },
+    {
+        name: 'auth',
+        group: 'Community',
+        summary: 'Manage Agora API credentials',
+        usage: 'agora auth login [--api-url url] [--data-dir path]\n' +
+            '  agora auth login --token <token> [--api-url url]\n' +
+            '  agora auth status [--data-dir path] [--json]\n' +
+            '  agora auth logout [--data-dir path]',
+        details: 'Stores or clears API credentials in the Agora state file. ' +
+            'Without --token, runs the device-code login flow: opens your browser to ' +
+            'authorize via GitHub and returns a short-lived JWT. ' +
+            'Pass --token (or set AGORA_TOKEN / AGORA_API_TOKEN) for headless/CI use. ' +
+            'Saved credentials are used automatically by write commands.',
+        flags: [
+            { flag: '--token', description: 'API auth token (also AGORA_TOKEN / AGORA_API_TOKEN env)' },
+            { flag: '--api-url', description: 'Override AGORA_API_URL for stored auth' },
+            { flag: '--data-dir', description: 'Override the Agora data directory' },
+            { flag: '--json', description: 'Output status as JSON' }
+        ],
+        examples: [
+            'agora auth login --api-url https://api.agora.example.com',
+            'agora auth login --token $AGORA_TOKEN --api-url https://agora.example.com',
+            'agora auth status',
+            'agora auth logout'
+        ]
+    },
+    {
+        name: 'preferences',
+        group: 'Setup',
+        summary: 'View or set local preferences',
+        usage: 'agora preferences [<key> <value>] [--json]',
+        details: 'Preferences are stored locally on disk and work without an account. ' +
+            'Keys: theme (dark|light|auto), verbosity (verbose|medium|quiet), ' +
+            'username, email, bio.',
+        flags: [
+            { flag: '--json', description: 'Output preferences as JSON' }
+        ],
+        examples: [
+            'agora preferences',
+            'agora preferences theme light',
+            'agora preferences verbosity quiet',
+            'agora preferences username "Jane Doe"'
+        ]
+    },
+    {
+        name: 'history',
+        group: 'Setup',
+        summary: 'View search and chat history',
+        usage: 'agora history [--limit N] [--clear] [--json]',
+        details: 'Shows recent searches and chat messages. History is stored locally and ' +
+            'works offline. Use --clear to erase all history.',
+        flags: [
+            { flag: '--limit', description: 'Number of entries to show (default: 50)' },
+            { flag: '--clear', description: 'Clear all history' },
+            { flag: '--json', description: 'Output as JSON' }
+        ],
+        examples: [
+            'agora history',
+            'agora history --limit 10',
+            'agora history --clear'
+        ]
+    }
+];
+//# sourceMappingURL=commands-meta.js.map

package/dist/cli/commands-meta.js.map

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

package/dist/cli/completions.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Pure completion providers for the Agora shell prompter.
+ * All functions are side-effect-free; callers inject I/O via context.
+ */
+export interface CompletionResult {
+    matches: string[];
+    replaceFrom: number;
+}
+export interface CompletionContext {
+    slashCommands: string[];
+    marketplaceIds: () => string[];
+    savedIds: () => string[];
+    listDir: (path: string) => string[];
+    cwd: string;
+}
+export declare function completeShellLine(line: string, cursor: number, context: CompletionContext): CompletionResult;
+export declare function ghostFromHistory(line: string, history: string[]): string | null;
+//# sourceMappingURL=completions.d.ts.map

package/dist/cli/completions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completions.d.ts","sourceRoot":"","sources":["../../src/cli/completions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,MAAM,EAAE,CAAC;IAC/B,QAAQ,EAAE,MAAM,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACpC,GAAG,EAAE,MAAM,CAAC;CACb;AAsCD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACzB,gBAAgB,CAyFlB;AA+ED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAS/E"}