agency/.pnpm-store/v3/files/62/d2f85b022632845aaad36a392fb62e3f52717a6c5b4e641fe56d4277c9cfd0752fb7335adadf3a73bd912303ffe222b74a91e2aaa98108d85c384d75dae788

/**
 * What each event MEANS and what it CARRIES.
 *
 * `names.ts` says which events exist. This says what they are — one entry per
 * name, a sentence a human can read and a property list a machine can check.
 *
 * Two rules keep this honest, and both matter more than completeness:
 *
 * 1. A property is listed only where there is EVIDENCE for it — a docstring in
 *    the vocabulary, or a live `capture()` call in a Hanzo surface. An invented
 *    property is worse than an absent one: it teaches a wrong shape to whoever
 *    reads this next, and to anything trained on the corpus.
 *
 * 2. Every event is OPEN. The wire accepts free-form properties and always has,
 *    so `props` is what we know an event carries, never the exhaustive set. A
 *    property absent here is undocumented, not forbidden — which is why the
 *    server records an unknown one rather than refusing it.
 *
 * The dimensions of an event are properties, never part of its name:
 * `deploy_succeeded` with `{framework:'static'}`, never `deploy_static_succeeded`.
 * That is what makes a funnel line up across surfaces, and it is why this file
 * can exist at all.
 */
const NONE = {};
/**
 * The catalog, keyed by the wire name (the value in EVENTS, not the constant).
 * Keying by the wire name is deliberate: it is what arrives at the door, what
 * lands in the warehouse, and therefore what anything reading this has in hand.
 */
export const SCHEMA = {
    // ── Signup funnel ────────────────────────────────────────────────
    signup_viewed: { summary: 'The signup form was shown.', props: NONE },
    signup_submitted: { summary: 'The signup form was submitted.', props: NONE },
    signup_verified: { summary: 'The address on a signup was verified.', props: NONE },
    signup_completed: { summary: 'A new account exists and is usable.', props: NONE },
    login_completed: {
        summary: 'A RETURNING user authenticated. Distinct from signup_completed on purpose — ' +
            'folding the two makes every returning login inflate the signup count.',
        props: NONE,
    },
    first_action: {
        summary: 'Activation: the first moment of real value. ONE event for every product — ' +
            'which moment it was is the `action` property, never a new event name.',
        props: {
            action: {
                type: 'string',
                doc: 'The product-specific moment that counted as activation.',
                values: ['api_call', 'app_live', 'chat_reply'],
            },
        },
    },
    // ── Waitlist and referral ────────────────────────────────────────
    waitlist_joined: { summary: 'Someone joined a waitlist.', props: NONE },
    waitlist_shared: { summary: 'Someone shared their waitlist position.', props: NONE },
    referral_used: { summary: 'A referral code was applied.', props: NONE },
    referral_claimed: { summary: 'A referral reward was claimed.', props: NONE },
    // ── Upgrade intent and purchase ──────────────────────────────────
    pricing_viewed: { summary: 'The pricing surface was shown.', props: NONE },
    plan_clicked: {
        summary: 'A specific plan was chosen from pricing.',
        props: { plan: { type: 'string', doc: 'The plan name as the catalog spells it.' } },
    },
    checkout_started: {
        summary: 'Checkout opened for a plan.',
        props: { plan: { type: 'string', doc: 'The plan name as the catalog spells it.' } },
    },
    order_completed: { summary: 'Payment succeeded and the order exists.', props: NONE },
    // ── Feature usage ────────────────────────────────────────────────
    feature_used: {
        summary: 'The generic usage event, for a surface with no dedicated name yet.',
        props: NONE,
    },
    api_key_created: { summary: 'An API key was minted.', props: NONE },
    app_created: {
        summary: 'An app now exists.',
        props: { source: { type: 'string', doc: 'Where the app came from — a template, an import, or empty.' } },
    },
    project_created: { summary: 'A project now exists.', props: NONE },
    agent_created: { summary: 'An agent was defined.', props: NONE },
    chat_started: { summary: 'A conversation began.', props: NONE },
    chat_message_sent: {
        summary: 'A turn was sent in a conversation.',
        props: { hasImages: { type: 'boolean', doc: 'Whether the turn carried image attachments.' } },
    },
    model_switched: {
        summary: 'The user changed model or endpoint — the strongest quality signal a chat ' +
            'surface emits, because a switch usually follows a bad answer.',
        props: NONE,
    },
    task_started: { summary: 'A task began.', props: NONE },
    task_completed: { summary: 'A task finished.', props: NONE },
    // ── Build → ship ─────────────────────────────────────────────────
    // `build_*` is a model producing an artifact; `deploy_*` is that artifact
    // going live. Intent is never the same event as the artifact existing.
    build_started: {
        summary: 'A build was requested.',
        props: {
            mode: { type: 'string', doc: 'How the build was invoked.' },
            withBase: { type: 'boolean', doc: 'Whether the build provisions a Base alongside the app.' },
        },
    },
    generation_completed: {
        summary: 'A model finished producing an artifact — an app build, a chat reply, an ' +
            'agent run. It carries its own duration, so no paired start event is needed.',
        props: { durationMs: { type: 'number', doc: 'Wall-clock milliseconds the generation took.' } },
    },
    generation_failed: { summary: 'A model failed to produce its artifact.', props: NONE },
    deploy_started: {
        summary: 'A deploy was requested.',
        props: {
            framework: { type: 'string', doc: 'The framework detected or declared for the deploy.' },
            update: { type: 'boolean', doc: 'Whether this replaces an existing deployment.' },
            source: { type: 'string', doc: 'What triggered the deploy.' },
        },
    },
    deploy_succeeded: { summary: 'The artifact is live.', props: NONE },
    deploy_failed: { summary: 'The deploy did not reach live.', props: NONE },
};