@project-ava-supernova/core 0.2.71

package/dist/dataset/emitter.js

@@ -0,0 +1,157 @@
+/**
+ * Typed Ava event emitter.
+ *
+ * Architecture:
+ *   - The emitter holds no business logic. It exists so the agent can
+ *     fire decision events without knowing what (if anything) is
+ *     listening. Capture is the consumer's problem; the agent just
+ *     emits.
+ *   - Trajectory context (trajectory_id, session_id, surface, mode,
+ *     model_id) lives in AsyncLocalStorage so emit sites don't have to
+ *     thread it through every call. Whoever opens an Agent.run() wraps
+ *     the run in `withTrajectory()` and every emit underneath inherits
+ *     the envelope.
+ *   - Payloads are deep-cloned at emit time via `structuredClone`. A
+ *     consumer that runs later (microtask, async I/O, whatever) can
+ *     never observe a mutated event because the mutation happened
+ *     after the snapshot. This is the root-cause fix for the
+ *     multi-writer corruption that disabled capture in the first
+ *     place.
+ *   - Handlers run on a microtask so emit() is non-blocking and can
+ *     never delay the user-visible response. A throwing handler
+ *     cannot crash the agent — errors are swallowed by design,
+ *     because dataset capture failing is never worth taking the chat
+ *     down for.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { randomUUID } from 'node:crypto';
+const trajectoryStorage = new AsyncLocalStorage();
+/**
+ * Open a trajectory context for the duration of `fn`. Every event
+ * emitted inside `fn` (sync or async) inherits this envelope. Wrap
+ * each top-level Agent.run() in this.
+ */
+export function withTrajectory(ctx, fn) {
+    const trajectory_id = ctx.trajectory_id ?? randomUUID();
+    const toolsSoFar = ctx.toolsSoFar ?? [];
+    const startedAt = ctx.startedAt ?? Date.now();
+    return trajectoryStorage.run({ ...ctx, trajectory_id, toolsSoFar, startedAt }, fn);
+}
+/**
+ * Open a child trajectory whose `parent_trajectory_id` points at the
+ * currently-active trajectory. Use this when an orchestrator spawns a
+ * sub-agent (e.g. Builder inside a planning run) so we can reconstruct
+ * the orchestration tree at training time.
+ */
+export function withChildTrajectory(overrides, fn) {
+    const parent = trajectoryStorage.getStore();
+    if (!parent) {
+        // No parent — degrade to a fresh top-level trajectory rather than
+        // throwing. Calling code shouldn't crash because of bookkeeping.
+        return withTrajectory({
+            session_id: overrides.session_id ?? 'unknown',
+            surface: overrides.surface ?? 'cli',
+            mode: overrides.mode ?? 'work',
+            model_id: overrides.model_id ?? 'unknown',
+            ...overrides,
+        }, fn);
+    }
+    return withTrajectory({
+        parent_trajectory_id: parent.trajectory_id,
+        session_id: parent.session_id,
+        surface: parent.surface,
+        mode: parent.mode,
+        model_id: parent.model_id,
+        ...overrides,
+    }, fn);
+}
+/** Read the current trajectory context. Returns undefined if not in a trajectory. */
+export function getTrajectory() {
+    return trajectoryStorage.getStore();
+}
+class AvaEventEmitter {
+    handlers = new Map();
+    wildcardHandlers = new Set();
+    /**
+     * Subscribe to one event type. Returns an unsubscribe function.
+     * Handlers run on a microtask after `emit` returns, so handler work
+     * cannot block or delay the emitter.
+     */
+    on(type, handler) {
+        let set = this.handlers.get(type);
+        if (!set) {
+            set = new Set();
+            this.handlers.set(type, set);
+        }
+        set.add(handler);
+        return () => {
+            set.delete(handler);
+        };
+    }
+    /** Subscribe to every event. Used by the dataset capture consumer. */
+    onAll(handler) {
+        this.wildcardHandlers.add(handler);
+        return () => {
+            this.wildcardHandlers.delete(handler);
+        };
+    }
+    /**
+     * Emit an event. Caller must be inside a `withTrajectory(...)` scope —
+     * if not, the emit is silently dropped (we don't throw because the
+     * agent shouldn't crash because of bookkeeping). Returns the
+     * generated event_id so callers can cross-reference it from a
+     * follow-up event (e.g. `tool_result.tool_choice_event_id`).
+     * Handlers run on a microtask, so emit() is non-blocking.
+     */
+    emit(type, payload) {
+        const ctx = trajectoryStorage.getStore();
+        if (!ctx)
+            return '';
+        const event = {
+            event_id: randomUUID(),
+            event_type: type,
+            timestamp: new Date().toISOString(),
+            trajectory_id: ctx.trajectory_id,
+            parent_trajectory_id: ctx.parent_trajectory_id,
+            session_id: ctx.session_id,
+            surface: ctx.surface,
+            mode: ctx.mode,
+            model_id: ctx.model_id,
+            payload: structuredClone(payload),
+        };
+        const typeHandlers = this.handlers.get(type);
+        const wildcardHandlers = this.wildcardHandlers;
+        queueMicrotask(() => {
+            if (typeHandlers) {
+                for (const h of typeHandlers) {
+                    this.runHandlerSafe(h, event);
+                }
+            }
+            for (const h of wildcardHandlers) {
+                this.runHandlerSafe(h, event);
+            }
+        });
+        return event.event_id;
+    }
+    /** For tests: drop every subscriber. */
+    clearAllHandlers() {
+        this.handlers.clear();
+        this.wildcardHandlers.clear();
+    }
+    runHandlerSafe(handler, event) {
+        try {
+            const result = handler(event);
+            if (result && typeof result.catch === 'function') {
+                result.catch(() => {
+                    // Dataset capture errors must never bubble. By design.
+                });
+            }
+        }
+        catch {
+            // Same.
+        }
+    }
+}
+/** Singleton — one event bus per process. */
+export const avaEvents = new AvaEventEmitter();
+//# sourceMappingURL=emitter.js.map

