@agent-native/core 0.222.0 → 0.222.1-nightly-20261029092708

package/dist/server/core-routes-plugin.js

@@ -45,6 +45,7 @@ import { getUserSetting, putUserSetting, deleteUserSetting, } from "../settings/
 import { ANALYTICS_CLIENT_PLATFORM_PROPERTY } from "../shared/analytics-platform.js";
 import { EMPTY_SPECULATION_RULES, resolveSsrCacheHeaders, } from "../shared/cache-control.js";
 import { EMBED_TARGET_HEADER } from "../shared/embed-auth.js";
+import { FIRST_RUN_ONBOARDING_EXPERIMENT_EVENT_NAMES } from "../shared/first-run-builder-credits-experiment.js";
 import { isGoogleProfileImageUrl } from "../shared/google-profile-image.js";
 import { llmConnectionTrackingProperties } from "../shared/llm-connection.js";
 import { EMBED_TRANSPLANT_HEADER, isMcpEmbedCorsOrigin, MCP_EMBED_CORS_ALLOW_HEADERS, shouldAllowMcpEmbedCredentials, } from "../shared/mcp-embed-headers.js";
@@ -59,7 +60,7 @@ import { createAgentEngineApiKeyHandler } from "./agent-engine-api-key-route.js"
 import { createAgentEngineDisconnectHandler } from "./agent-engine-default-model-route.js";
 import { createAgentEngineOllamaModelsHandler } from "./agent-engine-ollama-models-route.js";
 import { memoizeAgentEngineStatus } from "./agent-engine-status-cache.js";
-import { readAnalyticsClientPlatformHeader, readBrowserSessionIdHeader, } from "./agent-run-context.js";
+import { readAnalyticsClientPlatformHeader, readBrowserSessionIdHeader, readBrowserTabIdHeader, } from "./agent-run-context.js";
 import { isAnonymousWaitlistSessionEmail } from "./anonymous-identity.js";
 import { getConfiguredAppBasePath, stripAppBasePath } from "./app-base-path.js";
 import { readAnalyticsSessionId } from "./attribution.js";
@@ -68,7 +69,7 @@ import { createAutomationFailureUnsubscribeHandler } from "./automation-failure-
 import { registerBackgroundJobStop } from "./background-jobs.js";
 import { getBetterAuthInternalAdapter, getBetterAuthSync, } from "./better-auth-instance.js";
 import { isBuilderReauthorizationRequired, resolveBuilderRequestAuthorization, } from "./builder-api-auth.js";
