@posthog/wizard 1.19.0 → 1.21.0

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

@@ -5,12 +5,43 @@
 import clack from '../utils/clack';
 import type { WizardOptions } from '../utils/types';
 type Agent = any;
+export declare const AgentSignals: {
+    /** Signal emitted when the agent reports progress to the user */
+    readonly STATUS: "[STATUS]";
+    /** Signal emitted when the agent cannot access the PostHog MCP server */
+    readonly ERROR_MCP_MISSING: "[ERROR-MCP-MISSING]";
+    /** Signal emitted when the agent cannot access the setup resource */
+    readonly ERROR_RESOURCE_MISSING: "[ERROR-RESOURCE-MISSING]";
+};
+export type AgentSignal = (typeof AgentSignals)[keyof typeof AgentSignals];
+/**
+ * Error types that can be returned from agent execution.
+ * These correspond to the error signals that the agent emits.
+ */
+export declare enum AgentErrorType {
+    /** Agent could not access the PostHog MCP server */
+    MCP_MISSING = "WIZARD_MCP_MISSING",
+    /** Agent could not access the setup resource */
+    RESOURCE_MISSING = "WIZARD_RESOURCE_MISSING"
+}
 export type AgentConfig = {
     workingDirectory: string;
     posthogMcpUrl: string;
     posthogApiKey: string;
     debug?: boolean;
 };
+/**
+ * Permission hook that allows only safe package manager commands.
+ * This prevents the agent from running arbitrary shell commands.
+ */
+export declare function wizardCanUseTool(toolName: string, input: {
+    command?: string;
+}): {
+    behavior: 'allow';
+} | {
+    behavior: 'deny';
+    message: string;
+};
 /**
  * Initialize a PostHog Agent instance with the provided configuration
  */
@@ -18,11 +49,15 @@ export declare function initializeAgent(config: AgentConfig, options: WizardOpti
 /**
  * Execute an agent with the provided prompt and options
  * Handles the full lifecycle: spinner, execution, error handling
+ *
+ * @returns An object containing any error detected in the agent's output
  */
 export declare function runAgent(agent: Agent, prompt: string, options: WizardOptions, spinner: ReturnType<typeof clack.spinner>, config?: {
     estimatedDurationMinutes?: number;
     spinnerMessage?: string;
     successMessage?: string;
     errorMessage?: string;
-}): Promise<void>;
+}): Promise<{
+    error?: AgentErrorType;
+}>;
 export {};

package/dist/src/lib/agent-interface.js

@@ -7,6 +7,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentErrorType = exports.AgentSignals = void 0;
+exports.wizardCanUseTool = wizardCanUseTool;
 exports.initializeAgent = initializeAgent;
 exports.runAgent = runAgent;
 const clack_1 = __importDefault(require("../utils/clack"));
@@ -29,6 +31,77 @@ const EventType = {
     ERROR: 'error',
     DONE: 'done',
 };
