:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
import { afterEach, beforeAll, describe, expect, it } from 'vitest'
import {
type CreatedResources,
TEST_ORG_ID,
TEST_PROJECT_ID,
cleanupResources,
createTestClient,
createTestContext,
generateUniqueKey,
parseToolResponse,
setActiveProjectAndOrg,
validateEnvironmentVariables,
} from '@/shared/test-utils'
import { GENERATED_TOOLS } from '@/tools/generated/actions'
import type { Context } from '@/tools/types'
describe('Actions', { concurrent: false }, () => {
let context: Context
const createdResources: CreatedResources = {
featureFlags: [],
insights: [],
dashboards: [],
surveys: [],
actions: [],
cohorts: [],
}
beforeAll(async () => {
validateEnvironmentVariables()
const client = createTestClient()
context = createTestContext(client)
await setActiveProjectAndOrg(context, TEST_PROJECT_ID!, TEST_ORG_ID!)
})
afterEach(async () => {
await cleanupResources(context.api, TEST_PROJECT_ID!, createdResources)
})
describe('action-create tool', () => {
const createTool = GENERATED_TOOLS['action-create']!()
it('should create an action with event-based step', async () => {
const params = {
name: `Test Action ${generateUniqueKey('action')}`,
description: 'Integration test action',
steps: [
{
event: '$pageview',
url: '/signup',
url_matching: 'contains' as const,
},
],
tags: ['test', 'integration'],
}
const result = await createTool.handler(context, params)
const actionData = parseToolResponse(result)
expect(actionData.id).toBeTruthy()
expect(actionData.name).toBe(params.name)
expect(actionData.description).toBe(params.description)
expect(actionData._posthogUrl).toContain('/data-management/actions/')
createdResources.actions.push(actionData.id)
})
it('should create an action with autocapture step', async () => {
const params = {
name: `Click Action ${generateUniqueKey('click')}`,
steps: [
{
event: '$autocapture',
tag_name: 'button',
text: 'Sign Up',
text_matching: 'contains' as const,
selector: 'div.signup-form > button',
},
],
}
const result = await createTool.handler(context, params)
const actionData = parseToolResponse(result)
expect(actionData.id).toBeTruthy()
expect(actionData.name).toBe(params.name)
createdResources.actions.push(actionData.id)
})
it('should create an action with multiple steps (OR conditions)', async () => {
const params = {
name: `Multi-step Action ${generateUniqueKey('multi')}`,
description: 'Action with multiple trigger conditions',
steps: [
{
event: '$pageview',
url: '/pricing',
url_matching: 'contains' as const,
},
{
event: '$autocapture',
tag_name: 'a',
href: '/pricing',
href_matching: 'contains' as const,
},
],
}
const result = await createTool.handler(context, params)
const actionData = parseToolResponse(result)
expect(actionData.id).toBeTruthy()
expect(actionData.name).toBe(params.name)
expect(actionData.steps).toHaveLength(2)
createdResources.actions.push(actionData.id)
})
it('should create an action with custom event', async () => {
const params = {
name: `Custom Event Action ${generateUniqueKey('custom')}`,
steps: [
{
event: 'user_signed_up',
},
],
}
const result = await createTool.handler(context, params)
const actionData = parseToolResponse(result)
expect(actionData.id).toBeTruthy()
expect(actionData.name).toBe(params.name)
createdResources.actions.push(actionData.id)
})
})
describe('actions-get-all tool', () => {
const getAllTool = GENERATED_TOOLS['actions-get-all']!()
const createTool = GENERATED_TOOLS['action-create']!()
it('should list all actions', async () => {
const createResult = await createTool.handler(context, {
name: `List Test Action ${generateUniqueKey('list')}`,
steps: [{ event: '$pageview' }],
})
const createdAction = parseToolResponse(createResult)
createdResources.actions.push(createdAction.id)
const result = await getAllTool.handler(context, {})
const response = parseToolResponse(result)
expect(Array.isArray(response.results)).toBe(true)
expect(response.results.some((a: { id: number }) => a.id === createdAction.id)).toBe(true)
})
it('should support pagination', async () => {
const result = await getAllTool.handler(context, { limit: 5, offset: 0 })
const response = parseToolResponse(result)
expect(Array.isArray(response.results)).toBe(true)
expect(response.results.length).toBeLessThanOrEqual(5)
})
})
describe('action-get tool', () => {
const getTool = GENERATED_TOOLS['action-get']!()
const createTool = GENERATED_TOOLS['action-create']!()
it('should get a specific action by ID', async () => {
const createResult = await createTool.handler(context, {
name: `Get Test Action ${generateUniqueKey('get')}`,
description: 'Test description for get',
steps: [
{
event: '$pageview',
url: '/test',
},
],
})
const createdAction = parseToolResponse(createResult)
createdResources.actions.push(createdAction.id)
const result = await getTool.handler(context, { id: createdAction.id })
const actionData = parseToolResponse(result)
expect(actionData.id).toBe(createdAction.id)
expect(actionData.name).toBe(createdAction.name)
expect(actionData.description).toBe('Test description for get')
expect(actionData._posthogUrl).toContain('/data-management/actions/')
})
})
describe('action-update tool', () => {
const updateTool = GENERATED_TOOLS['action-update']!()
const createTool = GENERATED_TOOLS['action-create']!()
it('should update an action name and description', async () => {
const originalName = `Original Action ${generateUniqueKey('original')}`
const createResult = await createTool.handler(context, {
name: originalName,
steps: [{ event: '$pageview' }],
})
const createdAction = parseToolResponse(createResult)
createdResources.actions.push(createdAction.id)
const updatedName = `Updated Action ${generateUniqueKey('updated')}`
const result = await updateTool.handler(context, {
id: createdAction.id,
name: updatedName,
description: 'Updated description',
})
const updatedAction = parseToolResponse(result)
expect(updatedAction.id).toBe(createdAction.id)
expect(updatedAction.name).toBe(updatedName)
expect(updatedAction.description).toBe('Updated description')
})
it('should update action steps', async () => {
const createResult = await createTool.handler(context, {
name: `Steps Update Action ${generateUniqueKey('steps')}`,
steps: [{ event: '$pageview' }],
})
const createdAction = parseToolResponse(createResult)
createdResources.actions.push(createdAction.id)
const result = await updateTool.handler(context, {
id: createdAction.id,
steps: [
{
event: '$pageview',
url: '/updated-page',
url_matching: 'contains' as const,
},
{
event: '$autocapture',
tag_name: 'button',
},
],
})
const updatedAction = parseToolResponse(result)
expect(updatedAction.id).toBe(createdAction.id)
expect(updatedAction.steps).toHaveLength(2)
})
it('should update action tags', async () => {
const createResult = await createTool.handler(context, {
name: `Tags Update Action ${generateUniqueKey('tags')}`,
steps: [{ event: '$pageview' }],
tags: ['original'],
})
const createdAction = parseToolResponse(createResult)
createdResources.actions.push(createdAction.id)
const result = await updateTool.handler(context, {
id: createdAction.id,
tags: ['updated', 'new-tag'],
})
const updatedAction = parseToolResponse(result)
expect(updatedAction.id).toBe(createdAction.id)
expect(updatedAction.tags).toContain('updated')
expect(updatedAction.tags).toContain('new-tag')
})
})
describe('action-delete tool', () => {
const deleteTool = GENERATED_TOOLS['action-delete']!()
const createTool = GENERATED_TOOLS['action-create']!()
const getAllTool = GENERATED_TOOLS['actions-get-all']!()
it('should delete an action', async () => {
const createResult = await createTool.handler(context, {
name: `Delete Test Action ${generateUniqueKey('delete')}`,
steps: [{ event: '$pageview' }],
})
const createdAction = parseToolResponse(createResult)
// Don't add to createdResources since we're deleting it
await deleteTool.handler(context, { id: createdAction.id })
// Verify it's no longer in the list
const listResult = await getAllTool.handler(context, {})
const response = parseToolResponse(listResult)
expect(response.results.some((a: { id: number }) => a.id === createdAction.id)).toBe(false)
})
})
})