rivet-design 0.12.3 → 0.13.0

package/dist/services/createAgentVariantsOrchestrator.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createAgentVariantsOrchestrator = exports.withVariantsSessionReplayLinking = void 0;
 const index_core_1 = require("../index-core");
-const agent_variants_1 = require("../mcp/agent-variants");
+const agent_variants_1 = require("../agent-variants");
 const devServerCommand_1 = require("../utils/devServerCommand");
 const ProjectDetectionService_1 = require("./ProjectDetectionService");
 const WorktreeManager_1 = require("./WorktreeManager");
@@ -63,7 +63,7 @@ const withVariantsSessionReplayLinking = (telemetry, bridge) => {
 };
 exports.withVariantsSessionReplayLinking = withVariantsSessionReplayLinking;
 /**
- * Creates the shared variants orchestration stack for embedded and MCP-driven agent sessions.
+ * Creates the shared variants orchestration stack for embedded and CLI-driven agent sessions.
  */
 const createAgentVariantsOrchestrator = (options) => {
     const cwd = options.cwd ?? (() => process.cwd());
@@ -74,7 +74,6 @@ const createAgentVariantsOrchestrator = (options) => {
     return new agent_variants_1.AgentVariantsOrchestrator({
         store: new agent_variants_1.SessionStore(),
         worktreeManager: options.worktreeManager ?? new WorktreeManager_1.WorktreeManager(getProjectPath),
-        pendingChangesAdapter: new agent_variants_1.PendingChangesAdapter(options.bridge),
         telemetry,
         resolveProjectEnvironment: options.resolveProjectEnvironment ??
             (async (sessionId) => {

package/dist/services/createAgentVariantsOrchestrator.js.map

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

package/dist/services/projectMetadataMigrations.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Schema migrations for the project metadata database
+ * (`<project>/.rivet/rivet.db`). `PRAGMA user_version` records how many have
+ * been applied; each database upgrades by running the entries above its
+ * version, one transaction per migration.
+ *
+ * ## Adding a migration
+ *
+ * 1. APPEND one entry to {@link PROJECT_METADATA_MIGRATIONS}. Never edit,
+ *    remove, or reorder an existing entry — shipped migrations have already
+ *    run on user databases, and the test suite freezes their checksums.
+ * 2. Write schema shape only (CREATE/ALTER/DROP/INDEX). Do NOT write data
+ *    backfills: after any upgrade the store marks the variant index stale,
+ *    so every row is re-projected from its manifest on the next read. A new
+ *    column derived from manifests populates itself.
+ * 3. Keep additions rebuildable from `.rivet/` files or Git refs. The
+ *    database is a projection — never the only copy of anything, and never
+ *    a home for artifact bodies (source trees, HTML, screenshots) or tokens.
+ * 4. Run `npx jest --config src/jest.config.ts --testPathPatterns
+ *    projectMetadataMigrations` and append the new checksum the failing
+ *    freeze test prints. The suite auto-verifies the rest: fresh install and
+ *    stepwise upgrades from every prior version produce identical schemas,
+ *    and failed migrations roll back cleanly.
+ * 5. Downgrades need no handling: an older Rivet refuses a newer database
+ *    ({@link UnsupportedSchemaVersionError}) and serves reads from the
+ *    filesystem instead.
+ */
+export interface ProjectMetadataMigration {
+    /** One line saying what the migration adds — for readers, not the runtime. */
+    description: string;
+    sql: string;
+}
+export declare const PROJECT_METADATA_MIGRATIONS: readonly ProjectMetadataMigration[];
+/** The schema version a fully migrated database reports. */
+export declare const PROJECT_METADATA_SCHEMA_VERSION: number;
+/** The database was written by a Rivet build with a newer schema. It must be
+ *  left untouched for that build — callers fall back to the filesystem. */
+export declare class UnsupportedSchemaVersionError extends Error {
+    constructor(version: number, supportedVersion: number);
+}
+/**
+ * Bring `db` from its recorded `user_version` up to `toVersion` (default:
+ * the full list), one transaction per migration so a failure rolls back to
+ * the last good version. Throws {@link UnsupportedSchemaVersionError} when
+ * the database is already past the list — it belongs to a newer build.
+ *
+ * `migrations` is injectable so tests can exercise upgrade paths with
+ * synthetic lists; production callers use the default.
+ *
+ * @effect Executes migration DDL and advances `PRAGMA user_version`.
+ */
+export declare const applyProjectMetadataMigrations: (db: import("node:sqlite").DatabaseSync, args?: {
+    migrations?: readonly ProjectMetadataMigration[];
+    toVersion?: number;
+}) => {
+    fromVersion: number;
+    toVersion: number;
+};
+//# sourceMappingURL=projectMetadataMigrations.d.ts.map

package/dist/services/projectMetadataMigrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectMetadataMigrations.d.ts","sourceRoot":"","sources":["../../src/services/projectMetadataMigrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,MAAM,WAAW,wBAAwB;IACvC,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,2BAA2B,EAAE,SAAS,wBAAwB,EAkCxE,CAAC;AAEJ,4DAA4D;AAC5D,eAAO,MAAM,+BAA+B,QACR,CAAC;AAErC;2EAC2E;AAC3E,qBAAa,6BAA8B,SAAQ,KAAK;gBAC1C,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM;CAMtD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,8BAA8B,GACzC,IAAI,OAAO,aAAa,EAAE,YAAY,EACtC,OAAM;IACJ,UAAU,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,KACL;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAsB1C,CAAC"}

package/dist/services/projectMetadataMigrations.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * Schema migrations for the project metadata database
+ * (`<project>/.rivet/rivet.db`). `PRAGMA user_version` records how many have
+ * been applied; each database upgrades by running the entries above its
+ * version, one transaction per migration.
+ *
+ * ## Adding a migration
+ *
+ * 1. APPEND one entry to {@link PROJECT_METADATA_MIGRATIONS}. Never edit,
+ *    remove, or reorder an existing entry — shipped migrations have already
+ *    run on user databases, and the test suite freezes their checksums.
+ * 2. Write schema shape only (CREATE/ALTER/DROP/INDEX). Do NOT write data
+ *    backfills: after any upgrade the store marks the variant index stale,
+ *    so every row is re-projected from its manifest on the next read. A new
+ *    column derived from manifests populates itself.
+ * 3. Keep additions rebuildable from `.rivet/` files or Git refs. The
+ *    database is a projection — never the only copy of anything, and never
+ *    a home for artifact bodies (source trees, HTML, screenshots) or tokens.
+ * 4. Run `npx jest --config src/jest.config.ts --testPathPatterns
+ *    projectMetadataMigrations` and append the new checksum the failing
+ *    freeze test prints. The suite auto-verifies the rest: fresh install and
+ *    stepwise upgrades from every prior version produce identical schemas,
+ *    and failed migrations roll back cleanly.
+ * 5. Downgrades need no handling: an older Rivet refuses a newer database
+ *    ({@link UnsupportedSchemaVersionError}) and serves reads from the
+ *    filesystem instead.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyProjectMetadataMigrations = exports.UnsupportedSchemaVersionError = exports.PROJECT_METADATA_SCHEMA_VERSION = exports.PROJECT_METADATA_MIGRATIONS = void 0;
+exports.PROJECT_METADATA_MIGRATIONS = [
+    {
+        description: 'variant history projection: metadata_state + variants + list indexes',
+        sql: `
+  CREATE TABLE metadata_state (
+    key TEXT PRIMARY KEY,
+    value TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+
+  CREATE TABLE variants (
+    session_id TEXT NOT NULL,
+    variant_id TEXT NOT NULL,
+    label TEXT NOT NULL,
+    brief TEXT NOT NULL,
+    session_prompt TEXT NOT NULL,
+    run_label TEXT,
+    status TEXT NOT NULL,
+    created_at TEXT NOT NULL,
+    status_changed_at TEXT NOT NULL,
+    has_tree INTEGER NOT NULL,
+    serve_kind TEXT,
+    has_static_preview INTEGER NOT NULL,
+    manifest_mtime_ms INTEGER NOT NULL,
+    manifest_json TEXT NOT NULL,
+    PRIMARY KEY (session_id, variant_id)
+  );
+
+  CREATE INDEX variants_created_at_idx ON variants(created_at DESC);
+  CREATE INDEX variants_status_idx ON variants(status);
+  `,
+    },
+];
+/** The schema version a fully migrated database reports. */
+exports.PROJECT_METADATA_SCHEMA_VERSION = exports.PROJECT_METADATA_MIGRATIONS.length;
+/** The database was written by a Rivet build with a newer schema. It must be
+ *  left untouched for that build — callers fall back to the filesystem. */
+class UnsupportedSchemaVersionError extends Error {
+    constructor(version, supportedVersion) {
+        super(`ProjectMetadataStore: database uses schema version ${version}, newer than this build supports (${supportedVersion}) — leaving it untouched`);
+        this.name = 'UnsupportedSchemaVersionError';
+    }
+}
+exports.UnsupportedSchemaVersionError = UnsupportedSchemaVersionError;
+/**
+ * Bring `db` from its recorded `user_version` up to `toVersion` (default:
+ * the full list), one transaction per migration so a failure rolls back to
+ * the last good version. Throws {@link UnsupportedSchemaVersionError} when
+ * the database is already past the list — it belongs to a newer build.
+ *
+ * `migrations` is injectable so tests can exercise upgrade paths with
+ * synthetic lists; production callers use the default.
+ *
+ * @effect Executes migration DDL and advances `PRAGMA user_version`.
+ */
+const applyProjectMetadataMigrations = (db, args = {}) => {
+    const migrations = args.migrations ?? exports.PROJECT_METADATA_MIGRATIONS;
+    const target = args.toVersion ?? migrations.length;
+    const versionRow = db.prepare('PRAGMA user_version').get();
+    const fromVersion = versionRow.user_version;
+    if (fromVersion > migrations.length) {
+        throw new UnsupportedSchemaVersionError(fromVersion, migrations.length);
+    }
+    for (let applied = fromVersion; applied < target; applied++) {
+        db.exec('BEGIN IMMEDIATE');
+        try {
+            db.exec(migrations[applied].sql);
+            db.exec(`PRAGMA user_version = ${applied + 1}`);
+            db.exec('COMMIT');
+        }
+        catch (err) {
+            db.exec('ROLLBACK');
+            throw err;
+        }
+    }
+    return { fromVersion, toVersion: Math.max(fromVersion, target) };
+};
+exports.applyProjectMetadataMigrations = applyProjectMetadataMigrations;
+//# sourceMappingURL=projectMetadataMigrations.js.map

package/dist/services/projectMetadataMigrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectMetadataMigrations.js","sourceRoot":"","sources":["../../src/services/projectMetadataMigrations.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;AAQU,QAAA,2BAA2B,GACtC;IACE;QACE,WAAW,EACT,sEAAsE;QACxE,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BR;KACE;CACF,CAAC;AAEJ,4DAA4D;AAC/C,QAAA,+BAA+B,GAC1C,mCAA2B,CAAC,MAAM,CAAC;AAErC;2EAC2E;AAC3E,MAAa,6BAA8B,SAAQ,KAAK;IACtD,YAAY,OAAe,EAAE,gBAAwB;QACnD,KAAK,CACH,sDAAsD,OAAO,qCAAqC,gBAAgB,0BAA0B,CAC7I,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAPD,sEAOC;AAED;;;;;;;;;;GAUG;AACI,MAAM,8BAA8B,GAAG,CAC5C,EAAsC,EACtC,OAGI,EAAE,EACsC,EAAE;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,mCAA2B,CAAC;IAClE,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,IAAI,UAAU,CAAC,MAAM,CAAC;IACnD,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,GAAG,EAEvD,CAAC;IACF,MAAM,WAAW,GAAG,UAAU,CAAC,YAAY,CAAC;IAC5C,IAAI,WAAW,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,IAAI,6BAA6B,CAAC,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC1E,CAAC;IACD,KAAK,IAAI,OAAO,GAAG,WAAW,EAAE,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;QAC5D,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC3B,IAAI,CAAC;YACH,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC;YACjC,EAAE,CAAC,IAAI,CAAC,yBAAyB,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC;YAChD,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACpB,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC;AACnE,CAAC,CAAC;AA5BW,QAAA,8BAA8B,kCA4BzC"}

package/dist/types/change-request-types.d.ts

@@ -5,6 +5,13 @@
  */
 export interface ChangeRequest {
     changes: ChangeItem[];
+    /**
+     * Who initiated this batch: `human` for handoff-less invocations (editor
+     * clicks, terminal commands), otherwise the caller agent kind and model.
+     * Carries no chat session id — that stays out of persisted queue state,
+     * logs, and telemetry. Absent on older payloads ⇒ treated as `human`.
+     */
+    initiator?: WorkItemInitiator;
     /**
      * When set, this batch targets a specific agent-variants variant rather than
      * the base project — every change item in the batch belongs to that variant.
@@ -52,6 +59,19 @@ export interface TelemetryContext {
     browserSessionId?: string;
     browserDistinctId?: string;
 }
+/** Caller agent kinds accepted by the CLI handoff allowlist. */
+export type CallerAgentKind = 'claude' | 'codex' | 'cursor' | 'unknown';
+/**
+ * Attribution stamped onto queued work items so status surfaces can answer
+ * "who asked for this". Deliberately excludes the caller's chat session id.
+ */
+export type WorkItemInitiator = {
+    kind: 'human';
+} | {
+    kind: 'agent';
+    agent: CallerAgentKind;
+    model?: string;
+};
 /** Identifies the agent-variants variant a change batch applies to. */
 export interface ChangeRequestTarget {
     kind: 'variant';
@@ -68,6 +88,7 @@ export interface StaticPreviewChangeTarget {
     /** workItemId of the static_preview variant within that session. */
     variantId: string;
 }
+export type VariantRequestMode = 'existing' | 'zero_to_one';
 export type ChangeItem = StyleChangeItem | TextChangeItem | CommentChangeItem | ChatChangeItem | VariantChangeItem;
 /** A CSS property change with an exact before/after diff */
 export interface StyleChangeItem {
@@ -123,6 +144,7 @@ export interface CommentChangeItem {
      */
     variantRequest?: {
         count: number;
+        mode?: VariantRequestMode;
     };
 }
 /**

package/dist/types/change-request-types.d.ts.map

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

package/dist/utils/logger.d.ts

@@ -2,7 +2,8 @@ export declare const registerErrorCapture: (fn: (message: string, args: unknown[
 export declare const setLogLevel: (level: string) => void;
 /**
  * Redirect all log output to stderr.
- * Required for MCP mode where stdout is reserved for the MCP protocol stream.
+ * Required for CLI control-plane commands where stdout is reserved for the
+ * JSON envelope.
  */
 export declare const redirectLogsToStderr: () => void;
 export declare const createLogger: (serviceName?: string) => {

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,oBAAoB,GAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,SAG5E,CAAC;AAGF,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,SAKxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,YAShC,CAAC;AAqCF,eAAO,MAAM,YAAY,GAAI,cAAc,MAAM;qBAI5B,MAAM,WAAW,OAAO,EAAE;qBAE1B,MAAM,WAAW,OAAO,EAAE;oBAE3B,MAAM,WAAW,OAAO,EAAE;oBAE1B,MAAM,WAAW,OAAO,EAAE;qBAEzB,MAAM,WAAW,OAAO,EAAE;yBAWtB,MAAM,WAAW,MAAM,WAAW,OAAO,EAAE;kBAIlD,MAAM,OAAO,MAAM,WAAW,MAAM,WAAW,OAAO,EAAE;CAGzE,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,oBAAoB,GAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,SAG5E,CAAC;AAGF,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,SAKxC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,YAShC,CAAC;AA+BF,eAAO,MAAM,YAAY,GAAI,cAAc,MAAM;qBAI5B,MAAM,WAAW,OAAO,EAAE;qBAE1B,MAAM,WAAW,OAAO,EAAE;oBAE3B,MAAM,WAAW,OAAO,EAAE;oBAE1B,MAAM,WAAW,OAAO,EAAE;qBAEzB,MAAM,WAAW,OAAO,EAAE;yBAWtB,MAAM,WAAW,MAAM,WAAW,OAAO,EAAE;kBAIlD,MAAM,OAAO,MAAM,WAAW,MAAM,WAAW,OAAO,EAAE;CAGzE,CAAC"}

package/dist/utils/logger.js

@@ -24,7 +24,8 @@ const setLogLevel = (level) => {
 exports.setLogLevel = setLogLevel;
 /**
  * Redirect all log output to stderr.
- * Required for MCP mode where stdout is reserved for the MCP protocol stream.
+ * Required for CLI control-plane commands where stdout is reserved for the
+ * JSON envelope.
  */
 const redirectLogsToStderr = () => {
     loglevel_1.default.methodFactory = (_methodName, _logLevel, _loggerName) => {
@@ -38,13 +39,8 @@ const redirectLogsToStderr = () => {
 exports.redirectLogsToStderr = redirectLogsToStderr;
 // Configure loglevel
 loglevel_1.default.setLevel(loglevel_1.default.levels[LOG_LEVEL] || loglevel_1.default.levels.INFO);
-// In MCP mode, redirect all logs to stderr immediately to avoid corrupting stdout.
-// This must run before any loggers are created at import time.
-if (process.argv.includes('mcp')) {
-    (0, exports.redirectLogsToStderr)();
-}
 // Add emojis and better formatting for development
-if (process.env.NODE_ENV !== 'production' && !process.argv.includes('mcp')) {
+if (process.env.NODE_ENV !== 'production') {
     const originalFactory = loglevel_1.default.methodFactory;
     loglevel_1.default.methodFactory = (methodName, logLevel, loggerName) => {
         const rawMethod = originalFactory(methodName, logLevel, loggerName);

package/dist/utils/logger.js.map

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

package/dist/utils/loopback.d.ts

@@ -0,0 +1,3 @@
+/** True when a socket remote address is a loopback (localhost) client. */
+export declare const isLoopbackAddress: (remoteAddress: string | undefined) => boolean;
+//# sourceMappingURL=loopback.d.ts.map

package/dist/utils/loopback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopback.d.ts","sourceRoot":"","sources":["../../src/utils/loopback.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,GAC5B,eAAe,MAAM,GAAG,SAAS,KAChC,OAOF,CAAC"}

package/dist/utils/loopback.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLoopbackAddress = void 0;
+/** True when a socket remote address is a loopback (localhost) client. */
+const isLoopbackAddress = (remoteAddress) => {
+    if (!remoteAddress)
+        return false;
+    return (remoteAddress === '127.0.0.1' ||
+        remoteAddress === '::1' ||
+        remoteAddress.startsWith('::ffff:127.'));
+};
+exports.isLoopbackAddress = isLoopbackAddress;
+//# sourceMappingURL=loopback.js.map

package/dist/utils/loopback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopback.js","sourceRoot":"","sources":["../../src/utils/loopback.ts"],"names":[],"mappings":";;;AAAA,0EAA0E;AACnE,MAAM,iBAAiB,GAAG,CAC/B,aAAiC,EACxB,EAAE;IACX,IAAI,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,CACL,aAAa,KAAK,WAAW;QAC7B,aAAa,KAAK,KAAK;QACvB,aAAa,CAAC,UAAU,CAAC,aAAa,CAAC,CACxC,CAAC;AACJ,CAAC,CAAC;AATW,QAAA,iBAAiB,qBAS5B"}

package/dist/utils/pid.d.ts

@@ -0,0 +1,3 @@
+/** True when the pid is still alive on this machine. */
+export declare const isPidAlive: (pid: number) => boolean;
+//# sourceMappingURL=pid.d.ts.map

package/dist/utils/pid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pid.d.ts","sourceRoot":"","sources":["../../src/utils/pid.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,OAOxC,CAAC"}

package/dist/utils/pid.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPidAlive = void 0;
+/** True when the pid is still alive on this machine. */
+const isPidAlive = (pid) => {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === 'EPERM';
+    }
+};
+exports.isPidAlive = isPidAlive;
+//# sourceMappingURL=pid.js.map

package/dist/utils/pid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pid.js","sourceRoot":"","sources":["../../src/utils/pid.ts"],"names":[],"mappings":";;;AAAA,wDAAwD;AACjD,MAAM,UAAU,GAAG,CAAC,GAAW,EAAW,EAAE;IACjD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAQ,KAA+B,CAAC,IAAI,KAAK,OAAO,CAAC;IAC3D,CAAC;AACH,CAAC,CAAC;AAPW,QAAA,UAAU,cAOrB"}

package/dist/utils/queueAccess.d.ts

@@ -1,4 +1,11 @@
 export declare const QUEUE_ACCESS_TOKEN_HEADER = "x-rivet-queue-token";
+/**
+ * Carries the caller's live AI-chat session id on enqueue requests for
+ * same-vendor session continuation. Sent as a header (never in the body) so
+ * it stays out of persisted queue snapshots; the server holds it in memory
+ * only and never logs it or sends it to telemetry.
+ */
+export declare const CALLER_SESSION_HEADER = "x-rivet-caller-session";
 type QueueAccessAuthorization = {
     queueAccessToken?: string | null;
     getHeader: (name: string) => string | string[] | undefined;

package/dist/utils/queueAccess.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queueAccess.d.ts","sourceRoot":"","sources":["../../src/utils/queueAccess.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,wBAAwB,CAAC;AAE/D,KAAK,wBAAwB,GAAG;IAC9B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CAC5D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,kCAGrC,wBAAwB,KAAG,OAK7B,CAAC"}
+{"version":3,"file":"queueAccess.d.ts","sourceRoot":"","sources":["../../src/utils/queueAccess.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,wBAAwB,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAE9D,KAAK,wBAAwB,GAAG;IAC9B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CAC5D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,kCAGrC,wBAAwB,KAAG,OAK7B,CAAC"}

package/dist/utils/queueAccess.js

@@ -1,7 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isQueueAccessAuthorized = exports.QUEUE_ACCESS_TOKEN_HEADER = void 0;
+exports.isQueueAccessAuthorized = exports.CALLER_SESSION_HEADER = exports.QUEUE_ACCESS_TOKEN_HEADER = void 0;
 exports.QUEUE_ACCESS_TOKEN_HEADER = 'x-rivet-queue-token';
+/**
+ * Carries the caller's live AI-chat session id on enqueue requests for
+ * same-vendor session continuation. Sent as a header (never in the body) so
+ * it stays out of persisted queue snapshots; the server holds it in memory
+ * only and never logs it or sends it to telemetry.
+ */
+exports.CALLER_SESSION_HEADER = 'x-rivet-caller-session';
 /**
  * Checks whether a browser request is allowed to enqueue or control embedded agent work.
  */

package/dist/utils/queueAccess.js.map

@@ -1 +1 @@
-{"version":3,"file":"queueAccess.js","sourceRoot":"","sources":["../../src/utils/queueAccess.ts"],"names":[],"mappings":";;;AAAa,QAAA,yBAAyB,GAAG,qBAAqB,CAAC;AAO/D;;GAEG;AACI,MAAM,uBAAuB,GAAG,CAAC,EACtC,gBAAgB,EAChB,SAAS,GACgB,EAAW,EAAE;IACtC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,SAAS,CAAC,iCAAyB,CAAC,KAAK,gBAAgB,CAAC;AACnE,CAAC,CAAC;AARW,QAAA,uBAAuB,2BAQlC"}
+{"version":3,"file":"queueAccess.js","sourceRoot":"","sources":["../../src/utils/queueAccess.ts"],"names":[],"mappings":";;;AAAa,QAAA,yBAAyB,GAAG,qBAAqB,CAAC;AAE/D;;;;;GAKG;AACU,QAAA,qBAAqB,GAAG,wBAAwB,CAAC;AAO9D;;GAEG;AACI,MAAM,uBAAuB,GAAG,CAAC,EACtC,gBAAgB,EAChB,SAAS,GACgB,EAAW,EAAE;IACtC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,SAAS,CAAC,iCAAyB,CAAC,KAAK,gBAAgB,CAAC;AACnE,CAAC,CAAC;AARW,QAAA,uBAAuB,2BAQlC"}

package/dist/utils/shouldRecordHostedDemoSessionAction.d.ts

@@ -1,8 +1,8 @@
 import type { Request } from 'express';
 /**
  * Returns true when the request should advance hosted demo session idle tracking.
- * Counts only mutating work: POST/PUT/PATCH to `/code/*`, `/search-components`, or `/design/*`.
- * Read-only traffic (config, health, tokens, etc.) does not extend the idle window.
+ * The viewer surface has no editor-originated mutating work routed through the
+ * hosted session proxy, so API traffic does not extend the idle window.
  */
-export declare const shouldRecordHostedDemoSessionAction: (req: Request) => boolean;
+export declare const shouldRecordHostedDemoSessionAction: (_req: Request) => boolean;
 //# sourceMappingURL=shouldRecordHostedDemoSessionAction.d.ts.map

package/dist/utils/shouldRecordHostedDemoSessionAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shouldRecordHostedDemoSessionAction.d.ts","sourceRoot":"","sources":["../../src/utils/shouldRecordHostedDemoSessionAction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIvC;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,GAAI,KAAK,OAAO,KAAG,OAelE,CAAC"}
+{"version":3,"file":"shouldRecordHostedDemoSessionAction.d.ts","sourceRoot":"","sources":["../../src/utils/shouldRecordHostedDemoSessionAction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,GAAI,MAAM,OAAO,KAAG,OAC7D,CAAC"}

package/dist/utils/shouldRecordHostedDemoSessionAction.js

@@ -1,27 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.shouldRecordHostedDemoSessionAction = void 0;
-const ACTION_METHODS = new Set(['POST', 'PUT', 'PATCH']);
 /**
  * Returns true when the request should advance hosted demo session idle tracking.
- * Counts only mutating work: POST/PUT/PATCH to `/code/*`, `/search-components`, or `/design/*`.
- * Read-only traffic (config, health, tokens, etc.) does not extend the idle window.
+ * The viewer surface has no editor-originated mutating work routed through the
+ * hosted session proxy, so API traffic does not extend the idle window.
  */
-const shouldRecordHostedDemoSessionAction = (req) => {
-    if (!ACTION_METHODS.has(req.method.toUpperCase())) {
-        return false;
-    }
-    const requestPath = req.path;
-    if (requestPath.startsWith('/code/')) {
-        return true;
-    }
-    if (requestPath === '/search-components') {
-        return true;
-    }
-    if (requestPath.startsWith('/design/')) {
-        return true;
-    }
-    return false;
-};
+const shouldRecordHostedDemoSessionAction = (_req) => false;
 exports.shouldRecordHostedDemoSessionAction = shouldRecordHostedDemoSessionAction;
 //# sourceMappingURL=shouldRecordHostedDemoSessionAction.js.map

package/dist/utils/shouldRecordHostedDemoSessionAction.js.map

@@ -1 +1 @@
-{"version":3,"file":"shouldRecordHostedDemoSessionAction.js","sourceRoot":"","sources":["../../src/utils/shouldRecordHostedDemoSessionAction.ts"],"names":[],"mappings":";;;AAEA,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;AAEzD;;;;GAIG;AACI,MAAM,mCAAmC,GAAG,CAAC,GAAY,EAAW,EAAE;IAC3E,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC;IAC7B,IAAI,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,WAAW,KAAK,oBAAoB,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAfW,QAAA,mCAAmC,uCAe9C"}
+{"version":3,"file":"shouldRecordHostedDemoSessionAction.js","sourceRoot":"","sources":["../../src/utils/shouldRecordHostedDemoSessionAction.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACI,MAAM,mCAAmC,GAAG,CAAC,IAAa,EAAW,EAAE,CAC5E,KAAK,CAAC;AADK,QAAA,mCAAmC,uCACxC"}

package/dist/utils/skillWriter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skillWriter.d.ts","sourceRoot":"","sources":["../../src/utils/skillWriter.ts"],"names":[],"mappings":"AA2BA,KAAK,gBAAgB,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9E;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAqCzD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAyBrE"}
+{"version":3,"file":"skillWriter.d.ts","sourceRoot":"","sources":["../../src/utils/skillWriter.ts"],"names":[],"mappings":"AAuBA,KAAK,gBAAgB,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9E;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAyCzD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAyBrE"}

package/dist/utils/skillWriter.js

@@ -12,9 +12,6 @@ const logger_1 = require("./logger");
 const claude_skill_1 = require("./skills/claude-skill");
 const cursor_rules_1 = require("./skills/cursor-rules");
 const log = (0, logger_1.createLogger)('SkillWriter');
-const SKILLS_BASE = path_1.default.join(os_1.default.homedir(), '.claude', 'skills');
-const SKILL_DIR = path_1.default.join(SKILLS_BASE, claude_skill_1.CLAUDE_SKILL_DIR);
-const SKILL_PATH = path_1.default.join(SKILL_DIR, claude_skill_1.CLAUDE_SKILL_FILENAME);
 function getInstalledVersion(content, pattern) {
     const match = content.match(pattern);
     return match ? parseInt(match[1], 10) : 0;
@@ -26,24 +23,28 @@ function getInstalledVersion(content, pattern) {
  */
 function writeSkillFileIfNeeded() {
     try {
+        // Paths resolve at call time so fixture homes (tests) take effect.
         const skillsBase = path_1.default.join(os_1.default.homedir(), '.claude', 'skills');
+        const skillDir = path_1.default.join(skillsBase, claude_skill_1.CLAUDE_SKILL_DIR);
+        const skillPath = path_1.default.join(skillDir, claude_skill_1.CLAUDE_SKILL_FILENAME);
         if (!fs_1.default.existsSync(skillsBase)) {
             fs_1.default.mkdirSync(skillsBase, { recursive: true });
         }
-        // If the old flat file exists at SKILL_DIR, remove it — we need a directory there now
-        if (fs_1.default.existsSync(SKILL_DIR) && fs_1.default.statSync(SKILL_DIR).isFile()) {
-            fs_1.default.unlinkSync(SKILL_DIR);
+        // If the old flat file exists at the skill dir path, remove it — we need
+        // a directory there now.
+        if (fs_1.default.existsSync(skillDir) && fs_1.default.statSync(skillDir).isFile()) {
+            fs_1.default.unlinkSync(skillDir);
         }
-        if (!fs_1.default.existsSync(SKILL_DIR)) {
-            fs_1.default.mkdirSync(SKILL_DIR, { recursive: true });
+        if (!fs_1.default.existsSync(skillDir)) {
+            fs_1.default.mkdirSync(skillDir, { recursive: true });
         }
-        if (fs_1.default.existsSync(SKILL_PATH)) {
-            const existing = fs_1.default.readFileSync(SKILL_PATH, 'utf8');
+        if (fs_1.default.existsSync(skillPath)) {
+            const existing = fs_1.default.readFileSync(skillPath, 'utf8');
             const installed = getInstalledVersion(existing, /rivet-skill-version:\s*(\d+)/);
             if (installed >= claude_skill_1.CLAUDE_SKILL_VERSION)
                 return { success: true };
         }
-        fs_1.default.writeFileSync(SKILL_PATH, claude_skill_1.CLAUDE_SKILL_CONTENT, 'utf8');
+        fs_1.default.writeFileSync(skillPath, claude_skill_1.CLAUDE_SKILL_CONTENT, 'utf8');
         log.info('Wrote Rivet Claude skill file');
         return { success: true };
     }

package/dist/utils/skillWriter.js.map

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

package/dist/utils/skills/claude-skill.d.ts

@@ -1,5 +1,10 @@
-export declare const CLAUDE_SKILL_VERSION = 36;
+/**
+ * Claude Code skill: CLI-first guidance written to
+ * `~/.claude/skills/rivet/SKILL.md` by `rivet install claude`. The version
+ * marker gates rewrites so user edits are only replaced by newer guidance.
+ */
+export declare const CLAUDE_SKILL_VERSION = 45;
 export declare const CLAUDE_SKILL_DIR = "rivet";
 export declare const CLAUDE_SKILL_FILENAME = "SKILL.md";
-export declare const CLAUDE_SKILL_CONTENT: string;
+export declare const CLAUDE_SKILL_CONTENT = "---\nname: rivet\ndescription: Rivet \u2014 explore multiple design directions for your web app (\"/rivet\", \"use rivet\", \"explore with rivet\", \"create variants of X\", \"show me options for X\", \"open rivet\", \"open the visual editor\"). Drive it with `rivet` CLI commands.\n---\n\n[//]: # (rivet-skill-version: 45)\n[//]: # (rivet-cli-guidance-version: 12)\n# Rivet\n\nRivet helps you **explore multiple design directions** for a web app. You drive it by running `rivet` CLI commands. Every command prints exactly one JSON envelope on stdout (`{ schemaVersion, ok, command, data | error }`), routes progress to stderr, and never prompts for input.\n\n**Exit codes:** 0 ok \u00B7 1 operation failed (see `error.code`) \u00B7 2 usage error \u00B7 3 auth required \u00B7 4 no server for the project \u00B7 5 `rivet wait` timeout (work still pending or running \u2014 not a failure; the envelope's `state` says which).\n\n**Identify yourself (handoff).** Add these flags to every invocation so Rivet can attribute work: `--caller-agent claude|codex|cursor`, `--caller-model <your model>`, and `--caller-session <your chat session id>` when you have one. Human-direct invocations omit handoff flags. Never wrap or chain `rivet` with other commands (`&&`, pipes) \u2014 plain invocations are what the host allowlist covers.\n\n**Project path.** Prefer explicit `--project <absolute path>` on every command so follow-up chats attach to the same workspace. For an existing app, pass its repo/app root. For a fresh app, create or use an empty directory first, then open Rivet there and start variants with `--fresh`.\n\n**Browser behavior.** For interactive user workflows, run `rivet open` without `--no-browser` so the Rivet UI opens in the browser. Use `--no-browser` only for headless/background automation, CI/e2e checks, or when the user explicitly asks not to open a browser; in those cases, report the returned `editorUrl`.\n\n**MCP tools (opt-in).** If this host has Rivet MCP tools registered (`rivet_status`, `rivet_variants`, `rivet_design_context` \u2014 the user opted in via `rivet install --mcp`), prefer them over shelling out for status, variants, and design-context work: they drive the same control plane and return the same JSON envelopes, without per-call process cost. Lifecycle and auth stay CLI-only on purpose \u2014 `rivet open`, `rivet stop`, `rivet wait`, and `rivet login` have no MCP tools. There is no blocking/watch tool either: start work with `rivet_variants`; if the result contains `nextAction.action=\"complete_host_variant_work\"`, execute it yourself with parallel subagents when available.\n\n## Commands\n\n- `rivet open [--project <path>] [--agent claude|codex|cursor] [--rivet-port N] [--user-port N] [--framework nextjs|vite|cra|remix|svelte|static] [--entry <path>] [--no-browser] [--no-git]` \u2014 start or attach the project's editor server (idempotent; returns `editorUrl`). It detects the app, attaches to an already-running dev server, or starts one from the app's standard `dev`/`start`/`serve` script when possible. Omit `--no-browser` for interactive work so the UI opens for the user.\n- `rivet variants start --project <path> --instruction <text> [--count N] [--element <selector>] [--fresh] [--target <sessionId>:<variantId>]` \u2014 explore design directions. Use `--fresh` for prompt-only 0-to-1 generation in a blank/new workspace; use `--target` to Vary an existing direction. Returns a `workId` immediately, plus `nextAction` when the host agent should implement the variants.\n- `rivet variants complete <workId> --project <path> [--session <sessionId>] [--status succeeded|failed|cancelled] [--output <json>] [--error <message>]` \u2014 report one host-agent work item complete after you edit its worktree.\n- `rivet wait <workId> --project <path> [--timeout <seconds>]` \u2014 bounded block until a work id settles (exit 5 on timeout; re-issue or check status).\n- `rivet status --project <path> [--watch]` \u2014 session, resolved runner, active run, and the variants snapshot. `--watch` streams NDJSON.\n- `rivet variants status --project <path>` / `rivet variants list --project <path> [--history]` \u2014 inspect live or past directions.\n- `rivet variants commit <variantId> --project <path> [--session <id>]` \u2014 send the chosen direction to the project.\n- `rivet variants cancel <sessionId> --project <path>` \u2014 cancel a running variants session.\n- `rivet evidence capture --url <url>` \u2014 rendered design evidence (root variables, element styles, fonts) for a reference URL.\n- `rivet reference fetch <url>` \u2014 Pinterest / Are.na reference data via the user's connected account.\n- `rivet auth status` \u2014 signed-in state. If `authenticated: false`, tell the user to run `rivet login` themselves \u2014 never run login for them.\n- `rivet stop [--project <path>]` \u2014 stop the CLI-owned server.\n\n## Typical flows\n\nExisting app:\n1. `rivet open --project <path> --caller-agent cursor --caller-model <model> --caller-session <id>` \u2192 note `editorUrl`, `sessionId`, and `resolvedRunner`.\n2. `rivet variants start --project <path> --instruction \"try three hero layouts\" --count 3 --caller-agent cursor --caller-model <model> --caller-session <id>` \u2192 note `workId`.\n3. If the start response has `nextAction.action=\"complete_host_variant_work\"`, execute it immediately. Otherwise poll `rivet status --project <path>` until that `nextAction` appears. The work items are independent: when your host supports subagents or parallel tasks, spawn one worker per item, each editing only its own `worktreePath` according to `briefLabel`, `briefBody`, target, and project context. Follow the item's `outputSchema`.\n4. As each worker finishes, run `rivet variants complete <workId> --project <path> --session <sessionId> --output '{\"worktreePath\":\"<worktreePath>\",\"changedFiles\":[\"relative/path\"]}'`. If a worker cannot complete it, use `--status failed --error <message>`.\n5. Show the user the `editorUrl` to compare directions; `rivet variants commit <variantId> --project <path>` when they pick one.\n\nFresh 0-to-1: create or use an empty directory, run `rivet open --project <path> ...`, then `rivet variants start --project <path> --fresh --instruction \"build a SaaS landing page\" --count 3 ...`.\n\nVary an existing direction: after status/list gives you `sessionId` and `variantId`, run `rivet variants start --project <path> --target <sessionId>:<variantId> --instruction \"make this calmer\" --count 2 ...`.\n\nRivet owns orchestration; the host agent owns implementation. Do not wait for Rivet to spawn a separate agent. When `rivet variants start`, `rivet status`, `rivet_variants`, or `rivet_status` returns `nextAction.action=\"complete_host_variant_work\"`, complete those work items from the current host session. Prefer parallelism: use one subagent or parallel task per work item when the host supports it, because each item has an isolated worktree. Report each item with `rivet variants complete` or `rivet_variants` action `complete`.\n\n**Never cancel to unblock.** If `variants start` is rejected with `start_in_flight`, a start is still provisioning (status reports `variants.starting: true` \u2014 can take minutes); poll status and retry once it clears. If rejected with `active_session`, the user has live work: report the conflict and let them decide, or refine the active session with `--target`. Cancelling a session destroys the user's in-progress exploration \u2014 only do it when the user explicitly asks.\n";
 //# sourceMappingURL=claude-skill.d.ts.map

package/dist/utils/skills/claude-skill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-skill.d.ts","sourceRoot":"","sources":["../../../src/utils/skills/claude-skill.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAGvC,eAAO,MAAM,gBAAgB,UAAU,CAAC;AACxC,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAuBhD,eAAO,MAAM,oBAAoB,QAqEhC,CAAC"}
+{"version":3,"file":"claude-skill.d.ts","sourceRoot":"","sources":["../../../src/utils/skills/claude-skill.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AAEH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAGvC,eAAO,MAAM,gBAAgB,UAAU,CAAC;AACxC,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAEhD,eAAO,MAAM,oBAAoB,q4OAUhC,CAAC"}