workos 0.17.1 → 0.19.0

package/dist/utils/output.js.map

@@ -1 +1 @@
-{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Output mode system for non-TTY / JSON support.\n *\n * Resolves once at startup, drives output formatting only.\n * In JSON mode: structured JSON to stdout, structured errors to stderr.\n * In human mode: chalk-formatted output (existing behavior).\n */\n\nimport chalk from 'chalk';\nimport { CliExit } from './cli-exit.js';\nimport { resolveErrorCode } from './exit-codes.js';\nimport { formatTable, type TableColumn } from './table.js';\nimport type { RecoveryHints } from './recovery-hints.js';\nimport type { InteractionModeInfo } from './interaction-mode.js';\n\nexport type OutputMode = 'human' | 'json';\n\nlet currentMode: OutputMode = 'human';\n\n/**\n * Resolve the output mode based on flags and environment.\n *\n * Priority:\n * 1. Explicit --json flag\n * 2. WORKOS_FORCE_TTY env var → human output compatibility\n * 3. WORKOS_NO_PROMPT legacy compatibility → json\n * 4. Non-TTY auto-detection → json\n * 5. Default → human\n */\nexport function resolveOutputMode(jsonFlag?: boolean): OutputMode {\n  if (jsonFlag) return 'json';\n  if (process.env.WORKOS_FORCE_TTY === '1' || process.env.WORKOS_FORCE_TTY === 'true') return 'human';\n  if (process.env.WORKOS_NO_PROMPT === '1' || process.env.WORKOS_NO_PROMPT === 'true') return 'json';\n  if (!process.stdout.isTTY) return 'json';\n  return 'human';\n}\n\nexport function resolveEffectiveOutputMode(mode: OutputMode, interaction: InteractionModeInfo): OutputMode {\n  if (interaction.mode === 'human' || interaction.source === 'non_tty') {\n    return mode;\n  }\n  return 'json';\n}\n\nexport function setOutputMode(mode: OutputMode): void {\n  currentMode = mode;\n  if (mode === 'json') {\n    chalk.level = 0;\n  }\n}\n\nexport function getOutputMode(): OutputMode {\n  return currentMode;\n}\n\nexport function isJsonMode(): boolean {\n  return currentMode === 'json';\n}\n\n/** Write structured JSON to stdout (one line, no pretty-print). */\nexport function outputJson(data: unknown): void {\n  console.log(JSON.stringify(data));\n}\n\n/** Write a success result — chalk in human mode, JSON in json mode. */\nexport function outputSuccess(\n  message: string,\n  data?: object,\n  options?: { warnings?: Array<{ code: string; message: string }> },\n): void {\n  if (currentMode === 'json') {\n    const result: Record<string, unknown> = { status: 'ok', message };\n    if (data) result.data = data;\n    if (options?.warnings?.length) result.warnings = options.warnings;\n    console.log(JSON.stringify(result));\n  } else {\n    console.log(chalk.green(message));\n    if (data) {\n      console.log(JSON.stringify(data, null, 2));\n    }\n    if (options?.warnings?.length) {\n      for (const w of options.warnings) {\n        console.error(chalk.yellow(w.message));\n      }\n    }\n  }\n}\n\nexport interface StructuredError {\n  code: string;\n  message: string;\n  details?: unknown;\n  /**\n   * Optional structured recovery metadata for agents.\n   *\n   * Only include for deterministic recovery paths. Human output prints the\n   * first hint as a follow-up line; JSON output serializes the full structure.\n   */\n  recovery?: RecoveryHints;\n}\n\n/** Write a structured error to stderr. */\nexport function outputError(error: StructuredError): void {\n  if (currentMode === 'json') {\n    console.error(JSON.stringify({ error }));\n  } else {\n    console.error(chalk.red(error.message));\n    const firstHint = error.recovery?.hints[0];\n    if (firstHint) {\n      const suffix = firstHint.command ? ` Run: ${firstHint.command}` : '';\n      console.error(chalk.dim(`→ ${firstHint.description}${suffix}`));\n    }\n  }\n}\n\n/** Write tabular data — chalk table in human mode, JSON array in json mode. */\nexport function outputTable(columns: TableColumn[], rows: string[][], rawData?: unknown[]): void {\n  if (currentMode === 'json') {\n    if (rawData) {\n      console.log(JSON.stringify(rawData));\n    } else {\n      const headers = columns.map((c) => c.header);\n      const jsonRows = rows.map((row) => {\n        const obj: Record<string, string> = {};\n        headers.forEach((h, i) => {\n          obj[h] = row[i] ?? '';\n        });\n        return obj;\n      });\n      console.log(JSON.stringify(jsonRows));\n    }\n  } else {\n    console.log(formatTable(columns, rows));\n  }\n}\n\nexport function exitWithError(\n  error: StructuredError & {\n    apiContext?: { status?: number; code?: string; resource?: string };\n  },\n): never {\n  outputError(error);\n  const { reason: codeReason, exit } = resolveErrorCode(error.code);\n  const reason = error.apiContext && codeReason === 'validation_error' ? 'api_error' : codeReason;\n  throw new CliExit(exit, {\n    reason,\n    errorCode: error.code,\n    apiContext: error.apiContext,\n  });\n}\n"]}
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Output mode system for non-TTY / JSON support.\n *\n * Resolves once at startup, drives output formatting only.\n * In JSON mode: structured JSON to stdout, structured errors to stderr.\n * In human mode: chalk-formatted output (existing behavior).\n */\n\nimport chalk from 'chalk';\nimport { CliExit } from './cli-exit.js';\nimport { resolveErrorCode } from './exit-codes.js';\nimport { formatTable, type TableColumn } from './table.js';\nimport type { RecoveryHints } from './recovery-hints.js';\nimport type { InteractionModeInfo } from './interaction-mode.js';\n\nexport type OutputMode = 'human' | 'json';\n\nlet currentMode: OutputMode = 'human';\n\n/**\n * Resolve the output mode based on flags and environment.\n *\n * Priority:\n * 1. Explicit --json flag\n * 2. WORKOS_FORCE_TTY env var → human output compatibility\n * 3. Non-TTY auto-detection → json\n * 4. Default → human\n *\n * Note: agent interaction mode (WORKOS_MODE=agent) also forces JSON output,\n * applied separately via resolveEffectiveOutputMode().\n */\nexport function resolveOutputMode(jsonFlag?: boolean): OutputMode {\n  if (jsonFlag) return 'json';\n  if (process.env.WORKOS_FORCE_TTY === '1' || process.env.WORKOS_FORCE_TTY === 'true') return 'human';\n  if (!process.stdout.isTTY) return 'json';\n  return 'human';\n}\n\nexport function resolveEffectiveOutputMode(mode: OutputMode, interaction: InteractionModeInfo): OutputMode {\n  if (interaction.mode === 'human' || interaction.source === 'non_tty') {\n    return mode;\n  }\n  return 'json';\n}\n\nexport function setOutputMode(mode: OutputMode): void {\n  currentMode = mode;\n  if (mode === 'json') {\n    chalk.level = 0;\n  }\n}\n\nexport function getOutputMode(): OutputMode {\n  return currentMode;\n}\n\nexport function isJsonMode(): boolean {\n  return currentMode === 'json';\n}\n\n/** Write structured JSON to stdout (one line, no pretty-print). */\nexport function outputJson(data: unknown): void {\n  console.log(JSON.stringify(data));\n}\n\n/** Write a success result — chalk in human mode, JSON in json mode. */\nexport function outputSuccess(\n  message: string,\n  data?: object,\n  options?: { warnings?: Array<{ code: string; message: string }> },\n): void {\n  if (currentMode === 'json') {\n    const result: Record<string, unknown> = { status: 'ok', message };\n    if (data) result.data = data;\n    if (options?.warnings?.length) result.warnings = options.warnings;\n    console.log(JSON.stringify(result));\n  } else {\n    console.log(chalk.green(message));\n    if (data) {\n      console.log(JSON.stringify(data, null, 2));\n    }\n    if (options?.warnings?.length) {\n      for (const w of options.warnings) {\n        console.error(chalk.yellow(w.message));\n      }\n    }\n  }\n}\n\nexport interface StructuredError {\n  code: string;\n  message: string;\n  details?: unknown;\n  /**\n   * Optional structured recovery metadata for agents.\n   *\n   * Only include for deterministic recovery paths. Human output prints the\n   * first hint as a follow-up line; JSON output serializes the full structure.\n   */\n  recovery?: RecoveryHints;\n}\n\n/** Write a structured error to stderr. */\nexport function outputError(error: StructuredError): void {\n  if (currentMode === 'json') {\n    console.error(JSON.stringify({ error }));\n  } else {\n    console.error(chalk.red(error.message));\n    const firstHint = error.recovery?.hints[0];\n    if (firstHint) {\n      const suffix = firstHint.command ? ` Run: ${firstHint.command}` : '';\n      console.error(chalk.dim(`→ ${firstHint.description}${suffix}`));\n    }\n  }\n}\n\n/** Write tabular data — chalk table in human mode, JSON array in json mode. */\nexport function outputTable(columns: TableColumn[], rows: string[][], rawData?: unknown[]): void {\n  if (currentMode === 'json') {\n    if (rawData) {\n      console.log(JSON.stringify(rawData));\n    } else {\n      const headers = columns.map((c) => c.header);\n      const jsonRows = rows.map((row) => {\n        const obj: Record<string, string> = {};\n        headers.forEach((h, i) => {\n          obj[h] = row[i] ?? '';\n        });\n        return obj;\n      });\n      console.log(JSON.stringify(jsonRows));\n    }\n  } else {\n    console.log(formatTable(columns, rows));\n  }\n}\n\nexport function exitWithError(\n  error: StructuredError & {\n    apiContext?: { status?: number; code?: string; resource?: string };\n  },\n): never {\n  outputError(error);\n  const { reason: codeReason, exit } = resolveErrorCode(error.code);\n  const reason = error.apiContext && codeReason === 'validation_error' ? 'api_error' : codeReason;\n  throw new CliExit(exit, {\n    reason,\n    errorCode: error.code,\n    apiContext: error.apiContext,\n  });\n}\n"]}

package/dist/utils/package-manager.js

@@ -1,7 +1,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { traceStep } from '../telemetry.js';
-import { getPackageDotJson, updatePackageDotJson } from './clack-utils.js';
+import { getPackageDotJson, updatePackageDotJson } from './ui-utils.js';
 import { analytics } from './analytics.js';
 export const BUN = {
     name: 'bun',

package/dist/utils/package-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"package-manager.js","sourceRoot":"","sources":["../../src/utils/package-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\nimport { traceStep } from '../telemetry.js';\nimport { getPackageDotJson, updatePackageDotJson } from './clack-utils.js';\nimport { analytics } from './analytics.js';\nimport type { InstallerOptions } from './types.js';\n\nexport interface PackageManager {\n  name: string;\n  label: string;\n  installCommand: string;\n  buildCommand: string;\n  /* The command that the package manager uses to run a script from package.json */\n  runScriptCommand: string;\n  flags: string;\n  forceInstallFlag: string;\n  detect: ({ installDir }: Pick<InstallerOptions, 'installDir'>) => boolean;\n  addOverride: (\n    pkgName: string,\n    pkgVersion: string,\n    { installDir }: Pick<InstallerOptions, 'installDir'>,\n  ) => Promise<void>;\n}\n\nexport const BUN: PackageManager = {\n  name: 'bun',\n  label: 'Bun',\n  installCommand: 'bun add',\n  buildCommand: 'bun run build',\n  runScriptCommand: 'bun run',\n  flags: '',\n  forceInstallFlag: '--force',\n  detect: ({ installDir }: Pick<InstallerOptions, 'installDir'>) =>\n    ['bun.lockb', 'bun.lock'].some((lockFile) => fs.existsSync(path.join(installDir, lockFile))),\n  addOverride: async (pkgName, pkgVersion, { installDir }: Pick<InstallerOptions, 'installDir'>): Promise<void> => {\n    const packageDotJson = await getPackageDotJson({ installDir });\n    const overrides = packageDotJson.overrides || {};\n\n    await updatePackageDotJson(\n      {\n        ...packageDotJson,\n        overrides: {\n          ...overrides,\n          [pkgName]: pkgVersion,\n        },\n      },\n      { installDir: installDir },\n    );\n  },\n};\nexport const YARN_V1: PackageManager = {\n  name: 'yarn',\n  label: 'Yarn V1',\n  installCommand: 'yarn add',\n  buildCommand: 'yarn build',\n  runScriptCommand: 'yarn',\n  flags: '--ignore-workspace-root-check',\n  forceInstallFlag: '--force',\n  detect: ({ installDir }: Pick<InstallerOptions, 'installDir'>) => {\n    try {\n      return fs.readFileSync(path.join(installDir, 'yarn.lock'), 'utf-8').slice(0, 500).includes('yarn lockfile v1');\n    } catch {\n      return false;\n    }\n  },\n  addOverride: async (pkgName, pkgVersion, { installDir }: Pick<InstallerOptions, 'installDir'>): Promise<void> => {\n    const packageDotJson = await getPackageDotJson({ installDir });\n    const resolutions = packageDotJson.resolutions || {};\n\n    await updatePackageDotJson(\n      {\n        ...packageDotJson,\n        resolutions: {\n          ...resolutions,\n          [pkgName]: pkgVersion,\n        },\n      },\n      { installDir },\n    );\n  },\n};\n/** YARN V2/3/4 */\nexport const YARN_V2: PackageManager = {\n  name: 'yarn',\n  label: 'Yarn V2/3/4',\n  installCommand: 'yarn add',\n  buildCommand: 'yarn build',\n  runScriptCommand: 'yarn',\n  flags: '',\n  forceInstallFlag: '--force',\n  detect: ({ installDir }: Pick<InstallerOptions, 'installDir'>) => {\n    try {\n      return fs.readFileSync(path.join(installDir, 'yarn.lock'), 'utf-8').slice(0, 500).includes('__metadata');\n    } catch {\n      return false;\n    }\n  },\n  addOverride: async (pkgName, pkgVersion, { installDir }: Pick<InstallerOptions, 'installDir'>): Promise<void> => {\n    const packageDotJson = await getPackageDotJson({ installDir });\n    const resolutions = packageDotJson.resolutions || {};\n\n    await updatePackageDotJson(\n      {\n        ...packageDotJson,\n        resolutions: {\n          ...resolutions,\n          [pkgName]: pkgVersion,\n        },\n      },\n      { installDir },\n    );\n  },\n};\nexport const PNPM: PackageManager = {\n  name: 'pnpm',\n  label: 'pnpm',\n  installCommand: 'pnpm add',\n  buildCommand: 'pnpm build',\n  runScriptCommand: 'pnpm',\n  flags: '--ignore-workspace-root-check',\n  forceInstallFlag: '--force',\n  detect: ({ installDir }: Pick<InstallerOptions, 'installDir'>) =>\n    fs.existsSync(path.join(installDir, 'pnpm-lock.yaml')),\n  addOverride: async (pkgName, pkgVersion, { installDir }: Pick<InstallerOptions, 'installDir'>): Promise<void> => {\n    const packageDotJson = await getPackageDotJson({ installDir });\n    const pnpm = packageDotJson.pnpm || {};\n    const overrides = pnpm.overrides || {};\n\n    await updatePackageDotJson(\n      {\n        ...packageDotJson,\n        pnpm: {\n          ...pnpm,\n          overrides: {\n            ...overrides,\n            [pkgName]: pkgVersion,\n          },\n        },\n      },\n      { installDir },\n    );\n  },\n};\nexport const NPM: PackageManager = {\n  name: 'npm',\n  label: 'npm',\n  installCommand: 'npm add',\n  buildCommand: 'npm run build',\n  runScriptCommand: 'npm run',\n  flags: '',\n  forceInstallFlag: '--force',\n  detect: ({ installDir }: Pick<InstallerOptions, 'installDir'>) =>\n    fs.existsSync(path.join(installDir, 'package-lock.json')),\n  addOverride: async (pkgName, pkgVersion, { installDir }: Pick<InstallerOptions, 'installDir'>): Promise<void> => {\n    const packageDotJson = await getPackageDotJson({ installDir });\n    const overrides = packageDotJson.overrides || {};\n\n    await updatePackageDotJson(\n      {\n        ...packageDotJson,\n        overrides: {\n          ...overrides,\n          [pkgName]: pkgVersion,\n        },\n      },\n      { installDir },\n    );\n  },\n};\n\nexport const EXPO: PackageManager = {\n  name: 'expo',\n  label: 'Expo',\n  installCommand: 'npx expo install',\n  buildCommand: 'npx expo build',\n  runScriptCommand: 'npx expo run',\n  flags: '',\n  forceInstallFlag: '--force',\n  detect: () => false,\n  addOverride: async (pkgName, pkgVersion, { installDir }: Pick<InstallerOptions, 'installDir'>): Promise<void> => {\n    const packageDotJson = await getPackageDotJson({ installDir });\n    const overrides = packageDotJson.overrides || {};\n\n    await updatePackageDotJson(\n      {\n        ...packageDotJson,\n        overrides: {\n          ...overrides,\n          [pkgName]: pkgVersion,\n        },\n      },\n      { installDir },\n    );\n  },\n};\n\nexport const packageManagers = [BUN, YARN_V1, YARN_V2, PNPM, NPM, EXPO];\n\nexport function detectAllPackageManagers({ installDir }: Pick<InstallerOptions, 'installDir'>): PackageManager[] {\n  return traceStep('detect-package-manager', () => {\n    const detectedManagers: PackageManager[] = [];\n    for (const packageManager of packageManagers) {\n      if (packageManager.detect({ installDir })) {\n        detectedManagers.push(packageManager);\n      }\n    }\n\n    if (detectedManagers.length === 0) {\n      analytics.setTag('package-manager', 'not-detected');\n    }\n    return detectedManagers;\n  });\n}\n"]}
+{"version":3,"file":"package-manager.js","sourceRoot":"","sources":["../../src/utils/package-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\nimport { traceStep } from '../telemetry.js';\nimport { getPackageDotJson, updatePackageDotJson } from './ui-utils.js';\nimport { analytics } from './analytics.js';\nimport type { InstallerOptions } from './types.js';\n\nexport interface PackageManager {\n  name: string;\n  label: string;\n  installCommand: string;\n  buildCommand: string;\n  /* The command that the package manager uses to run a script from package.json */\n  runScriptCommand: string;\n  flags: string;\n  forceInstallFlag: string;\n  detect: ({ installDir }: Pick<InstallerOptions, 'installDir'>) => boolean;\n  addOverride: (\n    pkgName: string,\n    pkgVersion: string,\n    { installDir }: Pick<InstallerOptions, 'installDir'>,\n  ) => Promise<void>;\n}\n\nexport const BUN: PackageManager = {\n  name: 'bun',\n  label: 'Bun',\n  installCommand: 'bun add',\n  buildCommand: 'bun run build',\n  runScriptCommand: 'bun run',\n  flags: '',\n  forceInstallFlag: '--force',\n  detect: ({ installDir }: Pick<InstallerOptions, 'installDir'>) =>\n    ['bun.lockb', 'bun.lock'].some((lockFile) => fs.existsSync(path.join(installDir, lockFile))),\n  addOverride: async (pkgName, pkgVersion, { installDir }: Pick<InstallerOptions, 'installDir'>): Promise<void> => {\n    const packageDotJson = await getPackageDotJson({ installDir });\n    const overrides = packageDotJson.overrides || {};\n\n    await updatePackageDotJson(\n      {\n        ...packageDotJson,\n        overrides: {\n          ...overrides,\n          [pkgName]: pkgVersion,\n        },\n      },\n      { installDir: installDir },\n    );\n  },\n};\nexport const YARN_V1: PackageManager = {\n  name: 'yarn',\n  label: 'Yarn V1',\n  installCommand: 'yarn add',\n  buildCommand: 'yarn build',\n  runScriptCommand: 'yarn',\n  flags: '--ignore-workspace-root-check',\n  forceInstallFlag: '--force',\n  detect: ({ installDir }: Pick<InstallerOptions, 'installDir'>) => {\n    try {\n      return fs.readFileSync(path.join(installDir, 'yarn.lock'), 'utf-8').slice(0, 500).includes('yarn lockfile v1');\n    } catch {\n      return false;\n    }\n  },\n  addOverride: async (pkgName, pkgVersion, { installDir }: Pick<InstallerOptions, 'installDir'>): Promise<void> => {\n    const packageDotJson = await getPackageDotJson({ installDir });\n    const resolutions = packageDotJson.resolutions || {};\n\n    await updatePackageDotJson(\n      {\n        ...packageDotJson,\n        resolutions: {\n          ...resolutions,\n          [pkgName]: pkgVersion,\n        },\n      },\n      { installDir },\n    );\n  },\n};\n/** YARN V2/3/4 */\nexport const YARN_V2: PackageManager = {\n  name: 'yarn',\n  label: 'Yarn V2/3/4',\n  installCommand: 'yarn add',\n  buildCommand: 'yarn build',\n  runScriptCommand: 'yarn',\n  flags: '',\n  forceInstallFlag: '--force',\n  detect: ({ installDir }: Pick<InstallerOptions, 'installDir'>) => {\n    try {\n      return fs.readFileSync(path.join(installDir, 'yarn.lock'), 'utf-8').slice(0, 500).includes('__metadata');\n    } catch {\n      return false;\n    }\n  },\n  addOverride: async (pkgName, pkgVersion, { installDir }: Pick<InstallerOptions, 'installDir'>): Promise<void> => {\n    const packageDotJson = await getPackageDotJson({ installDir });\n    const resolutions = packageDotJson.resolutions || {};\n\n    await updatePackageDotJson(\n      {\n        ...packageDotJson,\n        resolutions: {\n          ...resolutions,\n          [pkgName]: pkgVersion,\n        },\n      },\n      { installDir },\n    );\n  },\n};\nexport const PNPM: PackageManager = {\n  name: 'pnpm',\n  label: 'pnpm',\n  installCommand: 'pnpm add',\n  buildCommand: 'pnpm build',\n  runScriptCommand: 'pnpm',\n  flags: '--ignore-workspace-root-check',\n  forceInstallFlag: '--force',\n  detect: ({ installDir }: Pick<InstallerOptions, 'installDir'>) =>\n    fs.existsSync(path.join(installDir, 'pnpm-lock.yaml')),\n  addOverride: async (pkgName, pkgVersion, { installDir }: Pick<InstallerOptions, 'installDir'>): Promise<void> => {\n    const packageDotJson = await getPackageDotJson({ installDir });\n    const pnpm = packageDotJson.pnpm || {};\n    const overrides = pnpm.overrides || {};\n\n    await updatePackageDotJson(\n      {\n        ...packageDotJson,\n        pnpm: {\n          ...pnpm,\n          overrides: {\n            ...overrides,\n            [pkgName]: pkgVersion,\n          },\n        },\n      },\n      { installDir },\n    );\n  },\n};\nexport const NPM: PackageManager = {\n  name: 'npm',\n  label: 'npm',\n  installCommand: 'npm add',\n  buildCommand: 'npm run build',\n  runScriptCommand: 'npm run',\n  flags: '',\n  forceInstallFlag: '--force',\n  detect: ({ installDir }: Pick<InstallerOptions, 'installDir'>) =>\n    fs.existsSync(path.join(installDir, 'package-lock.json')),\n  addOverride: async (pkgName, pkgVersion, { installDir }: Pick<InstallerOptions, 'installDir'>): Promise<void> => {\n    const packageDotJson = await getPackageDotJson({ installDir });\n    const overrides = packageDotJson.overrides || {};\n\n    await updatePackageDotJson(\n      {\n        ...packageDotJson,\n        overrides: {\n          ...overrides,\n          [pkgName]: pkgVersion,\n        },\n      },\n      { installDir },\n    );\n  },\n};\n\nexport const EXPO: PackageManager = {\n  name: 'expo',\n  label: 'Expo',\n  installCommand: 'npx expo install',\n  buildCommand: 'npx expo build',\n  runScriptCommand: 'npx expo run',\n  flags: '',\n  forceInstallFlag: '--force',\n  detect: () => false,\n  addOverride: async (pkgName, pkgVersion, { installDir }: Pick<InstallerOptions, 'installDir'>): Promise<void> => {\n    const packageDotJson = await getPackageDotJson({ installDir });\n    const overrides = packageDotJson.overrides || {};\n\n    await updatePackageDotJson(\n      {\n        ...packageDotJson,\n        overrides: {\n          ...overrides,\n          [pkgName]: pkgVersion,\n        },\n      },\n      { installDir },\n    );\n  },\n};\n\nexport const packageManagers = [BUN, YARN_V1, YARN_V2, PNPM, NPM, EXPO];\n\nexport function detectAllPackageManagers({ installDir }: Pick<InstallerOptions, 'installDir'>): PackageManager[] {\n  return traceStep('detect-package-manager', () => {\n    const detectedManagers: PackageManager[] = [];\n    for (const packageManager of packageManagers) {\n      if (packageManager.detect({ installDir })) {\n        detectedManagers.push(packageManager);\n      }\n    }\n\n    if (detectedManagers.length === 0) {\n      analytics.setTag('package-manager', 'not-detected');\n    }\n    return detectedManagers;\n  });\n}\n"]}

package/dist/utils/recovery-hints.d.ts

@@ -33,5 +33,10 @@ export declare function authLoginRecovery(options: {
 }): RecoveryHints;
 /** Build a `confirmation_required` recovery hint, attaching a command only when the exact rerun is known. */
 export declare function confirmationRecovery(command?: string): RecoveryHints;
+/** Build a recovery hint for a transient network / connection failure. */
+export declare function networkRetryRecovery(options?: {
+    command?: string;
+    docsUrl?: string;
+}): RecoveryHints;
 /** Build a `missing_args` recovery hint, attaching a command only when it is directly runnable. */
 export declare function missingArgsRecovery(command: string | undefined, description: string): RecoveryHints;

package/dist/utils/recovery-hints.js

@@ -66,6 +66,18 @@ export function confirmationRecovery(command) {
         ],
     };
 }
