rivet-design 0.26.1 → 0.27.0

package/dist/services/AuthService.d.ts

@@ -18,68 +18,16 @@ declare const LoginResponseSchema: z.ZodObject<{
         id: z.ZodString;
         email: z.ZodString;
         displayName: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        email: string;
-        id: string;
-        displayName?: string | undefined;
-    }, {
-        email: string;
-        id: string;
-        displayName?: string | undefined;
-    }>>;
+    }, z.core.$strip>>;
     profile: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         remaining_spend_usd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         monthly_limit_usd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         current_month_spend_usd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         total_spend_usd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    }, "strip", z.ZodTypeAny, {
-        remaining_spend_usd?: number | null | undefined;
-        monthly_limit_usd?: number | null | undefined;
-        current_month_spend_usd?: number | null | undefined;
-        total_spend_usd?: number | null | undefined;
-    }, {
-        remaining_spend_usd?: number | null | undefined;
-        monthly_limit_usd?: number | null | undefined;
-        current_month_spend_usd?: number | null | undefined;
-        total_spend_usd?: number | null | undefined;
-    }>>>;
+    }, z.core.$strip>>>;
     error: z.ZodOptional<z.ZodString>;
     message: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    success: boolean;
-    error?: string | undefined;
-    token?: string | undefined;
-    message?: string | undefined;
-    refreshToken?: string | undefined;
-    user?: {
-        email: string;
-        id: string;
-        displayName?: string | undefined;
-    } | undefined;
-    profile?: {
-        remaining_spend_usd?: number | null | undefined;
-        monthly_limit_usd?: number | null | undefined;
-        current_month_spend_usd?: number | null | undefined;
-        total_spend_usd?: number | null | undefined;
-    } | null | undefined;
-}, {
-    success: boolean;
-    error?: string | undefined;
-    token?: string | undefined;
-    message?: string | undefined;
-    refreshToken?: string | undefined;
-    user?: {
-        email: string;
-        id: string;
-        displayName?: string | undefined;
-    } | undefined;
-    profile?: {
-        remaining_spend_usd?: number | null | undefined;
-        monthly_limit_usd?: number | null | undefined;
-        current_month_spend_usd?: number | null | undefined;
-        total_spend_usd?: number | null | undefined;
-    } | null | undefined;
-}>;
+}, z.core.$strip>;
 type LoginResponse = z.infer<typeof LoginResponseSchema>;
 type UserProfile = {
     user: {
@@ -123,7 +71,6 @@ export declare class AuthService {
     resumePendingLogin(maxAttempts?: number): Promise<LoginResponse | null>;
     private pollForToken;
     logout(options?: LogoutOptions): Promise<void>;
-    getProfile(): Promise<UserProfile | null>;
     ensureAuthenticated(): Promise<boolean>;
     getValidatedProfile(): Promise<UserProfile | null>;
     isAuthenticated(): boolean;

package/dist/services/AuthService.js

@@ -600,34 +600,6 @@ class AuthService {
         }
         log.info('Logged out successfully');
     }
-    async getProfile() {
-        const token = this.configManager.getAuthToken();
-        if (!token) {
-            log.warn('No authentication token found');
-            return null;
-        }
-        try {
-            const response = await fetch(`${this.proxyUrl}/api/user/profile`, {
-                method: 'GET',
-                headers: {
-                    'Content-Type': 'application/json',
-                    Authorization: `Bearer ${token}`,
-                },
-                signal: AbortSignal.timeout(PROFILE_FETCH_TIMEOUT_MS),
-            });
-            if (!response.ok) {
-                const error = await response.json().catch(() => ({}));
-                log.warn('Failed to fetch profile:', error);
-                return null;
-            }
-            const result = await response.json();
-            return result.success ? result : null;
-        }
-        catch (error) {
-            log.warn('Profile fetch error:', error);
-            return null;
-        }
-    }
     async ensureAuthenticated() {
         const profile = await this.getValidatedProfile();
         return profile !== null;

package/dist/services/ConfigManager.d.ts

@@ -76,8 +76,6 @@ export declare class ConfigManager {
     setTelemetryIdentifiedEmail(email: string): void;
     getTelemetryIdentifiedUserId(): string | undefined;
     setTelemetryIdentifiedUserId(userId: string): void;
-    hasCompletedFirstVariantsRun(): boolean;
-    markFirstVariantsRun(): void;
     claimMcpRemovedTelemetryWindow(now?: Date): boolean;
     getInstallRef(): string | undefined;
     setInstallRef(installRef: string, downloadType?: string): void;

package/dist/services/ConfigManager.js

@@ -276,20 +276,6 @@ class ConfigManager {
         this.config.telemetryIdentifiedUserId = userId;
         this.saveConfig();
     }
-    hasCompletedFirstVariantsRun() {
-        this.reloadConfigFromDisk();
-        return Boolean(this.config.firstVariantsRunAt);
-    }
-    markFirstVariantsRun() {
-        if (this.config.firstVariantsRunAt)
-            return;
-        this.reloadConfigFromDisk();
-        if (this.config.firstVariantsRunAt)
-            return;
-        this.config.firstVariantsRunAt = new Date().toISOString();
-        this.saveConfig();
-        log.debug('Recorded first variants run for onboarding gate');
-    }
     claimMcpRemovedTelemetryWindow(now = new Date()) {
         const day = now.toISOString().slice(0, 10);
         this.reloadConfigFromDisk();

package/dist/services/DependencyPreparationService.js

@@ -16,6 +16,7 @@ const ProjectPackageManager_1 = require("./ProjectPackageManager");
 const errnoCode_1 = require("../utils/errnoCode");
 const pathContainment_1 = require("../utils/pathContainment");
 const errorMessage_1 = require("../utils/errorMessage");
+const failureReason_1 = require("../utils/failureReason");
 const subprocessEnvironment_1 = require("../utils/subprocessEnvironment");
 const MAX_CONCURRENT_INSTALLS = 2;
 const INSTALL_TIMEOUT_MS = 5 * 60 * 1000;
@@ -43,11 +44,13 @@ const isInstallEnvironmentKey = (key) => {
         INSTALL_ENVIRONMENT_KEYS.has(lower));
 };
 const yarnAgentForVersion = (version) => Number.parseInt(version, 10) > 1 ? 'yarn@berry' : 'yarn';
-const preparationError = (message, detail = '') => new devServerError_1.DevServerStartError({
+const preparationError = ({ reasonCode, message, detail = '', }) => new devServerError_1.DevServerStartError({
     message: detail ? `${message}\n${detail}` : message,
     reason: 'dependency_install_failed',
     portInUse: false,
     detail,
+    reasonCode,
+    summary: message,
 });
 class DependencyPreparationService {
     pending = new Map();
@@ -78,7 +81,10 @@ class DependencyPreparationService {
         catch (error) {
             if (error instanceof devServerError_1.DevServerStartError)
                 throw error;
-            throw preparationError(`Could not prepare preview dependencies: ${(0, errorMessage_1.errorMessage)(error)}`);
+            throw preparationError({
+                reasonCode: (0, failureReason_1.failureReasonCode)(error),
+                message: `Could not prepare preview dependencies: ${(0, errorMessage_1.errorMessage)(error)}`,
+            });
         }
     }
     forget(workspaceRoot) {
@@ -116,9 +122,16 @@ class DependencyPreparationService {
             .reverse()
             .find((line) => /^\d+\.\d+\.\d+(?:-.+)?$/.test(line));
         if (!version)
-            throw preparationError(`Could not identify the ${project.name} version`, versionOutput);
+            throw preparationError({
+                reasonCode: 'version_unreadable',
+                message: `Could not identify the ${project.name} version`,
+                detail: versionOutput,
+            });
         if (project.version && version !== project.version) {
-            throw preparationError(`This project requires ${project.name}@${project.version}, but the available command reports ${version}. Activate the project's package manager version, then retry the preview.`);
+            throw preparationError({
+                reasonCode: 'version_mismatch',
+                message: `This project requires ${project.name}@${project.version}, but the available command reports ${version}. Activate the project's package manager version, then retry the preview.`,
+            });
         }
         const agent = project.name === 'yarn' ? yarnAgentForVersion(version) : project.agent;
         const fingerprint = await this.fingerprint(project, version);
@@ -134,7 +147,10 @@ class DependencyPreparationService {
             : await this.fingerprint(project, version, true);
         const command = (0, package_manager_detector_1.resolveCommand)(agent, project.hasLockfile ? 'frozen' : 'install', []);
         if (!command)
-            throw preparationError(`No dependency install command is available for ${project.name}`);
+            throw preparationError({
+                reasonCode: 'no_install_command',
+                message: `No dependency install command is available for ${project.name}`,
+            });
         if (project.name === 'npm')
             command.args.push('--no-audit', '--no-fund');
         if (this.activeInstalls >= MAX_CONCURRENT_INSTALLS) {
@@ -166,7 +182,10 @@ class DependencyPreparationService {
                 ? completedFingerprint
                 : await this.fingerprint(project, version, true);
             if (inputsAfterInstall !== inputsBeforeInstall) {
-                throw preparationError('Dependency inputs changed during installation. Retry the preview to prepare the updated project.');
+                throw preparationError({
+                    reasonCode: 'inputs_changed',
+                    message: 'Dependency inputs changed during installation. Retry the preview to prepare the updated project.',
+                });
             }
             this.prepared.set(project.rootPath, {
                 fingerprint: completedFingerprint,
@@ -194,14 +213,20 @@ class DependencyPreparationService {
                 try {
                     const resolved = await promises_1.default.realpath(candidate);
                     if (!(0, pathContainment_1.isPathWithinRoot)(boundary, resolved))
-                        throw preparationError(`Dependency path resolves outside the preview workspace: ${candidate}`);
+                        throw preparationError({
+                            reasonCode: 'path_outside_workspace',
+                            message: `Dependency path resolves outside the preview workspace: ${candidate}`,
+                        });
                 }
                 catch (error) {
                     if ((0, errnoCode_1.errnoCode)(error) !== 'ENOENT')
                         throw error;
                     const entry = await promises_1.default.lstat(candidate).catch(() => null);
                     if (entry?.isSymbolicLink())
-                        throw preparationError(`Dependency path is a dangling symlink: ${candidate}`);
+                        throw preparationError({
+                            reasonCode: 'dangling_symlink',
+                            message: `Dependency path is a dangling symlink: ${candidate}`,
+                        });
                 }
             }
         }
@@ -284,7 +309,7 @@ class DependencyPreparationService {
                 stdio: 'pipe',
             });
             let output = '';
-            let interrupted = false;
+            let interruption;
             let settleTimer;
             const drain = (chunk) => {
                 output = (output + chunk.toString()).slice(-OUTPUT_TAIL_LIMIT);
@@ -292,35 +317,48 @@ class DependencyPreparationService {
             proc.stdout?.on('data', drain);
             proc.stderr?.on('data', drain);
             proc.stdin?.end();
-            const stop = () => {
-                interrupted = true;
+            const stop = (cause) => {
+                interruption ??= cause;
                 void OperatingSystemServices_1.selectedOperatingSystemServices.projectProcesses
                     .terminate(proc, { isForceful: true })
                     .catch(() => undefined);
                 settleTimer ??= setTimeout(() => {
                     cleanup();
-                    reject(preparationError(`Dependency preparation could not be stopped: ${project.name} ${args.join(' ')} is still running. Stop the process, then retry the preview.`, output.trim()));
+                    reject(preparationError({
+                        reasonCode: 'installer_unstoppable',
+                        message: `Dependency preparation could not be stopped: ${project.name} ${args.join(' ')} is still running. Stop the process, then retry the preview.`,
+                        detail: output.trim(),
+                    }));
                 }, this.terminationSettleTimeoutMs);
             };
-            const timer = setTimeout(stop, timeoutMs);
-            signal?.addEventListener('abort', stop, { once: true });
+            const abort = () => stop('aborted');
+            const timer = setTimeout(() => stop('timeout'), timeoutMs);
+            signal?.addEventListener('abort', abort, { once: true });
             if (signal?.aborted)
-                stop();
+                abort();
             const cleanup = () => {
                 clearTimeout(timer);
                 clearTimeout(settleTimer);
-                signal?.removeEventListener('abort', stop);
+                signal?.removeEventListener('abort', abort);
             };
             proc.once('error', (error) => {
                 cleanup();
-                reject(preparationError(`Could not run ${project.name} ${args.join(' ')}: ${error.message}`, output));
+                reject(preparationError({
+                    reasonCode: (0, failureReason_1.failureReasonCode)(error),
+                    message: `Could not run ${project.name} ${args.join(' ')}: ${error.message}`,
+                    detail: output,
+                }));
             });
             proc.once('close', (code) => {
                 cleanup();
-                if (code === 0 && !interrupted)
+                if (code === 0 && !interruption)
                     resolve(output);
                 else
-                    reject(preparationError(`Dependency preparation failed: ${project.name} ${args.join(' ')} (${interrupted ? 'cancelled or timed out' : `exit ${code}`}). Fix the installation error, then retry the preview.`, output.trim()));
+                    reject(preparationError({
+                        reasonCode: interruption ?? 'install_failed',
+                        message: `Dependency preparation failed: ${project.name} ${args.join(' ')} (${interruption ? 'cancelled or timed out' : `exit ${code}`}). Fix the installation error, then retry the preview.`,
+                        detail: output.trim(),
+                    }));
             });
         });
     }

package/dist/services/GuidanceVerifierRunner.js

@@ -254,16 +254,16 @@ const executeGuidanceVerifier = async (args) => {
         durationMs: Date.now() - started,
     });
     try {
-        await promises_1.default.mkdir(args.runsDirectory, { recursive: true, mode: 0o700 });
-        runDirectory = await promises_1.default.mkdtemp(path_1.default.join(await promises_1.default.realpath(args.runsDirectory), 'run-'));
-        if (args.signal?.aborted)
-            return failed('cancelled');
         if (args.packet.verifierState === 'missing')
             return failed('verifier_missing');
         if (args.packet.verifierState === 'stale')
             return failed('verifier_stale');
         if (!args.packet.verifier.package)
             return failed('package_required');
+        await promises_1.default.mkdir(args.runsDirectory, { recursive: true, mode: 0o700 });
+        runDirectory = await promises_1.default.mkdtemp(path_1.default.join(await promises_1.default.realpath(args.runsDirectory), 'run-'));
+        if (args.signal?.aborted)
+            return failed('cancelled');
         const executable = guidance_verifier_1.GuidanceVerifierPackageSchema.parse(args.packet.verifier.package);
         const packageDirectory = await (0, retainedTextFiles_1.materializeTextFiles)({
             files: executable.files,

package/dist/services/HubDiscovery.d.ts

@@ -3,15 +3,7 @@ declare const HubRecordSchema: z.ZodObject<{
     pid: z.ZodNumber;
     token: z.ZodString;
     port: z.ZodNullable<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    port: number | null;
-    token: string;
-    pid: number;
-}, {
-    port: number | null;
-    token: string;
-    pid: number;
-}>;
+}, z.core.$strip>;
 export type HubRecord = z.infer<typeof HubRecordSchema>;
 type ClaimResult = {
     status: 'owned';

package/dist/services/IntegrationsClient.d.ts

@@ -139,22 +139,22 @@ export declare class IntegrationsClient {
         cursor?: string;
         signal?: AbortSignal;
     }): Promise<{
-        total: number | null;
-        nextCursor: string | null;
         collections: {
+            id: string;
+            title: string;
             description: string | null;
             url: string | null;
-            title: string;
-            id: string;
-            children: string[];
             total: number | null;
             parentId: string | null;
+            children: string[];
         }[];
+        total: number | null;
+        nextCursor: string | null;
         profile: {
-            url: string;
-            title: string;
             id: string;
             username: string;
+            title: string;
+            url: string;
         };
     }>;
     readReferenceCollection(input: {
@@ -165,11 +165,11 @@ export declare class IntegrationsClient {
         signal?: AbortSignal;
     }): Promise<{
         accountId: string;
+        collectionId: string;
         references: {
+            remoteId: string;
             title: string;
             text: string;
-            provider: "pinterest" | "arena" | "cosmos" | "x";
-            remoteId: string;
             media: {
                 hash: string;
                 mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif";
@@ -177,21 +177,21 @@ export declare class IntegrationsClient {
                 representation: "variant" | "image" | "video-cover" | "page";
                 page?: number | undefined;
             }[];
+            provider: "pinterest" | "arena" | "cosmos" | "x";
+            url?: string | undefined;
+            remoteImages?: string[] | undefined;
+            remoteImageRepresentations?: ("image" | "video-cover")[] | undefined;
+            unsupportedReason?: string | undefined;
             variant?: {
                 projectId: string;
                 sessionId: string;
                 variantId: string;
                 treeSha?: string | undefined;
             } | undefined;
-            url?: string | undefined;
             note?: string | undefined;
-            remoteImages?: string[] | undefined;
-            remoteImageRepresentations?: ("image" | "video-cover")[] | undefined;
-            unsupportedReason?: string | undefined;
         }[];
         total: number | null;
         nextCursor: string | null;
-        collectionId: string;
         isCollectionComplete: boolean;
     }>;
     referenceAccount(input: {
@@ -199,10 +199,10 @@ export declare class IntegrationsClient {
         expectedAccountId: string;
         signal?: AbortSignal;
     }): Promise<{
-        url: string;
-        title: string;
         id: string;
         username: string;
+        title: string;
+        url: string;
     }>;
     discoverCosmos({ url, cursor, signal, }: CosmosDiscoveryInput): Promise<CosmosProfilePage>;
     fetchCosmos({ url, collectionId, cursor, signal, }: CosmosFetchInput): Promise<CosmosResult>;

package/dist/services/MCPOnboardingTelemetry.d.ts

@@ -1,9 +1,6 @@
-import type { ChangeRequest } from '../types/change-request-types';
 export type MCPSource = 'mcp' | 'ui' | 'core';
 export type MCPAuthState = 'authenticated' | 'unauthenticated' | 'unknown';
 export type MCPAuthMethod = 'google' | 'existing_session' | 'hosted_oauth';
-export type MCPTargetKind = 'app' | 'variant' | 'static_preview' | 'unknown';
-export type MCPHandoffPathCategory = 'landing' | 'local_rivet' | 'mcp_client_connect' | 'oauth_callback' | 'unknown';
 export type MCPOAuthCallbackResult = 'accepted' | 'missing_state' | 'missing_code' | 'state_mismatch' | 'exchange_failed' | 'credential_store_failed' | 'unknown';
 export type MCPOnboardingCorrelation = {
     onboardingAttemptId?: string;
@@ -16,15 +13,4 @@ export type MCPOnboardingCorrelation = {
     mcpEditor?: string;
     source?: MCPSource;
 };
-export type MCPConversationTurnMetadata = MCPOnboardingCorrelation & {
-    round: number;
-    messageCount: number;
-    instructionLengthTotal: number;
-    maxInstructionLength: number;
-    imageCount: number;
-    elementCount: number;
-    sourceFileCount: number;
-    targetKind: MCPTargetKind;
-};
-export declare const summarizeMCPConversationTurn: (request: ChangeRequest, round: number, sessionId: string) => MCPConversationTurnMetadata;
 //# sourceMappingURL=MCPOnboardingTelemetry.d.ts.map

package/dist/services/MCPOnboardingTelemetry.js

@@ -1,65 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.summarizeMCPConversationTurn = void 0;
-const commentElements = (item) => [
-    item.element,
-    ...(item.elements ?? []),
-];
-const getTargetKind = (isStaticPreviewTarget, isVariantTarget) => {
-    if (isStaticPreviewTarget) {
-        return 'static_preview';
-    }
-    if (isVariantTarget) {
-        return 'variant';
-    }
-    return 'app';
-};
-const summarizeMCPConversationTurn = (request, round, sessionId) => {
-    let messageCount = 0;
-    let instructionLengthTotal = 0;
-    let maxInstructionLength = 0;
-    let imageCount = 0;
-    let elementCount = 0;
-    let isVariantTarget = Boolean(request.target);
-    let isStaticPreviewTarget = Boolean(request.staticPreviewTarget);
-    for (const item of request.changes) {
-        if (item.kind === 'comment') {
-            messageCount++;
-            instructionLengthTotal += item.instruction.length;
-            maxInstructionLength = Math.max(maxInstructionLength, item.instruction.length);
-            imageCount += item.images?.length ?? 0;
-            elementCount += commentElements(item).length;
-            isVariantTarget = isVariantTarget || Boolean(item.target);
-            isStaticPreviewTarget =
-                isStaticPreviewTarget || Boolean(item.staticPreviewTarget);
-            continue;
-        }
-        if (item.kind === 'chat') {
-            messageCount++;
-            instructionLengthTotal += item.instruction.length;
-            maxInstructionLength = Math.max(maxInstructionLength, item.instruction.length);
-            imageCount += item.images?.length ?? 0;
-            continue;
-        }
-        if ('element' in item) {
-            elementCount++;
-        }
-    }
-    return {
-        sessionId,
-        round,
-        messageCount,
-        instructionLengthTotal,
-        maxInstructionLength,
-        imageCount,
-        elementCount,
-        sourceFileCount: new Set(request.sourceFiles ?? []).size,
-        targetKind: getTargetKind(isStaticPreviewTarget, isVariantTarget),
-        traceId: request.traceId,
-        agentRunId: request.agentRunId,
-        browserSessionId: request.telemetryContext?.browserSessionId,
-        browserDistinctId: request.telemetryContext?.browserDistinctId,
-    };
-};
-exports.summarizeMCPConversationTurn = summarizeMCPConversationTurn;
 //# sourceMappingURL=MCPOnboardingTelemetry.js.map

package/dist/services/ProjectPackageManager.d.ts

@@ -1,5 +1,10 @@
 import { type Agent } from 'package-manager-detector';
+import type { FailureReasonCode } from '../utils/failureReason';
 export type PreviewPackageManager = 'npm' | 'yarn' | 'pnpm';
+export declare class PackageManagerError extends Error {
+    readonly reasonCode: FailureReasonCode;
+    constructor(reasonCode: FailureReasonCode, message: string);
+}
 export interface ProjectPackageManager {
     name: PreviewPackageManager;
     agent: Agent;

package/dist/services/ProjectPackageManager.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveProjectPackageManager = exports.readProjectFile = exports.isInstallOutputPath = exports.forEveryPackageManager = exports.INSTALL_CONTENT_GLOBS = exports.INSTALL_ARTIFACTS = exports.INSTALL_CONFIG_FILES = exports.LOCKFILES = void 0;
+exports.resolveProjectPackageManager = exports.readProjectFile = exports.isInstallOutputPath = exports.forEveryPackageManager = exports.INSTALL_CONTENT_GLOBS = exports.INSTALL_ARTIFACTS = exports.INSTALL_CONFIG_FILES = exports.LOCKFILES = exports.PackageManagerError = void 0;
 const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
 const glob_1 = require("glob");
@@ -11,6 +11,15 @@ const js_yaml_1 = require("js-yaml");
 const package_manager_detector_1 = require("package-manager-detector");
 const errnoCode_1 = require("../utils/errnoCode");
 const pathContainment_1 = require("../utils/pathContainment");
+class PackageManagerError extends Error {
+    reasonCode;
+    constructor(reasonCode, message) {
+        super(message);
+        this.reasonCode = reasonCode;
+        this.name = 'PackageManagerError';
+    }
+}
+exports.PackageManagerError = PackageManagerError;
 exports.LOCKFILES = {
     npm: ['package-lock.json', 'npm-shrinkwrap.json'],
     yarn: ['yarn.lock'],
@@ -79,13 +88,26 @@ const readProjectFile = async (file) => {
 exports.readProjectFile = readProjectFile;
 const readManifest = async (root) => {
     const source = await (0, exports.readProjectFile)(path_1.default.join(root, 'package.json'));
-    return source === null ? null : JSON.parse(source);
+    if (source === null)
+        return null;
+    try {
+        return JSON.parse(source);
+    }
+    catch {
+        throw new PackageManagerError('invalid_manifest', 'package.json is not valid JSON');
+    }
+};
+const readPnpmWorkspace = (source) => {
+    try {
+        return (0, js_yaml_1.load)(source, { schema: js_yaml_1.JSON_SCHEMA });
+    }
+    catch {
+        throw new PackageManagerError('invalid_workspace', 'pnpm-workspace.yaml is not valid YAML');
+    }
 };
 const packagePathsFor = async (root, manifest) => {
     const pnpmSource = await (0, exports.readProjectFile)(path_1.default.join(root, 'pnpm-workspace.yaml'));
-    const pnpmConfig = pnpmSource === null
-        ? null
-        : (0, js_yaml_1.load)(pnpmSource, { schema: js_yaml_1.JSON_SCHEMA });
+    const pnpmConfig = pnpmSource === null ? null : readPnpmWorkspace(pnpmSource);
     const patterns = pnpmConfig?.packages ??
         (Array.isArray(manifest.workspaces)
             ? manifest.workspaces
@@ -93,7 +115,7 @@ const packagePathsFor = async (root, manifest) => {
         [];
     if (!Array.isArray(patterns) ||
         patterns.some((pattern) => typeof pattern !== 'string')) {
-        throw new Error('Workspace packages must be an array of directory patterns');
+        throw new PackageManagerError('invalid_workspace', 'Workspace packages must be an array of directory patterns');
     }
     const included = patterns.filter((pattern) => !pattern.startsWith('!'));
     const excluded = patterns
@@ -107,7 +129,7 @@ const packagePathsFor = async (root, manifest) => {
     });
     const members = await Promise.all(files.map((file) => promises_1.default.realpath(path_1.default.dirname(file))));
     if (members.some((member) => !(0, pathContainment_1.isPathWithinRoot)(root, member))) {
-        throw new Error('A workspace package resolves outside the preview workspace');
+        throw new PackageManagerError('path_outside_workspace', 'A workspace package resolves outside the preview workspace');
     }
     return [...new Set([root, ...members.sort()])];
 };
@@ -115,7 +137,7 @@ const resolveProjectPackageManager = async (options) => {
     const cwd = await promises_1.default.realpath(options.cwd);
     const boundary = await promises_1.default.realpath(options.workspaceRoot);
     if (!(0, pathContainment_1.isPathWithinRoot)(boundary, cwd)) {
-        throw new Error('Dependency preparation directory is outside the preview workspace');
+        throw new PackageManagerError('path_outside_workspace', 'Dependency preparation directory is outside the preview workspace');
     }
     let rootPath = cwd;
     let manifest = await readManifest(cwd);
@@ -139,7 +161,7 @@ const resolveProjectPackageManager = async (options) => {
     const declared = manifest.packageManager;
     const declaration = declared ? parsePackageManagerDeclaration(declared) : null;
     if (declared && !declaration) {
-        throw new Error(`Unsupported packageManager declaration: ${declared}. Preview preparation supports pinned npm, Yarn, and pnpm versions.`);
+        throw new PackageManagerError('invalid_package_manager_field', `Unsupported packageManager declaration: ${declared}. Preview preparation supports pinned npm, Yarn, and pnpm versions.`);
     }
     const managersWithLockfiles = [];
     for (const name of Object.keys(exports.LOCKFILES)) {
@@ -164,7 +186,7 @@ const resolveProjectPackageManager = async (options) => {
         !manifest.devEngines?.packageManager &&
         managersWithLockfiles.length > 1 &&
         !selectedManager) {
-        throw new Error('Multiple package manager lockfiles found. Set package.json packageManager to select the project tool.');
+        throw new PackageManagerError('multiple_lockfiles', 'Multiple package manager lockfiles found. Set package.json packageManager to select the project tool.');
     }
     const detected = selectedManager
         ? null
@@ -175,7 +197,7 @@ const resolveProjectPackageManager = async (options) => {
         });
     const name = selectedManager ?? detected?.name ?? 'npm';
     if (name !== 'npm' && name !== 'yarn' && name !== 'pnpm') {
-        throw new Error(`Preview dependency preparation does not support ${name}`);
+        throw new PackageManagerError('unsupported_package_manager', `Preview dependency preparation does not support ${name}`);
     }
     let agent = selectedManager ?? detected?.agent ?? name;
     if (name === 'yarn' &&