Skip to content

: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.

2.1 KB
Raw Blame
import { describe, expect, it, vi } from 'vitest'

import { buildAgentHelp, toCliSyntax } from '@/cli/agent-help'
import { getCliTools } from '@/cli/tools'

describe('CLI agent help', () => {
    it('rewrites exec invocations to CLI syntax', () => {
        expect(toCliSyntax('posthog:exec({ "command": "search dashboard" })')).toBe('posthog-cli api search dashboard')
        expect(toCliSyntax('posthog:exec({ "command": "tools" })')).toBe('posthog-cli api tools')
    })

    it('quotes JSON payloads and unescapes embedded quotes', () => {
        expect(
            toCliSyntax(
                'posthog:exec({ "command": "call read-data-schema {\\"query\\": {\\"kind\\": \\"events\\"}}" })'
            )
        ).toBe(`posthog-cli api call read-data-schema '{"query": {"kind": "events"}}'`)
    })

    it('builds the agent guide from the MCP exec templates', () => {
        const help = buildAgentHelp(getCliTools())

        expect(help).toContain('posthog-cli api info <tool_name>')
        expect(help).toContain('SCHEMA DRILL-DOWN RULE')
        expect(help).not.toContain('posthog:exec(')
        // Tool-domain index and query-tool catalog come from the bundled registry.
        expect(help).toContain('query-trends')
    })

    it('does not require credentials to build', () => {
        expect(() => buildAgentHelp(getCliTools())).not.toThrow()
    })

    it('skips unavailable tools without stderr warnings', () => {
        const stderrWrite = vi.spyOn(process.stderr, 'write').mockImplementation(() => true)

        try {
            const toolNames = getCliTools().map((tool) => tool.name)

            expect(toolNames).not.toContain('evaluations-get')
            expect(stderrWrite).not.toHaveBeenCalled()
        } finally {
            stderrWrite.mockRestore()
        }
    })

    it('hides AI-consent tools unless consent is confirmed', () => {
        const withoutConsent = getCliTools().map((tool) => tool.name)
        const withConsent = getCliTools({ aiConsentGiven: true }).map((tool) => tool.name)

        expect(withoutConsent).not.toContain('llma-summarization-create')
        expect(withConsent).toContain('llma-summarization-create')
    })
})