import { getErrorMessage } from '@sim/utils/errors' import { getPostHogIngestBaseUrl } from '@/tools/posthog/utils' import type { ToolConfig } from '@/tools/types' export interface PostHogCaptureEventParams { projectApiKey: string region?: 'us' | 'eu' host?: string event: string distinctId: string properties?: string timestamp?: string } export interface PostHogCaptureEventResponse { success: boolean output: { status: string } } export const captureEventTool: ToolConfig = { id: 'posthog_capture_event', name: 'PostHog Capture Event', description: 'Capture a single event in PostHog. Use this to track user actions, page views, or custom events.', version: '1.0.0', params: { projectApiKey: { type: 'string', required: true, visibility: 'user-only', description: 'PostHog Project API Key (public token for event ingestion)', }, region: { type: 'string', required: false, visibility: 'user-only', description: 'PostHog region: us (default) or eu', default: 'us', }, host: { type: 'string', required: false, visibility: 'user-only', description: 'Self-hosted PostHog instance host (e.g., "posthog.mycompany.com"). Overrides the region setting when provided.', }, event: { type: 'string', required: true, visibility: 'user-or-llm', description: 'The name of the event to capture (e.g., "page_view", "button_clicked")', }, distinctId: { type: 'string', required: true, visibility: 'user-or-llm', description: 'Unique identifier for the user or device (e.g., "user123", email, or device UUID)', }, properties: { type: 'string', required: false, visibility: 'user-or-llm', description: 'JSON string of event properties (e.g., {"button_name": "signup", "page": "homepage"})', }, timestamp: { type: 'string', required: false, visibility: 'user-or-llm', description: 'ISO 8601 timestamp for when the event occurred. If not provided, uses current time', }, }, request: { url: (params) => { const baseUrl = getPostHogIngestBaseUrl(params.region, params.host) return `${baseUrl}/capture/` }, method: 'POST', headers: (params) => ({ 'Content-Type': 'application/json', }), body: (params) => { const body: Record = { api_key: params.projectApiKey, event: params.event, distinct_id: params.distinctId, } if (params.properties) { try { body.properties = JSON.parse(params.properties) } catch (error) { throw new Error(`Invalid properties JSON: ${getErrorMessage(error)}`) } } if (params.timestamp) { body.timestamp = params.timestamp } return body }, }, transformResponse: async (response: Response) => { const data = await response.json() const success = data.status === 1 return { success, output: { status: success ? 'Event captured successfully' : `Event capture failed (status: ${data.status})`, }, } }, outputs: { status: { type: 'string', description: 'Status message indicating whether the event was captured successfully', }, }, }