-import { BUILDER_CONNECT_PARAM, BUILDER_CONNECT_MODE_PARAM, BUILDER_AGENT_NATIVE_PROVISION_MODE, BUILDER_CONNECT_ATTEMPT_PARAM, BUILDER_CONNECT_STATE_COOKIE, BUILDER_ENV_KEYS, BUILDER_OPENER_PARAM, BUILDER_RELAY_FLOW_HEADER, BUILDER_RELAY_SIGNATURE_HEADER, BUILDER_RELAY_STATE_PARAM, BUILDER_RELAY_TIMESTAMP_HEADER, appendBuilderConnectToken, appendBuilderConnectStateCookie, builderConnectTrackingProperties, BUILDER_UPSTREAM_FAILURE_STATUS, createBuilderConnectState, createBuilderBrowserCallbackErrorPage, createBuilderBrowserCallbackPage, createBuilderRelayRequest, getBuilderConnectCallbackOriginFromUrl, getBuilderConnectTrackingParams, getBuilderBrowserOriginForEvent, getBuilderBrowserStatusForEvent, BuilderAccountProvisioningError, isBuilderAccountAlreadyExistsError, isBuilderAccountProvisioningEnabled, isBuilderConnectCallbackUrlAllowed, isSignedBuilderConnectState, normalizeBuilderAgentContext, parseBuilderConnectStateCookie, provisionBuilderAccount, resolveBuilderBranchProjectId, resolveBuilderConnectCallbackUrl, resolveBuilderConnectCallbackState, resolveBuilderPreviewRelayParentOrigin, removeBuilderConnectStateCookie, runBuilderAgent, sendBuilderPopupErrorPage, verifyBuilderRelayRequest, verifyBuilderPreviewRelayStateForCallback, verifyBuilderConnectTokenAndGetOwner, signBuilderProvisioningToken, verifyBuilderProvisioningToken, withBuilderConnectTrackingParams, } from "./builder-browser.js";
+import { BUILDER_CONNECT_PARAM, BUILDER_CONNECT_MODE_PARAM, BUILDER_AGENT_NATIVE_PROVISION_MODE, BUILDER_CONNECT_ATTEMPT_PARAM, BUILDER_CONNECT_STATE_COOKIE, BUILDER_ENV_KEYS, BUILDER_OPENER_PARAM, BUILDER_RELAY_FLOW_HEADER, BUILDER_RELAY_SIGNATURE_HEADER, BUILDER_RELAY_STATE_PARAM, BUILDER_RELAY_TIMESTAMP_HEADER, appendBuilderConnectToken, appendBuilderConnectStateCookie, builderConnectTrackingProperties, BUILDER_UPSTREAM_FAILURE_STATUS, createBuilderConnectState, createBuilderBrowserCallbackErrorPage, createBuilderBrowserCallbackPage, createBuilderRelayRequest, getBuilderConnectCallbackOriginFromUrl, getBuilderConnectTrackingParams, getBuilderBrowserOriginForEvent, getBuilderBrowserStatusForEvent, BuilderAccountProvisioningError, isBuilderAccountAlreadyExistsError, isBuilderAccountProvisioningEnabled, isBuilderConnectCallbackUrlAllowed, isSignedBuilderConnectState, normalizeBuilderAgentContext, parseBuilderConnectStateCookie, provisionBuilderAccount, resolveBuilderBranchProjectId, resolveBuilderHandoffProjectId, resolveBuilderConnectCallbackUrl, resolveBuilderConnectCallbackState, resolveBuilderPreviewRelayParentOrigin, removeBuilderConnectStateCookie, runBuilderAgent, sendBuilderPopupErrorPage, verifyBuilderRelayRequest, verifyBuilderPreviewRelayStateForCallback, verifyBuilderConnectTokenAndGetOwner, signBuilderProvisioningToken, verifyBuilderProvisioningToken, withBuilderConnectTrackingParams, } from "./builder-browser.js";
 import { createBuilderDesktopMessagesHandler } from "./builder-desktop-messages-route.js";
 import { BUILDER_OAUTH_SCOPE, builderOAuthScopeFor, canRoleConnectPersonalBuilder, deleteBuilderOAuthSession, exchangeBuilderOAuthAuthorization, getBuilderOAuthGrants, getBuilderOAuthStoredScope, hasUsableBuilderOAuthSessionForReadiness, hasStoredBuilderOAuthGrant, isBuilderOrgManagerRole, isPersonalBuilderGrantAllowed, saveBuilderOAuthCredentials, startBuilderOAuthAuthorization, } from "./builder-oauth.js";
 import { captureError, registerErrorCaptureProvider } from "./capture-error.js";
