workos 0.0.24 → 0.1.0

package/dist/src/lib/adapters/cli-adapter.js

@@ -0,0 +1,318 @@
+import clack from '../../utils/clack.js';
+import chalk from 'chalk';
+import { getConfig } from '../settings.js';
+import { ProgressTracker } from '../progress-tracker.js';
+/**
+ * CLI adapter that renders wizard events via clack.
+ *
+ * Subscribes to WizardEventEmitter and translates events into
+ * clack UI operations (logs, spinners, prompts).
+ */
+export class CLIAdapter {
+    emitter;
+    sendEvent;
+    debug;
+    spinner = null;
+    isStarted = false;
+    progress = new ProgressTracker();
+    // Store bound handlers for cleanup
+    handlers = new Map();
+    // Queue for logs while prompt is active (parallel state issue)
+    isPromptActive = false;
+    pendingLogs = [];
+    // SIGINT handler for cleanup
+    sigIntHandler = null;
+    // Long-running agent update interval
+    agentUpdateInterval = null;
+    constructor(config) {
+        this.emitter = config.emitter;
+        this.sendEvent = config.sendEvent;
+        this.debug = config.debug ?? false;
+    }
+    /**
+     * Queue a log call if a prompt is active, otherwise execute immediately.
+     */
+    queueableLog(logFn) {
+        if (this.isPromptActive) {
+            this.pendingLogs.push(logFn);
+        }
+        else {
+            logFn();
+        }
+    }
+    /**
+     * Flush any queued logs after prompt completes.
+     */
+    flushPendingLogs() {
+        const logs = this.pendingLogs.splice(0);
+        logs.forEach((fn) => fn());
+    }
+    async start() {
+        if (this.isStarted)
+            return;
+        this.isStarted = true;
+        // Show intro
+        const config = getConfig();
+        if (config.branding.showAsciiArt) {
+            const art = config.branding.useCompact ? config.branding.compactAsciiArt : config.branding.asciiArt;
+            console.log(chalk.cyan(art));
+            console.log();
+        }
+        else {
+            clack.intro('Welcome to the WorkOS AuthKit setup wizard');
+        }
+        // Handle Ctrl+C gracefully
+        const handleSigInt = () => {
+            if (this.spinner) {
+                this.spinner.stop('Cancelled');
+                this.spinner = null;
+            }
+            this.stopAgentUpdates();
+            clack.log.warn('Wizard cancelled');
+            clack.outro('Your project was not modified');
+            process.exit(0);
+        };
+        process.on('SIGINT', handleSigInt);
+        this.sigIntHandler = handleSigInt;
+        // Subscribe to state events for progress tracking
+        this.subscribe('state:enter', this.handleStateEnter);
+        this.subscribe('state:exit', this.handleStateExit);
+        // Subscribe to events that require UI rendering
+        this.subscribe('auth:success', this.handleAuthSuccess);
+        this.subscribe('auth:failure', this.handleAuthFailure);
+        this.subscribe('detection:complete', this.handleDetectionComplete);
+        this.subscribe('detection:none', this.handleDetectionNone);
+        this.subscribe('git:dirty', this.handleGitDirty);
+        this.subscribe('credentials:found', this.handleCredentialsFound);
+        this.subscribe('credentials:request', this.handleCredentialsRequest);
+        this.subscribe('config:complete', this.handleConfigComplete);
+        this.subscribe('agent:start', this.handleAgentStart);
+        this.subscribe('agent:progress', this.handleAgentProgress);
+        this.subscribe('validation:start', this.handleValidationStart);
+        this.subscribe('validation:issues', this.handleValidationIssues);
+        this.subscribe('validation:complete', this.handleValidationComplete);
+        this.subscribe('complete', this.handleComplete);
+        this.subscribe('error', this.handleError);
+    }
+    async stop() {
+        if (!this.isStarted)
+            return;
+        // Remove SIGINT handler
+        if (this.sigIntHandler) {
+            process.off('SIGINT', this.sigIntHandler);
+            this.sigIntHandler = null;
+        }
+        // Stop agent updates
+        this.stopAgentUpdates();
+        // Unsubscribe from all events
+        for (const [event, handler] of this.handlers) {
+            this.emitter.off(event, handler);
+        }
+        this.handlers.clear();
+        // Stop any active spinner
+        this.spinner?.stop();
+        this.spinner = null;
+        this.isStarted = false;
+    }
+    stopAgentUpdates = () => {
+        if (this.agentUpdateInterval) {
+            clearInterval(this.agentUpdateInterval);
+            this.agentUpdateInterval = null;
+        }
+    };
+    /** Debug logging - only outputs when debug mode is enabled */
+    debugLog = (message) => {
+        if (this.debug) {
+            console.log(chalk.dim(`[debug] ${message}`));
+        }
+    };
+    /**
+     * Helper to subscribe and track handlers for cleanup.
+     */
+    subscribe(event, handler) {
+        const boundHandler = handler.bind(this);
+        this.handlers.set(event, boundHandler);
+        this.emitter.on(event, boundHandler);
+    }
+    // ===== Event Handlers =====
+    handleStateEnter = ({ state }) => {
+        this.progress.enterPhase(state);
+    };
+    handleStateExit = ({ state }) => {
+        this.progress.exitPhase(state);
+    };
+    handleAuthSuccess = () => {
+        clack.log.success('Authenticated');
+    };
+    handleAuthFailure = ({ message }) => {
+        clack.log.error(`Auth failed: ${message}`);
+        clack.log.info('Visit https://dashboard.workos.com to verify your account');
+    };
+    handleDetectionComplete = ({ integration }) => {
+        this.queueableLog(() => clack.log.success(`Detected ${chalk.bold(integration)}`));
+    };
+    handleDetectionNone = () => {
+        this.queueableLog(() => clack.log.warn('Could not detect framework automatically'));
+    };
+    handleCredentialsFound = () => {
+        clack.log.success('Found existing WorkOS credentials in .env.local');
+    };
+    handleGitDirty = async ({ files }) => {
+        clack.log.warn('You have uncommitted or untracked files:');
+        files.slice(0, 5).forEach((f) => clack.log.info(chalk.dim(`  ${f}`)));
+        if (files.length > 5) {
+            clack.log.info(chalk.dim(`  ... and ${files.length - 5} more`));
+        }
+        this.isPromptActive = true;
+        const confirmed = await clack.confirm({
+            message: 'Continue anyway?',
+            initialValue: false,
+        });
+        this.isPromptActive = false;
+        this.flushPendingLogs();
+        if (clack.isCancel(confirmed)) {
+            this.sendEvent({ type: 'GIT_CANCELLED' });
+        }
+        else if (confirmed) {
+            this.sendEvent({ type: 'GIT_CONFIRMED' });
+        }
+        else {
+            this.sendEvent({ type: 'GIT_CANCELLED' });
+        }
+    };
+    handleCredentialsRequest = async ({ requiresApiKey }) => {
+        clack.log.step(`Get your credentials from ${chalk.cyan('https://dashboard.workos.com')}`);
+        const clientId = await clack.text({
+            message: 'Enter your WorkOS Client ID:',
+            placeholder: 'client_...',
+            validate: (value) => {
+                if (!value || value.trim().length === 0) {
+                    return 'Client ID is required';
+                }
+                if (!value.startsWith('client_')) {
+                    return 'Client ID should start with "client_"';
+                }
+                return undefined;
+            },
+        });
+        if (clack.isCancel(clientId)) {
+            this.sendEvent({ type: 'CANCEL' });
+            return;
+        }
+        let apiKey = '';
+        if (requiresApiKey) {
+            clack.log.info(chalk.dim('ℹ️ Your API key will be hidden for security and saved to .env.local'));
+            const apiKeyResult = await clack.password({
+                message: 'Enter your WorkOS API Key:',
+                validate: (value) => {
+                    if (!value || value.trim().length === 0) {
+                        return 'API Key is required';
+                    }
+                    if (!value.startsWith('sk_')) {
+                        return 'API Key should start with "sk_"';
+                    }
+                    return undefined;
+                },
+            });
+            if (clack.isCancel(apiKeyResult)) {
+                this.sendEvent({ type: 'CANCEL' });
+                return;
+            }
+            apiKey = apiKeyResult;
+        }
+        else {
+            clack.log.info(chalk.dim('ℹ️ Client-only SDK - API key not required'));
+        }
+        this.sendEvent({
+            type: 'CREDENTIALS_SUBMITTED',
+            apiKey,
+            clientId: clientId,
+        });
+    };
+    handleConfigComplete = () => {
+        clack.log.success('Environment configured');
+    };
+    handleAgentStart = () => {
+        this.spinner = clack.spinner();
+        this.spinner.start('Running AI agent...');
+        // Periodic status updates for long-running operations
+        let dots = 0;
+        this.agentUpdateInterval = setInterval(() => {
+            dots = (dots + 1) % 4;
+            const dotStr = '.'.repeat(dots + 1);
+            this.spinner?.message(`Running AI agent${dotStr}`);
+        }, 2000);
+    };
+    handleAgentProgress = ({ step, detail }) => {
+        const message = detail ? `${step}: ${detail}` : step;
+        this.spinner?.message(message);
+    };
+    handleValidationStart = () => {
+        this.stopAgentUpdates();
+        if (this.spinner) {
+            this.spinner.stop('Agent completed');
+            this.spinner = null;
+        }
+    };
+    handleValidationIssues = ({ issues }) => {
+        for (const issue of issues) {
+            if (issue.severity === 'error') {
+                clack.log.error(issue.message);
+            }
+            else {
+                clack.log.warn(issue.message);
+            }
+            if (issue.hint) {
+                clack.log.info(`Hint: ${issue.hint}`);
+            }
+        }
+    };
+    handleValidationComplete = ({ passed, issueCount }) => {
+        if (passed) {
+            clack.log.success('Validation passed');
+        }
+        else {
+            clack.log.warn(`Validation found ${issueCount} issue(s)`);
+        }
+    };
+    handleComplete = ({ success, summary }) => {
+        this.stopAgentUpdates();
+        if (this.spinner) {
+            this.spinner.stop(success ? 'Done' : 'Failed');
+            this.spinner = null;
+        }
+        if (success) {
+            clack.log.success('WorkOS AuthKit installed!');
+            clack.log.message('Next steps:');
+            clack.log.message('  • Start dev server to test authentication');
+            clack.log.message('  • Visit WorkOS Dashboard to manage users');
+            clack.outro(chalk.dim('Docs: https://workos.com/docs/authkit'));
+        }
+        else {
+            clack.log.error('Installation failed');
+            if (summary) {
+                clack.log.info(summary);
+            }
+            clack.outro(chalk.dim('Report issues: https://github.com/workos/installer/issues'));
+        }
+    };
+    handleError = ({ message, stack }) => {
+        if (this.spinner) {
+            this.spinner.stop('Error');
+            this.spinner = null;
+        }
+        this.stopAgentUpdates();
+        clack.log.error(message);
+        // Add actionable hints for common errors
+        if (message.includes('authentication') || message.includes('auth')) {
+            clack.log.info('Try running: wizard logout && wizard');
+        }
+        if (message.includes('ENOENT') || message.includes('not found')) {
+            clack.log.info('Ensure you are in a project directory');
+        }
+        if (stack && this.debug) {
+            this.debugLog(stack);
+        }
+    };
+}
+//# sourceMappingURL=cli-adapter.js.map

