rivet-design 0.19.0 → 0.20.0

package/dist/agent-variants/variantWorkspaceFiles.js

@@ -0,0 +1,426 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultMaterializeProject = exports.assertDevScriptExists = exports.canInstallWithoutTouchingHost = exports.buildServeRecipeFromResolved = exports.defaultInstallDependencies = exports.STATIC_PREVIEW_HISTORY_FILE_EXTENSIONS = exports.STATIC_PREVIEW_HISTORY_EXCLUDE = exports.MATERIALIZE_EXCLUDE = exports.ALLOWED_INERT_ASSET_EXTENSIONS = void 0;
+exports.estimateOutputBytes = estimateOutputBytes;
+exports.normalizeOutput = normalizeOutput;
+exports.isStrictlyInside = isStrictlyInside;
+exports.resolveAssetWithinBase = resolveAssetWithinBase;
+exports.resolveStaticPreviewAssetBase = resolveStaticPreviewAssetBase;
+exports.parseStaticPreviewOutput = parseStaticPreviewOutput;
+exports.buildStaticPreviewDocument = buildStaticPreviewDocument;
+exports.countDiffFiles = countDiffFiles;
+exports.countWorktreeFiles = countWorktreeFiles;
+exports.copyStaticPreviewDirectory = copyStaticPreviewDirectory;
+exports.areSameVolume = areSameVolume;
+exports.resolveNodeModulesSymlink = resolveNodeModulesSymlink;
+exports.synthesizeUnifiedBriefBody = synthesizeUnifiedBriefBody;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const simple_git_1 = require("simple-git");
+const DependencyPreparationService_1 = require("../services/DependencyPreparationService");
+const devServerError_1 = require("../utils/devServerError");
+const logger_1 = require("../utils/logger");
+const log = (0, logger_1.createLogger)('VariantWorkspaceFiles');
+const FALLBACK_DIRECTION_FOCI = [
+    'Emphasize hierarchy and one unmistakable primary action.',
+    'Use stronger contrast, scale shifts, and a more expressive visual system.',
+    'Favor a quieter, spacious composition with restrained supporting detail.',
+    'Make information density and fast scanning the organizing principle.',
+    'Lead with imagery and let content frame the visual story.',
+    'Use modular cards and clear grouping to expose the product structure.',
+    'Explore tactile depth, layering, and purposeful interaction cues.',
+    'Reduce the concept to its most essential typography and geometry.',
+];
+exports.ALLOWED_INERT_ASSET_EXTENSIONS = new Set([
+    '.glb',
+    '.gltf',
+    '.obj',
+    '.fbx',
+    '.usdz',
+    '.png',
+    '.jpg',
+    '.jpeg',
+    '.gif',
+    '.webp',
+    '.svg',
+    '.avif',
+    '.bmp',
+    '.ico',
+    '.mp4',
+    '.webm',
+    '.mov',
+    '.mp3',
+    '.wav',
+    '.ogg',
+    '.m4a',
+    '.woff',
+    '.woff2',
+    '.ttf',
+    '.otf',
+    '.eot',
+    '.pdf',
+]);
+function estimateOutputBytes(output) {
+    if (output === undefined || output === null)
+        return 0;
+    try {
+        return typeof output === 'string'
+            ? output.length
+            : JSON.stringify(output).length;
+    }
+    catch {
+        return 0;
+    }
+}
+function normalizeOutput(output) {
+    if (typeof output === 'string') {
+        try {
+            return JSON.parse(output);
+        }
+        catch {
+            return output;
+        }
+    }
+    return output;
+}
+function isStrictlyInside(child, parent) {
+    const c = path_1.default.resolve(child);
+    const p = path_1.default.resolve(parent);
+    return c !== p && c.startsWith(p + path_1.default.sep);
+}
+function resolveAssetWithinBase(base, requestedPath) {
+    const target = path_1.default.resolve(base, '.' + path_1.default.sep + requestedPath);
+    if (target !== base && !target.startsWith(base + path_1.default.sep)) {
+        return undefined;
+    }
+    let realTarget;
+    try {
+        realTarget = fs_1.default.realpathSync(target);
+    }
+    catch {
+        return undefined;
+    }
+    if (realTarget !== base && !realTarget.startsWith(base + path_1.default.sep)) {
+        return undefined;
+    }
+    try {
+        const stat = fs_1.default.statSync(realTarget);
+        if (!stat.isFile())
+            return undefined;
+        if (stat.nlink !== 1)
+            return undefined;
+        return realTarget;
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveStaticPreviewAssetBase(args) {
+    if (!args.assetBase)
+        return undefined;
+    if (args.projectContext.kind !== 'fresh')
+        return undefined;
+    let workspace;
+    let resolved;
+    try {
+        const wsStat = fs_1.default.lstatSync(args.projectContext.workspacePath);
+        if (wsStat.isSymbolicLink()) {
+            log.warn(`Static preview workspacePath ${args.projectContext.workspacePath} is a symlink — refusing assetBase`);
+            return undefined;
+        }
+        const realWorkspaceRoot = fs_1.default.realpathSync(args.projectContext.workspaceRoot);
+        workspace = fs_1.default.realpathSync(args.projectContext.workspacePath);
+        if (!workspace.startsWith(realWorkspaceRoot + path_1.default.sep)) {
+            log.warn(`Static preview workspacePath ${workspace} is not a strict descendant of workspaceRoot ${realWorkspaceRoot} — refusing assetBase`);
+            return undefined;
+        }
+        const candidate = path_1.default.isAbsolute(args.assetBase)
+            ? args.assetBase
+            : path_1.default.join(workspace, args.assetBase);
+        resolved = fs_1.default.realpathSync(candidate);
+    }
+    catch {
+        log.warn(`Static preview assetBase ${args.assetBase} could not be resolved — ignoring`);
+        return undefined;
+    }
+    if (resolved !== workspace && !resolved.startsWith(workspace + path_1.default.sep)) {
+        log.warn(`Static preview assetBase ${args.assetBase} escapes workspace ${workspace} — ignoring`);
+        return undefined;
+    }
+    try {
+        const stat = fs_1.default.statSync(resolved);
+        if (!stat.isDirectory()) {
+            log.warn(`Static preview assetBase ${resolved} is not a directory — ignoring`);
+            return undefined;
+        }
+        return resolved;
+    }
+    catch {
+        log.warn(`Static preview assetBase ${resolved} does not exist — ignoring`);
+        return undefined;
+    }
+}
+function parseStaticPreviewOutput(output) {
+    if (!output || typeof output !== 'object')
+        return null;
+    const html = output.html;
+    if (typeof html !== 'string' || html.trim().length === 0)
+        return null;
+    const css = output.css;
+    const js = output.js;
+    const assetBase = output.assetBase;
+    return {
+        html: buildStaticPreviewDocument({
+            html,
+            css: typeof css === 'string' ? css : undefined,
+            js: typeof js === 'string' ? js : undefined,
+        }),
+        ...(typeof assetBase === 'string' && assetBase.length > 0
+            ? { assetBase }
+            : {}),
+    };
+}
+function buildStaticPreviewDocument(input) {
+    const style = input.css ? `<style>\n${input.css}\n</style>` : '';
+    const script = input.js ? `<script>\n${input.js}\n</script>` : '';
+    if (/<!doctype html>|<html[\s>]/i.test(input.html)) {
+        let doc = input.html;
+        if (style) {
+            if (/<\/head>/i.test(doc)) {
+                doc = doc.replace(/<\/head>/i, () => `${style}\n</head>`);
+            }
+            else {
+                doc += `\n${style}`;
+            }
+        }
+        if (script) {
+            if (/<\/body>/i.test(doc)) {
+                doc = doc.replace(/<\/body>/i, () => `${script}\n</body>`);
+            }
+            else {
+                doc += `\n${script}`;
+            }
+        }
+        return doc;
+    }
+    return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    ${style}
+  </head>
+  <body>
+${input.html}
+    ${script}
+  </body>
+</html>`;
+}
+function countDiffFiles(diff) {
+    return (diff.match(/^diff --git /gm) ?? []).length;
+}
+function countWorktreeFiles(destinationPath) {
+    let count = 0;
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (exports.MATERIALIZE_EXCLUDE.has(entry.name))
+                continue;
+            const full = path_1.default.join(dir, entry.name);
+            if (entry.isDirectory())
+                walk(full);
+            else if (entry.isFile())
+                count += 1;
+        }
+    };
+    walk(destinationPath);
+    return count;
+}
+exports.MATERIALIZE_EXCLUDE = new Set([
+    'node_modules',
+    '.git',
+    '.rivet',
+    'dist',
+    '.next',
+    '.cache',
+    '.vite',
+]);
+exports.STATIC_PREVIEW_HISTORY_EXCLUDE = new Set([
+    ...exports.MATERIALIZE_EXCLUDE,
+    '.rivet',
+]);
+exports.STATIC_PREVIEW_HISTORY_FILE_EXTENSIONS = new Set([
+    ...exports.ALLOWED_INERT_ASSET_EXTENSIONS,
+    '.css',
+    '.htm',
+    '.html',
+    '.js',
+]);
+function copyStaticPreviewDirectory(src, dest) {
+    fs_1.default.mkdirSync(dest, { recursive: true });
+    let entries;
+    try {
+        entries = fs_1.default.readdirSync(src, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.name.startsWith('.') ||
+            exports.STATIC_PREVIEW_HISTORY_EXCLUDE.has(entry.name)) {
+            continue;
+        }
+        const from = path_1.default.join(src, entry.name);
+        const to = path_1.default.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyStaticPreviewDirectory(from, to);
+        }
+        else if (entry.isFile()) {
+            const extension = path_1.default.extname(entry.name).toLowerCase();
+            if (!exports.STATIC_PREVIEW_HISTORY_FILE_EXTENSIONS.has(extension))
+                continue;
+            let stat;
+            try {
+                stat = fs_1.default.statSync(from);
+            }
+            catch {
+                continue;
+            }
+            if (!stat.isFile() || stat.nlink !== 1)
+                continue;
+            fs_1.default.mkdirSync(path_1.default.dirname(to), { recursive: true });
+            fs_1.default.copyFileSync(from, to);
+        }
+    }
+}
+const defaultInstallDependencies = async (worktreePath, options) => {
+    await DependencyPreparationService_1.previewDependencies.prepare({
+        cwd: worktreePath,
+        workspaceRoot: options?.workspaceRoot ?? worktreePath,
+        force: options?.force,
+        signal: options?.signal,
+    });
+};
+exports.defaultInstallDependencies = defaultInstallDependencies;
+const buildServeRecipeFromResolved = (snapshotRoot, dev, port) => {
+    const portPattern = new RegExp(`(?<![0-9])${port}(?![0-9])`, 'g');
+    const sub = (value) => value.replace(portPattern, '${PORT}');
+    const relativeCwd = path_1.default.relative(snapshotRoot, dev.cwd);
+    return {
+        cwd: relativeCwd === '' ? '.' : relativeCwd,
+        cmd: dev.cmd,
+        argsTemplate: dev.args.map(sub),
+        envTemplate: Object.fromEntries(Object.entries(dev.env).map(([key, value]) => [key, sub(value)])),
+    };
+};
+exports.buildServeRecipeFromResolved = buildServeRecipeFromResolved;
+const canInstallWithoutTouchingHost = (cwd) => {
+    try {
+        return !fs_1.default.lstatSync(path_1.default.join(cwd, 'node_modules')).isSymbolicLink();
+    }
+    catch {
+        return true;
+    }
+};
+exports.canInstallWithoutTouchingHost = canInstallWithoutTouchingHost;
+const assertDevScriptExists = (cwd, scriptName) => {
+    let scripts;
+    try {
+        const raw = fs_1.default.readFileSync(path_1.default.join(cwd, 'package.json'), 'utf8');
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object' && 'scripts' in parsed) {
+            const candidate = parsed.scripts;
+            if (candidate && typeof candidate === 'object') {
+                scripts = candidate;
+            }
+        }
+    }
+    catch {
+        return;
+    }
+    if (scripts && typeof scripts[scriptName] === 'string')
+        return;
+    const available = Object.keys(scripts ?? {});
+    throw new devServerError_1.DevServerStartError({
+        message: `package.json at ${cwd} has no "${scriptName}" script` +
+            (available.length ? ` (available: ${available.join(', ')})` : ''),
+        reason: 'missing_dev_script',
+        portInUse: false,
+        detail: available.length
+            ? `available scripts: ${available.join(', ')}`
+            : '',
+    });
+};
+exports.assertDevScriptExists = assertDevScriptExists;
+function areSameVolume(a, b) {
+    try {
+        const statA = fs_1.default.statSync(a);
+        const parentB = fs_1.default.existsSync(b) ? b : path_1.default.dirname(b);
+        const statB = fs_1.default.statSync(parentB);
+        return statA.dev === statB.dev;
+    }
+    catch {
+        return false;
+    }
+}
+async function resolveNodeModulesSymlink(worktreePath) {
+    const nodeModulesPath = path_1.default.join(worktreePath, 'node_modules');
+    try {
+        if (!(await fs_1.default.promises.lstat(nodeModulesPath)).isSymbolicLink())
+            return false;
+        await fs_1.default.promises.rm(nodeModulesPath, { force: true });
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return true;
+        throw error;
+    }
+}
+const defaultMaterializeProject = async (sourceWorktreePath, destinationPath) => {
+    await fs_1.default.promises.mkdir(destinationPath, { recursive: true });
+    await fs_1.default.promises.cp(sourceWorktreePath, destinationPath, {
+        recursive: true,
+        filter: (sourcePath) => {
+            const rel = path_1.default.relative(sourceWorktreePath, sourcePath);
+            if (!rel)
+                return true;
+            const top = rel.split(path_1.default.sep)[0];
+            return !exports.MATERIALIZE_EXCLUDE.has(top);
+        },
+    });
+    const git = (0, simple_git_1.simpleGit)(destinationPath);
+    await git.raw(['init']);
+    await git.raw(['add', '-A']);
+    await git
+        .raw([
+        '-c',
+        'user.name=Rivet',
+        '-c',
+        'user.email=hello@tryrivet.design',
+        'commit',
+        '--no-gpg-sign',
+        '-m',
+        'Initial commit (created with Rivet)',
+    ])
+        .catch(() => { });
+};
+exports.defaultMaterializeProject = defaultMaterializeProject;
+function synthesizeUnifiedBriefBody(prompt, index, total) {
+    const trimmed = prompt.trim().replace(/\s+/g, ' ').slice(0, 200);
+    const intent = trimmed.length > 0 ? trimmed : 'Create this variant';
+    if (total <= 1)
+        return intent;
+    const focus = FALLBACK_DIRECTION_FOCI[(Math.max(index, 1) - 1) % FALLBACK_DIRECTION_FOCI.length];
+    return `${intent} Direction ${index} of ${total}: ${focus}`;
+}
+//# sourceMappingURL=variantWorkspaceFiles.js.map

package/dist/agent-variants/variantWorkspaceFiles.js.map

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

package/dist/agent-variants/variantsTelemetry.d.ts

@@ -0,0 +1,189 @@
+import type { MCPVariantsTelemetryMetadata } from '../services/MCPVariantsTelemetry';
+import type { DesignContextEntry } from './contracts';
+export interface VariantsTelemetry {
+    track(event: string, properties?: Record<string, unknown>): void;
+    trackAgentVariantsRequestStarted?: (data: MCPVariantsTelemetryMetadata) => void;
+    trackAgentVariantsRequestAccepted?: (data: MCPVariantsTelemetryMetadata) => void;
+    trackAgentVariantsRequestRejected?: (data: MCPVariantsTelemetryMetadata) => void;
+    trackAgentVariantsSourcePlanStarted?: (data: MCPVariantsTelemetryMetadata) => void;
+    trackAgentVariantsSourcePlanCompleted?: (data: MCPVariantsTelemetryMetadata) => void;
+    trackAgentVariantsSourcePlanFailed?: (data: MCPVariantsTelemetryMetadata) => void;
+    trackAgentVariantsBriefsStarted?: (data: MCPVariantsTelemetryMetadata) => void;
+    trackAgentVariantsBriefsCompleted?: (data: MCPVariantsTelemetryMetadata) => void;
+    trackAgentVariantsBriefsFailed?: (data: MCPVariantsTelemetryMetadata) => void;
+    trackAgentVariantsRefinementRequested?: (data: MCPVariantsTelemetryMetadata) => void;
+    trackAgentVariantsRefinementLeased?: (data: MCPVariantsTelemetryMetadata) => void;
+    trackAgentVariantsRefinementCompleted?: (data: MCPVariantsTelemetryMetadata) => void;
+    trackAgentVariantsRefinementFailed?: (data: MCPVariantsTelemetryMetadata) => void;
+    trackAgentVariantsRoundStarted?: (data: MCPVariantsTelemetryMetadata) => void;
+    trackAgentVariantsRoundCompleted?: (data: MCPVariantsTelemetryMetadata) => void;
+    trackAgentVariantsCommitFailed?: (data: MCPVariantsTelemetryMetadata) => void;
+    trackAgentVariantsScaffoldStarted?: (data: {
+        sessionId: string;
+        variantCount: number;
+        designContext?: Array<{
+            slot: number;
+            kind: 'slug' | 'markdown';
+            slug?: string;
+            markdownLabel?: string;
+        }> | null;
+    }) => void;
+    trackAgentVariantsScaffoldCompleted?: (data: {
+        sessionId: string;
+        durationMs: number;
+        installDurationMs: number;
+        variantCount: number;
+    }) => void;
+    trackAgentVariantsScaffoldFailed?: (data: {
+        sessionId: string;
+        errorCode: string;
+        durationMs: number;
+    }) => void;
+    trackAgentVariantsFreshDevServerStarted?: (data: {
+        sessionId: string;
+        variantId: string;
+        port: number;
+    }) => void;
+    trackAgentVariantsFreshDevServerFailed?: (data: {
+        sessionId: string;
+        variantId: string;
+        errorCode: string;
+        reason?: string;
+        portInUse?: boolean;
+        exitCode?: number | null;
+        signal?: string | null;
+        missingDeps?: boolean;
+    }) => void;
+    trackAgentVariantsPreviewStarted?: (data: {
+        sessionId: string;
+        variantId: string;
+        projectContextKind: 'existing' | 'fresh';
+        previewKind: 'dev_server' | 'static_artifact';
+    }) => void;
+    trackAgentVariantsPreviewReady?: (data: {
+        sessionId: string;
+        variantId: string;
+        projectContextKind: 'existing' | 'fresh';
+        previewKind: 'dev_server' | 'static_artifact';
+        hasPort: boolean;
+        port?: number;
+        durationMs?: number | null;
+    }) => void;
+    trackAgentVariantsPreviewFailed?: (data: {
+        sessionId: string;
+        variantId: string;
+        projectContextKind: 'existing' | 'fresh';
+        previewKind: 'dev_server' | 'static_artifact';
+        errorCode: string;
+        reason?: string;
+        portInUse?: boolean;
+        durationMs?: number | null;
+        exitCode?: number | null;
+        signal?: string | null;
+        missingDeps?: boolean;
+    }) => void;
+    trackAgentVariantsNewProjectMaterialized?: (data: {
+        sessionId: string;
+        variantId: string;
+        destinationPath: string;
+        changedFilesCount: number;
+        durationMs: number;
+    }) => void;
+    trackAgentVariantsSourceContextQuality?: (data: {
+        sessionId: string;
+        sourceUrlCount: number;
+        artifactCount: number;
+        hasScreenshotReferences: boolean;
+        preserveBrand: boolean;
+    }) => void;
+    trackAgentVariantsBriefQuality?: (data: {
+        sessionId: string;
+        briefCount: number;
+        evidenceBackedCount: number;
+        shortBriefCount: number;
+    }) => void;
+    trackAgentVariantsStaticPreviewCompleted?: (data: {
+        sessionId: string;
+        variantId: string;
+        durationMs: number | null;
+    }) => void;
+}
+export declare const NOOP_TELEMETRY: VariantsTelemetry;
+type DesignContextTelemetryEntry = {
+    slot: number;
+    kind: 'slug' | 'markdown';
+    slug?: string;
+    markdownLabel?: string;
+};
+export declare const summarizeDesignContext: (designContext: ReadonlyArray<DesignContextEntry | undefined> | undefined) => DesignContextTelemetryEntry[] | null;
+export declare const trackScaffoldStarted: (telemetry: VariantsTelemetry, data: {
+    sessionId: string;
+    variantCount: number;
+    designContext?: Array<{
+        slot: number;
+        kind: "slug" | "markdown";
+        slug?: string;
+        markdownLabel?: string;
+    }> | null;
+}) => void;
+export declare const trackScaffoldCompleted: (telemetry: VariantsTelemetry, data: {
+    sessionId: string;
+    durationMs: number;
+    installDurationMs: number;
+    variantCount: number;
+}) => void;
+export declare const trackScaffoldFailed: (telemetry: VariantsTelemetry, data: {
+    sessionId: string;
+    errorCode: string;
+    durationMs: number;
+}) => void;
+export declare const trackFreshDevServerStarted: (telemetry: VariantsTelemetry, data: {
+    sessionId: string;
+    variantId: string;
+    port: number;
+}) => void;
+export declare const trackFreshDevServerFailed: (telemetry: VariantsTelemetry, data: {
+    sessionId: string;
+    variantId: string;
+    errorCode: string;
+    reason?: string;
+    portInUse?: boolean;
+    exitCode?: number | null;
+    signal?: string | null;
+    missingDeps?: boolean;
+}) => void;
+export declare const trackPreviewStarted: (telemetry: VariantsTelemetry, data: {
+    sessionId: string;
+    variantId: string;
+    projectContextKind: "existing" | "fresh";
+    previewKind: "dev_server" | "static_artifact";
+}) => void;
+export declare const trackPreviewReady: (telemetry: VariantsTelemetry, data: {
+    sessionId: string;
+    variantId: string;
+    projectContextKind: "existing" | "fresh";
+    previewKind: "dev_server" | "static_artifact";
+    hasPort: boolean;
+    port?: number;
+    durationMs?: number | null;
+}) => void;
+export declare const trackPreviewFailed: (telemetry: VariantsTelemetry, data: {
+    sessionId: string;
+    variantId: string;
+    projectContextKind: "existing" | "fresh";
+    previewKind: "dev_server" | "static_artifact";
+    errorCode: string;
+    reason?: string;
+    portInUse?: boolean;
+    durationMs?: number | null;
+    exitCode?: number | null;
+    signal?: string | null;
+    missingDeps?: boolean;
+}) => void;
+export declare const trackStaticPreviewCompleted: (telemetry: VariantsTelemetry, data: {
+    sessionId: string;
+    variantId: string;
+    durationMs: number | null;
+}) => void;
+export {};
+//# sourceMappingURL=variantsTelemetry.d.ts.map

package/dist/agent-variants/variantsTelemetry.d.ts.map

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