rivet-design 0.23.1 → 0.25.0

package/dist/agent-variants/contracts.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ERROR_CODES = exports.getVariantInput = exports.captureDesignEvidenceInput = exports.listPastVariantsInput = exports.variantHistoryStatusSchema = exports.startVariantsBriefContent = exports.cancelVariantsInput = exports.reportWorkItemInput = exports.reportVariantCompleteStatus = exports.continueVariantsInput = exports.continueVariantsAction = exports.commitVariantInput = exports.reportVariantBriefsInput = exports.proposeVariantsInput = exports.runLabelSchema = exports.DEFAULT_VARIANT_COUNT = exports.VARIANT_COUNT_MAX = exports.VARIANT_COUNT_MIN = exports.variantWorkItemContextSchema = exports.briefSchema = exports.targetSchema = exports.VARIANT_ARTIFACT_KINDS = exports.isWorkerFidelity = exports.VARIANT_EXECUTION_MODES = exports.projectContextInputSchema = exports.projectContextSchema = exports.projectContextFresh = exports.projectContextExisting = exports.variantContextBundleSchema = exports.executionCapabilityPlanSchema = exports.assetPlanEntrySchema = exports.executionConfidenceSchema = exports.executionModeSchema = exports.variantContextBindingSchema = exports.rivetMetadataSchema = exports.rivetContextActionSchema = exports.rivetContextActionKindSchema = exports.storedUserContextSourceRecordSchema = exports.stagedContextAssetSchema = exports.contextAssetInputSchema = exports.rawUserContextSourceSchema = exports.rawUserContextInputSchema = exports.sourceRoleSchema = exports.designContextEntrySchema = exports.CONTEXT_ASSET_MAX_ITEMS = exports.WORK_ITEM_STATUSES = exports.WORK_ITEM_KINDS = exports.TERMINAL_STAGES = exports.STAGES = void 0;
+exports.ERROR_CODES = exports.getVariantInput = exports.captureDesignEvidenceInput = exports.listPastVariantsInput = exports.variantHistoryStatusSchema = exports.startVariantsBriefContent = exports.cancelVariantsInput = exports.reportWorkItemInput = exports.reportVariantCompleteStatus = exports.continueVariantsInput = exports.continueVariantsAction = exports.commitVariantInput = exports.reportVariantBriefsInput = exports.proposeVariantsInput = exports.runLabelSchema = exports.DEFAULT_VARIANT_COUNT = exports.VARIANT_COUNT_MAX = exports.VARIANT_COUNT_MIN = exports.variantWorkItemContextSchema = exports.briefSchema = exports.targetSchema = exports.isWorkerFidelity = exports.VARIANT_EXECUTION_MODES = exports.projectContextInputSchema = exports.projectContextSchema = exports.projectContextFresh = exports.projectContextExisting = exports.variantContextBundleSchema = exports.executionCapabilityPlanSchema = exports.assetPlanEntrySchema = exports.executionConfidenceSchema = exports.executionModeSchema = exports.variantContextBindingSchema = exports.rivetMetadataSchema = exports.rivetContextActionSchema = exports.rivetContextActionKindSchema = exports.storedUserContextSourceRecordSchema = exports.stagedContextAssetSchema = exports.contextAssetInputSchema = exports.rawUserContextSourceSchema = exports.rawUserContextInputSchema = exports.sourceRoleSchema = exports.designContextEntrySchema = exports.CONTEXT_ASSET_MAX_ITEMS = exports.WORK_ITEM_STATUSES = exports.WORK_ITEM_KINDS = exports.TERMINAL_STAGES = exports.STAGES = void 0;
 const variant_reference_1 = require("../types/variant-reference");
 const v3_1 = require("zod/v3");
 const errors_1 = require("./errors");
