workos 0.3.3 → 0.5.0

package/dist/integrations/elixir/index.js

@@ -0,0 +1,152 @@
+import { enableDebugLogs } from '../../utils/debug.js';
+import { SPINNER_MESSAGE } from '../../lib/framework-config.js';
+import { analytics } from '../../utils/analytics.js';
+import { INSTALLER_INTERACTION_EVENT_NAME } from '../../lib/constants.js';
+import { getOrAskForWorkOSCredentials } from '../../utils/clack-utils.js';
+import { initializeAgent, runAgent } from '../../lib/agent-interface.js';
+import { writeEnvLocal } from '../../lib/env-writer.js';
+export const config = {
+    metadata: {
+        name: 'Elixir (Phoenix)',
+        integration: 'elixir',
+        docsUrl: 'https://github.com/workos/workos-elixir',
+        skillName: 'workos-elixir',
+        language: 'elixir',
+        stability: 'experimental',
+        priority: 30,
+        packageManager: 'mix',
+        manifestFile: 'mix.exs',
+    },
+    detection: {
+        // Required by FrameworkDetection interface — stubs for non-JS integration.
+        // Actual detection uses language-detection.ts (mix.exs) + registry manifestFile check.
+        packageName: 'workos',
+        packageDisplayName: 'WorkOS Elixir',
+        getVersion: () => undefined,
+    },
+    environment: {
+        uploadToHosting: false,
+        requiresApiKey: true,
+        getEnvVars: (apiKey, clientId) => ({
+            WORKOS_API_KEY: apiKey,
+            WORKOS_CLIENT_ID: clientId,
+        }),
+    },
+    analytics: {
+        getTags: () => ({}),
+    },
+    prompts: {},
+    ui: {
+        successMessage: 'WorkOS AuthKit integration complete',
+        getOutroChanges: () => [
+            'Analyzed your Phoenix project structure',
+            'Installed workos Hex package',
+            'Configured WorkOS in config/runtime.exs',
+            'Created auth controller and routes',
+        ],
+        getOutroNextSteps: () => [
+            'Run `mix phx.server` to test authentication',
+            'Visit the WorkOS Dashboard to manage users and settings',
+        ],
+    },
+};
+/**
+ * Custom run function for Elixir — bypasses runAgentInstaller() which assumes
+ * package.json exists. Directly calls initializeAgent/runAgent instead.
+ */
+export async function run(options) {
+    if (options.debug) {
+        enableDebugLogs();
+    }
+    options.emitter?.emit('status', {
+        message: `Setting up WorkOS AuthKit for ${config.metadata.name}`,
+    });
+    analytics.capture(INSTALLER_INTERACTION_EVENT_NAME, {
+        action: 'started agent integration',
+        integration: config.metadata.integration,
+    });
+    // Get WorkOS credentials
+    const { apiKey, clientId } = await getOrAskForWorkOSCredentials(options, config.environment.requiresApiKey);
+    // Write env vars to .env.local for the agent to reference
+    const callerHandledConfig = Boolean(options.apiKey || options.clientId);
+    if (!callerHandledConfig) {
+        const port = 4000; // Phoenix default
+        const callbackPath = '/auth/callback';
+        const redirectUri = options.redirectUri || `http://localhost:${port}${callbackPath}`;
+        writeEnvLocal(options.installDir, {
+            ...(apiKey ? { WORKOS_API_KEY: apiKey } : {}),
+            WORKOS_CLIENT_ID: clientId,
+            WORKOS_REDIRECT_URI: redirectUri,
+        });
+    }
+    // Build Elixir-specific prompt
+    const integrationPrompt = buildElixirPrompt();
+    // Initialize and run agent
+    const agent = await initializeAgent({
+        workingDirectory: options.installDir,
+        workOSApiKey: apiKey,
+        workOSApiHost: 'https://api.workos.com',
+    }, options);
+    const agentResult = await runAgent(agent, integrationPrompt, options, {
+        spinnerMessage: SPINNER_MESSAGE,
+        successMessage: config.ui.successMessage,
+        errorMessage: 'Integration failed',
+    }, options.emitter);
+    if (agentResult.error) {
+        await analytics.shutdown('error');
+        const message = agentResult.errorMessage || agentResult.error;
+        throw new Error(`Agent SDK error: ${message}`);
+    }
+    // Build summary
+    const changes = config.ui.getOutroChanges({});
+    const nextSteps = config.ui.getOutroNextSteps({});
+    const lines = [
+        'Successfully installed WorkOS AuthKit!',
+        '',
+        'What the agent did:',
+        ...changes.map((c) => `• ${c}`),
+        '',
+        'Next steps:',
+        ...nextSteps.map((s) => `• ${s}`),
+        '',
+        `Learn more: ${config.metadata.docsUrl}`,
+        '',
+        'Note: This installer uses an LLM agent to analyze and modify your project. Please review the changes made.',
+    ];
+    await analytics.shutdown('success');
+    return lines.join('\n');
+}
+function buildElixirPrompt() {
+    return `You are integrating WorkOS AuthKit into this Elixir/Phoenix application.
+
+## Project Context
+
+- Framework: Phoenix (Elixir)
+- Package manager: mix (Hex)
+
+## Environment
+
+The following environment variables have been configured in .env.local:
+- WORKOS_API_KEY
+- WORKOS_CLIENT_ID
+- WORKOS_REDIRECT_URI
+
+Note: For Elixir/Phoenix, these should be read via System.get_env() in config/runtime.exs rather than from .env.local directly.
+
+## Your Task
+
+Use the \`workos-elixir\` skill to integrate WorkOS AuthKit into this application.
+
+The skill contains step-by-step instructions including:
+1. Fetching the SDK documentation
+2. Validating the Phoenix project structure
+3. Installing the workos Hex package
+4. Configuring WorkOS in runtime.exs
+5. Creating auth controller and routes
+6. Verification with mix compile
+
+Report your progress using [STATUS] prefixes.
+
+Begin by invoking the workos-elixir skill.`;
+}
+//# sourceMappingURL=index.js.map