+/**
+ * Content types for agent messages and blocks
+ */
+const ContentType = {
+    TEXT: 'text',
+    ASSISTANT: 'assistant',
+};
+exports.AgentSignals = {
+    /** Signal emitted when the agent reports progress to the user */
+    STATUS: '[STATUS]',
+    /** Signal emitted when the agent cannot access the PostHog MCP server */
+    ERROR_MCP_MISSING: '[ERROR-MCP-MISSING]',
+    /** Signal emitted when the agent cannot access the setup resource */
+    ERROR_RESOURCE_MISSING: '[ERROR-RESOURCE-MISSING]',
+};
+/**
+ * Error types that can be returned from agent execution.
+ * These correspond to the error signals that the agent emits.
+ */
+var AgentErrorType;
+(function (AgentErrorType) {
+    /** Agent could not access the PostHog MCP server */
+    AgentErrorType["MCP_MISSING"] = "WIZARD_MCP_MISSING";
+    /** Agent could not access the setup resource */
+    AgentErrorType["RESOURCE_MISSING"] = "WIZARD_RESOURCE_MISSING";
+})(AgentErrorType || (exports.AgentErrorType = AgentErrorType = {}));
+/**
+ * Allowed bash command prefixes for the wizard agent.
+ * These are package manager commands needed for PostHog installation.
+ */
+const ALLOWED_BASH_PREFIXES = [
+    // Package installation
+    'npm install',
+    'npm ci',
+    'pnpm install',
+    'pnpm add',
+    'bun install',
+    'bun add',
+    'yarn add',
+    'yarn install',
+];
+/**
+ * Permission hook that allows only safe package manager commands.
+ * This prevents the agent from running arbitrary shell commands.
+ */
+function wizardCanUseTool(toolName, input) {
+    // Allow all non-Bash tools
+    if (toolName !== 'Bash') {
+        return { behavior: 'allow' };
+    }
+    const command = (input.command ?? '').trim();
+    // Block commands with shell operators (chaining, subshells, etc.)
+    if (/[;&|`$()]/.test(command)) {
+        (0, debug_1.debug)(`Denying bash command with shell operators: ${command}`);
+        return {
+            behavior: 'deny',
+            message: `Bash command not allowed. Chained commands are not permitted.`,
+        };
+    }
+    // Check if command starts with any allowed prefix
+    const isAllowed = ALLOWED_BASH_PREFIXES.some((prefix) => command.startsWith(prefix));
+    if (isAllowed) {
+        (0, debug_1.debug)(`Allowing bash command: ${command}`);
+        return { behavior: 'allow' };
+    }
+    (0, debug_1.debug)(`Denying bash command: ${command}`);
+    return {
+        behavior: 'deny',
+        message: `Bash command not allowed. Only package manager commands (npm/pnpm/bun/yarn install) are permitted.`,
+    };
+}
 /**
  * Initialize a PostHog Agent instance with the provided configuration
  */
@@ -74,15 +147,16 @@ function handleAgentEvent(event, options, spinner) {
     // Only show [STATUS] events to the user - everything else goes to debug log
     switch (event.type) {
         case EventType.RAW_SDK_EVENT:
-            if (event.sdkMessage?.type === 'assistant') {
+            if (event.sdkMessage?.type === ContentType.ASSISTANT) {
                 const message = event.sdkMessage.message;
                 if (message?.content && Array.isArray(message.content)) {
                     const textContent = message.content
-                        .filter((block) => block.type === 'text')
+                        .filter((block) => block.type === ContentType.TEXT)
                         .map((block) => block.text)
                         .join('\n');
                     // Check if the text contains a [STATUS] marker
-                    const statusMatch = textContent.match(/^.*\[STATUS\]\s*(.+?)$/m);
+                    const statusRegex = new RegExp(`^.*${exports.AgentSignals.STATUS.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\s*(.+?)$`, 'm');
+                    const statusMatch = textContent.match(statusRegex);
                     if (statusMatch) {
                         // Stop spinner, log the status step, restart spinner
                         // This creates the progress list as the agent proceeds
@@ -145,6 +219,8 @@ function handleAgentEvent(event, options, spinner) {
 /**
  * Execute an agent with the provided prompt and options
  * Handles the full lifecycle: spinner, execution, error handling
+ *
+ * @returns An object containing any error detected in the agent's output
  */
 async function runAgent(agent, prompt, options, spinner, config) {
     const { estimatedDurationMinutes = 8, spinnerMessage = 'Customizing your PostHog setup...', successMessage = 'PostHog integration complete', errorMessage = 'Integration failed', } = config ?? {};
@@ -152,11 +228,26 @@ async function runAgent(agent, prompt, options, spinner, config) {
     clack_1.default.log.step(`This whole process should take about ${estimatedDurationMinutes} minutes including error checking and fixes.\n\nGrab some coffee!`);
     spinner.start(spinnerMessage);
     try {
-        await agent.run(prompt, {
+        const result = await agent.run(prompt, {
             repositoryPath: options.installDir,
             permissionMode: PermissionMode.ACCEPT_EDITS,
+            queryOverrides: {
+                model: 'claude-opus-4-5-20251101',
+                canUseTool: wizardCanUseTool,
+            },
         });
+        // Check for error markers in the agent's output
+        const outputText = extractTextFromResults(result.results);
+        if (outputText.includes(exports.AgentSignals.ERROR_MCP_MISSING)) {
+            spinner.stop('Agent could not access PostHog MCP');
+            return { error: AgentErrorType.MCP_MISSING };
+        }
+        if (outputText.includes(exports.AgentSignals.ERROR_RESOURCE_MISSING)) {
+            spinner.stop('Agent could not access setup resource');
+            return { error: AgentErrorType.RESOURCE_MISSING };
+        }
         spinner.stop(successMessage);
+        return {};
     }
     catch (error) {
         spinner.stop(errorMessage);
@@ -165,4 +256,28 @@ async function runAgent(agent, prompt, options, spinner, config) {
         throw error;
     }
 }
+/**
+ * Extract text content from agent execution results
+ */
+function extractTextFromResults(results) {
+    const textParts = [];
+    for (const result of results) {
+        // Handle assistant messages with content blocks
+        if (result?.type === ContentType.ASSISTANT && result.message?.content) {
+            const content = result.message.content;
+            if (Array.isArray(content)) {
+                for (const block of content) {
+                    if (block.type === ContentType.TEXT && block.text) {
+                        textParts.push(block.text);
+                    }
+                }
+            }
+        }
+        // Handle direct text content
+        if (typeof result === 'string') {
+            textParts.push(result);
+        }
+    }
+    return textParts.join('\n');
+}
 //# sourceMappingURL=agent-interface.js.map

package/dist/src/lib/agent-interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-interface.js","sourceRoot":"","sources":["../../../src/lib/agent-interface.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared agent interface for PostHog wizards\n * Provides common agent initialization and event handling\n */\n\nimport clack from '../utils/clack';\nimport { debug } from '../utils/debug';\nimport type { WizardOptions } from '../utils/types';\nimport { analytics } from '../utils/analytics';\nimport { WIZARD_INTERACTION_EVENT_NAME } from './constants';\n\nlet _agentModule: any = null;\nasync function getAgentModule(): Promise<any> {\n  if (!_agentModule) {\n    _agentModule = await import('@posthog/agent');\n  }\n  return _agentModule;\n}\n\n// Using `any` because typed imports from ESM modules require import attributes\n// syntax which prettier cannot parse. See PR discussion for details.\ntype Agent = any;\ntype AgentEvent = any;\n\n// TODO: Remove these if/when posthog/agent exports an enum for events\nconst EventType = {\n  RAW_SDK_EVENT: 'raw_sdk_event',\n  TOKEN: 'token',\n  TOOL_CALL: 'tool_call',\n  TOOL_RESULT: 'tool_result',\n  ERROR: 'error',\n  DONE: 'done',\n} as const;\n\nexport type AgentConfig = {\n  workingDirectory: string;\n  posthogMcpUrl: string;\n  posthogApiKey: string;\n  debug?: boolean;\n};\n\n/**\n * Initialize a PostHog Agent instance with the provided configuration\n */\nexport async function initializeAgent(\n  config: AgentConfig,\n  options: WizardOptions,\n  spinner: ReturnType<typeof clack.spinner>,\n): Promise<Agent> {\n  clack.log.step('Initializing PostHog agent...');\n\n  try {\n    const { Agent } = await getAgentModule();\n\n    const agentConfig = {\n      workingDirectory: config.workingDirectory,\n      posthogMcpUrl: config.posthogMcpUrl,\n      posthogApiKey: config.posthogApiKey,\n      onEvent: (event: AgentEvent) => {\n        handleAgentEvent(event, options, spinner);\n      },\n      debug: config.debug ?? false,\n    };\n\n    if (options.debug) {\n      debug('Agent config:', {\n        workingDirectory: agentConfig.workingDirectory,\n        posthogMcpUrl: agentConfig.posthogMcpUrl,\n        posthogApiKeyPresent: !!agentConfig.posthogApiKey,\n      });\n    }\n\n    const agent = new Agent(agentConfig);\n    clack.log.success(\"Agent initialized. Let's get cooking!\");\n    return agent;\n  } catch (error) {\n    clack.log.error(`Failed to initialize agent: ${(error as Error).message}`);\n    debug('Agent initialization error:', error);\n    throw error;\n  }\n}\n\n/**\n * Handle agent events and provide user feedback\n * This function processes events from the agent SDK and provides appropriate\n * user feedback through the CLI spinner and logging\n */\nfunction handleAgentEvent(\n  event: AgentEvent,\n  options: WizardOptions,\n  spinner: ReturnType<typeof clack.spinner>,\n): void {\n  if (options.debug) {\n    debug(`Event type: ${event.type}`, JSON.stringify(event, null, 2));\n  }\n\n  // Only show [STATUS] events to the user - everything else goes to debug log\n  switch (event.type) {\n    case EventType.RAW_SDK_EVENT:\n      if (event.sdkMessage?.type === 'assistant') {\n        const message = event.sdkMessage.message;\n        if (message?.content && Array.isArray(message.content)) {\n          const textContent = message.content\n            .filter((block: any) => block.type === 'text')\n            .map((block: any) => block.text)\n            .join('\\n');\n\n          // Check if the text contains a [STATUS] marker\n          const statusMatch = textContent.match(/^.*\\[STATUS\\]\\s*(.+?)$/m);\n          if (statusMatch) {\n            // Stop spinner, log the status step, restart spinner\n            // This creates the progress list as the agent proceeds\n            spinner.stop(statusMatch[1].trim());\n            spinner.start('Integrating PostHog...');\n          }\n        }\n      }\n      break;\n\n    case EventType.TOKEN:\n      if (options.debug) {\n        debug(event.content);\n      }\n      break;\n\n    case EventType.TOOL_CALL:\n      if (options.debug) {\n        debug(`Tool: ${event.toolName}`);\n        debug('  Args:', JSON.stringify(event.args, null, 2));\n      }\n      break;\n\n    case EventType.TOOL_RESULT:\n      if (options.debug) {\n        debug(`✅ ${event.toolName} completed`);\n        const resultStr: string =\n          typeof event.result === 'string'\n            ? event.result\n            : JSON.stringify(event.result, null, 2);\n        const truncated =\n          resultStr.length > 500\n            ? `${resultStr.substring(0, 500)}...`\n            : resultStr;\n        debug('  Result:', truncated);\n      }\n      break;\n\n    case EventType.ERROR:\n      // Always show errors to user\n      clack.log.error(`Error: ${event.message}`);\n      if (options.debug && event.error) {\n        debug('Error details:', event.error);\n      }\n      if (event.error instanceof Error) {\n        analytics.captureException(event.error, {\n          event_type: event.type,\n          message: event.message,\n        });\n      }\n      break;\n\n    case EventType.DONE:\n      if (event.durationMs) {\n        if (options.debug) {\n          debug(`Completed in ${Math.round(event.durationMs / 1000)}s`);\n        }\n        analytics.capture(WIZARD_INTERACTION_EVENT_NAME, {\n          action: 'agent integration completed',\n          duration_ms: event.durationMs,\n          duration_seconds: Math.round(event.durationMs / 1000),\n        });\n      }\n      break;\n  }\n}\n\n/**\n * Execute an agent with the provided prompt and options\n * Handles the full lifecycle: spinner, execution, error handling\n */\nexport async function runAgent(\n  agent: Agent,\n  prompt: string,\n  options: WizardOptions,\n  spinner: ReturnType<typeof clack.spinner>,\n  config?: {\n    estimatedDurationMinutes?: number;\n    spinnerMessage?: string;\n    successMessage?: string;\n    errorMessage?: string;\n  },\n): Promise<void> {\n  const {\n    estimatedDurationMinutes = 8,\n    spinnerMessage = 'Customizing your PostHog setup...',\n    successMessage = 'PostHog integration complete',\n    errorMessage = 'Integration failed',\n  } = config ?? {};\n  const { PermissionMode } = await getAgentModule();\n\n  clack.log.step(\n    `This whole process should take about ${estimatedDurationMinutes} minutes including error checking and fixes.\\n\\nGrab some coffee!`,\n  );\n\n  spinner.start(spinnerMessage);\n\n  try {\n    await agent.run(prompt, {\n      repositoryPath: options.installDir,\n      permissionMode: PermissionMode.ACCEPT_EDITS,\n    });\n    spinner.stop(successMessage);\n  } catch (error) {\n    spinner.stop(errorMessage);\n    clack.log.error(`Error: ${(error as Error).message}`);\n    debug('Full error:', error);\n    throw error;\n  }\n}\n"]}
+{"version":3,"file":"agent-interface.js","sourceRoot":"","sources":["../../../src/lib/agent-interface.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared agent interface for PostHog wizards\n * Provides common agent initialization and event handling\n */\n\nimport clack from '../utils/clack';\nimport { debug } from '../utils/debug';\nimport type { WizardOptions } from '../utils/types';\nimport { analytics } from '../utils/analytics';\nimport { WIZARD_INTERACTION_EVENT_NAME } from './constants';\n\nlet _agentModule: any = null;\nasync function getAgentModule(): Promise<any> {\n  if (!_agentModule) {\n    _agentModule = await import('@posthog/agent');\n  }\n  return _agentModule;\n}\n\n// Using `any` because typed imports from ESM modules require import attributes\n// syntax which prettier cannot parse. See PR discussion for details.\ntype Agent = any;\ntype AgentEvent = any;\n\n// TODO: Remove these if/when posthog/agent exports an enum for events\nconst EventType = {\n  RAW_SDK_EVENT: 'raw_sdk_event',\n  TOKEN: 'token',\n  TOOL_CALL: 'tool_call',\n  TOOL_RESULT: 'tool_result',\n  ERROR: 'error',\n  DONE: 'done',\n} as const;\n\n/**\n * Content types for agent messages and blocks\n */\nconst ContentType = {\n  TEXT: 'text',\n  ASSISTANT: 'assistant',\n} as const;\n\nexport const AgentSignals = {\n  /** Signal emitted when the agent reports progress to the user */\n  STATUS: '[STATUS]',\n  /** Signal emitted when the agent cannot access the PostHog MCP server */\n  ERROR_MCP_MISSING: '[ERROR-MCP-MISSING]',\n  /** Signal emitted when the agent cannot access the setup resource */\n  ERROR_RESOURCE_MISSING: '[ERROR-RESOURCE-MISSING]',\n} as const;\n\nexport type AgentSignal = (typeof AgentSignals)[keyof typeof AgentSignals];\n\n/**\n * Error types that can be returned from agent execution.\n * These correspond to the error signals that the agent emits.\n */\nexport enum AgentErrorType {\n  /** Agent could not access the PostHog MCP server */\n  MCP_MISSING = 'WIZARD_MCP_MISSING',\n  /** Agent could not access the setup resource */\n  RESOURCE_MISSING = 'WIZARD_RESOURCE_MISSING',\n}\n\nexport type AgentConfig = {\n  workingDirectory: string;\n  posthogMcpUrl: string;\n  posthogApiKey: string;\n  debug?: boolean;\n};\n\n/**\n * Allowed bash command prefixes for the wizard agent.\n * These are package manager commands needed for PostHog installation.\n */\nconst ALLOWED_BASH_PREFIXES = [\n  // Package installation\n  'npm install',\n  'npm ci',\n  'pnpm install',\n  'pnpm add',\n  'bun install',\n  'bun add',\n  'yarn add',\n  'yarn install',\n];\n\n/**\n * Permission hook that allows only safe package manager commands.\n * This prevents the agent from running arbitrary shell commands.\n */\nexport function wizardCanUseTool(\n  toolName: string,\n  input: { command?: string },\n): { behavior: 'allow' } | { behavior: 'deny'; message: string } {\n  // Allow all non-Bash tools\n  if (toolName !== 'Bash') {\n    return { behavior: 'allow' };\n  }\n\n  const command = (input.command ?? '').trim();\n  // Block commands with shell operators (chaining, subshells, etc.)\n  if (/[;&|`$()]/.test(command)) {\n    debug(`Denying bash command with shell operators: ${command}`);\n    return {\n      behavior: 'deny',\n      message: `Bash command not allowed. Chained commands are not permitted.`,\n    };\n  }\n\n  // Check if command starts with any allowed prefix\n  const isAllowed = ALLOWED_BASH_PREFIXES.some((prefix) =>\n    command.startsWith(prefix),\n  );\n\n  if (isAllowed) {\n    debug(`Allowing bash command: ${command}`);\n    return { behavior: 'allow' };\n  }\n\n  debug(`Denying bash command: ${command}`);\n  return {\n    behavior: 'deny',\n    message: `Bash command not allowed. Only package manager commands (npm/pnpm/bun/yarn install) are permitted.`,\n  };\n}\n\n/**\n * Initialize a PostHog Agent instance with the provided configuration\n */\nexport async function initializeAgent(\n  config: AgentConfig,\n  options: WizardOptions,\n  spinner: ReturnType<typeof clack.spinner>,\n): Promise<Agent> {\n  clack.log.step('Initializing PostHog agent...');\n\n  try {\n    const { Agent } = await getAgentModule();\n\n    const agentConfig = {\n      workingDirectory: config.workingDirectory,\n      posthogMcpUrl: config.posthogMcpUrl,\n      posthogApiKey: config.posthogApiKey,\n      onEvent: (event: AgentEvent) => {\n        handleAgentEvent(event, options, spinner);\n      },\n      debug: config.debug ?? false,\n    };\n\n    if (options.debug) {\n      debug('Agent config:', {\n        workingDirectory: agentConfig.workingDirectory,\n        posthogMcpUrl: agentConfig.posthogMcpUrl,\n        posthogApiKeyPresent: !!agentConfig.posthogApiKey,\n      });\n    }\n\n    const agent = new Agent(agentConfig);\n    clack.log.success(\"Agent initialized. Let's get cooking!\");\n    return agent;\n  } catch (error) {\n    clack.log.error(`Failed to initialize agent: ${(error as Error).message}`);\n    debug('Agent initialization error:', error);\n    throw error;\n  }\n}\n\n/**\n * Handle agent events and provide user feedback\n * This function processes events from the agent SDK and provides appropriate\n * user feedback through the CLI spinner and logging\n */\nfunction handleAgentEvent(\n  event: AgentEvent,\n  options: WizardOptions,\n  spinner: ReturnType<typeof clack.spinner>,\n): void {\n  if (options.debug) {\n    debug(`Event type: ${event.type}`, JSON.stringify(event, null, 2));\n  }\n\n  // Only show [STATUS] events to the user - everything else goes to debug log\n  switch (event.type) {\n    case EventType.RAW_SDK_EVENT:\n      if (event.sdkMessage?.type === ContentType.ASSISTANT) {\n        const message = event.sdkMessage.message;\n        if (message?.content && Array.isArray(message.content)) {\n          const textContent = message.content\n            .filter((block: any) => block.type === ContentType.TEXT)\n            .map((block: any) => block.text)\n            .join('\\n');\n\n          // Check if the text contains a [STATUS] marker\n          const statusRegex = new RegExp(\n            `^.*${AgentSignals.STATUS.replace(\n              /[.*+?^${}()|[\\]\\\\]/g,\n              '\\\\$&',\n            )}\\\\s*(.+?)$`,\n            'm',\n          );\n          const statusMatch = textContent.match(statusRegex);\n          if (statusMatch) {\n            // Stop spinner, log the status step, restart spinner\n            // This creates the progress list as the agent proceeds\n            spinner.stop(statusMatch[1].trim());\n            spinner.start('Integrating PostHog...');\n          }\n        }\n      }\n      break;\n\n    case EventType.TOKEN:\n      if (options.debug) {\n        debug(event.content);\n      }\n      break;\n\n    case EventType.TOOL_CALL:\n      if (options.debug) {\n        debug(`Tool: ${event.toolName}`);\n        debug('  Args:', JSON.stringify(event.args, null, 2));\n      }\n      break;\n\n    case EventType.TOOL_RESULT:\n      if (options.debug) {\n        debug(`✅ ${event.toolName} completed`);\n        const resultStr: string =\n          typeof event.result === 'string'\n            ? event.result\n            : JSON.stringify(event.result, null, 2);\n        const truncated =\n          resultStr.length > 500\n            ? `${resultStr.substring(0, 500)}...`\n            : resultStr;\n        debug('  Result:', truncated);\n      }\n      break;\n\n    case EventType.ERROR:\n      // Always show errors to user\n      clack.log.error(`Error: ${event.message}`);\n      if (options.debug && event.error) {\n        debug('Error details:', event.error);\n      }\n      if (event.error instanceof Error) {\n        analytics.captureException(event.error, {\n          event_type: event.type,\n          message: event.message,\n        });\n      }\n      break;\n\n    case EventType.DONE:\n      if (event.durationMs) {\n        if (options.debug) {\n          debug(`Completed in ${Math.round(event.durationMs / 1000)}s`);\n        }\n        analytics.capture(WIZARD_INTERACTION_EVENT_NAME, {\n          action: 'agent integration completed',\n          duration_ms: event.durationMs,\n          duration_seconds: Math.round(event.durationMs / 1000),\n        });\n      }\n      break;\n  }\n}\n\n/**\n * Execute an agent with the provided prompt and options\n * Handles the full lifecycle: spinner, execution, error handling\n *\n * @returns An object containing any error detected in the agent's output\n */\nexport async function runAgent(\n  agent: Agent,\n  prompt: string,\n  options: WizardOptions,\n  spinner: ReturnType<typeof clack.spinner>,\n  config?: {\n    estimatedDurationMinutes?: number;\n    spinnerMessage?: string;\n    successMessage?: string;\n    errorMessage?: string;\n  },\n): Promise<{ error?: AgentErrorType }> {\n  const {\n    estimatedDurationMinutes = 8,\n    spinnerMessage = 'Customizing your PostHog setup...',\n    successMessage = 'PostHog integration complete',\n    errorMessage = 'Integration failed',\n  } = config ?? {};\n  const { PermissionMode } = await getAgentModule();\n\n  clack.log.step(\n    `This whole process should take about ${estimatedDurationMinutes} minutes including error checking and fixes.\\n\\nGrab some coffee!`,\n  );\n\n  spinner.start(spinnerMessage);\n\n  try {\n    const result = await agent.run(prompt, {\n      repositoryPath: options.installDir,\n      permissionMode: PermissionMode.ACCEPT_EDITS,\n      queryOverrides: {\n        model: 'claude-opus-4-5-20251101',\n        canUseTool: wizardCanUseTool,\n      },\n    });\n\n    // Check for error markers in the agent's output\n    const outputText = extractTextFromResults(result.results);\n\n    if (outputText.includes(AgentSignals.ERROR_MCP_MISSING)) {\n      spinner.stop('Agent could not access PostHog MCP');\n      return { error: AgentErrorType.MCP_MISSING };\n    }\n\n    if (outputText.includes(AgentSignals.ERROR_RESOURCE_MISSING)) {\n      spinner.stop('Agent could not access setup resource');\n      return { error: AgentErrorType.RESOURCE_MISSING };\n    }\n\n    spinner.stop(successMessage);\n    return {};\n  } catch (error) {\n    spinner.stop(errorMessage);\n    clack.log.error(`Error: ${(error as Error).message}`);\n    debug('Full error:', error);\n    throw error;\n  }\n}\n\n/**\n * Extract text content from agent execution results\n */\nfunction extractTextFromResults(results: any[]): string {\n  const textParts: string[] = [];\n\n  for (const result of results) {\n    // Handle assistant messages with content blocks\n    if (result?.type === ContentType.ASSISTANT && result.message?.content) {\n      const content = result.message.content;\n      if (Array.isArray(content)) {\n        for (const block of content) {\n          if (block.type === ContentType.TEXT && block.text) {\n            textParts.push(block.text);\n          }\n        }\n      }\n    }\n\n    // Handle direct text content\n    if (typeof result === 'string') {\n      textParts.push(result);\n    }\n  }\n\n  return textParts.join('\\n');\n}\n"]}

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

@@ -0,0 +1,7 @@
+import type { FrameworkConfig } from './framework-config';
+import type { WizardOptions } from '../utils/types';
+/**
+ * Universal agent-powered wizard runner.
+ * Handles the complete flow for any framework using PostHog MCP integration.
+ */
+export declare function runAgentWizard(config: FrameworkConfig, options: WizardOptions): Promise<void>;

package/dist/src/lib/agent-runner.js

@@ -0,0 +1,201 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAgentWizard = runAgentWizard;
+const clack_utils_1 = require("../utils/clack-utils");
+const analytics_1 = require("../utils/analytics");
+const constants_1 = require("./constants");
+const clack_1 = __importDefault(require("../utils/clack"));
+const agent_interface_1 = require("./agent-interface");
+const urls_1 = require("../utils/urls");
+const chalk_1 = __importDefault(require("chalk"));
+const steps_1 = require("../steps");
+/**
+ * Universal agent-powered wizard runner.
+ * Handles the complete flow for any framework using PostHog MCP integration.
+ */
+async function runAgentWizard(config, options) {
+    // Setup phase
+    (0, clack_utils_1.printWelcome)({ wizardName: config.ui.welcomeMessage });
+    clack_1.default.log.info(`🧙 The wizard has chosen you to try the next-generation agent integration for ${config.metadata.name}.\n\nStand by for the good stuff, and let me know how it goes:\n\ndanilo@posthog.com`);
+    const aiConsent = await (0, clack_utils_1.askForAIConsent)(options);
+    if (!aiConsent) {
+        await (0, clack_utils_1.abort)(config.metadata.abortMessage, 0);
+    }
+    const cloudRegion = options.cloudRegion ?? (await (0, clack_utils_1.askForCloudRegion)());
+    const typeScriptDetected = (0, clack_utils_1.isUsingTypeScript)(options);
+    await (0, clack_utils_1.confirmContinueIfNoOrDirtyGitRepo)(options);
+    // Framework detection and version
+    const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
+    await (0, clack_utils_1.ensurePackageIsInstalled)(packageJson, config.detection.packageName, config.detection.packageDisplayName);
+    const frameworkVersion = config.detection.getVersion(packageJson);
+    // Set analytics tags for framework version
+    if (frameworkVersion && config.detection.getVersionBucket) {
+        const versionBucket = config.detection.getVersionBucket(frameworkVersion);
+        analytics_1.analytics.setTag(`${config.metadata.integration}-version`, versionBucket);
+    }
+    analytics_1.analytics.capture(constants_1.WIZARD_INTERACTION_EVENT_NAME, {
+        action: 'started agent integration',
+        integration: config.metadata.integration,
+    });
+    // Get PostHog credentials
+    const { projectApiKey, host, accessToken } = await (0, clack_utils_1.getOrAskForProjectData)({
+        ...options,
+        cloudRegion,
+    });
+    // Gather framework-specific context (e.g., Next.js router, React Native platform)
+    const frameworkContext = config.metadata.gatherContext
+        ? await config.metadata.gatherContext(options)
+        : {};
+    // Set analytics tags from framework context
+    const contextTags = config.analytics.getTags(frameworkContext);
+    Object.entries(contextTags).forEach(([key, value]) => {
+        analytics_1.analytics.setTag(key, value);
+    });
+    // Build integration prompt
+    const integrationPrompt = buildIntegrationPrompt(config, {
+        frameworkVersion: frameworkVersion || 'latest',
+        typescript: typeScriptDetected,
+        projectApiKey,
+        host,
+    }, frameworkContext);
+    // Initialize and run agent
+    const spinner = clack_1.default.spinner();
+    const agent = await (0, agent_interface_1.initializeAgent)({
+        workingDirectory: options.installDir,
+        posthogMcpUrl: 'https://mcp.posthog.com/mcp',
+        posthogApiKey: accessToken,
+        debug: false,
+    }, options, spinner);
+    const agentResult = await (0, agent_interface_1.runAgent)(agent, integrationPrompt, options, spinner, {
+        estimatedDurationMinutes: config.ui.estimatedDurationMinutes,
+        spinnerMessage: config.ui.spinnerMessage,
+        successMessage: config.ui.successMessage,
+        errorMessage: 'Integration failed',
+    });
+    // Handle error cases detected in agent output
+    if (agentResult.error === agent_interface_1.AgentErrorType.MCP_MISSING) {
+        analytics_1.analytics.captureException(new Error('Agent could not access PostHog MCP server'), {
+            integration: config.metadata.integration,
+            error_type: agent_interface_1.AgentErrorType.MCP_MISSING,
+            signal: agent_interface_1.AgentSignals.ERROR_MCP_MISSING,
+        });
+        const errorMessage = `
+${chalk_1.default.red('❌ Could not access the PostHog MCP server')}
+
+The wizard was unable to connect to the PostHog MCP server.
+This could be due to a network issue or a configuration problem.
+
+Please try again, or set up ${config.metadata.name} manually by following our documentation:
+${chalk_1.default.cyan(config.metadata.docsUrl)}`;
+        clack_1.default.outro(errorMessage);
+        await analytics_1.analytics.shutdown('error');
+        process.exit(1);
+    }
+    if (agentResult.error === agent_interface_1.AgentErrorType.RESOURCE_MISSING) {
+        analytics_1.analytics.captureException(new Error('Agent could not access setup resource'), {
+            integration: config.metadata.integration,
+            error_type: agent_interface_1.AgentErrorType.RESOURCE_MISSING,
+            signal: agent_interface_1.AgentSignals.ERROR_RESOURCE_MISSING,
+        });
+        const errorMessage = `
+${chalk_1.default.red('❌ Could not access the setup resource')}
+
+The wizard could not access the setup resource. This may indicate a version mismatch or a temporary service issue.
+
+Please try again, or set up ${config.metadata.name} manually by following our documentation:
+${chalk_1.default.cyan(config.metadata.docsUrl)}`;
+        clack_1.default.outro(errorMessage);
+        await analytics_1.analytics.shutdown('error');
+        process.exit(1);
+    }
+    // Build environment variables from OAuth credentials
+    const envVars = config.environment.getEnvVars(projectApiKey, host);
+    // Upload environment variables to hosting providers (if configured)
+    let uploadedEnvVars = [];
+    if (config.environment.uploadToHosting) {
+        uploadedEnvVars = await (0, steps_1.uploadEnvironmentVariablesStep)(envVars, {
+            integration: config.metadata.integration,
+            options,
+        });
+    }
+    // Add MCP server to clients
+    await (0, steps_1.addMCPServerToClientsStep)({
+        cloudRegion,
+        integration: config.metadata.integration,
+    });
+    // Build outro message
+    const continueUrl = options.signup
+        ? `${(0, urls_1.getCloudUrlFromRegion)(cloudRegion)}/products?source=wizard`
+        : undefined;
+    const changes = [
+        ...config.ui.getOutroChanges(frameworkContext),
+        Object.keys(envVars).length > 0
+            ? `Added environment variables to .env file`
+            : '',
+        uploadedEnvVars.length > 0
+            ? `Uploaded environment variables to your hosting provider`
+            : '',
+    ].filter(Boolean);
+    const nextSteps = [
+        ...config.ui.getOutroNextSteps(frameworkContext),
+        uploadedEnvVars.length === 0 && config.environment.uploadToHosting
+            ? `Upload your Project API key to your hosting provider`
+            : '',
+    ].filter(Boolean);
+    const outroMessage = `
+${chalk_1.default.green('Successfully installed PostHog!')}
+
+${chalk_1.default.cyan('What the agent did:')}
+${changes.map((change) => `• ${change}`).join('\n')}
+
+${chalk_1.default.yellow('Next steps:')}
+${nextSteps.map((step) => `• ${step}`).join('\n')}
+
+Learn more: ${chalk_1.default.cyan(config.metadata.docsUrl)}
+${continueUrl ? `\nContinue onboarding: ${chalk_1.default.cyan(continueUrl)}\n` : ``}
+${chalk_1.default.dim('Note: This wizard uses an LLM agent to analyze and modify your project. Please review the changes made.')}
+
+${chalk_1.default.dim(`How did this work for you? Drop me a line: danilo@posthog.com`)}`;
+    clack_1.default.outro(outroMessage);
+    await analytics_1.analytics.shutdown('success');
+}
+/**
+ * Build the integration prompt for the agent.
+ * Uses shared base prompt with optional framework-specific addendum.
+ */
+function buildIntegrationPrompt(config, context, frameworkContext) {
+    const additionalLines = config.prompts.getAdditionalContextLines
+        ? config.prompts.getAdditionalContextLines(frameworkContext)
+        : [];
+    const additionalContext = additionalLines.length > 0
+        ? '\n' + additionalLines.map((line) => `- ${line}`).join('\n')
+        : '';
+    return `You have access to the PostHog MCP server which provides an integration resource to integrate PostHog into this ${config.metadata.name} project.
+
+Project context:
+- Framework: ${config.metadata.name} ${context.frameworkVersion}
+- TypeScript: ${context.typescript ? 'Yes' : 'No'}
+- PostHog API Key: ${context.projectApiKey}
+- PostHog Host: ${context.host}${additionalContext}
+
+Instructions:
+1. Call the PostHog MCP's resource for setup: posthog://workflows/basic-integration/begin
+2. Follow all instructions provided
+3. Set up environment variables for PostHog in a .env file with the API key and host provided above, using the appropriate naming convention for ${config.metadata.name}. Make sure to use these environment variables in the code files you create instead of hardcoding the API key and host.
+
+The PostHog MCP will provide specific integration code and instructions. Please follow them carefully. Be sure to look for lockfiles to determine the appropriate package manager to use when installing PostHog. Do not manually edit the package.json file.
+
+Before beginning, confirm that you can access the PostHog MCP. If the PostHog MCP is not accessible, emit the following string:
+
+${agent_interface_1.AgentSignals.ERROR_MCP_MISSING} Could not access the PostHog MCP.
+
+If the PostHog MCP is accessible, attempt to access the setup resource. If the setup resource is not accessible, emit the following string:
+
+${agent_interface_1.AgentSignals.ERROR_RESOURCE_MISSING} Could not access the setup resource.
+
+`;
+}
+//# sourceMappingURL=agent-runner.js.map

package/dist/src/lib/agent-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner.js","sourceRoot":"","sources":["../../../src/lib/agent-runner.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FrameworkConfig } from './framework-config';\nimport type { WizardOptions } from '../utils/types';\nimport {\n  abort,\n  askForAIConsent,\n  confirmContinueIfNoOrDirtyGitRepo,\n  ensurePackageIsInstalled,\n  getOrAskForProjectData,\n  getPackageDotJson,\n  isUsingTypeScript,\n  printWelcome,\n  askForCloudRegion,\n} from '../utils/clack-utils';\nimport { analytics } from '../utils/analytics';\nimport { WIZARD_INTERACTION_EVENT_NAME } from './constants';\nimport clack from '../utils/clack';\nimport {\n  initializeAgent,\n  runAgent,\n  AgentSignals,\n  AgentErrorType,\n} from './agent-interface';\nimport { getCloudUrlFromRegion } from '../utils/urls';\nimport chalk from 'chalk';\nimport {\n  addMCPServerToClientsStep,\n  uploadEnvironmentVariablesStep,\n} from '../steps';\n\n/**\n * Universal agent-powered wizard runner.\n * Handles the complete flow for any framework using PostHog MCP integration.\n */\nexport async function runAgentWizard(\n  config: FrameworkConfig,\n  options: WizardOptions,\n): Promise<void> {\n  // Setup phase\n  printWelcome({ wizardName: config.ui.welcomeMessage });\n\n  clack.log.info(\n    `🧙 The wizard has chosen you to try the next-generation agent integration for ${config.metadata.name}.\\n\\nStand by for the good stuff, and let me know how it goes:\\n\\ndanilo@posthog.com`,\n  );\n\n  const aiConsent = await askForAIConsent(options);\n  if (!aiConsent) {\n    await abort(config.metadata.abortMessage, 0);\n  }\n\n  const cloudRegion = options.cloudRegion ?? (await askForCloudRegion());\n  const typeScriptDetected = isUsingTypeScript(options);\n\n  await confirmContinueIfNoOrDirtyGitRepo(options);\n\n  // Framework detection and version\n  const packageJson = await getPackageDotJson(options);\n  await ensurePackageIsInstalled(\n    packageJson,\n    config.detection.packageName,\n    config.detection.packageDisplayName,\n  );\n\n  const frameworkVersion = config.detection.getVersion(packageJson);\n\n  // Set analytics tags for framework version\n  if (frameworkVersion && config.detection.getVersionBucket) {\n    const versionBucket = config.detection.getVersionBucket(frameworkVersion);\n    analytics.setTag(`${config.metadata.integration}-version`, versionBucket);\n  }\n\n  analytics.capture(WIZARD_INTERACTION_EVENT_NAME, {\n    action: 'started agent integration',\n    integration: config.metadata.integration,\n  });\n\n  // Get PostHog credentials\n  const { projectApiKey, host, accessToken } = await getOrAskForProjectData({\n    ...options,\n    cloudRegion,\n  });\n\n  // Gather framework-specific context (e.g., Next.js router, React Native platform)\n  const frameworkContext = config.metadata.gatherContext\n    ? await config.metadata.gatherContext(options)\n    : {};\n\n  // Set analytics tags from framework context\n  const contextTags = config.analytics.getTags(frameworkContext);\n  Object.entries(contextTags).forEach(([key, value]) => {\n    analytics.setTag(key, value);\n  });\n\n  // Build integration prompt\n  const integrationPrompt = buildIntegrationPrompt(\n    config,\n    {\n      frameworkVersion: frameworkVersion || 'latest',\n      typescript: typeScriptDetected,\n      projectApiKey,\n      host,\n    },\n    frameworkContext,\n  );\n\n  // Initialize and run agent\n  const spinner = clack.spinner();\n  const agent = await initializeAgent(\n    {\n      workingDirectory: options.installDir,\n      posthogMcpUrl: 'https://mcp.posthog.com/mcp',\n      posthogApiKey: accessToken,\n      debug: false,\n    },\n    options,\n    spinner,\n  );\n\n  const agentResult = await runAgent(\n    agent,\n    integrationPrompt,\n    options,\n    spinner,\n    {\n      estimatedDurationMinutes: config.ui.estimatedDurationMinutes,\n      spinnerMessage: config.ui.spinnerMessage,\n      successMessage: config.ui.successMessage,\n      errorMessage: 'Integration failed',\n    },\n  );\n\n  // Handle error cases detected in agent output\n  if (agentResult.error === AgentErrorType.MCP_MISSING) {\n    analytics.captureException(\n      new Error('Agent could not access PostHog MCP server'),\n      {\n        integration: config.metadata.integration,\n        error_type: AgentErrorType.MCP_MISSING,\n        signal: AgentSignals.ERROR_MCP_MISSING,\n      },\n    );\n\n    const errorMessage = `\n${chalk.red('❌ Could not access the PostHog MCP server')}\n\nThe wizard was unable to connect to the PostHog MCP server.\nThis could be due to a network issue or a configuration problem.\n\nPlease try again, or set up ${\n      config.metadata.name\n    } manually by following our documentation:\n${chalk.cyan(config.metadata.docsUrl)}`;\n\n    clack.outro(errorMessage);\n    await analytics.shutdown('error');\n    process.exit(1);\n  }\n\n  if (agentResult.error === AgentErrorType.RESOURCE_MISSING) {\n    analytics.captureException(\n      new Error('Agent could not access setup resource'),\n      {\n        integration: config.metadata.integration,\n        error_type: AgentErrorType.RESOURCE_MISSING,\n        signal: AgentSignals.ERROR_RESOURCE_MISSING,\n      },\n    );\n\n    const errorMessage = `\n${chalk.red('❌ Could not access the setup resource')}\n\nThe wizard could not access the setup resource. This may indicate a version mismatch or a temporary service issue.\n\nPlease try again, or set up ${\n      config.metadata.name\n    } manually by following our documentation:\n${chalk.cyan(config.metadata.docsUrl)}`;\n\n    clack.outro(errorMessage);\n    await analytics.shutdown('error');\n    process.exit(1);\n  }\n\n  // Build environment variables from OAuth credentials\n  const envVars = config.environment.getEnvVars(projectApiKey, host);\n\n  // Upload environment variables to hosting providers (if configured)\n  let uploadedEnvVars: string[] = [];\n  if (config.environment.uploadToHosting) {\n    uploadedEnvVars = await uploadEnvironmentVariablesStep(envVars, {\n      integration: config.metadata.integration,\n      options,\n    });\n  }\n\n  // Add MCP server to clients\n  await addMCPServerToClientsStep({\n    cloudRegion,\n    integration: config.metadata.integration,\n  });\n\n  // Build outro message\n  const continueUrl = options.signup\n    ? `${getCloudUrlFromRegion(cloudRegion)}/products?source=wizard`\n    : undefined;\n\n  const changes = [\n    ...config.ui.getOutroChanges(frameworkContext),\n    Object.keys(envVars).length > 0\n      ? `Added environment variables to .env file`\n      : '',\n    uploadedEnvVars.length > 0\n      ? `Uploaded environment variables to your hosting provider`\n      : '',\n  ].filter(Boolean);\n\n  const nextSteps = [\n    ...config.ui.getOutroNextSteps(frameworkContext),\n    uploadedEnvVars.length === 0 && config.environment.uploadToHosting\n      ? `Upload your Project API key to your hosting provider`\n      : '',\n  ].filter(Boolean);\n\n  const outroMessage = `\n${chalk.green('Successfully installed PostHog!')}\n\n${chalk.cyan('What the agent did:')}\n${changes.map((change) => `• ${change}`).join('\\n')}\n\n${chalk.yellow('Next steps:')}\n${nextSteps.map((step) => `• ${step}`).join('\\n')}\n\nLearn more: ${chalk.cyan(config.metadata.docsUrl)}\n${continueUrl ? `\\nContinue onboarding: ${chalk.cyan(continueUrl)}\\n` : ``}\n${chalk.dim(\n  'Note: This wizard uses an LLM agent to analyze and modify your project. Please review the changes made.',\n)}\n\n${chalk.dim(`How did this work for you? Drop me a line: danilo@posthog.com`)}`;\n\n  clack.outro(outroMessage);\n\n  await analytics.shutdown('success');\n}\n\n/**\n * Build the integration prompt for the agent.\n * Uses shared base prompt with optional framework-specific addendum.\n */\nfunction buildIntegrationPrompt(\n  config: FrameworkConfig,\n  context: {\n    frameworkVersion: string;\n    typescript: boolean;\n    projectApiKey: string;\n    host: string;\n  },\n  frameworkContext: Record<string, any>,\n): string {\n  const additionalLines = config.prompts.getAdditionalContextLines\n    ? config.prompts.getAdditionalContextLines(frameworkContext)\n    : [];\n\n  const additionalContext =\n    additionalLines.length > 0\n      ? '\\n' + additionalLines.map((line) => `- ${line}`).join('\\n')\n      : '';\n\n  return `You have access to the PostHog MCP server which provides an integration resource to integrate PostHog into this ${\n    config.metadata.name\n  } project.\n\nProject context:\n- Framework: ${config.metadata.name} ${context.frameworkVersion}\n- TypeScript: ${context.typescript ? 'Yes' : 'No'}\n- PostHog API Key: ${context.projectApiKey}\n- PostHog Host: ${context.host}${additionalContext}\n\nInstructions:\n1. Call the PostHog MCP's resource for setup: posthog://workflows/basic-integration/begin\n2. Follow all instructions provided\n3. Set up environment variables for PostHog in a .env file with the API key and host provided above, using the appropriate naming convention for ${\n    config.metadata.name\n  }. Make sure to use these environment variables in the code files you create instead of hardcoding the API key and host.\n\nThe PostHog MCP will provide specific integration code and instructions. Please follow them carefully. Be sure to look for lockfiles to determine the appropriate package manager to use when installing PostHog. Do not manually edit the package.json file.\n\nBefore beginning, confirm that you can access the PostHog MCP. If the PostHog MCP is not accessible, emit the following string:\n\n${AgentSignals.ERROR_MCP_MISSING} Could not access the PostHog MCP.\n\nIf the PostHog MCP is accessible, attempt to access the setup resource. If the setup resource is not accessible, emit the following string:\n\n${AgentSignals.ERROR_RESOURCE_MISSING} Could not access the setup resource.\n\n`;\n}\n"]}

package/dist/src/lib/constants.d.ts

@@ -29,6 +29,7 @@ export declare const ISSUES_URL = "https://github.com/posthog/wizard/issues";
 export declare const DEFAULT_HOST_URL: string;
 export declare const ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY = "sTMFPsFhdP1Ssg";
 export declare const ANALYTICS_HOST_URL = "https://internal-j.posthog.com";
+export declare const ANALYTICS_TEAM_TAG = "docs-and-wizard";
 export declare const DUMMY_PROJECT_API_KEY = "_YOUR_POSTHOG_PROJECT_API_KEY_";
 export declare const POSTHOG_US_CLIENT_ID = "c4Rdw8DIxgtQfA80IiSnGKlNX8QN00cFWF00QQhM";
 export declare const POSTHOG_EU_CLIENT_ID = "bx2C5sZRN03TkdjraCcetvQFPGH6N2Y9vRLkcKEy";

package/dist/src/lib/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WIZARD_INTERACTION_EVENT_NAME = exports.OAUTH_PORT = exports.POSTHOG_DEV_CLIENT_ID = exports.POSTHOG_EU_CLIENT_ID = exports.POSTHOG_US_CLIENT_ID = exports.DUMMY_PROJECT_API_KEY = exports.ANALYTICS_HOST_URL = exports.ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY = exports.DEFAULT_HOST_URL = exports.ISSUES_URL = exports.DEFAULT_URL = exports.DEBUG = exports.IS_DEV = exports.WizardVariant = exports.FeatureFlagDefinition = exports.Integration = void 0;
+exports.WIZARD_INTERACTION_EVENT_NAME = exports.OAUTH_PORT = exports.POSTHOG_DEV_CLIENT_ID = exports.POSTHOG_EU_CLIENT_ID = exports.POSTHOG_US_CLIENT_ID = exports.DUMMY_PROJECT_API_KEY = exports.ANALYTICS_TEAM_TAG = exports.ANALYTICS_HOST_URL = exports.ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY = exports.DEFAULT_HOST_URL = exports.ISSUES_URL = exports.DEFAULT_URL = exports.DEBUG = exports.IS_DEV = exports.WizardVariant = exports.FeatureFlagDefinition = exports.Integration = void 0;
 exports.getIntegrationDescription = getIntegrationDescription;
 exports.getIntegrationChoices = getIntegrationChoices;
 var Integration;
@@ -53,6 +53,7 @@ exports.DEFAULT_HOST_URL = exports.IS_DEV
     : 'https://us.i.posthog.com';
 exports.ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY = 'sTMFPsFhdP1Ssg';
 exports.ANALYTICS_HOST_URL = 'https://internal-j.posthog.com';
+exports.ANALYTICS_TEAM_TAG = 'docs-and-wizard';
 exports.DUMMY_PROJECT_API_KEY = '_YOUR_POSTHOG_PROJECT_API_KEY_';
 exports.POSTHOG_US_CLIENT_ID = 'c4Rdw8DIxgtQfA80IiSnGKlNX8QN00cFWF00QQhM';
 exports.POSTHOG_EU_CLIENT_ID = 'bx2C5sZRN03TkdjraCcetvQFPGH6N2Y9vRLkcKEy';

package/dist/src/lib/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/lib/constants.ts"],"names":[],"mappings":";;;AAiBA,8DAeC;AAOD,sDAKC;AA5CD,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,8BAAe,CAAA;IACf,gCAAiB,CAAA;IACjB,2CAA4B,CAAA;IAC5B,8BAAe,CAAA;AACjB,CAAC,EANW,WAAW,2BAAX,WAAW,QAMtB;AAED,IAAY,qBAEX;AAFD,WAAY,qBAAqB;IAC/B,kDAAyB,CAAA;AAC3B,CAAC,EAFW,qBAAqB,qCAArB,qBAAqB,QAEhC;AAED,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,kCAAiB,CAAA;IACjB,gCAAe,CAAA;AACjB,CAAC,EAHW,aAAa,6BAAb,aAAa,QAGxB;AAED,SAAgB,yBAAyB,CAAC,IAAY;IACpD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,WAAW,CAAC,MAAM;YACrB,OAAO,SAAS,CAAC;QACnB,KAAK,WAAW,CAAC,KAAK;YACpB,OAAO,OAAO,CAAC;QACjB,KAAK,WAAW,CAAC,WAAW;YAC1B,OAAO,cAAc,CAAC;QACxB,KAAK,WAAW,CAAC,MAAM;YACrB,OAAO,QAAQ,CAAC;QAClB,KAAK,WAAW,CAAC,KAAK;YACpB,OAAO,OAAO,CAAC;QACjB;YACE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAOD,SAAgB,qBAAqB;IACnC,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC;QACrC,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC,CAAC;AACN,CAAC;AAOY,QAAA,MAAM,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,QAAQ,CACpD,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAC3B,CAAC;AAEW,QAAA,KAAK,GAAG,KAAK,CAAC;AAEd,QAAA,WAAW,GAAG,cAAM;IAC/B,CAAC,CAAC,uBAAuB;IACzB,CAAC,CAAC,wBAAwB,CAAC;AAChB,QAAA,UAAU,GAAG,0CAA0C,CAAC;AACxD,QAAA,gBAAgB,GAAG,cAAM;IACpC,CAAC,CAAC,uBAAuB;IACzB,CAAC,CAAC,0BAA0B,CAAC;AAClB,QAAA,0CAA0C,GAAG,gBAAgB,CAAC;AAC9D,QAAA,kBAAkB,GAAG,gCAAgC,CAAC;AACtD,QAAA,qBAAqB,GAAG,gCAAgC,CAAC;AAEzD,QAAA,oBAAoB,GAAG,0CAA0C,CAAC;AAClE,QAAA,oBAAoB,GAAG,0CAA0C,CAAC;AAClE,QAAA,qBAAqB,GAAG,0CAA0C,CAAC;AACnE,QAAA,UAAU,GAAG,IAAI,CAAC;AAElB,QAAA,6BAA6B,GAAG,oBAAoB,CAAC","sourcesContent":["export enum Integration {\n  nextjs = 'nextjs',\n  react = 'react',\n  svelte = 'svelte',\n  reactNative = 'react-native',\n  astro = 'astro',\n}\n\nexport enum FeatureFlagDefinition {\n  NextV2 = 'wizard-next-v2',\n}\n\nexport enum WizardVariant {\n  Legacy = 'legacy',\n  Agent = 'agent',\n}\n\nexport function getIntegrationDescription(type: string): string {\n  switch (type) {\n    case Integration.nextjs:\n      return 'Next.js';\n    case Integration.react:\n      return 'React';\n    case Integration.reactNative:\n      return 'React Native';\n    case Integration.svelte:\n      return 'Svelte';\n    case Integration.astro:\n      return 'Astro';\n    default:\n      throw new Error(`Unknown integration ${type}`);\n  }\n}\n\ntype IntegrationChoice = {\n  name: string;\n  value: string;\n};\n\nexport function getIntegrationChoices(): IntegrationChoice[] {\n  return Object.keys(Integration).map((type: string) => ({\n    name: getIntegrationDescription(type),\n    value: type,\n  }));\n}\n\nexport interface Args {\n  debug: boolean;\n  integration: Integration;\n}\n\nexport const IS_DEV = ['test', 'development'].includes(\n  process.env.NODE_ENV ?? '',\n);\n\nexport const DEBUG = false;\n\nexport const DEFAULT_URL = IS_DEV\n  ? 'http://localhost:8010'\n  : 'https://us.posthog.com';\nexport const ISSUES_URL = 'https://github.com/posthog/wizard/issues';\nexport const DEFAULT_HOST_URL = IS_DEV\n  ? 'http://localhost:8010'\n  : 'https://us.i.posthog.com';\nexport const ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY = 'sTMFPsFhdP1Ssg';\nexport const ANALYTICS_HOST_URL = 'https://internal-j.posthog.com';\nexport const DUMMY_PROJECT_API_KEY = '_YOUR_POSTHOG_PROJECT_API_KEY_';\n\nexport const POSTHOG_US_CLIENT_ID = 'c4Rdw8DIxgtQfA80IiSnGKlNX8QN00cFWF00QQhM';\nexport const POSTHOG_EU_CLIENT_ID = 'bx2C5sZRN03TkdjraCcetvQFPGH6N2Y9vRLkcKEy';\nexport const POSTHOG_DEV_CLIENT_ID = 'DC5uRLVbGI02YQ82grxgnK6Qn12SXWpCqdPb60oZ';\nexport const OAUTH_PORT = 8239;\n\nexport const WIZARD_INTERACTION_EVENT_NAME = 'wizard interaction';\n"]}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/lib/constants.ts"],"names":[],"mappings":";;;AAiBA,8DAeC;AAOD,sDAKC;AA5CD,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,8BAAe,CAAA;IACf,gCAAiB,CAAA;IACjB,2CAA4B,CAAA;IAC5B,8BAAe,CAAA;AACjB,CAAC,EANW,WAAW,2BAAX,WAAW,QAMtB;AAED,IAAY,qBAEX;AAFD,WAAY,qBAAqB;IAC/B,kDAAyB,CAAA;AAC3B,CAAC,EAFW,qBAAqB,qCAArB,qBAAqB,QAEhC;AAED,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,kCAAiB,CAAA;IACjB,gCAAe,CAAA;AACjB,CAAC,EAHW,aAAa,6BAAb,aAAa,QAGxB;AAED,SAAgB,yBAAyB,CAAC,IAAY;IACpD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,WAAW,CAAC,MAAM;YACrB,OAAO,SAAS,CAAC;QACnB,KAAK,WAAW,CAAC,KAAK;YACpB,OAAO,OAAO,CAAC;QACjB,KAAK,WAAW,CAAC,WAAW;YAC1B,OAAO,cAAc,CAAC;QACxB,KAAK,WAAW,CAAC,MAAM;YACrB,OAAO,QAAQ,CAAC;QAClB,KAAK,WAAW,CAAC,KAAK;YACpB,OAAO,OAAO,CAAC;QACjB;YACE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAOD,SAAgB,qBAAqB;IACnC,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC;QACrC,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC,CAAC;AACN,CAAC;AAOY,QAAA,MAAM,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,QAAQ,CACpD,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAC3B,CAAC;AAEW,QAAA,KAAK,GAAG,KAAK,CAAC;AAEd,QAAA,WAAW,GAAG,cAAM;IAC/B,CAAC,CAAC,uBAAuB;IACzB,CAAC,CAAC,wBAAwB,CAAC;AAChB,QAAA,UAAU,GAAG,0CAA0C,CAAC;AACxD,QAAA,gBAAgB,GAAG,cAAM;IACpC,CAAC,CAAC,uBAAuB;IACzB,CAAC,CAAC,0BAA0B,CAAC;AAClB,QAAA,0CAA0C,GAAG,gBAAgB,CAAC;AAC9D,QAAA,kBAAkB,GAAG,gCAAgC,CAAC;AACtD,QAAA,kBAAkB,GAAG,iBAAiB,CAAC;AACvC,QAAA,qBAAqB,GAAG,gCAAgC,CAAC;AAEzD,QAAA,oBAAoB,GAAG,0CAA0C,CAAC;AAClE,QAAA,oBAAoB,GAAG,0CAA0C,CAAC;AAClE,QAAA,qBAAqB,GAAG,0CAA0C,CAAC;AACnE,QAAA,UAAU,GAAG,IAAI,CAAC;AAElB,QAAA,6BAA6B,GAAG,oBAAoB,CAAC","sourcesContent":["export enum Integration {\n  nextjs = 'nextjs',\n  react = 'react',\n  svelte = 'svelte',\n  reactNative = 'react-native',\n  astro = 'astro',\n}\n\nexport enum FeatureFlagDefinition {\n  NextV2 = 'wizard-next-v2',\n}\n\nexport enum WizardVariant {\n  Legacy = 'legacy',\n  Agent = 'agent',\n}\n\nexport function getIntegrationDescription(type: string): string {\n  switch (type) {\n    case Integration.nextjs:\n      return 'Next.js';\n    case Integration.react:\n      return 'React';\n    case Integration.reactNative:\n      return 'React Native';\n    case Integration.svelte:\n      return 'Svelte';\n    case Integration.astro:\n      return 'Astro';\n    default:\n      throw new Error(`Unknown integration ${type}`);\n  }\n}\n\ntype IntegrationChoice = {\n  name: string;\n  value: string;\n};\n\nexport function getIntegrationChoices(): IntegrationChoice[] {\n  return Object.keys(Integration).map((type: string) => ({\n    name: getIntegrationDescription(type),\n    value: type,\n  }));\n}\n\nexport interface Args {\n  debug: boolean;\n  integration: Integration;\n}\n\nexport const IS_DEV = ['test', 'development'].includes(\n  process.env.NODE_ENV ?? '',\n);\n\nexport const DEBUG = false;\n\nexport const DEFAULT_URL = IS_DEV\n  ? 'http://localhost:8010'\n  : 'https://us.posthog.com';\nexport const ISSUES_URL = 'https://github.com/posthog/wizard/issues';\nexport const DEFAULT_HOST_URL = IS_DEV\n  ? 'http://localhost:8010'\n  : 'https://us.i.posthog.com';\nexport const ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY = 'sTMFPsFhdP1Ssg';\nexport const ANALYTICS_HOST_URL = 'https://internal-j.posthog.com';\nexport const ANALYTICS_TEAM_TAG = 'docs-and-wizard';\nexport const DUMMY_PROJECT_API_KEY = '_YOUR_POSTHOG_PROJECT_API_KEY_';\n\nexport const POSTHOG_US_CLIENT_ID = 'c4Rdw8DIxgtQfA80IiSnGKlNX8QN00cFWF00QQhM';\nexport const POSTHOG_EU_CLIENT_ID = 'bx2C5sZRN03TkdjraCcetvQFPGH6N2Y9vRLkcKEy';\nexport const POSTHOG_DEV_CLIENT_ID = 'DC5uRLVbGI02YQ82grxgnK6Qn12SXWpCqdPb60oZ';\nexport const OAUTH_PORT = 8239;\n\nexport const WIZARD_INTERACTION_EVENT_NAME = 'wizard interaction';\n"]}