@nordsym/apiclaw 1.3.6 → 1.3.8

package/dist/ui/prompts.d.ts

@@ -0,0 +1,88 @@
+/**
+ * APIClaw MCP Auto-Setup - Interactive Prompts
+ *
+ * Inquirer-based prompts for the --wizard mode.
+ * Provides a guided, interactive setup experience.
+ */
+/**
+ * Detected client information
+ */
+export interface DetectedClient {
+    id: string;
+    name: string;
+    detected: boolean;
+    configPath: string;
+    alreadyConfigured: boolean;
+}
+/**
+ * Configuration change preview
+ */
+export interface ConfigChange {
+    clientId: string;
+    clientName: string;
+    configPath: string;
+    action: 'create' | 'update' | 'skip';
+    diff?: string;
+}
+/**
+ * Wizard result
+ */
+export interface WizardResult {
+    selectedClients: string[];
+    workspace?: string;
+    confirmed: boolean;
+    dryRun: boolean;
+}
+/**
+ * Display welcome banner
+ */
+export declare function showWelcome(): void;
+/**
+ * Prompt for client selection
+ */
+export declare function selectClients(clients: DetectedClient[]): Promise<string[]>;
+/**
+ * Prompt for custom config path
+ */
+export declare function promptCustomPath(): Promise<string>;
+/**
+ * Prompt for workspace ID
+ */
+export declare function promptWorkspace(): Promise<string | undefined>;
+/**
+ * Show preview of changes and confirm
+ */
+export declare function confirmChanges(changes: ConfigChange[], options?: {
+    dryRun?: boolean;
+}): Promise<boolean>;
+/**
+ * Prompt for force overwrite
+ */
+export declare function confirmForce(clientName: string): Promise<boolean>;
+/**
+ * Show success message with next steps
+ */
+export declare function showSuccess(configuredClients: string[]): void;
+/**
+ * Show dry-run summary
+ */
+export declare function showDryRunSummary(changes: ConfigChange[]): void;
+/**
+ * Run the full interactive wizard
+ */
+export declare function runWizard(clients: DetectedClient[], options?: {
+    dryRun?: boolean;
+}): Promise<WizardResult>;
+/**
+ * Prompt for restore backup selection
+ */
+export declare function selectBackup(backups: {
+    path: string;
+    date: Date;
+    client: string;
+}[]): Promise<string | null>;
+/**
+ * Confirm uninstall
+ */
+export declare function confirmUninstall(clients: string[]): Promise<boolean>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/ui/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/ui/prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAuDhF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAmBxD;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgCnE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,OAAO,CAAC,CAsClB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,iBAAiB,EAAE,MAAM,EAAE,GAAG,IAAI,CAgB7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAW/D;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,cAAc,EAAE,EACzB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,YAAY,CAAC,CA2CvB;AAqBD;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0BlH;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAe1E"}

package/dist/ui/prompts.js

