rivet-design 0.12.3 → 0.13.0

package/dist/cli/commands/open.js

@@ -0,0 +1,280 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleOpen = void 0;
+const child_process_1 = require("child_process");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const envelope_1 = require("../envelope");
+const flags_1 = require("../flags");
+const client_1 = require("../client");
+const serverHandshake_1 = require("../serverHandshake");
+const handoff_1 = require("../handoff");
+const runnerSelection_1 = require("../runnerSelection");
+const shared_1 = require("./shared");
+const COMMAND = 'open';
+const OPEN_FLAG_SPEC = {
+    'rivet-port': { takesValue: true },
+    'user-port': { takesValue: true },
+    framework: { takesValue: true },
+    entry: { takesValue: true },
+    agent: { takesValue: true },
+    'no-git': { takesValue: false },
+    'no-browser': { takesValue: false },
+};
+/** How long `rivet open` waits for a spawned server's handshake to go live. */
+const DEFAULT_SERVER_START_TIMEOUT_MS = 120_000;
+const SERVER_START_POLL_INTERVAL_MS = 300;
+/** How long a racing `rivet open` waits for the lock winner's server. */
+const DEFAULT_LOCK_WAIT_TIMEOUT_MS = 150_000;
+const SERVER_START_TIMEOUT_ENV = 'RIVET_SERVER_START_TIMEOUT_MS';
+const LOCK_WAIT_TIMEOUT_ENV = 'RIVET_LOCK_WAIT_TIMEOUT_MS';
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/** Poll for a healthy server until it appears or the deadline passes. */
+const waitForServer = async (projectPath, timeoutMs, isSpawnDead) => {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const attached = await (0, client_1.attachToServer)(projectPath);
+        if (attached) {
+            return attached;
+        }
+        if (isSpawnDead?.()) {
+            return null;
+        }
+        await sleep(SERVER_START_POLL_INTERVAL_MS);
+    }
+    return null;
+};
+const serverLogPath = (projectPath) => path_1.default.join(projectPath, '.rivet', 'cli', 'server.log');
+const tailServerLog = (projectPath) => {
+    try {
+        const contents = fs_1.default.readFileSync(serverLogPath(projectPath), 'utf8');
+        const lines = contents.trimEnd().split('\n');
+        return lines.slice(-12).join('\n') || undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * Launch the detached `rivet __serve` process for a project. Output goes to
+ * `.rivet/cli/server.log`; the child advertises itself via the handshake.
+ */
+const spawnDetachedServer = ({ projectPath, serveArgs, env, }) => {
+    const logPath = serverLogPath(projectPath);
+    fs_1.default.mkdirSync(path_1.default.dirname(logPath), { recursive: true });
+    const logFd = fs_1.default.openSync(logPath, 'a');
+    const child = (0, child_process_1.spawn)(process.execPath, [process.argv[1], '__serve', ...serveArgs], {
+        cwd: projectPath,
+        env,
+        detached: true,
+        stdio: ['ignore', logFd, logFd],
+    });
+    let isDead = false;
+    child.once('exit', () => {
+        isDead = true;
+    });
+    child.unref();
+    fs_1.default.closeSync(logFd);
+    return { pid: child.pid, isDead: () => isDead };
+};
+const timeoutFromEnv = (env, name, fallbackMs) => {
+    const value = env[name];
+    if (!value) {
+        return fallbackMs;
+    }
+    const parsed = Number.parseInt(value, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallbackMs;
+};
+const passthroughServeArgs = (context) => {
+    const { flags, projectPath } = context;
+    const args = ['--project', projectPath];
+    for (const name of [
+        'rivet-port',
+        'user-port',
+        'framework',
+        'entry',
+        'agent',
+    ]) {
+        const value = (0, flags_1.stringFlag)(flags, name);
+        if (value !== undefined) {
+            args.push(`--${name}`, value);
+        }
+    }
+    for (const name of [
+        'no-git',
+        'no-telemetry',
+    ]) {
+        if (flags.values[name] === true) {
+            args.push(`--${name}`);
+        }
+    }
+    return args;
+};
+/**
+ * Environment for the spawned server. The handoff rides on env vars — never
+ * argv — so the caller's chat session id stays out of process listings.
+ */
+const serveEnvFor = (handoff, baseEnv) => ({
+    ...baseEnv,
+    ...(handoff
+        ? {
+            [handoff_1.HANDOFF_ENV_VARS.agent]: handoff.agent,
+            ...(handoff.model ? { [handoff_1.HANDOFF_ENV_VARS.model]: handoff.model } : {}),
+            ...(handoff.session
+                ? { [handoff_1.HANDOFF_ENV_VARS.session]: handoff.session }
+                : {}),
+        }
+        : {}),
+});
+const openedData = async (attached, wasAlreadyRunning) => {
+    let session;
+    try {
+        const status = await (0, client_1.requestServer)(attached, '/api/cli/status');
+        if (status.status === 200) {
+            session = status.body.session;
+        }
+    }
+    catch {
+        // Status detail is best-effort on open; the attach itself succeeded.
+    }
+    return {
+        attached: true,
+        alreadyRunning: wasAlreadyRunning,
+        rivetPort: attached.handshake.rivetPort,
+        editorUrl: (0, client_1.editorUrlFor)(attached),
+        sessionId: session?.sessionId ?? attached.handshake.sessionId,
+        applyMode: attached.handshake.applyMode,
+        resolvedRunner: session?.resolvedRunner ?? null,
+        initiator: session?.initiator ?? null,
+    };
+};
+/**
+ * Open the editor in a browser unless the caller explicitly disables it.
+ */
+const maybeOpenBrowser = async (context, editorUrl, io, openBrowser) => {
+    if (context.flags.values['no-browser'] === true) {
+        return;
+    }
+    try {
+        const launch = openBrowser ??
+            (await Promise.resolve().then(() => __importStar(require('open')))).default;
+        await launch(editorUrl);
+        io.writeProgress(`Opened ${editorUrl} in your browser.`);
+    }
+    catch {
+        io.writeProgress(`Open ${editorUrl} in your browser to start editing.`);
+    }
+};
+/**
+ * Start-or-attach the project's Rivet server. Idempotent per project root:
+ * a live server is attached to; otherwise the start lock elects one starter
+ * and every racing invocation converges on the winner's server.
+ */
+const handleOpen = async (args, io, dependencies = {}) => {
+    const context = (0, shared_1.parseCommandContext)(COMMAND, args, OPEN_FLAG_SPEC, dependencies.env);
+    if ((0, shared_1.isCommandResult)(context)) {
+        return context;
+    }
+    const { projectPath, handoff } = context;
+    const env = dependencies.env ?? process.env;
+    const serverStartTimeoutMs = timeoutFromEnv(env, SERVER_START_TIMEOUT_ENV, DEFAULT_SERVER_START_TIMEOUT_MS);
+    const lockWaitTimeoutMs = timeoutFromEnv(env, LOCK_WAIT_TIMEOUT_ENV, DEFAULT_LOCK_WAIT_TIMEOUT_MS);
+    const agentSelectionError = (0, runnerSelection_1.explicitRunnerSelectionError)((0, flags_1.stringFlag)(context.flags, 'agent'));
+    if (agentSelectionError) {
+        return (0, envelope_1.errorResult)(COMMAND, 'USAGE_ERROR', agentSelectionError);
+    }
+    let isAuthenticated = dependencies.isAuthenticated;
+    if (!isAuthenticated) {
+        const { getConfigManager } = await Promise.resolve().then(() => __importStar(require('../../services/ConfigManager')));
+        isAuthenticated = () => getConfigManager().isAuthenticated();
+    }
+    if (!isAuthenticated()) {
+        io.writeProgress('Not signed in. Run `rivet login` first.');
+        return (0, envelope_1.errorResult)(COMMAND, 'AUTH_REQUIRED', 'Authentication required. Run `rivet login` first.');
+    }
+    const existing = await (0, client_1.attachToServer)(projectPath);
+    if (existing) {
+        const data = await openedData(existing, true);
+        await maybeOpenBrowser(context, data.editorUrl, io, dependencies.openBrowser);
+        return (0, envelope_1.okResult)(COMMAND, data);
+    }
+    const spawnServer = dependencies.spawnServer ?? spawnDetachedServer;
+    const lock = (0, serverHandshake_1.acquireStartLock)(projectPath);
+    if (!lock) {
+        // Another invocation is starting the server — converge on its result.
+        io.writeProgress('Another rivet invocation is starting this project — attaching…');
+        const attached = await waitForServer(projectPath, lockWaitTimeoutMs);
+        if (!attached) {
+            return (0, envelope_1.errorResult)(COMMAND, 'SERVER_UNAVAILABLE', 'Timed out waiting for the concurrent rivet open to bring the server up.');
+        }
+        const data = await openedData(attached, true);
+        await maybeOpenBrowser(context, data.editorUrl, io, dependencies.openBrowser);
+        return (0, envelope_1.okResult)(COMMAND, data);
+    }
+    let shouldReleaseStartLock = true;
+    try {
+        io.writeProgress(`Starting Rivet server for ${projectPath}…`);
+        const handle = spawnServer({
+            projectPath,
+            serveArgs: passthroughServeArgs(context),
+            env: serveEnvFor(handoff, env),
+        });
+        if (handle.pid) {
+            lock.holdForProcess(handle.pid);
+        }
+        const attached = await waitForServer(projectPath, serverStartTimeoutMs, handle.isDead);
+        if (!attached) {
+            const logTail = tailServerLog(projectPath);
+            if (!handle.isDead()) {
+                shouldReleaseStartLock = false;
+            }
+            return (0, envelope_1.errorResult)(COMMAND, 'SERVER_UNAVAILABLE', 'The Rivet server did not come up. See .rivet/cli/server.log for details.', logTail ? { serverLog: logTail } : undefined);
+        }
+        const data = await openedData(attached, false);
+        await maybeOpenBrowser(context, data.editorUrl, io, dependencies.openBrowser);
+        return (0, envelope_1.okResult)(COMMAND, data);
+    }
+    finally {
+        if (shouldReleaseStartLock) {
+            lock.release();
+        }
+    }
+};
+exports.handleOpen = handleOpen;
+//# sourceMappingURL=open.js.map

package/dist/cli/commands/open.js.map

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

package/dist/cli/commands/reference.d.ts

@@ -0,0 +1,8 @@
+import { type CliCommandResult } from '../envelope';
+/**
+ * Fetch normalized design-reference data (Pinterest pins, Are.na blocks)
+ * through the user's connected account. Talks to the proxy directly — no
+ * project server attach required.
+ */
+export declare const handleReferenceFetch: (args: string[]) => Promise<CliCommandResult>;
+//# sourceMappingURL=reference.d.ts.map

package/dist/cli/commands/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/reference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAgC3E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,EAAE,KACb,OAAO,CAAC,gBAAgB,CAgD1B,CAAC"}

package/dist/cli/commands/reference.js

@@ -0,0 +1,101 @@
+"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.handleReferenceFetch = void 0;
+const envelope_1 = require("../envelope");
+const shared_1 = require("./shared");
+const COMMAND = 'reference.fetch';
+/**
+ * Map a reference URL to its provider by host: Pinterest (pinterest.com /
+ * pin.it, including subdomains) or Are.na. Unsupported hosts are reported in
+ * the envelope so agents fall back to native URL handling.
+ */
+const detectProvider = (url) => {
+    let host;
+    try {
+        host = new URL(url).hostname.toLowerCase();
+    }
+    catch {
+        return null;
+    }
+    if (host === 'pin.it' ||
+        host === 'pinterest.com' ||
+        host.endsWith('.pinterest.com')) {
+        return 'pinterest';
+    }
+    if (host === 'are.na' || host.endsWith('.are.na')) {
+        return 'arena';
+    }
+    return null;
+};
+/**
+ * Fetch normalized design-reference data (Pinterest pins, Are.na blocks)
+ * through the user's connected account. Talks to the proxy directly — no
+ * project server attach required.
+ */
+const handleReferenceFetch = async (args) => {
+    const context = (0, shared_1.parseCommandContext)(COMMAND, args);
+    if ((0, shared_1.isCommandResult)(context)) {
+        return context;
+    }
+    const url = context.flags.positionals[0];
+    if (!url) {
+        return (0, envelope_1.errorResult)(COMMAND, 'USAGE_ERROR', 'Usage: rivet reference fetch <url>');
+    }
+    const provider = detectProvider(url);
+    if (!provider) {
+        return (0, envelope_1.okResult)(COMMAND, {
+            status: 'unsupported',
+            message: 'Unsupported design-reference URL. rivet reference fetch handles Pinterest (pinterest.com / pin.it) and Are.na (are.na) links.',
+        });
+    }
+    const { getConfigManager } = await Promise.resolve().then(() => __importStar(require('../../services/ConfigManager')));
+    if (!getConfigManager().isAuthenticated()) {
+        return (0, envelope_1.errorResult)(COMMAND, 'AUTH_REQUIRED', 'Authentication required. Run `rivet login` first.');
+    }
+    const { IntegrationsClient } = await Promise.resolve().then(() => __importStar(require('../../services/IntegrationsClient')));
+    const client = new IntegrationsClient();
+    try {
+        const result = provider === 'pinterest'
+            ? await client.fetchPinterest(url)
+            : await client.fetchArena(url);
+        return (0, envelope_1.okResult)(COMMAND, { provider, ...result });
+    }
+    catch (error) {
+        return (0, envelope_1.errorResult)(COMMAND, 'OPERATION_FAILED', error instanceof Error ? error.message : 'Reference fetch failed');
+    }
+};
+exports.handleReferenceFetch = handleReferenceFetch;
+//# sourceMappingURL=reference.js.map

package/dist/cli/commands/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../../../src/cli/commands/reference.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,0CAA2E;AAC3E,qCAAgE;AAEhE,MAAM,OAAO,GAAG,iBAAiB,CAAC;AAIlC;;;;GAIG;AACH,MAAM,cAAc,GAAG,CAAC,GAAW,EAA4B,EAAE;IAC/D,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IACE,IAAI,KAAK,QAAQ;QACjB,IAAI,KAAK,eAAe;QACxB,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAC/B,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAClD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;GAIG;AACI,MAAM,oBAAoB,GAAG,KAAK,EACvC,IAAc,EACa,EAAE;IAC7B,MAAM,OAAO,GAAG,IAAA,4BAAmB,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnD,IAAI,IAAA,wBAAe,EAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,IAAA,sBAAW,EAChB,OAAO,EACP,aAAa,EACb,oCAAoC,CACrC,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAA,mBAAQ,EAAC,OAAO,EAAE;YACvB,MAAM,EAAE,aAAa;YACrB,OAAO,EACL,+HAA+H;SAClI,CAAC,CAAC;IACL,CAAC;IAED,MAAM,EAAE,gBAAgB,EAAE,GAAG,wDAAa,8BAA8B,GAAC,CAAC;IAC1E,IAAI,CAAC,gBAAgB,EAAE,CAAC,eAAe,EAAE,EAAE,CAAC;QAC1C,OAAO,IAAA,sBAAW,EAChB,OAAO,EACP,eAAe,EACf,mDAAmD,CACpD,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,kBAAkB,EAAE,GAC1B,wDAAa,mCAAmC,GAAC,CAAC;IACpD,MAAM,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,GACV,QAAQ,KAAK,WAAW;YACtB,CAAC,CAAC,MAAM,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC;YAClC,CAAC,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO,IAAA,mBAAQ,EAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAA,sBAAW,EAChB,OAAO,EACP,kBAAkB,EAClB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAClE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAlDW,QAAA,oBAAoB,wBAkD/B"}

package/dist/cli/commands/serve.d.ts

@@ -0,0 +1,9 @@
+import { type CliCommandResult } from '../envelope';
+import type { CliIO } from '../io';
+/**
+ * Foreground server process behind `rivet open` (spawned detached). Resolves
+ * the target app's dev server and runs the editor server. Variant work is
+ * leased to the host agent session through the CLI/MCP control plane.
+ */
+export declare const handleServe: (args: string[], io: CliIO) => Promise<CliCommandResult>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/cli/commands/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE3E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAiBnC;;;;GAIG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,MAAM,EAAE,EACd,IAAI,KAAK,KACR,OAAO,CAAC,gBAAgB,CA2J1B,CAAC"}

package/dist/cli/commands/serve.js

@@ -0,0 +1,182 @@
+"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.handleServe = void 0;
+const envelope_1 = require("../envelope");
+const flags_1 = require("../flags");
+const shared_1 = require("./shared");
+const handoff_1 = require("../handoff");
+const handoffStore_1 = require("../handoffStore");
+const runnerSelection_1 = require("../runnerSelection");
+const COMMAND = '__serve';
+const SERVE_FLAG_SPEC = {
+    'rivet-port': { takesValue: true },
+    'user-port': { takesValue: true },
+    framework: { takesValue: true },
+    entry: { takesValue: true },
+    agent: { takesValue: true },
+    'no-git': { takesValue: false },
+};
+/**
+ * Foreground server process behind `rivet open` (spawned detached). Resolves
+ * the target app's dev server and runs the editor server. Variant work is
+ * leased to the host agent session through the CLI/MCP control plane.
+ */
+const handleServe = async (args, io) => {
+    const context = (0, shared_1.parseCommandContext)(COMMAND, args, SERVE_FLAG_SPEC);
+    if ((0, shared_1.isCommandResult)(context)) {
+        return context;
+    }
+    const { flags, projectPath, handoff } = context;
+    const agentSelectionError = (0, runnerSelection_1.explicitRunnerSelectionError)((0, flags_1.stringFlag)(flags, 'agent'));
+    if (agentSelectionError) {
+        return (0, envelope_1.errorResult)(COMMAND, 'USAGE_ERROR', agentSelectionError);
+    }
+    // Imported lazily: `../index` re-exports the dev-server resolution helpers
+    // and importing it eagerly would create a module cycle with the router.
+    const { resolveAgentDevServer, buildAgentDevServerHealth, registerOwnedDevServerSignalHandlers, updateOwnedDevServerHealthOnExit, DEFAULT_PORT, } = await Promise.resolve().then(() => __importStar(require('../../index')));
+    const { startServer } = await Promise.resolve().then(() => __importStar(require('../../server')));
+    const { TelemetryService } = await Promise.resolve().then(() => __importStar(require('../../services/TelemetryService')));
+    const { createVariantsRuntime } = await Promise.resolve().then(() => __importStar(require('../../services/VariantsRuntime')));
+    const { findAvailablePort } = await Promise.resolve().then(() => __importStar(require('../../utils/portUtils')));
+    const { writeCursorRulesIfNeeded } = await Promise.resolve().then(() => __importStar(require('../../utils/skillWriter')));
+    const telemetry = new TelemetryService({
+        enabled: flags.values['no-telemetry'] !== true,
+        source: 'cli',
+    });
+    const framework = (0, flags_1.stringFlag)(flags, 'framework');
+    const agentDevServer = await resolveAgentDevServer({
+        projectPath,
+        options: {
+            framework,
+            entry: (0, flags_1.stringFlag)(flags, 'entry'),
+            userPort: (0, flags_1.integerFlag)(flags, 'user-port'),
+        },
+    });
+    const { project, userDevServerPort, devServerContext } = agentDevServer;
+    try {
+        const variantsRuntime = createVariantsRuntime({
+            projectPath,
+            telemetry,
+            devServerContext,
+            devServerHealth: buildAgentDevServerHealth(devServerContext),
+        });
+        const bridge = variantsRuntime.bridge;
+        const sessionInitiator = (0, handoff_1.initiatorFor)(handoff);
+        bridge.setSessionRuntimeInfo({
+            sessionInitiator,
+            resolvedRunner: {
+                mode: 'unavailable',
+            },
+        });
+        // Durable, owner-only attribution record; the chat session id lives only
+        // here (work items carry agent kind and model, never the session id).
+        try {
+            (0, handoffStore_1.writeSessionHandoff)(projectPath, {
+                sessionId: bridge.getSessionId(),
+                initiator: sessionInitiator,
+                handoff,
+            });
+        }
+        catch (err) {
+            io.writeProgress(`Could not persist session handoff (non-fatal): ${err instanceof Error ? err.message : String(err)}`);
+        }
+        if (agentDevServer.ownedProcess) {
+            const ownedDevServerPort = devServerContext.port;
+            registerOwnedDevServerSignalHandlers(agentDevServer.ownedProcess);
+            agentDevServer.ownedProcess.once('exit', () => {
+                updateOwnedDevServerHealthOnExit(bridge, ownedDevServerPort);
+            });
+        }
+        let rivetPort = (0, flags_1.integerFlag)(flags, 'rivet-port') ??
+            (await findAvailablePort(DEFAULT_PORT));
+        let serverStarted = false;
+        let retries = 0;
+        const maxRetries = 5;
+        while (!serverStarted && retries < maxRetries) {
+            try {
+                // Embedded mode serves previews from an isolated
+                // origin on a second port so they can run with `allow-same-origin`.
+                const previewPort = await findAvailablePort(rivetPort + 1);
+                await startServer({
+                    userPort: userDevServerPort,
+                    userHost: project.devServerHost,
+                    framework: project.framework,
+                    telemetry,
+                    projectPath,
+                    staticEntry: project.entryPoint,
+                    sessionBridge: bridge,
+                    variantsRuntime,
+                    previewPort,
+                    agentApplyMode: 'external',
+                    rivetPort,
+                    isGitEnabled: flags.values['no-git'] ? false : true,
+                    skipProcessHandlers: retries > 0,
+                    beforeShutdown: agentDevServer.cleanup,
+                    cliShutdown: () => process.kill(process.pid, 'SIGTERM'),
+                });
+                serverStarted = true;
+            }
+            catch (err) {
+                const code = err?.code;
+                if (code === 'EADDRINUSE' && !(0, flags_1.integerFlag)(flags, 'rivet-port')) {
+                    retries++;
+                    rivetPort = await findAvailablePort(rivetPort + 1);
+                }
+                else {
+                    await agentDevServer.cleanup?.();
+                    throw err;
+                }
+            }
+        }
+        if (!serverStarted) {
+            await agentDevServer.cleanup?.();
+            return (0, envelope_1.errorResult)(COMMAND, 'SERVER_UNAVAILABLE', `Could not start the Rivet server after ${maxRetries} attempts.`);
+        }
+        // Keep the project's Cursor rules current so in-editor agents discover
+        // the CLI without a global install step.
+        writeCursorRulesIfNeeded(projectPath);
+        io.writeProgress(`Rivet server on http://localhost:${rivetPort} — variants run via the host agent`);
+        // Run until stopped (`rivet stop`, SIGINT, or SIGTERM).
+        await new Promise(() => { });
+        return (0, envelope_1.okResult)(COMMAND, {});
+    }
+    catch (error) {
+        await agentDevServer.cleanup?.();
+        return (0, envelope_1.errorResult)(COMMAND, 'SERVER_UNAVAILABLE', error instanceof Error ? error.message : String(error));
+    }
+};
+exports.handleServe = handleServe;
+//# sourceMappingURL=serve.js.map

package/dist/cli/commands/serve.js.map

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

package/dist/cli/commands/shared.d.ts

@@ -0,0 +1,31 @@
+import type { ParsedFlags } from '../flags';
+import { type FlagSpec } from '../flags';
+import { type CliCommandResult } from '../envelope';
+import { type AttachedServer } from '../client';
+import { type CallerHandoff } from '../handoff';
+/** Flags accepted by every control-plane subcommand. */
+export declare const SHARED_FLAG_SPEC: FlagSpec;
+export declare const withSharedFlags: (spec: FlagSpec) => FlagSpec;
+export type CommandContext = {
+    flags: ParsedFlags;
+    projectPath: string;
+    handoff: CallerHandoff | null;
+};
+/**
+ * Parse a subcommand's argv: shared flags, the project root, and the
+ * optional caller handoff. Returns a usage-error result when the invocation
+ * is malformed.
+ */
+export declare const parseCommandContext: (command: string, args: string[], spec?: FlagSpec, env?: NodeJS.ProcessEnv) => CommandContext | CliCommandResult;
+export declare const isCommandResult: (value: CommandContext | CliCommandResult) => value is CliCommandResult;
+/**
+ * Attach to the project's live server or produce the documented
+ * server-unavailable error (exit code 4).
+ */
+export declare const attachOrUnavailable: (command: string, projectPath: string) => Promise<AttachedServer | CliCommandResult>;
+export declare const isAttached: (value: AttachedServer | CliCommandResult) => value is AttachedServer;
+/** Map a non-2xx server response onto the operation-failed envelope. */
+export declare const serverErrorResult: (command: string, status: number, body: unknown) => CliCommandResult;
+/** Map a transport-level failure onto the server-unavailable envelope. */
+export declare const transportErrorResult: (command: string, error: unknown) => CliCommandResult;
+//# sourceMappingURL=shared.d.ts.map

package/dist/cli/commands/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/shared.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9D,wDAAwD;AACxD,eAAO,MAAM,gBAAgB,EAAE,QAS9B,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,MAAM,QAAQ,KAAG,QAG/C,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,SAAS,MAAM,EACf,MAAM,MAAM,EAAE,EACd,OAAM,QAAa,EACnB,MAAK,MAAM,CAAC,UAAwB,KACnC,cAAc,GAAG,gBA+BnB,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,OAAO,cAAc,GAAG,gBAAgB,KACvC,KAAK,IAAI,gBAAuC,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,SAAS,MAAM,EACf,aAAa,MAAM,KAClB,OAAO,CAAC,cAAc,GAAG,gBAAgB,CAU3C,CAAC;AAEF,eAAO,MAAM,UAAU,GACrB,OAAO,cAAc,GAAG,gBAAgB,KACvC,KAAK,IAAI,cAAoC,CAAC;AAEjD,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,EACf,QAAQ,MAAM,EACd,MAAM,OAAO,KACZ,gBAMF,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,oBAAoB,GAC/B,SAAS,MAAM,EACf,OAAO,OAAO,KACb,gBAOA,CAAC"}