1export const posthogIntegrationSpec = defineIntegration({
2  meta: {
3    key: 'analytics.posthog',
4    version: '1.1.0',
5    category: 'analytics',
6    title: 'PostHog',
7    description:
8      'PostHog integration for product analytics, feature flags, HogQL queries, and LLM analytics with evaluations.',
9    domain: 'analytics',
10    owners: ['@platform.integrations'],
11    tags: ['analytics', 'posthog', 'llm', 'ai'],
12    stability: StabilityEnum.Beta,
13  },
14  supportedModes: ['managed', 'byok'],
15  capabilities: {
16    provides: [
17      { key: 'analytics.events', version: '1.0.0' },
18      { key: 'analytics.feature-flags', version: '1.0.0' },
19      { key: 'analytics.query', version: '1.0.0' },
20      { key: 'analytics.events.read', version: '1.0.0' },
21      { key: 'analytics.persons', version: '1.0.0' },
22      { key: 'analytics.insights', version: '1.0.0' },
23      { key: 'analytics.cohorts', version: '1.0.0' },
24      { key: 'analytics.annotations', version: '1.0.0' },
25      { key: 'analytics.llm-tracing', version: '1.0.0' },
26      { key: 'analytics.llm-evaluations', version: '1.0.0' },
27    ],
28  },
29  configSchema: {
30    schema: {
31      type: 'object',
32      properties: {
33        host: {
34          type: 'string',
35          description:
36            'PostHog host (e.g., https://app.posthog.com or self-hosted URL).',
37        },
38        projectId: {
39          type: 'string',
40          description: 'PostHog project ID for API queries.',
41        },
42        mcpUrl: {
43          type: 'string',
44          description: 'Optional MCP endpoint URL for PostHog tools.',
45        },
46      },
47    },
48    example: {
49      host: 'https://app.posthog.com',
50      projectId: '12345',
51    },
52  },
53  secretSchema: {
54    schema: {
55      type: 'object',
56      required: ['personalApiKey'],
57      properties: {
58        personalApiKey: {
59          type: 'string',
60          description:
61            'PostHog personal API key (required for API reads/writes).',
62        },
63        projectApiKey: {
64          type: 'string',
65          description:
66            'PostHog project API key (required for capture/ingest events).',
67        },
68      },
69    },
70    example: {
71      personalApiKey: 'phx_personal_api_key',
72      projectApiKey: 'phc_project_api_key',
73    },
74  },
75  healthCheck: {
76    method: 'custom',
77    timeoutMs: 5000,
78  },
79  docsUrl: 'https://posthog.com/docs',
80  byokSetup: {
81    setupInstructions:
82      'Generate a PostHog personal API key for read/write operations and a project API key for event capture.',
83  },
84});