rivet-design 0.25.0 → 0.26.1

package/dist/cli/commands/mcpServe.d.ts

@@ -5,12 +5,12 @@ type McpServeOptions = {
     projectPath?: string;
     handoffArgs?: string[];
     noTelemetry?: boolean;
-    telemetry?: Pick<TelemetryService, 'track' | 'trackCliCommandCompleted' | 'trackMCPToolExecuted' | 'trackMCPToolFailed' | 'shutdown'>;
+    telemetry?: Pick<TelemetryService, 'track' | 'trackCliCommandCompleted' | 'trackMCPToolExecuted' | 'trackMCPToolFailed' | 'reportInstallRefActivations' | 'shutdown'>;
 };
 export declare const isStaleAttachError: (envelope: CliEnvelope) => boolean;
 export declare const buildMcpServer: (options?: McpServeOptions) => Promise<{
     mcp: import("@modelcontextprotocol/sdk/server/mcp.js").McpServer;
-    telemetry: Pick<TelemetryService, "track" | "trackCliCommandCompleted" | "trackMCPToolExecuted" | "trackMCPToolFailed" | "shutdown"> | null;
+    telemetry: Pick<TelemetryService, "reportInstallRefActivations" | "track" | "trackCliCommandCompleted" | "trackMCPToolExecuted" | "trackMCPToolFailed" | "shutdown"> | null;
 }>;
 export declare const handleMcpServe: (rest: string[], io: CliIO) => Promise<CliCommandResult>;
 export {};

package/dist/cli/commands/mcpServe.js

@@ -238,6 +238,7 @@ const buildMcpServer = async (options = {}) => {
                     isRecoverable: args.envelope.error.isRecoverable,
                 });
             }
+            telemetry?.reportInstallRefActivations();
         }
         catch { }
         return toToolResult(args.envelope, args.progress);

package/dist/cli/commands/variants.js

@@ -58,7 +58,6 @@ const errorMessage_1 = require("../../utils/errorMessage");
 const START_COMMAND = 'variants.start';
 const STATUS_COMMAND = 'variants.status';
 const CANCEL_COMMAND = 'variants.cancel';
-const COMMIT_COMMAND = 'variants.commit';
 const COMPLETE_COMMAND = 'variants.complete';
 const GET_COMMAND = 'variants.get';
 const LIST_COMMAND = 'variants.list';