package/dist/dataset/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../src/dataset/emitter.ts"],"names":[],"mappings":"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"}

package/dist/dataset/events.d.ts

@@ -0,0 +1,360 @@
+/**
+ * Ava Action Event Taxonomy
+ *
+ * The canonical type definitions for every event Ava emits as she works.
+ * This file is the contract between the agent (which emits events) and the
+ * dataset capture consumer (which routes events into per-dataset JSONL
+ * files for the future own-model training run).
+ *
+ * Design principles:
+ *   1. Every event represents an Ava DECISION or ACTION — never a user
+ *      action, never a system tick. If it isn't something Ava chose or
+ *      did, it doesn't belong here.
+ *   2. Every event carries enough context to reconstruct the decision
+ *      without referencing the live conversation. No back-pointers into
+ *      mutable runtime state.
+ *   3. User-identifying or proprietary payloads are summarised, not
+ *      copied verbatim. File contents become "ts file, 200 lines";
+ *      prompts become category + intent; tool args become a one-line
+ *      summary. Raw text of the user's message never lands in an event.
+ *   4. Trajectory IDs glue related events together across files so we
+ *      can reconstruct multi-step flows at training time.
+ *
+ * Files in this directory:
+ *   events.ts    — this file, the taxonomy (types only, no runtime).
+ *   emitter.ts   — typed EventEmitter (next step).
+ *   consumer.ts  — subscribes, snapshots, writes JSONL (next step).
+ *   routing.ts   — maps event_type → which dataset files it belongs in.
+ */
+export type AvaSurface = 'cli' | 'extension' | 'ide' | 'companion';
+export type AvaMode = 'work' | 'plan' | 'chat' | 'teach' | 'security' | 'brainstorm' | 'write' | 'desktop' | 'health' | 'design';
+/**
+ * Every event carries this envelope. The discriminator is `event_type`;
+ * `payload` is typed per event. `trajectory_id` groups events from a
+ * single Ava-Run-loop so consumers can reconstruct multi-step flows.
+ */
+export interface AvaEvent<T extends AvaEventType = AvaEventType> {
+    event_id: string;
+    event_type: T;
+    timestamp: string;
+    trajectory_id: string;
+    parent_trajectory_id?: string;
+    session_id: string;
+    surface: AvaSurface;
+    mode: AvaMode;
+    model_id: string;
+    payload: AvaEventPayloadMap[T];
+}
+export type AvaEventType = 'tool_choice' | 'tool_result' | 'tool_chain_complete' | 'persona_decision' | 'persona_handoff' | 'persona_complete' | 'persona_veto' | 'team_depth_decision' | 'verification_decision' | 'correction_received' | 'verification_evidence' | 'task_classification' | 'routing_decision' | 'tool_error' | 'error_guidance_applied' | 'recovery_action' | 'memory_save' | 'memory_recall' | 'memory_update' | 'memory_consolidation' | 'memory_forget' | 'continuation_stall_detected' | 'continuation_nudge_fired' | 'mode_switch' | 'generation_started' | 'generation_complete' | 'generation_user_action' | 'knowledge_pack_activated' | 'knowledge_pack_used' | 'context_compression' | 'vision_bridge' | 'credits_charged';
+/** Ava decided to call a tool. Fired BEFORE the call executes. */
+export interface ToolChoicePayload {
+    tool_name: string;
+    args_summary: string;
+    reasoning_summary?: string;
+    prev_tools_in_trajectory: string[];
+    is_retry_of?: string;
+}
+/** Tool returned. Fired AFTER the result lands. */
+export interface ToolResultPayload {
+    tool_name: string;
+    tool_choice_event_id: string;
+    success: boolean;
+    result_summary: string;
+    duration_ms: number;
+    error_summary?: string;
+}
+/** A tool chain finished — Ava stopped calling tools and produced a final response. */
+export interface ToolChainCompletePayload {
+    tool_count: number;
+    total_duration_ms: number;
+    outcome: 'task_completed' | 'gave_up' | 'asked_user' | 'hit_loop_limit';
+    outcome_summary: string;
+}
+/** Conductor decided which persona team to spawn for this task. */
+export interface PersonaDecisionPayload {
+    task_classification: string;
+    chosen_team: string[];
+    reasoning_summary: string;
+}
+/** One persona finished and handed work to the next. */
+export interface PersonaHandoffPayload {
+    from_persona: string;
+    to_persona: string;
+    artifacts_produced: string[];
+    context_word_count: number;
+}
+/** A persona finished its leg of the orchestration. */
+export interface PersonaCompletePayload {
+    persona: string;
+    output_summary: string;
+    success: boolean;
+    duration_ms: number;
+}
+/**
+ * A veto-capable persona (Challenger, Fact Checker, Verifier…) halted the
+ * pipeline because its output tripped its veto signal. Strong negative
+ * signal — the team caught bad work before it shipped. The raw veto reason
+ * is never captured; only the kind of veto and how substantive it was.
+ */
+export interface PersonaVetoPayload {
+    vetoing_persona: string;
+    veto_category: string;
+    reason_word_count: number;
+}
+/**
+ * The Conductor decided whether to run the light or full persona team for
+ * this task. Trains the "how much orchestration does this task need" signal.
+ * Shape-only: mode, the depth, what drove it, and team size.
+ */
+export interface TeamDepthDecisionPayload {
+    mode: string;
+    depth: 'light' | 'full';
+    trigger: 'classifier' | 'regex_fallback';
+    team_size: number;
+}
+/**
+ * Ava chose either to verify (read/grep/search) before answering, or to
+ * answer directly. Captures the decision and what tools (if any) were
+ * used to verify. Outcome quality gets joined in at training time from
+ * `correction_received` events on the same trajectory.
+ */
+export interface VerificationDecisionPayload {
+    verified: boolean;
+    verification_tools_used: string[];
+    response_word_count: number;
+    question_signature: string;
+}
+/**
+ * The user pushed back on a previous response. Strong signal the prior
+ * answer was wrong. Linked to the trajectory whose verification decision
+ * we want to re-evaluate.
+ */
+export interface CorrectionReceivedPayload {
+    corrected_trajectory_id: string;
+    original_verification: boolean;
+    correction_signature: string;
+}
+/**
+ * Did Ava's evidence-gathering actually *succeed* this run — not just "was
+ * verification attempted" (that's verification_decision) but "did the
+ * read-only verify tools come back ok, and did the soft-honesty gate flag
+ * an unbacked claim". This is the verifiability signal: a self-generated
+ * trajectory is only training-grade if its claims can be checked. All
+ * shape-only counts/booleans — no tool output, no response text.
+ */
+export interface VerificationEvidencePayload {
+    verify_tool_calls: number;
+    verify_tool_successes: number;
+    distinct_verify_tools: number;
+    verified_before_response: boolean;
+    claim_flagged: boolean;
+}
+/** task_classifier categorised an incoming request. */
+export interface TaskClassificationPayload {
+    input_signature: string;
+    classified_as: string;
+    classifier_model: string;
+    confidence?: number;
+}
+/** Auto Mode picked a model based on the classification. */
+export interface RoutingDecisionPayload {
+    classification: string;
+    chosen_model: string;
+    fallback_model?: string;
+    reason: string;
+}
+/** A tool failed. */
+export interface ToolErrorPayload {
+    tool_name: string;
+    tool_result_event_id: string;
+    error_pattern_match?: string;
+    error_summary: string;
+}
+/** error-guidance.ts surfaced fix advice based on a pattern match. */
+export interface ErrorGuidanceAppliedPayload {
+    tool_error_event_id: string;
+    pattern: string;
+    guidance_summary: string;
+}
+/** Ava's next move after an error — did she retry, switch tools, give up, escalate? */
+export interface RecoveryActionPayload {
+    tool_error_event_id: string;
+    recovery_kind: 'retry_same' | 'retry_with_change' | 'switch_tool' | 'ask_user' | 'gave_up';
+    next_tool?: string;
+    eventually_succeeded?: boolean;
+}
+/** Ava saved a memory. */
+export interface MemorySavePayload {
+    scope: 'global' | 'project';
+    /** Mirrors `MemoryLayer` from packages/core/src/memory/types.ts. */
+    layer: 'person' | 'workflow' | 'project';
+    category: string;
+    source: 'explicit' | 'auto-extract' | 'reflection' | 'consolidation' | 'memory-agent';
+    content_signature: string;
+    confidence?: number;
+}
+/** Ava recalled memories. */
+export interface MemoryRecallPayload {
+    query_signature: string;
+    results_count: number;
+    results_used_count: number;
+}
+/** Ava updated an existing memory. */
+export interface MemoryUpdatePayload {
+    scope: 'global' | 'project';
+    what_changed: 'content' | 'confidence' | 'tags' | 'metadata';
+    reason: string;
+}
+/** Background consolidation merged duplicate memories. */
+export interface MemoryConsolidationPayload {
+    count_before: number;
+    count_after: number;
+    scope: 'global' | 'project';
+}
+/** Background forgetting removed stale memories. */
+export interface MemoryForgetPayload {
+    count_forgotten: number;
+    reason: 'low_confidence' | 'age' | 'superseded';
+}
+/** Agent detected a stall (response narrated intent but produced no tool call). */
+export interface ContinuationStallDetectedPayload {
+    response_summary: string;
+    stall_pattern: string;
+}
+/** Auto-continuation nudge fired. */
+export interface ContinuationNudgeFiredPayload {
+    stall_event_id: string;
+    nudge_action: string;
+    recovered: boolean;
+}
+/** Ava switched mode mid-conversation. */
+export interface ModeSwitchPayload {
+    from_mode: AvaMode;
+    to_mode: AvaMode;
+    trigger: 'user_prefix' | 'auto_detection' | 'orchestrator';
+}
+/** Ava started a Creative Studio generation job. */
+export interface GenerationStartedPayload {
+    type: 'image' | 'audio' | 'voice' | 'video' | 'music';
+    model: string;
+    prompt_signature: string;
+    params_summary: string;
+}
+/** Generation finished. */
+export interface GenerationCompletePayload {
+    generation_started_event_id: string;
+    type: 'image' | 'audio' | 'voice' | 'video' | 'music';
+    status: 'success' | 'error';
+    duration_ms: number;
+    file_size_bytes?: number;
+    error_summary?: string;
+}
+/** What the user did with the result — kept it, retried, discarded, edited. */
+export interface GenerationUserActionPayload {
+    generation_complete_event_id: string;
+    user_action: 'kept' | 'retried' | 'discarded' | 'edited' | 'unknown';
+}
+/** Auto-activation chose a knowledge pack to inject into the system prompt. */
+export interface KnowledgePackActivatedPayload {
+    pack_name: string;
+    trigger_signal: 'file_type' | 'framework' | 'language' | 'keyword' | 'manual';
+    trigger_detail: string;
+    injected_token_count: number;
+}
+/**
+ * Ava actually referenced the pack's content in her response. Computed by
+ * checking response text against pack-specific markers. Strong signal the
+ * pack was useful; absence is a signal it was injected unnecessarily.
+ */
+export interface KnowledgePackUsedPayload {
+    knowledge_pack_activated_event_id: string;
+    pack_name: string;
+    in_response: boolean;
+    reference_count: number;
+}
+/**
+ * Ava compressed or truncated the working context to stay under the model's
+ * window. Trains context-management strategy: when compression fires, how
+ * much it reclaims. Pure counts — no message content.
+ */
+export interface ContextCompressionPayload {
+    operation: 'compress' | 'truncate';
+    messages_before: number;
+    messages_after: number;
+    tokens_before: number;
+    token_budget: number;
+}
+/**
+ * A text-only coordinator couldn't see attached images, so the vision bridge
+ * described them with a vision model and injected the text. Trains the
+ * image→text relay signal. Shape-only: which model, how many images, latency,
+ * whether descriptions were produced (vs a "switch model" fallback).
+ */
+export interface VisionBridgePayload {
+    describer_model: string;
+    image_count: number;
+    described_count: number;
+    latency_ms: number;
+    success: boolean;
+}
+/**
+ * A metered action completed and credits were deducted from the user's
+ * allowance. Emitted by `chargeCredits()` in billing/meter.ts. The server
+ * sums these per user per billing period once Stage 3's billing switch
+ * is live; during Stage 2 (dual-write) the server bills on raw tokens
+ * while recording the `credits` field for parity auditing.
+ *
+ * One event per chargeable action — not per model iteration. An Agent
+ * that loops 5 times for tool use emits one charge per iteration (each
+ * is a `chat_turn`); a full Conductor run emits one charge per persona
+ * (`light_persona` or `heavy_persona`).
+ */
+export interface CreditsChargedPayload {
+    /** CreditAction from billing/credits — kept as string here to avoid a
+     *  dataset ↔ billing import dependency. */
+    action: string;
+    /** Credits actually deducted (after cache-hit discount, if any). */
+    credits: number;
+    cache_hit: boolean;
+    /** Provider's raw input token count (dual-write for billing parity). */
+    raw_input_tokens?: number;
+    raw_output_tokens?: number;
+    raw_cached_tokens?: number;
+    model?: string;
+}
+export interface AvaEventPayloadMap {
+    tool_choice: ToolChoicePayload;
+    tool_result: ToolResultPayload;
+    tool_chain_complete: ToolChainCompletePayload;
+    persona_decision: PersonaDecisionPayload;
+    persona_handoff: PersonaHandoffPayload;
+    persona_complete: PersonaCompletePayload;
+    persona_veto: PersonaVetoPayload;
+    team_depth_decision: TeamDepthDecisionPayload;
+    verification_decision: VerificationDecisionPayload;
+    correction_received: CorrectionReceivedPayload;
+    verification_evidence: VerificationEvidencePayload;
+    task_classification: TaskClassificationPayload;
+    routing_decision: RoutingDecisionPayload;
+    tool_error: ToolErrorPayload;
+    error_guidance_applied: ErrorGuidanceAppliedPayload;
+    recovery_action: RecoveryActionPayload;
+    memory_save: MemorySavePayload;
+    memory_recall: MemoryRecallPayload;
+    memory_update: MemoryUpdatePayload;
+    memory_consolidation: MemoryConsolidationPayload;
+    memory_forget: MemoryForgetPayload;
+    continuation_stall_detected: ContinuationStallDetectedPayload;
+    continuation_nudge_fired: ContinuationNudgeFiredPayload;
+    mode_switch: ModeSwitchPayload;
+    generation_started: GenerationStartedPayload;
+    generation_complete: GenerationCompletePayload;
+    generation_user_action: GenerationUserActionPayload;
+    knowledge_pack_activated: KnowledgePackActivatedPayload;
+    knowledge_pack_used: KnowledgePackUsedPayload;
+    context_compression: ContextCompressionPayload;
+    vision_bridge: VisionBridgePayload;
+    credits_charged: CreditsChargedPayload;
+}
+export type AvaEventOf<T extends AvaEventType> = AvaEvent<T>;
+//# sourceMappingURL=events.d.ts.map