@@ -355,12 +355,6 @@ exports.projectContextInputSchema = v3_1.z.discriminatedUnion('kind', [
 exports.VARIANT_EXECUTION_MODES = ['create', 'vary', 'refine'];
 const isWorkerFidelity = (value) => value === 'low' || value === 'medium' || value === 'high';
 exports.isWorkerFidelity = isWorkerFidelity;
-exports.VARIANT_ARTIFACT_KINDS = [
-    'design_context',
-    'source_context',
-    'qa_report',
-    'asset',
-];
 exports.targetSchema = v3_1.z.object({
     type: v3_1.z.enum(['element', 'file', 'route']),
     ref: v3_1.z.string().min(1),

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

@@ -0,0 +1,9 @@
+import type { ActiveProjectContext, ActiveVariantSnapshot, DesignContextEntry, ProjectContext } from './contracts';
+import type { VariantDesignSource } from '../services/VariantHistoryService';
+export declare const enrichDesignSource: (design: ActiveVariantSnapshot["design"]) => ActiveVariantSnapshot["design"];
+export declare const toActiveProjectContext: (projectContext: ProjectContext) => ActiveProjectContext;
+export declare const resolveDesignArtifact: (entry: DesignContextEntry | undefined) => {
+    markdown: string;
+    source: VariantDesignSource;
+} | null;
+//# sourceMappingURL=designContext.d.ts.map

package/dist/agent-variants/designContext.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveDesignArtifact = exports.toActiveProjectContext = exports.enrichDesignSource = void 0;
+const designCatalog_1 = require("../services/templates/designCatalog");
+const enrichDesignSource = (design) => {
+    if (!design || design.kind !== 'slug')
+        return design;
+    return {
+        ...design,
+        displayName: (0, designCatalog_1.getDesignSystemBySlug)(design.slug)?.name ?? design.slug,
+    };
+};
+exports.enrichDesignSource = enrichDesignSource;
+const toActiveProjectContext = (projectContext) => {
+    const sourceCount = projectContext.variantContext?.userContext.filter((source) => source.transport !== 'prompt').length ?? 0;
+    const hasSourceContextSummary = Boolean(sourceCount > 0 ||
+        (projectContext.variantContext?.rivetMetadata.length ?? 0) > 0);
+    const activeSourceContext = hasSourceContextSummary
+        ? {
+            sourceCount,
+            isSourceGrounded: Boolean(sourceCount > 0 ||
+                projectContext.designContext?.length ||
+                projectContext.variantContext?.rivetMetadata.length),
+        }
+        : undefined;
+    if (projectContext.kind === 'existing') {
+        return {
+            kind: 'existing',
+            designContext: projectContext.designContext?.map((entry) => entry.kind === 'slug'
+                ? { kind: 'slug', slug: entry.slug }
+                : { kind: 'markdown', label: entry.label }),
+            ...(activeSourceContext ? { sourceContext: activeSourceContext } : {}),
+        };
+    }
+    return {
+        kind: 'fresh',
+        workspacePath: projectContext.workspacePath,
+        workspaceRoot: projectContext.workspaceRoot,
+        framework: projectContext.framework,
+        designContext: projectContext.designContext?.map((entry) => entry.kind === 'slug'
+            ? { kind: 'slug', slug: entry.slug }
+            : { kind: 'markdown', label: entry.label }),
+        ...(activeSourceContext ? { sourceContext: activeSourceContext } : {}),
+        ...(projectContext.executionPlan
+            ? {
+                executionPlan: {
+                    mode: projectContext.executionPlan.mode,
+                    confidence: projectContext.executionPlan.confidence,
+                    reason: projectContext.executionPlan.reason,
+                    assetCount: projectContext.executionPlan.assetPlan?.length ?? 0,
+                    runtimeRequirementCount: projectContext.executionPlan.runtimeRequirements?.length ?? 0,
+                },
+            }
+            : {}),
+    };
+};
+exports.toActiveProjectContext = toActiveProjectContext;
+const resolveDesignArtifact = (entry) => {
+    if (!entry)
+        return null;
+    if (entry.kind === 'markdown') {
+        return {
+            markdown: entry.content,
+            source: { kind: 'markdown', label: entry.label },
+        };
+    }
+    const markdown = (0, designCatalog_1.loadDesignSystemMarkdown)(entry.slug);
+    if (!markdown)
+        return null;
+    const catalogEntry = (0, designCatalog_1.getDesignSystemBySlug)(entry.slug);
+    return {
+        markdown,
+        source: {
+            kind: 'slug',
+            slug: entry.slug,
+            label: catalogEntry?.name ?? entry.slug,
+        },
+    };
+};
+exports.resolveDesignArtifact = resolveDesignArtifact;
+//# sourceMappingURL=designContext.js.map

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

@@ -1,4 +1,5 @@
 import type { GuidanceDocument } from '../types/guidance';
+import type { WorkerSelection } from '../types/change-request-types';
 import type { SessionStore } from './SessionStore';
 import type { StartVariantsBriefContent, StaticPreviewTargetElement, VariantWorkItemContext } from './contracts';
 import type { VariantsTelemetry } from './variantsTelemetry';
@@ -17,6 +18,7 @@ export type StaticPreviewRefinementRequest = {
         briefs?: StartVariantsBriefContent[];
         runLabel?: string;
         fidelity?: import('./contracts').WorkerFidelity;
+        workerSelection?: WorkerSelection;
         element?: StaticPreviewTargetElement;
         relevantFiles?: string[];
         requestId?: string;

package/dist/agent-variants/staticPreviewRefinements.js

@@ -39,6 +39,7 @@ const createStaticPreviewRefinements = ({ request: args, store, telemetry, getSt
                     relevantFiles: target.relevantFiles,
                     requestId: target.requestId,
                     ...(target.fidelity ? { fidelity: target.fidelity } : {}),
+                    workerSelection: target.workerSelection,
                 });
                 createdWorkItemIds.push(refineItem.id);
                 acceptedWorkItemIds.push(refineItem.id);
@@ -57,6 +58,7 @@ const createStaticPreviewRefinements = ({ request: args, store, telemetry, getSt
                         instruction: target.instruction,
                         guidance: target.guidance ?? [],
                         fidelity: target.fidelity,
+                        workerSelection: target.workerSelection,
                     });
                     if (folded && pending && previousInput) {
                         coalesced.push({ item: pending, input: previousInput });
@@ -100,6 +102,7 @@ const createStaticPreviewRefinements = ({ request: args, store, telemetry, getSt
                 ...(target.briefs ? { briefs: target.briefs } : {}),
                 ...(target.runLabel ? { runLabel: target.runLabel } : {}),
                 ...(target.fidelity ? { fidelity: target.fidelity } : {}),
+                workerSelection: target.workerSelection,
                 currentHtml,
                 targetElement: target.element,
                 relevantFiles: target.relevantFiles,

package/dist/agent-variants/variant-start-types.d.ts

@@ -0,0 +1,38 @@
+import type { GuidanceDocument } from '../types/guidance';
+import type { WorkerSelection } from '../types/change-request-types';
+import type { ProjectContext, StartVariantsBriefContent, Target, WorkerFidelity } from './contracts';
+import type { RequestWorkResult } from './SessionStore';
+export interface VariantStartRequest {
+    previewRoutes?: string[];
+    beforeDispatch?: (workItemIds: string[]) => Promise<void> | void;
+    guidance?: GuidanceDocument[];
+    assertContext?: () => void;
+    prompt: string;
+    count?: number;
+    target?: Target;
+    projectContext?: ProjectContext;
+    sessionId?: string;
+    runLabel?: string;
+    leaseOwner?: string;
+    briefs?: StartVariantsBriefContent[];
+    requestId?: string;
+    allowAccumulate?: boolean;
+    sourceVariantId?: string;
+    relevantFiles?: string[];
+    fidelity?: WorkerFidelity;
+    workerSelection?: WorkerSelection;
+}
+export interface VariantStartResult {
+    sessionId: string;
+    variants: Array<{
+        variantId: string;
+        briefId: string;
+        label: string;
+        status: 'pending';
+    }>;
+    scaffoldBaseWorkItemId: string | null;
+    leaseId?: string;
+    leaseTtlMs?: number;
+    leasedWorkItems?: RequestWorkResult['leasedWorkItems'];
+}
+//# sourceMappingURL=variant-start-types.d.ts.map

package/dist/agent-variants/variant-start-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=variant-start-types.js.map

package/dist/agent-variants/videoKeyframes.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.extractVideoKeyframes = void 0;
 const child_process_1 = require("child_process");
+const subprocessEnvironment_1 = require("../utils/subprocessEnvironment");
 const fs = __importStar(require("fs"));
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
@@ -57,7 +58,7 @@ const extractVideoKeyframes = async (videoPath, options) => {
             '-of',
             'default=noprint_wrappers=1:nokey=1',
             videoPath,
-        ], { timeout: FFMPEG_TIMEOUT_MS });
+        ], { timeout: FFMPEG_TIMEOUT_MS, env: (0, subprocessEnvironment_1.subprocessEnvironment)('verifier') });
         duration = Number.parseFloat(probe.stdout.trim());
         if (!Number.isFinite(duration) || duration <= 0) {
             return { ok: false, reason: `ffprobe reported no duration for ${videoPath}` };
@@ -84,7 +85,7 @@ const extractVideoKeyframes = async (videoPath, options) => {
                 '3',
                 '-y',
                 framePath,
-            ], { timeout: FFMPEG_TIMEOUT_MS });
+            ], { timeout: FFMPEG_TIMEOUT_MS, env: (0, subprocessEnvironment_1.subprocessEnvironment)('verifier') });
             framePaths[index] = framePath;
         }));
     }

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

