rivet-design 0.12.3 → 0.13.0

package/dist/cli/handoffStore.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readSessionHandoff = exports.writeSessionHandoff = exports.sessionHandoffPath = exports.SESSION_HANDOFF_VERSION = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Durable, owner-only record of the handoff that started a session — the
+ * on-disk counterpart of the in-memory session attribution. Written under
+ * `<projectPath>/.rivet/cli/handoff.json` with `0600` permissions (the same
+ * discipline as the daemon token) because it can carry the caller's chat
+ * session id. That id never leaves this file: work items are stamped with
+ * agent kind and model only, and telemetry never receives it.
+ */
+exports.SESSION_HANDOFF_VERSION = 1;
+const OWNER_ONLY_FILE_MODE = 0o600;
+const sessionHandoffPath = (projectPath) => (0, path_1.join)(projectPath, '.rivet', 'cli', 'handoff.json');
+exports.sessionHandoffPath = sessionHandoffPath;
+/** Atomically persist the session-starting handoff, owner-only. */
+const writeSessionHandoff = (projectPath, record) => {
+    const filePath = (0, exports.sessionHandoffPath)(projectPath);
+    (0, fs_1.mkdirSync)((0, path_1.dirname)(filePath), { recursive: true });
+    const tempPath = `${filePath}.${process.pid}.tmp`;
+    const fd = (0, fs_1.openSync)(tempPath, 'w', OWNER_ONLY_FILE_MODE);
+    try {
+        (0, fs_1.writeSync)(fd, JSON.stringify({
+            version: exports.SESSION_HANDOFF_VERSION,
+            recordedAt: new Date().toISOString(),
+            ...record,
+        }));
+    }
+    finally {
+        (0, fs_1.closeSync)(fd);
+    }
+    (0, fs_1.chmodSync)(tempPath, OWNER_ONLY_FILE_MODE);
+    (0, fs_1.renameSync)(tempPath, filePath);
+};
+exports.writeSessionHandoff = writeSessionHandoff;
+/** Read the persisted session handoff, or null when missing/corrupt. */
+const readSessionHandoff = (projectPath) => {
+    try {
+        const parsed = JSON.parse((0, fs_1.readFileSync)((0, exports.sessionHandoffPath)(projectPath), 'utf8'));
+        return parsed.version === exports.SESSION_HANDOFF_VERSION ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+};
+exports.readSessionHandoff = readSessionHandoff;
+//# sourceMappingURL=handoffStore.js.map

package/dist/cli/handoffStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoffStore.js","sourceRoot":"","sources":["../../src/cli/handoffStore.ts"],"names":[],"mappings":";;;AAAA,2BAQY;AACZ,+BAAqC;AAGrC;;;;;;;GAOG;AAEU,QAAA,uBAAuB,GAAG,CAAC,CAAC;AAWzC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAE5B,MAAM,kBAAkB,GAAG,CAAC,WAAmB,EAAU,EAAE,CAChE,IAAA,WAAI,EAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;AADxC,QAAA,kBAAkB,sBACsB;AAErD,mEAAmE;AAC5D,MAAM,mBAAmB,GAAG,CACjC,WAAmB,EACnB,MAA4D,EACtD,EAAE;IACR,MAAM,QAAQ,GAAG,IAAA,0BAAkB,EAAC,WAAW,CAAC,CAAC;IACjD,IAAA,cAAS,EAAC,IAAA,cAAO,EAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;IAClD,MAAM,EAAE,GAAG,IAAA,aAAQ,EAAC,QAAQ,EAAE,GAAG,EAAE,oBAAoB,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,IAAA,cAAS,EACP,EAAE,EACF,IAAI,CAAC,SAAS,CAAC;YACb,OAAO,EAAE,+BAAuB;YAChC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,GAAG,MAAM;SACV,CAAC,CACH,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAA,cAAS,EAAC,EAAE,CAAC,CAAC;IAChB,CAAC;IACD,IAAA,cAAS,EAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IAC1C,IAAA,eAAU,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACjC,CAAC,CAAC;AAtBW,QAAA,mBAAmB,uBAsB9B;AAEF,wEAAwE;AACjE,MAAM,kBAAkB,GAAG,CAChC,WAAmB,EACU,EAAE;IAC/B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CACvB,IAAA,iBAAY,EAAC,IAAA,0BAAkB,EAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAC9B,CAAC;QAC1B,OAAO,MAAM,CAAC,OAAO,KAAK,+BAAuB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAXW,QAAA,kBAAkB,sBAW7B"}

package/dist/cli/hostWorkNextAction.d.ts

@@ -0,0 +1,45 @@
+type HostWorkItem = {
+    workId: string;
+    variantId?: string;
+    kind?: string;
+    input?: {
+        worktreePath?: string;
+        briefLabel?: string;
+        briefBody?: string;
+        instruction?: string;
+    };
+    outputSchema?: unknown;
+};
+export type StatusWithHostWork = {
+    variants?: {
+        sessionId?: string;
+        hostWork?: HostWorkItem[];
+    };
+};
+export type HostWorkNextAction = {
+    action: 'complete_host_variant_work';
+    message: string;
+    command: 'rivet variants complete';
+    parallelism: {
+        recommended: true;
+        strategy: 'one_worker_per_work_item';
+        instructions: string;
+    };
+    sessionId?: string;
+    workItems: Array<{
+        workId: string;
+        variantId?: string;
+        kind?: string;
+        worktreePath?: string;
+        briefLabel?: string;
+        briefBody?: string;
+        instruction?: string;
+        outputSchema?: unknown;
+    }>;
+};
+export declare const buildHostWorkNextAction: (status: StatusWithHostWork) => HostWorkNextAction | null;
+export declare const withHostWorkNextAction: <T extends StatusWithHostWork>(status: T) => T & {
+    nextAction?: HostWorkNextAction;
+};
+export {};
+//# sourceMappingURL=hostWorkNextAction.d.ts.map

package/dist/cli/hostWorkNextAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostWorkNextAction.d.ts","sourceRoot":"","sources":["../../src/cli/hostWorkNextAction.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;KAC3B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,4BAA4B,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,yBAAyB,CAAC;IACnC,WAAW,EAAE;QACX,WAAW,EAAE,IAAI,CAAC;QAClB,QAAQ,EAAE,0BAA0B,CAAC;QACrC,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,KAAK,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC,CAAC;CACJ,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,kBAAkB,KACzB,kBAAkB,GAAG,IAkCvB,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,kBAAkB,EACjE,QAAQ,CAAC,KACR,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,kBAAkB,CAAA;CAGvC,CAAC"}

package/dist/cli/hostWorkNextAction.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withHostWorkNextAction = exports.buildHostWorkNextAction = void 0;
+const buildHostWorkNextAction = (status) => {
+    const hostWork = status.variants?.hostWork ?? [];
+    if (hostWork.length === 0) {
+        return null;
+    }
+    return {
+        action: 'complete_host_variant_work',
+        message: 'You are the host worker for these independent variant work items. Run them in parallel when your host supports subagents, then report each completion with rivet variants complete.',
+        command: 'rivet variants complete',
+        parallelism: {
+            recommended: true,
+            strategy: 'one_worker_per_work_item',
+            instructions: 'Spawn one subagent or parallel task per work item when available. Each item has its own worktreePath and can be edited independently.',
+        },
+        ...(status.variants?.sessionId
+            ? { sessionId: status.variants.sessionId }
+            : {}),
+        workItems: hostWork.map((item) => ({
+            workId: item.workId,
+            ...(item.variantId ? { variantId: item.variantId } : {}),
+            ...(item.kind ? { kind: item.kind } : {}),
+            ...(item.input?.worktreePath
+                ? { worktreePath: item.input.worktreePath }
+                : {}),
+            ...(item.input?.briefLabel ? { briefLabel: item.input.briefLabel } : {}),
+            ...(item.input?.briefBody ? { briefBody: item.input.briefBody } : {}),
+            ...(item.input?.instruction
+                ? { instruction: item.input.instruction }
+                : {}),
+            ...(item.outputSchema ? { outputSchema: item.outputSchema } : {}),
+        })),
+    };
+};
+exports.buildHostWorkNextAction = buildHostWorkNextAction;
+const withHostWorkNextAction = (status) => {
+    const nextAction = (0, exports.buildHostWorkNextAction)(status);
+    return nextAction ? { ...status, nextAction } : status;
+};
+exports.withHostWorkNextAction = withHostWorkNextAction;
+//# sourceMappingURL=hostWorkNextAction.js.map

package/dist/cli/hostWorkNextAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostWorkNextAction.js","sourceRoot":"","sources":["../../src/cli/hostWorkNextAction.ts"],"names":[],"mappings":";;;AA0CO,MAAM,uBAAuB,GAAG,CACrC,MAA0B,EACC,EAAE;IAC7B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,EAAE,QAAQ,IAAI,EAAE,CAAC;IACjD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,MAAM,EAAE,4BAA4B;QACpC,OAAO,EACL,qLAAqL;QACvL,OAAO,EAAE,yBAAyB;QAClC,WAAW,EAAE;YACX,WAAW,EAAE,IAAI;YACjB,QAAQ,EAAE,0BAA0B;YACpC,YAAY,EACV,uIAAuI;SAC1I;QACD,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS;YAC5B,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE;YAC1C,CAAC,CAAC,EAAE,CAAC;QACP,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACjC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY;gBAC1B,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE;gBAC3C,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW;gBACzB,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBACzC,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClE,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC,CAAC;AApCW,QAAA,uBAAuB,2BAoClC;AAEK,MAAM,sBAAsB,GAAG,CACpC,MAAS,EACgC,EAAE;IAC3C,MAAM,UAAU,GAAG,IAAA,+BAAuB,EAAC,MAAM,CAAC,CAAC;IACnD,OAAO,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AACzD,CAAC,CAAC;AALW,QAAA,sBAAsB,0BAKjC"}

package/dist/cli/io.d.ts

@@ -0,0 +1,17 @@
+import type { CliCommandResult, CliEnvelope } from './envelope';
+/**
+ * Output surface for CLI subcommands. Envelopes go to stdout; human-readable
+ * progress goes to stderr. Injectable so tests can capture both streams
+ * without spawning a process.
+ *
+ * The CLI contract is non-interactive: this surface deliberately exposes no
+ * stdin reader, so agent-reachable subcommands cannot block on input.
+ */
+export type CliIO = {
+    writeEnvelope: (envelope: CliEnvelope) => void;
+    writeProgress: (message: string) => void;
+};
+export declare const processCliIO: CliIO;
+/** Print a command result and return its exit code. */
+export declare const emitResult: (io: CliIO, result: CliCommandResult) => number;
+//# sourceMappingURL=io.d.ts.map

package/dist/cli/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/cli/io.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGhE;;;;;;;GAOG;AACH,MAAM,MAAM,KAAK,GAAG;IAClB,aAAa,EAAE,CAAC,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC;IAC/C,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAO1B,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,UAAU,GAAI,IAAI,KAAK,EAAE,QAAQ,gBAAgB,KAAG,MAGhE,CAAC"}

package/dist/cli/io.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitResult = exports.processCliIO = void 0;
+const envelope_1 = require("./envelope");
+exports.processCliIO = {
+    writeEnvelope: (envelope) => {
+        process.stdout.write(`${(0, envelope_1.serializeEnvelope)(envelope)}\n`);
+    },
+    writeProgress: (message) => {
+        process.stderr.write(`${message}\n`);
+    },
+};
+/** Print a command result and return its exit code. */
+const emitResult = (io, result) => {
+    io.writeEnvelope(result.envelope);
+    return result.exitCode;
+};
+exports.emitResult = emitResult;
+//# sourceMappingURL=io.js.map

package/dist/cli/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/cli/io.ts"],"names":[],"mappings":";;;AACA,yCAA+C;AAelC,QAAA,YAAY,GAAU;IACjC,aAAa,EAAE,CAAC,QAAQ,EAAE,EAAE;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAA,4BAAiB,EAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC;IACD,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACvC,CAAC;CACF,CAAC;AAEF,uDAAuD;AAChD,MAAM,UAAU,GAAG,CAAC,EAAS,EAAE,MAAwB,EAAU,EAAE;IACxE,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC,QAAQ,CAAC;AACzB,CAAC,CAAC;AAHW,QAAA,UAAU,cAGrB"}

package/dist/cli/router.d.ts

@@ -0,0 +1,23 @@
+import { type CliCommandResult } from './envelope';
+import { type CliIO } from './io';
+/**
+ * Dispatch for the `rivet` control-plane subcommands (the CLI-first
+ * surface). Every command emits exactly one JSON envelope on stdout (NDJSON
+ * for streaming surfaces), routes progress to stderr, and maps onto the
+ * documented exit codes. Handlers are imported lazily so a subcommand only
+ * loads the services it needs.
+ */
+export { isCliControlCommand } from './commandNames';
+export declare const splitMcpServeArgs: (rest: string[]) => string[] | null;
+/**
+ * Route one control-plane subcommand to its handler. Exported for the MCP
+ * server (`rivet mcp serve`), which calls it in-process per tool call —
+ * the CLI and MCP are two front-ends over this one dispatch.
+ */
+export declare const dispatch: (command: string, rest: string[], io: CliIO) => Promise<CliCommandResult>;
+/**
+ * Run one control-plane subcommand end to end: dispatch, emit the envelope,
+ * record telemetry, and return the documented exit code.
+ */
+export declare const runCliControlCommand: (args: string[], io?: CliIO) => Promise<number>;
+//# sourceMappingURL=router.d.ts.map

package/dist/cli/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/cli/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAA4B,KAAK,KAAK,EAAE,MAAM,MAAM,CAAC;AAG5D;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AA6CrD,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,KAAG,MAAM,EAAE,GAAG,IAM7D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GACnB,SAAS,MAAM,EACf,MAAM,MAAM,EAAE,EACd,IAAI,KAAK,KACR,OAAO,CAAC,gBAAgB,CA0E1B,CAAC;AAyBF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,EAAE,EACd,KAAI,KAAoB,KACvB,OAAO,CAAC,MAAM,CAsDhB,CAAC"}

package/dist/cli/router.js

@@ -0,0 +1,236 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCliControlCommand = exports.dispatch = exports.splitMcpServeArgs = exports.isCliControlCommand = void 0;
+const envelope_1 = require("./envelope");
+const io_1 = require("./io");
+const handoff_1 = require("./handoff");
+/**
+ * Dispatch for the `rivet` control-plane subcommands (the CLI-first
+ * surface). Every command emits exactly one JSON envelope on stdout (NDJSON
+ * for streaming surfaces), routes progress to stderr, and maps onto the
+ * documented exit codes. Handlers are imported lazily so a subcommand only
+ * loads the services it needs.
+ */
+var commandNames_1 = require("./commandNames");
+Object.defineProperty(exports, "isCliControlCommand", { enumerable: true, get: function () { return commandNames_1.isCliControlCommand; } });
+/** One-line usage summaries surfaced by `--help` on each subcommand. */
+const COMMAND_USAGE = {
+    open: [
+        'rivet open [--project <path>] [--agent claude|codex|cursor] [--rivet-port N] [--user-port N] [--framework <f>] [--entry <p>] [--no-browser] [--no-git]',
+        'Start or attach to the project\u2019s Rivet server (idempotent per project root).',
+    ],
+    stop: ['rivet stop [--project <path>]', 'Stop the CLI-owned Rivet server.'],
+    status: [
+        'rivet status [--project <path>] [--watch]',
+        'Session, runner, and variants status; --watch streams NDJSON.',
+    ],
+    wait: [
+        'rivet wait <workId> [--timeout <seconds>] [--project <path>]',
+        'Block until a work id settles; exits 5 on timeout.',
+    ],
+    variants: [
+        'rivet variants <start|status|cancel|commit|complete|list> [options]',
+        'start: --instruction <text> [--count N] [--element <selector>] [--fresh] [--target <sessionId>:<variantId>] · cancel <sessionId> · commit <variantId> [--session <id>] · list [--history]',
+    ],
+    evidence: [
+        'rivet evidence capture --url <url> [--screenshot] [--width N --height N]',
+        'Capture rendered design evidence for a URL.',
+    ],
+    reference: [
+        'rivet reference fetch <url>',
+        'Fetch Pinterest / Are.na design-reference data via the connected account.',
+    ],
+    auth: ['rivet auth status', 'Report signed-in state (server-validated).'],
+    mcp: [
+        'rivet mcp serve [--project <path>]',
+        'Start the resident stdio MCP server (three deep tools over the CLI control plane). Bare `rivet mcp` — the deleted per-tool server — stays removed.',
+    ],
+};
+/**
+ * Agent invocations carry an optional handoff on every subcommand:
+ * `--caller-agent claude|codex|cursor`, `--caller-model <model>`,
+ * `--caller-session <chat-session-id>` (env: RIVET_CALLER_AGENT/MODEL/
+ * SESSION), or one `--handoff '{"agent":…,"model":…,"session":…}'`.
+ */
+const HANDOFF_USAGE = 'Optional handoff flags on every command: --caller-agent claude|codex|cursor, --caller-model <model>, --caller-session <id>, or --handoff <json>. Human-direct invocations omit them.';
+const splitMcpServeArgs = (rest) => {
+    const serveIndex = rest.indexOf('serve');
+    if (serveIndex === -1) {
+        return null;
+    }
+    return [...rest.slice(0, serveIndex), ...rest.slice(serveIndex + 1)];
+};
+exports.splitMcpServeArgs = splitMcpServeArgs;
+/**
+ * Route one control-plane subcommand to its handler. Exported for the MCP
+ * server (`rivet mcp serve`), which calls it in-process per tool call —
+ * the CLI and MCP are two front-ends over this one dispatch.
+ */
+const dispatch = async (command, rest, io) => {
+    if (command === 'mcp') {
+        const serveArgs = (0, exports.splitMcpServeArgs)(rest);
+        if (serveArgs) {
+            const { handleMcpServe } = await Promise.resolve().then(() => __importStar(require('./commands/mcpServe')));
+            return handleMcpServe(serveArgs, io);
+        }
+        // The per-tool MCP server is gone: agents drive Rivet with `rivet` CLI
+        // commands (or the resident `rivet mcp serve` adapter over them). A
+        // stale host registration can still spawn bare `rivet mcp` (with
+        // arbitrary legacy flags, which are ignored); fail fast with the removal
+        // envelope on stdout and human guidance on stderr — MCP hosts surface
+        // stderr.
+        io.writeProgress('The Rivet MCP server has been removed. Agents drive Rivet with `rivet` CLI commands now.\n' +
+            'Run `npx -y rivet-design@latest install` to update your agent setup (this also removes stale MCP registrations).');
+        return (0, envelope_1.errorResult)('mcp', 'MCP_REMOVED', 'The Rivet MCP server has been removed. Run `npx -y rivet-design@latest install` to update your agent setup, then drive Rivet with `rivet` CLI commands (`rivet open`, `rivet variants start`, …).');
+    }
+    if (command === 'open') {
+        const { handleOpen } = await Promise.resolve().then(() => __importStar(require('./commands/open')));
+        return handleOpen(rest, io);
+    }
+    if (command === 'stop') {
+        const { handleStop } = await Promise.resolve().then(() => __importStar(require('./commands/stop')));
+        return handleStop(rest);
+    }
+    if (command === 'status') {
+        const { handleStatus } = await Promise.resolve().then(() => __importStar(require('./commands/status')));
+        return handleStatus(rest, io);
+    }
+    if (command === 'wait') {
+        const { handleWait } = await Promise.resolve().then(() => __importStar(require('./commands/wait')));
+        return handleWait(rest);
+    }
+    if (command === 'variants') {
+        const { handleVariants } = await Promise.resolve().then(() => __importStar(require('./commands/variants')));
+        return handleVariants(rest);
+    }
+    if (command === 'evidence') {
+        if (rest[0] !== 'capture') {
+            return (0, envelope_1.errorResult)('evidence', 'USAGE_ERROR', 'Usage: rivet evidence capture --url <url>');
+        }
+        const { handleEvidenceCapture } = await Promise.resolve().then(() => __importStar(require('./commands/evidence')));
+        return handleEvidenceCapture(rest.slice(1));
+    }
+    if (command === 'reference') {
+        if (rest[0] !== 'fetch') {
+            return (0, envelope_1.errorResult)('reference', 'USAGE_ERROR', 'Usage: rivet reference fetch <url>');
+        }
+        const { handleReferenceFetch } = await Promise.resolve().then(() => __importStar(require('./commands/reference')));
+        return handleReferenceFetch(rest.slice(1));
+    }
+    if (command === 'auth') {
+        const { handleAuth } = await Promise.resolve().then(() => __importStar(require('./commands/auth')));
+        return handleAuth(rest);
+    }
+    if (command === '__serve') {
+        const { handleServe } = await Promise.resolve().then(() => __importStar(require('./commands/serve')));
+        return handleServe(rest, io);
+    }
+    return (0, envelope_1.errorResult)(command, 'USAGE_ERROR', `Unknown command: ${command}`);
+};
+exports.dispatch = dispatch;
+/** Caller attribution for command telemetry (kind and model only). */
+const telemetryHandoffFields = (args) => {
+    const valueOf = (flag) => {
+        const index = args.indexOf(flag);
+        return index !== -1 ? args[index + 1] : undefined;
+    };
+    const parsed = (0, handoff_1.parseHandoff)({
+        callerAgent: valueOf('--caller-agent'),
+        callerModel: valueOf('--caller-model'),
+        callerSession: valueOf('--caller-session'),
+        handoffJson: valueOf('--handoff'),
+    });
+    if (!parsed.ok || !parsed.handoff) {
+        return {};
+    }
+    return {
+        callerAgent: parsed.handoff.agent,
+        callerModel: parsed.handoff.model,
+    };
+};
+/**
+ * Run one control-plane subcommand end to end: dispatch, emit the envelope,
+ * record telemetry, and return the documented exit code.
+ */
+const runCliControlCommand = async (args, io = io_1.processCliIO) => {
+    // stdout is reserved for the JSON envelope: route every service log line
+    // to stderr, exactly as MCP mode does for its protocol stream.
+    const { redirectLogsToStderr } = await Promise.resolve().then(() => __importStar(require('../utils/logger')));
+    redirectLogsToStderr();
+    const [command, ...rest] = args;
+    const startedAt = Date.now();
+    if (rest.includes('--help') || rest.includes('-h')) {
+        const usage = COMMAND_USAGE[command] ?? [];
+        return (0, io_1.emitResult)(io, {
+            envelope: {
+                schemaVersion: envelope_1.CLI_SCHEMA_VERSION,
+                ok: true,
+                command,
+                data: { usage, handoff: HANDOFF_USAGE },
+            },
+            exitCode: 0,
+        });
+    }
+    let result;
+    try {
+        result = await (0, exports.dispatch)(command, rest, io);
+    }
+    catch (error) {
+        result = (0, envelope_1.errorResult)(command, 'OPERATION_FAILED', error instanceof Error ? error.message : String(error));
+    }
+    const exitCode = (0, io_1.emitResult)(io, result);
+    if (!rest.includes('--no-telemetry')) {
+        try {
+            const { TelemetryService } = await Promise.resolve().then(() => __importStar(require('../services/TelemetryService')));
+            const telemetry = new TelemetryService({ source: 'cli' });
+            telemetry.trackCliCommandCompleted({
+                command: result.envelope.command,
+                ok: result.envelope.ok,
+                exitCode,
+                errorCode: result.envelope.ok ? undefined : result.envelope.error.code,
+                durationMs: Date.now() - startedAt,
+                ...telemetryHandoffFields(rest),
+            });
+            await telemetry.shutdown();
+        }
+        catch {
+            // Telemetry is never allowed to break a CLI invocation.
+        }
+    }
+    return exitCode;
+};
+exports.runCliControlCommand = runCliControlCommand;
+//# sourceMappingURL=router.js.map

package/dist/cli/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/cli/router.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yCAIoB;AACpB,6BAA4D;AAC5D,uCAAyC;AAEzC;;;;;;GAMG;AAEH,+CAAqD;AAA5C,mHAAA,mBAAmB,OAAA;AAE5B,wEAAwE;AACxE,MAAM,aAAa,GAA6B;IAC9C,IAAI,EAAE;QACJ,wJAAwJ;QACxJ,mFAAmF;KACpF;IACD,IAAI,EAAE,CAAC,+BAA+B,EAAE,kCAAkC,CAAC;IAC3E,MAAM,EAAE;QACN,2CAA2C;QAC3C,+DAA+D;KAChE;IACD,IAAI,EAAE;QACJ,8DAA8D;QAC9D,oDAAoD;KACrD;IACD,QAAQ,EAAE;QACR,qEAAqE;QACrE,2LAA2L;KAC5L;IACD,QAAQ,EAAE;QACR,0EAA0E;QAC1E,6CAA6C;KAC9C;IACD,SAAS,EAAE;QACT,6BAA6B;QAC7B,2EAA2E;KAC5E;IACD,IAAI,EAAE,CAAC,mBAAmB,EAAE,4CAA4C,CAAC;IACzE,GAAG,EAAE;QACH,oCAAoC;QACpC,oJAAoJ;KACrJ;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,aAAa,GACjB,sLAAsL,CAAC;AAElL,MAAM,iBAAiB,GAAG,CAAC,IAAc,EAAmB,EAAE;IACnE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC,CAAC;AANW,QAAA,iBAAiB,qBAM5B;AAEF;;;;GAIG;AACI,MAAM,QAAQ,GAAG,KAAK,EAC3B,OAAe,EACf,IAAc,EACd,EAAS,EACkB,EAAE;IAC7B,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,IAAA,yBAAiB,EAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,EAAE,cAAc,EAAE,GAAG,wDAAa,qBAAqB,GAAC,CAAC;YAC/D,OAAO,cAAc,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,uEAAuE;QACvE,oEAAoE;QACpE,iEAAiE;QACjE,yEAAyE;QACzE,sEAAsE;QACtE,UAAU;QACV,EAAE,CAAC,aAAa,CACd,4FAA4F;YAC1F,kHAAkH,CACrH,CAAC;QACF,OAAO,IAAA,sBAAW,EAChB,KAAK,EACL,aAAa,EACb,mMAAmM,CACpM,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,UAAU,EAAE,GAAG,wDAAa,iBAAiB,GAAC,CAAC;QACvD,OAAO,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,UAAU,EAAE,GAAG,wDAAa,iBAAiB,GAAC,CAAC;QACvD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,EAAE,YAAY,EAAE,GAAG,wDAAa,mBAAmB,GAAC,CAAC;QAC3D,OAAO,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,UAAU,EAAE,GAAG,wDAAa,iBAAiB,GAAC,CAAC;QACvD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,MAAM,EAAE,cAAc,EAAE,GAAG,wDAAa,qBAAqB,GAAC,CAAC;QAC/D,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,IAAA,sBAAW,EAChB,UAAU,EACV,aAAa,EACb,2CAA2C,CAC5C,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,qBAAqB,EAAE,GAAG,wDAAa,qBAAqB,GAAC,CAAC;QACtE,OAAO,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;YACxB,OAAO,IAAA,sBAAW,EAChB,WAAW,EACX,aAAa,EACb,oCAAoC,CACrC,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,oBAAoB,EAAE,GAAG,wDAAa,sBAAsB,GAAC,CAAC;QACtE,OAAO,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,UAAU,EAAE,GAAG,wDAAa,iBAAiB,GAAC,CAAC;QACvD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,EAAE,WAAW,EAAE,GAAG,wDAAa,kBAAkB,GAAC,CAAC;QACzD,OAAO,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,IAAA,sBAAW,EAAC,OAAO,EAAE,aAAa,EAAE,oBAAoB,OAAO,EAAE,CAAC,CAAC;AAC5E,CAAC,CAAC;AA9EW,QAAA,QAAQ,YA8EnB;AAEF,sEAAsE;AACtE,MAAM,sBAAsB,GAAG,CAC7B,IAAc,EACkC,EAAE;IAClD,MAAM,OAAO,GAAG,CAAC,IAAY,EAAsB,EAAE;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,IAAA,sBAAY,EAAC;QAC1B,WAAW,EAAE,OAAO,CAAC,gBAAgB,CAAC;QACtC,WAAW,EAAE,OAAO,CAAC,gBAAgB,CAAC;QACtC,aAAa,EAAE,OAAO,CAAC,kBAAkB,CAAC;QAC1C,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC;KAClC,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAClC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;QACjC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;KAClC,CAAC;AACJ,CAAC,CAAC;AAEF;;;GAGG;AACI,MAAM,oBAAoB,GAAG,KAAK,EACvC,IAAc,EACd,KAAY,iBAAY,EACP,EAAE;IACnB,yEAAyE;IACzE,+DAA+D;IAC/D,MAAM,EAAE,oBAAoB,EAAE,GAAG,wDAAa,iBAAiB,GAAC,CAAC;IACjE,oBAAoB,EAAE,CAAC;IAEvB,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC3C,OAAO,IAAA,eAAU,EAAC,EAAE,EAAE;YACpB,QAAQ,EAAE;gBACR,aAAa,EAAE,6BAAkB;gBACjC,EAAE,EAAE,IAAI;gBACR,OAAO;gBACP,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE;aACxC;YACD,QAAQ,EAAE,CAAC;SACZ,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAA,gBAAQ,EAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,IAAA,sBAAW,EAClB,OAAO,EACP,kBAAkB,EAClB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,eAAU,EAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAExC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,EAAE,gBAAgB,EAAE,GAAG,wDAAa,8BAA8B,GAAC,CAAC;YAC1E,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1D,SAAS,CAAC,wBAAwB,CAAC;gBACjC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;gBAChC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;gBACtB,QAAQ;gBACR,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI;gBACtE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,GAAG,sBAAsB,CAAC,IAAI,CAAC;aAChC,CAAC,CAAC;YACH,MAAM,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,wDAAwD;QAC1D,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAzDW,QAAA,oBAAoB,wBAyD/B"}

package/dist/cli/runnerSelection.d.ts

@@ -0,0 +1,60 @@
+import type { CallerHandoff } from './handoff';
+/**
+ * Resolves which apply runner a CLI-started server uses, closing the
+ * `--agent` producer gap: the invoking agent's handoff is the default
+ * signal for which vendor CLI should execute applies.
+ *
+ * Precedence (first match wins), per the CLI-first design:
+ *   1. Explicit `--agent` on the server start (`claude`, `codex`, `cursor`).
+ *   2. User-level configuration (`~/.rivet/config.json`), same values.
+ *   3. Handoff `caller-agent` from the invocation that started the session
+ *      (agent-initiated starts only — human-direct starts contribute none).
+ *   4. PATH probe for a known vendor binary.
+ *   5. None found → unavailable; a local vendor CLI runner is required.
+ *
+ * Runner identity is NEVER read from project-local files: the runner
+ * executes with bypassed permissions, so only the invoking process (flags,
+ * env, user-scope config) may influence which binary that is.
+ */
+/** Vendor kinds a session can resolve to as its apply runner. */
+export type RunnerVendor = 'claude' | 'codex' | 'cursor';
+/** Vendor CLI binary probed on PATH for each runner kind. */
+export declare const RUNNER_VENDOR_BINARIES: Record<RunnerVendor, string>;
+/** Vendors the embedded terminal runner can execute today. */
+export declare const EXECUTABLE_RUNNER_VENDORS: readonly RunnerVendor[];
+/** Values accepted for the explicit `--agent` flag and user-config `runner`. */
+export declare const EXPLICIT_RUNNER_SELECTIONS: readonly string[];
+/**
+ * Usage-error message for an invalid explicit `--agent` value, or null when
+ * the value is absent or one of the accepted selections.
+ */
+export declare const explicitRunnerSelectionError: (value: string | undefined) => string | null;
+export type RunnerSource = 'flag' | 'user_config' | 'handoff' | 'path_probe';
+export type ResolvedRunner = {
+    mode: 'runner';
+    vendor: RunnerVendor;
+    source: RunnerSource;
+} | {
+    mode: 'unavailable';
+};
+export type BinaryProbe = (binary: string) => boolean;
+/** True when `binary` resolves to an executable on PATH. */
+export declare const isBinaryOnPath: (binary: string, env?: NodeJS.ProcessEnv) => boolean;
+export type ResolveRunnerOptions = {
+    /** Explicit `--agent` value on the server start, when supplied. */
+    explicitAgent?: string;
+    /** `runner` value from user-level `~/.rivet/config.json`, when set. */
+    configuredRunner?: string;
+    /** Handoff from the invocation that started the session, when present. */
+    handoff?: CallerHandoff | null;
+    /** Injectable PATH probe (defaults to a real executable check). */
+    probe?: BinaryProbe;
+};
+/**
+ * Resolve the session's apply runner by the documented precedence. The
+ * result is fixed for the server's lifetime; later invocations with a
+ * different caller-agent never flip it (they are logged and surfaced in
+ * `rivet status` instead).
+ */
+export declare const resolveRunner: (options: ResolveRunnerOptions) => ResolvedRunner;
+//# sourceMappingURL=runnerSelection.d.ts.map

package/dist/cli/runnerSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnerSelection.d.ts","sourceRoot":"","sources":["../../src/cli/runnerSelection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C;;;;;;;;;;;;;;;;GAgBG;AAEH,iEAAiE;AACjE,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEzD,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAI/D,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,yBAAyB,EAAE,SAAS,YAAY,EAI5D,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAEvD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GACvC,OAAO,MAAM,GAAG,SAAS,KACxB,MAAM,GAAG,IAQX,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;AAE7E,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAE5B,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;AAEtD,4DAA4D;AAC5D,eAAO,MAAM,cAAc,GACzB,QAAQ,MAAM,EACd,MAAK,MAAM,CAAC,UAAwB,KACnC,OAYF,CAAC;AAiBF,MAAM,MAAM,oBAAoB,GAAG;IACjC,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,mEAAmE;IACnE,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,SAAS,oBAAoB,KAC5B,cAyBF,CAAC"}

package/dist/cli/runnerSelection.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRunner = exports.isBinaryOnPath = exports.explicitRunnerSelectionError = exports.EXPLICIT_RUNNER_SELECTIONS = exports.EXECUTABLE_RUNNER_VENDORS = exports.RUNNER_VENDOR_BINARIES = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/** Vendor CLI binary probed on PATH for each runner kind. */
+exports.RUNNER_VENDOR_BINARIES = {
+    claude: 'claude',
+    codex: 'codex',
+    cursor: 'cursor-agent',
+};
+/** Vendors the embedded terminal runner can execute today. */
+exports.EXECUTABLE_RUNNER_VENDORS = [
+    'claude',
+    'codex',
+    'cursor',
+];
+/** Values accepted for the explicit `--agent` flag and user-config `runner`. */
+exports.EXPLICIT_RUNNER_SELECTIONS = [
+    ...exports.EXECUTABLE_RUNNER_VENDORS,
+];
+/**
+ * Usage-error message for an invalid explicit `--agent` value, or null when
+ * the value is absent or one of the accepted selections.
+ */
+const explicitRunnerSelectionError = (value) => {
+    if (value === undefined) {
+        return null;
+    }
+    if (exports.EXPLICIT_RUNNER_SELECTIONS.includes(value.trim().toLowerCase())) {
+        return null;
+    }
+    return `Flag --agent must be one of ${exports.EXPLICIT_RUNNER_SELECTIONS.join('|')} (got "${value}")`;
+};
+exports.explicitRunnerSelectionError = explicitRunnerSelectionError;
+/** True when `binary` resolves to an executable on PATH. */
+const isBinaryOnPath = (binary, env = process.env) => {
+    const pathValue = env.PATH ?? '';
+    for (const dir of pathValue.split(path_1.delimiter)) {
+        if (!dir)
+            continue;
+        try {
+            (0, fs_1.accessSync)((0, path_1.join)(dir, binary), fs_1.constants.X_OK);
+            return true;
+        }
+        catch {
+            // Not here — keep probing.
+        }
+    }
+    return false;
+};
+exports.isBinaryOnPath = isBinaryOnPath;
+const asExecutableVendor = (value) => {
+    if (!value)
+        return null;
+    const candidate = value.trim().toLowerCase();
+    return exports.EXECUTABLE_RUNNER_VENDORS.includes(candidate)
+        ? candidate
+        : null;
+};
+/** Explicit selection value (flag or user config): a vendor or invalid. */
+const asExplicitSelection = (value) => {
+    return asExecutableVendor(value);
+};
+/**
+ * Resolve the session's apply runner by the documented precedence. The
+ * result is fixed for the server's lifetime; later invocations with a
+ * different caller-agent never flip it (they are logged and surfaced in
+ * `rivet status` instead).
+ */
+const resolveRunner = (options) => {
+    const probe = options.probe ?? ((binary) => (0, exports.isBinaryOnPath)(binary));
+    const explicit = asExplicitSelection(options.explicitAgent);
+    if (explicit) {
+        return { mode: 'runner', vendor: explicit, source: 'flag' };
+    }
+    const configured = asExplicitSelection(options.configuredRunner);
+    if (configured) {
+        return { mode: 'runner', vendor: configured, source: 'user_config' };
+    }
+    const handoffVendor = asExecutableVendor(options.handoff?.agent);
+    if (handoffVendor && probe(exports.RUNNER_VENDOR_BINARIES[handoffVendor])) {
+        return { mode: 'runner', vendor: handoffVendor, source: 'handoff' };
+    }
+    for (const vendor of exports.EXECUTABLE_RUNNER_VENDORS) {
+        if (probe(exports.RUNNER_VENDOR_BINARIES[vendor])) {
+            return { mode: 'runner', vendor, source: 'path_probe' };
+        }
+    }
+    return { mode: 'unavailable' };
+};
+exports.resolveRunner = resolveRunner;
+//# sourceMappingURL=runnerSelection.js.map

package/dist/cli/runnerSelection.js.map

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