chore(workflows): pin which first run banner asks an agent for help

Red step: the logic stub answers no missing data yet.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

Author: Silthus

products/workflows/frontend/firstRun/firstRunAgentHelpLogic.test.ts

@@ -0,0 +1,126 @@
+import { expectLogic } from 'kea-test-utils'
+import posthog from 'posthog-js'
+
+import { useMocks } from '~/mocks/jest'
+import { initKeaTests } from '~/test/init'
+
+import type { HogFlowTemplateApi } from '../generated/api.schemas'
+import { firstRunAgentHelpLogic } from './firstRunAgentHelpLogic'
+
+const WELCOME = '019b6f44-f9a3-0000-c4a7-b8050d25d690'
+
+const TEMPLATES: Partial<HogFlowTemplateApi>[] = [
+    {
+        id: 'onboarding',
+        name: 'Onboarding',
+        scope: 'global',
+        starts_on: { kind: 'event', events: ['$pageview'], detail: '' },
+        tags: [],
+        actions: [],
+    },
+    {
+        id: WELCOME,
+        name: 'Welcome',
+        scope: 'global',
+        starts_on: { kind: 'event', events: ['user signed up', 'signed_up'], detail: '' },
+        tags: [],
+        actions: [],
+    },
+]
+
+describe('firstRunAgentHelpLogic', () => {
+    let logic: ReturnType<typeof firstRunAgentHelpLogic.build>
+    let capture: jest.SpyInstance
+
+    let seenEvents: string[]
+    let personProperties: string[]
+
+    beforeEach(() => {
+        seenEvents = []
+        personProperties = []
+        useMocks({
+            get: {
+                '/api/projects/:team_id/hog_flow_templates/': { count: TEMPLATES.length, results: TEMPLATES },
+                '/api/projects/:team_id/event_definitions/': ({ request }) => {
+                    const names = new URL(request.url).searchParams.get('names')?.split(',') ?? []
+                    const seen = names.filter((name) => seenEvents.includes(name))
+                    return [
+                        200,
+                        {
+                            count: seen.length,
+                            results: seen.map((name) => ({ id: name, name, last_seen_at: '2026-10-01T00:00:00Z' })),
+                        },
+                    ]
+                },
+                '/api/projects/:team_id/property_definitions/': ({ request }) => {
+                    const params = new URL(request.url).searchParams
+                    const names = params.get('properties')?.split(',') ?? []
+                    const definitions =
+                        params.get('type') === 'person' ? names.filter((name) => personProperties.includes(name)) : []
+                    return [
+                        200,
+                        { count: definitions.length, results: definitions.map((name) => ({ id: name, name })) },
+                    ]
+                },
+            },
+        })
+        initKeaTests()
+        capture = jest.spyOn(posthog, 'capture').mockImplementation()
+    })
+
+    async function openFirstRun(project: { seenEvents: string[]; personProperties: string[] }): Promise<void> {
+        seenEvents = project.seenEvents
+        personProperties = project.personProperties
+        logic = firstRunAgentHelpLogic()
+        logic.mount()
+        await expectLogic(logic).toFinishAllListeners()
+    }
+
+    afterEach(() => {
+        logic?.unmount()
+        jest.restoreAllMocks()
+    })
+
+    const agentHelpShownCalls = (): unknown[][] =>
+        capture.mock.calls.filter(([event]) => event === 'workflows first run agent help shown')
+
+    it.each([
+        {
+            project: 'without a signup event',
+            seenEvents: ['$pageview'],
+            personProperties: ['email'],
+            missing: 'signup_event',
+        },
+        {
+            project: 'with signups but no email property',
+            seenEvents: ['signed_up'],
+            personProperties: ['name'],
+            missing: 'email',
+        },
+        {
+            project: 'without a signup event or an email property',
+            seenEvents: [],
+            personProperties: [],
+            missing: 'signup_event',
+        },
+        {
+            project: 'with signups and an email property',
+            seenEvents: ['signed_up', '$pageview'],
+            personProperties: ['email'],
+            missing: null,
+        },
+    ])('asks a project $project for help with $missing', async ({ missing, ...project }) => {
+        await openFirstRun(project)
+
+        expect(logic.values.missingData).toEqual(missing)
+        expect(agentHelpShownCalls()).toEqual(missing ? [['workflows first run agent help shown', { missing }]] : [])
+    })
+
+    it('reports a copied prompt with the data it fixes', async () => {
+        await openFirstRun({ seenEvents: ['signed_up'], personProperties: [] })
+
+        logic.actions.reportPromptCopied()
+
+        expect(capture).toHaveBeenCalledWith('workflows first run agent prompt copied', { missing: 'email' })
+    })
+})

products/workflows/frontend/firstRun/firstRunAgentHelpLogic.ts

@@ -0,0 +1,25 @@
+import { MakeLogicType, actions, kea, path, selectors } from 'kea'
+
+export type MissingData = 'signup_event' | 'email'
+
+// Generated by kea-typegen. Update if you're an agent, ignore if you're human.
+export interface firstRunAgentHelpLogicValues {
+    missingData: MissingData | null
+}
+
+// Generated by kea-typegen. Update if you're an agent, ignore if you're human.
+export interface firstRunAgentHelpLogicActions {
+    reportPromptCopied: () => true
+}
+
+export type firstRunAgentHelpLogicType = MakeLogicType<firstRunAgentHelpLogicValues, firstRunAgentHelpLogicActions>
+
+export const firstRunAgentHelpLogic = kea<firstRunAgentHelpLogicType>([
+    path(['products', 'workflows', 'frontend', 'firstRun', 'firstRunAgentHelpLogic']),
+    actions({
+        reportPromptCopied: true,
+    }),
+    selectors({
+        missingData: [() => [], (): MissingData | null => null],
+    }),
+])