+/** Build a recovery hint for a transient network / connection failure. */
+export function networkRetryRecovery(options = {}) {
+    return {
+        hints: [
+            {
+                description: 'Check your network connection and try again.',
+                ...(options.command && { command: options.command }),
+                ...(options.docsUrl && { docsUrl: options.docsUrl }),
+            },
+        ],
+    };
+}
 /** Build a `missing_args` recovery hint, attaching a command only when it is directly runnable. */
 export function missingArgsRecovery(command, description) {
     return {

package/dist/utils/recovery-hints.js.map

@@ -1 +1 @@
-{"version":3,"file":"recovery-hints.js","sourceRoot":"","sources":["../../src/utils/recovery-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAmB9D,kEAAkE;AAClE,MAAM,UAAU,iBAAiB,CAAC,OAA2D;IAC3F,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,YAAY,GAAG,mBAAmB,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAE5D,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO;YACL,KAAK,EAAE;gBACL;oBACE,WAAW,EAAE,2CAA2C;iBACzD;gBACD;oBACE,WAAW,EAAE,kDAAkD;oBAC/D,OAAO,EAAE,YAAY;oBACrB,iBAAiB,EAAE,IAAI;iBACxB;aACF;SACF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO;YACL,KAAK,EAAE;gBACL;oBACE,WAAW,EAAE,wCAAwC;oBACrD,OAAO,EAAE,YAAY;oBACrB,iBAAiB,EAAE,IAAI;iBACxB;gBACD;oBACE,WAAW,EAAE,gDAAgD;iBAC9D;aACF;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE;YACL;gBACE,WAAW,EAAE,8CAA8C;gBAC3D,OAAO,EAAE,YAAY;aACtB;YACD;gBACE,WAAW,EAAE,wBAAwB;aACtC;SACF;KACF,CAAC;AACJ,CAAC;AAED,6GAA6G;AAC7G,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;QACL,KAAK,EAAE;YACL;gBACE,WAAW,EAAE,oCAAoC;gBACjD,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;aAC5B;SACF;KACF,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,mBAAmB,CAAC,OAA2B,EAAE,WAAmB;IAClF,OAAO;QACL,KAAK,EAAE;YACL;gBACE,WAAW;gBACX,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;aAC5B;SACF;KACF,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Recovery hints for structured CLI errors.\n *\n * Recovery metadata is consumed by coding agents through JSON stderr output.\n * Hints describe the deterministic next step the caller can take to fix the\n * failure: the exact command to run, whether host shell access is required,\n * and (optionally) related docs links.\n *\n * Keep hints conservative: only include `command` when the next action is\n * unambiguous and safe. When the correct next step depends on user intent,\n * provide `description` only.\n */\n\nimport type { InteractionMode } from './interaction-mode.js';\nimport { formatWorkOSCommand } from './command-invocation.js';\n\nexport interface RecoveryHint {\n  /** Human-readable next step for both humans and agents. */\n  description: string;\n  /** Exact command to run, when deterministic. */\n  command?: string;\n  /** True when the command must run on the user's host shell, not in the current sandbox. */\n  hostShellRequired?: boolean;\n  /** Optional documentation URL. */\n  docsUrl?: string;\n  /** Optional markdown-capable documentation URL. Only set when route support is verified. */\n  docsMarkdownUrl?: string;\n}\n\nexport interface RecoveryHints {\n  hints: RecoveryHint[];\n}\n\n/** Build mode-aware recovery hints for `auth_required` errors. */\nexport function authLoginRecovery(options: { mode: InteractionMode; env?: NodeJS.ProcessEnv }): RecoveryHints {\n  const env = options.env ?? process.env;\n  const loginCommand = formatWorkOSCommand('auth login', env);\n\n  if (options.mode === 'ci') {\n    return {\n      hints: [\n        {\n          description: 'Set WORKOS_API_KEY in the CI environment.',\n        },\n        {\n          description: 'Or refresh stored credentials before the CI run.',\n          command: loginCommand,\n          hostShellRequired: true,\n        },\n      ],\n    };\n  }\n\n  if (options.mode === 'agent') {\n    return {\n      hints: [\n        {\n          description: \"Authenticate on the user's host shell.\",\n          command: loginCommand,\n          hostShellRequired: true,\n        },\n        {\n          description: 'Or set WORKOS_API_KEY before invoking the CLI.',\n        },\n      ],\n    };\n  }\n\n  return {\n    hints: [\n      {\n        description: 'Authenticate via browser-based device login.',\n        command: loginCommand,\n      },\n      {\n        description: 'Or set WORKOS_API_KEY.',\n      },\n    ],\n  };\n}\n\n/** Build a `confirmation_required` recovery hint, attaching a command only when the exact rerun is known. */\nexport function confirmationRecovery(command?: string): RecoveryHints {\n  return {\n    hints: [\n      {\n        description: 'Re-run with explicit confirmation.',\n        ...(command && { command }),\n      },\n    ],\n  };\n}\n\n/** Build a `missing_args` recovery hint, attaching a command only when it is directly runnable. */\nexport function missingArgsRecovery(command: string | undefined, description: string): RecoveryHints {\n  return {\n    hints: [\n      {\n        description,\n        ...(command && { command }),\n      },\n    ],\n  };\n}\n"]}
+{"version":3,"file":"recovery-hints.js","sourceRoot":"","sources":["../../src/utils/recovery-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAmB9D,kEAAkE;AAClE,MAAM,UAAU,iBAAiB,CAAC,OAA2D;IAC3F,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,YAAY,GAAG,mBAAmB,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAE5D,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO;YACL,KAAK,EAAE;gBACL;oBACE,WAAW,EAAE,2CAA2C;iBACzD;gBACD;oBACE,WAAW,EAAE,kDAAkD;oBAC/D,OAAO,EAAE,YAAY;oBACrB,iBAAiB,EAAE,IAAI;iBACxB;aACF;SACF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO;YACL,KAAK,EAAE;gBACL;oBACE,WAAW,EAAE,wCAAwC;oBACrD,OAAO,EAAE,YAAY;oBACrB,iBAAiB,EAAE,IAAI;iBACxB;gBACD;oBACE,WAAW,EAAE,gDAAgD;iBAC9D;aACF;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE;YACL;gBACE,WAAW,EAAE,8CAA8C;gBAC3D,OAAO,EAAE,YAAY;aACtB;YACD;gBACE,WAAW,EAAE,wBAAwB;aACtC;SACF;KACF,CAAC;AACJ,CAAC;AAED,6GAA6G;AAC7G,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;QACL,KAAK,EAAE;YACL;gBACE,WAAW,EAAE,oCAAoC;gBACjD,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;aAC5B;SACF;KACF,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,oBAAoB,CAAC,UAAkD,EAAE;IACvF,OAAO;QACL,KAAK,EAAE;YACL;gBACE,WAAW,EAAE,8CAA8C;gBAC3D,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpD,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;aACrD;SACF;KACF,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,mBAAmB,CAAC,OAA2B,EAAE,WAAmB;IAClF,OAAO;QACL,KAAK,EAAE;YACL;gBACE,WAAW;gBACX,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;aAC5B;SACF;KACF,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Recovery hints for structured CLI errors.\n *\n * Recovery metadata is consumed by coding agents through JSON stderr output.\n * Hints describe the deterministic next step the caller can take to fix the\n * failure: the exact command to run, whether host shell access is required,\n * and (optionally) related docs links.\n *\n * Keep hints conservative: only include `command` when the next action is\n * unambiguous and safe. When the correct next step depends on user intent,\n * provide `description` only.\n */\n\nimport type { InteractionMode } from './interaction-mode.js';\nimport { formatWorkOSCommand } from './command-invocation.js';\n\nexport interface RecoveryHint {\n  /** Human-readable next step for both humans and agents. */\n  description: string;\n  /** Exact command to run, when deterministic. */\n  command?: string;\n  /** True when the command must run on the user's host shell, not in the current sandbox. */\n  hostShellRequired?: boolean;\n  /** Optional documentation URL. */\n  docsUrl?: string;\n  /** Optional markdown-capable documentation URL. Only set when route support is verified. */\n  docsMarkdownUrl?: string;\n}\n\nexport interface RecoveryHints {\n  hints: RecoveryHint[];\n}\n\n/** Build mode-aware recovery hints for `auth_required` errors. */\nexport function authLoginRecovery(options: { mode: InteractionMode; env?: NodeJS.ProcessEnv }): RecoveryHints {\n  const env = options.env ?? process.env;\n  const loginCommand = formatWorkOSCommand('auth login', env);\n\n  if (options.mode === 'ci') {\n    return {\n      hints: [\n        {\n          description: 'Set WORKOS_API_KEY in the CI environment.',\n        },\n        {\n          description: 'Or refresh stored credentials before the CI run.',\n          command: loginCommand,\n          hostShellRequired: true,\n        },\n      ],\n    };\n  }\n\n  if (options.mode === 'agent') {\n    return {\n      hints: [\n        {\n          description: \"Authenticate on the user's host shell.\",\n          command: loginCommand,\n          hostShellRequired: true,\n        },\n        {\n          description: 'Or set WORKOS_API_KEY before invoking the CLI.',\n        },\n      ],\n    };\n  }\n\n  return {\n    hints: [\n      {\n        description: 'Authenticate via browser-based device login.',\n        command: loginCommand,\n      },\n      {\n        description: 'Or set WORKOS_API_KEY.',\n      },\n    ],\n  };\n}\n\n/** Build a `confirmation_required` recovery hint, attaching a command only when the exact rerun is known. */\nexport function confirmationRecovery(command?: string): RecoveryHints {\n  return {\n    hints: [\n      {\n        description: 'Re-run with explicit confirmation.',\n        ...(command && { command }),\n      },\n    ],\n  };\n}\n\n/** Build a recovery hint for a transient network / connection failure. */\nexport function networkRetryRecovery(options: { command?: string; docsUrl?: string } = {}): RecoveryHints {\n  return {\n    hints: [\n      {\n        description: 'Check your network connection and try again.',\n        ...(options.command && { command: options.command }),\n        ...(options.docsUrl && { docsUrl: options.docsUrl }),\n      },\n    ],\n  };\n}\n\n/** Build a `missing_args` recovery hint, attaching a command only when it is directly runnable. */\nexport function missingArgsRecovery(command: string | undefined, description: string): RecoveryHints {\n  return {\n    hints: [\n      {\n        description,\n        ...(command && { command }),\n      },\n    ],\n  };\n}\n"]}

package/dist/utils/summary-box.d.ts

@@ -1,6 +1,7 @@
 import { type LockExpression } from './lock-art.js';
+import type { CompletionData } from '../lib/events.js';
 /** Pre-built completion summaries shared by CLI and Dashboard adapters. */
-export declare function renderCompletionSummary(success: boolean, summary?: string): string;
+export declare function renderCompletionSummary(success: boolean, summary?: string, completion?: CompletionData): string;
 export interface SummaryBoxItem {
     type: 'done' | 'pending' | 'error';
     text: string;
@@ -11,6 +12,12 @@ export interface SummaryBoxOptions {
     items?: SummaryBoxItem[];
     footer?: string;
 }
+/**
+ * The install opener: the WorkOS lock (in brand indigo) beside the wordmark.
+ * A compact, de-boxed replacement for the full block-letter banner — the same
+ * lock that closes the install, so the two ends bookend each other.
+ */
+export declare function renderBrandMark(subtitle?: string): string;
 /**
  * Render a branded summary box with the WorkOS lock character,
  * a title, optional checklist items, and an optional footer.

package/dist/utils/summary-box.js

@@ -1,11 +1,28 @@
 import chalk from 'chalk';
 import { isUnicodeSupported } from './vendor/is-unicorn-supported.js';
 import { getLockArt, LOCK_WIDTH } from './lock-art.js';
-import { symbols } from './cli-symbols.js';
+import { symbols, palette } from './cli-symbols.js';
+/** Max number of changed files listed in the success box before collapsing. */
+const MAX_SUMMARY_FILES = 5;
 /** Pre-built completion summaries shared by CLI and Dashboard adapters. */
-export function renderCompletionSummary(success, summary) {
+export function renderCompletionSummary(success, summary, completion) {
     if (success) {
-        return renderSummaryBox({
+        if (completion) {
+            const files = completion.files;
+            const shown = files.slice(0, MAX_SUMMARY_FILES).map((f) => ({ type: 'done', text: f }));
+            if (files.length > MAX_SUMMARY_FILES) {
+                shown.push({ type: 'done', text: `…and ${files.length - MAX_SUMMARY_FILES} more` });
+            }
+            const steps = completion.nextSteps.map((s) => ({ type: 'pending', text: s }));
+            return renderFlatSummary({
+                expression: 'success',
+                title: 'WorkOS AuthKit Installed',
+                items: [...shown, ...steps],
+                footer: completion.docsUrl,
+            });
+        }
+        // Fallback: preserve the original static next-steps when no structured data is present.
+        return renderFlatSummary({
             expression: 'success',
             title: 'WorkOS AuthKit Installed',
             items: [
@@ -15,7 +32,7 @@ export function renderCompletionSummary(success, summary) {
             footer: 'https://workos.com/docs/authkit',
         });
     }
-    return renderSummaryBox({
+    return renderFlatSummary({
         expression: 'error',
         title: 'Installation Failed',
         items: summary ? [{ type: 'error', text: summary }] : [],
@@ -31,6 +48,52 @@ const ITEM_ICONS = {
     pending: chalk.cyan(symbols.arrow),
     error: chalk.red(symbols.error),
 };
+// ── Flat (de-boxed) rendering — the install opener + closer ───────────────────
+const { accent, cyan: flatCyan } = palette;
+/** Flat glyphs matching the ui facade (green ✓ / accent › / red ✗). */
+const FLAT_ICONS = {
+    done: chalk.green('✓'),
+    pending: accent('›'),
+    error: chalk.red('✗'),
+};
+/**
+ * The install opener: the WorkOS lock (in brand indigo) beside the wordmark.
+ * A compact, de-boxed replacement for the full block-letter banner — the same
+ * lock that closes the install, so the two ends bookend each other.
+ */
+export function renderBrandMark(subtitle) {
+    const lock = getLockArt('success', false); // raw lines; recolor to brand indigo
+    const titleLine = 2; // "WorkOS" sits beside the top of the lock body
+    const subtitleLine = 3;
+    return lock
+        .map((l, i) => {
+        const left = `  ${accent(l)}`;
+        if (i === titleLine)
+            return `${left}   ${accent.bold('WorkOS')}`;
+        if (i === subtitleLine && subtitle)
+            return `${left}   ${chalk.dim(subtitle)}`;
+        return left;
+    })
+        .join('\n');
+}
+/**
+ * The install closer: the WorkOS lock (colored by outcome) above a flat title,
+ * checklist, and footer — no border. Shared by the CLI and Dashboard adapters.
+ * The lock is the same mark that opens the install (see renderBrandMark).
+ */
+function renderFlatSummary(options) {
+    const { expression, title, items = [], footer } = options;
+    const out = getLockArt(expression, true).map((l) => `  ${l}`);
+    out.push('', `  ${chalk.bold(title)}`);
+    for (const item of items) {
+        // File paths (done) read better in cyan; next-step prose stays default weight.
+        const text = item.type === 'done' ? flatCyan(item.text) : item.text;
+        out.push(`  ${FLAT_ICONS[item.type]} ${text}`);
+    }
+    if (footer)
+        out.push('', `  ${chalk.dim(footer)}`);
+    return out.join('\n');
+}
 const MIN_WIDTH = 42;
 // Item prefix "  X " = 4 visible chars before text
 const ITEM_PREFIX_LEN = 4;

package/dist/utils/summary-box.js.map

@@ -1 +1 @@
-{"version":3,"file":"summary-box.js","sourceRoot":"","sources":["../../src/utils/summary-box.ts"],"names":[],"mappings":"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","sourcesContent":["import chalk from 'chalk';\nimport { isUnicodeSupported } from './vendor/is-unicorn-supported.js';\nimport { type LockExpression, getLockArt, LOCK_WIDTH } from './lock-art.js';\nimport { symbols } from './cli-symbols.js';\n\n/** Pre-built completion summaries shared by CLI and Dashboard adapters. */\nexport function renderCompletionSummary(success: boolean, summary?: string): string {\n  if (success) {\n    return renderSummaryBox({\n      expression: 'success',\n      title: 'WorkOS AuthKit Installed',\n      items: [\n        { type: 'pending', text: 'Start dev server to test authentication' },\n        { type: 'pending', text: 'Visit WorkOS Dashboard to manage users' },\n      ],\n      footer: 'https://workos.com/docs/authkit',\n    });\n  }\n  return renderSummaryBox({\n    expression: 'error',\n    title: 'Installation Failed',\n    items: summary ? [{ type: 'error', text: summary }] : [],\n    footer: 'https://github.com/workos/cli/issues',\n  });\n}\n\nexport interface SummaryBoxItem {\n  type: 'done' | 'pending' | 'error';\n  text: string;\n}\n\nexport interface SummaryBoxOptions {\n  expression: LockExpression;\n  title: string;\n  items?: SummaryBoxItem[];\n  footer?: string;\n}\n\nconst unicode = isUnicodeSupported();\n\nconst BOX = unicode\n  ? { tl: '┌', tr: '┐', bl: '└', br: '┘', h: '─', v: '│', ml: '├', mr: '┤' }\n  : { tl: '+', tr: '+', bl: '+', br: '+', h: '-', v: '|', ml: '+', mr: '+' };\n\nconst ITEM_ICONS: Record<SummaryBoxItem['type'], string> = {\n  done: chalk.green(symbols.success),\n  pending: chalk.cyan(symbols.arrow),\n  error: chalk.red(symbols.error),\n};\n\nconst MIN_WIDTH = 42;\n// Item prefix \"  X \" = 4 visible chars before text\nconst ITEM_PREFIX_LEN = 4;\n// Footer prefix \"  \" = 2 visible chars before text\nconst FOOTER_PREFIX_LEN = 2;\n\nfunction hLine(left: string, right: string, width: number): string {\n  return `${left}${BOX.h.repeat(width - 2)}${right}`;\n}\n\nfunction padRight(text: string, visibleLen: number, targetLen: number): string {\n  const padding = Math.max(0, targetLen - visibleLen);\n  return text + ' '.repeat(padding);\n}\n\n/** Word-wrap text to fit within maxLen, returning multiple lines. */\nfunction wrapText(text: string, maxLen: number): string[] {\n  if (text.length <= maxLen) return [text];\n  const words = text.split(' ');\n  const wrapped: string[] = [];\n  let current = '';\n  for (const word of words) {\n    const candidate = current ? `${current} ${word}` : word;\n    if (candidate.length > maxLen && current) {\n      wrapped.push(current);\n      current = word;\n    } else {\n      current = candidate;\n    }\n  }\n  if (current) wrapped.push(current);\n  return wrapped;\n}\n\nfunction getTerminalWidth(): number {\n  return process.stdout.columns || 80;\n}\n\n/**\n * Render a branded summary box with the WorkOS lock character,\n * a title, optional checklist items, and an optional footer.\n */\nexport function renderSummaryBox(options: SummaryBoxOptions): string {\n  const { expression, title, items = [], footer } = options;\n\n  const lockColored = getLockArt(expression, true);\n  const lockRaw = getLockArt(expression, false);\n  const lockLines = lockColored.length;\n\n  // \" \" + lock + \"  \" = lock column width\n  const lockColWidth = LOCK_WIDTH + 3;\n\n  // Cap box width to terminal width\n  const termWidth = getTerminalWidth();\n  // innerWidth must fit: lock+title, items, footer — but capped to terminal\n  const maxInner = Math.max(MIN_WIDTH - 2, termWidth - 2);\n\n  // Compute ideal inner width from content\n  const titleRowWidth = lockColWidth + title.length;\n  const itemWidths = items.map((item) => ITEM_PREFIX_LEN + item.text.length);\n  const footerWidth = footer ? FOOTER_PREFIX_LEN + footer.length : 0;\n  const idealInner = Math.max(titleRowWidth, ...itemWidths, footerWidth) + 1;\n\n  const innerWidth = Math.min(Math.max(MIN_WIDTH - 2, idealInner), maxInner);\n  const boxWidth = innerWidth + 2;\n\n  // Available text width for items and footer (after prefix, before right padding + border)\n  const itemTextMax = innerWidth - ITEM_PREFIX_LEN - 1;\n  const footerTextMax = innerWidth - FOOTER_PREFIX_LEN - 1;\n\n  const lines: string[] = [];\n\n  // Top border\n  lines.push(hLine(BOX.tl, BOX.tr, boxWidth));\n\n  // Lock + title rows\n  const titleLineIndex = 3;\n  for (let i = 0; i < lockLines; i++) {\n    const lockPart = ` ${lockColored[i]}  `;\n    const lockPartRaw = ` ${lockRaw[i]}  `;\n    let rightPart: string;\n    let rightPartLen: number;\n    if (i === titleLineIndex) {\n      rightPart = chalk.bold(title);\n      rightPartLen = title.length;\n    } else {\n      rightPart = '';\n      rightPartLen = 0;\n    }\n    const row = BOX.v + padRight(lockPart + rightPart, lockPartRaw.length + rightPartLen, innerWidth) + BOX.v;\n    lines.push(row);\n  }\n\n  // Items\n  if (items.length > 0) {\n    lines.push(`${BOX.v}${' '.repeat(innerWidth)}${BOX.v}`);\n\n    for (const item of items) {\n      const icon = ITEM_ICONS[item.type];\n      const wrappedLines = wrapText(item.text, itemTextMax);\n      // First line gets the icon\n      const first = `  ${icon} ${wrappedLines[0]}`;\n      const firstLen = ITEM_PREFIX_LEN + wrappedLines[0].length;\n      lines.push(`${BOX.v}${padRight(first, firstLen, innerWidth)}${BOX.v}`);\n      // Continuation lines are indented to align with text after icon\n      for (let j = 1; j < wrappedLines.length; j++) {\n        const cont = `    ${wrappedLines[j]}`;\n        const contLen = 4 + wrappedLines[j].length;\n        lines.push(`${BOX.v}${padRight(cont, contLen, innerWidth)}${BOX.v}`);\n      }\n    }\n  }\n\n  // Footer\n  if (footer) {\n    lines.push(hLine(BOX.ml, BOX.mr, boxWidth));\n    const wrappedFooter = wrapText(footer, footerTextMax);\n    for (const fLine of wrappedFooter) {\n      const content = `  ${chalk.dim(fLine)}`;\n      const visibleLen = FOOTER_PREFIX_LEN + fLine.length;\n      lines.push(`${BOX.v}${padRight(content, visibleLen, innerWidth)}${BOX.v}`);\n    }\n  }\n\n  // Bottom border\n  lines.push(hLine(BOX.bl, BOX.br, boxWidth));\n\n  return lines.join('\\n');\n}\n"]}
+{"version":3,"file":"summary-box.js","sourceRoot":"","sources":["../../src/utils/summary-box.ts"],"names":[],"mappings":"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","sourcesContent":["import chalk from 'chalk';\nimport { isUnicodeSupported } from './vendor/is-unicorn-supported.js';\nimport { type LockExpression, getLockArt, LOCK_WIDTH } from './lock-art.js';\nimport { symbols, palette } from './cli-symbols.js';\nimport type { CompletionData } from '../lib/events.js';\n\n/** Max number of changed files listed in the success box before collapsing. */\nconst MAX_SUMMARY_FILES = 5;\n\n/** Pre-built completion summaries shared by CLI and Dashboard adapters. */\nexport function renderCompletionSummary(success: boolean, summary?: string, completion?: CompletionData): string {\n  if (success) {\n    if (completion) {\n      const files = completion.files;\n      const shown: SummaryBoxItem[] = files.slice(0, MAX_SUMMARY_FILES).map((f) => ({ type: 'done', text: f }));\n      if (files.length > MAX_SUMMARY_FILES) {\n        shown.push({ type: 'done', text: `…and ${files.length - MAX_SUMMARY_FILES} more` });\n      }\n      const steps: SummaryBoxItem[] = completion.nextSteps.map((s) => ({ type: 'pending', text: s }));\n      return renderFlatSummary({\n        expression: 'success',\n        title: 'WorkOS AuthKit Installed',\n        items: [...shown, ...steps],\n        footer: completion.docsUrl,\n      });\n    }\n    // Fallback: preserve the original static next-steps when no structured data is present.\n    return renderFlatSummary({\n      expression: 'success',\n      title: 'WorkOS AuthKit Installed',\n      items: [\n        { type: 'pending', text: 'Start dev server to test authentication' },\n        { type: 'pending', text: 'Visit WorkOS Dashboard to manage users' },\n      ],\n      footer: 'https://workos.com/docs/authkit',\n    });\n  }\n  return renderFlatSummary({\n    expression: 'error',\n    title: 'Installation Failed',\n    items: summary ? [{ type: 'error', text: summary }] : [],\n    footer: 'https://github.com/workos/cli/issues',\n  });\n}\n\nexport interface SummaryBoxItem {\n  type: 'done' | 'pending' | 'error';\n  text: string;\n}\n\nexport interface SummaryBoxOptions {\n  expression: LockExpression;\n  title: string;\n  items?: SummaryBoxItem[];\n  footer?: string;\n}\n\nconst unicode = isUnicodeSupported();\n\nconst BOX = unicode\n  ? { tl: '┌', tr: '┐', bl: '└', br: '┘', h: '─', v: '│', ml: '├', mr: '┤' }\n  : { tl: '+', tr: '+', bl: '+', br: '+', h: '-', v: '|', ml: '+', mr: '+' };\n\nconst ITEM_ICONS: Record<SummaryBoxItem['type'], string> = {\n  done: chalk.green(symbols.success),\n  pending: chalk.cyan(symbols.arrow),\n  error: chalk.red(symbols.error),\n};\n\n// ── Flat (de-boxed) rendering — the install opener + closer ───────────────────\n\nconst { accent, cyan: flatCyan } = palette;\n\n/** Flat glyphs matching the ui facade (green ✓ / accent › / red ✗). */\nconst FLAT_ICONS: Record<SummaryBoxItem['type'], string> = {\n  done: chalk.green('✓'),\n  pending: accent('›'),\n  error: chalk.red('✗'),\n};\n\n/**\n * The install opener: the WorkOS lock (in brand indigo) beside the wordmark.\n * A compact, de-boxed replacement for the full block-letter banner — the same\n * lock that closes the install, so the two ends bookend each other.\n */\nexport function renderBrandMark(subtitle?: string): string {\n  const lock = getLockArt('success', false); // raw lines; recolor to brand indigo\n  const titleLine = 2; // \"WorkOS\" sits beside the top of the lock body\n  const subtitleLine = 3;\n  return lock\n    .map((l, i) => {\n      const left = `  ${accent(l)}`;\n      if (i === titleLine) return `${left}   ${accent.bold('WorkOS')}`;\n      if (i === subtitleLine && subtitle) return `${left}   ${chalk.dim(subtitle)}`;\n      return left;\n    })\n    .join('\\n');\n}\n\n/**\n * The install closer: the WorkOS lock (colored by outcome) above a flat title,\n * checklist, and footer — no border. Shared by the CLI and Dashboard adapters.\n * The lock is the same mark that opens the install (see renderBrandMark).\n */\nfunction renderFlatSummary(options: SummaryBoxOptions): string {\n  const { expression, title, items = [], footer } = options;\n  const out: string[] = getLockArt(expression, true).map((l) => `  ${l}`);\n  out.push('', `  ${chalk.bold(title)}`);\n  for (const item of items) {\n    // File paths (done) read better in cyan; next-step prose stays default weight.\n    const text = item.type === 'done' ? flatCyan(item.text) : item.text;\n    out.push(`  ${FLAT_ICONS[item.type]} ${text}`);\n  }\n  if (footer) out.push('', `  ${chalk.dim(footer)}`);\n  return out.join('\\n');\n}\n\nconst MIN_WIDTH = 42;\n// Item prefix \"  X \" = 4 visible chars before text\nconst ITEM_PREFIX_LEN = 4;\n// Footer prefix \"  \" = 2 visible chars before text\nconst FOOTER_PREFIX_LEN = 2;\n\nfunction hLine(left: string, right: string, width: number): string {\n  return `${left}${BOX.h.repeat(width - 2)}${right}`;\n}\n\nfunction padRight(text: string, visibleLen: number, targetLen: number): string {\n  const padding = Math.max(0, targetLen - visibleLen);\n  return text + ' '.repeat(padding);\n}\n\n/** Word-wrap text to fit within maxLen, returning multiple lines. */\nfunction wrapText(text: string, maxLen: number): string[] {\n  if (text.length <= maxLen) return [text];\n  const words = text.split(' ');\n  const wrapped: string[] = [];\n  let current = '';\n  for (const word of words) {\n    const candidate = current ? `${current} ${word}` : word;\n    if (candidate.length > maxLen && current) {\n      wrapped.push(current);\n      current = word;\n    } else {\n      current = candidate;\n    }\n  }\n  if (current) wrapped.push(current);\n  return wrapped;\n}\n\nfunction getTerminalWidth(): number {\n  return process.stdout.columns || 80;\n}\n\n/**\n * Render a branded summary box with the WorkOS lock character,\n * a title, optional checklist items, and an optional footer.\n */\nexport function renderSummaryBox(options: SummaryBoxOptions): string {\n  const { expression, title, items = [], footer } = options;\n\n  const lockColored = getLockArt(expression, true);\n  const lockRaw = getLockArt(expression, false);\n  const lockLines = lockColored.length;\n\n  // \" \" + lock + \"  \" = lock column width\n  const lockColWidth = LOCK_WIDTH + 3;\n\n  // Cap box width to terminal width\n  const termWidth = getTerminalWidth();\n  // innerWidth must fit: lock+title, items, footer — but capped to terminal\n  const maxInner = Math.max(MIN_WIDTH - 2, termWidth - 2);\n\n  // Compute ideal inner width from content\n  const titleRowWidth = lockColWidth + title.length;\n  const itemWidths = items.map((item) => ITEM_PREFIX_LEN + item.text.length);\n  const footerWidth = footer ? FOOTER_PREFIX_LEN + footer.length : 0;\n  const idealInner = Math.max(titleRowWidth, ...itemWidths, footerWidth) + 1;\n\n  const innerWidth = Math.min(Math.max(MIN_WIDTH - 2, idealInner), maxInner);\n  const boxWidth = innerWidth + 2;\n\n  // Available text width for items and footer (after prefix, before right padding + border)\n  const itemTextMax = innerWidth - ITEM_PREFIX_LEN - 1;\n  const footerTextMax = innerWidth - FOOTER_PREFIX_LEN - 1;\n\n  const lines: string[] = [];\n\n  // Top border\n  lines.push(hLine(BOX.tl, BOX.tr, boxWidth));\n\n  // Lock + title rows\n  const titleLineIndex = 3;\n  for (let i = 0; i < lockLines; i++) {\n    const lockPart = ` ${lockColored[i]}  `;\n    const lockPartRaw = ` ${lockRaw[i]}  `;\n    let rightPart: string;\n    let rightPartLen: number;\n    if (i === titleLineIndex) {\n      rightPart = chalk.bold(title);\n      rightPartLen = title.length;\n    } else {\n      rightPart = '';\n      rightPartLen = 0;\n    }\n    const row = BOX.v + padRight(lockPart + rightPart, lockPartRaw.length + rightPartLen, innerWidth) + BOX.v;\n    lines.push(row);\n  }\n\n  // Items\n  if (items.length > 0) {\n    lines.push(`${BOX.v}${' '.repeat(innerWidth)}${BOX.v}`);\n\n    for (const item of items) {\n      const icon = ITEM_ICONS[item.type];\n      const wrappedLines = wrapText(item.text, itemTextMax);\n      // First line gets the icon\n      const first = `  ${icon} ${wrappedLines[0]}`;\n      const firstLen = ITEM_PREFIX_LEN + wrappedLines[0].length;\n      lines.push(`${BOX.v}${padRight(first, firstLen, innerWidth)}${BOX.v}`);\n      // Continuation lines are indented to align with text after icon\n      for (let j = 1; j < wrappedLines.length; j++) {\n        const cont = `    ${wrappedLines[j]}`;\n        const contLen = 4 + wrappedLines[j].length;\n        lines.push(`${BOX.v}${padRight(cont, contLen, innerWidth)}${BOX.v}`);\n      }\n    }\n  }\n\n  // Footer\n  if (footer) {\n    lines.push(hLine(BOX.ml, BOX.mr, boxWidth));\n    const wrappedFooter = wrapText(footer, footerTextMax);\n    for (const fLine of wrappedFooter) {\n      const content = `  ${chalk.dim(fLine)}`;\n      const visibleLen = FOOTER_PREFIX_LEN + fLine.length;\n      lines.push(`${BOX.v}${padRight(content, visibleLen, innerWidth)}${BOX.v}`);\n    }\n  }\n\n  // Bottom border\n  lines.push(hLine(BOX.bl, BOX.br, boxWidth));\n\n  return lines.join('\\n');\n}\n"]}

package/dist/utils/telemetry-types.d.ts

@@ -81,7 +81,7 @@ export interface CommandEvent extends BaseTelemetryEvent {
         'api.resource'?: string;
         'cli.version': string;
         'workos.user_id'?: string;
-    } & EnvFingerprint;
+    } & EnvFingerprint & Record<string, string | number | boolean | undefined>;
 }
 export interface CrashEvent extends BaseTelemetryEvent {
     type: 'crash';

package/dist/utils/telemetry-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-types.js","sourceRoot":"","sources":["../../src/utils/telemetry-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * Telemetry event types for installer → gateway communication.\n * The gateway converts these to OTel format.\n */\n\nexport interface BaseTelemetryEvent {\n  type: 'session.start' | 'session.end' | 'step' | 'agent.tool' | 'agent.llm' | 'command' | 'crash';\n  sessionId: string;\n  timestamp: string;\n}\n\nexport type AuthMode = 'jwt' | 'claim_token' | 'api_key' | 'none';\n\n/**\n * Structured outcome dimension for command events. Supersedes the boolean\n * `command.success` as the primary categorization (`command.success` remains\n * for backward-compat). Populated by `analytics.emitCommandEvent()` from the\n * top-level command lifecycle.\n */\nexport type TerminationReason = 'success' | 'cancelled' | 'auth_required' | 'validation_error' | 'api_error' | 'crash';\n\nexport interface EnvFingerprint {\n  'device.id': string;\n  'auth.mode': AuthMode;\n  'env.os': string;\n  'env.os_version': string;\n  'env.node_version': string;\n  'env.shell': string;\n  'env.ci': boolean;\n  'env.ci_provider'?: string;\n}\n\nexport interface SessionStartEvent extends BaseTelemetryEvent {\n  type: 'session.start';\n  attributes: {\n    'installer.version': string;\n    'installer.mode': 'cli' | 'tui' | 'headless';\n    'workos.user_id'?: string;\n    'workos.org_id'?: string;\n  } & EnvFingerprint;\n}\n\nexport interface SessionEndEvent extends BaseTelemetryEvent {\n  type: 'session.end';\n  attributes: {\n    'installer.outcome': 'success' | 'error' | 'cancelled';\n    'installer.duration_ms': number;\n  } & Record<string, string | number | boolean>;\n}\n\nexport interface StepEvent extends BaseTelemetryEvent {\n  type: 'step';\n  name: string;\n  startTimestamp: string;\n  durationMs: number;\n  success: boolean;\n  error?: {\n    type: string;\n    message: string;\n  };\n}\n\nexport interface AgentToolEvent extends BaseTelemetryEvent {\n  type: 'agent.tool';\n  toolName: string;\n  startTimestamp: string;\n  durationMs: number;\n  success: boolean;\n}\n\nexport interface AgentLLMEvent extends BaseTelemetryEvent {\n  type: 'agent.llm';\n  model: string;\n  inputTokens: number;\n  outputTokens: number;\n}\n\nexport interface CommandEvent extends BaseTelemetryEvent {\n  type: 'command';\n  attributes: {\n    'command.name': string;\n    'command.duration_ms': number;\n    'command.success': boolean;\n    'command.error_type'?: string;\n    'command.error_message'?: string;\n    'command.flags'?: string;\n    'termination.reason'?: TerminationReason;\n    'error.code'?: string;\n    'api.status'?: number;\n    'api.code'?: string;\n    'api.resource'?: string;\n    'cli.version': string;\n    'workos.user_id'?: string;\n  } & EnvFingerprint;\n}\n\nexport interface CrashEvent extends BaseTelemetryEvent {\n  type: 'crash';\n  attributes: {\n    'crash.error_type': string;\n    'crash.error_message': string;\n    'crash.stack': string;\n    'crash.command'?: string;\n    'cli.version': string;\n    'workos.user_id'?: string;\n  } & EnvFingerprint;\n}\n\nexport interface TelemetryRequest {\n  events: TelemetryEvent[];\n}\n\nexport type TelemetryEvent =\n  | SessionStartEvent\n  | SessionEndEvent\n  | StepEvent\n  | AgentToolEvent\n  | AgentLLMEvent\n  | CommandEvent\n  | CrashEvent;\n"]}
+{"version":3,"file":"telemetry-types.js","sourceRoot":"","sources":["../../src/utils/telemetry-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * Telemetry event types for installer → gateway communication.\n * The gateway converts these to OTel format.\n */\n\nexport interface BaseTelemetryEvent {\n  type: 'session.start' | 'session.end' | 'step' | 'agent.tool' | 'agent.llm' | 'command' | 'crash';\n  sessionId: string;\n  timestamp: string;\n}\n\nexport type AuthMode = 'jwt' | 'claim_token' | 'api_key' | 'none';\n\n/**\n * Structured outcome dimension for command events. Supersedes the boolean\n * `command.success` as the primary categorization (`command.success` remains\n * for backward-compat). Populated by `analytics.emitCommandEvent()` from the\n * top-level command lifecycle.\n */\nexport type TerminationReason = 'success' | 'cancelled' | 'auth_required' | 'validation_error' | 'api_error' | 'crash';\n\nexport interface EnvFingerprint {\n  'device.id': string;\n  'auth.mode': AuthMode;\n  'env.os': string;\n  'env.os_version': string;\n  'env.node_version': string;\n  'env.shell': string;\n  'env.ci': boolean;\n  'env.ci_provider'?: string;\n}\n\nexport interface SessionStartEvent extends BaseTelemetryEvent {\n  type: 'session.start';\n  attributes: {\n    'installer.version': string;\n    'installer.mode': 'cli' | 'tui' | 'headless';\n    'workos.user_id'?: string;\n    'workos.org_id'?: string;\n  } & EnvFingerprint;\n}\n\nexport interface SessionEndEvent extends BaseTelemetryEvent {\n  type: 'session.end';\n  attributes: {\n    'installer.outcome': 'success' | 'error' | 'cancelled';\n    'installer.duration_ms': number;\n  } & Record<string, string | number | boolean>;\n}\n\nexport interface StepEvent extends BaseTelemetryEvent {\n  type: 'step';\n  name: string;\n  startTimestamp: string;\n  durationMs: number;\n  success: boolean;\n  error?: {\n    type: string;\n    message: string;\n  };\n}\n\nexport interface AgentToolEvent extends BaseTelemetryEvent {\n  type: 'agent.tool';\n  toolName: string;\n  startTimestamp: string;\n  durationMs: number;\n  success: boolean;\n}\n\nexport interface AgentLLMEvent extends BaseTelemetryEvent {\n  type: 'agent.llm';\n  model: string;\n  inputTokens: number;\n  outputTokens: number;\n}\n\nexport interface CommandEvent extends BaseTelemetryEvent {\n  type: 'command';\n  attributes: {\n    'command.name': string;\n    'command.duration_ms': number;\n    'command.success': boolean;\n    'command.error_type'?: string;\n    'command.error_message'?: string;\n    'command.flags'?: string;\n    'termination.reason'?: TerminationReason;\n    'error.code'?: string;\n    'api.status'?: number;\n    'api.code'?: string;\n    'api.resource'?: string;\n    'cli.version': string;\n    'workos.user_id'?: string;\n    // Open for caller-supplied dimensions (e.g. mcp.*) — the gateway schema is\n    // passthrough and flattens unknown attributes onto the command span.\n  } & EnvFingerprint &\n    Record<string, string | number | boolean | undefined>;\n}\n\nexport interface CrashEvent extends BaseTelemetryEvent {\n  type: 'crash';\n  attributes: {\n    'crash.error_type': string;\n    'crash.error_message': string;\n    'crash.stack': string;\n    'crash.command'?: string;\n    'cli.version': string;\n    'workos.user_id'?: string;\n  } & EnvFingerprint;\n}\n\nexport interface TelemetryRequest {\n  events: TelemetryEvent[];\n}\n\nexport type TelemetryEvent =\n  | SessionStartEvent\n  | SessionEndEvent\n  | StepEvent\n  | AgentToolEvent\n  | AgentLLMEvent\n  | CommandEvent\n  | CrashEvent;\n"]}

package/dist/utils/types.d.ts

@@ -1,3 +1,4 @@
+import type { CredentialSource } from '../lib/installer-core.types.js';
 export type InstallerOptions = {
     /**
      * Whether to enable debug mode.
@@ -36,6 +37,13 @@ export type InstallerOptions = {
      * WorkOS Client ID (client_xxx)
      */
     clientId?: string;
+    /**
+     * How the WorkOS credentials were resolved by the state machine
+     * (`cli`|`env`|`stored`|`device`|`manual`). Threaded downstream so
+     * user-facing copy can be source-accurate (e.g. avoid claiming the user
+     * "provided" credentials on the auto-provisioned path).
+     */
+    credentialSource?: CredentialSource;
     /**
      * App homepage URL for WorkOS dashboard config.
      * Defaults to http://localhost:{detected_port}
@@ -99,6 +107,8 @@ export type InstallerOptions = {
      * Overrides detection from npm_config_user_agent.
      */
     pm?: string;
+    /** Next.js router to target when detection is ambiguous (from --router). */
+    router?: 'app' | 'pages';
 };
 export interface Feature {
     id: string;

package/dist/utils/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"","sourcesContent":["export type InstallerOptions = {\n  /**\n   * Whether to enable debug mode.\n   */\n  debug: boolean;\n\n  /**\n   * Whether to force install the SDK package to continue with the installation in case\n   * any package manager checks are failing (e.g. peer dependency versions).\n   *\n   * Use with caution and only if you know what you're doing.\n   *\n   * Does not apply to all wizard flows (currently NPM only)\n   */\n  forceInstall: boolean;\n\n  /**\n   * The directory to run the wizard in.\n   */\n  installDir: string;\n\n  /**\n   * Whether to use local services (LLM gateway on localhost:8000)\n   */\n  local: boolean;\n\n  /**\n   * CI mode - non-interactive execution\n   */\n  ci: boolean;\n\n  /**\n   * Skip authentication check (for local development only)\n   */\n  skipAuth: boolean;\n\n  /**\n   * WorkOS API key (sk_xxx)\n   */\n  apiKey?: string;\n\n  /**\n   * WorkOS Client ID (client_xxx)\n   */\n  clientId?: string;\n\n  /**\n   * App homepage URL for WorkOS dashboard config.\n   * Defaults to http://localhost:{detected_port}\n   */\n  homepageUrl?: string;\n\n  /**\n   * Redirect URI for WorkOS callback.\n   * Defaults to framework-specific convention (e.g., /api/auth/callback)\n   */\n  redirectUri?: string;\n\n  /**\n   * [Experimental] Enable visual dashboard mode\n   */\n  dashboard?: boolean;\n\n  /**\n   * Event emitter for dashboard mode\n   */\n  emitter?: import('../lib/events.js').InstallerEventEmitter;\n\n  /**\n   * Enable XState inspector - opens browser to visualize state machine live\n   */\n  inspect?: boolean;\n\n  /**\n   * Skip post-installation validation (includes build check)\n   */\n  noValidate?: boolean;\n\n  /**\n   * Skip post-install commit and PR workflow\n   */\n  noCommit?: boolean;\n\n  /**\n   * Skip branch creation (continue on current branch)\n   */\n  noBranch?: boolean;\n\n  /**\n   * Auto-create pull request after installation\n   */\n  createPr?: boolean;\n\n  /**\n   * Skip git dirty working tree check\n   */\n  noGitCheck?: boolean;\n\n  /**\n   * Direct mode - bypass llm-gateway and use user's own Anthropic API key.\n   * Requires ANTHROPIC_API_KEY environment variable.\n   */\n  direct?: boolean;\n\n  /**\n   * Max correction attempts after initial agent run.\n   * The agent gets this many chances to fix validation failures (typecheck/build).\n   * Default: 2. Set to 0 to disable retries entirely.\n   */\n  maxRetries?: number;\n\n  /**\n   * Scaffold a new Next.js app when run in an empty directory.\n   * Auto-enabled in headless mode; opt-in via --scaffold in interactive mode.\n   */\n  scaffold?: boolean;\n\n  /**\n   * Package manager for the scaffolded app (npm/pnpm/yarn/bun).\n   * Overrides detection from npm_config_user_agent.\n   */\n  pm?: string;\n};\n\nexport interface Feature {\n  id: string;\n  prompt: string;\n  enabledHint?: string;\n  disabledHint?: string;\n}\n\nexport type FileChange = {\n  filePath: string;\n  oldContent?: string;\n  newContent: string;\n};\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { CredentialSource } from '../lib/installer-core.types.js';\n\nexport type InstallerOptions = {\n  /**\n   * Whether to enable debug mode.\n   */\n  debug: boolean;\n\n  /**\n   * Whether to force install the SDK package to continue with the installation in case\n   * any package manager checks are failing (e.g. peer dependency versions).\n   *\n   * Use with caution and only if you know what you're doing.\n   *\n   * Does not apply to all wizard flows (currently NPM only)\n   */\n  forceInstall: boolean;\n\n  /**\n   * The directory to run the wizard in.\n   */\n  installDir: string;\n\n  /**\n   * Whether to use local services (LLM gateway on localhost:8000)\n   */\n  local: boolean;\n\n  /**\n   * CI mode - non-interactive execution\n   */\n  ci: boolean;\n\n  /**\n   * Skip authentication check (for local development only)\n   */\n  skipAuth: boolean;\n\n  /**\n   * WorkOS API key (sk_xxx)\n   */\n  apiKey?: string;\n\n  /**\n   * WorkOS Client ID (client_xxx)\n   */\n  clientId?: string;\n\n  /**\n   * How the WorkOS credentials were resolved by the state machine\n   * (`cli`|`env`|`stored`|`device`|`manual`). Threaded downstream so\n   * user-facing copy can be source-accurate (e.g. avoid claiming the user\n   * \"provided\" credentials on the auto-provisioned path).\n   */\n  credentialSource?: CredentialSource;\n\n  /**\n   * App homepage URL for WorkOS dashboard config.\n   * Defaults to http://localhost:{detected_port}\n   */\n  homepageUrl?: string;\n\n  /**\n   * Redirect URI for WorkOS callback.\n   * Defaults to framework-specific convention (e.g., /api/auth/callback)\n   */\n  redirectUri?: string;\n\n  /**\n   * [Experimental] Enable visual dashboard mode\n   */\n  dashboard?: boolean;\n\n  /**\n   * Event emitter for dashboard mode\n   */\n  emitter?: import('../lib/events.js').InstallerEventEmitter;\n\n  /**\n   * Enable XState inspector - opens browser to visualize state machine live\n   */\n  inspect?: boolean;\n\n  /**\n   * Skip post-installation validation (includes build check)\n   */\n  noValidate?: boolean;\n\n  /**\n   * Skip post-install commit and PR workflow\n   */\n  noCommit?: boolean;\n\n  /**\n   * Skip branch creation (continue on current branch)\n   */\n  noBranch?: boolean;\n\n  /**\n   * Auto-create pull request after installation\n   */\n  createPr?: boolean;\n\n  /**\n   * Skip git dirty working tree check\n   */\n  noGitCheck?: boolean;\n\n  /**\n   * Direct mode - bypass llm-gateway and use user's own Anthropic API key.\n   * Requires ANTHROPIC_API_KEY environment variable.\n   */\n  direct?: boolean;\n\n  /**\n   * Max correction attempts after initial agent run.\n   * The agent gets this many chances to fix validation failures (typecheck/build).\n   * Default: 2. Set to 0 to disable retries entirely.\n   */\n  maxRetries?: number;\n\n  /**\n   * Scaffold a new Next.js app when run in an empty directory.\n   * Auto-enabled in headless mode; opt-in via --scaffold in interactive mode.\n   */\n  scaffold?: boolean;\n\n  /**\n   * Package manager for the scaffolded app (npm/pnpm/yarn/bun).\n   * Overrides detection from npm_config_user_agent.\n   */\n  pm?: string;\n\n  /** Next.js router to target when detection is ambiguous (from --router). */\n  router?: 'app' | 'pages';\n};\n\nexport interface Feature {\n  id: string;\n  prompt: string;\n  enabledHint?: string;\n  disabledHint?: string;\n}\n\nexport type FileChange = {\n  filePath: string;\n  oldContent?: string;\n  newContent: string;\n};\n"]}

package/dist/utils/{clack-utils.d.ts → ui-utils.d.ts}

@@ -88,7 +88,7 @@ export declare function isUsingTypeScript({ installDir }: Pick<InstallerOptions,
  * Get WorkOS credentials (API Key and Client ID) from user or CLI options
  * @param requireApiKey - Whether API key is needed (false for client-only SDKs like React, Vanilla JS)
  */
-export declare function getOrAskForWorkOSCredentials(_options: Pick<InstallerOptions, 'ci' | 'apiKey' | 'clientId' | 'installDir' | 'dashboard'>, requireApiKey?: boolean): Promise<{
+export declare function getOrAskForWorkOSCredentials(_options: Pick<InstallerOptions, 'ci' | 'apiKey' | 'clientId' | 'installDir' | 'dashboard' | 'credentialSource'>, requireApiKey?: boolean): Promise<{
     apiKey: string;
     clientId: string;
 }>;