@@ -1,4 +1,5 @@
 import type { HostVariantImplementationWorkItemSnapshot } from './contracts';
+export declare const workItemBriefingsDirectory: () => string;
 export declare const workItemBriefingPath: (sessionId: string, workId: string) => string;
 type WorkItemCompleteCommandContext = {
     projectPath?: string;

package/dist/agent-variants/workItemBriefing.js

@@ -33,13 +33,16 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.renderWorkItemBriefing = exports.workItemWorkerPrompt = exports.workItemCompleteCommand = exports.workItemBriefingPath = void 0;
+exports.renderWorkItemBriefing = exports.workItemWorkerPrompt = exports.workItemCompleteCommand = exports.workItemBriefingPath = exports.workItemBriefingsDirectory = void 0;
+const telemetryPolicy_1 = require("../config/telemetryPolicy");
 const guidancePrompt_1 = require("./guidancePrompt");
 const workerDefaults_1 = require("../hosts/workerDefaults");
 const pluginContext_1 = require("../hosts/pluginContext");
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
-const workItemBriefingPath = (sessionId, workId) => path.join(os.tmpdir(), 'rivet-work-briefings', sessionId, `${workId}.md`);
+const workItemBriefingsDirectory = () => path.join(os.tmpdir(), 'rivet-work-briefings');
+exports.workItemBriefingsDirectory = workItemBriefingsDirectory;
+const workItemBriefingPath = (sessionId, workId) => path.join((0, exports.workItemBriefingsDirectory)(), sessionId, `${workId}.md`);
 exports.workItemBriefingPath = workItemBriefingPath;
 const commandArgument = (value) => /^[A-Za-z0-9_./:-]+$/.test(value)
     ? value
@@ -59,6 +62,7 @@ const workItemCompleteCommand = (workId, context) => {
             ? `--session ${commandArgument(context.sessionId)}`
             : null,
         '--status succeeded',
+        (0, telemetryPolicy_1.getTelemetryMode)() === 'off' ? '--no-telemetry' : null,
     ]
         .filter((part) => part !== null)
         .join(' ');
@@ -144,7 +148,10 @@ const renderWorkItemBriefing = (item, options) => {
     }
     lines.push('', `## Boundaries`, `Edit only ${item.workspace.rootPath}${item.workspace.kind === 'git_worktree'
         ? ` (app at ${item.workspace.projectPath})`
-        : ''}. Do not touch other variants' workspaces. Do not run git commit or push.`);
+        : ''}. Do not touch other variants' workspaces. Do not run git commit or push.`, `Use the invoking host's current permissions and approval flow. If access is denied or approval is unavailable, report failure with the blocked operation. Do not bypass restrictions, switch providers, or ask the Rivet server to perform denied work.`);
+    if (item.workerSelection) {
+        lines.push('', '## Worker selection', `Requested provider: ${item.workerSelection.provider ?? 'initiating host'}. Requested model: ${item.workerSelection.model ?? 'inherit current model'}.`, 'Honor this selection through the native host. If it cannot select the requested model or provider, report failure before authoring.');
+    }
     if (item.mode === 'create' && item.workspace.kind === 'git_worktree') {
         lines.push('', `## Project check`, `Run the project's existing targeted build or typecheck once if one is`, `available. Fix failures caused by your changes. Do not install new`, `dependencies or start a browser solely for verification.`);
     }