package/dist/src/lib/adapters/cli-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-adapter.js","sourceRoot":"","sources":["../../../../src/lib/adapters/cli-adapter.ts"],"names":[],"mappings":"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","sourcesContent":["import type { WizardAdapter, AdapterConfig } from './types.js';\nimport type { WizardEventEmitter, WizardEvents } from '../events.js';\nimport clack from '../../utils/clack.js';\nimport chalk from 'chalk';\nimport { getConfig } from '../settings.js';\nimport { ProgressTracker } from '../progress-tracker.js';\n\n/**\n * CLI adapter that renders wizard events via clack.\n *\n * Subscribes to WizardEventEmitter and translates events into\n * clack UI operations (logs, spinners, prompts).\n */\nexport class CLIAdapter implements WizardAdapter {\n  readonly emitter: WizardEventEmitter;\n  private sendEvent: AdapterConfig['sendEvent'];\n  private debug: boolean;\n  private spinner: ReturnType<typeof clack.spinner> | null = null;\n  private isStarted = false;\n  private progress = new ProgressTracker();\n\n  // Store bound handlers for cleanup\n  private handlers = new Map<string, (...args: unknown[]) => void>();\n\n  // Queue for logs while prompt is active (parallel state issue)\n  private isPromptActive = false;\n  private pendingLogs: Array<() => void> = [];\n\n  // SIGINT handler for cleanup\n  private sigIntHandler: (() => void) | null = null;\n\n  // Long-running agent update interval\n  private agentUpdateInterval: NodeJS.Timeout | null = null;\n\n  constructor(config: AdapterConfig) {\n    this.emitter = config.emitter;\n    this.sendEvent = config.sendEvent;\n    this.debug = config.debug ?? false;\n  }\n\n  /**\n   * Queue a log call if a prompt is active, otherwise execute immediately.\n   */\n  private queueableLog(logFn: () => void): void {\n    if (this.isPromptActive) {\n      this.pendingLogs.push(logFn);\n    } else {\n      logFn();\n    }\n  }\n\n  /**\n   * Flush any queued logs after prompt completes.\n   */\n  private flushPendingLogs(): void {\n    const logs = this.pendingLogs.splice(0);\n    logs.forEach((fn) => fn());\n  }\n\n  async start(): Promise<void> {\n    if (this.isStarted) return;\n    this.isStarted = true;\n\n    // Show intro\n    const config = getConfig();\n    if (config.branding.showAsciiArt) {\n      const art = config.branding.useCompact ? config.branding.compactAsciiArt : config.branding.asciiArt;\n      console.log(chalk.cyan(art));\n      console.log();\n    } else {\n      clack.intro('Welcome to the WorkOS AuthKit setup wizard');\n    }\n\n    // Handle Ctrl+C gracefully\n    const handleSigInt = () => {\n      if (this.spinner) {\n        this.spinner.stop('Cancelled');\n        this.spinner = null;\n      }\n      this.stopAgentUpdates();\n      clack.log.warn('Wizard cancelled');\n      clack.outro('Your project was not modified');\n      process.exit(0);\n    };\n    process.on('SIGINT', handleSigInt);\n    this.sigIntHandler = handleSigInt;\n\n    // Subscribe to state events for progress tracking\n    this.subscribe('state:enter', this.handleStateEnter);\n    this.subscribe('state:exit', this.handleStateExit);\n\n    // Subscribe to events that require UI rendering\n    this.subscribe('auth:success', this.handleAuthSuccess);\n    this.subscribe('auth:failure', this.handleAuthFailure);\n    this.subscribe('detection:complete', this.handleDetectionComplete);\n    this.subscribe('detection:none', this.handleDetectionNone);\n    this.subscribe('git:dirty', this.handleGitDirty);\n    this.subscribe('credentials:found', this.handleCredentialsFound);\n    this.subscribe('credentials:request', this.handleCredentialsRequest);\n    this.subscribe('config:complete', this.handleConfigComplete);\n    this.subscribe('agent:start', this.handleAgentStart);\n    this.subscribe('agent:progress', this.handleAgentProgress);\n    this.subscribe('validation:start', this.handleValidationStart);\n    this.subscribe('validation:issues', this.handleValidationIssues);\n    this.subscribe('validation:complete', this.handleValidationComplete);\n    this.subscribe('complete', this.handleComplete);\n    this.subscribe('error', this.handleError);\n  }\n\n  async stop(): Promise<void> {\n    if (!this.isStarted) return;\n\n    // Remove SIGINT handler\n    if (this.sigIntHandler) {\n      process.off('SIGINT', this.sigIntHandler);\n      this.sigIntHandler = null;\n    }\n\n    // Stop agent updates\n    this.stopAgentUpdates();\n\n    // Unsubscribe from all events\n    for (const [event, handler] of this.handlers) {\n      this.emitter.off(event as keyof WizardEvents, handler as never);\n    }\n    this.handlers.clear();\n\n    // Stop any active spinner\n    this.spinner?.stop();\n    this.spinner = null;\n\n    this.isStarted = false;\n  }\n\n  private stopAgentUpdates = (): void => {\n    if (this.agentUpdateInterval) {\n      clearInterval(this.agentUpdateInterval);\n      this.agentUpdateInterval = null;\n    }\n  };\n\n  /** Debug logging - only outputs when debug mode is enabled */\n  private debugLog = (message: string): void => {\n    if (this.debug) {\n      console.log(chalk.dim(`[debug] ${message}`));\n    }\n  };\n\n  /**\n   * Helper to subscribe and track handlers for cleanup.\n   */\n  private subscribe<K extends keyof WizardEvents>(\n    event: K,\n    handler: (payload: WizardEvents[K]) => void | Promise<void>,\n  ): void {\n    const boundHandler = handler.bind(this);\n    this.handlers.set(event, boundHandler as (...args: unknown[]) => void);\n    this.emitter.on(event, boundHandler);\n  }\n\n  // ===== Event Handlers =====\n\n  private handleStateEnter = ({ state }: WizardEvents['state:enter']): void => {\n    this.progress.enterPhase(state);\n  };\n\n  private handleStateExit = ({ state }: WizardEvents['state:exit']): void => {\n    this.progress.exitPhase(state);\n  };\n\n  private handleAuthSuccess = (): void => {\n    clack.log.success('Authenticated');\n  };\n\n  private handleAuthFailure = ({ message }: WizardEvents['auth:failure']): void => {\n    clack.log.error(`Auth failed: ${message}`);\n    clack.log.info('Visit https://dashboard.workos.com to verify your account');\n  };\n\n  private handleDetectionComplete = ({ integration }: WizardEvents['detection:complete']): void => {\n    this.queueableLog(() => clack.log.success(`Detected ${chalk.bold(integration)}`));\n  };\n\n  private handleDetectionNone = (): void => {\n    this.queueableLog(() => clack.log.warn('Could not detect framework automatically'));\n  };\n\n  private handleCredentialsFound = (): void => {\n    clack.log.success('Found existing WorkOS credentials in .env.local');\n  };\n\n  private handleGitDirty = async ({ files }: WizardEvents['git:dirty']): Promise<void> => {\n    clack.log.warn('You have uncommitted or untracked files:');\n    files.slice(0, 5).forEach((f) => clack.log.info(chalk.dim(`  ${f}`)));\n    if (files.length > 5) {\n      clack.log.info(chalk.dim(`  ... and ${files.length - 5} more`));\n    }\n\n    this.isPromptActive = true;\n    const confirmed = await clack.confirm({\n      message: 'Continue anyway?',\n      initialValue: false,\n    });\n    this.isPromptActive = false;\n    this.flushPendingLogs();\n\n    if (clack.isCancel(confirmed)) {\n      this.sendEvent({ type: 'GIT_CANCELLED' });\n    } else if (confirmed) {\n      this.sendEvent({ type: 'GIT_CONFIRMED' });\n    } else {\n      this.sendEvent({ type: 'GIT_CANCELLED' });\n    }\n  };\n\n  private handleCredentialsRequest = async ({ requiresApiKey }: WizardEvents['credentials:request']): Promise<void> => {\n    clack.log.step(`Get your credentials from ${chalk.cyan('https://dashboard.workos.com')}`);\n\n    const clientId = await clack.text({\n      message: 'Enter your WorkOS Client ID:',\n      placeholder: 'client_...',\n      validate: (value) => {\n        if (!value || value.trim().length === 0) {\n          return 'Client ID is required';\n        }\n        if (!value.startsWith('client_')) {\n          return 'Client ID should start with \"client_\"';\n        }\n        return undefined;\n      },\n    });\n\n    if (clack.isCancel(clientId)) {\n      this.sendEvent({ type: 'CANCEL' });\n      return;\n    }\n\n    let apiKey = '';\n    if (requiresApiKey) {\n      clack.log.info(chalk.dim('ℹ️ Your API key will be hidden for security and saved to .env.local'));\n      const apiKeyResult = await clack.password({\n        message: 'Enter your WorkOS API Key:',\n        validate: (value) => {\n          if (!value || value.trim().length === 0) {\n            return 'API Key is required';\n          }\n          if (!value.startsWith('sk_')) {\n            return 'API Key should start with \"sk_\"';\n          }\n          return undefined;\n        },\n      });\n\n      if (clack.isCancel(apiKeyResult)) {\n        this.sendEvent({ type: 'CANCEL' });\n        return;\n      }\n      apiKey = apiKeyResult as string;\n    } else {\n      clack.log.info(chalk.dim('ℹ️ Client-only SDK - API key not required'));\n    }\n\n    this.sendEvent({\n      type: 'CREDENTIALS_SUBMITTED',\n      apiKey,\n      clientId: clientId as string,\n    });\n  };\n\n  private handleConfigComplete = (): void => {\n    clack.log.success('Environment configured');\n  };\n\n  private handleAgentStart = (): void => {\n    this.spinner = clack.spinner();\n    this.spinner.start('Running AI agent...');\n\n    // Periodic status updates for long-running operations\n    let dots = 0;\n    this.agentUpdateInterval = setInterval(() => {\n      dots = (dots + 1) % 4;\n      const dotStr = '.'.repeat(dots + 1);\n      this.spinner?.message(`Running AI agent${dotStr}`);\n    }, 2000);\n  };\n\n  private handleAgentProgress = ({ step, detail }: WizardEvents['agent:progress']): void => {\n    const message = detail ? `${step}: ${detail}` : step;\n    this.spinner?.message(message);\n  };\n\n  private handleValidationStart = (): void => {\n    this.stopAgentUpdates();\n    if (this.spinner) {\n      this.spinner.stop('Agent completed');\n      this.spinner = null;\n    }\n  };\n\n  private handleValidationIssues = ({ issues }: WizardEvents['validation:issues']): void => {\n    for (const issue of issues) {\n      if (issue.severity === 'error') {\n        clack.log.error(issue.message);\n      } else {\n        clack.log.warn(issue.message);\n      }\n      if (issue.hint) {\n        clack.log.info(`Hint: ${issue.hint}`);\n      }\n    }\n  };\n\n  private handleValidationComplete = ({ passed, issueCount }: WizardEvents['validation:complete']): void => {\n    if (passed) {\n      clack.log.success('Validation passed');\n    } else {\n      clack.log.warn(`Validation found ${issueCount} issue(s)`);\n    }\n  };\n\n  private handleComplete = ({ success, summary }: WizardEvents['complete']): void => {\n    this.stopAgentUpdates();\n\n    if (this.spinner) {\n      this.spinner.stop(success ? 'Done' : 'Failed');\n      this.spinner = null;\n    }\n\n    if (success) {\n      clack.log.success('WorkOS AuthKit installed!');\n      clack.log.message('Next steps:');\n      clack.log.message('  • Start dev server to test authentication');\n      clack.log.message('  • Visit WorkOS Dashboard to manage users');\n      clack.outro(chalk.dim('Docs: https://workos.com/docs/authkit'));\n    } else {\n      clack.log.error('Installation failed');\n      if (summary) {\n        clack.log.info(summary);\n      }\n      clack.outro(chalk.dim('Report issues: https://github.com/workos/installer/issues'));\n    }\n  };\n\n  private handleError = ({ message, stack }: WizardEvents['error']): void => {\n    if (this.spinner) {\n      this.spinner.stop('Error');\n      this.spinner = null;\n    }\n    this.stopAgentUpdates();\n\n    clack.log.error(message);\n\n    // Add actionable hints for common errors\n    if (message.includes('authentication') || message.includes('auth')) {\n      clack.log.info('Try running: wizard logout && wizard');\n    }\n    if (message.includes('ENOENT') || message.includes('not found')) {\n      clack.log.info('Ensure you are in a project directory');\n    }\n\n    if (stack && this.debug) {\n      this.debugLog(stack);\n    }\n  };\n}\n"]}

package/dist/src/lib/adapters/dashboard-adapter.d.ts

@@ -0,0 +1,30 @@
+import type { WizardAdapter, AdapterConfig } from './types.js';
+import type { WizardEventEmitter } from '../events.js';
+/**
+ * Dashboard adapter that renders wizard events via Ink/React TUI.
+ *
+ * Wraps the existing Dashboard component and passes the emitter to it.
+ * The Dashboard component already handles most event rendering internally.
+ */
+export declare class DashboardAdapter implements WizardAdapter {
+    readonly emitter: WizardEventEmitter;
+    private sendEvent;
+    private cleanup;
+    private isStarted;
+    private completionData;
+    constructor(config: AdapterConfig);
+    start(): Promise<void>;
+    /**
+     * Capture completion data for display after exit.
+     */
+    private handleComplete;
+    stop(): Promise<void>;
+    /**
+     * Handle confirm dialog responses from Dashboard.
+     */
+    private handleConfirmResponse;
+    /**
+     * Handle credentials form submission from Dashboard.
+     */
+    private handleCredentialsResponse;
+}

package/dist/src/lib/adapters/dashboard-adapter.js

@@ -0,0 +1,97 @@
+import chalk from 'chalk';
+/**
+ * Dashboard adapter that renders wizard events via Ink/React TUI.
+ *
+ * Wraps the existing Dashboard component and passes the emitter to it.
+ * The Dashboard component already handles most event rendering internally.
+ */
+export class DashboardAdapter {
+    emitter;
+    sendEvent;
+    cleanup = null;
+    isStarted = false;
+    completionData = null;
+    constructor(config) {
+        this.emitter = config.emitter;
+        this.sendEvent = config.sendEvent;
+    }
+    async start() {
+        if (this.isStarted)
+            return;
+        this.isStarted = true;
+        // Dynamic imports to avoid loading Ink when not needed
+        const { render } = await import('ink');
+        const { createElement } = await import('react');
+        const { Dashboard } = await import('../../dashboard/components/Dashboard.js');
+        // Enter fullscreen (alternate screen buffer)
+        process.stdout.write('\x1b[?1049h'); // Enter alternate screen
+        process.stdout.write('\x1b[2J'); // Clear entire screen
+        process.stdout.write('\x1b[H'); // Move cursor to home
+        process.stdout.write('\x1b[?25l'); // Hide cursor
+        // Render the Dashboard component with emitter
+        const instance = render(createElement(Dashboard, { emitter: this.emitter }));
+        // Setup cleanup function
+        this.cleanup = () => {
+            instance.unmount();
+            process.stdout.write('\x1b[?25h'); // Show cursor
+            process.stdout.write('\x1b[?1049l'); // Exit alternate screen
+        };
+        // Wire up Dashboard responses back to the machine
+        // The Dashboard component emits these when user interacts
+        this.emitter.on('confirm:response', this.handleConfirmResponse);
+        this.emitter.on('credentials:response', this.handleCredentialsResponse);
+        // Track completion for post-exit summary
+        this.emitter.on('complete', this.handleComplete);
+    }
+    /**
+     * Capture completion data for display after exit.
+     */
+    handleComplete = ({ success, summary }) => {
+        this.completionData = { success, summary };
+    };
+    async stop() {
+        if (!this.isStarted)
+            return;
+        // Unsubscribe from events
+        this.emitter.off('confirm:response', this.handleConfirmResponse);
+        this.emitter.off('credentials:response', this.handleCredentialsResponse);
+        this.emitter.off('complete', this.handleComplete);
+        // Run cleanup (unmount Ink, exit fullscreen)
+        this.cleanup?.();
+        this.cleanup = null;
+        // Print completion summary to terminal after exiting alternate screen
+        if (this.completionData) {
+            console.log(); // blank line
+            if (this.completionData.success) {
+                console.log(chalk.green('✓ Installation Complete'));
+                if (this.completionData.summary) {
+                    console.log();
+                    console.log(this.completionData.summary);
+                }
+            }
+            else {
+                console.log(chalk.red('✗ Installation Failed'));
+                if (this.completionData.summary) {
+                    console.log(chalk.dim(this.completionData.summary));
+                }
+            }
+            console.log();
+        }
+        this.isStarted = false;
+    }
+    /**
+     * Handle confirm dialog responses from Dashboard.
+     */
+    handleConfirmResponse = ({ id, confirmed }) => {
+        if (id === 'git-status') {
+            this.sendEvent({ type: confirmed ? 'GIT_CONFIRMED' : 'GIT_CANCELLED' });
+        }
+    };
+    /**
+     * Handle credentials form submission from Dashboard.
+     */
+    handleCredentialsResponse = ({ apiKey, clientId }) => {
+        this.sendEvent({ type: 'CREDENTIALS_SUBMITTED', apiKey, clientId });
+    };
+}
+//# sourceMappingURL=dashboard-adapter.js.map

package/dist/src/lib/adapters/dashboard-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-adapter.js","sourceRoot":"","sources":["../../../../src/lib/adapters/dashboard-adapter.ts"],"names":[],"mappings":"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","sourcesContent":["import type { WizardAdapter, AdapterConfig } from './types.js';\nimport type { WizardEventEmitter, WizardEvents } from '../events.js';\nimport chalk from 'chalk';\n\n/**\n * Dashboard adapter that renders wizard events via Ink/React TUI.\n *\n * Wraps the existing Dashboard component and passes the emitter to it.\n * The Dashboard component already handles most event rendering internally.\n */\nexport class DashboardAdapter implements WizardAdapter {\n  readonly emitter: WizardEventEmitter;\n  private sendEvent: AdapterConfig['sendEvent'];\n  private cleanup: (() => void) | null = null;\n  private isStarted = false;\n  private completionData: { success: boolean; summary?: string } | null = null;\n\n  constructor(config: AdapterConfig) {\n    this.emitter = config.emitter;\n    this.sendEvent = config.sendEvent;\n  }\n\n  async start(): Promise<void> {\n    if (this.isStarted) return;\n    this.isStarted = true;\n\n    // Dynamic imports to avoid loading Ink when not needed\n    const { render } = await import('ink');\n    const { createElement } = await import('react');\n    const { Dashboard } = await import('../../dashboard/components/Dashboard.js');\n\n    // Enter fullscreen (alternate screen buffer)\n    process.stdout.write('\\x1b[?1049h'); // Enter alternate screen\n    process.stdout.write('\\x1b[2J'); // Clear entire screen\n    process.stdout.write('\\x1b[H'); // Move cursor to home\n    process.stdout.write('\\x1b[?25l'); // Hide cursor\n\n    // Render the Dashboard component with emitter\n    const instance = render(createElement(Dashboard, { emitter: this.emitter }));\n\n    // Setup cleanup function\n    this.cleanup = () => {\n      instance.unmount();\n      process.stdout.write('\\x1b[?25h'); // Show cursor\n      process.stdout.write('\\x1b[?1049l'); // Exit alternate screen\n    };\n\n    // Wire up Dashboard responses back to the machine\n    // The Dashboard component emits these when user interacts\n    this.emitter.on('confirm:response', this.handleConfirmResponse);\n    this.emitter.on('credentials:response', this.handleCredentialsResponse);\n\n    // Track completion for post-exit summary\n    this.emitter.on('complete', this.handleComplete);\n  }\n\n  /**\n   * Capture completion data for display after exit.\n   */\n  private handleComplete = ({ success, summary }: WizardEvents['complete']): void => {\n    this.completionData = { success, summary };\n  };\n\n  async stop(): Promise<void> {\n    if (!this.isStarted) return;\n\n    // Unsubscribe from events\n    this.emitter.off('confirm:response', this.handleConfirmResponse);\n    this.emitter.off('credentials:response', this.handleCredentialsResponse);\n    this.emitter.off('complete', this.handleComplete);\n\n    // Run cleanup (unmount Ink, exit fullscreen)\n    this.cleanup?.();\n    this.cleanup = null;\n\n    // Print completion summary to terminal after exiting alternate screen\n    if (this.completionData) {\n      console.log(); // blank line\n      if (this.completionData.success) {\n        console.log(chalk.green('✓ Installation Complete'));\n        if (this.completionData.summary) {\n          console.log();\n          console.log(this.completionData.summary);\n        }\n      } else {\n        console.log(chalk.red('✗ Installation Failed'));\n        if (this.completionData.summary) {\n          console.log(chalk.dim(this.completionData.summary));\n        }\n      }\n      console.log();\n    }\n\n    this.isStarted = false;\n  }\n\n  /**\n   * Handle confirm dialog responses from Dashboard.\n   */\n  private handleConfirmResponse = ({ id, confirmed }: { id: string; confirmed: boolean }): void => {\n    if (id === 'git-status') {\n      this.sendEvent({ type: confirmed ? 'GIT_CONFIRMED' : 'GIT_CANCELLED' });\n    }\n  };\n\n  /**\n   * Handle credentials form submission from Dashboard.\n   */\n  private handleCredentialsResponse = ({ apiKey, clientId }: { apiKey: string; clientId: string }): void => {\n    this.sendEvent({ type: 'CREDENTIALS_SUBMITTED', apiKey, clientId });\n  };\n}\n"]}

package/dist/src/lib/adapters/index.d.ts

@@ -0,0 +1,3 @@
+export { CLIAdapter } from './cli-adapter.js';
+export { DashboardAdapter } from './dashboard-adapter.js';
+export type { WizardAdapter, AdapterConfig } from './types.js';

package/dist/src/lib/adapters/index.js

@@ -0,0 +1,3 @@
+export { CLIAdapter } from './cli-adapter.js';
+export { DashboardAdapter } from './dashboard-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/src/lib/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC","sourcesContent":["export { CLIAdapter } from './cli-adapter.js';\nexport { DashboardAdapter } from './dashboard-adapter.js';\nexport type { WizardAdapter, AdapterConfig } from './types.js';\n"]}

package/dist/src/lib/adapters/types.d.ts

@@ -0,0 +1,41 @@
+import type { WizardEventEmitter } from '../events.js';
+/**
+ * Configuration passed to adapter constructors.
+ */
+export interface AdapterConfig {
+    /** Event emitter to subscribe to */
+    emitter: WizardEventEmitter;
+    /**
+     * Callback to send events back to the machine.
+     * Used for user responses (confirmations, credentials, etc.)
+     */
+    sendEvent: (event: {
+        type: string;
+        [key: string]: unknown;
+    }) => void;
+    /** Enable verbose debug output (stack traces, etc.) */
+    debug?: boolean;
+}
+/**
+ * Interface all UI adapters must implement.
+ *
+ * Adapters are event subscribers that translate machine events
+ * into framework-specific UI rendering. They don't control flow—
+ * they react to it.
+ */
+export interface WizardAdapter {
+    /**
+     * Start the adapter.
+     * - Subscribe to emitter events
+     * - Initialize UI framework (show intro, enter fullscreen, etc.)
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the adapter.
+     * - Unsubscribe from all events
+     * - Clean up UI (exit fullscreen, restore terminal, etc.)
+     */
+    stop(): Promise<void>;
+    /** The emitter this adapter subscribes to */
+    readonly emitter: WizardEventEmitter;
+}

package/dist/src/lib/adapters/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/lib/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/lib/adapters/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { WizardEventEmitter } from '../events.js';\n\n/**\n * Configuration passed to adapter constructors.\n */\nexport interface AdapterConfig {\n  /** Event emitter to subscribe to */\n  emitter: WizardEventEmitter;\n\n  /**\n   * Callback to send events back to the machine.\n   * Used for user responses (confirmations, credentials, etc.)\n   */\n  sendEvent: (event: { type: string; [key: string]: unknown }) => void;\n\n  /** Enable verbose debug output (stack traces, etc.) */\n  debug?: boolean;\n}\n\n/**\n * Interface all UI adapters must implement.\n *\n * Adapters are event subscribers that translate machine events\n * into framework-specific UI rendering. They don't control flow—\n * they react to it.\n */\nexport interface WizardAdapter {\n  /**\n   * Start the adapter.\n   * - Subscribe to emitter events\n   * - Initialize UI framework (show intro, enter fullscreen, etc.)\n   */\n  start(): Promise<void>;\n\n  /**\n   * Stop the adapter.\n   * - Unsubscribe from all events\n   * - Clean up UI (exit fullscreen, restore terminal, etc.)\n   */\n  stop(): Promise<void>;\n\n  /** The emitter this adapter subscribes to */\n  readonly emitter: WizardEventEmitter;\n}\n"]}

package/dist/src/lib/agent-interface.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Shared agent interface for WorkOS wizards
+ * Uses Claude Agent SDK directly with WorkOS MCP server
+ */
+import type { WizardOptions } from '../utils/types.js';
+import type { WizardEventEmitter } from './events.js';
+type McpServersConfig = any;
+export declare const AgentSignals: {
+    /** Signal emitted when the agent reports progress to the user */
+    readonly STATUS: "[STATUS]";
+    /** Signal emitted when the agent cannot access the WorkOS MCP server */
+    readonly ERROR_MCP_MISSING: "[ERROR-MCP-MISSING]";
+    /** Signal emitted when the agent cannot access the setup resource */
+    readonly ERROR_RESOURCE_MISSING: "[ERROR-RESOURCE-MISSING]";
+};
+export type AgentSignal = (typeof AgentSignals)[keyof typeof AgentSignals];
+/**
+ * Error types that can be returned from agent execution.
+ * These correspond to the error signals that the agent emits.
+ */
+export declare enum AgentErrorType {
+    /** Agent could not access the WorkOS MCP server */
+    MCP_MISSING = "WIZARD_MCP_MISSING",
+    /** Agent could not access the setup resource */
+    RESOURCE_MISSING = "WIZARD_RESOURCE_MISSING",
+    /** Agent execution failed (API error, auth error, etc.) */
+    EXECUTION_ERROR = "WIZARD_EXECUTION_ERROR"
+}
+export type AgentConfig = {
+    workingDirectory: string;
+    workOSApiKey: string;
+    workOSApiHost: string;
+};
+/**
+ * Internal configuration object returned by initializeAgent
+ */
+type AgentRunConfig = {
+    workingDirectory: string;
+    mcpServers: McpServersConfig;
+    model: string;
+    allowedTools: string[];
+};
+/**
+ * Permission hook that allows only safe commands.
+ * - Package manager install commands
+ * - Build/typecheck/lint commands for verification
+ * - Piping to tail/head for output limiting is allowed
+ * - Stderr redirection (2>&1) is allowed
+ */
+export declare function wizardCanUseTool(toolName: string, input: Record<string, unknown>): {
+    behavior: 'allow';
+    updatedInput: Record<string, unknown>;
+} | {
+    behavior: 'deny';
+    message: string;
+};
+/**
+ * Initialize agent configuration for the LLM gateway
+ */
+export declare function initializeAgent(config: AgentConfig, options: WizardOptions): Promise<AgentRunConfig>;
+/**
+ * Execute an agent with the provided prompt and options
+ * Handles the full lifecycle via event emissions - adapters handle UI rendering.
+ *
+ * @returns An object containing any error detected in the agent's output
+ */
+export declare function runAgent(agentConfig: AgentRunConfig, prompt: string, options: WizardOptions, config?: {
+    spinnerMessage?: string;
+    successMessage?: string;
+    errorMessage?: string;
+}, emitter?: WizardEventEmitter): Promise<{
+    error?: AgentErrorType;
+    errorMessage?: string;
+}>;
+export {};