package/dist/integrations/elixir/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/elixir/index.ts"],"names":[],"mappings":"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","sourcesContent":["/* Elixir/Phoenix integration — auto-discovered by registry */\nimport type { FrameworkConfig } from '../../lib/framework-config.js';\nimport type { InstallerOptions } from '../../utils/types.js';\nimport { enableDebugLogs } from '../../utils/debug.js';\nimport { SPINNER_MESSAGE } from '../../lib/framework-config.js';\nimport { analytics } from '../../utils/analytics.js';\nimport { INSTALLER_INTERACTION_EVENT_NAME } from '../../lib/constants.js';\nimport { getOrAskForWorkOSCredentials } from '../../utils/clack-utils.js';\nimport { initializeAgent, runAgent } from '../../lib/agent-interface.js';\nimport { writeEnvLocal } from '../../lib/env-writer.js';\n\nexport const config: FrameworkConfig = {\n  metadata: {\n    name: 'Elixir (Phoenix)',\n    integration: 'elixir',\n    docsUrl: 'https://github.com/workos/workos-elixir',\n    skillName: 'workos-elixir',\n    language: 'elixir',\n    stability: 'experimental',\n    priority: 30,\n    packageManager: 'mix',\n    manifestFile: 'mix.exs',\n  },\n\n  detection: {\n    // Required by FrameworkDetection interface — stubs for non-JS integration.\n    // Actual detection uses language-detection.ts (mix.exs) + registry manifestFile check.\n    packageName: 'workos',\n    packageDisplayName: 'WorkOS Elixir',\n    getVersion: () => undefined,\n  },\n\n  environment: {\n    uploadToHosting: false,\n    requiresApiKey: true,\n    getEnvVars: (apiKey: string, clientId: string) => ({\n      WORKOS_API_KEY: apiKey,\n      WORKOS_CLIENT_ID: clientId,\n    }),\n  },\n\n  analytics: {\n    getTags: () => ({}),\n  },\n\n  prompts: {},\n\n  ui: {\n    successMessage: 'WorkOS AuthKit integration complete',\n    getOutroChanges: () => [\n      'Analyzed your Phoenix project structure',\n      'Installed workos Hex package',\n      'Configured WorkOS in config/runtime.exs',\n      'Created auth controller and routes',\n    ],\n    getOutroNextSteps: () => [\n      'Run `mix phx.server` to test authentication',\n      'Visit the WorkOS Dashboard to manage users and settings',\n    ],\n  },\n};\n\n/**\n * Custom run function for Elixir — bypasses runAgentInstaller() which assumes\n * package.json exists. Directly calls initializeAgent/runAgent instead.\n */\nexport async function run(options: InstallerOptions): Promise<string> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  options.emitter?.emit('status', {\n    message: `Setting up WorkOS AuthKit for ${config.metadata.name}`,\n  });\n\n  analytics.capture(INSTALLER_INTERACTION_EVENT_NAME, {\n    action: 'started agent integration',\n    integration: config.metadata.integration,\n  });\n\n  // Get WorkOS credentials\n  const { apiKey, clientId } = await getOrAskForWorkOSCredentials(options, config.environment.requiresApiKey);\n\n  // Write env vars to .env.local for the agent to reference\n  const callerHandledConfig = Boolean(options.apiKey || options.clientId);\n  if (!callerHandledConfig) {\n    const port = 4000; // Phoenix default\n    const callbackPath = '/auth/callback';\n    const redirectUri = options.redirectUri || `http://localhost:${port}${callbackPath}`;\n\n    writeEnvLocal(options.installDir, {\n      ...(apiKey ? { WORKOS_API_KEY: apiKey } : {}),\n      WORKOS_CLIENT_ID: clientId,\n      WORKOS_REDIRECT_URI: redirectUri,\n    });\n  }\n\n  // Build Elixir-specific prompt\n  const integrationPrompt = buildElixirPrompt();\n\n  // Initialize and run agent\n  const agent = await initializeAgent(\n    {\n      workingDirectory: options.installDir,\n      workOSApiKey: apiKey,\n      workOSApiHost: 'https://api.workos.com',\n    },\n    options,\n  );\n\n  const agentResult = await runAgent(\n    agent,\n    integrationPrompt,\n    options,\n    {\n      spinnerMessage: SPINNER_MESSAGE,\n      successMessage: config.ui.successMessage,\n      errorMessage: 'Integration failed',\n    },\n    options.emitter,\n  );\n\n  if (agentResult.error) {\n    await analytics.shutdown('error');\n    const message = agentResult.errorMessage || agentResult.error;\n    throw new Error(`Agent SDK error: ${message}`);\n  }\n\n  // Build summary\n  const changes = config.ui.getOutroChanges({});\n  const nextSteps = config.ui.getOutroNextSteps({});\n\n  const lines: string[] = [\n    'Successfully installed WorkOS AuthKit!',\n    '',\n    'What the agent did:',\n    ...changes.map((c) => `• ${c}`),\n    '',\n    'Next steps:',\n    ...nextSteps.map((s) => `• ${s}`),\n    '',\n    `Learn more: ${config.metadata.docsUrl}`,\n    '',\n    'Note: This installer uses an LLM agent to analyze and modify your project. Please review the changes made.',\n  ];\n\n  await analytics.shutdown('success');\n  return lines.join('\\n');\n}\n\nfunction buildElixirPrompt(): string {\n  return `You are integrating WorkOS AuthKit into this Elixir/Phoenix application.\n\n## Project Context\n\n- Framework: Phoenix (Elixir)\n- Package manager: mix (Hex)\n\n## Environment\n\nThe following environment variables have been configured in .env.local:\n- WORKOS_API_KEY\n- WORKOS_CLIENT_ID\n- WORKOS_REDIRECT_URI\n\nNote: For Elixir/Phoenix, these should be read via System.get_env() in config/runtime.exs rather than from .env.local directly.\n\n## Your Task\n\nUse the \\`workos-elixir\\` skill to integrate WorkOS AuthKit into this application.\n\nThe skill contains step-by-step instructions including:\n1. Fetching the SDK documentation\n2. Validating the Phoenix project structure\n3. Installing the workos Hex package\n4. Configuring WorkOS in runtime.exs\n5. Creating auth controller and routes\n6. Verification with mix compile\n\nReport your progress using [STATUS] prefixes.\n\nBegin by invoking the workos-elixir skill.`;\n}\n"]}

package/dist/integrations/go/index.d.ts

@@ -0,0 +1,11 @@
+import type { FrameworkConfig } from '../../lib/framework-config.js';
+import type { InstallerOptions } from '../../utils/types.js';
+export declare const config: FrameworkConfig;
+/**
+ * Run the Go integration.
+ *
+ * Custom flow that bypasses runAgentInstaller because the universal runner
+ * assumes package.json exists (getPackageDotJson aborts without it) and
+ * port-detection/env-writer are JS-specific.
+ */
+export declare function run(options: InstallerOptions): Promise<string>;

package/dist/integrations/go/index.js

@@ -0,0 +1,220 @@
+/* Go integration — auto-discovered by registry */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { SPINNER_MESSAGE } from '../../lib/framework-config.js';
+import { enableDebugLogs } from '../../utils/debug.js';
+import { analytics } from '../../utils/analytics.js';
+import { INSTALLER_INTERACTION_EVENT_NAME } from '../../lib/constants.js';
+import { initializeAgent, runAgent } from '../../lib/agent-interface.js';
+import { getOrAskForWorkOSCredentials } from '../../utils/clack-utils.js';
+import { autoConfigureWorkOSEnvironment } from '../../lib/workos-management.js';
+import { validateInstallation } from '../../lib/validation/index.js';
+import { parseEnvFile } from '../../utils/env-parser.js';
+/** Default port for Go HTTP servers */
+const GO_DEFAULT_PORT = 8080;
+const GO_CALLBACK_PATH = '/auth/callback';
+/**
+ * Detect whether go.mod includes the Gin web framework.
+ */
+function detectGoFramework(installDir) {
+    try {
+        const goMod = readFileSync(join(installDir, 'go.mod'), 'utf-8');
+        return goMod.includes('github.com/gin-gonic/gin') ? 'gin' : 'stdlib';
+    }
+    catch {
+        return 'stdlib';
+    }
+}
+/**
+ * Write environment variables to .env (Go convention, not .env.local).
+ * Merges with existing .env if present.
+ */
+function writeGoEnv(installDir, envVars) {
+    const envPath = join(installDir, '.env');
+    let existing = {};
+    if (existsSync(envPath)) {
+        existing = parseEnvFile(readFileSync(envPath, 'utf-8'));
+    }
+    const merged = { ...existing, ...envVars };
+    const content = Object.entries(merged)
+        .map(([key, value]) => `${key}=${value}`)
+        .join('\n');
+    writeFileSync(envPath, content + '\n');
+}
+export const config = {
+    metadata: {
+        name: 'Go',
+        integration: 'go',
+        docsUrl: 'https://workos.com/docs/authkit/vanilla/go',
+        skillName: 'workos-go',
+        language: 'go',
+        stability: 'experimental',
+        priority: 50,
+        packageManager: 'go',
+        manifestFile: 'go.mod',
+        gatherContext: async (options) => {
+            return { framework: detectGoFramework(options.installDir) };
+        },
+    },
+    detection: {
+        packageName: 'github.com/workos/workos-go/v4',
+        packageDisplayName: 'Go',
+        getVersion: () => undefined,
+    },
+    environment: {
+        uploadToHosting: false,
+        requiresApiKey: true,
+        getEnvVars: (apiKey, clientId) => ({
+            WORKOS_API_KEY: apiKey,
+            WORKOS_CLIENT_ID: clientId,
+        }),
+    },
+    analytics: {
+        getTags: (context) => (context?.framework ? { 'go-framework': context.framework } : {}),
+    },
+    prompts: {
+        getAdditionalContextLines: (context) => [
+            ...(context?.framework ? [`Go web framework: ${context.framework}`] : []),
+        ],
+    },
+    ui: {
+        successMessage: 'WorkOS AuthKit integration complete',
+        getOutroChanges: () => [
+            'Analyzed your Go project structure',
+            'Installed workos-go SDK',
+            'Created authentication handlers',
+            'Configured environment variables',
+        ],
+        getOutroNextSteps: () => [
+            'Run `go run .` to start your server',
+            'Visit the WorkOS Dashboard to manage users and settings',
+        ],
+    },
+};
+/**
+ * Run the Go integration.
+ *
+ * Custom flow that bypasses runAgentInstaller because the universal runner
+ * assumes package.json exists (getPackageDotJson aborts without it) and
+ * port-detection/env-writer are JS-specific.
+ */
+export async function run(options) {
+    if (options.debug) {
+        enableDebugLogs();
+    }
+    options.emitter?.emit('status', {
+        message: `Setting up WorkOS AuthKit for ${config.metadata.name}`,
+    });
+    analytics.capture(INSTALLER_INTERACTION_EVENT_NAME, {
+        action: 'started agent integration',
+        integration: config.metadata.integration,
+    });
+    // Get WorkOS credentials
+    const { apiKey, clientId } = await getOrAskForWorkOSCredentials(options, config.environment.requiresApiKey);
+    // Auto-configure WorkOS environment (redirect URI, CORS)
+    const callerHandledConfig = Boolean(options.apiKey || options.clientId);
+    if (!callerHandledConfig && apiKey) {
+        const redirectUri = options.redirectUri || `http://localhost:${GO_DEFAULT_PORT}${GO_CALLBACK_PATH}`;
+        await autoConfigureWorkOSEnvironment(apiKey, config.metadata.integration, GO_DEFAULT_PORT, {
+            homepageUrl: options.homepageUrl,
+            redirectUri,
+        });
+    }
+    // Gather Go-specific context
+    const frameworkContext = config.metadata.gatherContext ? await config.metadata.gatherContext(options) : {};
+    // Write .env (not .env.local — Go convention)
+    if (!callerHandledConfig) {
+        const redirectUri = options.redirectUri || `http://localhost:${GO_DEFAULT_PORT}${GO_CALLBACK_PATH}`;
+        writeGoEnv(options.installDir, {
+            ...(apiKey ? { WORKOS_API_KEY: apiKey } : {}),
+            WORKOS_CLIENT_ID: clientId,
+            WORKOS_REDIRECT_URI: redirectUri,
+        });
+    }
+    // Set analytics tags
+    const contextTags = config.analytics.getTags(frameworkContext);
+    Object.entries(contextTags).forEach(([key, value]) => {
+        analytics.setTag(key, value);
+    });
+    // Build prompt
+    const additionalLines = config.prompts.getAdditionalContextLines
+        ? config.prompts.getAdditionalContextLines(frameworkContext)
+        : [];
+    const additionalContext = additionalLines.length > 0 ? '\n' + additionalLines.map((line) => `- ${line}`).join('\n') : '';
+    const skillName = config.metadata.skillName;
+    const integrationPrompt = `You are integrating WorkOS AuthKit into this ${config.metadata.name} application.
+
+## Project Context
+
+- Language: Go
+- Framework: ${frameworkContext.framework === 'gin' ? 'Gin' : 'stdlib net/http'}${additionalContext}
+
+## Environment
+
+The following environment variables have been configured in .env:
+- WORKOS_API_KEY
+- WORKOS_CLIENT_ID
+- WORKOS_REDIRECT_URI
+
+## Your Task
+
+Use the \`${skillName}\` skill to integrate WorkOS AuthKit into this application.
+
+The skill contains step-by-step instructions including:
+1. Fetching the SDK documentation
+2. Installing the SDK
+3. Detecting Gin vs stdlib
+4. Creating authentication handlers
+5. Wiring handlers into the router
+6. Verification with go build and go vet
+
+Report your progress using [STATUS] prefixes.
+
+Begin by invoking the ${skillName} skill.`;
+    // Initialize and run agent
+    const agent = await initializeAgent({
+        workingDirectory: options.installDir,
+        workOSApiKey: apiKey,
+        workOSApiHost: 'https://api.workos.com',
+    }, options);
+    const agentResult = await runAgent(agent, integrationPrompt, options, {
+        spinnerMessage: SPINNER_MESSAGE,
+        successMessage: config.ui.successMessage,
+        errorMessage: 'Integration failed',
+    }, options.emitter);
+    if (agentResult.error) {
+        await analytics.shutdown('error');
+        const message = agentResult.errorMessage || agentResult.error;
+        throw new Error(`Agent SDK error: ${message}`);
+    }
+    // Post-installation validation (gracefully skips — no rules file for Go)
+    if (!options.noValidate) {
+        options.emitter?.emit('validation:start', { framework: config.metadata.integration });
+        const validationResult = await validateInstallation(config.metadata.integration, options.installDir, {
+            runBuild: true,
+        });
+        if (validationResult.issues.length > 0) {
+            options.emitter?.emit('validation:issues', { issues: validationResult.issues });
+        }
+        options.emitter?.emit('validation:complete', {
+            passed: validationResult.passed,
+            issueCount: validationResult.issues.length,
+            durationMs: validationResult.durationMs,
+        });
+    }
+    // Build summary
+    const changes = config.ui.getOutroChanges(frameworkContext).filter(Boolean);
+    const nextSteps = config.ui.getOutroNextSteps(frameworkContext).filter(Boolean);
+    const lines = [
+        'Successfully installed WorkOS AuthKit!',
+        '',
+        ...(changes.length > 0 ? ['What the agent did:', ...changes.map((c) => `• ${c}`), ''] : []),
+        ...(nextSteps.length > 0 ? ['Next steps:', ...nextSteps.map((s) => `• ${s}`), ''] : []),
+        `Learn more: ${config.metadata.docsUrl}`,
+        '',
+        'Note: This installer uses an LLM agent to analyze and modify your project. Please review the changes made.',
+    ];
+    await analytics.shutdown('success');
+    return lines.join('\n');
+}
+//# sourceMappingURL=index.js.map

package/dist/integrations/go/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/go/index.ts"],"names":[],"mappings":"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","sourcesContent":["/* Go integration — auto-discovered by registry */\nimport { existsSync, readFileSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport type { FrameworkConfig } from '../../lib/framework-config.js';\nimport { SPINNER_MESSAGE } from '../../lib/framework-config.js';\nimport type { InstallerOptions } from '../../utils/types.js';\nimport { enableDebugLogs } from '../../utils/debug.js';\nimport { analytics } from '../../utils/analytics.js';\nimport { INSTALLER_INTERACTION_EVENT_NAME } from '../../lib/constants.js';\nimport { initializeAgent, runAgent } from '../../lib/agent-interface.js';\nimport { getOrAskForWorkOSCredentials } from '../../utils/clack-utils.js';\nimport { autoConfigureWorkOSEnvironment } from '../../lib/workos-management.js';\nimport { validateInstallation } from '../../lib/validation/index.js';\nimport { parseEnvFile } from '../../utils/env-parser.js';\n\n/** Default port for Go HTTP servers */\nconst GO_DEFAULT_PORT = 8080;\nconst GO_CALLBACK_PATH = '/auth/callback';\n\n/**\n * Detect whether go.mod includes the Gin web framework.\n */\nfunction detectGoFramework(installDir: string): 'gin' | 'stdlib' {\n  try {\n    const goMod = readFileSync(join(installDir, 'go.mod'), 'utf-8');\n    return goMod.includes('github.com/gin-gonic/gin') ? 'gin' : 'stdlib';\n  } catch {\n    return 'stdlib';\n  }\n}\n\n/**\n * Write environment variables to .env (Go convention, not .env.local).\n * Merges with existing .env if present.\n */\nfunction writeGoEnv(installDir: string, envVars: Record<string, string>): void {\n  const envPath = join(installDir, '.env');\n  let existing: Record<string, string> = {};\n\n  if (existsSync(envPath)) {\n    existing = parseEnvFile(readFileSync(envPath, 'utf-8'));\n  }\n\n  const merged = { ...existing, ...envVars };\n  const content = Object.entries(merged)\n    .map(([key, value]) => `${key}=${value}`)\n    .join('\\n');\n\n  writeFileSync(envPath, content + '\\n');\n}\n\nexport const config: FrameworkConfig = {\n  metadata: {\n    name: 'Go',\n    integration: 'go',\n    docsUrl: 'https://workos.com/docs/authkit/vanilla/go',\n    skillName: 'workos-go',\n    language: 'go',\n    stability: 'experimental',\n    priority: 50,\n    packageManager: 'go',\n    manifestFile: 'go.mod',\n    gatherContext: async (options) => {\n      return { framework: detectGoFramework(options.installDir) };\n    },\n  },\n\n  detection: {\n    packageName: 'github.com/workos/workos-go/v4',\n    packageDisplayName: 'Go',\n    getVersion: () => undefined,\n  },\n\n  environment: {\n    uploadToHosting: false,\n    requiresApiKey: true,\n    getEnvVars: (apiKey: string, clientId: string) => ({\n      WORKOS_API_KEY: apiKey,\n      WORKOS_CLIENT_ID: clientId,\n    }),\n  },\n\n  analytics: {\n    getTags: (context: any) => (context?.framework ? { 'go-framework': context.framework } : {}),\n  },\n\n  prompts: {\n    getAdditionalContextLines: (context: any) => [\n      ...(context?.framework ? [`Go web framework: ${context.framework}`] : []),\n    ],\n  },\n\n  ui: {\n    successMessage: 'WorkOS AuthKit integration complete',\n    getOutroChanges: () => [\n      'Analyzed your Go project structure',\n      'Installed workos-go SDK',\n      'Created authentication handlers',\n      'Configured environment variables',\n    ],\n    getOutroNextSteps: () => [\n      'Run `go run .` to start your server',\n      'Visit the WorkOS Dashboard to manage users and settings',\n    ],\n  },\n};\n\n/**\n * Run the Go integration.\n *\n * Custom flow that bypasses runAgentInstaller because the universal runner\n * assumes package.json exists (getPackageDotJson aborts without it) and\n * port-detection/env-writer are JS-specific.\n */\nexport async function run(options: InstallerOptions): Promise<string> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  options.emitter?.emit('status', {\n    message: `Setting up WorkOS AuthKit for ${config.metadata.name}`,\n  });\n\n  analytics.capture(INSTALLER_INTERACTION_EVENT_NAME, {\n    action: 'started agent integration',\n    integration: config.metadata.integration,\n  });\n\n  // Get WorkOS credentials\n  const { apiKey, clientId } = await getOrAskForWorkOSCredentials(options, config.environment.requiresApiKey);\n\n  // Auto-configure WorkOS environment (redirect URI, CORS)\n  const callerHandledConfig = Boolean(options.apiKey || options.clientId);\n  if (!callerHandledConfig && apiKey) {\n    const redirectUri = options.redirectUri || `http://localhost:${GO_DEFAULT_PORT}${GO_CALLBACK_PATH}`;\n    await autoConfigureWorkOSEnvironment(apiKey, config.metadata.integration, GO_DEFAULT_PORT, {\n      homepageUrl: options.homepageUrl,\n      redirectUri,\n    });\n  }\n\n  // Gather Go-specific context\n  const frameworkContext = config.metadata.gatherContext ? await config.metadata.gatherContext(options) : {};\n\n  // Write .env (not .env.local — Go convention)\n  if (!callerHandledConfig) {\n    const redirectUri = options.redirectUri || `http://localhost:${GO_DEFAULT_PORT}${GO_CALLBACK_PATH}`;\n    writeGoEnv(options.installDir, {\n      ...(apiKey ? { WORKOS_API_KEY: apiKey } : {}),\n      WORKOS_CLIENT_ID: clientId,\n      WORKOS_REDIRECT_URI: redirectUri,\n    });\n  }\n\n  // Set analytics tags\n  const contextTags = config.analytics.getTags(frameworkContext);\n  Object.entries(contextTags).forEach(([key, value]) => {\n    analytics.setTag(key, value);\n  });\n\n  // Build prompt\n  const additionalLines = config.prompts.getAdditionalContextLines\n    ? config.prompts.getAdditionalContextLines(frameworkContext)\n    : [];\n  const additionalContext =\n    additionalLines.length > 0 ? '\\n' + additionalLines.map((line) => `- ${line}`).join('\\n') : '';\n\n  const skillName = config.metadata.skillName!;\n  const integrationPrompt = `You are integrating WorkOS AuthKit into this ${config.metadata.name} application.\n\n## Project Context\n\n- Language: Go\n- Framework: ${frameworkContext.framework === 'gin' ? 'Gin' : 'stdlib net/http'}${additionalContext}\n\n## Environment\n\nThe following environment variables have been configured in .env:\n- WORKOS_API_KEY\n- WORKOS_CLIENT_ID\n- WORKOS_REDIRECT_URI\n\n## Your Task\n\nUse the \\`${skillName}\\` skill to integrate WorkOS AuthKit into this application.\n\nThe skill contains step-by-step instructions including:\n1. Fetching the SDK documentation\n2. Installing the SDK\n3. Detecting Gin vs stdlib\n4. Creating authentication handlers\n5. Wiring handlers into the router\n6. Verification with go build and go vet\n\nReport your progress using [STATUS] prefixes.\n\nBegin by invoking the ${skillName} skill.`;\n\n  // Initialize and run agent\n  const agent = await initializeAgent(\n    {\n      workingDirectory: options.installDir,\n      workOSApiKey: apiKey,\n      workOSApiHost: 'https://api.workos.com',\n    },\n    options,\n  );\n\n  const agentResult = await runAgent(\n    agent,\n    integrationPrompt,\n    options,\n    {\n      spinnerMessage: SPINNER_MESSAGE,\n      successMessage: config.ui.successMessage,\n      errorMessage: 'Integration failed',\n    },\n    options.emitter,\n  );\n\n  if (agentResult.error) {\n    await analytics.shutdown('error');\n    const message = agentResult.errorMessage || agentResult.error;\n    throw new Error(`Agent SDK error: ${message}`);\n  }\n\n  // Post-installation validation (gracefully skips — no rules file for Go)\n  if (!options.noValidate) {\n    options.emitter?.emit('validation:start', { framework: config.metadata.integration });\n\n    const validationResult = await validateInstallation(config.metadata.integration, options.installDir, {\n      runBuild: true,\n    });\n\n    if (validationResult.issues.length > 0) {\n      options.emitter?.emit('validation:issues', { issues: validationResult.issues });\n    }\n\n    options.emitter?.emit('validation:complete', {\n      passed: validationResult.passed,\n      issueCount: validationResult.issues.length,\n      durationMs: validationResult.durationMs,\n    });\n  }\n\n  // Build summary\n  const changes = config.ui.getOutroChanges(frameworkContext).filter(Boolean);\n  const nextSteps = config.ui.getOutroNextSteps(frameworkContext).filter(Boolean);\n\n  const lines: string[] = [\n    'Successfully installed WorkOS AuthKit!',\n    '',\n    ...(changes.length > 0 ? ['What the agent did:', ...changes.map((c) => `• ${c}`), ''] : []),\n    ...(nextSteps.length > 0 ? ['Next steps:', ...nextSteps.map((s) => `• ${s}`), ''] : []),\n    `Learn more: ${config.metadata.docsUrl}`,\n    '',\n    'Note: This installer uses an LLM agent to analyze and modify your project. Please review the changes made.',\n  ];\n\n  await analytics.shutdown('success');\n\n  return lines.join('\\n');\n}\n"]}

package/dist/integrations/kotlin/index.d.ts

@@ -0,0 +1,4 @@
+import type { FrameworkConfig } from '../../lib/framework-config.js';
+import type { InstallerOptions } from '../../utils/types.js';
+export declare const config: FrameworkConfig;
+export declare function run(options: InstallerOptions): Promise<string>;

package/dist/integrations/kotlin/index.js

@@ -0,0 +1,53 @@
+import { enableDebugLogs } from '../../utils/debug.js';
+export const config = {
+    metadata: {
+        name: 'Kotlin (Spring Boot)',
+        integration: 'kotlin',
+        docsUrl: 'https://github.com/workos/workos-kotlin',
+        skillName: 'workos-kotlin',
+        language: 'kotlin',
+        stability: 'experimental',
+        priority: 40,
+        packageManager: 'gradle',
+        manifestFile: 'build.gradle.kts',
+    },
+    detection: {
+        packageName: 'com.workos:workos-kotlin',
+        packageDisplayName: 'Kotlin (Spring Boot)',
+        getVersion: () => undefined,
+    },
+    environment: {
+        uploadToHosting: false,
+        requiresApiKey: true,
+        getEnvVars: (apiKey, clientId) => ({
+            WORKOS_API_KEY: apiKey,
+            WORKOS_CLIENT_ID: clientId,
+        }),
+    },
+    analytics: {
+        getTags: () => ({}),
+    },
+    prompts: {},
+    ui: {
+        successMessage: 'WorkOS AuthKit integration complete',
+        getOutroChanges: () => [
+            'Analyzed your Kotlin/Spring Boot project structure',
+            'Added WorkOS Kotlin SDK dependency to build.gradle.kts',
+            'Created authentication controller with login, callback, and logout endpoints',
+            'Configured application.properties with WorkOS credentials',
+        ],
+        getOutroNextSteps: () => [
+            'Run ./gradlew bootRun to start your application',
+            'Visit http://localhost:8080/auth/login to test authentication',
+            'Visit the WorkOS Dashboard to manage users and settings',
+        ],
+    },
+};
+export async function run(options) {
+    if (options.debug) {
+        enableDebugLogs();
+    }
+    const { runAgentInstaller } = await import('../../lib/agent-runner.js');
+    return runAgentInstaller(config, options);
+}
+//# sourceMappingURL=index.js.map

package/dist/integrations/kotlin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/kotlin/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,CAAC,MAAM,MAAM,GAAoB;IACrC,QAAQ,EAAE;QACR,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,yCAAyC;QAClD,SAAS,EAAE,eAAe;QAC1B,QAAQ,EAAE,QAAQ;QAClB,SAAS,EAAE,cAAc;QACzB,QAAQ,EAAE,EAAE;QACZ,cAAc,EAAE,QAAQ;QACxB,YAAY,EAAE,kBAAkB;KACjC;IAED,SAAS,EAAE;QACT,WAAW,EAAE,0BAA0B;QACvC,kBAAkB,EAAE,sBAAsB;QAC1C,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS;KAC5B;IAED,WAAW,EAAE;QACX,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,UAAU,EAAE,CAAC,MAAc,EAAE,QAAgB,EAAE,EAAE,CAAC,CAAC;YACjD,cAAc,EAAE,MAAM;YACtB,gBAAgB,EAAE,QAAQ;SAC3B,CAAC;KACH;IAED,SAAS,EAAE;QACT,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;KACpB;IAED,OAAO,EAAE,EAAE;IAEX,EAAE,EAAE;QACF,cAAc,EAAE,qCAAqC;QACrD,eAAe,EAAE,GAAG,EAAE,CAAC;YACrB,oDAAoD;YACpD,wDAAwD;YACxD,8EAA8E;YAC9E,2DAA2D;SAC5D;QACD,iBAAiB,EAAE,GAAG,EAAE,CAAC;YACvB,iDAAiD;YACjD,+DAA+D;YAC/D,yDAAyD;SAC1D;KACF;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,OAAyB;IACjD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC;IACpB,CAAC;IAED,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IACxE,OAAO,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC","sourcesContent":["/* Kotlin (Spring Boot) integration — auto-discovered by registry */\nimport type { FrameworkConfig } from '../../lib/framework-config.js';\nimport type { InstallerOptions } from '../../utils/types.js';\nimport { enableDebugLogs } from '../../utils/debug.js';\n\nexport const config: FrameworkConfig = {\n  metadata: {\n    name: 'Kotlin (Spring Boot)',\n    integration: 'kotlin',\n    docsUrl: 'https://github.com/workos/workos-kotlin',\n    skillName: 'workos-kotlin',\n    language: 'kotlin',\n    stability: 'experimental',\n    priority: 40,\n    packageManager: 'gradle',\n    manifestFile: 'build.gradle.kts',\n  },\n\n  detection: {\n    packageName: 'com.workos:workos-kotlin',\n    packageDisplayName: 'Kotlin (Spring Boot)',\n    getVersion: () => undefined,\n  },\n\n  environment: {\n    uploadToHosting: false,\n    requiresApiKey: true,\n    getEnvVars: (apiKey: string, clientId: string) => ({\n      WORKOS_API_KEY: apiKey,\n      WORKOS_CLIENT_ID: clientId,\n    }),\n  },\n\n  analytics: {\n    getTags: () => ({}),\n  },\n\n  prompts: {},\n\n  ui: {\n    successMessage: 'WorkOS AuthKit integration complete',\n    getOutroChanges: () => [\n      'Analyzed your Kotlin/Spring Boot project structure',\n      'Added WorkOS Kotlin SDK dependency to build.gradle.kts',\n      'Created authentication controller with login, callback, and logout endpoints',\n      'Configured application.properties with WorkOS credentials',\n    ],\n    getOutroNextSteps: () => [\n      'Run ./gradlew bootRun to start your application',\n      'Visit http://localhost:8080/auth/login to test authentication',\n      'Visit the WorkOS Dashboard to manage users and settings',\n    ],\n  },\n};\n\nexport async function run(options: InstallerOptions): Promise<string> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  const { runAgentInstaller } = await import('../../lib/agent-runner.js');\n  return runAgentInstaller(config, options);\n}\n"]}

package/dist/integrations/nextjs/index.d.ts

@@ -0,0 +1,4 @@
+import type { FrameworkConfig } from '../../lib/framework-config.js';
+import type { InstallerOptions } from '../../utils/types.js';
+export declare const config: FrameworkConfig;
+export declare function run(options: InstallerOptions): Promise<string>;

package/dist/integrations/nextjs/index.js

@@ -0,0 +1,90 @@
+import { enableDebugLogs } from '../../utils/debug.js';
+import { getPackageVersion } from '../../utils/package-json.js';
+import { getPackageDotJson } from '../../utils/clack-utils.js';
+import clack from '../../utils/clack.js';
+import chalk from 'chalk';
+import * as semver from 'semver';
+import { getNextJsRouter, getNextJsVersionBucket, getNextJsRouterName, NextJsRouter } from './utils.js';
+const MINIMUM_NEXTJS_VERSION = '15.3.0';
+export const config = {
+    metadata: {
+        name: 'Next.js',
+        integration: 'nextjs',
+        docsUrl: 'https://workos.com/docs/user-management/authkit/nextjs',
+        unsupportedVersionDocsUrl: 'https://workos.com/docs/user-management/authkit/nextjs',
+        skillName: 'workos-authkit-nextjs',
+        language: 'javascript',
+        stability: 'stable',
+        priority: 100,
+        gatherContext: async (options) => {
+            const router = await getNextJsRouter(options);
+            return { router };
+        },
+    },
+    detection: {
+        packageName: 'next',
+        packageDisplayName: 'Next.js',
+        getVersion: (packageJson) => getPackageVersion('next', packageJson),
+        getVersionBucket: getNextJsVersionBucket,
+    },
+    environment: {
+        uploadToHosting: true,
+        requiresApiKey: true,
+        getEnvVars: (apiKey, clientId) => ({
+            WORKOS_API_KEY: apiKey,
+            WORKOS_CLIENT_ID: clientId,
+        }),
+    },
+    analytics: {
+        getTags: (context) => {
+            const router = context.router;
+            return {
+                router: router === NextJsRouter.APP_ROUTER ? 'app' : 'pages',
+            };
+        },
+    },
+    prompts: {
+        getAdditionalContextLines: (context) => {
+            const router = context.router;
+            const routerType = router === NextJsRouter.APP_ROUTER ? 'app' : 'pages';
+            return [`Router: ${routerType}`];
+        },
+    },
+    ui: {
+        successMessage: 'WorkOS AuthKit integration complete',
+        getOutroChanges: (context) => {
+            const router = context.router;
+            const routerName = getNextJsRouterName(router);
+            return [
+                `Analyzed your Next.js project structure (${routerName})`,
+                `Created and configured WorkOS AuthKit`,
+                `Integrated authentication into your application`,
+            ];
+        },
+        getOutroNextSteps: () => [
+            'Start your development server to test authentication',
+            'Visit the WorkOS Dashboard to manage users and settings',
+        ],
+    },
+};
+export async function run(options) {
+    if (options.debug) {
+        enableDebugLogs();
+    }
+    // Check Next.js version - agent wizard requires >= 15.3.0
+    const packageJson = await getPackageDotJson(options);
+    const nextVersion = getPackageVersion('next', packageJson);
+    if (nextVersion) {
+        const coercedVersion = semver.coerce(nextVersion);
+        if (coercedVersion && semver.lt(coercedVersion, MINIMUM_NEXTJS_VERSION)) {
+            const docsUrl = config.metadata.unsupportedVersionDocsUrl ?? config.metadata.docsUrl;
+            clack.log.warn(`Sorry: the installer can't help you with Next.js ${nextVersion}. Upgrade to Next.js ${MINIMUM_NEXTJS_VERSION} or later, or check out the manual setup guide.`);
+            clack.log.info(`Setup Next.js manually: ${chalk.cyan(docsUrl)}`);
+            clack.outro('WorkOS AuthKit installer will see you next time!');
+            return '';
+        }
+    }
+    const { runAgentInstaller } = await import('../../lib/agent-runner.js');
+    return runAgentInstaller(config, options);
+}
+//# sourceMappingURL=index.js.map

package/dist/integrations/nextjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/nextjs/index.ts"],"names":[],"mappings":"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","sourcesContent":["/* Next.js integration — auto-discovered by registry */\nimport type { FrameworkConfig } from '../../lib/framework-config.js';\nimport type { InstallerOptions } from '../../utils/types.js';\nimport { enableDebugLogs } from '../../utils/debug.js';\nimport { getPackageVersion } from '../../utils/package-json.js';\nimport { getPackageDotJson } from '../../utils/clack-utils.js';\nimport clack from '../../utils/clack.js';\nimport chalk from 'chalk';\nimport * as semver from 'semver';\nimport { getNextJsRouter, getNextJsVersionBucket, getNextJsRouterName, NextJsRouter } from './utils.js';\n\nconst MINIMUM_NEXTJS_VERSION = '15.3.0';\n\nexport const config: FrameworkConfig = {\n  metadata: {\n    name: 'Next.js',\n    integration: 'nextjs',\n    docsUrl: 'https://workos.com/docs/user-management/authkit/nextjs',\n    unsupportedVersionDocsUrl: 'https://workos.com/docs/user-management/authkit/nextjs',\n    skillName: 'workos-authkit-nextjs',\n    language: 'javascript',\n    stability: 'stable',\n    priority: 100,\n    gatherContext: async (options: InstallerOptions) => {\n      const router = await getNextJsRouter(options);\n      return { router };\n    },\n  },\n\n  detection: {\n    packageName: 'next',\n    packageDisplayName: 'Next.js',\n    getVersion: (packageJson: any) => getPackageVersion('next', packageJson),\n    getVersionBucket: getNextJsVersionBucket,\n  },\n\n  environment: {\n    uploadToHosting: true,\n    requiresApiKey: true,\n    getEnvVars: (apiKey: string, clientId: string) => ({\n      WORKOS_API_KEY: apiKey,\n      WORKOS_CLIENT_ID: clientId,\n    }),\n  },\n\n  analytics: {\n    getTags: (context: any) => {\n      const router = context.router as NextJsRouter;\n      return {\n        router: router === NextJsRouter.APP_ROUTER ? 'app' : 'pages',\n      };\n    },\n  },\n\n  prompts: {\n    getAdditionalContextLines: (context: any) => {\n      const router = context.router as NextJsRouter;\n      const routerType = router === NextJsRouter.APP_ROUTER ? 'app' : 'pages';\n      return [`Router: ${routerType}`];\n    },\n  },\n\n  ui: {\n    successMessage: 'WorkOS AuthKit integration complete',\n    getOutroChanges: (context: any) => {\n      const router = context.router as NextJsRouter;\n      const routerName = getNextJsRouterName(router);\n      return [\n        `Analyzed your Next.js project structure (${routerName})`,\n        `Created and configured WorkOS AuthKit`,\n        `Integrated authentication into your application`,\n      ];\n    },\n    getOutroNextSteps: () => [\n      'Start your development server to test authentication',\n      'Visit the WorkOS Dashboard to manage users and settings',\n    ],\n  },\n};\n\nexport async function run(options: InstallerOptions): Promise<string> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  // Check Next.js version - agent wizard requires >= 15.3.0\n  const packageJson = await getPackageDotJson(options);\n  const nextVersion = getPackageVersion('next', packageJson);\n\n  if (nextVersion) {\n    const coercedVersion = semver.coerce(nextVersion);\n    if (coercedVersion && semver.lt(coercedVersion, MINIMUM_NEXTJS_VERSION)) {\n      const docsUrl = config.metadata.unsupportedVersionDocsUrl ?? config.metadata.docsUrl;\n\n      clack.log.warn(\n        `Sorry: the installer can't help you with Next.js ${nextVersion}. Upgrade to Next.js ${MINIMUM_NEXTJS_VERSION} or later, or check out the manual setup guide.`,\n      );\n      clack.log.info(`Setup Next.js manually: ${chalk.cyan(docsUrl)}`);\n      clack.outro('WorkOS AuthKit installer will see you next time!');\n      return '';\n    }\n  }\n\n  const { runAgentInstaller } = await import('../../lib/agent-runner.js');\n  return runAgentInstaller(config, options);\n}\n"]}

package/dist/integrations/nextjs/utils.d.ts

@@ -0,0 +1,8 @@
+import type { InstallerOptions } from '../../utils/types.js';
+export declare function getNextJsVersionBucket(version: string | undefined): string;
+export declare enum NextJsRouter {
+    APP_ROUTER = "app-router",
+    PAGES_ROUTER = "pages-router"
+}
+export declare function getNextJsRouter({ installDir }: Pick<InstallerOptions, 'installDir'>): Promise<NextJsRouter>;
+export declare const getNextJsRouterName: (router: NextJsRouter) => "app router" | "pages router";