@@ -102,9 +101,6 @@ const CONTEXT_IMAGE_MIME_BY_EXTENSION = new Map([
 const MAX_REFERENCE_PAGES = 3;
 const MAX_REFERENCE_VIDEOS = 2;
 const REFERENCE_VIDEO_EXTENSIONS = new Set(['.mp4', '.mov', '.webm', '.m4v']);
-const COMMIT_FLAG_SPEC = {
-    session: { takesValue: true },
-};
 const COMPLETE_FLAG_SPEC = {
     session: { takesValue: true },
     status: { takesValue: true },
@@ -698,44 +694,10 @@ const handleVariantsCancel = async (args) => {
 };
 const resolveActiveSessionId = async (attached) => {
     const response = await (0, client_1.requestServer)(attached, '/api/variants/active');
-    if (response.status !== 200 || response.body.active !== true) {
+    if (response.status !== 200 || response.body.active !== true)
         return null;
-    }
     return response.body.sessionId ?? null;
 };
-const handleVariantsCommit = async (args) => {
-    const context = (0, shared_1.parseCommandContext)(COMMIT_COMMAND, args, COMMIT_FLAG_SPEC);
-    if ((0, shared_1.isCommandResult)(context)) {
-        return context;
-    }
-    const variantId = context.flags.positionals[0];
-    if (!variantId) {
-        return (0, envelope_1.errorResult)(COMMIT_COMMAND, 'USAGE_ERROR', 'Usage: rivet variants commit <variantId> [--session <sessionId>]');
-    }
-    const attached = await (0, shared_1.attachOrUnavailable)(COMMIT_COMMAND, context.projectPath);
-    if (!(0, shared_1.isAttached)(attached)) {
-        return attached;
-    }
-    try {
-        const sessionId = (0, flags_1.stringFlag)(context.flags, 'session') ??
-            (await resolveActiveSessionId(attached));
-        if (!sessionId) {
-            return (0, envelope_1.errorResult)(COMMIT_COMMAND, 'OPERATION_FAILED', 'No active variants session. Pass --session <sessionId> for a past session.');
-        }
-        const response = await (0, client_1.requestServer)(attached, `/api/variants/${encodeURIComponent(sessionId)}/commit`, { method: 'POST', body: { variantId } });
-        if (response.status !== 200) {
-            return (0, shared_1.serverErrorResult)(COMMIT_COMMAND, response.status, response.body);
-        }
-        return (0, envelope_1.okResult)(COMMIT_COMMAND, {
-            sessionId,
-            variantId,
-            result: response.body,
-        });
-    }
-    catch (error) {
-        return (0, shared_1.transportErrorResult)(COMMIT_COMMAND, error);
-    }
-};
 const handleVariantsComplete = async (args) => {
     const context = (0, shared_1.parseCommandContext)(COMPLETE_COMMAND, args, COMPLETE_FLAG_SPEC);
     if ((0, shared_1.isCommandResult)(context)) {
@@ -939,9 +901,6 @@ const handleVariants = async (args, options = {}) => {
     if (action === 'cancel') {
         return handleVariantsCancel(rest);
     }
-    if (action === 'commit') {
-        return handleVariantsCommit(rest);
-    }
     if (action === 'complete') {
         return handleVariantsComplete(rest);
     }
@@ -951,7 +910,7 @@ const handleVariants = async (args, options = {}) => {
     if (action === 'list') {
         return handleVariantsList(rest);
     }
-    return (0, envelope_1.errorResult)('variants', 'USAGE_ERROR', 'Usage: rivet variants <start|status|cancel|commit|complete|get|list> [options]');
+    return (0, envelope_1.errorResult)('variants', 'USAGE_ERROR', 'Usage: rivet variants <start|status|cancel|complete|get|list> [options]');
 };
 exports.handleVariants = handleVariants;
 //# sourceMappingURL=variants.js.map

package/dist/cli/router.js

@@ -79,8 +79,8 @@ const COMMAND_USAGE = {
         'Block until a work id settles; exits 5 on timeout.',
     ],
     variants: [
-        'rivet variants <start|status|cancel|commit|complete|get|list> [options]',
-        'start: --instruction <text> [--count N] [--element <selector>] [--fresh] [--target <sessionId>:<variantId>] [--worker-provider claude|codex|cursor] [--worker-model <id>] · get <projectId>/<sessionId>:<variantId> [--detail] · cancel <sessionId> · commit <variantId> [--session <id>] · list [--history]',
+        'rivet variants <start|status|cancel|complete|get|list> [options]',
+        'start: --instruction <text> [--count N] [--element <selector>] [--fresh] [--target <sessionId>:<variantId>] [--worker-provider claude|codex|cursor] [--worker-model <id>] · get <projectId>/<sessionId>:<variantId> [--detail] · cancel <sessionId> · list [--history]',
     ],
     evidence: [
         'rivet evidence capture --url <url> [--screenshot] [--width N --height N]',
@@ -311,6 +311,7 @@ const runCliControlCommand = async (args, io = io_1.processCliIO) => {
                 ...(0, telemetry_1.browserMetadataForEnvelope)(result.envelope),
                 ...(0, handoff_1.callerTelemetryFieldsFromArgs)(rest),
             });
+            telemetry.reportInstallRefActivations();
             await telemetry.shutdown(result.envelope.command === 'variants.get'
                 ? VARIANT_LOOKUP_TELEMETRY_TIMEOUT_MS
                 : undefined);

package/dist/config/flags.d.ts

@@ -26,9 +26,6 @@ export declare const FLAG_DEFINITIONS: {
     readonly canvasShare: {
         readonly default: false;
     };
-    readonly variantSend: {
-        readonly default: false;
-    };
     readonly generativeControls: {
         readonly default: false;
     };

package/dist/config/flags.js

@@ -11,7 +11,6 @@ exports.FLAG_DEFINITIONS = {
     share: { default: false },
     deployPrototype: { default: false },
     canvasShare: { default: false },
-    variantSend: { default: false },
     generativeControls: { default: false },
     refineMode: { default: false },
     inspectorUndoRedo: { default: false },

package/dist/config/pluginMetrics.js

@@ -16,7 +16,6 @@ const metricProperties = zod_1.z.object({
         'variants.get',
         'variants.list',
         'variants.complete',
-        'variants.commit',
         'variants.cancel',
         'reference.fetch',
         'evidence.capture',
@@ -27,7 +26,6 @@ const metricProperties = zod_1.z.object({
         'rivet_login',
         'rivet_explore_designs',
         'rivet_get_exploration',
-        'rivet_apply_design',
         'rivet_cancel_exploration',
         'rivet_complete_variant_work',
         'rivet_get_design_context',
@@ -216,8 +214,6 @@ const PRODUCT_EVENTS = new Set([
     'agent_variants.preview_started',
     'agent_variants.preview_ready',
     'agent_variants.preview_failed',
-    'agent_variants.committed',
-    'agent_variants.commit_failed',
 ]);
 const pluginMetricProperties = (event, properties) => {
     if (!PRODUCT_EVENTS.has(event))

package/dist/index.d.ts

@@ -73,7 +73,7 @@ export declare const authCommandOptionsForArgs: (args: string[]) => {
     noBrowser: boolean;
     noTelemetry: boolean;
 };
-export declare const rememberInstallRef: (args: string[]) => string[];
+export declare const rememberInstallRef: (args: string[], downloadType?: string) => string[];
 export declare const authFailureReasonForError: (error: string | undefined) => "oauth_failed" | "timeout";
 export declare const main: (args?: string[]) => Promise<void>;
 export declare const parseArgs: (args: string[]) => CLIOptions;

package/dist/index.js

@@ -238,14 +238,19 @@ const authCommandOptionsForArgs = (args) => ({
     noTelemetry: args.includes('--no-telemetry'),
 });
 exports.authCommandOptionsForArgs = authCommandOptionsForArgs;
-const rememberInstallRef = (args) => {
+const rememberInstallRef = (args, downloadType) => {
     const { installRef, remainingArgs } = (0, installRef_1.extractInstallRef)(args);
     if (installRef) {
-        (0, ConfigManager_1.getConfigManager)().setInstallRef(installRef);
+        (0, ConfigManager_1.getConfigManager)().setInstallRef(installRef, downloadType);
     }
     return remainingArgs;
 };
 exports.rememberInstallRef = rememberInstallRef;
+const reportInstallRefActivations = async () => {
+    const telemetry = new TelemetryService_1.TelemetryService({ source: 'cli' });
+    telemetry.reportInstallRefActivations();
+    await telemetry.shutdown();
+};
 const discardInstallRefForValidatedSession = () => {
     const configManager = (0, ConfigManager_1.getConfigManager)();
     const installRef = configManager.getInstallRef();
@@ -803,7 +808,8 @@ const promptPostInstall = async () => {
     }
 };
 const handleInstall = async (installArgs) => {
-    const parsed = (0, flags_1.parseFlags)((0, installRef_1.extractInstallRef)(installArgs).remainingArgs, {
+    const { installRef, remainingArgs } = (0, installRef_1.extractInstallRef)(installArgs);
+    const parsed = (0, flags_1.parseFlags)(remainingArgs, {
         mcp: { takesValue: false },
         'no-mcp': { takesValue: false },
         'no-telemetry': { takesValue: false },
@@ -852,7 +858,9 @@ const handleInstall = async (installArgs) => {
         (0, harnesses_1.reportInstallConfirmation)(selection, installArgs);
         return;
     }
-    (0, exports.rememberInstallRef)(installArgs);
+    (0, exports.rememberInstallRef)(installArgs, selection.targetIds.join(','));
+    if (installRef)
+        await reportInstallRefActivations();
     const bootstrap = (0, globalBootstrap_1.bootstrapGlobalInstall)(installArgs);
     if (bootstrap.action === 'reexeced') {
         process.exit(bootstrap.exitCode);
@@ -877,6 +885,10 @@ const handleLogin = async (options = {}) => {
         enabled: !options.noTelemetry,
         source: 'cli',
     });
+    const finishTelemetry = async () => {
+        telemetry.reportInstallRefActivations();
+        await telemetry.shutdown();
+    };
     let authAttemptId = '';
     let authStartedAt = 0;
     const startAuthAttempt = () => {
@@ -906,7 +918,7 @@ const handleLogin = async (options = {}) => {
                     outcome: 'already_authenticated',
                     durationMs: Date.now() - authStartedAt,
                 });
-                await telemetry.shutdown();
+                await finishTelemetry();
                 console.log(`✅ Already signed in as ${configManager.getEmail()}`);
                 console.log(`\n${nextStepHint}`);
                 return;
@@ -934,7 +946,7 @@ const handleLogin = async (options = {}) => {
                     outcome: 'authenticated',
                     durationMs: Date.now() - authStartedAt,
                 });
-                await telemetry.shutdown();
+                await finishTelemetry();
                 console.log(`✅ Logged in as ${resumed.user.email}`);
                 console.log(`\n${nextStepHint}`);
                 return;
@@ -983,7 +995,7 @@ const handleLogin = async (options = {}) => {
             outcome: 'authenticated',
             durationMs: Date.now() - authStartedAt,
         });
-        await telemetry.shutdown();
+        await finishTelemetry();
         console.log(`✅ Logged in as ${loginResult.user?.email}`);
         console.log(`\n${nextStepHint}`);
         return;
@@ -996,7 +1008,7 @@ const handleLogin = async (options = {}) => {
         failureReason: (0, exports.authFailureReasonForError)(loginResult.error),
         durationMs: Date.now() - authStartedAt,
     });
-    await telemetry.shutdown();
+    await finishTelemetry();
     console.log(`❌ Login failed: ${loginResult.error || loginResult.message}`);
     if (options.exitOnFailure ?? true) {
         process.exit(1);

package/dist/install/mcpRegistration.js

@@ -88,6 +88,7 @@ const verifyMcpServeInvocation = (spawnSync = childProcess.spawnSync) => {
         env: {
             ...(0, subprocessEnvironment_1.subprocessEnvironment)('rivetRuntime'),
             RIVET_LOG_LEVEL: 'SILENT',
+            RIVET_AUTO_UPDATE_DISABLED: '1',
         },
         input: `${input}\n`,
         timeout: MCP_SERVE_VERIFICATION_TIMEOUT_MS,

package/dist/mcp/explorationTools.js

@@ -56,23 +56,6 @@ const registerExplorationTools = (dependencies) => {
         callerAgent: dependencies.callerAgent,
         callerModel: (0, callerModel_1.callerModelArgsFromToolMeta)(extra._meta)[1],
     }));
-    (0, intentTool_1.registerIntentTool)(dependencies, {
-        name: 'rivet_apply_design',
-        title: 'Apply chosen design',
-        description: 'Apply the explicitly selected direction to the project working tree. Writes or replaces project files; generated applications may install dependencies and start a dev server, executing local code and contacting package registries. Only use after the user selects this result. Does not generate a different design.',
-        shape: {
-            project: intentTool_1.requiredText,
-            sessionId: intentTool_1.requiredText,
-            variantId: intentTool_1.requiredText,
-        },
-        annotations: intentTool_1.externalChange,
-    }, async (input) => runCommand('variants', [
-        'commit',
-        input.variantId,
-        '--session',
-        input.sessionId,
-        ...projectArgs(input.project),
-    ]));
     (0, intentTool_1.registerIntentTool)(dependencies, {
         name: 'rivet_cancel_exploration',
         title: 'Cancel exploration',

package/dist/routes/account.js

@@ -27,8 +27,9 @@ const createAccountRouter = (telemetry) => {
             const config = (0, ConfigManager_1.getConfigManager)();
             config.setAuth(token, email, refreshToken, userId);
             const carriedInstallRef = (0, installRef_1.parseInstallRef)(installRef);
-            if (carriedInstallRef)
-                config.clearInstallRef(carriedInstallRef);
+            if (carriedInstallRef) {
+                config.completeInstallRefSignIn(carriedInstallRef, config.getUserId());
+            }
         }
         catch {
             return res
@@ -36,6 +37,7 @@ const createAccountRouter = (telemetry) => {
                 .json({ error: 'Failed to store auth credentials' });
         }
         telemetry?.identifyUser();
+        telemetry?.reportInstallRefActivations();
         log.info(`Stored auth for ${email} via browser OAuth`);
         res.json({ success: true });
     });

package/dist/routes/agentVariants.js

@@ -48,9 +48,6 @@ const previewPortBody = v3_1.z.object({
     variantId: v3_1.z.string().min(1).nullable(),
     retry: v3_1.z.boolean().optional(),
 });
-const commitBody = v3_1.z.object({
-    variantId: v3_1.z.string().min(1),
-});
 const adoptPastBody = v3_1.z.object({
     pastSessionId: v3_1.z.string().min(1),
     pastVariantId: v3_1.z.string().min(1),
@@ -1679,92 +1676,6 @@ const createAgentVariantsRouter = (orchestrator, bridge, telemetry, variantHisto
             sendError(res, err);
         }
     });
-    postOperation('/variants/:sessionId/commit', async (req, res) => {
-        if (rejectNonLocalRequest(req, res))
-            return;
-        const sessionId = req.params.sessionId;
-        const flags = await (0, evaluateFlags_1.getFeatureFlags)({
-            userKey: (0, featureFlagUserKey_1.getConfigFeatureFlagUserKey)({ headers: req.headers }),
-        });
-        if (!flags.variantSend.isEnabled) {
-            res.status(403).json({
-                errorCode: 'FEATURE_DISABLED',
-                message: 'Variant send is not enabled.',
-            });
-            return;
-        }
-        const parsed = commitBody.safeParse(req.body);
-        if (!parsed.success) {
-            res.status(400).json({
-                errorCode: 'SCHEMA_VALIDATION_FAILED',
-                message: parsed.error.message,
-            });
-            return;
-        }
-        try {
-            const projectContext = orchestrator.getProjectContext(sessionId);
-            const isFresh = projectContext.kind === 'fresh';
-            const result = await orchestrator.commitVariant({
-                sessionId,
-                variantId: parsed.data.variantId,
-                skipTeardown: isFresh,
-            });
-            if (result.enqueued &&
-                result.payloadKind === 'project-created' &&
-                isFresh) {
-                if (!bridge || !result.destinationPath) {
-                    variantsTelemetry?.trackAgentVariantsActiveProjectTransition({
-                        sessionId,
-                        success: false,
-                        reasonCode: 'bridge_unavailable',
-                        destinationPath: result.destinationPath ?? null,
-                    });
-                    res.status(503).json({
-                        errorCode: 'RUNTIME_VALIDATION_FAILED',
-                        message: 'Variant sent, but active-project transition is unavailable. Keep this session open and run open_visual_editor on the destination project.',
-                        destinationPath: result.destinationPath ?? null,
-                    });
-                    return;
-                }
-                try {
-                    bridge.rebindProjectPath(result.destinationPath);
-                    await orchestrator.cleanupCommittedSession(sessionId);
-                    variantsTelemetry?.trackAgentVariantsActiveProjectTransition({
-                        sessionId,
-                        success: true,
-                        reasonCode: 'rebind_succeeded',
-                        destinationPath: result.destinationPath,
-                    });
-                }
-                catch {
-                    variantsTelemetry?.trackAgentVariantsActiveProjectTransition({
-                        sessionId,
-                        success: false,
-                        reasonCode: 'rebind_failed',
-                        destinationPath: result.destinationPath,
-                    });
-                    res.status(500).json({
-                        errorCode: 'RUNTIME_VALIDATION_FAILED',
-                        message: 'Variant sent, but active-project handoff failed. Destination project is preserved; keep this variants session open and retry send.',
-                        destinationPath: result.destinationPath,
-                    });
-                    return;
-                }
-            }
-            else if (bridge && result.enqueued) {
-                try {
-                    bridge.switchPreviewPort(null);
-                }
-                catch (err) {
-                    log.warn('switchPreviewPort(null) after commit failed', err);
-                }
-            }
-            res.json(result);
-        }
-        catch (err) {
-            sendError(res, err);
-        }
-    });
     postOperation('/variants/:sessionId/deploy', async (req, res) => {
         if (rejectNonLocalRequest(req, res))
             return;
@@ -2138,6 +2049,7 @@ const createAgentVariantsRouter = (orchestrator, bridge, telemetry, variantHisto
             sendError(res, err);
         }
     });
+    router.use('/variants', (_req, res) => res.sendStatus(404));
     return router;
 };
 exports.createAgentVariantsRouter = createAgentVariantsRouter;

package/dist/routes/library/browserAccess.d.ts

@@ -1,7 +1,9 @@
 import { Router } from 'express';
 import { BrowserSessions } from '../../library/BrowserSessions';
-export declare const createBrowserAccessRouter: ({ token, sessions, }: {
+import type { TelemetryService } from '../../services/TelemetryService';
+export declare const createBrowserAccessRouter: ({ token, sessions, telemetry, }: {
     token: string;
     sessions: BrowserSessions;
+    telemetry?: Pick<TelemetryService, "reportInstallRefActivations">;
 }) => Router;
 //# sourceMappingURL=browserAccess.d.ts.map

package/dist/routes/library/browserAccess.js

@@ -14,7 +14,7 @@ const signInBody = zod_1.z.object({
     refreshToken: zod_1.z.string().optional(),
     installRef: zod_1.z.string().optional(),
 });
-const createBrowserAccessRouter = ({ token, sessions, }) => {
+const createBrowserAccessRouter = ({ token, sessions, telemetry, }) => {
     const router = (0, express_1.Router)();
     router.post('/browser-sessions', (0, express_1.json)({ limit: '8kb' }), async (req, res) => {
         if (!(0, middleware_1.isLocalBrowserRequest)(req))
@@ -39,8 +39,10 @@ const createBrowserAccessRouter = ({ token, sessions, }) => {
             userId: profile.userId,
         });
         const carriedInstallRef = (0, installRef_1.parseInstallRef)(parsed.data.installRef);
-        if (carriedInstallRef)
-            sessions.config.clearInstallRef(carriedInstallRef);
+        if (carriedInstallRef) {
+            sessions.config.completeInstallRefSignIn(carriedInstallRef, profile.userId);
+        }
+        telemetry?.reportInstallRefActivations();
         return res.json({ token: browserToken });
     });
     router.post('/browser-sessions/exchange', (0, express_1.json)({ limit: '8kb' }), (req, res) => {

package/dist/routes/library/index.js

@@ -38,6 +38,7 @@ const createLibraryRouter = (options) => {
         router.use((0, browserAccess_1.createBrowserAccessRouter)({
             token: options.token,
             sessions: options.browserSessions,
+            telemetry: options.telemetry,
         }));
     router.get('/health', (0, middleware_1.authenticateLibrary)(options.token), (_req, res) => res.json({
         pid: process.pid,

package/dist/routes/variantRequestSchema.d.ts

@@ -103,7 +103,7 @@ export declare const inlineVariantRequestSchema: z.ZodEffects<z.ZodObject<{
         label?: string | undefined;
     }[] | undefined;
     runLabel?: string | undefined;
-    fidelity?: "low" | "medium" | "high" | undefined;
+    fidelity?: "high" | "medium" | "low" | undefined;
     profile?: "off" | "auto" | undefined;
     briefs?: {
         label: string;
@@ -131,7 +131,7 @@ export declare const inlineVariantRequestSchema: z.ZodEffects<z.ZodObject<{
         label?: string | undefined;
     }[] | undefined;
     runLabel?: string | undefined;
-    fidelity?: "low" | "medium" | "high" | undefined;
+    fidelity?: "high" | "medium" | "low" | undefined;
     profile?: "off" | "auto" | undefined;
     briefs?: {
         label: string;
@@ -156,7 +156,7 @@ export declare const inlineVariantRequestSchema: z.ZodEffects<z.ZodObject<{
         label?: string | undefined;
     }[] | undefined;
     runLabel?: string | undefined;
-    fidelity?: "low" | "medium" | "high" | undefined;
+    fidelity?: "high" | "medium" | "low" | undefined;
     profile?: "off" | "auto" | undefined;
     briefs?: {
         label: string;
@@ -184,7 +184,7 @@ export declare const inlineVariantRequestSchema: z.ZodEffects<z.ZodObject<{
         label?: string | undefined;
     }[] | undefined;
     runLabel?: string | undefined;
-    fidelity?: "low" | "medium" | "high" | undefined;
+    fidelity?: "high" | "medium" | "low" | undefined;
     profile?: "off" | "auto" | undefined;
     briefs?: {
         label: string;

package/dist/services/AuthService.js

@@ -403,7 +403,7 @@ class AuthService {
             if (tokenResult.success && tokenResult.token && tokenResult.user) {
                 this.configManager.setAuth(tokenResult.token, tokenResult.user.email, tokenResult.refreshToken, tokenResult.user.id, { expectedGeneration, isRecovery: true });
                 if (installRef) {
-                    this.configManager.clearInstallRef(installRef);
+                    this.configManager.completeInstallRefSignIn(installRef, tokenResult.user.id);
                 }
                 log.info(`Logged in as ${tokenResult.user.email}`);
             }
@@ -530,7 +530,7 @@ class AuthService {
             (0, pendingLogin_1.clearPendingLogin)();
             this.configManager.setAuth(tokenResult.token, tokenResult.user.email, tokenResult.refreshToken, tokenResult.user.id, { expectedGeneration: pending.generation, isRecovery: true });
             if (pending.installRef) {
-                this.configManager.clearInstallRef(pending.installRef);
+                this.configManager.completeInstallRefSignIn(pending.installRef, tokenResult.user.id);
             }
             log.info(`Logged in as ${tokenResult.user.email} (resumed login)`);
             return tokenResult;

package/dist/services/ConfigManager.d.ts

@@ -3,6 +3,20 @@ export interface AccountIdentity {
     userId?: string;
     email?: string;
 }
+export type InstallRefActivationTrigger = 'first_run' | 'sign_in';
+export type InstallRefActivation = {
+    installRef: string;
+    trigger: InstallRefActivationTrigger;
+    downloadType?: string;
+    userId?: string;
+};
+type InstallRefActivationRecord = {
+    installRef: string;
+    downloadType?: string;
+    signInUserId?: string;
+    pendingTriggers: InstallRefActivationTrigger[];
+    reportedTriggers: InstallRefActivationTrigger[];
+};
 type RivetConfig = {
     authToken?: string;
     refreshToken?: string;
@@ -21,6 +35,7 @@ type RivetConfig = {
     workerVendorFallback?: boolean;
     workerModels?: Partial<Record<'claude' | 'codex' | 'cursor', string>>;
     installRef?: string;
+    installRefActivations?: InstallRefActivationRecord[];
 };
 interface ConfigManagerOptions {
     configPath?: string;
@@ -65,8 +80,10 @@ export declare class ConfigManager {
     markFirstVariantsRun(): void;
     claimMcpRemovedTelemetryWindow(now?: Date): boolean;
     getInstallRef(): string | undefined;
-    setInstallRef(installRef: string): void;
+    setInstallRef(installRef: string, downloadType?: string): void;
     clearInstallRef(installRef: string): void;
+    completeInstallRefSignIn(installRef: string, userId: string | undefined): void;
+    claimInstallRefActivations(): InstallRefActivation[];
     getProxyUrl(): string;
     getConfiguredRunner(): string | undefined;
     getConfiguredRunnerPaths(): Record<string, unknown> | undefined;