@posthog/wizard 1.33.0 → 1.35.0

package/dist/bin.js

@@ -71,6 +71,10 @@ if (process.env.NODE_ENV === 'test') {
         describe: 'PostHog personal API key (phx_xxx) for authentication\nenv: POSTHOG_WIZARD_API_KEY',
         type: 'string',
     },
+    'project-id': {
+        describe: 'PostHog project ID to use (optional; when not set, uses default from API key or OAuth)\nenv: POSTHOG_WIZARD_PROJECT_ID',
+        type: 'string',
+    },
 })
     .command(['$0'], 'Run the PostHog setup wizard', (yargs) => {
     return yargs.options({
@@ -101,6 +105,11 @@ if (process.env.NODE_ENV === 'test') {
             describe: 'Show menu for manual integration selection instead of auto-detecting\nenv: POSTHOG_WIZARD_MENU',
             type: 'boolean',
         },
+        benchmark: {
+            default: false,
+            describe: 'Run in benchmark mode with per-phase token tracking\nenv: POSTHOG_WIZARD_BENCHMARK',
+            type: 'boolean',
+        },
     });
 }, (argv) => {
     const options = { ...argv };

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../bin.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\nimport { satisfies } from 'semver';\nimport { red } from './src/utils/logging';\n\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\nimport chalk from 'chalk';\n\nconst NODE_VERSION_RANGE = '>=18.17.0';\n\n// Have to run this above the other imports because they are importing clack that\n// has the problematic imports.\nif (!satisfies(process.version, NODE_VERSION_RANGE)) {\n  red(\n    `PostHog wizard requires Node.js ${NODE_VERSION_RANGE}. You are using Node.js ${process.version}. Please upgrade your Node.js version.`,\n  );\n  process.exit(1);\n}\n\nimport { runMCPInstall, runMCPRemove } from './src/mcp';\nimport type { CloudRegion, WizardOptions } from './src/utils/types';\nimport { runWizard } from './src/run';\nimport { isNonInteractiveEnvironment } from './src/utils/environment';\nimport clack from './src/utils/clack';\n\nif (process.env.NODE_ENV === 'test') {\n  void (async () => {\n    try {\n      const { server } = await import('./e2e-tests/mocks/server.js');\n      server.listen({\n        onUnhandledRequest: 'bypass',\n      });\n    } catch (error) {\n      // Mock server import failed - this can happen during non-E2E tests\n    }\n  })();\n}\n\nyargs(hideBin(process.argv))\n  .env('POSTHOG_WIZARD')\n  // global options\n  .options({\n    debug: {\n      default: false,\n      describe: 'Enable verbose logging\\nenv: POSTHOG_WIZARD_DEBUG',\n      type: 'boolean',\n    },\n    region: {\n      describe: 'PostHog cloud region\\nenv: POSTHOG_WIZARD_REGION',\n      choices: ['us', 'eu'],\n      type: 'string',\n    },\n    default: {\n      default: true,\n      describe:\n        'Use default options for all prompts\\nenv: POSTHOG_WIZARD_DEFAULT',\n      type: 'boolean',\n    },\n    signup: {\n      default: false,\n      describe:\n        'Create a new PostHog account during setup\\nenv: POSTHOG_WIZARD_SIGNUP',\n      type: 'boolean',\n    },\n    'local-mcp': {\n      default: false,\n      describe:\n        'Use local MCP server at http://localhost:8787/mcp\\nenv: POSTHOG_WIZARD_LOCAL_MCP',\n      type: 'boolean',\n    },\n    ci: {\n      default: false,\n      describe:\n        'Enable CI mode for non-interactive execution\\nenv: POSTHOG_WIZARD_CI',\n      type: 'boolean',\n    },\n    'api-key': {\n      describe:\n        'PostHog personal API key (phx_xxx) for authentication\\nenv: POSTHOG_WIZARD_API_KEY',\n      type: 'string',\n    },\n  })\n  .command(\n    ['$0'],\n    'Run the PostHog setup wizard',\n    (yargs) => {\n      return yargs.options({\n        'force-install': {\n          default: false,\n          describe:\n            'Force install packages even if peer dependency checks fail\\nenv: POSTHOG_WIZARD_FORCE_INSTALL',\n          type: 'boolean',\n        },\n        'install-dir': {\n          describe:\n            'Directory to install PostHog in\\nenv: POSTHOG_WIZARD_INSTALL_DIR',\n          type: 'string',\n        },\n        integration: {\n          describe: 'Integration to set up',\n          choices: [\n            'nextjs',\n            'astro',\n            'react',\n            'svelte',\n            'react-native',\n            'tanstack-router',\n            'tanstack-start',\n          ],\n          type: 'string',\n        },\n        menu: {\n          default: false,\n          describe:\n            'Show menu for manual integration selection instead of auto-detecting\\nenv: POSTHOG_WIZARD_MENU',\n          type: 'boolean',\n        },\n      });\n    },\n    (argv) => {\n      const options = { ...argv };\n\n      // CI mode validation and TTY check\n      if (options.ci) {\n        // Validate required CI flags\n        if (!options.region) {\n          clack.intro(chalk.inverse(`PostHog Wizard`));\n          clack.log.error('CI mode requires --region (us or eu)');\n          process.exit(1);\n        }\n        if (!options.apiKey) {\n          clack.intro(chalk.inverse(`PostHog Wizard`));\n          clack.log.error(\n            'CI mode requires --api-key (personal API key phx_xxx)',\n          );\n          process.exit(1);\n        }\n        if (!options.installDir) {\n          clack.intro(chalk.inverse(`PostHog Wizard`));\n          clack.log.error(\n            'CI mode requires --install-dir (directory to install PostHog in)',\n          );\n          process.exit(1);\n        }\n      } else if (isNonInteractiveEnvironment()) {\n        // Original TTY error for non-CI mode\n        clack.intro(chalk.inverse(`PostHog Wizard`));\n        clack.log.error(\n          'This installer requires an interactive terminal (TTY) to run.\\n' +\n            'It appears you are running in a non-interactive environment.\\n' +\n            'Please run the wizard in an interactive terminal.\\n\\n' +\n            'For CI/CD environments, use --ci mode:\\n' +\n            '  npx @posthog/wizard --ci --region us --api-key phx_xxx',\n        );\n        process.exit(1);\n      }\n\n      void runWizard(options as unknown as WizardOptions);\n    },\n  )\n  .command('mcp <command>', 'MCP server management commands', (yargs) => {\n    return yargs\n      .command(\n        'add',\n        'Install PostHog MCP server to supported clients',\n        (yargs) => {\n          return yargs.options({\n            local: {\n              default: false,\n              describe:\n                'Add local development MCP server (http://localhost:8787)',\n              type: 'boolean',\n            },\n          });\n        },\n        (argv) => {\n          const options = { ...argv };\n          void runMCPInstall(\n            options as unknown as {\n              signup: boolean;\n              region?: CloudRegion;\n              local?: boolean;\n              debug?: boolean;\n            },\n          );\n        },\n      )\n      .command(\n        'remove',\n        'Remove PostHog MCP server from supported clients',\n        (yargs) => {\n          return yargs.options({\n            local: {\n              default: false,\n              describe:\n                'Remove local development MCP server (http://localhost:8787)',\n              type: 'boolean',\n            },\n          });\n        },\n        (argv) => {\n          const options = { ...argv };\n          void runMCPRemove(options as { local?: boolean });\n        },\n      )\n      .demandCommand(1, 'You must specify a subcommand (add or remove)')\n      .help();\n  })\n  .help()\n  .alias('help', 'h')\n  .version()\n  .alias('version', 'v')\n  .wrap(process.stdout.isTTY ? yargs.terminalWidth() : 80).argv;\n"]}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../bin.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\nimport { satisfies } from 'semver';\nimport { red } from './src/utils/logging';\n\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\nimport chalk from 'chalk';\n\nconst NODE_VERSION_RANGE = '>=18.17.0';\n\n// Have to run this above the other imports because they are importing clack that\n// has the problematic imports.\nif (!satisfies(process.version, NODE_VERSION_RANGE)) {\n  red(\n    `PostHog wizard requires Node.js ${NODE_VERSION_RANGE}. You are using Node.js ${process.version}. Please upgrade your Node.js version.`,\n  );\n  process.exit(1);\n}\n\nimport { runMCPInstall, runMCPRemove } from './src/mcp';\nimport type { CloudRegion } from './src/utils/types';\nimport { runWizard } from './src/run';\nimport { isNonInteractiveEnvironment } from './src/utils/environment';\nimport clack from './src/utils/clack';\n\nif (process.env.NODE_ENV === 'test') {\n  void (async () => {\n    try {\n      const { server } = await import('./e2e-tests/mocks/server.js');\n      server.listen({\n        onUnhandledRequest: 'bypass',\n      });\n    } catch (error) {\n      // Mock server import failed - this can happen during non-E2E tests\n    }\n  })();\n}\n\nyargs(hideBin(process.argv))\n  .env('POSTHOG_WIZARD')\n  // global options\n  .options({\n    debug: {\n      default: false,\n      describe: 'Enable verbose logging\\nenv: POSTHOG_WIZARD_DEBUG',\n      type: 'boolean',\n    },\n    region: {\n      describe: 'PostHog cloud region\\nenv: POSTHOG_WIZARD_REGION',\n      choices: ['us', 'eu'],\n      type: 'string',\n    },\n    default: {\n      default: true,\n      describe:\n        'Use default options for all prompts\\nenv: POSTHOG_WIZARD_DEFAULT',\n      type: 'boolean',\n    },\n    signup: {\n      default: false,\n      describe:\n        'Create a new PostHog account during setup\\nenv: POSTHOG_WIZARD_SIGNUP',\n      type: 'boolean',\n    },\n    'local-mcp': {\n      default: false,\n      describe:\n        'Use local MCP server at http://localhost:8787/mcp\\nenv: POSTHOG_WIZARD_LOCAL_MCP',\n      type: 'boolean',\n    },\n    ci: {\n      default: false,\n      describe:\n        'Enable CI mode for non-interactive execution\\nenv: POSTHOG_WIZARD_CI',\n      type: 'boolean',\n    },\n    'api-key': {\n      describe:\n        'PostHog personal API key (phx_xxx) for authentication\\nenv: POSTHOG_WIZARD_API_KEY',\n      type: 'string',\n    },\n    'project-id': {\n      describe:\n        'PostHog project ID to use (optional; when not set, uses default from API key or OAuth)\\nenv: POSTHOG_WIZARD_PROJECT_ID',\n      type: 'string',\n    },\n  })\n  .command(\n    ['$0'],\n    'Run the PostHog setup wizard',\n    (yargs) => {\n      return yargs.options({\n        'force-install': {\n          default: false,\n          describe:\n            'Force install packages even if peer dependency checks fail\\nenv: POSTHOG_WIZARD_FORCE_INSTALL',\n          type: 'boolean',\n        },\n        'install-dir': {\n          describe:\n            'Directory to install PostHog in\\nenv: POSTHOG_WIZARD_INSTALL_DIR',\n          type: 'string',\n        },\n        integration: {\n          describe: 'Integration to set up',\n          choices: [\n            'nextjs',\n            'astro',\n            'react',\n            'svelte',\n            'react-native',\n            'tanstack-router',\n            'tanstack-start',\n          ],\n          type: 'string',\n        },\n        menu: {\n          default: false,\n          describe:\n            'Show menu for manual integration selection instead of auto-detecting\\nenv: POSTHOG_WIZARD_MENU',\n          type: 'boolean',\n        },\n        benchmark: {\n          default: false,\n          describe:\n            'Run in benchmark mode with per-phase token tracking\\nenv: POSTHOG_WIZARD_BENCHMARK',\n          type: 'boolean',\n        },\n      });\n    },\n    (argv) => {\n      const options = { ...argv };\n\n      // CI mode validation and TTY check\n      if (options.ci) {\n        // Validate required CI flags\n        if (!options.region) {\n          clack.intro(chalk.inverse(`PostHog Wizard`));\n          clack.log.error('CI mode requires --region (us or eu)');\n          process.exit(1);\n        }\n        if (!options.apiKey) {\n          clack.intro(chalk.inverse(`PostHog Wizard`));\n          clack.log.error(\n            'CI mode requires --api-key (personal API key phx_xxx)',\n          );\n          process.exit(1);\n        }\n        if (!options.installDir) {\n          clack.intro(chalk.inverse(`PostHog Wizard`));\n          clack.log.error(\n            'CI mode requires --install-dir (directory to install PostHog in)',\n          );\n          process.exit(1);\n        }\n      } else if (isNonInteractiveEnvironment()) {\n        // Original TTY error for non-CI mode\n        clack.intro(chalk.inverse(`PostHog Wizard`));\n        clack.log.error(\n          'This installer requires an interactive terminal (TTY) to run.\\n' +\n            'It appears you are running in a non-interactive environment.\\n' +\n            'Please run the wizard in an interactive terminal.\\n\\n' +\n            'For CI/CD environments, use --ci mode:\\n' +\n            '  npx @posthog/wizard --ci --region us --api-key phx_xxx',\n        );\n        process.exit(1);\n      }\n\n      void runWizard(options as unknown as Parameters<typeof runWizard>[0]);\n    },\n  )\n  .command('mcp <command>', 'MCP server management commands', (yargs) => {\n    return yargs\n      .command(\n        'add',\n        'Install PostHog MCP server to supported clients',\n        (yargs) => {\n          return yargs.options({\n            local: {\n              default: false,\n              describe:\n                'Add local development MCP server (http://localhost:8787)',\n              type: 'boolean',\n            },\n          });\n        },\n        (argv) => {\n          const options = { ...argv };\n          void runMCPInstall(\n            options as unknown as {\n              signup: boolean;\n              region?: CloudRegion;\n              local?: boolean;\n              debug?: boolean;\n            },\n          );\n        },\n      )\n      .command(\n        'remove',\n        'Remove PostHog MCP server from supported clients',\n        (yargs) => {\n          return yargs.options({\n            local: {\n              default: false,\n              describe:\n                'Remove local development MCP server (http://localhost:8787)',\n              type: 'boolean',\n            },\n          });\n        },\n        (argv) => {\n          const options = { ...argv };\n          void runMCPRemove(options as { local?: boolean });\n        },\n      )\n      .demandCommand(1, 'You must specify a subcommand (add or remove)')\n      .help();\n  })\n  .help()\n  .alias('help', 'h')\n  .version()\n  .alias('version', 'v')\n  .wrap(process.stdout.isTTY ? yargs.terminalWidth() : 80).argv;\n"]}

package/dist/src/javascript-node/javascript-node-wizard-agent.d.ts

@@ -0,0 +1,4 @@
+import type { FrameworkConfig } from '../lib/framework-config';
+type JavaScriptNodeContext = Record<string, unknown>;
+export declare const JAVASCRIPT_NODE_AGENT_CONFIG: FrameworkConfig<JavaScriptNodeContext>;
+export {};

package/dist/src/javascript-node/javascript-node-wizard-agent.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JAVASCRIPT_NODE_AGENT_CONFIG = void 0;
+const constants_1 = require("../lib/constants");
+const clack_utils_1 = require("../utils/clack-utils");
+const package_manager_detection_1 = require("../lib/package-manager-detection");
+exports.JAVASCRIPT_NODE_AGENT_CONFIG = {
+    metadata: {
+        name: 'Node.js',
+        integration: constants_1.Integration.javascriptNode,
+        beta: true,
+        docsUrl: 'https://posthog.com/docs/libraries/node',
+    },
+    detection: {
+        packageName: 'posthog-node',
+        packageDisplayName: 'Node.js',
+        usesPackageJson: false,
+        getVersion: () => undefined,
+        detectPackageManager: package_manager_detection_1.detectNodePackageManagers,
+        detect: async (options) => {
+            const packageJson = await (0, clack_utils_1.tryGetPackageJson)(options);
+            return !!packageJson;
+        },
+    },
+    environment: {
+        uploadToHosting: false,
+        getEnvVars: (apiKey, host) => ({
+            POSTHOG_API_KEY: apiKey,
+            POSTHOG_HOST: host,
+        }),
+    },
+    analytics: {
+        getTags: () => ({}),
+    },
+    prompts: {
+        projectTypeDetection: 'This is a server-side Node.js project. Look for package.json and lockfiles to confirm.',
+        packageInstallation: 'Use npm, yarn, pnpm, or bun based on the existing lockfile (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb). Install posthog-node as a regular dependency.',
+        getAdditionalContextLines: () => [
+            `Framework docs ID: javascript_node (use posthog://docs/frameworks/javascript_node for documentation)`,
+        ],
+    },
+    ui: {
+        successMessage: 'PostHog integration complete',
+        estimatedDurationMinutes: 5,
+        getOutroChanges: () => [
+            `Analyzed your Node.js project structure`,
+            `Installed the posthog-node package`,
+            `Created PostHog initialization with proper configuration`,
+            `Configured graceful shutdown for event flushing`,
+            `Added example code for events, feature flags, and error capture`,
+        ],
+        getOutroNextSteps: () => [
+            'Use the PostHog client instance for all tracking calls',
+            'Call posthog.shutdown() on application exit to flush pending events',
+            'NEVER send PII in event properties (no emails, names, or user content)',
+            'Use posthog.capture() for events and posthog.identify() for users',
+            'Visit your PostHog dashboard to see incoming events',
+        ],
+    },
+};
+//# sourceMappingURL=javascript-node-wizard-agent.js.map

package/dist/src/javascript-node/javascript-node-wizard-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"javascript-node-wizard-agent.js","sourceRoot":"","sources":["../../../src/javascript-node/javascript-node-wizard-agent.ts"],"names":[],"mappings":";;;AAEA,gDAA+C;AAC/C,sDAAyD;AACzD,gFAA6E;AAIhE,QAAA,4BAA4B,GACvC;IACE,QAAQ,EAAE;QACR,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,uBAAW,CAAC,cAAc;QACvC,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,yCAAyC;KACnD;IAED,SAAS,EAAE;QACT,WAAW,EAAE,cAAc;QAC3B,kBAAkB,EAAE,SAAS;QAC7B,eAAe,EAAE,KAAK;QACtB,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS;QAC3B,oBAAoB,EAAE,qDAAyB;QAC/C,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACxB,MAAM,WAAW,GAAG,MAAM,IAAA,+BAAiB,EAAC,OAAO,CAAC,CAAC;YACrD,OAAO,CAAC,CAAC,WAAW,CAAC;QACvB,CAAC;KACF;IAED,WAAW,EAAE;QACX,eAAe,EAAE,KAAK;QACtB,UAAU,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,CAAC;YAC7C,eAAe,EAAE,MAAM;YACvB,YAAY,EAAE,IAAI;SACnB,CAAC;KACH;IAED,SAAS,EAAE;QACT,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;KACpB;IAED,OAAO,EAAE;QACP,oBAAoB,EAClB,wFAAwF;QAC1F,mBAAmB,EACjB,qKAAqK;QACvK,yBAAyB,EAAE,GAAG,EAAE,CAAC;YAC/B,sGAAsG;SACvG;KACF;IAED,EAAE,EAAE;QACF,cAAc,EAAE,8BAA8B;QAC9C,wBAAwB,EAAE,CAAC;QAC3B,eAAe,EAAE,GAAG,EAAE,CAAC;YACrB,yCAAyC;YACzC,oCAAoC;YACpC,0DAA0D;YAC1D,iDAAiD;YACjD,iEAAiE;SAClE;QACD,iBAAiB,EAAE,GAAG,EAAE,CAAC;YACvB,wDAAwD;YACxD,qEAAqE;YACrE,wEAAwE;YACxE,mEAAmE;YACnE,qDAAqD;SACtD;KACF;CACF,CAAC","sourcesContent":["/* Generic Node.js language wizard using posthog-agent with PostHog MCP */\nimport type { FrameworkConfig } from '../lib/framework-config';\nimport { Integration } from '../lib/constants';\nimport { tryGetPackageJson } from '../utils/clack-utils';\nimport { detectNodePackageManagers } from '../lib/package-manager-detection';\n\ntype JavaScriptNodeContext = Record<string, unknown>;\n\nexport const JAVASCRIPT_NODE_AGENT_CONFIG: FrameworkConfig<JavaScriptNodeContext> =\n  {\n    metadata: {\n      name: 'Node.js',\n      integration: Integration.javascriptNode,\n      beta: true,\n      docsUrl: 'https://posthog.com/docs/libraries/node',\n    },\n\n    detection: {\n      packageName: 'posthog-node',\n      packageDisplayName: 'Node.js',\n      usesPackageJson: false,\n      getVersion: () => undefined,\n      detectPackageManager: detectNodePackageManagers,\n      detect: async (options) => {\n        const packageJson = await tryGetPackageJson(options);\n        return !!packageJson;\n      },\n    },\n\n    environment: {\n      uploadToHosting: false,\n      getEnvVars: (apiKey: string, host: string) => ({\n        POSTHOG_API_KEY: apiKey,\n        POSTHOG_HOST: host,\n      }),\n    },\n\n    analytics: {\n      getTags: () => ({}),\n    },\n\n    prompts: {\n      projectTypeDetection:\n        'This is a server-side Node.js project. Look for package.json and lockfiles to confirm.',\n      packageInstallation:\n        'Use npm, yarn, pnpm, or bun based on the existing lockfile (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb). Install posthog-node as a regular dependency.',\n      getAdditionalContextLines: () => [\n        `Framework docs ID: javascript_node (use posthog://docs/frameworks/javascript_node for documentation)`,\n      ],\n    },\n\n    ui: {\n      successMessage: 'PostHog integration complete',\n      estimatedDurationMinutes: 5,\n      getOutroChanges: () => [\n        `Analyzed your Node.js project structure`,\n        `Installed the posthog-node package`,\n        `Created PostHog initialization with proper configuration`,\n        `Configured graceful shutdown for event flushing`,\n        `Added example code for events, feature flags, and error capture`,\n      ],\n      getOutroNextSteps: () => [\n        'Use the PostHog client instance for all tracking calls',\n        'Call posthog.shutdown() on application exit to flush pending events',\n        'NEVER send PII in event properties (no emails, names, or user content)',\n        'Use posthog.capture() for events and posthog.identify() for users',\n        'Visit your PostHog dashboard to see incoming events',\n      ],\n    },\n  };\n"]}

package/dist/src/javascript-web/javascript-web-wizard-agent.d.ts

@@ -0,0 +1,3 @@
+import type { FrameworkConfig } from '../lib/framework-config';
+import { type JavaScriptContext } from './utils';
+export declare const JAVASCRIPT_WEB_AGENT_CONFIG: FrameworkConfig<JavaScriptContext>;

package/dist/src/javascript-web/javascript-web-wizard-agent.js

@@ -0,0 +1,150 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JAVASCRIPT_WEB_AGENT_CONFIG = void 0;
+const constants_1 = require("../lib/constants");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const package_json_1 = require("../utils/package-json");
+const clack_utils_1 = require("../utils/clack-utils");
+const utils_1 = require("./utils");
+const package_manager_detection_1 = require("../lib/package-manager-detection");
+exports.JAVASCRIPT_WEB_AGENT_CONFIG = {
+    metadata: {
+        name: 'JavaScript (Web)',
+        integration: constants_1.Integration.javascript_web,
+        beta: true,
+        docsUrl: 'https://posthog.com/docs/libraries/js',
+        gatherContext: (options) => {
+            const packageManagerName = (0, utils_1.detectJsPackageManager)(options);
+            const hasTypeScript = fs.existsSync(path.join(options.installDir, 'tsconfig.json'));
+            const hasBundler = (0, utils_1.detectBundler)(options);
+            return Promise.resolve({ packageManagerName, hasTypeScript, hasBundler });
+        },
+    },
+    detection: {
+        packageName: 'posthog-js',
+        packageDisplayName: 'JavaScript (Web)',
+        usesPackageJson: false,
+        getVersion: () => undefined,
+        detectPackageManager: package_manager_detection_1.detectNodePackageManagers,
+        detect: async (options) => {
+            const packageJson = await (0, clack_utils_1.tryGetPackageJson)(options);
+            if (!packageJson) {
+                return false;
+            }
+            // Exclude projects with known framework packages
+            for (const frameworkPkg of utils_1.FRAMEWORK_PACKAGES) {
+                if ((0, package_json_1.hasPackageInstalled)(frameworkPkg, packageJson)) {
+                    return false;
+                }
+            }
+            // Ensure this is actually a JS project, not just a package.json for tooling
+            const { installDir } = options;
+            // Check for a lockfile
+            const hasLockfile = [
+                'package-lock.json',
+                'yarn.lock',
+                'pnpm-lock.yaml',
+                'bun.lockb',
+                'bun.lock',
+            ].some((lockfile) => fs.existsSync(path.join(installDir, lockfile)));
+            if (hasLockfile) {
+                return true;
+            }
+            // Fallback: check if package.json has actual dependencies
+            const hasDeps = (packageJson.dependencies &&
+                Object.keys(packageJson.dependencies).length > 0) ||
+                (packageJson.devDependencies &&
+                    Object.keys(packageJson.devDependencies).length > 0);
+            return !!hasDeps;
+        },
+    },
+    environment: {
+        uploadToHosting: false,
+        getEnvVars: (apiKey, host) => ({
+            POSTHOG_API_KEY: apiKey,
+            POSTHOG_HOST: host,
+        }),
+    },
+    analytics: {
+        getTags: (context) => {
+            const tags = {
+                packageManager: context.packageManagerName ?? 'unknown',
+            };
+            if (context.hasBundler) {
+                tags.bundler = context.hasBundler;
+            }
+            return tags;
+        },
+    },
+    prompts: {
+        projectTypeDetection: 'This is a JavaScript/TypeScript project. Look for package.json and lockfiles (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb) to confirm.',
+        packageInstallation: 'Look for lockfiles to determine the package manager (npm, yarn, pnpm, bun). Do not manually edit package.json.',
+        getAdditionalContextLines: (context) => {
+            const lines = [
+                `Package manager: ${context.packageManagerName ?? 'unknown'}`,
+                `Has TypeScript: ${context.hasTypeScript ? 'yes' : 'no'}`,
+                `Framework docs ID: js (use posthog://docs/frameworks/js for documentation if available)`,
+                `Project type: Generic JavaScript/TypeScript application (no specific framework detected)`,
+            ];
+            if (context.hasBundler) {
+                lines.unshift(`Bundler: ${context.hasBundler}`);
+            }
+            return lines;
+        },
+    },
+    ui: {
+        successMessage: 'PostHog integration complete',
+        estimatedDurationMinutes: 5,
+        getOutroChanges: (context) => {
+            const packageManagerName = context.packageManagerName ?? 'package manager';
+            return [
+                `Analyzed your JavaScript project structure`,
+                `Installed the posthog-js package using ${packageManagerName}`,
+                `Created PostHog initialization code`,
+                `Configured autocapture, error tracking, and event capture`,
+            ];
+        },
+        getOutroNextSteps: () => [
+            'Ensure posthog.init() is called before any capture calls',
+            'Autocapture tracks clicks, form submissions, and pageviews automatically',
+            'Use posthog.capture() for custom events and posthog.identify() for users',
+            'NEVER send PII in event properties (no emails, names, or user content)',
+            'Visit your PostHog dashboard to see incoming events',
+        ],
+    },
+};
+//# sourceMappingURL=javascript-web-wizard-agent.js.map

package/dist/src/javascript-web/javascript-web-wizard-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"javascript-web-wizard-agent.js","sourceRoot":"","sources":["../../../src/javascript-web/javascript-web-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* Generic JavaScript Web (client-side) wizard using posthog-agent with PostHog MCP */\nimport type { WizardOptions } from '../utils/types';\nimport type { FrameworkConfig } from '../lib/framework-config';\nimport { Integration } from '../lib/constants';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { hasPackageInstalled } from '../utils/package-json';\nimport { tryGetPackageJson } from '../utils/clack-utils';\nimport {\n  FRAMEWORK_PACKAGES,\n  detectJsPackageManager,\n  detectBundler,\n  type JavaScriptContext,\n} from './utils';\nimport { detectNodePackageManagers } from '../lib/package-manager-detection';\n\nexport const JAVASCRIPT_WEB_AGENT_CONFIG: FrameworkConfig<JavaScriptContext> = {\n  metadata: {\n    name: 'JavaScript (Web)',\n    integration: Integration.javascript_web,\n    beta: true,\n    docsUrl: 'https://posthog.com/docs/libraries/js',\n    gatherContext: (options: WizardOptions) => {\n      const packageManagerName = detectJsPackageManager(options);\n      const hasTypeScript = fs.existsSync(\n        path.join(options.installDir, 'tsconfig.json'),\n      );\n      const hasBundler = detectBundler(options);\n      return Promise.resolve({ packageManagerName, hasTypeScript, hasBundler });\n    },\n  },\n\n  detection: {\n    packageName: 'posthog-js',\n    packageDisplayName: 'JavaScript (Web)',\n    usesPackageJson: false,\n    getVersion: () => undefined,\n    detectPackageManager: detectNodePackageManagers,\n    detect: async (options) => {\n      const packageJson = await tryGetPackageJson(options);\n      if (!packageJson) {\n        return false;\n      }\n\n      // Exclude projects with known framework packages\n      for (const frameworkPkg of FRAMEWORK_PACKAGES) {\n        if (hasPackageInstalled(frameworkPkg, packageJson)) {\n          return false;\n        }\n      }\n\n      // Ensure this is actually a JS project, not just a package.json for tooling\n      const { installDir } = options;\n\n      // Check for a lockfile\n      const hasLockfile = [\n        'package-lock.json',\n        'yarn.lock',\n        'pnpm-lock.yaml',\n        'bun.lockb',\n        'bun.lock',\n      ].some((lockfile) => fs.existsSync(path.join(installDir, lockfile)));\n\n      if (hasLockfile) {\n        return true;\n      }\n\n      // Fallback: check if package.json has actual dependencies\n      const hasDeps =\n        (packageJson.dependencies &&\n          Object.keys(packageJson.dependencies).length > 0) ||\n        (packageJson.devDependencies &&\n          Object.keys(packageJson.devDependencies).length > 0);\n\n      return !!hasDeps;\n    },\n  },\n\n  environment: {\n    uploadToHosting: false,\n    getEnvVars: (apiKey: string, host: string) => ({\n      POSTHOG_API_KEY: apiKey,\n      POSTHOG_HOST: host,\n    }),\n  },\n\n  analytics: {\n    getTags: (context) => {\n      const tags: Record<string, string> = {\n        packageManager: context.packageManagerName ?? 'unknown',\n      };\n      if (context.hasBundler) {\n        tags.bundler = context.hasBundler;\n      }\n      return tags;\n    },\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is a JavaScript/TypeScript project. Look for package.json and lockfiles (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb) to confirm.',\n    packageInstallation:\n      'Look for lockfiles to determine the package manager (npm, yarn, pnpm, bun). Do not manually edit package.json.',\n    getAdditionalContextLines: (context) => {\n      const lines = [\n        `Package manager: ${context.packageManagerName ?? 'unknown'}`,\n        `Has TypeScript: ${context.hasTypeScript ? 'yes' : 'no'}`,\n        `Framework docs ID: js (use posthog://docs/frameworks/js for documentation if available)`,\n        `Project type: Generic JavaScript/TypeScript application (no specific framework detected)`,\n      ];\n\n      if (context.hasBundler) {\n        lines.unshift(`Bundler: ${context.hasBundler}`);\n      }\n\n      return lines;\n    },\n  },\n\n  ui: {\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 5,\n    getOutroChanges: (context) => {\n      const packageManagerName =\n        context.packageManagerName ?? 'package manager';\n      return [\n        `Analyzed your JavaScript project structure`,\n        `Installed the posthog-js package using ${packageManagerName}`,\n        `Created PostHog initialization code`,\n        `Configured autocapture, error tracking, and event capture`,\n      ];\n    },\n    getOutroNextSteps: () => [\n      'Ensure posthog.init() is called before any capture calls',\n      'Autocapture tracks clicks, form submissions, and pageviews automatically',\n      'Use posthog.capture() for custom events and posthog.identify() for users',\n      'NEVER send PII in event properties (no emails, names, or user content)',\n      'Visit your PostHog dashboard to see incoming events',\n    ],\n  },\n};\n"]}