@@ -0,0 +1,295 @@
+/**
+ * APIClaw MCP Auto-Setup - Interactive Prompts
+ *
+ * Inquirer-based prompts for the --wizard mode.
+ * Provides a guided, interactive setup experience.
+ */
+import inquirer from 'inquirer';
+import { colors, icons, header, box, codeBlock, added, bulletList } from './colors.js';
+/**
+ * Display welcome banner
+ */
+export function showWelcome() {
+    console.log(header('APIClaw MCP Auto-Setup'));
+    console.log(colors.secondary('Configure APIClaw as an MCP server across your AI coding assistants.\n'));
+}
+/**
+ * Prompt for client selection
+ */
+export async function selectClients(clients) {
+    console.log(colors.info(`${icons.search} Detected MCP clients:\n`));
+    // Show detection results
+    for (const client of clients) {
+        if (client.detected) {
+            const status = client.alreadyConfigured
+                ? colors.warning(`(already configured)`)
+                : colors.success('(detected)');
+            console.log(`  ${icons.success} ${colors.highlight(client.name)} ${status}`);
+            console.log(colors.muted(`    ${client.configPath}`));
+        }
+        else {
+            console.log(`  ${icons.pending} ${colors.muted(client.name)} ${colors.muted('(not found)')}`);
+        }
+    }
+    console.log();
+    const detectedClients = clients.filter(c => c.detected);
+    if (detectedClients.length === 0) {
+        console.log(colors.warning('No MCP clients detected on this system.'));
+        console.log(colors.secondary('\nYou can still configure a custom path.\n'));
+    }
+    const choices = clients.map(client => ({
+        name: `${client.name}${client.detected ? '' : ' (not detected)'}${client.alreadyConfigured ? ' ⚠️ already configured' : ''}`,
+        value: client.id,
+        checked: client.detected && !client.alreadyConfigured,
+        disabled: !client.detected && client.id !== 'custom' ? 'Not installed' : false,
+    }));
+    // Add custom option
+    choices.push({
+        name: 'Custom config path...',
+        value: 'custom',
+        checked: false,
+        disabled: false,
+    });
+    const { selected } = await inquirer.prompt([
+        {
+            type: 'checkbox',
+            name: 'selected',
+            message: 'Which clients do you want to configure?',
+            choices,
+            validate: (answer) => {
+                if (answer.length === 0) {
+                    return 'Please select at least one client.';
+                }
+                return true;
+            },
+        },
+    ]);
+    return selected;
+}
+/**
+ * Prompt for custom config path
+ */
+export async function promptCustomPath() {
+    const { customPath } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'customPath',
+            message: 'Enter the path to your MCP config file:',
+            validate: (input) => {
+                if (!input.trim()) {
+                    return 'Please enter a valid path.';
+                }
+                if (!input.endsWith('.json')) {
+                    return 'Config file should be a .json file.';
+                }
+                return true;
+            },
+        },
+    ]);
+    return customPath;
+}
+/**
+ * Prompt for workspace ID
+ */
+export async function promptWorkspace() {
+    const { hasWorkspace } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'hasWorkspace',
+            message: 'Do you have an APIClaw workspace ID to link?',
+            default: false,
+        },
+    ]);
+    if (!hasWorkspace) {
+        return undefined;
+    }
+    const { workspace } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'workspace',
+            message: 'Enter your workspace ID:',
+            validate: (input) => {
+                if (!input.trim()) {
+                    return 'Please enter a workspace ID.';
+                }
+                if (!input.startsWith('ws_')) {
+                    return 'Workspace ID should start with "ws_"';
+                }
+                return true;
+            },
+        },
+    ]);
+    return workspace;
+}
+/**
+ * Show preview of changes and confirm
+ */
+export async function confirmChanges(changes, options = {}) {
+    console.log(header('Review Changes'));
+    for (const change of changes) {
+        const actionLabel = {
+            create: colors.success('CREATE'),
+            update: colors.warning('UPDATE'),
+            skip: colors.muted('SKIP'),
+        }[change.action];
+        console.log(`${actionLabel} ${colors.highlight(change.clientName)}`);
+        console.log(colors.muted(`  ${change.configPath}\n`));
+        if (change.diff) {
+            console.log(codeBlock(change.diff));
+            console.log();
+        }
+    }
+    if (options.dryRun) {
+        console.log(box(colors.info('Dry-run mode: No changes will be made.'), { borderColor: colors.info }));
+        console.log();
+        return true;
+    }
+    const { confirmed } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'confirmed',
+            message: 'Apply these changes?',
+            default: true,
+        },
+    ]);
+    return confirmed;
+}
+/**
+ * Prompt for force overwrite
+ */
+export async function confirmForce(clientName) {
+    const { force } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'force',
+            message: `${clientName} already has APIClaw configured. Overwrite?`,
+            default: false,
+        },
+    ]);
+    return force;
+}
+/**
+ * Show success message with next steps
+ */
+export function showSuccess(configuredClients) {
+    console.log();
+    console.log(box(`${icons.check} APIClaw configured successfully!\n\n` +
+        `Configured: ${configuredClients.join(', ')}`, { title: 'Success', borderColor: colors.success }));
+    console.log(colors.secondary('\nNext steps:'));
+    console.log(bulletList([
+        `Restart ${configuredClients.join(' / ')}`,
+        'Ask your agent: "List available APIs"',
+    ], 2));
+    console.log(colors.secondary('\nNeed help?'));
+    console.log(`  ${colors.link('https://docs.apiclaw.com/setup')}\n`);
+}
+/**
+ * Show dry-run summary
+ */
+export function showDryRunSummary(changes) {
+    console.log();
+    console.log(box(`${icons.info} Dry-run complete\n\n` +
+        `Would configure: ${changes.filter(c => c.action !== 'skip').length} client(s)\n` +
+        `Would skip: ${changes.filter(c => c.action === 'skip').length} client(s)`, { title: 'Dry Run', borderColor: colors.info }));
+    console.log(colors.secondary('\nTo apply changes, run:'));
+    console.log(colors.action('  npx @nordsym/apiclaw setup\n'));
+}
+/**
+ * Run the full interactive wizard
+ */
+export async function runWizard(clients, options = {}) {
+    showWelcome();
+    // Select clients
+    const selectedClients = await selectClients(clients);
+    // Handle custom path if selected
+    const finalClients = [...selectedClients];
+    if (selectedClients.includes('custom')) {
+        const customPath = await promptCustomPath();
+        // Remove 'custom' placeholder and add actual path
+        const idx = finalClients.indexOf('custom');
+        finalClients[idx] = `custom:${customPath}`;
+    }
+    // Optionally link workspace
+    const workspace = await promptWorkspace();
+    // Build preview changes
+    const changes = finalClients.map(clientId => {
+        const isCustom = clientId.startsWith('custom:');
+        const client = isCustom
+            ? { id: 'custom', name: 'Custom', configPath: clientId.replace('custom:', ''), alreadyConfigured: false }
+            : clients.find(c => c.id === clientId);
+        return {
+            clientId: client.id,
+            clientName: client.name,
+            configPath: client.configPath,
+            action: client.alreadyConfigured ? 'skip' : 'update',
+            diff: generateDiff(workspace),
+        };
+    });
+    // Confirm changes
+    const confirmed = await confirmChanges(changes, { dryRun: options.dryRun });
+    return {
+        selectedClients: finalClients,
+        workspace,
+        confirmed,
+        dryRun: options.dryRun || false,
+    };
+}
+/**
+ * Generate diff preview for config change
+ */
+function generateDiff(workspace) {
+    const lines = [
+        added('"apiclaw": {'),
+        added('  "command": "npx",'),
+        added('  "args": ["-y", "@nordsym/apiclaw"]'),
+    ];
+    if (workspace) {
+        lines.splice(2, 0, added(`  "env": { "APICLAW_WORKSPACE": "${workspace}" },`));
+    }
+    lines.push(added('}'));
+    return lines.join('\n');
+}
+/**
+ * Prompt for restore backup selection
+ */
+export async function selectBackup(backups) {
+    if (backups.length === 0) {
+        console.log(colors.warning('No backups found.'));
+        return null;
+    }
+    const choices = backups.map(b => ({
+        name: `${b.client} - ${b.date.toLocaleString()} (${b.path})`,
+        value: b.path,
+    }));
+    choices.push({
+        name: 'Cancel',
+        value: '',
+    });
+    const { backup } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'backup',
+            message: 'Select a backup to restore:',
+            choices,
+        },
+    ]);
+    return backup || null;
+}
+/**
+ * Confirm uninstall
+ */
+export async function confirmUninstall(clients) {
+    console.log(colors.warning('\n⚠️  This will remove APIClaw from:\n'));
+    console.log(bulletList(clients, 2));
+    console.log();
+    const { confirmed } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'confirmed',
+            message: 'Are you sure you want to uninstall APIClaw?',
+            default: false,
+        },
+    ]);
+    return confirmed;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/ui/prompts.js.map

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