package/dist/dataset/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/dataset/events.ts"],"names":[],"mappings":"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"}

package/dist/dataset/events.js

@@ -0,0 +1,30 @@
+/**
+ * Ava Action Event Taxonomy
+ *
+ * The canonical type definitions for every event Ava emits as she works.
+ * This file is the contract between the agent (which emits events) and the
+ * dataset capture consumer (which routes events into per-dataset JSONL
+ * files for the future own-model training run).
+ *
+ * Design principles:
+ *   1. Every event represents an Ava DECISION or ACTION — never a user
+ *      action, never a system tick. If it isn't something Ava chose or
+ *      did, it doesn't belong here.
+ *   2. Every event carries enough context to reconstruct the decision
+ *      without referencing the live conversation. No back-pointers into
+ *      mutable runtime state.
+ *   3. User-identifying or proprietary payloads are summarised, not
+ *      copied verbatim. File contents become "ts file, 200 lines";
+ *      prompts become category + intent; tool args become a one-line
+ *      summary. Raw text of the user's message never lands in an event.
+ *   4. Trajectory IDs glue related events together across files so we
+ *      can reconstruct multi-step flows at training time.
+ *
+ * Files in this directory:
+ *   events.ts    — this file, the taxonomy (types only, no runtime).
+ *   emitter.ts   — typed EventEmitter (next step).
+ *   consumer.ts  — subscribes, snapshots, writes JSONL (next step).
+ *   routing.ts   — maps event_type → which dataset files it belongs in.
+ */
+export {};
+//# sourceMappingURL=events.js.map