package/dist/src/javascript-web/utils.d.ts

@@ -0,0 +1,23 @@
+import type { WizardOptions } from '../utils/types';
+export type JavaScriptContext = {
+    packageManagerName?: string;
+    hasTypeScript?: boolean;
+    hasBundler?: string;
+};
+/**
+ * Packages that indicate a specific framework integration exists.
+ * If any of these are in package.json, we should NOT match as generic JavaScript.
+ *
+ * When adding a new JS framework integration to the wizard,
+ * add its detection package here too.
+ */
+export declare const FRAMEWORK_PACKAGES: readonly ["next", "nuxt", "vue", "react-router", "@tanstack/react-start", "@tanstack/react-router", "react-native", "@angular/core", "astro", "@sveltejs/kit"];
+/**
+ * Detect the JS package manager for the project by checking lockfiles.
+ * Reuses the existing package manager detection infrastructure.
+ */
+export declare function detectJsPackageManager(options: Pick<WizardOptions, 'installDir'>): string;
+/**
+ * Detect the bundler used in the project by checking package.json dependencies.
+ */
+export declare function detectBundler(options: Pick<WizardOptions, 'installDir'>): string | undefined;

package/dist/src/javascript-web/utils.js

@@ -0,0 +1,99 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FRAMEWORK_PACKAGES = void 0;
+exports.detectJsPackageManager = detectJsPackageManager;
+exports.detectBundler = detectBundler;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const package_manager_1 = require("../utils/package-manager");
+/**
+ * Packages that indicate a specific framework integration exists.
+ * If any of these are in package.json, we should NOT match as generic JavaScript.
+ *
+ * When adding a new JS framework integration to the wizard,
+ * add its detection package here too.
+ */
+exports.FRAMEWORK_PACKAGES = [
+    'next',
+    'nuxt',
+    'vue',
+    'react-router',
+    '@tanstack/react-start',
+    '@tanstack/react-router',
+    'react-native',
+    '@angular/core',
+    'astro',
+    '@sveltejs/kit',
+];
+/**
+ * Detect the JS package manager for the project by checking lockfiles.
+ * Reuses the existing package manager detection infrastructure.
+ */
+function detectJsPackageManager(options) {
+    const detected = (0, package_manager_1.detectAllPackageManagers)(options);
+    if (detected.length > 0) {
+        return detected[0].label;
+    }
+    return 'unknown';
+}
+/**
+ * Detect the bundler used in the project by checking package.json dependencies.
+ */
+function detectBundler(options) {
+    try {
+        const content = fs.readFileSync(path.join(options.installDir, 'package.json'), 'utf-8');
+        const pkg = JSON.parse(content);
+        const allDeps = {
+            ...pkg.dependencies,
+            ...pkg.devDependencies,
+        };
+        if (allDeps['vite'])
+            return 'vite';
+        if (allDeps['webpack'])
+            return 'webpack';
+        if (allDeps['esbuild'])
+            return 'esbuild';
+        if (allDeps['parcel'])
+            return 'parcel';
+        if (allDeps['rollup'])
+            return 'rollup';
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/javascript-web/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/javascript-web/utils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,wDAQC;AAKD,sCAuBC;AAvED,4CAA8B;AAC9B,gDAAkC;AAClC,8DAAoE;AASpE;;;;;;GAMG;AACU,QAAA,kBAAkB,GAAG;IAChC,MAAM;IACN,MAAM;IACN,KAAK;IACL,cAAc;IACd,uBAAuB;IACvB,wBAAwB;IACxB,cAAc;IACd,eAAe;IACf,OAAO;IACP,eAAe;CACP,CAAC;AAEX;;;GAGG;AACH,SAAgB,sBAAsB,CACpC,OAA0C;IAE1C,MAAM,QAAQ,GAAG,IAAA,0CAAwB,EAAC,OAAO,CAAC,CAAC;IACnD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAC3B,OAA0C;IAE1C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAC7B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,cAAc,CAAC,EAC7C,OAAO,CACR,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,OAAO,GAA2B;YACtC,GAAG,GAAG,CAAC,YAAY;YACnB,GAAG,GAAG,CAAC,eAAe;SACvB,CAAC;QAEF,IAAI,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QACnC,IAAI,OAAO,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QACzC,IAAI,OAAO,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QACzC,IAAI,OAAO,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;QACvC,IAAI,OAAO,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;QACvC,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC","sourcesContent":["import * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { detectAllPackageManagers } from '../utils/package-manager';\nimport type { WizardOptions } from '../utils/types';\n\nexport type JavaScriptContext = {\n  packageManagerName?: string;\n  hasTypeScript?: boolean;\n  hasBundler?: string;\n};\n\n/**\n * Packages that indicate a specific framework integration exists.\n * If any of these are in package.json, we should NOT match as generic JavaScript.\n *\n * When adding a new JS framework integration to the wizard,\n * add its detection package here too.\n */\nexport const FRAMEWORK_PACKAGES = [\n  'next',\n  'nuxt',\n  'vue',\n  'react-router',\n  '@tanstack/react-start',\n  '@tanstack/react-router',\n  'react-native',\n  '@angular/core',\n  'astro',\n  '@sveltejs/kit',\n] as const;\n\n/**\n * Detect the JS package manager for the project by checking lockfiles.\n * Reuses the existing package manager detection infrastructure.\n */\nexport function detectJsPackageManager(\n  options: Pick<WizardOptions, 'installDir'>,\n): string {\n  const detected = detectAllPackageManagers(options);\n  if (detected.length > 0) {\n    return detected[0].label;\n  }\n  return 'unknown';\n}\n\n/**\n * Detect the bundler used in the project by checking package.json dependencies.\n */\nexport function detectBundler(\n  options: Pick<WizardOptions, 'installDir'>,\n): string | undefined {\n  try {\n    const content = fs.readFileSync(\n      path.join(options.installDir, 'package.json'),\n      'utf-8',\n    );\n    const pkg = JSON.parse(content);\n    const allDeps: Record<string, string> = {\n      ...pkg.dependencies,\n      ...pkg.devDependencies,\n    };\n\n    if (allDeps['vite']) return 'vite';\n    if (allDeps['webpack']) return 'webpack';\n    if (allDeps['esbuild']) return 'esbuild';\n    if (allDeps['parcel']) return 'parcel';\n    if (allDeps['rollup']) return 'rollup';\n    return undefined;\n  } catch {\n    return undefined;\n  }\n}\n"]}

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

@@ -27,6 +27,7 @@ describe('runAgent', () => {
         localMcp: false,
         ci: false,
         menu: false,
+        benchmark: false,
     };
     const defaultAgentConfig = {
         workingDirectory: '/test/dir',

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

@@ -1 +1 @@
-{"version":3,"file":"agent-interface.test.js","sourceRoot":"","sources":["../../../../src/lib/__tests__/agent-interface.test.ts"],"names":[],"mappings":";;;;;AAAA,wDAA8C;AAG9C,oBAAoB;AACpB,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;AAC/B,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;AACnC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;AAE/B,sBAAsB;AACtB,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;AAC5B,IAAI,CAAC,IAAI,CAAC,gCAAgC,EAAE,GAAG,EAAE,CAAC,CAAC;IACjD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;CAClD,CAAC,CAAC,CAAC;AAEJ,+BAA+B;AAC/B,8DAAsC;AACtC,MAAM,SAAS,GAAG,eAAkC,CAAC;AAErD,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,IAAI,WAIH,CAAC;IAEF,MAAM,cAAc,GAAkB;QACpC,KAAK,EAAE,KAAK;QACZ,UAAU,EAAE,WAAW;QACvB,YAAY,EAAE,KAAK;QACnB,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,KAAK;QACf,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,KAAK;KACZ,CAAC;IAEF,MAAM,kBAAkB,GAAG;QACzB,gBAAgB,EAAE,WAAW;QAC7B,UAAU,EAAE,EAAE;QACd,KAAK,EAAE,0BAA0B;KAClC,CAAC;IAEF,UAAU,CAAC,GAAG,EAAE;QACd,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,WAAW,GAAG;YACZ,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;YAChB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;YACf,OAAO,EAAE,EAAE;SACZ,CAAC;QAEF,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAC3D,SAAS,CAAC,GAAG,GAAG;YACd,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;YACf,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE;YAClB,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;YAChB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;YACf,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE;YAClB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;YACf,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE;SACnB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,gFAAgF,EAAE,KAAK,IAAI,EAAE;YAC9F,qCAAqC;YACrC,yCAAyC;YACzC,6DAA6D;YAC7D,iEAAiE;YACjE,yBAAyB;YACzB,8EAA8E;YAE9E,QAAQ,CAAC,CAAC,6BAA6B;gBACrC,MAAM;oBACJ,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,MAAM;oBACf,KAAK,EAAE,0BAA0B;oBACjC,KAAK,EAAE,EAAE;oBACT,WAAW,EAAE,EAAE;iBAChB,CAAC;gBAEF,MAAM;oBACJ,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,SAAS;oBAClB,QAAQ,EAAE,KAAK;oBACf,MAAM,EAAE,8BAA8B;iBACvC,CAAC;gBAEF,2DAA2D;gBAC3D,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;YAC1E,CAAC;YAED,SAAS,CAAC,eAAe,CAAC,6BAA6B,EAAE,CAAC,CAAC;YAE3D,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAQ,EAC3B,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,WAA0D,EAC1D;gBACE,cAAc,EAAE,cAAc;gBAC9B,YAAY,EAAE,YAAY;aAC3B,CACF,CAAC;YAEF,kDAAkD;YAClD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC3B,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;YACnF,qEAAqE;YAErE,QAAQ,CAAC,CAAC,0BAA0B;gBAClC,MAAM;oBACJ,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,MAAM;oBACf,KAAK,EAAE,0BAA0B;oBACjC,KAAK,EAAE,EAAE;oBACT,WAAW,EAAE,EAAE;iBAChB,CAAC;gBAEF,mCAAmC;gBACnC,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACtC,CAAC;YAED,SAAS,CAAC,eAAe,CAAC,0BAA0B,EAAE,CAAC,CAAC;YAExD,MAAM,MAAM,CACV,IAAA,0BAAQ,EACN,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,WAA0D,EAC1D;gBACE,cAAc,EAAE,cAAc;gBAC9B,YAAY,EAAE,YAAY;aAC3B,CACF,CACF,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;YAEtC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;YACzD,2DAA2D;YAC3D,mEAAmE;YAEnE,QAAQ,CAAC,CAAC,4BAA4B;gBACpC,MAAM;oBACJ,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,MAAM;oBACf,KAAK,EAAE,0BAA0B;oBACjC,KAAK,EAAE,EAAE;oBACT,WAAW,EAAE,EAAE;iBAChB,CAAC;gBAEF,MAAM;oBACJ,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,SAAS,EAAE,2CAA2C;oBAC/D,QAAQ,EAAE,IAAI;oBACd,MAAM,EAAE,sCAAsC;iBAC/C,CAAC;gBAEF,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAChD,CAAC;YAED,SAAS,CAAC,eAAe,CAAC,4BAA4B,EAAE,CAAC,CAAC;YAE1D,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAQ,EAC3B,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,WAA0D,EAC1D;gBACE,cAAc,EAAE,cAAc;gBAC9B,YAAY,EAAE,YAAY;aAC3B,CACF,CAAC;YAEF,uCAAuC;YACvC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC9C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+EAA+E,EAAE,KAAK,IAAI,EAAE;YAC7F,gFAAgF;YAChF,iEAAiE;YACjE,+DAA+D;YAC/D,0CAA0C;YAC1C,mEAAmE;YACnE,EAAE;YACF,0EAA0E;YAC1E,4DAA4D;YAE5D,QAAQ,CAAC,CAAC,yCAAyC;gBACjD,MAAM;oBACJ,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,MAAM;oBACf,KAAK,EAAE,0BAA0B;oBACjC,KAAK,EAAE,EAAE;oBACT,WAAW,EAAE,EAAE;iBAChB,CAAC;gBAEF,sDAAsD;gBACtD,MAAM;oBACJ,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,SAAS;oBAClB,QAAQ,EAAE,KAAK;oBACf,SAAS,EAAE,GAAG;oBACd,MAAM,EAAE,oDAAoD;oBAC5D,UAAU,EAAE,sCAAsC;oBAClD,cAAc,EAAE,IAAI;iBACrB,CAAC;gBAEF,iEAAiE;gBACjE,MAAM;oBACJ,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,wBAAwB;oBACjC,QAAQ,EAAE,IAAI;oBACd,SAAS,EAAE,CAAC;oBACZ,UAAU,EAAE,sCAAsC;oBAClD,cAAc,EAAE,CAAC;oBACjB,MAAM,EAAE;wBACN,sDAAsD;wBACtD,qDAAqD;wBACrD,qDAAqD;wBACrD,mCAAmC;qBACpC;iBACF,CAAC;YACJ,CAAC;YAED,SAAS,CAAC,eAAe,CAAC,yCAAyC,EAAE,CAAC,CAAC;YAEvE,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAQ,EAC3B,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,WAA0D,EAC1D;gBACE,cAAc,EAAE,cAAc;gBAC9B,YAAY,EAAE,YAAY;aAC3B,CACF,CAAC;YAEF,kDAAkD;YAClD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC3B,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;YAE9D,2EAA2E;YAC3E,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { runAgent } from '../agent-interface';\nimport type { WizardOptions } from '../../utils/types';\n\n// Mock dependencies\njest.mock('../../utils/clack');\njest.mock('../../utils/analytics');\njest.mock('../../utils/debug');\n\n// Mock the SDK module\nconst mockQuery = jest.fn();\njest.mock('@anthropic-ai/claude-agent-sdk', () => ({\n  query: (...args: unknown[]) => mockQuery(...args),\n}));\n\n// Get mocked clack for spinner\nimport clack from '../../utils/clack';\nconst mockClack = clack as jest.Mocked<typeof clack>;\n\ndescribe('runAgent', () => {\n  let mockSpinner: {\n    start: jest.Mock;\n    stop: jest.Mock;\n    message: string;\n  };\n\n  const defaultOptions: WizardOptions = {\n    debug: false,\n    installDir: '/test/dir',\n    forceInstall: false,\n    default: false,\n    signup: false,\n    localMcp: false,\n    ci: false,\n    menu: false,\n  };\n\n  const defaultAgentConfig = {\n    workingDirectory: '/test/dir',\n    mcpServers: {},\n    model: 'claude-opus-4-5-20251101',\n  };\n\n  beforeEach(() => {\n    jest.clearAllMocks();\n\n    mockSpinner = {\n      start: jest.fn(),\n      stop: jest.fn(),\n      message: '',\n    };\n\n    mockClack.spinner = jest.fn().mockReturnValue(mockSpinner);\n    mockClack.log = {\n      step: jest.fn(),\n      success: jest.fn(),\n      error: jest.fn(),\n      warn: jest.fn(),\n      warning: jest.fn(),\n      info: jest.fn(),\n      message: jest.fn(),\n    };\n  });\n\n  describe('race condition handling', () => {\n    it('should return success when agent completes successfully then SDK cleanup fails', async () => {\n      // This simulates the race condition:\n      // 1. Agent completes with success result\n      // 2. signalDone() is called, completing the prompt generator\n      // 3. SDK tries to send cleanup command while streaming is active\n      // 4. SDK throws an error\n      // The fix should recognize we already got a success and return success anyway\n\n      function* mockGeneratorWithCleanupError() {\n        yield {\n          type: 'system',\n          subtype: 'init',\n          model: 'claude-opus-4-5-20251101',\n          tools: [],\n          mcp_servers: [],\n        };\n\n        yield {\n          type: 'result',\n          subtype: 'success',\n          is_error: false,\n          result: 'Agent completed successfully',\n        };\n\n        // Simulate the SDK cleanup error that occurs after success\n        throw new Error('only prompt commands are supported in streaming mode');\n      }\n\n      mockQuery.mockReturnValue(mockGeneratorWithCleanupError());\n\n      const result = await runAgent(\n        defaultAgentConfig,\n        'test prompt',\n        defaultOptions,\n        mockSpinner as unknown as ReturnType<typeof clack.spinner>,\n        {\n          successMessage: 'Test success',\n          errorMessage: 'Test error',\n        },\n      );\n\n      // Should return success (empty object), not throw\n      expect(result).toEqual({});\n      expect(mockSpinner.stop).toHaveBeenCalledWith('Test success');\n    });\n\n    it('should still throw when no success result was received before error', async () => {\n      // If we never got a success result, errors should propagate normally\n\n      function* mockGeneratorWithOnlyError() {\n        yield {\n          type: 'system',\n          subtype: 'init',\n          model: 'claude-opus-4-5-20251101',\n          tools: [],\n          mcp_servers: [],\n        };\n\n        // No success result, just an error\n        throw new Error('Actual SDK error');\n      }\n\n      mockQuery.mockReturnValue(mockGeneratorWithOnlyError());\n\n      await expect(\n        runAgent(\n          defaultAgentConfig,\n          'test prompt',\n          defaultOptions,\n          mockSpinner as unknown as ReturnType<typeof clack.spinner>,\n          {\n            successMessage: 'Test success',\n            errorMessage: 'Test error',\n          },\n        ),\n      ).rejects.toThrow('Actual SDK error');\n\n      expect(mockSpinner.stop).toHaveBeenCalledWith('Test error');\n    });\n\n    it('should not treat error results as success', async () => {\n      // A result with is_error: true should not count as success\n      // Even if subtype is 'success', the is_error flag takes precedence\n\n      function* mockGeneratorWithErrorResult() {\n        yield {\n          type: 'system',\n          subtype: 'init',\n          model: 'claude-opus-4-5-20251101',\n          tools: [],\n          mcp_servers: [],\n        };\n\n        yield {\n          type: 'result',\n          subtype: 'success', // subtype can be success but is_error true\n          is_error: true,\n          result: 'API Error: 500 Internal Server Error',\n        };\n\n        throw new Error('Process exited with code 1');\n      }\n\n      mockQuery.mockReturnValue(mockGeneratorWithErrorResult());\n\n      const result = await runAgent(\n        defaultAgentConfig,\n        'test prompt',\n        defaultOptions,\n        mockSpinner as unknown as ReturnType<typeof clack.spinner>,\n        {\n          successMessage: 'Test success',\n          errorMessage: 'Test error',\n        },\n      );\n\n      // Should return API error, not success\n      expect(result.error).toBe('WIZARD_API_ERROR');\n      expect(result.message).toContain('API Error');\n    });\n\n    it('should suppress user-facing errors when SDK yields error result after success', async () => {\n      // This test models actual SDK behavior where the SDK emits TWO result messages:\n      // 1. SDK yields success result (num_turns: 105, is_error: false)\n      // 2. SDK yields a SECOND result with is_error: true containing\n      //    accumulated cleanup/telemetry errors\n      // 3. The errors should be logged to file but NOT shown to the user\n      //\n      // This differs from the thrown exception test above - here the SDK YIELDS\n      // an error result message instead of THROWING an exception.\n\n      function* mockGeneratorWithYieldedErrorAfterSuccess() {\n        yield {\n          type: 'system',\n          subtype: 'init',\n          model: 'claude-opus-4-5-20251101',\n          tools: [],\n          mcp_servers: [],\n        };\n\n        // First result: success (this is the real completion)\n        yield {\n          type: 'result',\n          subtype: 'success',\n          is_error: false,\n          num_turns: 105,\n          result: '[WIZARD-REMARK] Integration completed successfully',\n          session_id: '2ce14bda-6d86-4220-b5bb-ab24f7004290',\n          total_cost_usd: 5.83,\n        };\n\n        // Second result: error (SDK cleanup noise - yielded, not thrown)\n        yield {\n          type: 'result',\n          subtype: 'error_during_execution',\n          is_error: true,\n          num_turns: 0,\n          session_id: '2ce14bda-6d86-4220-b5bb-ab24f7004290',\n          total_cost_usd: 0,\n          errors: [\n            'only prompt commands are supported in streaming mode',\n            'Error: 1P event logging: 14 events failed to export',\n            'Error: 1P event logging: 13 events failed to export',\n            'Error: Failed to export 14 events',\n          ],\n        };\n      }\n\n      mockQuery.mockReturnValue(mockGeneratorWithYieldedErrorAfterSuccess());\n\n      const result = await runAgent(\n        defaultAgentConfig,\n        'test prompt',\n        defaultOptions,\n        mockSpinner as unknown as ReturnType<typeof clack.spinner>,\n        {\n          successMessage: 'Test success',\n          errorMessage: 'Test error',\n        },\n      );\n\n      // Should return success (empty object), not error\n      expect(result).toEqual({});\n      expect(mockSpinner.stop).toHaveBeenCalledWith('Test success');\n\n      // clack.log.error should NOT have been called (errors suppressed for user)\n      expect(mockClack.log.error).not.toHaveBeenCalled();\n    });\n  });\n});\n"]}
+{"version":3,"file":"agent-interface.test.js","sourceRoot":"","sources":["../../../../src/lib/__tests__/agent-interface.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { runAgent } from '../agent-interface';\nimport type { WizardOptions } from '../../utils/types';\n\n// Mock dependencies\njest.mock('../../utils/clack');\njest.mock('../../utils/analytics');\njest.mock('../../utils/debug');\n\n// Mock the SDK module\nconst mockQuery = jest.fn();\njest.mock('@anthropic-ai/claude-agent-sdk', () => ({\n  query: (...args: unknown[]) => mockQuery(...args),\n}));\n\n// Get mocked clack for spinner\nimport clack from '../../utils/clack';\nconst mockClack = clack as jest.Mocked<typeof clack>;\n\ndescribe('runAgent', () => {\n  let mockSpinner: {\n    start: jest.Mock;\n    stop: jest.Mock;\n    message: string;\n  };\n\n  const defaultOptions: WizardOptions = {\n    debug: false,\n    installDir: '/test/dir',\n    forceInstall: false,\n    default: false,\n    signup: false,\n    localMcp: false,\n    ci: false,\n    menu: false,\n    benchmark: false,\n  };\n\n  const defaultAgentConfig = {\n    workingDirectory: '/test/dir',\n    mcpServers: {},\n    model: 'claude-opus-4-5-20251101',\n  };\n\n  beforeEach(() => {\n    jest.clearAllMocks();\n\n    mockSpinner = {\n      start: jest.fn(),\n      stop: jest.fn(),\n      message: '',\n    };\n\n    mockClack.spinner = jest.fn().mockReturnValue(mockSpinner);\n    mockClack.log = {\n      step: jest.fn(),\n      success: jest.fn(),\n      error: jest.fn(),\n      warn: jest.fn(),\n      warning: jest.fn(),\n      info: jest.fn(),\n      message: jest.fn(),\n    };\n  });\n\n  describe('race condition handling', () => {\n    it('should return success when agent completes successfully then SDK cleanup fails', async () => {\n      // This simulates the race condition:\n      // 1. Agent completes with success result\n      // 2. signalDone() is called, completing the prompt generator\n      // 3. SDK tries to send cleanup command while streaming is active\n      // 4. SDK throws an error\n      // The fix should recognize we already got a success and return success anyway\n\n      function* mockGeneratorWithCleanupError() {\n        yield {\n          type: 'system',\n          subtype: 'init',\n          model: 'claude-opus-4-5-20251101',\n          tools: [],\n          mcp_servers: [],\n        };\n\n        yield {\n          type: 'result',\n          subtype: 'success',\n          is_error: false,\n          result: 'Agent completed successfully',\n        };\n\n        // Simulate the SDK cleanup error that occurs after success\n        throw new Error('only prompt commands are supported in streaming mode');\n      }\n\n      mockQuery.mockReturnValue(mockGeneratorWithCleanupError());\n\n      const result = await runAgent(\n        defaultAgentConfig,\n        'test prompt',\n        defaultOptions,\n        mockSpinner as unknown as ReturnType<typeof clack.spinner>,\n        {\n          successMessage: 'Test success',\n          errorMessage: 'Test error',\n        },\n      );\n\n      // Should return success (empty object), not throw\n      expect(result).toEqual({});\n      expect(mockSpinner.stop).toHaveBeenCalledWith('Test success');\n    });\n\n    it('should still throw when no success result was received before error', async () => {\n      // If we never got a success result, errors should propagate normally\n\n      function* mockGeneratorWithOnlyError() {\n        yield {\n          type: 'system',\n          subtype: 'init',\n          model: 'claude-opus-4-5-20251101',\n          tools: [],\n          mcp_servers: [],\n        };\n\n        // No success result, just an error\n        throw new Error('Actual SDK error');\n      }\n\n      mockQuery.mockReturnValue(mockGeneratorWithOnlyError());\n\n      await expect(\n        runAgent(\n          defaultAgentConfig,\n          'test prompt',\n          defaultOptions,\n          mockSpinner as unknown as ReturnType<typeof clack.spinner>,\n          {\n            successMessage: 'Test success',\n            errorMessage: 'Test error',\n          },\n        ),\n      ).rejects.toThrow('Actual SDK error');\n\n      expect(mockSpinner.stop).toHaveBeenCalledWith('Test error');\n    });\n\n    it('should not treat error results as success', async () => {\n      // A result with is_error: true should not count as success\n      // Even if subtype is 'success', the is_error flag takes precedence\n\n      function* mockGeneratorWithErrorResult() {\n        yield {\n          type: 'system',\n          subtype: 'init',\n          model: 'claude-opus-4-5-20251101',\n          tools: [],\n          mcp_servers: [],\n        };\n\n        yield {\n          type: 'result',\n          subtype: 'success', // subtype can be success but is_error true\n          is_error: true,\n          result: 'API Error: 500 Internal Server Error',\n        };\n\n        throw new Error('Process exited with code 1');\n      }\n\n      mockQuery.mockReturnValue(mockGeneratorWithErrorResult());\n\n      const result = await runAgent(\n        defaultAgentConfig,\n        'test prompt',\n        defaultOptions,\n        mockSpinner as unknown as ReturnType<typeof clack.spinner>,\n        {\n          successMessage: 'Test success',\n          errorMessage: 'Test error',\n        },\n      );\n\n      // Should return API error, not success\n      expect(result.error).toBe('WIZARD_API_ERROR');\n      expect(result.message).toContain('API Error');\n    });\n\n    it('should suppress user-facing errors when SDK yields error result after success', async () => {\n      // This test models actual SDK behavior where the SDK emits TWO result messages:\n      // 1. SDK yields success result (num_turns: 105, is_error: false)\n      // 2. SDK yields a SECOND result with is_error: true containing\n      //    accumulated cleanup/telemetry errors\n      // 3. The errors should be logged to file but NOT shown to the user\n      //\n      // This differs from the thrown exception test above - here the SDK YIELDS\n      // an error result message instead of THROWING an exception.\n\n      function* mockGeneratorWithYieldedErrorAfterSuccess() {\n        yield {\n          type: 'system',\n          subtype: 'init',\n          model: 'claude-opus-4-5-20251101',\n          tools: [],\n          mcp_servers: [],\n        };\n\n        // First result: success (this is the real completion)\n        yield {\n          type: 'result',\n          subtype: 'success',\n          is_error: false,\n          num_turns: 105,\n          result: '[WIZARD-REMARK] Integration completed successfully',\n          session_id: '2ce14bda-6d86-4220-b5bb-ab24f7004290',\n          total_cost_usd: 5.83,\n        };\n\n        // Second result: error (SDK cleanup noise - yielded, not thrown)\n        yield {\n          type: 'result',\n          subtype: 'error_during_execution',\n          is_error: true,\n          num_turns: 0,\n          session_id: '2ce14bda-6d86-4220-b5bb-ab24f7004290',\n          total_cost_usd: 0,\n          errors: [\n            'only prompt commands are supported in streaming mode',\n            'Error: 1P event logging: 14 events failed to export',\n            'Error: 1P event logging: 13 events failed to export',\n            'Error: Failed to export 14 events',\n          ],\n        };\n      }\n\n      mockQuery.mockReturnValue(mockGeneratorWithYieldedErrorAfterSuccess());\n\n      const result = await runAgent(\n        defaultAgentConfig,\n        'test prompt',\n        defaultOptions,\n        mockSpinner as unknown as ReturnType<typeof clack.spinner>,\n        {\n          successMessage: 'Test success',\n          errorMessage: 'Test error',\n        },\n      );\n\n      // Should return success (empty object), not error\n      expect(result).toEqual({});\n      expect(mockSpinner.stop).toHaveBeenCalledWith('Test success');\n\n      // clack.log.error should NOT have been called (errors suppressed for user)\n      expect(mockClack.log.error).not.toHaveBeenCalled();\n    });\n  });\n});\n"]}

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

@@ -15,6 +15,8 @@ export declare const AgentSignals: {
     readonly ERROR_RESOURCE_MISSING: "[ERROR-RESOURCE-MISSING]";
     /** Signal emitted when the agent provides a remark about its run */
     readonly WIZARD_REMARK: "[WIZARD-REMARK]";
+    /** Signal prefix for benchmark logging */
+    readonly BENCHMARK: "[BENCHMARK]";
 };
 export type AgentSignal = (typeof AgentSignals)[keyof typeof AgentSignals];
 /**
@@ -79,6 +81,9 @@ export declare function runAgent(agentConfig: AgentRunConfig, prompt: string, op
     spinnerMessage?: string;
     successMessage?: string;
     errorMessage?: string;
+}, middleware?: {
+    onMessage(message: any): void;
+    finalize(resultMessage: any, totalDurationMs: number): any;
 }): Promise<{
     error?: AgentErrorType;
     message?: string;

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

@@ -45,6 +45,8 @@ exports.AgentSignals = {
     ERROR_RESOURCE_MISSING: '[ERROR-RESOURCE-MISSING]',
     /** Signal emitted when the agent provides a remark about its run */
     WIZARD_REMARK: '[WIZARD-REMARK]',
+    /** Signal prefix for benchmark logging */
+    BENCHMARK: '[BENCHMARK]',
 };
 /**
  * Error types that can be returned from agent execution.
@@ -288,6 +290,7 @@ async function initializeAgent(config, options) {
                 url: config.posthogMcpUrl,
                 headers: {
                     Authorization: `Bearer ${config.posthogApiKey}`,
+                    'User-Agent': constants_1.WIZARD_USER_AGENT,
                 },
             },
             ...Object.fromEntries(Object.entries(config.additionalMcpServers ?? {}).map(([name, { url }]) => [name, { type: 'http', url }])),
@@ -317,7 +320,7 @@ async function initializeAgent(config, options) {
                 apiKeyPresent: !!config.posthogApiKey,
             });
         }
-        clack_1.default.log.step(`Verbose logs: ${debug_1.LOG_FILE_PATH}`);
+        clack_1.default.log.step(`Verbose logs: ${(0, debug_1.getLogFilePath)()}`);
         clack_1.default.log.success("Agent initialized. Let's get cooking!");
         return agentRunConfig;
     }
@@ -334,7 +337,7 @@ async function initializeAgent(config, options) {
  *
  * @returns An object containing any error detected in the agent's output
  */
-async function runAgent(agentConfig, prompt, options, spinner, config) {
+async function runAgent(agentConfig, prompt, options, spinner, config, middleware) {
     const { estimatedDurationMinutes = 8, spinnerMessage = 'Customizing your PostHog setup...', successMessage = 'PostHog integration complete', errorMessage = 'Integration failed', } = config ?? {};
     const { query } = await getSDKModule();
     clack_1.default.log.step(`This whole process should take about ${estimatedDurationMinutes} minutes including error checking and fixes.\n\nGrab some coffee!`);
@@ -347,6 +350,7 @@ async function runAgent(agentConfig, prompt, options, spinner, config) {
     const collectedText = [];
     // Track if we received a successful result (before any cleanup errors)
     let receivedSuccessResult = false;
+    let lastResultMessage = null;
     // Workaround for SDK bug: stdin closes before canUseTool responses can be sent.
     // The fix is to use an async generator for the prompt that stays open until
     // the result is received, keeping the stdin stream alive for permission responses.
@@ -391,6 +395,12 @@ async function runAgent(agentConfig, prompt, options, spinner, config) {
             duration_ms: durationMs,
             duration_seconds: durationSeconds,
         });
+        try {
+            middleware?.finalize(lastResultMessage, durationMs);
+        }
+        catch (e) {
+            (0, debug_1.logToFile)(`${exports.AgentSignals.BENCHMARK} Middleware finalize error:`, e);
+        }
         spinner.stop(successMessage);
         return {};
     };
@@ -475,12 +485,19 @@ async function runAgent(agentConfig, prompt, options, spinner, config) {
             // Pass receivedSuccessResult so handleSDKMessage can suppress user-facing error
             // output for post-success cleanup errors while still logging them to file
             handleSDKMessage(message, options, spinner, collectedText, receivedSuccessResult);
+            try {
+                middleware?.onMessage(message);
+            }
+            catch (e) {
+                (0, debug_1.logToFile)(`${exports.AgentSignals.BENCHMARK} Middleware onMessage error:`, e);
+            }
             // Signal completion when result received
             if (message.type === 'result') {
                 // Track successful results before any potential cleanup errors
                 // The SDK may emit a second error result during cleanup due to a race condition
                 if (message.subtype === 'success' && !message.is_error) {
                     receivedSuccessResult = true;
+                    lastResultMessage = message;
                 }
                 signalDone();
             }