@@ -173,9 +180,16 @@ const renderWorkItemBriefing = (item, options) => {
         lines.push(`Rivet checks that the worker produced an artifact — do NOT spend time`, `on screenshots, broader verification, or repeated re-reads, and do`, `not run any completion command. When your edits are in place, simply`, `stop.`, '');
         return lines.join('\n');
     }
-    lines.push('', `## Completion — your FINAL step, the moment the workspace is done`, `Rivet checks that the worker produced an artifact — do NOT spend time on`, `screenshots, broader verification, or repeated re-reads. When your edits`, `are in place, run exactly:`, '', '```', (0, exports.workItemCompleteCommand)(item.workId, options?.completionCommand), '```', '', `(Hosts with Rivet MCP tools may instead call the rivet_variants tool with ` +
-        `action "complete" and workId "${item.workId}".) Do not send file contents ` +
-        `through the completion; Rivet reads the workspace itself. Then stop.`, '');
+    lines.push('', `## Completion — your FINAL step, the moment the workspace is done`, `Rivet checks that the worker produced an artifact — do NOT spend time on`, `screenshots, broader verification, or repeated re-reads. When your edits`, `are in place, run exactly:`, '', '```', (0, exports.workItemCompleteCommand)(item.workId, options?.completionCommand), '```', '', '');
+    const completionContext = options?.completionCommand;
+    if (completionContext?.projectPath && completionContext.sessionId)
+        lines.push('Hosts with Rivet MCP tools may instead call rivet_complete_variant_work with exactly:', JSON.stringify({
+            project: completionContext.projectPath,
+            sessionId: completionContext.sessionId,
+            workId: item.workId,
+            status: 'succeeded',
+        }), '');
+    lines.push('Do not send file contents through completion; Rivet reads the workspace itself. Then stop.', '');
     return lines.join('\n');
 };
 exports.renderWorkItemBriefing = renderWorkItemBriefing;