package/dist/dataset/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/dataset/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG"}

package/dist/dataset/generation-emit.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Generation event tracker — pairs `generation_started` with
+ * `generation_complete` for Creative Studio operations.
+ *
+ * Generate tools (image / video / music / voice) call
+ * `startGenerationTracking()` once they've passed initial validation
+ * and are about to actually call the upstream model. The returned
+ * tracker carries the started event_id and a stopwatch; the tool
+ * calls either `complete()` or `fail()` exactly once when the
+ * generation finishes. The tracker enforces the "exactly once"
+ * guarantee internally so a try/catch + early-return error path
+ * pattern can call both without producing duplicate events.
+ */
+import type { AvaSurface } from './events.js';
+export type GenerationType = 'image' | 'audio' | 'voice' | 'video' | 'music';
+export type GenerationUserAction = 'kept' | 'retried' | 'discarded' | 'edited' | 'unknown';
+export interface GenerationTracker {
+    /** event_id of the generation_started event — for cross-reference. */
+    readonly startedEventId: string;
+    /** event_id of the generation_complete event — set after complete()/fail().
+     *  Surfaces persist this with the asset so a later generation_user_action
+     *  can link back to the exact generation. Null until completed. */
+    completeEventId: string | null;
+    /** Wall-clock millis when tracking opened. */
+    readonly startTime: number;
+    readonly type: GenerationType;
+    /** Mark the generation as successful. Idempotent. */
+    complete(opts?: {
+        fileSizeBytes?: number;
+    }): void;
+    /** Mark the generation as failed. Idempotent. */
+    fail(errorSummary: string): void;
+}
+export declare function startGenerationTracking(opts: {
+    type: GenerationType;
+    model: string;
+    prompt: string;
+    paramsSummary: string;
+}): GenerationTracker;
+/**
+ * Track a UI-originated (Creative Studio) generation. Creative Studio calls the
+ * platform API directly rather than the agent's generate_* tools, so it runs
+ * OUTSIDE any agent trajectory — and the emitter drops events fired without
+ * one. This wraps the whole generation lifecycle (start → await → complete) in
+ * a synthetic write-mode trajectory so the events land, and returns the
+ * generation_complete event_id for the surface to persist with the asset.
+ */
+export declare function trackUiGeneration<T>(opts: {
+    type: GenerationType;
+    model: string;
+    prompt: string;
+    paramsSummary: string;
+    surface: AvaSurface;
+    sessionId?: string;
+}, run: (tracker: GenerationTracker) => Promise<T>): Promise<{
+    result: T;
+    completeEventId: string | null;
+}>;
+/**
+ * Emit a generation_user_action for a Creative Studio gallery action (kept /
+ * retried / discarded / edited). Fires from the gallery, outside any agent run,
+ * so it gets its own synthetic trajectory. Links to the generation via the
+ * complete event_id the surface stored when the asset was created.
+ */
+export declare function emitGenerationUserAction(opts: {
+    completeEventId: string;
+    action: GenerationUserAction;
+    surface: AvaSurface;
+    model?: string;
+    sessionId?: string;
+}): void;
+//# sourceMappingURL=generation-emit.d.ts.map

package/dist/dataset/generation-emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-emit.d.ts","sourceRoot":"","sources":["../../src/dataset/generation-emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAC7E,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3F,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC;;uEAEmE;IACnE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClD,iDAAiD;IACjD,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,iBAAiB,CA8CpB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,IAAI,EAAE;IACJ,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,EACD,GAAG,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAC9C,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAWxD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAWP"}