rivet-design 0.10.6 → 0.10.8

package/dist/mcp/agent-variants/generatedDestination.js.map

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

package/dist/mcp/agent-variants/index.d.ts

@@ -3,9 +3,8 @@ export type { ApprovedBriefSelection, ApproveResult, ProposeArgs, ProposeResult,
 export { PendingChangesAdapter } from './pendingChangesAdapter';
 export type { AdapterTelemetry, BridgeChangeIntent, BridgeQueue, } from './pendingChangesAdapter';
 export { AgentVariantsOrchestrator } from './WorktreeOrchestrator';
-export type { OrchestratorDeps, ProjectEnvironment, WorktreeManagerLike, } from './WorktreeOrchestrator';
+export type { ActiveSnapshot, OrchestratorDeps, ProjectEnvironment, WorktreeManagerLike, } from './WorktreeOrchestrator';
 export { registerAgentVariantsTools, slugifyPrompt } from './tools';
-export { registerCreateZeroToOneTool } from './createZeroToOneTool';
 export type { ToolDeps } from './tools';
 export { AgentVariantsError, ERROR_CODES, type ErrorCode } from './errors';
 export { VARIANT_COUNT_MIN, VARIANT_COUNT_MAX } from './contracts';

package/dist/mcp/agent-variants/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/agent-variants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,GACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,0BAA0B,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EACV,KAAK,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,8BAA8B,EAC9B,+BAA+B,EAC/B,WAAW,EACX,wBAAwB,EACxB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,4BAA4B,EAC5B,KAAK,EACL,MAAM,EACN,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,QAAQ,EACR,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/agent-variants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,GACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,0BAA0B,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EACV,KAAK,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,8BAA8B,EAC9B,+BAA+B,EAC/B,WAAW,EACX,wBAAwB,EACxB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,4BAA4B,EAC5B,KAAK,EACL,MAAM,EACN,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,QAAQ,EACR,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/mcp/agent-variants/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VARIANT_COUNT_MAX = exports.VARIANT_COUNT_MIN = exports.ERROR_CODES = exports.AgentVariantsError = exports.registerCreateZeroToOneTool = exports.slugifyPrompt = exports.registerAgentVariantsTools = exports.AgentVariantsOrchestrator = exports.PendingChangesAdapter = exports.SessionStore = void 0;
+exports.VARIANT_COUNT_MAX = exports.VARIANT_COUNT_MIN = exports.ERROR_CODES = exports.AgentVariantsError = exports.slugifyPrompt = exports.registerAgentVariantsTools = exports.AgentVariantsOrchestrator = exports.PendingChangesAdapter = exports.SessionStore = void 0;
 var SessionStore_1 = require("./SessionStore");
 Object.defineProperty(exports, "SessionStore", { enumerable: true, get: function () { return SessionStore_1.SessionStore; } });
 var pendingChangesAdapter_1 = require("./pendingChangesAdapter");
@@ -10,8 +10,6 @@ Object.defineProperty(exports, "AgentVariantsOrchestrator", { enumerable: true,
 var tools_1 = require("./tools");
 Object.defineProperty(exports, "registerAgentVariantsTools", { enumerable: true, get: function () { return tools_1.registerAgentVariantsTools; } });
 Object.defineProperty(exports, "slugifyPrompt", { enumerable: true, get: function () { return tools_1.slugifyPrompt; } });
-var createZeroToOneTool_1 = require("./createZeroToOneTool");
-Object.defineProperty(exports, "registerCreateZeroToOneTool", { enumerable: true, get: function () { return createZeroToOneTool_1.registerCreateZeroToOneTool; } });
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "AgentVariantsError", { enumerable: true, get: function () { return errors_1.AgentVariantsError; } });
 Object.defineProperty(exports, "ERROR_CODES", { enumerable: true, get: function () { return errors_1.ERROR_CODES; } });

package/dist/mcp/agent-variants/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/agent-variants/index.ts"],"names":[],"mappings":";;;AAAA,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAUrB,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAM9B,+DAAmE;AAA1D,iIAAA,yBAAyB,OAAA;AAMlC,iCAAoE;AAA3D,mHAAA,0BAA0B,OAAA;AAAE,sGAAA,aAAa,OAAA;AAClD,6DAAoE;AAA3D,kIAAA,2BAA2B,OAAA;AAEpC,mCAA2E;AAAlE,4GAAA,kBAAkB,OAAA;AAAE,qGAAA,WAAW,OAAA;AACxC,yCAAmE;AAA1D,8GAAA,iBAAiB,OAAA;AAAE,8GAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/agent-variants/index.ts"],"names":[],"mappings":";;;AAAA,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAUrB,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAM9B,+DAAmE;AAA1D,iIAAA,yBAAyB,OAAA;AAOlC,iCAAoE;AAA3D,mHAAA,0BAA0B,OAAA;AAAE,sGAAA,aAAa,OAAA;AAElD,mCAA2E;AAAlE,4GAAA,kBAAkB,OAAA;AAAE,qGAAA,WAAW,OAAA;AACxC,yCAAmE;AAA1D,8GAAA,iBAAiB,OAAA;AAAE,8GAAA,iBAAiB,OAAA"}

package/dist/mcp/agent-variants/pinterestSourceContext.d.ts

@@ -0,0 +1,18 @@
+import type { IntegrationsClient } from '../../services/IntegrationsClient';
+import type { SourceArtifactInput } from './contracts';
+type PinterestSourceContextInput = {
+    sourceUrls: string[];
+    integrationsClient?: Pick<IntegrationsClient, 'fetchPinterest'>;
+};
+export type PinterestSourceContextEnrichment = {
+    sourceArtifacts: SourceArtifactInput[];
+    warnings: string[];
+};
+export declare const selectPrimaryPinterestImage: (imageUrls: readonly string[]) => string | null;
+/**
+ * Enriches Pinterest source URLs through the existing proxy-backed integration
+ * client, preserving local auth/token handling outside MCP.
+ */
+export declare const enrichPinterestSourceContext: (input: PinterestSourceContextInput) => Promise<PinterestSourceContextEnrichment>;
+export {};
+//# sourceMappingURL=pinterestSourceContext.d.ts.map

package/dist/mcp/agent-variants/pinterestSourceContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinterestSourceContext.d.ts","sourceRoot":"","sources":["../../../src/mcp/agent-variants/pinterestSourceContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAGnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAqBvD,KAAK,2BAA2B,GAAG;IACjC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kBAAkB,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;CACjE,CAAC;AAQF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,eAAe,EAAE,mBAAmB,EAAE,CAAC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AA6BF,eAAO,MAAM,2BAA2B,GACtC,WAAW,SAAS,MAAM,EAAE,KAC3B,MAAM,GAAG,IAoBX,CAAC;AAqEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GACvC,OAAO,2BAA2B,KACjC,OAAO,CAAC,gCAAgC,CA2C1C,CAAC"}

package/dist/mcp/agent-variants/pinterestSourceContext.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enrichPinterestSourceContext = exports.selectPrimaryPinterestImage = void 0;
+const MAX_PINTEREST_SOURCE_URLS = 1;
+const MAX_PINTEREST_PINS = 3;
+const MAX_PINTEREST_ARTIFACT_CONTENT_LENGTH = 7_500;
+const PINTEREST_HOST_SUFFIX = 'pinterest.com';
+const NOT_CONNECTED_FALLBACK_WARNING = 'Pinterest is not connected; using the Pinterest URL without authenticated board context.';
+/**
+ * Builds the not-connected warning, embedding the proxy-provided connect URL as
+ * an actionable nudge when present so the agent can link the user to it during
+ * zero-to-one variant generation, and falling back to the generic wording
+ * otherwise.
+ */
+const buildNotConnectedWarning = (connectUrl) => connectUrl
+    ? `Pinterest is not connected. Connect Pinterest at ${connectUrl}; using the Pinterest URL without authenticated board context.`
+    : NOT_CONNECTED_FALLBACK_WARNING;
+const isPinterestUrl = (rawUrl) => {
+    try {
+        const parsed = new URL(rawUrl);
+        const hostname = parsed.hostname.replace(/^www\./, '').toLowerCase();
+        return (hostname === PINTEREST_HOST_SUFFIX ||
+            hostname.endsWith(`.${PINTEREST_HOST_SUFFIX}`));
+    }
+    catch {
+        return false;
+    }
+};
+const inferImageScore = (url) => {
+    const sizePair = url.match(/(?:^|[^\d])(\d{2,5})x(\d{2,5})(?:[^\d]|$)/);
+    if (sizePair) {
+        return Number(sizePair[1]) * Number(sizePair[2]);
+    }
+    const pinterestWidth = url.match(/\/(\d{2,5})x\//);
+    if (pinterestWidth) {
+        return Number(pinterestWidth[1]);
+    }
+    return null;
+};
+const selectPrimaryPinterestImage = (imageUrls) => {
+    const candidates = imageUrls
+        .map((url, index) => ({ url, score: inferImageScore(url), index }))
+        .filter((candidate) => candidate.url.length > 0);
+    if (candidates.length === 0) {
+        return null;
+    }
+    const scoredCandidates = candidates.filter((candidate) => candidate.score !== null);
+    if (scoredCandidates.length > 0) {
+        return scoredCandidates.reduce((largest, candidate) => candidate.score > largest.score ? candidate : largest).url;
+    }
+    return candidates[candidates.length - 1].url;
+};
+exports.selectPrimaryPinterestImage = selectPrimaryPinterestImage;
+const compactLine = (label, value) => (value ? `${label}: ${value}` : null);
+const buildPinLines = (pin, index) => {
+    const primaryImageUrl = (0, exports.selectPrimaryPinterestImage)(pin.image_urls);
+    return [
+        `Pin ${index + 1}`,
+        compactLine('id', pin.id),
+        compactLine('title', pin.title),
+        compactLine('description', pin.description),
+        compactLine('alt_text', pin.alt_text),
+        compactLine('dominant_color', pin.dominant_color),
+        compactLine('link', pin.link),
+        compactLine('primary_image_url', primaryImageUrl),
+        pin.image_urls.length > 0
+            ? `image_urls: ${pin.image_urls.join(', ')}`
+            : null,
+    ].filter((line) => Boolean(line));
+};
+const buildBoardLines = (board) => {
+    if (!board) {
+        return [];
+    }
+    return [
+        compactLine('board_title', board.name),
+        compactLine('board_description', board.description),
+        compactLine('board_privacy', board.privacy),
+    ].filter((line) => Boolean(line));
+};
+const buildPinterestArtifact = (input) => {
+    const pins = input.pins.slice(0, MAX_PINTEREST_PINS);
+    if (pins.length === 0) {
+        return null;
+    }
+    const label = input.board?.name
+        ? `Pinterest: ${input.board.name}`
+        : 'Pinterest visual reference';
+    const content = [
+        `source_url: ${input.sourceUrl}`,
+        ...buildBoardLines(input.board),
+        ...pins.flatMap((pin, index) => ['', ...buildPinLines(pin, index)]),
+    ]
+        .join('\n')
+        .trim()
+        .slice(0, MAX_PINTEREST_ARTIFACT_CONTENT_LENGTH);
+    if (!content) {
+        return null;
+    }
+    return {
+        kind: 'visualBrief',
+        label,
+        content,
+    };
+};
+/**
+ * Enriches Pinterest source URLs through the existing proxy-backed integration
+ * client, preserving local auth/token handling outside MCP.
+ */
+const enrichPinterestSourceContext = async (input) => {
+    const allPinterestUrls = input.sourceUrls.filter(isPinterestUrl);
+    const pinterestUrls = allPinterestUrls.slice(0, MAX_PINTEREST_SOURCE_URLS);
+    if (!input.integrationsClient || pinterestUrls.length === 0) {
+        return { sourceArtifacts: [], warnings: [] };
+    }
+    const sourceArtifacts = [];
+    const warnings = [];
+    const skippedPinterestUrlCount = allPinterestUrls.length - pinterestUrls.length;
+    if (skippedPinterestUrlCount > 0) {
+        warnings.push(`Only the first Pinterest source URL is enriched; ${skippedPinterestUrlCount} additional Pinterest URL(s) remain as plain source links.`);
+    }
+    for (const sourceUrl of pinterestUrls) {
+        const result = await input.integrationsClient.fetchPinterest(sourceUrl);
+        if (result.status === 'not_connected') {
+            warnings.push(buildNotConnectedWarning(result.connectUrl));
+            continue;
+        }
+        if (result.status === 'error') {
+            warnings.push(`Pinterest fetch failed; using the Pinterest URL without authenticated board context. ${result.message}`);
+            continue;
+        }
+        const artifact = buildPinterestArtifact({
+            sourceUrl,
+            board: result.type === 'board' ? result.board : undefined,
+            pins: result.pins,
+        });
+        if (artifact) {
+            sourceArtifacts.push(artifact);
+        }
+    }
+    return { sourceArtifacts, warnings };
+};
+exports.enrichPinterestSourceContext = enrichPinterestSourceContext;
+//# sourceMappingURL=pinterestSourceContext.js.map

package/dist/mcp/agent-variants/pinterestSourceContext.js.map

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

package/dist/mcp/agent-variants/runPlan.d.ts

@@ -0,0 +1,107 @@
+/**
+ * VariantRunPlan — the single, canonical resolution of "what kind of run is
+ * this" for an agent-variants session.
+ *
+ * Historically the lifecycle policy (work-item topology, how variants are
+ * provisioned, how they're committed, how they preview) was re-derived
+ * independently at every stage from `projectContext.kind`,
+ * `executionPlan.mode`, and framework detection — `SessionStore.approve`,
+ * `WorktreeOrchestrator` provisioning, the commit path, and the preview
+ * wiring each made the same `kind === 'fresh'` / `mode === 'vite_app'`
+ * decisions in their own way. That spread the same handful of facts across
+ * dozens of call sites and let them drift.
+ *
+ * This module collapses those facts into a *closed* discriminated union. There
+ * are exactly three legal run shapes:
+ *
+ *   1. existing project              — clone+diff against the user's tree
+ *   2. generated project, static     — inline HTML/CSS/JS, no runtime
+ *   3. generated project, app (vite) — scaffolded Vite app with a dev server
+ *
+ * Every other lifecycle policy (topology / provision / commit) is a pure
+ * function of which of those three a session is — see `runPlanPolicy`. Callers
+ * resolve the plan once (at `approve` time, the first point where every input
+ * is known) and read policy off it, rather than re-deriving from raw context.
+ *
+ * Preview is deliberately *not* a fixed field of the plan. For generated
+ * projects it's determined (static → static_artifact, app → dev_server), but
+ * for existing projects it's only known at success time — a `framework:'static'`
+ * existing project previews as a materialized static artifact, anything else
+ * proxies a dev server. That one genuinely-late decision is exposed via
+ * `existingPreviewKind` rather than baked into the plan at resolve time.
+ */
+import type { ProjectContext } from './contracts';
+/**
+ * The closed set of legal run shapes. Modelled as a discriminated union so the
+ * compiler rejects impossible combinations (e.g. an existing project with a
+ * `runtime`, or a generated project with no runtime) at construction time —
+ * there is no way to hand-assemble an illegal plan.
+ */
+export type VariantRunPlan = {
+    source: 'existing';
+} | {
+    source: 'generated';
+    runtime: 'static';
+} | {
+    source: 'generated';
+    runtime: 'app';
+};
+/** How the work items for a run are shaped at approve time. */
+export type RunTopology = 
+/** One `code_gen` item per variant, edited inside a git worktree. Used by
+ *  existing projects and (with a `scaffold_base` dependency) generated apps. */
+'code_gen'
+/** One `static_preview` item per variant — inline HTML is the deliverable,
+ *  no worktree, no scaffold. Generated-static only. */
+ | 'static_preview';
+/** How each variant's working copy is provisioned. */
+export type RunProvision = 
+/** A git worktree cloned from the user's repo (existing projects). */
+'git_worktree'
+/** A scaffolded template worktree under `.rivet-variants` (generated apps). */
+ | 'template_worktree'
+/** Nothing — the deliverable is inline HTML (generated-static). */
+ | 'none';
+/** How the picked variant is landed when the user commits. */
+export type RunCommit = 
+/** Apply the captured diff to the user's working tree (existing projects). */
+'apply_diff'
+/** Write the static site (HTML + assets) to the destination
+ *  (generated-static). */
+ | 'write_static_site'
+/** Materialize / rename the whole scaffolded app to the destination
+ *  (generated apps). */
+ | 'materialize_project';
+/** Preview surface for a generated variant. Existing projects defer this to
+ *  success time — see {@link existingPreviewKind}. */
+export type RunPreview = 'static_artifact' | 'dev_server';
+export interface RunPlanPolicy {
+    topology: RunTopology;
+    provision: RunProvision;
+    commit: RunCommit;
+    /** True when the run needs a `scaffold_base` work item gating its
+     *  `code_gen` items (generated Vite apps). */
+    needsScaffoldBase: boolean;
+    /** Fixed preview surface when the source determines it; `undefined` for
+     *  existing projects, where it's resolved at success time. */
+    preview?: RunPreview;
+}
+/**
+ * Resolve the run plan from a project context. This is the single decision
+ * point: `source` comes from `projectContext.kind`; for generated projects the
+ * `runtime` comes from the agent's reported `executionPlan.mode`, defaulting to
+ * `static` for source-less zero-to-one runs (which never report a plan).
+ */
+export declare function resolveRunPlan(projectContext: ProjectContext): VariantRunPlan;
+/** Derive the lifecycle policy for a resolved plan. Total over the closed set. */
+export declare function runPlanPolicy(plan: VariantRunPlan): RunPlanPolicy;
+/** Convenience: resolve and derive policy in one step. */
+export declare function resolveRunPlanPolicy(projectContext: ProjectContext): RunPlanPolicy;
+/**
+ * Preview surface for an existing-project variant, resolved at success time
+ * from whether the variant materialized static files (framework `static`, no
+ * dev command) or runs a dev server. Generated projects don't use this — their
+ * preview is fixed by {@link runPlanPolicy}.
+ */
+export declare function existingPreviewKind(hasStaticFiles: boolean): RunPreview;
+//# sourceMappingURL=runPlan.d.ts.map

package/dist/mcp/agent-variants/runPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runPlan.d.ts","sourceRoot":"","sources":["../../../src/mcp/agent-variants/runPlan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,GAC1C;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC;AAE5C,+DAA+D;AAC/D,MAAM,MAAM,WAAW;AACrB;gFACgF;AAC9E,UAAU;AACZ;uDACuD;GACrD,gBAAgB,CAAC;AAErB,sDAAsD;AACtD,MAAM,MAAM,YAAY;AACtB,sEAAsE;AACpE,cAAc;AAChB,+EAA+E;GAC7E,mBAAmB;AACrB,mEAAmE;GACjE,MAAM,CAAC;AAEX,8DAA8D;AAC9D,MAAM,MAAM,SAAS;AACnB,8EAA8E;AAC5E,YAAY;AACd;0BAC0B;GACxB,mBAAmB;AACrB;wBACwB;GACtB,qBAAqB,CAAC;AAE1B;sDACsD;AACtD,MAAM,MAAM,UAAU,GAAG,iBAAiB,GAAG,YAAY,CAAC;AAE1D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,YAAY,CAAC;IACxB,MAAM,EAAE,SAAS,CAAC;IAClB;kDAC8C;IAC9C,iBAAiB,EAAE,OAAO,CAAC;IAC3B;kEAC8D;IAC9D,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,cAAc,EAAE,cAAc,GAAG,cAAc,CAU7E;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,aAAa,CA2BjE;AAED,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,cAAc,GAC7B,aAAa,CAEf;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,OAAO,GAAG,UAAU,CAEvE"}

package/dist/mcp/agent-variants/runPlan.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * VariantRunPlan — the single, canonical resolution of "what kind of run is
+ * this" for an agent-variants session.
+ *
+ * Historically the lifecycle policy (work-item topology, how variants are
+ * provisioned, how they're committed, how they preview) was re-derived
+ * independently at every stage from `projectContext.kind`,
+ * `executionPlan.mode`, and framework detection — `SessionStore.approve`,
+ * `WorktreeOrchestrator` provisioning, the commit path, and the preview
+ * wiring each made the same `kind === 'fresh'` / `mode === 'vite_app'`
+ * decisions in their own way. That spread the same handful of facts across
+ * dozens of call sites and let them drift.
+ *
+ * This module collapses those facts into a *closed* discriminated union. There
+ * are exactly three legal run shapes:
+ *
+ *   1. existing project              — clone+diff against the user's tree
+ *   2. generated project, static     — inline HTML/CSS/JS, no runtime
+ *   3. generated project, app (vite) — scaffolded Vite app with a dev server
+ *
+ * Every other lifecycle policy (topology / provision / commit) is a pure
+ * function of which of those three a session is — see `runPlanPolicy`. Callers
+ * resolve the plan once (at `approve` time, the first point where every input
+ * is known) and read policy off it, rather than re-deriving from raw context.
+ *
+ * Preview is deliberately *not* a fixed field of the plan. For generated
+ * projects it's determined (static → static_artifact, app → dev_server), but
+ * for existing projects it's only known at success time — a `framework:'static'`
+ * existing project previews as a materialized static artifact, anything else
+ * proxies a dev server. That one genuinely-late decision is exposed via
+ * `existingPreviewKind` rather than baked into the plan at resolve time.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRunPlan = resolveRunPlan;
+exports.runPlanPolicy = runPlanPolicy;
+exports.resolveRunPlanPolicy = resolveRunPlanPolicy;
+exports.existingPreviewKind = existingPreviewKind;
+/**
+ * Resolve the run plan from a project context. This is the single decision
+ * point: `source` comes from `projectContext.kind`; for generated projects the
+ * `runtime` comes from the agent's reported `executionPlan.mode`, defaulting to
+ * `static` for source-less zero-to-one runs (which never report a plan).
+ */
+function resolveRunPlan(projectContext) {
+    if (projectContext.kind === 'existing') {
+        return { source: 'existing' };
+    }
+    // Generated (fresh) project. `executionPlan` is present only for
+    // source-grounded runs (reported via `report_source_plan`); source-less
+    // zero-to-one runs default to a static preview.
+    const runtime = projectContext.executionPlan?.mode === 'vite_app' ? 'app' : 'static';
+    return { source: 'generated', runtime };
+}
+/** Derive the lifecycle policy for a resolved plan. Total over the closed set. */
+function runPlanPolicy(plan) {
+    if (plan.source === 'existing') {
+        return {
+            topology: 'code_gen',
+            provision: 'git_worktree',
+            commit: 'apply_diff',
+            needsScaffoldBase: false,
+            // preview deferred to success time (static vs dev_server by framework).
+        };
+    }
+    if (plan.runtime === 'static') {
+        return {
+            topology: 'static_preview',
+            provision: 'none',
+            commit: 'write_static_site',
+            needsScaffoldBase: false,
+            preview: 'static_artifact',
+        };
+    }
+    // generated app (vite)
+    return {
+        topology: 'code_gen',
+        provision: 'template_worktree',
+        commit: 'materialize_project',
+        needsScaffoldBase: true,
+        preview: 'dev_server',
+    };
+}
+/** Convenience: resolve and derive policy in one step. */
+function resolveRunPlanPolicy(projectContext) {
+    return runPlanPolicy(resolveRunPlan(projectContext));
+}
+/**
+ * Preview surface for an existing-project variant, resolved at success time
+ * from whether the variant materialized static files (framework `static`, no
+ * dev command) or runs a dev server. Generated projects don't use this — their
+ * preview is fixed by {@link runPlanPolicy}.
+ */
+function existingPreviewKind(hasStaticFiles) {
+    return hasStaticFiles ? 'static_artifact' : 'dev_server';
+}
+//# sourceMappingURL=runPlan.js.map

package/dist/mcp/agent-variants/runPlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runPlan.js","sourceRoot":"","sources":["../../../src/mcp/agent-variants/runPlan.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;AAkEH,wCAUC;AAGD,sCA2BC;AAGD,oDAIC;AAQD,kDAEC;AA/DD;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,cAA8B;IAC3D,IAAI,cAAc,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACvC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAChC,CAAC;IACD,iEAAiE;IACjE,wEAAwE;IACxE,gDAAgD;IAChD,MAAM,OAAO,GACX,cAAc,CAAC,aAAa,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;IACvE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC;AAED,kFAAkF;AAClF,SAAgB,aAAa,CAAC,IAAoB;IAChD,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO;YACL,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,cAAc;YACzB,MAAM,EAAE,YAAY;YACpB,iBAAiB,EAAE,KAAK;YACxB,wEAAwE;SACzE,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO;YACL,QAAQ,EAAE,gBAAgB;YAC1B,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,mBAAmB;YAC3B,iBAAiB,EAAE,KAAK;YACxB,OAAO,EAAE,iBAAiB;SAC3B,CAAC;IACJ,CAAC;IACD,uBAAuB;IACvB,OAAO;QACL,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,mBAAmB;QAC9B,MAAM,EAAE,qBAAqB;QAC7B,iBAAiB,EAAE,IAAI;QACvB,OAAO,EAAE,YAAY;KACtB,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,SAAgB,oBAAoB,CAClC,cAA8B;IAE9B,OAAO,aAAa,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,cAAuB;IACzD,OAAO,cAAc,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,YAAY,CAAC;AAC3D,CAAC"}

package/dist/mcp/agent-variants/tools.d.ts

@@ -1,9 +1,10 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { type VariantQaResult, type VisualEditorAttachment } from './contracts';
 import { VariantHistoryService } from '../../services/VariantHistoryService';
-import { slugifyPrompt } from './createZeroToOneTool';
+import { slugifyPrompt } from './generatedDestination';
 export { slugifyPrompt };
 import type { AgentVariantsOrchestrator } from './WorktreeOrchestrator';
+import type { IntegrationsClient } from '../../services/IntegrationsClient';
 /**
  * Coerce `output` to a structured value when an agent (incorrectly) sends a
  * stringified JSON. The MCP schema accepts `z.unknown()` so the call doesn't
@@ -18,7 +19,7 @@ export interface ToolDeps {
     /**
      * Zero-to-one only: ensure the Rivet visual editor is up on the future
      * destination path so the iframe is ready when variants render. Wired
-     * from server.ts; same hook used by create_zero_to_one_project. When
+     * from server.ts. When
      * absent (e.g. unit tests), start_variants(mode='zero_to_one') skips
      * the auto-open and the caller can open the editor themselves.
      */
@@ -40,11 +41,55 @@ export interface ToolDeps {
      *  `start_variants(mode='zero_to_one')` so new projects default to the
      *  workspace the user is already working in. Wired from server.ts. */
     getProjectPath?: () => string | null;
-    telemetry?: unknown;
+    telemetry?: VariantsToolTelemetry;
     /** Read-only access to the on-disk variant history under
      *  `<projectPath>/.rivet/variants/`. Defaults to a fresh
      *  `VariantHistoryService` since the service is stateless. */
     variantHistory?: VariantHistoryService;
+    /** Test seam — defaults to os.homedir. Used to authorize asset-source
+     *  roots for source-grounded zero-to-one sessions. */
+    homedir?: () => string;
+    /** Optional authenticated integration client for source-context enrichment. */
+    integrationsClient?: Pick<IntegrationsClient, 'fetchPinterest'>;
+}
+/**
+ * Telemetry surface used by the variants tools. All methods optional so unit
+ * tests can omit them; the real telemetry service structurally satisfies this.
+ */
+export interface VariantsToolTelemetry {
+    track(event: string, properties: Record<string, unknown>): void;
+    trackAgentVariantsSourceContextQuality?: (data: {
+        sessionId: string;
+        sourceUrlCount: number;
+        artifactCount: number;
+        hasScreenshotReferences: boolean;
+        preserveBrand: boolean;
+    }) => void;
+    /**
+     * Outcome metadata only — counts of links, successes, low-signal pages,
+     * fetch failures, blocked targets, the merge strategy, and cache outcome
+     * counts. Full URLs, fetched HTML, file paths, and extracted text MUST NOT
+     * be forwarded.
+     */
+    trackAgentVariantsInspirationExtraction?: (data: {
+        sessionId: string;
+        inspirationLinkCount: number;
+        referenceLinkCount: number;
+        successfulExtractions: number;
+        lowSignalCount: number;
+        fetchFailureCount: number;
+        blockedTargetCount: number;
+        mergeStrategy: 'merge' | 'separate' | 'none';
+        cacheHitCount: number;
+        cacheMissCount: number;
+        cacheStaleCount: number;
+        cacheVersionMismatchCount: number;
+        cacheLowConfidenceCount: number;
+        cacheRegenerationCount: number;
+        cacheForcedRefresh: boolean;
+        cacheReuseAgeBucket?: 'lt_1h' | '1h_24h' | '1d_7d' | '7d_30d' | 'gt_30d';
+        cacheReuseConfidenceBucket?: 'low' | 'medium' | 'high';
+    }) => void;
 }
 export declare function registerAgentVariantsTools(mcp: McpServer, deps: ToolDeps): void;
 /**

package/dist/mcp/agent-variants/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/mcp/agent-variants/tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EA0CL,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EAEtB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,CAAC;AAGzB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAGxE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,OAAO,KAAG,OAOtD,CAAC;AAyBF,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,yBAAyB,CAAC;IACxC,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE;QAC/B;kDAC0C;QAC1C,WAAW,EAAE,MAAM,CAAC;QACpB;;8DAEsD;QACtD,aAAa,EAAE,MAAM,CAAC;QACtB;+DACuD;QACvD,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC;KAC9B,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACtC,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB;;0EAEsE;IACtE,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;kEAE8D;IAC9D,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC;AA0BD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,QAAQ,GACb,IAAI,CAsjBN;AA+GD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,eAAe,CAAA;CAAE,CAAC,EACvD,YAAY,EAAE,MAAM,GACnB,MAAM,CAwBR"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/mcp/agent-variants/tools.ts"],"names":[],"mappings":"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"}