@@ -3491,8 +3492,15 @@ export function createCoreRoutesPlugin(options = {}) {
                 // uses. Without this, per-user Builder keys stored in app_secrets are
                 // invisible to the run path and the call throws "Builder keys are not
                 // configured" even though the status endpoint correctly reports configured=true.
-                return runWithRequestContext({ userEmail, orgId: orgId ?? undefined }, async () => {
-                    const projectId = await resolveBuilderBranchProjectId();
+                // The tab id lets a host's branch-project provider find the view
+                // this click came from (its navigation state is tab-scoped).
+                const browserTabId = readBrowserTabIdHeader(event);
+                return runWithRequestContext({
+                    userEmail,
+                    ...(orgId ? { orgId } : {}),
+                    ...(browserTabId ? { run: { browserTabId } } : {}),
+                }, async () => {
+                    const projectId = await resolveBuilderHandoffProjectId();
                     if (!projectId) {
                         setResponseStatus(event, 403);
                         return {
@@ -4306,15 +4314,41 @@ export function createCoreRoutesPlugin(options = {}) {
                 };
                 if (orgId)
                     properties.org_id = orgId;
+                // The browser cannot supply experiment attribution. Restore an
+                // exposed first-run arm from server storage before tracking onboarding
+                // events so the registry can replace, rather than trust, client tags.
+                const isFirstRunOnboardingEvent = FIRST_RUN_ONBOARDING_EXPERIMENT_EVENT_NAMES.has(validation.name) && validation.properties?.flow === "first_run";
                 // Best-effort — server `track()` swallows provider errors. We still
                 // guard here so an unexpected throw can't surface to the browser.
                 try {
-                    track(validation.name, properties, {
+                    const browserSessionId = readBrowserSessionIdHeader(event);
+                    const trackingSource = {
                         userId: userEmail,
-                        authUserId: session.authUserId,
-                        sessionId: readBrowserSessionIdHeader(event),
+                        ...(session.authUserId ? { authUserId: session.authUserId } : {}),
+                        ...(browserSessionId ? { sessionId: browserSessionId } : {}),
                         telemetryOrigin: "client",
-                    });
+                    };
+                    const trackClientEvent = () => track(validation.name, properties, trackingSource);
+                    if (isFirstRunOnboardingEvent) {
+                        await runWithRequestContext({
+                            userEmail,
+                            ...(session.authUserId
+                                ? { authUserId: session.authUserId }
+                                : {}),
+                        }, async () => {
+                            try {
+                                const { loadFirstRunBuilderCreditsV2Assignment } = await import("../onboarding/first-run-builder-credits-experiment.js");
+                                await loadFirstRunBuilderCreditsV2Assignment();
+                            }
+                            catch {
+                                console.error("[tracking] first-run onboarding assignment lookup failed", { eventName: validation.name });
+                            }
+                            trackClientEvent();
+                        });
+                    }
+                    else {
+                        trackClientEvent();
+                    }
                 }
                 catch {
                     // best-effort

package/dist/server/index.d.ts

@@ -113,7 +113,7 @@ export { BUILDER_PUBLISH_MCP_RESOURCE, canAuthorizeBuilderApiRequest, hasBuilder
 export { createFusionAgentFeed, fusionStepToAgentChatEvents, type FusionAgentFeedSummary, } from "./fusion-agent-feed.js";
 export { BUILDER_ASSETS_WRITE_SCOPE, BUILDER_CONTENT_READ_SCOPE, BUILDER_CONTENT_WRITE_SCOPE, BUILDER_OAUTH_RESOURCE, BUILDER_OAUTH_SCOPE, type BuilderOAuthPermissionScope, } from "./builder-oauth.js";
 export { assertBuilderDesignSystemCodeIndexingAllowed, builderDesignSystemUrl, builderProjectBranchUrl, buildBuilderDesignSystemIndexFiles, collectBuilderDesignSystemGitHubFiles, createBuilderDesignSystemProxyFields, designSystemTierUpgradeUrl, fetchBuilderDesignSystemDecodeJobStatus, fetchBuilderDesignSystemDocs, fetchBuilderDesignSystemDocumentCount, fetchBuilderDesignSystemRecord, fetchBuilderDesignSystemTierLimit, getBuilderDesignSystemsBaseUrl, hydrateBuilderDesignSystemReference, indexBuilderDesignSystem, isBuilderDesignSystemReadyByCount, localBuilderDesignSystemId, mimeTypeForBuilderDesignSystemFilename, parseBuilderDesignSystemProxyReference, startBuilderDesignSystemIndex, startBuilderDesignSystemUpload, type BuildBuilderDesignSystemIndexFilesOptions, type BuilderDesignSystemCodeFileInput, type BuilderDesignSystemDecodeJobStatus, type BuilderDesignSystemDocsOptions, type BuilderDesignSystemDocument, type BuilderDesignSystemDocumentCountResult, type BuilderDesignSystemHydratedReference, type BuilderDesignSystemIndexFile, type BuilderDesignSystemIndexFromSourcesOptions, type BuilderDesignSystemIndexOptions, type BuilderDesignSystemIndexResult, type BuilderDesignSystemRecord, type BuilderDesignSystemStatus, type BuilderDesignSystemTierLimit, type BuilderDesignSystemGitHubFile, type BuilderDesignSystemGitHubFileCollection, type BuilderDesignSystemGitHubSource, type BuilderDesignSystemUploadAttachment, type BuilderDesignSystemUploadSlot, type BuilderDesignSystemProxyFields, type BuilderDesignSystemProxyFieldsOptions, type BuilderDesignSystemProxyReference, type BuilderDesignSystemSourceKind, } from "./builder-design-systems.js";
-export { cdnSafeOriginStatus, createBuilderProject, ensureBuilderProject, findBuilderProjectForRepo, getBuilderBranchProjectId, isBuilderBranchingEnabled, requestBuilderBrowserConnection, resolveBuilderBranchProjectId, resolveIsBuilderBranchingEnabled, normalizeBuilderAgentAttachments, runBuilderAgent, type BuilderAgentAttachment, type BuilderAgentUploadAttachment, type BuilderAgentUrlAttachment, type BuilderProjectResult, type RunBuilderAgentResult, } from "./builder-browser.js";
+export { cdnSafeOriginStatus, createBuilderProject, ensureBuilderProject, findBuilderProjectForRepo, getBuilderBranchProjectId, isBuilderBranchingEnabled, registerBuilderBranchProject, requestBuilderBrowserConnection, resolveBuilderBranchProjectId, resolveBuilderHandoffProjectId, resolveIsBuilderBranchingEnabled, normalizeBuilderAgentAttachments, runBuilderAgent, type BuilderAgentAttachment, type BuilderAgentUploadAttachment, type BuilderAgentUrlAttachment, type BuilderProjectResult, type RunBuilderAgentResult, } from "./builder-browser.js";
 export { BuilderBranchError, getBuilderBranchStatus, sendBuilderBranchMessage, type BuilderBranchAgentState, type BuilderBranchErrorCode, type BuilderBranchOperation, type BuilderBranchPrStatus, type BuilderBranchRef, type BuilderBranchState, type BuilderBranchStatus, type GetBuilderBranchStatusOptions, type SendBuilderBranchMessageOptions, type SendBuilderBranchMessageResult, } from "./builder-branch.js";
 export { BuilderBranchFilesError, readBuilderBranchFiles, } from "./builder-branch-files.js";
 export { ensureFusionContainer, sendFusionBranchMessage, pushFusionBranch, reserveFusionHostingSlug, deployFusionProject, getFusionDeploys, getFusionBranchEditorUrl, getFusionHostingUrl, type FusionBranchRef, type EnsureFusionContainerResult, type SendFusionMessageResult, } from "./fusion-app.js";

package/dist/server/index.js

@@ -106,7 +106,7 @@ export { BUILDER_PUBLISH_MCP_RESOURCE, canAuthorizeBuilderApiRequest, hasBuilder
 export { createFusionAgentFeed, fusionStepToAgentChatEvents, } from "./fusion-agent-feed.js";
 export { BUILDER_ASSETS_WRITE_SCOPE, BUILDER_CONTENT_READ_SCOPE, BUILDER_CONTENT_WRITE_SCOPE, BUILDER_OAUTH_RESOURCE, BUILDER_OAUTH_SCOPE, } from "./builder-oauth.js";
 export { assertBuilderDesignSystemCodeIndexingAllowed, builderDesignSystemUrl, builderProjectBranchUrl, buildBuilderDesignSystemIndexFiles, collectBuilderDesignSystemGitHubFiles, createBuilderDesignSystemProxyFields, designSystemTierUpgradeUrl, fetchBuilderDesignSystemDecodeJobStatus, fetchBuilderDesignSystemDocs, fetchBuilderDesignSystemDocumentCount, fetchBuilderDesignSystemRecord, fetchBuilderDesignSystemTierLimit, getBuilderDesignSystemsBaseUrl, hydrateBuilderDesignSystemReference, indexBuilderDesignSystem, isBuilderDesignSystemReadyByCount, localBuilderDesignSystemId, mimeTypeForBuilderDesignSystemFilename, parseBuilderDesignSystemProxyReference, startBuilderDesignSystemIndex, startBuilderDesignSystemUpload, } from "./builder-design-systems.js";
-export { cdnSafeOriginStatus, createBuilderProject, ensureBuilderProject, findBuilderProjectForRepo, getBuilderBranchProjectId, isBuilderBranchingEnabled, requestBuilderBrowserConnection, resolveBuilderBranchProjectId, resolveIsBuilderBranchingEnabled, normalizeBuilderAgentAttachments, runBuilderAgent, } from "./builder-browser.js";
+export { cdnSafeOriginStatus, createBuilderProject, ensureBuilderProject, findBuilderProjectForRepo, getBuilderBranchProjectId, isBuilderBranchingEnabled, registerBuilderBranchProject, requestBuilderBrowserConnection, resolveBuilderBranchProjectId, resolveBuilderHandoffProjectId, resolveIsBuilderBranchingEnabled, normalizeBuilderAgentAttachments, runBuilderAgent, } from "./builder-browser.js";
 export { BuilderBranchError, getBuilderBranchStatus, sendBuilderBranchMessage, } from "./builder-branch.js";
 export { BuilderBranchFilesError, readBuilderBranchFiles, } from "./builder-branch-files.js";
 export { ensureFusionContainer, sendFusionBranchMessage, pushFusionBranch, reserveFusionHostingSlug, deployFusionProject, getFusionDeploys, getFusionBranchEditorUrl, getFusionHostingUrl, } from "./fusion-app.js";

package/dist/server/request-context.d.ts

@@ -64,6 +64,14 @@ export interface RequestRunContext {
         totalTools: number;
         resultNames: string[];
     }>;
+    /** Signup-time question-intake assignment loaded for this authenticated run. */
+    questionIntakeExperimentAssignment?: {
+        authUserId: string;
+        experimentId: string;
+        variantId: "control" | "no_questions";
+    };
+    /** Tools unavailable to the current agent run and its tool-search surface. */
+    excludedActionNames?: readonly string[];
 }
 export interface RequestContext {
     /**

package/dist/server/transcribe-voice.d.ts

@@ -17,8 +17,8 @@
  * typed JSON-in / JSON-out).
  */
 export declare function createTranscribeVoiceHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    text?: undefined;
     error: string;
+    text?: undefined;
 } | {
     error?: undefined;
     text: string;

package/dist/shared/first-run-builder-credits-experiment.d.ts

@@ -1,6 +1,7 @@
 export declare const FIRST_RUN_BUILDER_CREDITS_V2_EXPERIMENT_ID = "first_run_builder_credits_v2";
 export declare const FIRST_RUN_BUILDER_CREDITS_V2_FLAG_KEY = "clips-first-run-credits-v2";
 export declare const FIRST_RUN_BUILDER_CREDITS_V2_VARIANTS: readonly ["control", "credits"];
+export declare const FIRST_RUN_ONBOARDING_EXPERIMENT_EVENT_NAMES: Set<string>;
 export type FirstRunBuilderCreditsV2Variant = (typeof FIRST_RUN_BUILDER_CREDITS_V2_VARIANTS)[number];
 export interface FirstRunBuilderCreditsV2Assignment {
     experiment_id: typeof FIRST_RUN_BUILDER_CREDITS_V2_EXPERIMENT_ID;

package/dist/shared/first-run-builder-credits-experiment.js

@@ -4,6 +4,25 @@ export const FIRST_RUN_BUILDER_CREDITS_V2_VARIANTS = [
     "control",
     "credits",
 ];
+export const FIRST_RUN_ONBOARDING_EXPERIMENT_EVENT_NAMES = new Set([
+    "onboarding_app_entered",
+    "onboarding_started",
+    "onboarding_experiment_exposed",
+    "onboarding_step_viewed",
+    "onboarding_step_completed",
+    "onboarding_step_skipped",
+    "onboarding_method_clicked",
+    "onboarding_method_started",
+    "onboarding_method_outcome",
+    "onboarding_abandoned",
+    "onboarding_correlation_unavailable",
+    "onboarding_role_save_started",
+    "onboarding_more_info_opened",
+    "onboarding_role_option_selected",
+    "onboarding_dismissed",
+    "onboarding_reopened",
+    "onboarding_completed",
+]);
 /** A stable, account-scoped arm that is the same in the browser and on server events. */
 export function assignFirstRunBuilderCreditsV2(authUserId) {
     const userId = authUserId?.trim();

package/dist/tracking/index.d.ts

@@ -1,4 +1,4 @@
-export { track, identify, flushTracking, registerTrackingProvider, unregisterTrackingProvider, listTrackingProviders, type TrackingMeta, type TrackingSource, } from "./registry.js";
+export { track, trackQuestionIntakeExposure, identify, flushTracking, registerTrackingProvider, unregisterTrackingProvider, listTrackingProviders, type TrackingMeta, type TrackingSource, } from "./registry.js";
 export { registerBuiltinProviders } from "./providers.js";
 export { readAnalyticsAnonymousId } from "../server/attribution.js";
 export { AGENT_NATIVE_ACTION_EVENTS, AGENT_NATIVE_LIFECYCLE_EVENTS, trackActionEvent, trackLifecycleEvent, type AgentNativeActionEventName, type AgentNativeLifecycleEventName, } from "./lifecycle.js";

package/dist/tracking/index.js

@@ -1,4 +1,4 @@
-export { track, identify, flushTracking, registerTrackingProvider, unregisterTrackingProvider, listTrackingProviders, } from "./registry.js";
+export { track, trackQuestionIntakeExposure, identify, flushTracking, registerTrackingProvider, unregisterTrackingProvider, listTrackingProviders, } from "./registry.js";
 export { registerBuiltinProviders } from "./providers.js";
 export { readAnalyticsAnonymousId } from "../server/attribution.js";
 export { AGENT_NATIVE_ACTION_EVENTS, AGENT_NATIVE_LIFECYCLE_EVENTS, trackActionEvent, trackLifecycleEvent, } from "./lifecycle.js";

package/dist/tracking/registry.d.ts

@@ -1,4 +1,5 @@
 import type { ActionRunContext } from "../action.js";
+import { type QuestionIntakeExperimentAssignment } from "../observability/question-intake-experiment.js";
 import { type TrackingEventOrigin } from "../observability/tracing.js";
 import type { TrackingProvider } from "./types.js";
 export { isQaTestEmail } from "../shared/qa-test-email.js";
@@ -17,5 +18,11 @@ export interface TrackingMeta {
 }
 export type TrackingSource = TrackingMeta | (ActionRunContext & Pick<TrackingMeta, "sessionId">);
 export declare function track(name: string, properties?: Record<string, unknown>, source?: TrackingSource): void;
+export declare function trackQuestionIntakeExposure(assignment: QuestionIntakeExperimentAssignment, context: {
+    appId: string;
+    threadId?: string;
+    turnId: string;
+    userId?: string;
+}): void;
 export declare function identify(userId: string, traits?: Record<string, unknown>): void;
 export declare function flushTracking(): Promise<void[]>;

package/dist/tracking/registry.js

@@ -1,11 +1,13 @@
 import { randomUUID } from "node:crypto";
-import { queueTrackingEvent, } from "../observability/tracing.js";
+import { getAppConfig } from "../app-config/index.js";
+import { questionIntakeExposureProperties, resolveQuestionIntakeExperimentAssignment, } from "../observability/question-intake-experiment.js";
+import { queueTrackingEvent, registerTrackingWork, } from "../observability/tracing.js";
 import { resolveDeployEnvironment } from "../server/deploy-environment.js";
-import { getRequestContext } from "../server/request-context.js";
+import { getRequestContext, getRequestRunContext, } from "../server/request-context.js";
 import { isTestIdentity } from "../server/test-identity.js";
 import { canonicalTrackingEvent, legacyLifecycleEvent, TRACKING_EVENT_ALIAS_ID_PROPERTY, withCanonicalTrackingProperties, } from "../shared/analytics-events.js";
 import { ANALYTICS_CLIENT_PLATFORM_PROPERTY } from "../shared/analytics-platform.js";
-import { assignFirstRunBuilderCreditsV2 } from "../shared/first-run-builder-credits-experiment.js";
+import { assignFirstRunBuilderCreditsV2, FIRST_RUN_ONBOARDING_EXPERIMENT_EVENT_NAMES, } from "../shared/first-run-builder-credits-experiment.js";
 export { isQaTestEmail } from "../shared/qa-test-email.js";
 const REGISTRY_KEY = Symbol.for("@agent-native/core/tracking.registry");
 const FIRST_RUN_EXPERIMENT_EVENT_NAMES = new Set([
@@ -98,6 +100,68 @@ function resolveTrackingSource(source) {
     };
 }
 export function track(name, properties, source) {
+    // raw-sql-ok: tracking persistence uses bound arguments for resolved identity values.
+    const resolvedSource = resolveTrackingSource(source);
+    // raw-sql-ok: resolved IDs remain bound event values at the tracking store boundary.
+    const { authUserId, userId } = resolvedSource;
+    if (getRequestContext()?.isSyntheticTraffic === true)
+        return;
+    const testIdentity = testIdentityOf(userId, properties);
+    if (testIdentity && name !== "$exception")
+        return;
+    const config = getAppConfig().agent.questionIntake;
+    const mayAttributeClientEvent = resolvedSource.telemetryOrigin !== "client" ||
+        config?.clientTrackedEventNames.includes(name) === true;
+    if (config?.enabled &&
+        !config.disabled &&
+        config.trackedEventNames.includes(name) &&
+        authUserId &&
+        mayAttributeClientEvent) {
+        const experimentProperties = { ...(properties ?? {}) };
+        delete experimentProperties.experiment_id;
+        delete experimentProperties.experiment_variant;
+        const requestAssignment = getRequestRunContext()?.questionIntakeExperimentAssignment;
+        if (requestAssignment?.authUserId === authUserId &&
+            requestAssignment.experimentId === config.experimentId) {
+            emitTrackedEvent(name, experimentProperties, source, requestAssignment);
+            return;
+        }
+        const pending = resolveQuestionIntakeExperimentAssignment(config, authUserId)
+            .then((assignment) => emitTrackedEvent(name, experimentProperties, source, assignment ?? undefined), () => {
+            console.error("[tracking] question-intake assignment lookup failed", {
+                experimentId: config.experimentId,
+                eventName: name,
+            });
+            emitTrackedEvent(name, experimentProperties, source);
+        })
+            .catch(() => {
+            console.error("[tracking] asynchronous event delivery failed");
+        });
+        registerTrackingWork(pending, getRequestContext()?.trackingScope);
+        const waitUntil = getRequestRunContext()?.waitUntil;
+        if (waitUntil) {
+            try {
+                waitUntil(pending);
+                return;
+            }
+            catch {
+                console.error("[tracking] request waitUntil rejected tracked event");
+            }
+        }
+        void pending.catch(() => {
+            console.error("[tracking] tracked event failed outside waitUntil");
+        });
+        return;
+    }
+    emitTrackedEvent(name, properties, source);
+}
+export function trackQuestionIntakeExposure(assignment, context) {
+    track("agent_experiment_exposed", questionIntakeExposureProperties(assignment, context), {
+        ...(context.userId ? { userId: context.userId } : {}),
+        authUserId: assignment.authUserId,
+    });
+}
+function emitTrackedEvent(name, properties, source, questionIntakeAssignment) {
     const { userId, authUserId, anonymousId, sessionId, occurredAt, telemetryOrigin, } = resolveTrackingSource(source);
     if (getRequestContext()?.isSyntheticTraffic === true)
         return;
@@ -109,14 +173,30 @@ export function track(name, properties, source) {
     const safeProperties = { ...(properties ?? {}) };
     delete safeProperties.auth_user_id;
     delete safeProperties.authUserId;
+    delete safeProperties.telemetry_origin;
+    delete safeProperties.telemetryOrigin;
+    if (telemetryOrigin === "client") {
+        delete safeProperties.experiment_id;
+        delete safeProperties.experiment_variant;
+    }
     if (authUserId)
         safeProperties.auth_user_id = authUserId;
-    const firstRunExperiment = authUserId && FIRST_RUN_EXPERIMENT_EVENT_NAMES.has(name)
+    const firstRunExperiment = authUserId &&
+        (FIRST_RUN_EXPERIMENT_EVENT_NAMES.has(name) ||
+            (FIRST_RUN_ONBOARDING_EXPERIMENT_EVENT_NAMES.has(name) &&
+                safeProperties.flow === "first_run"))
         ? requestFirstRunExperiment(authUserId)
         : null;
     const trackedProperties = withCanonicalTrackingProperties({
         ...safeProperties,
+        telemetry_origin: telemetryOrigin,
         ...(firstRunExperiment ?? {}),
+        ...(questionIntakeAssignment
+            ? {
+                experiment_id: questionIntakeAssignment.experimentId,
+                experiment_variant: questionIntakeAssignment.variantId,
+            }
+            : {}),
         ...(sessionId ? { session_id: sessionId } : {}),
         ...(userId ? { user_id: userId } : {}),
         ...(actionContext?.userEmail

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.222.0",
+  "version": "0.222.1-nightly-20261029092708",
   "description": "The agentic application framework for building autonomous agents with intuitive UIs",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -742,8 +742,8 @@
     "yaml": "^2.9.0",
     "yjs": "^13.6.33",
     "zod": "^4.3.6",
-    "@agent-native/agentkit": "^0.222.0",
-    "@agent-native/recap-cli": "^0.5.91"
+    "@agent-native/recap-cli": "^0.5.91",
+    "@agent-native/agentkit": "^0.222.1-nightly-20261029092708"
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.71",
@@ -814,7 +814,7 @@
     "xlsx": "^0.18.5"
   },
   "peerDependencies": {
-    "@agent-native/core-corpus": ">=0.196.0",
+    "@agent-native/core-corpus": "0.222.1-nightly-20261029092708",
     "@ai-sdk/anthropic": ">=3",
     "@ai-sdk/cohere": ">=3",
     "@ai-sdk/google": ">=3",