rivet-design 0.12.3 → 0.13.0

package/dist/mcp/server.js

@@ -1,2536 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.startMCPServer = exports.createRivetMcp = exports.canReuseExistingProjectVisualEditor = exports.closeDetachedVisualEditorServer = exports.getActiveVisualEditorProjectAction = exports.buildVariantAckFailedResponse = exports.buildVariantManualAckBlockedResponse = exports.ackVariantBridgeLease = exports.ackApplyBridgeLease = exports.createVariantRequestLeaseTracker = exports.buildLeasedVariantResponse = exports.buildStaticPreviewRefineResponse = exports.collectStaticPreviewRefineTargetInstructions = exports.buildApplyChangesResponse = exports.buildNoPendingChangesResponse = exports.leaseAvailableBatchForPoll = exports.resolveLeasePickupRequestId = exports.buildVariantRequestBatchResponse = exports.buildMixedVariantBatchResponse = exports.startParentProcessMonitor = exports.buildVisualEditorWatchAction = exports.configureMcpStdioLogging = void 0;
-const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
-const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
-const v3_1 = require("zod/v3");
-const index_core_1 = require("../index-core");
-const SessionBridgeService_1 = require("../services/SessionBridgeService");
-const server_1 = require("../server");
-const staticStarter_1 = require("../services/staticStarter");
-const TelemetryService_1 = require("../services/TelemetryService");
-const AuthService_1 = require("../services/AuthService");
-const IntegrationsClient_1 = require("../services/IntegrationsClient");
-const tools_1 = require("./auth/tools");
-const toolAnalytics_1 = require("./toolAnalytics");
-const tools_2 = require("./integrations/tools");
-const instructions_1 = require("./instructions");
-const ConfigManager_1 = require("../services/ConfigManager");
-const MCPOnboardingTelemetry_1 = require("../services/MCPOnboardingTelemetry");
-const open_1 = __importDefault(require("open"));
-const index_1 = require("../index");
-const evaluateFlags_1 = require("../config/evaluateFlags");
-const skillWriter_1 = require("../utils/skillWriter");
-const portUtils_1 = require("../utils/portUtils");
-const harnesses_1 = require("../install/harnesses");
-const agent_variants_1 = require("./agent-variants");
-const child_process_1 = require("child_process");
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const util_1 = require("util");
-const devServerCommand_1 = require("../utils/devServerCommand");
-const StaticPreviewServer_1 = require("../services/StaticPreviewServer");
-const staticProjectTarget_1 = require("../services/staticProjectTarget");
-const createAgentVariantsOrchestrator_1 = require("../services/createAgentVariantsOrchestrator");
-const changeBatchClassification_1 = require("./changeBatchClassification");
-const log = (0, index_core_1.createLogger)('MCPServer');
-const execAsync = (0, util_1.promisify)(child_process_1.exec);
-/**
- * @effect Routes stdio MCP diagnostics to stderr before applying the requested log level.
- */
-const configureMcpStdioLogging = (deps = {
-    env: process.env,
-    redirectLogs: index_core_1.redirectLogsToStderr,
-    setLevel: index_core_1.setLogLevel,
-}) => {
-    deps.redirectLogs();
-    deps.setLevel(deps.env.RIVET_LOG_LEVEL ?? 'SILENT');
-};
-exports.configureMcpStdioLogging = configureMcpStdioLogging;
-/** Poll until the port responds to HTTP or the timeout is reached. */
-async function waitForPort(port, host, timeoutMs = 60_000) {
-    const deadline = Date.now() + timeoutMs;
-    while (Date.now() < deadline) {
-        try {
-            await fetch(`http://${host}:${port}`, {
-                signal: AbortSignal.timeout(1000),
-            });
-            return true;
-        }
-        catch {
-            await new Promise((r) => setTimeout(r, 500));
-        }
-    }
-    return false;
-}
-/** Stop a spawned process with graceful SIGTERM and SIGKILL fallback. */
-async function stopChildProcess(child, timeoutMs = DEV_SERVER_STOP_TIMEOUT_MS) {
-    if (child.killed || child.exitCode !== null || child.pid == null) {
-        return;
-    }
-    const waitForExit = new Promise((resolve) => {
-        const onExit = () => {
-            child.off('exit', onExit);
-            child.off('error', onExit);
-            resolve();
-        };
-        child.once('exit', onExit);
-        child.once('error', onExit);
-    });
-    try {
-        child.kill('SIGTERM');
-    }
-    catch {
-        // no-op; fallback still runs below if process persists
-    }
-    const timedOut = await Promise.race([
-        waitForExit.then(() => false),
-        new Promise((resolve) => setTimeout(() => resolve(true), timeoutMs)),
-    ]);
-    if (!timedOut) {
-        return;
-    }
-    try {
-        child.kill('SIGKILL');
-    }
-    catch {
-        // best effort
-    }
-    await waitForExit;
-}
-/** Builds the required host-agent action that keeps a visual editor session listening. */
-const buildVisualEditorWatchAction = (sessionId, timing = 'immediate') => ({
-    tool: 'watch_for_changes',
-    arguments: { sessionId },
-    required: true,
-    timing,
-    loopUntil: 'close_visual_editor',
-    onTimeout: 'call_again',
-    afterHandlingChanges: 'call_again',
-});
-exports.buildVisualEditorWatchAction = buildVisualEditorWatchAction;
-const DEV_SERVER_STOP_TIMEOUT_MS = 5000;
-const PARENT_PROCESS_MONITOR_INTERVAL_MS = 2000;
-const SUPERSEDED_CHANGES_MESSAGE = 'Queued changes were superseded by newer user input. Call watch_for_changes again.';
-/**
- * Watches for MCP clients disappearing without closing stdio cleanly.
- * A parent PID transition to init means the original client process is gone
- * while the Express server can still keep the event loop alive.
- */
-const startParentProcessMonitor = (params) => {
-    const getParentPid = params.getParentPid ?? (() => process.ppid);
-    const exitProcess = params.exitProcess ?? ((code) => process.exit(code));
-    let previousParentPid = getParentPid();
-    const interval = setInterval(() => {
-        const currentParentPid = getParentPid();
-        const isReparentedToInit = previousParentPid !== 1 && currentParentPid === 1;
-        previousParentPid = currentParentPid;
-        if (!isReparentedToInit) {
-            return;
-        }
-        clearInterval(interval);
-        params.onOrphaned().then(() => exitProcess(0), () => exitProcess(1));
-    }, params.intervalMs ?? PARENT_PROCESS_MONITOR_INTERVAL_MS);
-    interval.unref();
-    return () => clearInterval(interval);
-};
-exports.startParentProcessMonitor = startParentProcessMonitor;
-function normalizeFilesystemPath(inputPath) {
-    if (!inputPath) {
-        return '';
-    }
-    const resolvedPath = path_1.default.resolve(inputPath);
-    try {
-        return fs_1.default.realpathSync(resolvedPath);
-    }
-    catch {
-        return resolvedPath;
-    }
-}
-function pathsMatchExactly(pathA, pathB) {
-    if (!pathA || !pathB) {
-        return false;
-    }
-    return pathA === pathB;
-}
-async function getListeningPortPids(port) {
-    try {
-        const { stdout } = await execAsync(`lsof -nP -iTCP:${port} -sTCP:LISTEN -Fp`);
-        const pids = stdout
-            .split('\n')
-            .map((line) => line.trim())
-            .filter((line) => line.startsWith('p'))
-            .map((line) => parseInt(line.slice(1), 10))
-            .filter((pid) => Number.isInteger(pid) && pid > 0);
-        return [...new Set(pids)];
-    }
-    catch {
-        return [];
-    }
-}
-async function getProcessCwd(pid) {
-    if (!Number.isInteger(pid) || pid <= 0) {
-        return null;
-    }
-    try {
-        const { stdout } = await execAsync(`lsof -a -p ${pid} -d cwd -Fn`);
-        const cwdLine = stdout
-            .split('\n')
-            .map((line) => line.trim())
-            .find((line) => line.startsWith('n'));
-        if (!cwdLine) {
-            return null;
-        }
-        return cwdLine.slice(1) || null;
-    }
-    catch {
-        return null;
-    }
-}
-async function isPortOwnedByProject(port, projectPath) {
-    if (!Number.isInteger(port) || port <= 0 || port >= 65536) {
-        return {
-            matches: false,
-            reason: `Invalid port ${port} for project validation.`,
-        };
-    }
-    const normalizedProjectPath = normalizeFilesystemPath(projectPath);
-    if (!normalizedProjectPath) {
-        return {
-            matches: false,
-            reason: 'Project path is invalid for strict server validation.',
-        };
-    }
-    const candidatePids = await getListeningPortPids(port);
-    if (candidatePids.length === 0) {
-        return {
-            matches: false,
-            reason: `No listening process found on localhost:${port}.`,
-        };
-    }
-    const observedProcessPaths = [];
-    for (const pid of candidatePids) {
-        const cwd = await getProcessCwd(pid);
-        const normalizedCwd = normalizeFilesystemPath(cwd);
-        if (!normalizedCwd) {
-            observedProcessPaths.push(`${pid}:<unknown_cwd>`);
-            continue;
-        }
-        observedProcessPaths.push(`${pid}:${normalizedCwd}`);
-        if (pathsMatchExactly(normalizedProjectPath, normalizedCwd)) {
-            return {
-                matches: true,
-                reason: `Process ${pid} is running from ${normalizedCwd}.`,
-            };
-        }
-    }
-    return {
-        matches: false,
-        reason: `A server is listening on localhost:${port}, but process paths do not match the selected project path. selected=${normalizedProjectPath}; observed=${observedProcessPaths.join(', ') || '<none>'}`,
-        selectedProjectPath: normalizedProjectPath,
-        observedProcessPaths,
-    };
-}
-function detectFrameworkFromHtml(html) {
-    const lower = html.toLowerCase();
-    const hasViteClient = lower.includes('/@vite/client');
-    const hasViteMarkers = lower.includes('vite') &&
-        (lower.includes('hmr') || lower.includes('/src/main.'));
-    if (hasViteClient || hasViteMarkers) {
-        return 'vite';
-    }
-    const hasNextAssets = lower.includes('/_next/');
-    const hasNextMarkers = lower.includes('__next_data__') || lower.includes('next-route-announcer');
-    if (hasNextAssets || hasNextMarkers) {
-        return 'nextjs';
-    }
-    return 'unknown';
-}
-function normalizeExpectedFramework(framework) {
-    if (!framework)
-        return 'unknown';
-    const lower = framework.toLowerCase();
-    if (lower.includes('vite'))
-        return 'vite';
-    if (lower.includes('next'))
-        return 'nextjs';
-    return 'unknown';
-}
-function isFrameworkCompatible(expected, detected) {
-    if (expected === 'unknown')
-        return true;
-    return expected === detected;
-}
-async function validateProjectServer(options) {
-    const { host, port, framework, projectPath } = options;
-    const signals = [];
-    const isReachable = await waitForPort(port, host, 3000);
-    if (!isReachable) {
-        return {
-            valid: false,
-            reason: `No server is responding on ${host}:${port}.`,
-            detectedFramework: 'unknown',
-            signals,
-        };
-    }
-    signals.push('tcp_reachable');
-    if (projectPath) {
-        const projectMatch = await isPortOwnedByProject(port, projectPath);
-        if (!projectMatch.matches) {
-            return {
-                valid: false,
-                reason: projectMatch.reason,
-                detectedFramework: 'unknown',
-                signals,
-                selectedProjectPath: projectMatch.selectedProjectPath,
-                observedProcessPaths: projectMatch.observedProcessPaths,
-            };
-        }
-        signals.push('path_match');
-    }
-    try {
-        const response = await fetch(`http://${host}:${port}`, {
-            signal: AbortSignal.timeout(3000),
-        });
-        const html = await response.text();
-        const detectedFramework = detectFrameworkFromHtml(html);
-        if (detectedFramework === 'vite') {
-            signals.push('vite_marker');
-        }
-        if (detectedFramework === 'nextjs') {
-            signals.push('next_marker');
-        }
-        const expected = normalizeExpectedFramework(framework);
-        if (!isFrameworkCompatible(expected, detectedFramework)) {
-            return {
-                valid: false,
-                reason: `Expected ${expected}, but detected ${detectedFramework} on ${host}:${port}.`,
-                detectedFramework,
-                signals,
-                statusCode: response.status,
-            };
-        }
-        if (detectedFramework === 'unknown' && expected !== 'unknown') {
-            return {
-                valid: false,
-                reason: 'Server is reachable but did not expose framework markers needed for validation.',
-                detectedFramework,
-                signals,
-                statusCode: response.status,
-            };
-        }
-        return {
-            valid: true,
-            reason: `Validated ${host}:${port} as a project server.`,
-            detectedFramework,
-            signals,
-            statusCode: response.status,
-        };
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        return {
-            valid: false,
-            reason: `HTTP validation failed: ${message}`,
-            detectedFramework: 'unknown',
-            signals,
-        };
-    }
-}
-/**
- * Starts the Rivet MCP server on stdio transport.
- * Called when the user runs `rivet mcp`.
- */
-function getSendButtonLabel(mcpEditor) {
-    return (0, harnesses_1.sendButtonLabelFor)(mcpEditor);
-}
-function trackChangesQueuedFromIntent(intent, bridge, telemetry, sessionId) {
-    const telemetryContext = bridge.getTelemetryContext();
-    telemetry.trackChangesQueued({
-        sessionId,
-        styleChangeCount: intent.changes.filter((c) => c.kind === 'style').length,
-        textChangeCount: intent.changes.filter((c) => c.kind === 'text').length,
-        commentCount: intent.changes.filter((c) => c.kind === 'comment').length,
-        chatCount: intent.changes.filter((c) => c.kind === 'chat').length,
-        round: bridge.getRoundsCompleted(),
-        traceId: intent.traceId,
-        agentRunId: intent.agentRunId,
-        browserSessionId: telemetryContext?.browserSessionId,
-        browserDistinctId: telemetryContext?.browserDistinctId,
-    });
-}
-const trackOrphanedMCPRun = (telemetry, sessionId, orphanedRun) => {
-    telemetry.trackAgentRunFailed({
-        traceId: orphanedRun.traceId,
-        agentRunId: orphanedRun.agentRunId,
-        sessionId,
-        posthogSessionId: orphanedRun.browserSessionId,
-        durationMs: Date.now() - orphanedRun.startedAt,
-        errorType: 'mcp_run_replaced',
-        errorMessage: 'A new MCP apply run started before the previous run completed',
-        source: 'mcp',
-    });
-};
-const APPLY_GUIDE = 'Read each file in sourceFiles, then apply every change in the changes array. ' +
-    'style: find the element by className/xpath and update the CSS property from "from" to "to". ' +
-    'text: find the element and replace the text content. ' +
-    'comment: interpret the instruction using the element context and apply appropriate code changes. ' +
-    'chat: interpret the free-text instruction in the "instruction" field and apply appropriate code changes across any file in the project. ' +
-    'variant: a user-picked variant from the agent-variants flow. ' +
-    'Variant protocol reminder: source_research (if present) -> report_source_context -> brief approval -> generation -> user commit. ' +
-    "variant.payload.kind=diff-applied: the server has already `git apply`d the unified diff to the user's working tree (uncommitted). DO NOT re-apply — acknowledge the variant and let the user review. " +
-    'variant.payload.kind=diff (legacy): apply the unified diff in payload.diff against the project root via `git apply` (no manual edits). ' +
-    'variant.payload.kind=project-created: the project has already been materialized at destinationPath and git-committed by the server. Optionally run `npm install` in destinationPath and continue from there — no further file operations are required for the pick itself. ' +
-    'For elements with empty filePaths, search the codebase by className or xpath. ' +
-    'If a change has imageCount > 0, the corresponding reference images appear as image content items immediately following this text in the tool result — view them before making changes. ' +
-    "IMPORTANT — variantRequest branch: if a comment item carries `variantRequest: { count }`, do NOT edit any files. Instead, derive `target` from the comment's `element` using this priority: " +
-    '(a) prefer `{ type: "file", ref: filePaths[0] }` when `filePaths.length === 1`; otherwise ' +
-    '(b) `rivetId` → `{ type: "element", ref: \'[data-rivet-id="<rivetId>"]\' }`, then ' +
-    '(c) `id` (no whitespace) → `{ type: "element", ref: "#<id>" }`, then ' +
-    '(d) `xpath` → `{ type: "element", ref: "<xpath>" }`, then ' +
-    '(e) single-token `className` → `{ type: "element", ref: ".<token>" }`. ' +
-    'If the comment has imageCount > 0, inspect the following image content items before calling `start_variants`; pass each image through `userContext` as `{ transport: "upload", dataUrl, label: "Reference image N", userIntent: "Inline variant visual reference" }` when your client exposes a data URL, or pass concise visual observations as `{ transport: "text", content, label: "Reference image observations", userIntent: "Inline variant visual reference" }` when it does not. ' +
-    'Then call `start_variants` with `{ mode: "existing", prompt: instruction, count: variantRequest.count, target, userContext }`. `start_variants` is the single kickoff call. `start_variants` returns leased work items; generate each variant in its worktree, call `report_work_item({ kind: "status", ... })` for each leased item, then wait for the user to pick and call `commit_variant`. ' +
-    'CRITICAL WORKFLOW: 1. Call get_pending_changes with a message sharing your brief plan. 2. Edit the files. 3. Call get_pending_changes with a message summarizing what you changed and refresh_git: true so the Rivet UI updates. 4. STOP and let the user know their changes have been applied.';
-/**
- * Prefix added to the apply guide when a batch targets a specific variant. The
- * variant's sources live in an isolated worktree, so all edits must happen
- * there (not the base project) for the change to land on the right variant.
- * The reference suffix is appended when any comment in the batch carries
- * `resolvedReferences` so the agent knows to consult those directories as
- * read-only context.
- */
-const buildApplyGuide = (worktreePath, hasReferences) => {
-    const targetPrefix = worktreePath
-        ? `These changes target a specific variant whose sources live in an isolated git worktree at \`${worktreePath}\`. Treat that worktree as the project root: read and edit files relative to it, and run git/refresh commands inside it. Do NOT edit the base project for this batch. `
-        : '';
-    const referenceSuffix = hasReferences
-        ? ' Some comments include `resolvedReferences` — each entry is a label, optional brief, and a directory path pointing to another variant\'s source. The user attached these as @-mention context; treat them as read-only and inspect with your Read/Grep tools as needed (do NOT edit files inside those paths). Use them to ground "make this more like X" style requests.'
-        : '';
-    return `${targetPrefix}${APPLY_GUIDE}${referenceSuffix}`;
-};
-const requestHasResolvedReferences = (request) => request.changes.some((c) => c.kind === 'comment' &&
-    Array.isArray(c.resolvedReferences) &&
-    c.resolvedReferences.length > 0);
-const VARIANT_REQUEST_GUIDE = 'This batch is a Rivet variant request — do NOT edit files directly. ' +
-    'The pending change is a single CommentChangeItem; `variantRequest.count` is only the editor\'s default placeholder count — YOU own the real number. Decide how many directions to generate from the user\'s `instruction` text — honor an explicit number ("give me 5"), a relative ask ("more options"), or a qualitative cue ("lots of variety"); default to 3 only when the instruction gives no count signal. ' +
-    "Derive the structured `start_variants.target` from the comment's `element` using this priority: " +
-    '(a) `{ type: "file", ref: filePaths[0] }` when `filePaths.length === 1`; otherwise ' +
-    '(b) `{ type: "element", ref: `[data-rivet-id="${rivetId}"]` }` when `rivetId` is present, then ' +
-    '(c) `{ type: "element", ref: `#${id}` }` when `id` has no whitespace, then ' +
-    '(d) `{ type: "element", ref: xpath }`, then ' +
-    '(e) `{ type: "element", ref: `.${token}` }` for a single-token `className`. ' +
-    "When you set a `target` from the comment's `element`, scope each variant's change to THAT element and its immediate section/card — do not restyle the rest of the page. " +
-    'If the comment has imageCount > 0, inspect the following image content items before calling `start_variants`; pass each image through `userContext` as `{ transport: "upload", dataUrl, label: "Reference image N", userIntent: "Inline variant visual reference" }` when your client exposes a data URL, or pass concise visual observations as `{ transport: "text", content, label: "Reference image observations", userIntent: "Inline variant visual reference" }` when it does not. ' +
-    'Then call `start_variants` with `{ mode: "existing", prompt: instruction, projectPath, target, userContext, requestId, briefs }`, passing this batch\'s `projectPath` and `requestId` through verbatim so the run stays attached to the visual editor project and the editor can map its loading placeholders to the new cards. Set the count by supplying `briefs` (one distinct `{ label, body }` per variant — `briefs.length` is the count, and each card is named by what it changes); the editor seeds a few placeholders and reconciles to however many you actually generate. `start_variants` is the single kickoff call. ' +
-    'ACCUMULATION: when a variants session is already live for this project, calling `start_variants` again does NOT discard it — Rivet APPENDS the new directions to that same active session (they show up alongside the existing ones), so just call `start_variants` per Vary; never try to reuse a prior sessionId or worry about orphaning earlier variants. ' +
-    '`start_variants` returns leased work items; generate each variant in its worktree and call `report_work_item({ kind: "status", ... })` for each leased item. ' +
-    'After the user picks a variant via `commit_variant`, STOP and tell the user their variant has been committed.';
-const VARIANT_MIXED_BATCH_GUIDE = 'Mixed batch rejected: a `variantRequest` comment must be the only item in its batch. ' +
-    'Ask the user to send the variant request on its own (clear other pending changes first) and retry.';
-// Shared preamble for both static-preview refine guides (fork vs in-place).
-// Keeps the STATIC_PREVIEW_REFINE_GUIDE marker, the lease call, and the
-// targetElement scoping rule consistent across both flows.
-const STATIC_PREVIEW_REFINE_GUIDE_PREAMBLE = 'STATIC_PREVIEW_REFINE_GUIDE: These changes target static_preview variant(s). ' +
-    'Do NOT edit base project files. ' +
-    "Lease ONLY this batch's work items: call `continue_variants({ action: 'request_work', workItemIds: <the response.workItemIds array> })`. " +
-    "Passing workItemIds (rather than a bare requestedLeaseCount) keeps concurrent runs from leasing each other's work, so several batches can be handled in parallel. " +
-    'When input.targetElement is present it is the specific element the user selected (match it in the HTML by tagName/className/id/textContent): ' +
-    'scope the change to THAT element and its immediate section/card — do not restyle the rest of the page. ';
-// "Vary" flow: the server forked N NEW sibling variants; the original is left
-// untouched and each fork gets a synthesized parent+change name.
-const STATIC_PREVIEW_FORK_GUIDE = STATIC_PREVIEW_REFINE_GUIDE_PREAMBLE +
-    'Do NOT overwrite the original variant. ' +
-    'The server has already created the requested number of NEW sibling variants per target — each is a fresh ' +
-    'static_preview work item seeded from the source variant (input.currentHtml) plus your instruction (input.instruction). ' +
-    'For each leased static_preview work item, generate a NEW variation of input.currentHtml that applies input.instruction. ' +
-    'Then call `report_work_item` (kind: "status") with output.html containing the full updated static HTML, ' +
-    'AND a synthesized `title` (≤ 6 words) + one-sentence `description` that combine the parent variant ' +
-    '(input.sourceLabel / input.sourceBody) with the change (input.instruction) — e.g. "Icon grid — red hover". ' +
-    'Each leased item becomes its own new variant card; the original variant is left unchanged.';
-// "Apply" flow: the server created a single in-place refinement work item that
-// UPDATES THE SAME variant — it is NOT a new sibling, so the variant keeps its
-// existing name and no synthesized title/description is reported.
-const STATIC_PREVIEW_INPLACE_REFINE_GUIDE = STATIC_PREVIEW_REFINE_GUIDE_PREAMBLE +
-    'The server has created an IN-PLACE refinement work item that UPDATES THE SAME variant per target — ' +
-    'it is NOT a new sibling. Lease it, then edit input.currentHtml to apply input.instruction, ' +
-    'preserving everything else. ' +
-    'Then call `report_work_item` (kind: "status") with output.html containing the full updated static HTML. ' +
-    'Do NOT pass a new `title`/`description` — the variant keeps its existing name. ' +
-    'The edited HTML replaces the existing variant in place.';
-/**
- * Pick the guide that matches what the server actually did with this batch:
- * a "Vary" target carries a `count` (the server forked N siblings), while a
- * plain "Apply" has no count (the server created one in-place refinement that
- * overwrites the source). A mixed batch falls back to the fork guide, whose
- * lease+report steps still cover the count-bearing targets.
- */
-const selectStaticPreviewRefineGuide = (targetInstructions) => targetInstructions.some(({ count }) => count != null)
-    ? STATIC_PREVIEW_FORK_GUIDE
-    : STATIC_PREVIEW_INPLACE_REFINE_GUIDE;
-const buildLeasePayloadFields = (lease) => ({
-    leaseId: lease.leaseId,
-    requestId: lease.requestId,
-    kind: lease.kind,
-    mergedRequestIds: lease.mergedRequestIds,
-    mergedFrom: lease.mergedFrom,
-});
-const getActiveLeaseMetadata = (bridge) => bridge.getActiveLeaseMetadata();
-const buildSupersededChangesResponse = () => ({
-    content: [
-        {
-            type: 'text',
-            text: JSON.stringify({
-                hasChanges: false,
-                superseded: true,
-                message: SUPERSEDED_CHANGES_MESSAGE,
-            }),
-        },
-    ],
-});
-const buildMixedVariantBatchResponse = (rejectedRequest) => {
-    if (rejectedRequest === undefined) {
-        return buildSupersededChangesResponse();
-    }
-    return {
-        content: [
-            {
-                type: 'text',
-                text: JSON.stringify({
-                    hasChanges: false,
-                    rejected: true,
-                    reason: 'mixed_variant_batch',
-                    message: VARIANT_MIXED_BATCH_GUIDE,
-                }),
-            },
-        ],
-        isError: true,
-    };
-};
-exports.buildMixedVariantBatchResponse = buildMixedVariantBatchResponse;
-const buildVariantRequestBatchResponse = (intent, lease, projectPath) => {
-    if (!intent) {
-        return buildSupersededChangesResponse();
-    }
-    const { changes, imageContent } = (0, changeBatchClassification_1.extractImages)(intent.changes);
-    const requestId = intent.agentRunId ?? intent.traceId;
-    return {
-        content: [
-            {
-                type: 'text',
-                text: JSON.stringify({
-                    hasChanges: true,
-                    kind: 'variant_request',
-                    changes,
-                    sourceFiles: intent.sourceFiles,
-                    ...(projectPath ? { projectPath } : {}),
-                    ...(requestId ? { requestId } : {}),
-                    ...(intent.target ? { target: intent.target } : {}),
-                    ...(lease ? buildLeasePayloadFields(lease) : {}),
-                    applyGuide: VARIANT_REQUEST_GUIDE,
-                }),
-            },
-            ...imageContent,
-        ],
-    };
-};
-exports.buildVariantRequestBatchResponse = buildVariantRequestBatchResponse;
-/**
- * Resolves whether `watch_for_changes` / `get_pending_changes` should pass
- * `requestId` into lease pickup. requestId is only for idempotent re-poll of
- * the same in-flight lease — omit it after ack so FIFO can pick the next batch.
- */
-const resolveLeasePickupRequestId = (args) => args.refresh_git || args.ack_batch ? undefined : args.requestId;
-exports.resolveLeasePickupRequestId = resolveLeasePickupRequestId;
-/**
- * Lease work for a poll. A matching requestId keeps idempotent re-polls on the
- * same in-flight batch; a stale requestId must not strand unrelated queued work.
- */
-const leaseAvailableBatchForPoll = (args) => {
-    if (args.requestId) {
-        const requestedLease = args.bridge.leaseBatch(args.requestId);
-        if (requestedLease) {
-            return requestedLease;
-        }
-    }
-    return args.bridge.leaseBatch();
-};
-exports.leaseAvailableBatchForPoll = leaseAvailableBatchForPoll;
-/**
- * Builds a poll response for an empty apply queue.
- */
-const buildNoPendingChangesResponse = (params = {}) => ({
-    content: [
-        {
-            type: 'text',
-            text: JSON.stringify({
-                hasChanges: false,
-                ...(params.message ? { message: params.message } : {}),
-                ...(params.devServerHealth !== undefined
-                    ? { devServerHealth: params.devServerHealth }
-                    : {}),
-                ...(params.pendingVariantRequests !== undefined
-                    ? { pendingVariantRequests: params.pendingVariantRequests }
-                    : {}),
-                ...(params.activeLeases !== undefined
-                    ? { activeLeases: params.activeLeases }
-                    : {}),
-            }),
-        },
-    ],
-});
-exports.buildNoPendingChangesResponse = buildNoPendingChangesResponse;
-/**
- * Builds a poll response for a normal apply batch.
- */
-const buildApplyChangesResponse = (params) => {
-    const { changes, imageContent } = (0, changeBatchClassification_1.extractImages)(params.intent.changes);
-    return {
-        content: [
-            {
-                type: 'text',
-                text: JSON.stringify({
-                    hasChanges: true,
-                    kind: 'apply',
-                    changes,
-                    sourceFiles: params.intent.sourceFiles,
-                    ...(params.intent.target ? { target: params.intent.target } : {}),
-                    ...(params.intent.worktreePath
-                        ? { worktreePath: params.intent.worktreePath }
-                        : {}),
-                    ...(params.lease ? buildLeasePayloadFields(params.lease) : {}),
-                    applyGuide: buildApplyGuide(params.intent.worktreePath, requestHasResolvedReferences(params.intent)),
-                    ...(params.pendingVariantRequests !== undefined
-                        ? { pendingVariantRequests: params.pendingVariantRequests }
-                        : {}),
-                }),
-            },
-            ...imageContent,
-        ],
-    };
-};
-exports.buildApplyChangesResponse = buildApplyChangesResponse;
-const staticPreviewTargetKey = (target) => `${target.sessionId}:${target.variantId}`;
-const getCommentStaticPreviewTarget = (comment, fallbackTarget) => comment.staticPreviewTarget ?? fallbackTarget;
-const collectStaticPreviewRefineTargetInstructions = (request) => {
-    const groups = new Map();
-    // Per-request correlation id: each Vary/Apply is dispatched as its own batch,
-    // so the batch's agentRunId (or traceId) uniquely identifies this UI request.
-    const requestId = request.agentRunId ?? request.traceId;
-    for (const change of request.changes) {
-        if (change.kind !== 'comment')
-            continue;
-        const target = getCommentStaticPreviewTarget(change, request.staticPreviewTarget);
-        if (!target)
-            continue;
-        const key = staticPreviewTargetKey(target);
-        const count = change.variantRequest?.count;
-        const existing = groups.get(key);
-        if (existing) {
-            existing.instruction = `${existing.instruction}\n\n${change.instruction}`;
-            if (count != null) {
-                existing.count = Math.max(existing.count ?? 0, count);
-            }
-            existing.element = existing.element ?? change.element;
-        }
-        else {
-            groups.set(key, {
-                target,
-                instruction: change.instruction,
-                ...(count != null ? { count } : {}),
-                element: change.element,
-                ...(requestId ? { requestId } : {}),
-            });
-        }
-    }
-    return [...groups.values()];
-};
-exports.collectStaticPreviewRefineTargetInstructions = collectStaticPreviewRefineTargetInstructions;
-const buildStaticPreviewRefineResponse = (consumedRequest, droppedRefinements = [], createdWorkItemIds = [], lease) => {
-    if (!consumedRequest) {
-        return buildSupersededChangesResponse();
-    }
-    const { changes, imageContent } = (0, changeBatchClassification_1.extractImages)(consumedRequest.changes);
-    const targetInstructions = (0, exports.collectStaticPreviewRefineTargetInstructions)(consumedRequest);
-    const staticPreviewTargets = targetInstructions.map(({ target }) => target);
-    return {
-        content: [
-            {
-                type: 'text',
-                text: JSON.stringify({
-                    hasChanges: true,
-                    kind: 'static_preview_refine',
-                    changes,
-                    sourceFiles: consumedRequest.sourceFiles,
-                    staticPreviewTarget: consumedRequest.staticPreviewTarget,
-                    staticPreviewTargets,
-                    ...(lease ? buildLeasePayloadFields(lease) : {}),
-                    applyGuide: selectStaticPreviewRefineGuide(targetInstructions),
-                    // The exact work items THIS batch created. Lease ONLY these (pass them
-                    // as `workItemIds` to request_work) so concurrent runs each pick up
-                    // their own batch instead of one greedily leasing everything.
-                    ...(createdWorkItemIds.length > 0
-                        ? { workItemIds: createdWorkItemIds }
-                        : {}),
-                    // In-place refinements the server could not apply (the variant was
-                    // already sent / no longer editable). Surfaced structurally so the
-                    // agent knows the instruction was NOT applied, instead of the poll
-                    // throwing and losing the already-consumed batch.
-                    ...(droppedRefinements.length > 0
-                        ? { rejectedRefinements: droppedRefinements }
-                        : {}),
-                }),
-            },
-            ...imageContent,
-        ],
-    };
-};
-exports.buildStaticPreviewRefineResponse = buildStaticPreviewRefineResponse;
-/**
- * Build the MCP response for a leased variant batch.
- */
-const buildLeasedVariantResponse = (params) => {
-    const intent = params.lease.intent;
-    if (params.isFreshStaticPreviewVariantRequestBatch(intent)) {
-        return params.withPendingVariantRequests(params.handleStaticPreviewRefineBatch(intent, params.lease));
-    }
-    if ((0, changeBatchClassification_1.isSingleVariantRequestBatch)(intent)) {
-        return params.withPendingVariantRequests((0, exports.buildVariantRequestBatchResponse)(intent, params.lease, params.projectPath));
-    }
-    if ((0, changeBatchClassification_1.isStaticPreviewRefineBatch)(intent)) {
-        return params.withPendingVariantRequests(params.handleStaticPreviewRefineBatch(intent, params.lease));
-    }
-    return params.withPendingVariantRequests((0, exports.buildVariantRequestBatchResponse)(intent, params.lease, params.projectPath));
-};
-exports.buildLeasedVariantResponse = buildLeasedVariantResponse;
-const FINISHED_VARIANT_REPORT_STATUSES = new Set([
-    'succeeded',
-    'failed',
-    'cancelled',
-]);
-const variantRequestWorkKey = (sessionId, workItemId) => `${sessionId}:${workItemId}`;
-/**
- * Tracks a UI-originated variant request lease across the variant work items
- * that satisfy it, releasing the bridge lease once the whole batch has
- * finished.
- */
-const createVariantRequestLeaseTracker = (params) => {
-    const trackedByWorkItem = new Map();
-    const trackedByRequest = new Map();
-    const finishedVariantWorkByRequest = new Map();
-    const markGeneratedWorkFinished = (lease) => {
-        finishedVariantWorkByRequest.set(lease.requestId, lease.leaseId);
-    };
-    const hasFinishedGeneratedWork = (lease) => finishedVariantWorkByRequest.get(lease.requestId) === lease.leaseId;
-    const findTrackedLease = (args) => {
-        if (args.requestId) {
-            const tracked = trackedByRequest.get(args.requestId);
-            if (tracked) {
-                return tracked;
-            }
-        }
-        if (args.leaseId) {
-            for (const tracked of trackedByRequest.values()) {
-                if (tracked.leaseId === args.leaseId) {
-                    return tracked;
-                }
-            }
-        }
-        return null;
-    };
-    const findActiveVariantLease = (args) => {
-        const activeLeases = params.activeVariantLeases?.() ?? [];
-        return (activeLeases.find((lease) => {
-            if (lease.kind !== 'variant') {
-                return false;
-            }
-            if (args.leaseId && lease.leaseId === args.leaseId) {
-                return true;
-            }
-            return Boolean(args.requestId && lease.requestId === args.requestId);
-        }) ?? null);
-    };
-    return {
-        claim(args) {
-            if (!args.requestId) {
-                return;
-            }
-            const lease = params.leaseRequest(args.requestId);
-            if (!lease || lease.kind !== 'variant') {
-                return;
-            }
-            if (args.workItemIds.length === 0) {
-                if (trackedByRequest.has(lease.requestId)) {
-                    return;
-                }
-                markGeneratedWorkFinished(lease);
-                params.ackRequest({
-                    leaseId: lease.leaseId,
-                    requestId: lease.requestId,
-                });
-                return;
-            }
-            finishedVariantWorkByRequest.delete(lease.requestId);
-            const tracked = trackedByRequest.get(lease.requestId) ??
-                {
-                    leaseId: lease.leaseId,
-                    requestId: lease.requestId,
-                    remainingWorkItemIds: new Set(),
-                };
-            trackedByRequest.set(lease.requestId, tracked);
-            for (const workItemId of args.workItemIds) {
-                tracked.remainingWorkItemIds.add(workItemId);
-                trackedByWorkItem.set(variantRequestWorkKey(args.sessionId, workItemId), tracked);
-            }
-        },
-        complete(args) {
-            if (args.requeuedForRegeneration ||
-                (!args.aborted && !FINISHED_VARIANT_REPORT_STATUSES.has(args.status))) {
-                return;
-            }
-            const key = variantRequestWorkKey(args.sessionId, args.workItemId);
-            const tracked = trackedByWorkItem.get(key);
-            if (!tracked) {
-                return;
-            }
-            tracked.remainingWorkItemIds.delete(args.workItemId);
-            trackedByWorkItem.delete(key);
-            if (tracked.remainingWorkItemIds.size > 0) {
-                return;
-            }
-            trackedByRequest.delete(tracked.requestId);
-            markGeneratedWorkFinished(tracked);
-            params.ackRequest({
-                leaseId: tracked.leaseId,
-                requestId: tracked.requestId,
-            });
-        },
-        getManualAckBlock(args) {
-            const tracked = findTrackedLease(args);
-            if (!tracked || tracked.remainingWorkItemIds.size === 0) {
-                const activeLease = findActiveVariantLease(args);
-                if (!activeLease) {
-                    return null;
-                }
-                if (hasFinishedGeneratedWork(activeLease)) {
-                    return null;
-                }
-                return {
-                    reason: 'variant_work_unclaimed',
-                    leaseId: activeLease.leaseId,
-                    requestId: activeLease.requestId,
-                    remainingWorkItemIds: [],
-                };
-            }
-            return {
-                reason: 'variant_work_unfinished',
-                leaseId: tracked.leaseId,
-                requestId: tracked.requestId,
-                remainingWorkItemIds: [...tracked.remainingWorkItemIds],
-            };
-        },
-    };
-};
-exports.createVariantRequestLeaseTracker = createVariantRequestLeaseTracker;
-const ackApplyBridgeLease = (args) => {
-    const ackResult = args.bridge.ackBatch({
-        leaseId: args.leaseId,
-        requestId: args.requestId,
-    });
-    if (ackResult.kind === 'apply' && ackResult.mergedRequestIds.length > 0) {
-        args.telemetry.trackMCPChangeAcked({
-            channel: 'apply',
-            leaseId: args.leaseId,
-            requestId: args.requestId ?? ackResult.mergedRequestIds[0],
-            changeCount: ackResult.mergedRequestIds.length,
-            sessionId: args.sessionId,
-        });
-        return;
-    }
-    args.telemetry.trackMCPChangeAckFailed({
-        channel: 'apply',
-        leaseId: args.leaseId,
-        requestId: args.requestId,
-        changeCount: 0,
-        sessionId: args.sessionId,
-        failureReason: 'ack_failed',
-    });
-};
-exports.ackApplyBridgeLease = ackApplyBridgeLease;
-const ackVariantBridgeLease = (args) => {
-    if (!args.leaseId) {
-        return {
-            ok: false,
-            reason: 'missing_lease_id',
-            requestId: args.requestId,
-        };
-    }
-    const ackResult = args.bridge.ackBatch({
-        leaseId: args.leaseId,
-        requestId: args.requestId,
-    });
-    const sessionId = args.bridge.getSessionId() ?? undefined;
-    if (ackResult.kind === 'variant' && ackResult.mergedRequestIds.length > 0) {
-        args.telemetry.trackMCPChangeAcked({
-            channel: 'variant',
-            leaseId: args.leaseId,
-            requestId: args.requestId ?? ackResult.mergedRequestIds[0],
-            changeCount: ackResult.mergedRequestIds.length,
-            sessionId,
-        });
-        return {
-            ok: true,
-            leaseId: args.leaseId,
-            requestId: args.requestId ?? ackResult.mergedRequestIds[0],
-            changeCount: ackResult.mergedRequestIds.length,
-        };
-    }
-    args.telemetry.trackMCPChangeAckFailed({
-        channel: 'variant',
-        leaseId: args.leaseId,
-        requestId: args.requestId,
-        changeCount: 0,
-        sessionId,
-        failureReason: 'ack_failed',
-    });
-    return {
-        ok: false,
-        reason: 'ack_failed',
-        leaseId: args.leaseId,
-        requestId: args.requestId,
-    };
-};
-exports.ackVariantBridgeLease = ackVariantBridgeLease;
-/** Builds the MCP error returned when generated variant work still owns a lease. */
-const buildVariantManualAckBlockedResponse = (block) => ({
-    content: [
-        {
-            type: 'text',
-            text: JSON.stringify({
-                error: 'variant_ack_blocked',
-                reason: block.reason,
-                message: block.reason === 'variant_work_unfinished'
-                    ? 'This variant request still has unfinished generated work. Finish it with report_work_item; do not use ack_batch to skip or finish generated variant work.'
-                    : 'This UI variant request has an active lease, but generated work has not claimed it yet. Process it through start_variants or scoped continue_variants({ action: "request_work", workItemIds }) and finish with report_work_item; do not use ack_batch to skip variant work.',
-                leaseId: block.leaseId,
-                requestId: block.requestId,
-                remainingWorkItemIds: block.remainingWorkItemIds,
-            }),
-        },
-    ],
-    isError: true,
-});
-exports.buildVariantManualAckBlockedResponse = buildVariantManualAckBlockedResponse;
-/** Builds the MCP error returned when ack_batch does not match an active variant lease. */
-const buildVariantAckFailedResponse = (result) => ({
-    content: [
-        {
-            type: 'text',
-            text: JSON.stringify({
-                error: 'variant_ack_failed',
-                reason: result.reason,
-                message: result.reason === 'missing_lease_id'
-                    ? 'ack_batch requires the leaseId from the variant batch.'
-                    : 'No active variant lease matched this ack_batch request.',
-                ...(result.leaseId ? { leaseId: result.leaseId } : {}),
-                ...(result.requestId ? { requestId: result.requestId } : {}),
-            }),
-        },
-    ],
-    isError: true,
-});
-exports.buildVariantAckFailedResponse = buildVariantAckFailedResponse;
-/**
- * Chooses how an active visual editor session should handle a project change.
- */
-const getActiveVisualEditorProjectAction = (args) => {
-    if (args.activeProjectPath === args.requestedProjectPath) {
-        return 'attach';
-    }
-    if (args.devServerOwnership === 'none') {
-        return 'rebind';
-    }
-    return 'restart';
-};
-exports.getActiveVisualEditorProjectAction = getActiveVisualEditorProjectAction;
-/**
- * Closes a Rivet server handle that is no longer attached to a bridge session.
- */
-const closeDetachedVisualEditorServer = async (args) => {
-    if (!args.serverHandle || args.isBridgeActive) {
-        return false;
-    }
-    await args.cleanup();
-    return true;
-};
-exports.closeDetachedVisualEditorServer = closeDetachedVisualEditorServer;
-/**
- * Existing-project variants need a mounted upstream for the Original preview.
- */
-const canReuseExistingProjectVisualEditor = (args) => Boolean(args.attachment && args.devServerOwnership !== 'none');
-exports.canReuseExistingProjectVisualEditor = canReuseExistingProjectVisualEditor;
-/**
- * Builds the fully configured Rivet MCP server (tools, auth gating, session
- * bridge, telemetry) without binding it to a transport. Shared by the stdio
- * and streamable-HTTP entry points. By default it registers process-level
- * signal handlers for stdio cleanup; HTTP hosts own shutdown externally.
- */
-const createRivetMcp = (options) => {
-    const { mcpEditor, revokeBearerToken } = options ?? {};
-    const shouldRegisterProcessHandlers = options?.registerProcessHandlers ?? true;
-    const sendButtonLabel = getSendButtonLabel(mcpEditor);
-    const bridge = new SessionBridgeService_1.SessionBridgeService();
-    const telemetry = new TelemetryService_1.TelemetryService({
-        enabled: true,
-        source: 'mcp',
-        editor: mcpEditor,
-    });
-    const authService = new AuthService_1.AuthService();
-    const integrationsClient = new IntegrationsClient_1.IntegrationsClient({ authService });
-    const requireAuth = (0, tools_1.createAuthGuard)(authService);
-    // Agent-driven variants orchestrator. Long-lived singleton: state machine +
-    // worktree lifecycle for any variants session, surfaced via the 5 MCP tools
-    // (registered below near mcp.connect) and the /api/variants Express routes
-    // (mounted by startServer when this orchestrator is passed in).
-    const agentVariantsOrchestrator = (0, createAgentVariantsOrchestrator_1.createAgentVariantsOrchestrator)({
-        bridge,
-        telemetry,
-    });
-    // `agent_variants.*` events also fire from the MCP tool handlers (not just the
-    // orchestrator), so share the same session-replay-linking wrapper with the
-    // tools registration below. The factory wraps the orchestrator's copy itself.
-    const variantsTelemetry = (0, createAgentVariantsOrchestrator_1.withVariantsSessionReplayLinking)(telemetry, bridge);
-    /**
-     * Resolve a variants sessionId to its projectContext kind, swallowing the
-     * `SESSION_NOT_FOUND` throw for unknown/expired sessions so classification can
-     * fall back to the default path.
-     */
-    const resolveSessionKind = (sessionId) => {
-        try {
-            return agentVariantsOrchestrator.getProjectContext(sessionId).kind;
-        }
-        catch {
-            return undefined;
-        }
-    };
-    /**
-     * A `variant_request` ("generate N variants") on a FRESH static-preview
-     * variant has no file-backed worktree to code_gen against: the inline preview
-     * HTML is gitignored and never lands in a `git worktree` clone, so the default
-     * `mode:"existing"` guide would send the agent to edit files that don't exist.
-     * Reroute it through the static-preview refine flow, which operates on the
-     * variant's inline HTML.
-     */
-    const isFreshStaticPreviewVariantRequestBatch = (intent) => (0, changeBatchClassification_1.isFreshStaticPreviewVariantRequest)(intent, resolveSessionKind, (sid, vid) => agentVariantsOrchestrator.isStaticPreviewVariant(sid, vid));
-    /**
-     * Kick off static-preview refinement work items for a leased batch.
-     */
-    const handleStaticPreviewRefineBatch = (intent, lease) => {
-        const consumedRequest = (0, changeBatchClassification_1.withDerivedStaticPreviewTargets)(intent);
-        let droppedRefinements = [];
-        let createdWorkItemIds = [];
-        if (consumedRequest) {
-            const targetInstructions = (0, exports.collectStaticPreviewRefineTargetInstructions)(consumedRequest);
-            const sessionId = targetInstructions[0]?.target.sessionId;
-            if (sessionId) {
-                ({ droppedRefinements, createdWorkItemIds } =
-                    agentVariantsOrchestrator.beginStaticPreviewRefinements({
-                        sessionId,
-                        targets: targetInstructions.map(({ target, instruction, count, element, requestId }) => ({
-                            variantId: target.variantId,
-                            instruction,
-                            count,
-                            element,
-                            requestId,
-                        })),
-                    }));
-                variantRequestLeaseTracker.claim({
-                    requestId: lease.requestId,
-                    sessionId,
-                    workItemIds: createdWorkItemIds,
-                });
-            }
-        }
-        return (0, exports.buildStaticPreviewRefineResponse)(consumedRequest, droppedRefinements, createdWorkItemIds, lease);
-    };
-    /** Release a variant bridge lease after tracked generated work has finished. */
-    const ackGeneratedVariantBridgeLease = (args) => {
-        const result = (0, exports.ackVariantBridgeLease)({ bridge, telemetry, ...args });
-        if (!result.ok) {
-            log.warn(`Failed to release generated variant bridge lease ${args.leaseId}: ${result.reason}`);
-        }
-    };
-    /** Complete an apply lease and refresh git status in the Rivet UI. */
-    const handleApplyAck = (sessionId, args) => {
-        const leaseId = args.leaseId ?? bridge.findActiveApplyLease()?.leaseId ?? undefined;
-        if (leaseId) {
-            (0, exports.ackApplyBridgeLease)({
-                bridge,
-                telemetry,
-                sessionId,
-                leaseId,
-                requestId: args.requestId,
-            });
-        }
-        handleRefreshGit(sessionId);
-        bridge.setStatus('READY');
-    };
-    /** Release a variant lease after the agent finishes the batch. */
-    const handleVariantAck = (args) => {
-        const manualAckBlock = variantRequestLeaseTracker.getManualAckBlock(args);
-        if (manualAckBlock) {
-            return (0, exports.buildVariantManualAckBlockedResponse)(manualAckBlock);
-        }
-        const result = (0, exports.ackVariantBridgeLease)({ bridge, telemetry, ...args });
-        if (!result.ok) {
-            return (0, exports.buildVariantAckFailedResponse)(result);
-        }
-        return null;
-    };
-    const variantRequestLeaseTracker = (0, exports.createVariantRequestLeaseTracker)({
-        leaseRequest: (requestId) => bridge.leaseBatch(requestId),
-        ackRequest: ackGeneratedVariantBridgeLease,
-        activeVariantLeases: () => getActiveLeaseMetadata(bridge),
-    });
-    /** Complete the active run correlation and refresh git status in the Rivet UI. */
-    const handleRefreshGit = (sessionId) => {
-        const activeRunCorrelation = bridge.completeActiveRunCorrelation();
-        if (activeRunCorrelation) {
-            telemetry.trackAgentRunCompleted({
-                traceId: activeRunCorrelation.traceId,
-                agentRunId: activeRunCorrelation.agentRunId,
-                sessionId,
-                posthogSessionId: activeRunCorrelation.browserSessionId,
-                durationMs: Date.now() - activeRunCorrelation.startedAt,
-                source: 'mcp',
-            });
-        }
-        bridge.reportFeedback('__RIVET_REFRESH_GIT__');
-    };
-    /**
-     * Start tracking an MCP apply run after a batch is leased.
-     */
-    const beginApplyingRun = (intent, sessionId, _lease) => {
-        bridge.setStatus('APPLYING');
-        const { newRun, orphanedRun } = bridge.startApplyingRun(intent);
-        const turnMetadata = (0, MCPOnboardingTelemetry_1.summarizeMCPConversationTurn)(intent, bridge.getRoundsCompleted() + 1, sessionId);
-        trackChangesQueuedFromIntent(intent, bridge, telemetry, sessionId);
-        if (orphanedRun) {
-            trackOrphanedMCPRun(telemetry, sessionId, orphanedRun);
-        }
-        telemetry.trackAgentRunStarted({
-            traceId: newRun.traceId,
-            agentRunId: newRun.agentRunId,
-            instructionLength: turnMetadata.instructionLengthTotal,
-            elementCount: turnMetadata.elementCount,
-            posthogSessionId: newRun.browserSessionId,
-            resumeSessionId: sessionId,
-            source: 'mcp',
-        });
-    };
-    /**
-     * Lease and route the next batch from the unified bridge pipeline.
-     */
-    const leaseAndRouteBatch = (sessionId, requestId) => {
-        while (true) {
-            const applyHead = bridge.getPendingChanges();
-            if (!applyHead || !(0, changeBatchClassification_1.isMixedVariantBatch)(applyHead)) {
-                break;
-            }
-            const rejectedRequest = bridge.rejectMixedVariantRequestBatch(applyHead);
-            return withPendingVariantRequests((0, exports.buildMixedVariantBatchResponse)(rejectedRequest));
-        }
-        const lease = (0, exports.leaseAvailableBatchForPoll)({ bridge, requestId });
-        if (!lease) {
-            return null;
-        }
-        telemetry.trackMCPChangeLeased({
-            channel: lease.kind,
-            leaseId: lease.leaseId,
-            requestId: lease.requestId,
-            changeCount: lease.mergedFrom,
-            sessionId,
-        });
-        if (lease.kind === 'variant') {
-            return (0, exports.buildLeasedVariantResponse)({
-                lease,
-                isFreshStaticPreviewVariantRequestBatch,
-                handleStaticPreviewRefineBatch,
-                withPendingVariantRequests,
-                projectPath: bridge.getProjectPath(),
-            });
-        }
-        beginApplyingRun(lease.intent, sessionId, lease);
-        return (0, exports.buildApplyChangesResponse)({
-            intent: lease.intent,
-            lease,
-            pendingVariantRequests: bridge.pendingVariantRequestCount(),
-        });
-    };
-    /**
-     * Stamp the live variant-request FIFO depth onto a built change response's
-     * first text block as `pendingVariantRequests`. Read from the bridge AFTER
-     * any batch was consumed, so the count reflects how many MORE batches are
-     * still queued (`> 0` ⇒ the agent should keep draining via
-     * watch_for_changes / get_pending_changes). Non-JSON text blocks pass through
-     * unchanged. Mutates and returns the same response object for convenience.
-     */
-    const withPendingVariantRequests = (response) => {
-        const head = response.content[0];
-        if (head?.type !== 'text')
-            return response;
-        try {
-            const parsed = JSON.parse(head.text);
-            parsed.pendingVariantRequests = bridge.pendingVariantRequestCount();
-            head.text = JSON.stringify(parsed);
-        }
-        catch {
-            // Not a JSON payload — leave it untouched.
-        }
-        return response;
-    };
-    // Tailor the sign-in instructions to the user's stored credentials so the
-    // agent is told to sign in up front (rather than after an AUTH_REQUIRED
-    // failure). A synchronous disk read is enough: the presence of an access or
-    // refresh token means the user has signed in before, and the per-tool guard
-    // will silently refresh a stale token; only a total absence means we must
-    // ask the agent to authenticate first.
-    const configManager = (0, ConfigManager_1.getConfigManager)();
-    const hasStoredCredentials = configManager.isAuthenticated() || Boolean(configManager.getRefreshToken());
-    const mcp = new mcp_js_1.McpServer({ name: 'rivet', version: '0.1.0' }, {
-        capabilities: { tools: {} },
-        instructions: (0, instructions_1.buildRivetMcpInstructions)(hasStoredCredentials ? 'authenticated' : 'unauthenticated', { firstRun: !configManager.hasCompletedFirstVariantsRun() }),
-    });
-    const analyticsMcp = (0, toolAnalytics_1.withMCPToolAnalytics)(mcp, {
-        telemetry,
-        getSessionId: () => bridge.getSessionId() ?? undefined,
-        getAuthState: () => configManager.isAuthenticated() || Boolean(configManager.getRefreshToken())
-            ? 'authenticated'
-            : 'unauthenticated',
-        // Once the editor browser connects it reports its PostHog session id via
-        // change-request telemetryContext; carrying it here lets tool-execution
-        // events link to the session replay. Null until the browser first reports.
-        getBrowserSession: () => {
-            const context = bridge.getTelemetryContext();
-            if (!context) {
-                return undefined;
-            }
-            return {
-                browserSessionId: context.browserSessionId,
-                browserDistinctId: context.browserDistinctId,
-            };
-        },
-        mcpEditor,
-    });
-    // Every substantive tool is gated behind login: register them on `guardedMcp`
-    // so an unauthenticated call returns AUTH_REQUIRED instead of running. The
-    // login/logout/auth_status tools register on `analyticsMcp` so they stay
-    // reachable while logged out and still emit tool analytics.
-    const guardedMcp = (0, tools_1.withAuthGuard)(analyticsMcp, requireAuth);
-    // Track the Express server
-    let serverHandle = null;
-    let sessionStartedAt = null;
-    // Track a dev server we auto-started so we can kill it on close
-    let devServerProcess = null;
-    let devServerOwnership = 'none';
-    let devServerHost = null;
-    let devServerPort = null;
-    let rivetServerPort = null;
-    let rivetServerUrl = null;
-    let isCleanupRunning = false;
-    /**
-     * Surfaces a provider connect prompt inside the Rivet editor when a fetch
-     * returns `not_connected`. Deep-links the active editor with `?connect=` so
-     * the "Connect design references" dialog opens over it (see App.tsx). When no
-     * editor is running there is nothing to open; the agent still relays the
-     * not-connected nudge from the tool result. Failures are non-fatal.
-     */
-    const openIntegrationConnectUrl = async (input) => {
-        if (!rivetServerUrl) {
-            return;
-        }
-        const target = new URL(rivetServerUrl);
-        target.searchParams.set('connect', input.provider);
-        await (0, open_1.default)(target.toString());
-    };
-    const updateBridgeHealth = (reason, isReachable) => {
-        bridge.updateDevServerHealth({
-            reason,
-            isReachable,
-            lastCheckedAt: Date.now(),
-        });
-    };
-    const cleanupSessionResources = async (options) => {
-        if (isCleanupRunning) {
-            return { totalRoundsCompleted: 0, sessionId: null };
-        }
-        isCleanupRunning = true;
-        try {
-            const activeSessionId = bridge.getSessionId();
-            const sessionIdToClose = options?.closeSessionId ??
-                (bridge.isActive() && activeSessionId ? activeSessionId : null);
-            const telemetryContext = bridge.getTelemetryContext();
-            const activeRunCorrelation = bridge.completeActiveRunCorrelation();
-            let totalRoundsCompleted = 0;
-            if (sessionIdToClose && bridge.isActive()) {
-                totalRoundsCompleted = bridge.endSession();
-            }
-            if (serverHandle) {
-                try {
-                    await serverHandle.close();
-                }
-                catch (error) {
-                    log.warn('Error stopping Express server:', error);
-                }
-                serverHandle = null;
-            }
-            if (devServerOwnership === 'rivet_owned' && devServerProcess) {
-                try {
-                    await stopChildProcess(devServerProcess);
-                }
-                catch (error) {
-                    log.warn('Error stopping dev server process:', error);
-                }
-            }
-            devServerProcess = null;
-            devServerOwnership = 'none';
-            devServerHost = null;
-            devServerPort = null;
-            rivetServerPort = null;
-            rivetServerUrl = null;
-            updateBridgeHealth('rivet_unreachable', false);
-            const durationMs = sessionStartedAt ? Date.now() - sessionStartedAt : 0;
-            sessionStartedAt = null;
-            if (options?.trackSessionEnd !== false && sessionIdToClose) {
-                telemetry.trackMCPSessionEnd({
-                    sessionId: sessionIdToClose,
-                    rounds: totalRoundsCompleted,
-                    durationMs,
-                    browserSessionId: telemetryContext?.browserSessionId,
-                    browserDistinctId: telemetryContext?.browserDistinctId,
-                });
-                if (activeRunCorrelation) {
-                    telemetry.trackAgentRunFailed({
-                        traceId: activeRunCorrelation.traceId,
-                        agentRunId: activeRunCorrelation.agentRunId,
-                        sessionId: sessionIdToClose,
-                        posthogSessionId: activeRunCorrelation.browserSessionId,
-                        durationMs: Date.now() - activeRunCorrelation.startedAt,
-                        errorType: 'mcp_session_closed',
-                        errorMessage: 'MCP session closed before apply completion confirmation',
-                        source: 'mcp',
-                    });
-                }
-            }
-            await telemetry.flush();
-            return {
-                totalRoundsCompleted,
-                sessionId: sessionIdToClose,
-            };
-        }
-        finally {
-            isCleanupRunning = false;
-        }
-    };
-    // Flush telemetry + resources before process exits
-    const shutdown = async () => {
-        await cleanupSessionResources({ trackSessionEnd: true });
-        await telemetry.shutdown();
-    };
-    if (shouldRegisterProcessHandlers) {
-        const stopParentProcessMonitor = (0, exports.startParentProcessMonitor)({
-            onOrphaned: async () => {
-                log.warn(`MCP parent process disappeared; shutting down orphaned process ${process.pid}`);
-                await shutdown();
-            },
-        });
-        process.on('SIGTERM', async () => {
-            stopParentProcessMonitor();
-            await shutdown();
-            process.exit(0);
-        });
-        process.on('SIGINT', async () => {
-            stopParentProcessMonitor();
-            await shutdown();
-            process.exit(0);
-        });
-        // Flush when the event loop empties (e.g., MCP transport disconnects)
-        process.on('beforeExit', async () => {
-            await shutdown();
-        });
-    }
-    /** Returns an attachment for the current visual editor session, if one exists. */
-    const attachActiveVisualEditor = async (projectPath) => {
-        if (!bridge.isActive()) {
-            return null;
-        }
-        if (!rivetServerUrl || rivetServerPort === null) {
-            throw new Error('Rivet visual editor session is active but URL metadata is unavailable');
-        }
-        const activeEditorSessionId = bridge.getSessionId();
-        if (!activeEditorSessionId) {
-            throw new Error('Rivet visual editor session is active but has no session ID');
-        }
-        const projectAction = (0, exports.getActiveVisualEditorProjectAction)({
-            activeProjectPath: bridge.getProjectPath(),
-            requestedProjectPath: projectPath,
-            devServerOwnership,
-        });
-        if (projectAction === 'restart') {
-            await cleanupSessionResources({ trackSessionEnd: false });
-            return null;
-        }
-        if (projectAction === 'rebind') {
-            bridge.rebindProjectPath(projectPath);
-        }
-        // Don't spawn a duplicate tab when a Rivet page is already open. The
-        // variants flow re-enters this path on every propose/start call; calling
-        // `open()` again opens a fresh tab in most browsers rather than focusing
-        // the existing one. Only (re)open when no UI client is connected — i.e.
-        // the user closed the page and needs it back.
-        if (!agentVariantsOrchestrator.hasUiClients()) {
-            try {
-                await (0, open_1.default)(rivetServerUrl);
-            }
-            catch {
-                log.warn('Failed to focus existing Rivet browser automatically');
-            }
-        }
-        return {
-            sessionId: activeEditorSessionId,
-            url: rivetServerUrl,
-            rivetPort: rivetServerPort,
-            opened: false,
-            attached: true,
-        };
-    };
-    /** Reads feature flags for a visual editor session without blocking startup on flag failures. */
-    const resolveSessionGitEnabled = async () => {
-        try {
-            const featureFlags = await (0, evaluateFlags_1.getFeatureFlags)();
-            return featureFlags.gitUi.isEnabled;
-        }
-        catch (error) {
-            log.warn('Failed to evaluate feature flags for MCP session startup; defaulting git to enabled:', error);
-            return true;
-        }
-    };
-    /** Writes editor-specific guidance once a visual editor session is ready. */
-    const writeEditorGuidance = (projectPath) => {
-        if (mcpEditor === 'cursor') {
-            (0, skillWriter_1.writeCursorRulesIfNeeded)(projectPath);
-        }
-        else if (mcpEditor === 'claude' || mcpEditor === undefined) {
-            (0, skillWriter_1.writeSkillFileIfNeeded)();
-        }
-    };
-    /**
-     * Ensure zero-to-one variant sessions have a Rivet UI shell subscribed to
-     * the shared variants orchestrator. Fresh projects do not have a base app
-     * server yet, so the shell starts with the existing proxy path and waits for
-     * generated variant dev servers to become selectable.
-     */
-    const ensureZeroToOneVisualEditorOpen = async (input) => {
-        // The bridge tracks the generated project folder. That keeps /api/config,
-        // history reads, and the committed preview focused on the same folder.
-        const { projectPath } = input;
-        const activeAttachment = await attachActiveVisualEditor(projectPath);
-        if (activeAttachment) {
-            return activeAttachment;
-        }
-        await (0, exports.closeDetachedVisualEditorServer)({
-            isBridgeActive: bridge.isActive(),
-            serverHandle,
-            cleanup: async () => {
-                await cleanupSessionResources({ trackSessionEnd: false });
-            },
-        });
-        let nextRivetPort;
-        try {
-            nextRivetPort = await (0, portUtils_1.findAvailablePort)(index_1.DEFAULT_PORT);
-        }
-        catch (error) {
-            log.warn(`Port discovery failed for zero-to-one editor, falling back to ${index_1.DEFAULT_PORT}:`, error);
-            nextRivetPort = index_1.DEFAULT_PORT;
-        }
-        let retries = 0;
-        const maxRetries = 5;
-        while (!serverHandle && retries < maxRetries) {
-            try {
-                serverHandle = await (0, server_1.startServer)({
-                    framework: input.framework,
-                    projectPath: input.projectPath,
-                    userPort: 0,
-                    userHost: 'localhost',
-                    sessionBridge: bridge,
-                    agentVariantsOrchestrator,
-                    telemetry,
-                    mcpEditor,
-                    skipProcessHandlers: true,
-                    rivetPort: nextRivetPort,
-                    isGitEnabled: false,
-                });
-            }
-            catch (error) {
-                if (error?.code !== 'EADDRINUSE') {
-                    throw error;
-                }
-                retries++;
-                nextRivetPort = await (0, portUtils_1.findAvailablePort)(nextRivetPort + 1);
-                log.debug(`Zero-to-one editor port in use, retrying with port ${nextRivetPort} (attempt ${retries}/${maxRetries})`);
-            }
-        }
-        if (!serverHandle) {
-            throw new Error(`Could not start Rivet server after ${maxRetries} attempts.`);
-        }
-        const editorSessionId = bridge.startSession(projectPath);
-        sessionStartedAt = Date.now();
-        devServerOwnership = 'none';
-        devServerHost = 'localhost';
-        devServerPort = null;
-        bridge.setDevServerContext({
-            ownership: devServerOwnership,
-            host: devServerHost,
-            port: devServerPort,
-            startedByRivet: false,
-        });
-        updateBridgeHealth('unknown', null);
-        telemetry.trackMCPSessionStart({
-            framework: input.framework,
-            devServerStarted: false,
-            sessionId: editorSessionId,
-            mcpEditor,
-        });
-        // Mirror the writeSkillFileIfNeeded / writeCursorRulesIfNeeded call
-        // that open_visual_editor performs after a successful open. The
-        // unified start_variants flow opens the editor via this hook instead
-        // of through the open_visual_editor tool, so without this the
-        // SKILL.md / rivet.mdc file would never be rewritten when only
-        // start_variants is used.
-        writeEditorGuidance(input.projectPath);
-        const url = `http://localhost:${nextRivetPort}/rivet`;
-        rivetServerPort = nextRivetPort;
-        rivetServerUrl = url;
-        try {
-            await (0, open_1.default)(url);
-        }
-        catch {
-            log.warn('Failed to open browser automatically');
-        }
-        return {
-            sessionId: editorSessionId,
-            url,
-            rivetPort: nextRivetPort,
-            opened: true,
-            attached: false,
-        };
-    };
-    /**
-     * Ensure existing-project variant sessions have the base app mounted as the
-     * default preview upstream before variant preview targets are selected.
-     */
-    const ensureExistingVisualEditorOpen = async (input) => {
-        const { projectPath } = input;
-        const activeAttachment = await attachActiveVisualEditor(projectPath);
-        if (activeAttachment &&
-            (0, exports.canReuseExistingProjectVisualEditor)({
-                attachment: activeAttachment,
-                devServerOwnership,
-            })) {
-            return activeAttachment;
-        }
-        if (activeAttachment) {
-            await cleanupSessionResources({ trackSessionEnd: false });
-        }
-        await (0, exports.closeDetachedVisualEditorServer)({
-            isBridgeActive: bridge.isActive(),
-            serverHandle,
-            cleanup: async () => {
-                await cleanupSessionResources({ trackSessionEnd: false });
-            },
-        });
-        const detection = new index_core_1.ProjectDetectionService();
-        let nextDevServerPort = null;
-        let nextDevServerHost = 'localhost';
-        let nextDevServerOwnership = 'none';
-        let staticTarget = null;
-        if (input.framework === 'static') {
-            staticTarget = (0, staticProjectTarget_1.resolveStaticProjectTarget)({ targetPath: projectPath });
-            if ((0, staticProjectTarget_1.needsStaticEntryPath)(staticTarget)) {
-                throw new Error('Static folder has multiple HTML files and no index.html. Open the visual editor with a specific entry path before starting variants.');
-            }
-            const entryFullPath = path_1.default.join(projectPath, staticTarget.entryPath);
-            const didWriteStarter = staticTarget.htmlEntryFiles.length === 0
-                ? (0, staticStarter_1.ensureStaticStarterCanvas)(projectPath)
-                : false;
-            const hasStaticEntry = fs_1.default.existsSync(entryFullPath) ||
-                (didWriteStarter && staticTarget.entryPath === 'index.html');
-            if (hasStaticEntry) {
-                nextDevServerHost = '127.0.0.1';
-                nextDevServerPort = await (0, portUtils_1.findAvailablePort)(index_1.DEFAULT_USER_PORT);
-                devServerProcess = await (0, StaticPreviewServer_1.startStaticPreviewServer)({
-                    rootPath: projectPath,
-                    port: nextDevServerPort,
-                    host: nextDevServerHost,
-                });
-                nextDevServerOwnership = 'rivet_owned';
-                devServerProcess.on('exit', (code) => {
-                    log.info(`Static preview server exited with code ${code}`);
-                    devServerProcess = null;
-                    if (bridge.isActive()) {
-                        updateBridgeHealth('upstream_unreachable', false);
-                    }
-                });
-                updateBridgeHealth('healthy', true);
-                log.info(`Static preview server ready on ${nextDevServerHost}:${nextDevServerPort}`);
-            }
-        }
-        else {
-            const frameworkConfig = devServerCommand_1.FRAMEWORK_DEV_CONFIG[input.framework];
-            const packageManager = await detection.detectPackageManager(projectPath);
-            const preferredPort = detection.readConfiguredPort(projectPath) ?? frameworkConfig.defaultPort;
-            nextDevServerPort = await (0, portUtils_1.findAvailablePort)(preferredPort);
-            const { cmd, args: cmdArgs, env, } = (0, devServerCommand_1.buildDevServerCommand)(input.framework, packageManager, frameworkConfig.devCommand, nextDevServerPort);
-            log.info(`Auto-starting dev server: ${cmd} ${cmdArgs.join(' ')} in ${projectPath}`);
-            devServerProcess = (0, child_process_1.spawn)(cmd, cmdArgs, {
-                cwd: projectPath,
-                env: { ...process.env, ...env },
-                stdio: 'pipe',
-                detached: false,
-            });
-            nextDevServerOwnership = 'rivet_owned';
-            devServerProcess.on('error', (err) => {
-                log.warn('Dev server process error:', err);
-            });
-            devServerProcess.on('exit', (code) => {
-                log.info(`Dev server exited with code ${code}`);
-                devServerProcess = null;
-                if (bridge.isActive()) {
-                    updateBridgeHealth('upstream_unreachable', false);
-                }
-            });
-            devServerProcess.stdout?.on('data', (data) => {
-                log.debug(`[dev-server] ${data.toString().trim()}`);
-            });
-            devServerProcess.stderr?.on('data', (data) => {
-                log.debug(`[dev-server] ${data.toString().trim()}`);
-            });
-            const ready = await waitForPort(nextDevServerPort, nextDevServerHost, 30_000);
-            if (!ready) {
-                if (devServerProcess) {
-                    await stopChildProcess(devServerProcess);
-                }
-                devServerProcess = null;
-                throw new Error(`Dev server did not become ready on port ${nextDevServerPort} within 30s.`);
-            }
-            const startupValidation = await validateProjectServer({
-                host: nextDevServerHost,
-                port: nextDevServerPort,
-                framework: input.framework,
-                projectPath,
-            });
-            if (!startupValidation.valid) {
-                if (devServerProcess) {
-                    await stopChildProcess(devServerProcess);
-                }
-                devServerProcess = null;
-                throw new Error(startupValidation.reason);
-            }
-            updateBridgeHealth('healthy', true);
-            log.info(`Dev server ready on ${nextDevServerHost}:${nextDevServerPort}`);
-        }
-        let nextRivetPort;
-        try {
-            nextRivetPort = await (0, portUtils_1.findAvailablePort)(index_1.DEFAULT_PORT);
-        }
-        catch (error) {
-            log.warn(`Port discovery failed for existing-project editor, falling back to ${index_1.DEFAULT_PORT}:`, error);
-            nextRivetPort = index_1.DEFAULT_PORT;
-        }
-        let retries = 0;
-        const maxRetries = 5;
-        const isGitEnabledForSession = await resolveSessionGitEnabled();
-        while (!serverHandle && retries < maxRetries) {
-            try {
-                serverHandle = await (0, server_1.startServer)({
-                    framework: input.framework,
-                    projectPath,
-                    staticEntry: staticTarget?.entryPath,
-                    userPort: nextDevServerPort ?? 0,
-                    userHost: nextDevServerHost,
-                    sessionBridge: bridge,
-                    agentVariantsOrchestrator,
-                    telemetry,
-                    mcpEditor,
-                    skipProcessHandlers: true,
-                    rivetPort: nextRivetPort,
-                    isGitEnabled: isGitEnabledForSession,
-                });
-            }
-            catch (error) {
-                if (error?.code !== 'EADDRINUSE') {
-                    if (devServerProcess) {
-                        await stopChildProcess(devServerProcess);
-                    }
-                    devServerProcess = null;
-                    throw error;
-                }
-                retries++;
-                nextRivetPort = await (0, portUtils_1.findAvailablePort)(nextRivetPort + 1);
-                log.debug(`Existing-project editor port in use, retrying with port ${nextRivetPort} (attempt ${retries}/${maxRetries})`);
-            }
-        }
-        if (!serverHandle) {
-            if (devServerProcess) {
-                await stopChildProcess(devServerProcess);
-            }
-            devServerProcess = null;
-            throw new Error(`Could not start Rivet server after ${maxRetries} attempts.`);
-        }
-        const editorSessionId = bridge.startSession(projectPath);
-        sessionStartedAt = Date.now();
-        devServerOwnership = nextDevServerOwnership;
-        devServerHost = nextDevServerHost;
-        devServerPort = nextDevServerPort;
-        bridge.setDevServerContext({
-            ownership: devServerOwnership,
-            host: devServerHost,
-            port: devServerPort,
-            startedByRivet: devServerOwnership === 'rivet_owned',
-        });
-        if (devServerOwnership === 'none') {
-            updateBridgeHealth('unknown', null);
-        }
-        else {
-            updateBridgeHealth('healthy', true);
-        }
-        telemetry.trackMCPSessionStart({
-            framework: input.framework,
-            devServerStarted: devServerOwnership === 'rivet_owned',
-            sessionId: editorSessionId,
-            mcpEditor,
-        });
-        writeEditorGuidance(projectPath);
-        const url = `http://localhost:${nextRivetPort}/rivet`;
-        rivetServerPort = nextRivetPort;
-        rivetServerUrl = url;
-        try {
-            await (0, open_1.default)(url);
-        }
-        catch {
-            log.warn('Failed to open browser automatically');
-        }
-        return {
-            sessionId: editorSessionId,
-            url,
-            rivetPort: nextRivetPort,
-            opened: true,
-            attached: false,
-        };
-    };
-    // Define schemas separately to avoid TS2589 "excessively deep" type inference
-    const openEditorArgs = {
-        projectPath: v3_1.z
-            .string()
-            .describe('Path to the project directory or a standalone HTML file. Defaults to current working directory.')
-            .optional(),
-        entryPath: v3_1.z
-            .string()
-            .describe('Static HTML entry path relative to projectPath. Use when opening a static folder with multiple HTML files and no index.html.')
-            .optional(),
-        framework: v3_1.z
-            .string()
-            .describe('Project framework. Optional; when omitted, Rivet detects it from projectPath.')
-            .optional(),
-        startPort: v3_1.z
-            .number()
-            .describe('Preferred starting port for the dev server. Rivet will find the next free port at or above this value. Falls back to the framework default if omitted.')
-            .optional(),
-        startupMode: v3_1.z
-            .enum(['manual_existing', 'ai_startup'])
-            .describe('How to connect the dev server: manual_existing uses an already-running server, ai_startup auto-starts one. Optional; if omitted, Rivet defaults to ai_startup.')
-            .optional(),
-        existingPort: v3_1.z
-            .number()
-            .describe('Port of an already-running dev server. Required for startupMode manual_existing, and reused for follow-up calls after nextStep responses.')
-            .optional(),
-        forceAttachExternal: v3_1.z
-            .boolean()
-            .describe('Confirmation flag for startupMode manual_existing when validation reports a project mismatch. Set true only after user confirms attaching anyway.')
-            .optional(),
-    };
-    const sessionIdArgs = {
-        sessionId: v3_1.z
-            .string()
-            .describe('The session ID returned by open_visual_editor'),
-    };
-    guardedMcp.tool('open_visual_editor', 'Start a Rivet visual editing session. Pass projectPath directly; framework is optional and will be detected when omitted. If the response has opened: false, follow the nextStep/nextAction instructions to recover. If opened: true, the response includes nextAction { tool: "watch_for_changes", ... }; host agents must call it immediately and keep that loop active until the user stops or closes the editor.', openEditorArgs, async (args) => {
-        if (bridge.isActive()) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            error: 'Session already active',
-                            sessionId: bridge.getSessionId(),
-                        }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const requestedProjectPath = args.projectPath || process.cwd();
-        let projectPath = requestedProjectPath;
-        let staticTarget = null;
-        try {
-            staticTarget = (0, staticProjectTarget_1.resolveStaticProjectTarget)({
-                targetPath: requestedProjectPath,
-                entryPath: args.entryPath,
-            });
-            projectPath = staticTarget.projectPath;
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : 'Unknown error';
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            error: `Could not open project target: ${message}`,
-                        }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        // When the caller omits framework (e.g. "open rivet"), detect it from
-        // the workspace rather than assuming a
-        // dev-server framework. An empty or HTML-only folder resolves to
-        // 'static', so the editor opens in static mode instead of trying to
-        // boot a Vite/Next dev server that isn't there. Detection only throws
-        // for a nonexistent path; fall back to the prior 'nextjs' default.
-        let framework;
-        if (args.framework) {
-            framework = args.framework;
-        }
-        else {
-            try {
-                framework = new index_core_1.ProjectDetectionService().detectFramework(projectPath);
-            }
-            catch {
-                framework = 'nextjs';
-            }
-        }
-        const requestedStartupMode = args.startupMode;
-        const startupMode = requestedStartupMode ?? 'ai_startup';
-        let nextDevServerPort = null;
-        let nextDevServerHost = 'localhost';
-        let nextDevServerOwnership = 'none';
-        const startupModeSelection = requestedStartupMode ? 'explicit' : 'auto';
-        if (framework === 'static') {
-            staticTarget = (0, staticProjectTarget_1.resolveStaticProjectTarget)({
-                targetPath: requestedProjectPath,
-                entryPath: args.entryPath,
-            });
-            projectPath = staticTarget.projectPath;
-            if ((0, staticProjectTarget_1.needsStaticEntryPath)(staticTarget)) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                opened: false,
-                                nextStep: 'entry_path_required',
-                                error: 'Static folder has multiple HTML files and no index.html. Pass projectPath as the target HTML file, or call open_visual_editor again with entryPath.',
-                                projectPath,
-                                staticHtmlFiles: staticTarget.htmlEntryFiles,
-                                nextAction: 'Call open_visual_editor with projectPath set to the specific HTML file, or with projectPath set to the folder and entryPath set to one of staticHtmlFiles.',
-                            }),
-                        },
-                    ],
-                    isError: false,
-                };
-            }
-            const entryFullPath = path_1.default.join(projectPath, staticTarget.entryPath);
-            const didWriteStarter = staticTarget.htmlEntryFiles.length === 0
-                ? (0, staticStarter_1.ensureStaticStarterCanvas)(projectPath)
-                : false;
-            const hasStaticEntry = fs_1.default.existsSync(entryFullPath) ||
-                (didWriteStarter && staticTarget.entryPath === 'index.html');
-            const isHistoryWorkspace = staticTarget.htmlEntryFiles.length === 0 &&
-                fs_1.default.existsSync(path_1.default.join(projectPath, '.rivet'));
-            if (!hasStaticEntry && !isHistoryWorkspace) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                opened: false,
-                                nextStep: 'entry_path_required',
-                                error: `Static entry not found: ${staticTarget.entryPath}`,
-                                projectPath,
-                                staticHtmlFiles: staticTarget.htmlEntryFiles,
-                                nextAction: 'Call open_visual_editor again with entryPath set to an existing HTML file.',
-                            }),
-                        },
-                    ],
-                    isError: false,
-                };
-            }
-            if (startupMode === 'manual_existing') {
-                const existingPort = args.existingPort ?? args.startPort ?? null;
-                if (!existingPort) {
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify({
-                                    error: 'startupMode manual_existing requires an existingPort value.',
-                                    suggestion: 'Pass existingPort for your running static file server.',
-                                }),
-                            },
-                        ],
-                        isError: true,
-                    };
-                }
-                const isReachable = await waitForPort(existingPort, nextDevServerHost, 3000);
-                if (!isReachable) {
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify({
-                                    error: `Cannot attach to ${nextDevServerHost}:${existingPort} because it is not reachable.`,
-                                }),
-                            },
-                        ],
-                        isError: true,
-                    };
-                }
-                nextDevServerPort = existingPort;
-                nextDevServerOwnership = 'external';
-                updateBridgeHealth('healthy', true);
-            }
-            else if (hasStaticEntry) {
-                nextDevServerHost = '127.0.0.1';
-                nextDevServerPort = await (0, portUtils_1.findAvailablePort)(args.startPort ?? index_1.DEFAULT_USER_PORT);
-                devServerProcess = await (0, StaticPreviewServer_1.startStaticPreviewServer)({
-                    rootPath: projectPath,
-                    port: nextDevServerPort,
-                    host: nextDevServerHost,
-                });
-                nextDevServerOwnership = 'rivet_owned';
-                devServerProcess.on('exit', (code) => {
-                    log.info(`Static preview server exited with code ${code}`);
-                    devServerProcess = null;
-                    if (bridge.isActive()) {
-                        updateBridgeHealth('upstream_unreachable', false);
-                    }
-                });
-                updateBridgeHealth('healthy', true);
-                log.info(`Static preview server ready on ${nextDevServerHost}:${nextDevServerPort}`);
-            }
-        }
-        else {
-            const frameworkConfig = devServerCommand_1.FRAMEWORK_DEV_CONFIG[framework] ?? {
-                devCommand: 'dev',
-                defaultPort: 3000,
-            };
-            const detection = new index_core_1.ProjectDetectionService();
-            if (!frameworkConfig.devCommand) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                error: 'Cannot auto-start: no dev command configured for this framework.',
-                                suggestion: 'Start the dev server manually, then call open_visual_editor again.',
-                            }),
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            if (startupMode === 'manual_existing') {
-                const existingPort = args.existingPort ?? args.startPort ?? null;
-                if (!existingPort) {
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify({
-                                    error: 'startupMode manual_existing requires an existingPort value.',
-                                    suggestion: 'Pass existingPort for your running dev server.',
-                                }),
-                            },
-                        ],
-                        isError: true,
-                    };
-                }
-                const manualValidation = await validateProjectServer({
-                    host: nextDevServerHost,
-                    port: existingPort,
-                    framework,
-                    projectPath,
-                });
-                if (!manualValidation.valid) {
-                    if (args.forceAttachExternal) {
-                        const isReachable = await waitForPort(existingPort, nextDevServerHost, 3000);
-                        if (!isReachable) {
-                            return {
-                                content: [
-                                    {
-                                        type: 'text',
-                                        text: JSON.stringify({
-                                            error: `Cannot attach to ${nextDevServerHost}:${existingPort} because it is not reachable.`,
-                                            validation: manualValidation,
-                                        }),
-                                    },
-                                ],
-                                isError: true,
-                            };
-                        }
-                        nextDevServerPort = existingPort;
-                        nextDevServerOwnership = 'external';
-                        log.info(`Force-attached to external dev server on ${nextDevServerHost}:${nextDevServerPort}`);
-                        updateBridgeHealth('healthy', true);
-                    }
-                    else if (manualValidation.selectedProjectPath ||
-                        (manualValidation.observedProcessPaths?.length ?? 0) > 0) {
-                        return {
-                            content: [
-                                {
-                                    type: 'text',
-                                    text: JSON.stringify({
-                                        opened: false,
-                                        nextStep: 'mismatch_confirmation_required',
-                                        error: manualValidation.reason,
-                                        existingServerPort: existingPort,
-                                        selectedProjectPath: manualValidation.selectedProjectPath,
-                                        observedProcessPaths: manualValidation.observedProcessPaths,
-                                        validation: manualValidation,
-                                        nextAction: 'If the user confirms, call open_visual_editor again with startupMode: "manual_existing", existingPort, and forceAttachExternal: true. Otherwise ask for another port.',
-                                    }),
-                                },
-                            ],
-                            isError: false,
-                        };
-                    }
-                    else {
-                        return {
-                            content: [
-                                {
-                                    type: 'text',
-                                    text: JSON.stringify({
-                                        error: manualValidation.reason,
-                                        validation: manualValidation,
-                                    }),
-                                },
-                            ],
-                            isError: true,
-                        };
-                    }
-                }
-                if (!nextDevServerPort) {
-                    nextDevServerPort = existingPort;
-                    nextDevServerOwnership = 'external';
-                    log.info(`Using existing dev server on ${nextDevServerHost}:${nextDevServerPort}`);
-                    updateBridgeHealth('healthy', true);
-                }
-            }
-            else {
-                const packageManager = await detection.detectPackageManager(projectPath);
-                const preferredPort = args.startPort ??
-                    detection.readConfiguredPort(projectPath) ??
-                    frameworkConfig.defaultPort;
-                nextDevServerPort = await (0, portUtils_1.findAvailablePort)(preferredPort);
-                const { cmd, args: cmdArgs, env, } = (0, devServerCommand_1.buildDevServerCommand)(framework, packageManager, frameworkConfig.devCommand, nextDevServerPort);
-                log.info(`Auto-starting dev server: ${cmd} ${cmdArgs.join(' ')} in ${projectPath}`);
-                devServerProcess = (0, child_process_1.spawn)(cmd, cmdArgs, {
-                    cwd: projectPath,
-                    env: { ...process.env, ...env },
-                    stdio: 'pipe',
-                    detached: false,
-                });
-                nextDevServerOwnership = 'rivet_owned';
-                devServerProcess.on('error', (err) => {
-                    log.warn('Dev server process error:', err);
-                });
-                devServerProcess.on('exit', (code) => {
-                    log.info(`Dev server exited with code ${code}`);
-                    devServerProcess = null;
-                    if (bridge.isActive()) {
-                        updateBridgeHealth('upstream_unreachable', false);
-                    }
-                });
-                devServerProcess.stdout?.on('data', (data) => {
-                    log.debug(`[dev-server] ${data.toString().trim()}`);
-                });
-                devServerProcess.stderr?.on('data', (data) => {
-                    log.debug(`[dev-server] ${data.toString().trim()}`);
-                });
-                const ready = await waitForPort(nextDevServerPort, nextDevServerHost, 30_000);
-                if (!ready) {
-                    if (devServerProcess) {
-                        await stopChildProcess(devServerProcess);
-                    }
-                    devServerProcess = null;
-                    const existingServer = await detection.findRunningDevServer(projectPath, [index_1.DEFAULT_PORT]);
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify({
-                                    opened: false,
-                                    nextStep: 'manual_port_required',
-                                    error: `Dev server did not become ready on port ${nextDevServerPort} within 30s.`,
-                                    existingServerPort: existingServer?.port ?? null,
-                                    validation: null,
-                                    nextAction: 'Call open_visual_editor again with startupMode: "manual_existing" and existingPort set to a running app server port.',
-                                }),
-                            },
-                        ],
-                        isError: false,
-                    };
-                }
-                const startupValidation = await validateProjectServer({
-                    host: nextDevServerHost,
-                    port: nextDevServerPort,
-                    framework,
-                    projectPath,
-                });
-                if (!startupValidation.valid) {
-                    if (devServerProcess) {
-                        await stopChildProcess(devServerProcess);
-                    }
-                    devServerProcess = null;
-                    const existingServer = await detection.findRunningDevServer(projectPath, [index_1.DEFAULT_PORT]);
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify({
-                                    opened: false,
-                                    nextStep: 'manual_port_required',
-                                    error: startupValidation.reason,
-                                    existingServerPort: existingServer?.port ?? null,
-                                    validation: startupValidation,
-                                    nextAction: 'Call open_visual_editor again with startupMode: "manual_existing" and existingPort set to a running app server port.',
-                                }),
-                            },
-                        ],
-                        isError: false,
-                    };
-                }
-                updateBridgeHealth('healthy', true);
-                log.info(`Dev server ready on ${nextDevServerHost}:${nextDevServerPort}`);
-            }
-        }
-        // Find a free port for Rivet's Express server (avoids conflict with desktop or other Rivet instances)
-        let isGitEnabledForSession = true;
-        try {
-            const featureFlags = await (0, evaluateFlags_1.getFeatureFlags)();
-            isGitEnabledForSession = featureFlags.gitUi.isEnabled;
-        }
-        catch (error) {
-            log.warn('Failed to evaluate feature flags for MCP session startup; defaulting git to enabled:', error);
-        }
-        let rivetPort;
-        try {
-            rivetPort = await (0, portUtils_1.findAvailablePort)(index_1.DEFAULT_PORT);
-            log.info(`Searching for available port starting from ${index_1.DEFAULT_PORT}... found ${rivetPort}`);
-        }
-        catch (error) {
-            log.warn(`Port discovery failed, falling back to ${index_1.DEFAULT_PORT}:`, error);
-            rivetPort = index_1.DEFAULT_PORT;
-        }
-        // Start the Rivet Express server (with retry on EADDRINUSE to avoid races)
-        let retries = 0;
-        const maxRetries = 5;
-        let serverStarted = false;
-        while (!serverStarted && retries < maxRetries) {
-            try {
-                serverHandle = await (0, server_1.startServer)({
-                    framework,
-                    projectPath,
-                    staticEntry: staticTarget?.entryPath,
-                    userPort: nextDevServerPort ?? 0,
-                    userHost: nextDevServerHost,
-                    sessionBridge: bridge,
-                    agentVariantsOrchestrator,
-                    telemetry,
-                    mcpEditor,
-                    skipProcessHandlers: true,
-                    rivetPort,
-                    isGitEnabled: isGitEnabledForSession,
-                });
-                serverStarted = true;
-            }
-            catch (error) {
-                if (error?.code === 'EADDRINUSE') {
-                    retries++;
-                    rivetPort = await (0, portUtils_1.findAvailablePort)(rivetPort + 1);
-                    log.debug(`Port in use, retrying with port ${rivetPort} (attempt ${retries}/${maxRetries})`);
-                }
-                else {
-                    const message = error instanceof Error ? error.message : 'Server start failed';
-                    if (devServerProcess) {
-                        await stopChildProcess(devServerProcess);
-                    }
-                    devServerProcess = null;
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify({ error: message }),
-                            },
-                        ],
-                        isError: true,
-                    };
-                }
-            }
-        }
-        if (!serverStarted) {
-            if (devServerProcess) {
-                await stopChildProcess(devServerProcess);
-            }
-            devServerProcess = null;
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            error: `Could not start Rivet server after ${maxRetries} attempts.`,
-                        }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const sessionId = bridge.startSession(projectPath);
-        sessionStartedAt = Date.now();
-        devServerOwnership = nextDevServerOwnership;
-        devServerHost = nextDevServerHost;
-        devServerPort = nextDevServerPort;
-        bridge.setDevServerContext({
-            ownership: devServerOwnership,
-            host: devServerHost,
-            port: devServerPort,
-            startedByRivet: devServerOwnership === 'rivet_owned',
-        });
-        if (devServerOwnership === 'none') {
-            updateBridgeHealth('unknown', null);
-        }
-        else {
-            updateBridgeHealth('healthy', true);
-        }
-        // Write editor-specific guidance file on first successful open
-        if (mcpEditor === 'cursor') {
-            (0, skillWriter_1.writeCursorRulesIfNeeded)(projectPath);
-        }
-        else if (mcpEditor === 'claude' || mcpEditor === undefined) {
-            (0, skillWriter_1.writeSkillFileIfNeeded)();
-        }
-        // Track session start
-        telemetry.trackMCPSessionStart({
-            framework,
-            devServerStarted: devServerOwnership === 'rivet_owned',
-            sessionId,
-            mcpEditor,
-        });
-        // Open the editor shell at /rivet. Static projects may also expose the
-        // project root at / when a preview backend exists.
-        const url = `http://localhost:${rivetPort}/rivet`;
-        rivetServerPort = rivetPort;
-        rivetServerUrl = url;
-        try {
-            await (0, open_1.default)(url);
-        }
-        catch {
-            log.warn('Failed to open browser automatically');
-        }
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        sessionId,
-                        url,
-                        projectPath,
-                        framework,
-                        rivetPort,
-                        opened: true,
-                        devServerPort: nextDevServerPort,
-                        devServerOwnership: nextDevServerOwnership,
-                        staticEntryPath: staticTarget?.entryPath ?? null,
-                        previewUrl: framework === 'static'
-                            ? `http://localhost:${rivetPort}/static/`
-                            : `http://localhost:${rivetPort}/`,
-                        startupMode,
-                        startupModeSelection,
-                        requestedStartupMode,
-                        isGitEnabled: isGitEnabledForSession,
-                        nextAction: (0, exports.buildVisualEditorWatchAction)(sessionId),
-                        next_step: `Rivet is open. Tell the user: "Rivet is ready — make your visual changes and click '${sendButtonLabel}'." Then immediately call watch_for_changes({ sessionId: "${sessionId}" }) and keep the watch loop active until the user stops or closes the editor. If watch_for_changes times out, call it again. After handling a batch, call it again; for hosts with background workers, dispatch static-preview variant/refine batches and re-watch immediately, and for hosts without background workers, process the scoped batch inline before re-watching.`,
-                    }),
-                },
-            ],
-        };
-    });
-    guardedMcp.tool('watch_for_changes', `Required visual-editor watch loop. Call immediately after a successful open_visual_editor response, or after a start_variants response that includes editorNextAction/visualEditor. It blocks until the user sends a change batch, then returns a leased payload with leaseId and kind. After editing files (apply), call watch_for_changes again with refresh_git: true and the leaseId to release the apply lease and refresh git. For UI-originated variant_request/static_preview_refine batches, lease the exact workItemIds and finish generated work with report_work_item; do not use ack_batch to skip or finish generated variant work. If it times out (hasChanges: false), call it again to keep waiting.`, {
-        sessionId: v3_1.z
-            .string()
-            .describe('The session ID returned by open_visual_editor'),
-        timeoutSeconds: v3_1.z
-            .number()
-            .min(1)
-            .max(600)
-            .optional()
-            .describe('How long to wait for the user to send changes (default: 600, max: 600)'),
-        message: v3_1.z
-            .string()
-            .optional()
-            .describe('A progress or summary message to show in the Rivet UI before waiting (e.g. your plan or what you just changed)'),
-        refresh_git: v3_1.z
-            .boolean()
-            .optional()
-            .describe('After completing an apply lease: set true with leaseId to ack the lease and trigger a git status refresh in the Rivet UI'),
-        ack_batch: v3_1.z
-            .boolean()
-            .optional()
-            .describe('Only for variant leases that are not tied to generated work items. UI-originated variant_request/static_preview_refine work is released by report_work_item; unclaimed or unfinished generated work rejects ack_batch.'),
-        leaseId: v3_1.z
-            .string()
-            .optional()
-            .describe('The leaseId from the batch you just completed'),
-        requestId: v3_1.z
-            .string()
-            .optional()
-            .describe('Optional requestId from the leased batch for idempotent ack'),
-    }, async (args) => {
-        if (!bridge.isActive() || bridge.getSessionId() !== args.sessionId) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({ error: 'No active session with that ID' }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const timeoutMs = Math.min((args.timeoutSeconds ?? 600) * 1000, 600_000);
-        if (args.message) {
-            bridge.reportFeedback(args.message);
-        }
-        if (args.refresh_git) {
-            handleApplyAck(args.sessionId, {
-                leaseId: args.leaseId,
-                requestId: args.requestId,
-            });
-        }
-        if (args.ack_batch) {
-            const ackError = handleVariantAck({
-                leaseId: args.leaseId,
-                requestId: args.requestId,
-            });
-            if (ackError) {
-                return ackError;
-            }
-        }
-        // `handleApplyAck` sets READY so the UI can clear comment markers. Do not
-        // overwrite it synchronously — the UI polls `/api/mcp/status` and needs
-        // one READY observation before the watch loop re-arms.
-        if (!args.refresh_git) {
-            bridge.setStatus('WATCHING');
-        }
-        try {
-            await bridge.waitForChanges(timeoutMs);
-        }
-        catch {
-            const health = bridge.getDevServerHealth();
-            return (0, exports.buildNoPendingChangesResponse)({
-                message: 'Timed out waiting for changes. Call watch_for_changes again to keep waiting.',
-                devServerHealth: health,
-                pendingVariantRequests: bridge.pendingVariantRequestCount(),
-                activeLeases: getActiveLeaseMetadata(bridge),
-            });
-        }
-        const routed = leaseAndRouteBatch(args.sessionId, (0, exports.resolveLeasePickupRequestId)(args));
-        if (routed) {
-            return routed;
-        }
-        const health = bridge.getDevServerHealth();
-        return (0, exports.buildNoPendingChangesResponse)({
-            message: 'No pending changes. Call watch_for_changes again to keep waiting.',
-            devServerHealth: health,
-            pendingVariantRequests: bridge.pendingVariantRequestCount(),
-            activeLeases: getActiveLeaseMetadata(bridge),
-        });
-    });
-    guardedMcp.tool('get_pending_changes', `Pick up pending design changes from the Rivet visual editor. Returns a leased batch with leaseId and kind when work is queued. After editing files (apply), call again with refresh_git: true and leaseId to ack and refresh git. For UI-originated variant_request/static_preview_refine batches, lease the exact workItemIds and finish generated work with report_work_item; do not use ack_batch to skip or finish generated variant work. Returns hasChanges: false if no changes are queued yet.`, {
-        sessionId: v3_1.z
-            .string()
-            .describe('The session ID returned by open_visual_editor'),
-        message: v3_1.z
-            .string()
-            .optional()
-            .describe('A progress or summary message to show in the Rivet UI (e.g. your plan or what you just changed)'),
-        refresh_git: v3_1.z
-            .boolean()
-            .optional()
-            .describe('After completing an apply lease: set true with leaseId to ack and trigger a git status refresh in the Rivet UI'),
-        ack_batch: v3_1.z
-            .boolean()
-            .optional()
-            .describe('Only for variant leases that are not tied to generated work items. UI-originated variant_request/static_preview_refine work is released by report_work_item; unclaimed or unfinished generated work rejects ack_batch.'),
-        leaseId: v3_1.z
-            .string()
-            .optional()
-            .describe('The leaseId from the batch you just completed'),
-        requestId: v3_1.z
-            .string()
-            .optional()
-            .describe('Optional requestId from the leased batch for idempotent ack'),
-    }, async (args) => {
-        if (!bridge.isActive() || bridge.getSessionId() !== args.sessionId) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({ error: 'No active session with that ID' }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        if (args.message) {
-            bridge.reportFeedback(args.message);
-        }
-        if (args.refresh_git) {
-            handleApplyAck(args.sessionId, {
-                leaseId: args.leaseId,
-                requestId: args.requestId,
-            });
-        }
-        if (args.ack_batch) {
-            const ackError = handleVariantAck({
-                leaseId: args.leaseId,
-                requestId: args.requestId,
-            });
-            if (ackError) {
-                return ackError;
-            }
-        }
-        const routed = leaseAndRouteBatch(args.sessionId, (0, exports.resolveLeasePickupRequestId)(args));
-        if (routed) {
-            return routed;
-        }
-        return (0, exports.buildNoPendingChangesResponse)({
-            pendingVariantRequests: bridge.pendingVariantRequestCount(),
-            activeLeases: getActiveLeaseMetadata(bridge),
-        });
-    });
-    guardedMcp.tool('close_visual_editor', 'Stop the Rivet visual editing session and clean up resources. Call this when the user is done making visual changes.', sessionIdArgs, async (args) => {
-        if (!bridge.isActive() || bridge.getSessionId() !== args.sessionId) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({ error: 'No active session with that ID' }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const { totalRoundsCompleted } = await cleanupSessionResources({
-            closeSessionId: args.sessionId,
-            trackSessionEnd: true,
-        });
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({ closed: true, totalRoundsCompleted }),
-                },
-            ],
-        };
-    });
-    // Register the agent-variants MCP tools (orchestrator was constructed at
-    // the top of runMcpServer so it's shared with the Express routes).
-    // Default inspiration fetcher + design-context store are wired
-    // automatically when omitted, so production picks them up here.
-    (0, agent_variants_1.registerAgentVariantsTools)(guardedMcp, {
-        orchestrator: agentVariantsOrchestrator,
-        leaseOwner: () => 'mcp-server',
-        ensureVisualEditorOpen: ensureZeroToOneVisualEditorOpen,
-        ensureExistingVisualEditorOpen,
-        getProjectPath: () => bridge.getProjectPath(),
-        resolveVariantRequestProjectPath: (requestId) => bridge.resolveVariantRequestProjectPath(requestId),
-        pendingVariantRequestCount: () => bridge.pendingVariantRequestCount(),
-        claimVariantRequestLease: variantRequestLeaseTracker.claim,
-        completeVariantRequestWork: variantRequestLeaseTracker.complete,
-        isVariantSendEnabled: async () => {
-            const flags = await (0, evaluateFlags_1.getFeatureFlags)();
-            return flags.variantSend.isEnabled;
-        },
-        telemetry: variantsTelemetry,
-        integrationsClient,
-        openIntegrationConnectUrl,
-        markFirstVariantsRun: () => configManager.markFirstVariantsRun(),
-    });
-    (0, tools_2.registerIntegrationsTools)(guardedMcp, {
-        integrationsClient,
-        openIntegrationConnectUrl,
-    });
-    (0, tools_1.registerAuthTools)(analyticsMcp, {
-        authService,
-        telemetry,
-        mcpEditor,
-        revokeBearerToken,
-    });
-    log.info('agent-variants + integrations + auth MCP tools registered');
-    const closeActiveSession = async () => {
-        await cleanupSessionResources({ trackSessionEnd: true });
-    };
-    return { mcp, closeActiveSession, shutdown };
-};
-exports.createRivetMcp = createRivetMcp;
-const startMCPServer = async (mcpEditor) => {
-    (0, exports.configureMcpStdioLogging)();
-    // Refresh the Claude skill at startup — NOT only after a successful
-    // open_visual_editor (the other call sites below). Otherwise stale guidance
-    // that refuses an action deadlocks: e.g. a v22 skill that won't open an empty
-    // folder means open_visual_editor never runs, so the skill never rewrites,
-    // so the agent keeps refusing forever. Writing on boot guarantees the agent
-    // loads current guidance on its next turn. Idempotent + version-gated.
-    // (Cursor rules stay post-open: they're project-scoped and the project path
-    // isn't known until the editor opens.)
-    if (mcpEditor === 'claude' || mcpEditor === undefined) {
-        (0, skillWriter_1.writeSkillFileIfNeeded)();
-    }
-    const localAuthBridge = await (0, AuthService_1.startLocalAuthBridgeServer)();
-    try {
-        const { mcp } = (0, exports.createRivetMcp)({ mcpEditor });
-        // Connect via stdio
-        const transport = new stdio_js_1.StdioServerTransport();
-        await mcp.connect(transport);
-        log.info('Rivet MCP server started on stdio');
-        // Keep the MCP process alive for as long as the client keeps stdio open.
-        // Without this guard, some Node/stdin combinations can allow the process
-        // to exit before the client finishes initialization.
-        await new Promise((resolve) => {
-            process.stdin.once('end', resolve);
-            process.stdin.once('close', resolve);
-            process.stdin.resume();
-        });
-    }
-    finally {
-        await localAuthBridge?.close();
-    }
-};
-exports.startMCPServer = startMCPServer;
-//# sourceMappingURL=server.js.map