package/dist/ui/spinner.d.ts

@@ -0,0 +1,112 @@
+/**
+ * APIClaw MCP Auto-Setup - Spinner Utilities
+ *
+ * Ora-based spinner wrapper with consistent styling and state management.
+ * Provides a fluent API for progress indication during CLI operations.
+ */
+import { Ora, Options as OraOptions } from 'ora';
+export interface SpinnerOptions {
+    /** Spinner text */
+    text?: string;
+    /** Prefix text before spinner */
+    prefix?: string;
+    /** Suffix text after spinner */
+    suffix?: string;
+    /** Whether to show spinner in CI environments */
+    showInCI?: boolean;
+    /** Custom spinner frames */
+    spinner?: OraOptions['spinner'];
+}
+export interface TaskSpinner {
+    /** Start the spinner with optional text */
+    start(text?: string): TaskSpinner;
+    /** Update spinner text */
+    text(text: string): TaskSpinner;
+    /** Mark as successful with optional message */
+    succeed(text?: string): TaskSpinner;
+    /** Mark as failed with optional message */
+    fail(text?: string): TaskSpinner;
+    /** Mark as warning with optional message */
+    warn(text?: string): TaskSpinner;
+    /** Show info message without stopping */
+    info(text?: string): TaskSpinner;
+    /** Stop spinner without status */
+    stop(): TaskSpinner;
+    /** Stop and clear spinner */
+    clear(): TaskSpinner;
+    /** Check if spinner is currently spinning */
+    isSpinning(): boolean;
+    /** Access underlying ora instance */
+    readonly ora: Ora;
+}
+/**
+ * Create a task spinner with APIClaw styling
+ */
+export declare function createSpinner(options?: SpinnerOptions): TaskSpinner;
+/**
+ * Convenience function for common spinner patterns
+ */
+export declare const spinner: {
+    /**
+     * Create and start a spinner in one call
+     */
+    start(text: string): TaskSpinner;
+    /**
+     * Run an async task with spinner, auto-succeed/fail
+     */
+    task<T>(text: string, fn: (spinner: TaskSpinner) => Promise<T>, options?: {
+        successText?: string | ((result: T) => string);
+        failText?: string | ((error: Error) => string);
+    }): Promise<T>;
+    /**
+     * Run multiple tasks in sequence with spinners
+     */
+    sequence<T>(tasks: Array<{
+        text: string;
+        task: () => Promise<T>;
+        successText?: string;
+        failText?: string;
+    }>): Promise<T[]>;
+};
+/**
+ * Progress tracker for multi-step operations
+ */
+export declare class ProgressTracker {
+    private current;
+    private readonly total;
+    private readonly items;
+    private readonly taskSpinner;
+    constructor(items: string[]);
+    /**
+     * Start tracking progress
+     */
+    start(): void;
+    /**
+     * Move to next item
+     */
+    next(): void;
+    /**
+     * Mark current item as done and move to next
+     */
+    done(message?: string): void;
+    /**
+     * Mark as complete
+     */
+    complete(message: string): void;
+    /**
+     * Mark as failed
+     */
+    fail(message: string): void;
+    private updateText;
+    private formatProgress;
+}
+/**
+ * Silent spinner for non-interactive/CI environments
+ * Logs plain text instead of animated spinners
+ */
+export declare function createSilentSpinner(options?: SpinnerOptions): TaskSpinner;
+/**
+ * Get appropriate spinner based on environment
+ */
+export declare function getSpinner(options?: SpinnerOptions): TaskSpinner;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/ui/spinner.d.ts.map

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