@buildautomaton/cli 0.1.69 → 0.1.70

package/dist/cli.js

@@ -31064,7 +31064,7 @@ var {
 } = import_index.default;
 
 // src/cli-version.ts
-var CLI_VERSION = "0.1.69".length > 0 ? "0.1.69" : "0.0.0-dev";
+var CLI_VERSION = "0.1.70".length > 0 ? "0.1.70" : "0.0.0-dev";
 
 // src/cli/defaults.ts
 var DEFAULT_API_URL = process.env.BUILDAUTOMATON_API_URL ?? "https://api.buildautomaton.com";
@@ -34902,6 +34902,18 @@ function getAgentModelFromAgentConfig(config2) {
   return t !== "" ? t : null;
 }
 
+// ../types/src/overview/heatmap/constants.ts
+var HOUR_MS = 36e5;
+var DAY_MS = 24 * HOUR_MS;
+
+// ../types/src/bridges/agents/types.ts
+var INSTALLABLE_BRIDGE_AGENTS = [
+  { value: "claude-code", label: "Anthropic Claude Code", tokenLabel: "Anthropic API key", tokenEnvVar: "ANTHROPIC_API_KEY" },
+  { value: "codex-acp", label: "Codex", tokenLabel: "OpenAI API key", tokenEnvVar: "OPENAI_API_KEY" },
+  { value: "cursor-cli", label: "Cursor CLI agent", tokenLabel: "Cursor API key", tokenEnvVar: "CURSOR_API_KEY" },
+  { value: "opencode", label: "OpenCode agent", tokenLabel: "Provider API key", tokenEnvVar: "OPENCODE_API_KEY" }
+];
+
 // src/paths/session-layout-paths.ts
 import * as path26 from "node:path";
 function resolveIsolatedSessionParentPathFromCheckouts(worktreePaths) {
@@ -51489,6 +51501,7 @@ var API_TO_BRIDGE_MESSAGE_TYPES = [
   "code_nav",
   "skill_layout_request",
   "install_skills",
+  "install_agent",
   "refresh_local_skills",
   "bridge_git_context_request",
   "list_repo_branches_request"
@@ -51564,6 +51577,100 @@ var handleBridgeHeartbeatAck = (msg, deps) => {
   deps.onBridgeHeartbeatAck?.(Math.trunc(raw));
 };
 
+// src/routing/dispatch/connection.ts
+function dispatchBridgeConnectionMessage(msg, deps) {
+  switch (msg.type) {
+    case "auth_token":
+      handleAuthToken(msg, deps);
+      break;
+    case "bridge_identified":
+      handleBridgeIdentified(msg, deps);
+      break;
+    case "ha":
+      handleBridgeHeartbeatAck(msg, deps);
+      break;
+  }
+}
+
+// src/routing/handlers/preview-environment-control.ts
+var handlePreviewEnvironmentControl = (msg, deps) => {
+  let wire;
+  try {
+    wire = deps.e2ee ? deps.e2ee.decryptMessage(msg) : msg;
+  } catch (e) {
+    deps.log(`[E2EE] Could not decrypt preview environment command: ${e instanceof Error ? e.message : String(e)}`);
+    return;
+  }
+  const environmentId = typeof wire.environmentId === "string" ? wire.environmentId : "";
+  const action = wire.action === "start" || wire.action === "stop" ? wire.action : null;
+  if (!environmentId || !action) return;
+  deps.previewEnvironmentManager?.handleControl(environmentId, action);
+};
+
+// src/routing/handlers/preview-environments-config.ts
+var VALID_PORT = (p) => typeof p === "number" && Number.isInteger(p) && p > 0 && p < 65536;
+var handlePreviewEnvironmentsConfig = (msg, deps) => {
+  const previewEnvironments = msg.previewEnvironments;
+  const proxyPorts = Array.isArray(msg.proxyPorts) ? msg.proxyPorts.filter(VALID_PORT) : void 0;
+  setImmediate(() => {
+    deps.previewEnvironmentManager?.applyConfig(previewEnvironments ?? []);
+    const environmentIds = parsePreviewEnvironmentDefs(previewEnvironments ?? []).map((d) => d.environmentId);
+    void deps.previewWorktreeManager?.syncConfiguredEnvironments(environmentIds);
+    if (proxyPorts !== void 0) {
+      deps.updateFirehoseProxyPorts?.(proxyPorts);
+    }
+  });
+};
+
+// src/routing/handlers/send-deploy-session-to-preview-result.ts
+function sendDeploySessionToPreviewResult(ws, id, payload) {
+  if (!ws) return;
+  sendWsMessage(ws, { type: "deploy_session_to_preview_result", id, ...payload });
+}
+
+// src/routing/handlers/deploy-session-to-preview.ts
+var handleDeploySessionToPreviewMessage = (msg, deps) => {
+  if (typeof msg.id !== "string") return;
+  const sessionId = typeof msg.sessionId === "string" ? msg.sessionId : "";
+  const environmentId = typeof msg.environmentId === "string" ? msg.environmentId : "";
+  if (!sessionId || !environmentId) return;
+  void (async () => {
+    const ws = deps.getWs();
+    const reply = (payload) => sendDeploySessionToPreviewResult(ws, msg.id, payload);
+    try {
+      if (!deps.previewWorktreeManager) {
+        reply({ ok: false, error: "Preview worktree manager unavailable" });
+        return;
+      }
+      const result = await deploySessionToPreviewEnvironment({
+        sessionWorktreeManager: deps.sessionWorktreeManager,
+        previewWorktreeManager: deps.previewWorktreeManager,
+        sessionId,
+        environmentId,
+        log: deps.log
+      });
+      reply(result);
+    } catch (e) {
+      reply({ ok: false, error: e instanceof Error ? e.message : String(e) });
+    }
+  })();
+};
+
+// src/routing/dispatch/preview.ts
+function dispatchBridgePreviewMessage(msg, deps) {
+  switch (msg.type) {
+    case "preview_environments_config":
+      handlePreviewEnvironmentsConfig(msg, deps);
+      break;
+    case "preview_environment_control":
+      handlePreviewEnvironmentControl(msg, deps);
+      break;
+    case "deploy_session_to_preview":
+      handleDeploySessionToPreviewMessage(msg, deps);
+      break;
+  }
+}
+
 // src/agents/acp/from-bridge/handle-bridge-agent-config.ts
 function handleBridgeAgentConfig(msg, { acpManager }) {
   if (!Array.isArray(msg.agents) || msg.agents.length === 0) return;
@@ -52202,367 +52309,505 @@ var handleSessionRequestResponseMessage = (msg, deps) => {
   handleBridgeSessionRequestResponse(msg, deps);
 };
 
-// src/skills/preview.ts
-import { spawn as spawn10 } from "node:child_process";
-var PREVIEW_API_BASE_PATH = "/__preview";
-var PREVIEW_SECRET_HEADER = "X-Preview-Secret";
-var DEFAULT_PORT = 3e3;
-var DEFAULT_COMMAND = "npm run preview";
-var PREVIEW_COMMAND_ENV = "BUILDAUTOMATON_PREVIEW_COMMAND";
-var PREVIEW_PORT_ENV = "BUILDAUTOMATON_PREVIEW_PORT";
-var previewProcess = null;
-var previewPort = DEFAULT_PORT;
-var previewSecret = "";
-function getPreviewCommand() {
-  return process.env[PREVIEW_COMMAND_ENV]?.trim() || DEFAULT_COMMAND;
-}
-function randomSecret() {
-  const bytes = new Uint8Array(32);
-  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
-    crypto.getRandomValues(bytes);
+// src/routing/handlers/git/handle-session-git-commit.ts
+async function handleSessionGitCommitAction(deps, sessionId, msg, reply) {
+  const branch = typeof msg.branch === "string" ? msg.branch : "";
+  const message = typeof msg.message === "string" ? msg.message : "";
+  const pushAfterCommit = msg.pushAfterCommit === true;
+  if (!branch.trim() || !message.trim()) {
+    reply({ ok: false, error: "branch and message are required for commit" });
+    return;
   }
-  return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
-}
-async function requestPreviewApi(port, secret, method, path84, body) {
-  const url2 = `http://127.0.0.1:${port}${path84}`;
-  const headers = {
-    [PREVIEW_SECRET_HEADER]: secret,
-    "Content-Type": "application/json"
-  };
-  const res = await fetch(url2, {
-    method,
-    headers,
-    body: body !== void 0 ? JSON.stringify(body) : void 0
+  const commitRes = await deps.sessionWorktreeManager.commitSession({
+    sessionId,
+    branch: branch.trim(),
+    message: message.trim(),
+    push: pushAfterCommit
   });
-  const data = await res.json().catch(() => ({}));
-  if (!res.ok) {
-    throw new Error(data?.error ?? `Preview API ${method} ${path84}: ${res.status}`);
+  if (!commitRes.ok) {
+    reply({ ok: false, error: commitRes.error ?? "Commit failed" });
+    return;
   }
-  return data;
+  const st = await deps.sessionWorktreeManager.getSessionWorkingTreeStatus(sessionId);
+  reply({
+    ok: true,
+    hasUncommittedChanges: st.hasUncommittedChanges,
+    hasUnpushedCommits: st.hasUnpushedCommits,
+    uncommittedFileCount: st.uncommittedFileCount
+  });
 }
-var OPERATIONS = [
-  {
-    id: "start",
-    description: "Start the preview server process (runs the configured command with PORT and PREVIEW_SECRET).",
-    params: [
-      { name: "port", description: "Port for the preview server", type: "number", required: false }
-    ]
-  },
-  {
-    id: "stop",
-    description: "Stop the preview server via POST /__preview/stop (graceful shutdown).",
-    params: []
-  },
-  {
-    id: "status",
-    description: "Return status from GET /__preview/status (running, url).",
-    params: []
+
+// src/routing/handlers/git/session-git-changes-params.ts
+function readString(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function readChangesObject(msg) {
+  const changes = msg.changes;
+  if (!changes || typeof changes !== "object" || Array.isArray(changes)) return null;
+  return changes;
+}
+function parseSessionGitChangesParams(msg) {
+  const nested = readChangesObject(msg);
+  const file2 = nested?.file && typeof nested.file === "object" && !Array.isArray(nested.file) ? nested.file : null;
+  const repoRelPath = readString(nested?.repoRelPath) || readString(msg.changesRepoRelPath);
+  const viewRaw = nested?.view ?? msg.changesView;
+  const view = viewRaw === "commit" ? "commit" : "working";
+  const commitSha = readString(nested?.commitSha) || readString(msg.changesCommitSha);
+  const recentCommitsLimit = nested?.recentCommitsLimit ?? msg.changesRecentCommitsLimit;
+  return {
+    repoRelPath,
+    view,
+    commitSha,
+    recentCommitsLimit: typeof recentCommitsLimit === "number" || typeof recentCommitsLimit === "string" ? recentCommitsLimit : void 0,
+    fileWorkspaceRelPath: readString(file2?.workspaceRelPath),
+    fileChange: readString(file2?.change),
+    fileMovedFromWorkspaceRelPath: readString(file2?.movedFromWorkspaceRelPath)
+  };
+}
+
+// src/routing/handlers/git/handle-session-git-get-change-file-patch.ts
+async function handleSessionGitGetChangeFilePatchAction(deps, msg, reply) {
+  const changes = parseSessionGitChangesParams(msg);
+  const { repoRelPath: repoRel, view, commitSha, fileWorkspaceRelPath, fileChange, fileMovedFromWorkspaceRelPath } = changes;
+  const change = parseWorkingTreeChangeKind(fileChange);
+  if (!repoRel || !fileWorkspaceRelPath || !change) {
+    reply({
+      ok: false,
+      error: "changes.repoRelPath, changes.file.workspaceRelPath, and changes.file.change are required"
+    });
+    return;
   }
-];
-var previewSkill = {
-  id: "preview",
-  name: "Preview",
-  description: "Start and manage a local preview server that implements the BuildAutomaton Preview Server API. Configure the command with BUILDAUTOMATON_PREVIEW_COMMAND (default: npm run preview). The server receives PORT and PREVIEW_SECRET and must expose /__preview/status and /__preview/stop.",
-  operations: OPERATIONS,
-  async execute(operationId, params) {
-    const command = getPreviewCommand();
-    switch (operationId) {
-      case "start": {
-        if (previewProcess) {
-          return {
-            ok: false,
-            message: "Preview server already running",
-            url: `http://localhost:${previewPort}`
-          };
-        }
-        const port = params.port ?? (Number(process.env[PREVIEW_PORT_ENV]) || DEFAULT_PORT);
-        previewPort = port;
-        previewSecret = randomSecret();
-        const isWindows = process.platform === "win32";
-        const parts = command.split(/\s+/);
-        const exe = parts[0];
-        const args = parts.slice(1);
-        previewProcess = spawn10(isWindows && exe === "npm" ? "npm.cmd" : exe, args, {
-          cwd: getBridgeRoot(),
-          stdio: ["ignore", "pipe", "pipe"],
-          env: {
-            ...process.env,
-            PORT: String(port),
-            PREVIEW_SECRET: previewSecret
-          }
-        });
-        previewProcess.stdout?.on("data", (d) => process.stdout.write(d));
-        previewProcess.stderr?.on("data", (d) => process.stderr.write(d));
-        previewProcess.on("exit", (code) => {
-          previewProcess = null;
-          if (code !== null && code !== 0) {
-            process.stderr.write(`Preview server exited with code ${code}
-`);
-          }
-        });
-        return {
-          ok: true,
-          message: `Preview server starting (${command}, port=${port})`,
-          url: `http://localhost:${port}`,
-          port
-        };
-      }
-      case "stop": {
-        if (!previewProcess) {
-          return { ok: true, message: "No preview server was running" };
-        }
-        if (!previewSecret) {
-          previewProcess.kill("SIGTERM");
-          previewProcess = null;
-          return { ok: true, message: "Preview process stopped (no secret)" };
-        }
-        try {
-          await requestPreviewApi(
-            previewPort,
-            previewSecret,
-            "POST",
-            `${PREVIEW_API_BASE_PATH}/stop`
-          );
-        } catch (e) {
-          previewProcess.kill("SIGTERM");
-        }
-        previewProcess = null;
-        previewSecret = "";
-        return { ok: true, message: "Preview server stop requested" };
-      }
-      case "status": {
-        if (!previewProcess || !previewSecret) {
-          return {
-            running: previewProcess != null,
-            url: previewProcess ? `http://localhost:${previewPort}` : void 0,
-            message: previewProcess ? `Process running at http://localhost:${previewPort}` : "No preview server running"
-          };
-        }
-        try {
-          const status = await requestPreviewApi(
-            previewPort,
-            previewSecret,
-            "GET",
-            `${PREVIEW_API_BASE_PATH}/status`
-          );
-          return {
-            running: status.status === "running",
-            status: status.status,
-            url: status.url ?? `http://localhost:${previewPort}`,
-            message: status.message ?? (status.status === "running" ? "Preview server running" : "Stopping")
-          };
-        } catch {
-          return {
-            running: previewProcess != null,
-            url: `http://localhost:${previewPort}`,
-            message: "Process running but status endpoint unreachable (server may not implement Preview Server API yet)"
-          };
-        }
-      }
-      default:
-        throw new Error(`Unknown operation: ${operationId}`);
-    }
+  if (view === "commit" && !commitSha) {
+    reply({ ok: false, error: "changes.commitSha is required for commit file patch" });
+    return;
   }
-};
+  const patch = await deps.sessionWorktreeManager.getSessionWorkingTreeChangeFilePatch(msg.sessionId, {
+    repoRelPath: repoRel,
+    workspaceRelPath: fileWorkspaceRelPath,
+    change,
+    movedFromWorkspaceRelPath: fileMovedFromWorkspaceRelPath || null,
+    basis: view === "commit" ? { kind: "commit", sha: commitSha } : { kind: "working" }
+  });
+  reply(
+    {
+      ok: true,
+      patchContent: patch.patchContent ?? null,
+      totalLines: patch.totalLines
+    },
+    ["patchContent"]
+  );
+}
 
-// src/skills/index.ts
-var skills = [previewSkill];
-function getSkill(id) {
-  return skills.find((s) => s.id === id);
+// src/routing/handlers/git/coalesce-list-changes.ts
+var listChangesInflight = /* @__PURE__ */ new Map();
+function normalizeListChangesRepoPathRelativeToWorkspaceRoot(repoRelPath) {
+  if (!repoRelPath?.trim()) return "";
+  return normalizeRepoPathRelativeToWorkspaceRoot(repoRelPath.trim());
 }
-async function callSkill(skillId, operationId, params) {
-  const skill = getSkill(skillId);
-  if (!skill) throw new Error(`Skill not found: ${skillId}`);
-  return skill.execute(operationId, params);
+function listChangesInflightKey(sessionId, opts) {
+  const basis = opts?.basis;
+  return [
+    sessionId,
+    normalizeListChangesRepoPathRelativeToWorkspaceRoot(opts?.repoRelPath),
+    basis?.kind === "commit" ? `commit:${basis.sha}` : "working",
+    String(opts?.recentCommitsLimit ?? "")
+  ].join("|");
 }
-
-// src/skills/handle-skill-call.ts
-function handleSkillCall(msg, socket, log2) {
-  callSkill(msg.skillId, msg.operationId, msg.params ?? {}).then((result) => {
-    sendWsMessage(socket, { type: "skill_result", id: msg.id, result });
-  }).catch((err) => {
-    sendWsMessage(socket, { type: "skill_result", id: msg.id, error: String(err) });
-    log2(`[Bridge service] Skill invocation failed (${msg.skillId}/${msg.operationId}): ${err}`);
+function getSessionWorkingTreeChangeDetailsCoalesced(sessionWorktreeManager, sessionId, opts) {
+  const key = listChangesInflightKey(sessionId, opts);
+  const existing = listChangesInflight.get(key);
+  if (existing) return existing;
+  const promise2 = sessionWorktreeManager.getSessionWorkingTreeChangeDetails(sessionId, opts).finally(() => {
+    if (listChangesInflight.get(key) === promise2) listChangesInflight.delete(key);
   });
+  listChangesInflight.set(key, promise2);
+  return promise2;
 }
 
-// src/routing/handlers/skill-call.ts
-var handleSkillCallMessage = (msg, { getWs, log: log2 }) => {
-  const skillId = typeof msg.skillId === "string" ? msg.skillId : "";
-  const operationId = typeof msg.operationId === "string" ? msg.operationId : "";
-  if (!skillId || !operationId) return;
-  const socket = getWs();
-  if (!socket) return;
-  handleSkillCall(
-    { id: msg.id, skillId, operationId, params: msg.params },
-    socket,
-    log2
+// src/routing/handlers/git/handle-session-git-list-changes.ts
+async function handleSessionGitListChangesAction(deps, msg, reply) {
+  const changes = parseSessionGitChangesParams(msg);
+  const { repoRelPath: repoRel, view, commitSha, recentCommitsLimit } = changes;
+  if (view === "commit") {
+    if (!repoRel || !commitSha) {
+      reply({
+        ok: false,
+        error: "changes.repoRelPath and changes.commitSha are required for commit view"
+      });
+      return;
+    }
+  }
+  const opts = repoRel && view === "commit" && commitSha ? {
+    repoRelPath: repoRel,
+    basis: { kind: "commit", sha: commitSha },
+    recentCommitsLimit
+  } : repoRel ? { repoRelPath: repoRel, basis: { kind: "working" }, recentCommitsLimit } : recentCommitsLimit !== void 0 ? { recentCommitsLimit } : void 0;
+  const repos = await getSessionWorkingTreeChangeDetailsCoalesced(
+    deps.sessionWorktreeManager,
+    msg.sessionId,
+    opts
   );
-};
-
-// src/files/browser/send-file-browser-message.ts
-function sendFileBrowserMessage(socket, e2ee, payload) {
-  sendWsMessage(socket, e2ee ? e2ee.encryptFields(payload, ["entries", "content", "totalLines", "size", "lineOffset"]) : payload);
+  reply({ ok: true, repos }, ["repos"]);
 }
 
-// src/files/browser/handle-file-browser-list.ts
-async function handleFileBrowserList(socket, e2ee, id, reqPath, sessionParentPath, gitScope) {
-  const result = await executeFileBrowserList({ reqPath, sessionParentPath, gitScope });
-  if ("error" in result) {
-    sendWsMessage(socket, { type: "file_browser_response", id, error: result.error });
+// src/routing/handlers/git/handle-session-git-push.ts
+async function handleSessionGitPushAction(deps, sessionId, reply) {
+  const pushRes = await deps.sessionWorktreeManager.pushSessionUpstream(sessionId);
+  if (!pushRes.ok) {
+    reply({ ok: false, error: pushRes.error ?? "Push failed" });
     return;
   }
-  sendFileBrowserMessage(socket, e2ee, { type: "file_browser_response", id, entries: result.entries });
+  const st = await deps.sessionWorktreeManager.getSessionWorkingTreeStatus(sessionId);
+  reply({
+    ok: true,
+    hasUncommittedChanges: st.hasUncommittedChanges,
+    hasUnpushedCommits: st.hasUnpushedCommits,
+    uncommittedFileCount: st.uncommittedFileCount
+  });
 }
 
-// src/files/browser/handle-file-browser-read.ts
-async function handleFileBrowserRead(socket, e2ee, msg, reqPath, sessionParentPath, gitScope) {
-  const result = await executeFileBrowserRead({ msg, reqPath, sessionParentPath, gitScope });
-  if ("error" in result) {
-    sendWsMessage(socket, { type: "file_browser_response", id: msg.id, error: result.error });
-    return;
+// src/routing/handlers/git/handle-session-git-status.ts
+async function handleSessionGitStatusAction(deps, sessionId, reply) {
+  const r = await deps.sessionWorktreeManager.getSessionWorkingTreeStatus(sessionId);
+  reply({
+    ok: true,
+    hasUncommittedChanges: r.hasUncommittedChanges,
+    hasUnpushedCommits: r.hasUnpushedCommits,
+    uncommittedFileCount: r.uncommittedFileCount
+  });
+}
+
+// src/routing/handlers/git/send-session-git-result.ts
+function sendSessionGitResult(ws, id, payload, e2ee, encryptedFields = []) {
+  if (!ws) return;
+  const message = { type: "session_git_result", id, ...payload };
+  let wire = message;
+  if (e2ee && encryptedFields.length > 0) {
+    wire = e2ee.encryptFields(message, encryptedFields);
   }
-  const payload = {
-    type: "file_browser_response",
-    id: msg.id,
-    content: result.content,
-    totalLines: result.totalLines,
-    size: result.size
-  };
-  if (result.lineOffset != null) payload.lineOffset = result.lineOffset;
-  if (result.mimeType != null) payload.mimeType = result.mimeType;
-  if (result.resolvedPath != null) payload.resolvedPath = result.resolvedPath;
-  sendFileBrowserMessage(socket, e2ee, payload);
+  sendWsMessage(ws, wire);
 }
 
-// src/files/browser/index.ts
-init_in_flight();
-function handleFileBrowserRequest(msg, socket, e2ee, sessionWorktreeManager) {
-  beginFileBrowserRequest();
+// src/routing/handlers/git/session-git-request.ts
+var handleSessionGitRequestMessage = (msg, deps) => {
+  if (typeof msg.id !== "string") return;
+  const sessionId = typeof msg.sessionId === "string" ? msg.sessionId : "";
+  const action = msg.action;
+  if (!sessionId || action !== "status" && action !== "push" && action !== "commit" && action !== "list_changes" && action !== "file_diff")
+    return;
   void (async () => {
+    const ws = deps.getWs();
+    const reply = (payload, encryptedFields = []) => sendSessionGitResult(ws, msg.id, payload, deps.e2ee, encryptedFields);
     try {
-      const reqPath = msg.path.replace(/^\/+/, "") || ".";
-      const sessionParentPath = sessionWorktreeManager != null ? await resolveFileBrowserSessionParent(sessionWorktreeManager, msg.sessionId) : void 0;
-      const gitScope = resolveGitBranchScope(msg);
-      if (msg.source === "git_branch" && typeof msg.repoRelPath === "string" && typeof msg.branch === "string" && msg.branch.trim().length > 0 && !gitScope) {
-        sendWsMessage(socket, { type: "file_browser_response", id: msg.id, error: "Invalid repository path" });
+      if (action === "status") {
+        await handleSessionGitStatusAction(deps, sessionId, reply);
         return;
       }
-      if (msg.op === "read") {
-        await handleFileBrowserRead(socket, e2ee, msg, reqPath, sessionParentPath, gitScope);
-      } else {
-        await handleFileBrowserList(socket, e2ee, msg.id, reqPath, sessionParentPath, gitScope);
+      if (action === "list_changes") {
+        await handleSessionGitListChangesAction(deps, { ...msg, sessionId }, reply);
+        return;
       }
-    } finally {
-      endFileBrowserRequest();
+      if (action === "file_diff") {
+        await handleSessionGitGetChangeFilePatchAction(deps, { ...msg, sessionId }, reply);
+        return;
+      }
+      if (action === "push") {
+        await handleSessionGitPushAction(deps, sessionId, reply);
+        return;
+      }
+      await handleSessionGitCommitAction(deps, sessionId, msg, reply);
+    } catch (e) {
+      reply({ ok: false, error: e instanceof Error ? e.message : String(e) });
     }
   })();
-}
+};
 
-// src/files/handle-file-browser-search.ts
-init_yield_to_event_loop();
-import path80 from "node:path";
-var SEARCH_LIMIT = 100;
-function handleFileBrowserSearch(msg, socket, e2ee, sessionWorktreeManager) {
-  void (async () => {
-    await yieldToEventLoop();
-    const q = typeof msg.q === "string" ? msg.q : "";
-    const sessionParentPath = path80.resolve(
-      sessionWorktreeManager != null ? await resolveFileBrowserSessionParent(sessionWorktreeManager, msg.sessionId) : getBridgeRoot()
-    );
-    if (!await bridgeFileIndexIsPopulated(sessionParentPath)) {
-      triggerFileIndexBuild(sessionParentPath);
-      const payload2 = {
-        type: "file_browser_search_response",
-        id: msg.id,
-        paths: [],
-        indexReady: false
-      };
-      sendWsMessage(socket, e2ee ? e2ee.encryptFields(payload2, ["paths"]) : payload2);
+// src/routing/handlers/rename-session-branch.ts
+var handleRenameSessionBranchMessage = (msg, deps) => {
+  const sessionId = typeof msg.sessionId === "string" ? msg.sessionId : "";
+  const newBranch = typeof msg.newBranch === "string" ? msg.newBranch : "";
+  if (!sessionId || !newBranch) return;
+  void deps.sessionWorktreeManager.renameSessionBranch(sessionId, newBranch);
+};
+
+// src/routing/handlers/session-archived.ts
+var handleSessionArchivedMessage = (msg, deps) => {
+  const sessionId = typeof msg.sessionId === "string" ? msg.sessionId : "";
+  if (!sessionId) return;
+  void deps.sessionWorktreeManager.removeSessionWorktrees(sessionId);
+};
+
+// src/routing/handlers/session-discarded.ts
+var handleSessionDiscardedMessage = (msg, deps) => {
+  const sessionId = typeof msg.sessionId === "string" ? msg.sessionId : "";
+  if (!sessionId) return;
+  void deps.sessionWorktreeManager.removeSessionWorktrees(sessionId);
+};
+
+// src/routing/handlers/revert-turn-snapshot.ts
+import * as fs60 from "node:fs";
+var handleRevertTurnSnapshotMessage = (msg, deps) => {
+  const id = typeof msg.id === "string" ? msg.id : "";
+  const sessionId = typeof msg.sessionId === "string" ? msg.sessionId : "";
+  const turnId = typeof msg.turnId === "string" ? msg.turnId : "";
+  if (!id || !sessionId || !turnId) return;
+  const { getWs, log: log2, sessionWorktreeManager } = deps;
+  void (async () => {
+    const s = getWs();
+    if (!s) return;
+    const agentBase = sessionWorktreeManager.getSessionWorktreeRootForSession(sessionId) ?? getBridgeRoot();
+    const file2 = snapshotFilePath(agentBase, turnId);
+    try {
+      await fs60.promises.access(file2, fs60.constants.F_OK);
+    } catch {
+      sendWsMessage(s, {
+        type: "revert_turn_snapshot_result",
+        id,
+        ok: false,
+        error: "No snapshot found for this turn (git state may be unavailable)."
+      });
       return;
     }
-    const results = await searchBridgeFilePathsAsync(sessionParentPath, q, SEARCH_LIMIT);
-    const payload = {
-      type: "file_browser_search_response",
-      id: msg.id,
-      paths: results,
-      indexReady: true
-    };
-    sendWsMessage(socket, e2ee ? e2ee.encryptFields(payload, ["paths"]) : payload);
-  })();
-}
-function triggerFileIndexBuild(sessionParentPath = getBridgeRoot()) {
-  setImmediate(() => {
-    void ensureFileIndexAsync(sessionParentPath).catch((e) => {
-      console.error("[file-index] Background build failed:", e);
+    const res = await applyPreTurnSnapshot(file2, log2);
+    sendWsMessage(s, {
+      type: "revert_turn_snapshot_result",
+      id,
+      ok: res.ok,
+      ...res.error ? { error: res.error } : {}
     });
-  });
+  })();
+};
+
+// src/routing/dispatch/session.ts
+function dispatchBridgeSessionMessage(msg, deps) {
+  switch (msg.type) {
+    case "agent_config":
+      handleAgentConfigMessage(msg, deps);
+      break;
+    case "prompt_queue_state":
+      handlePromptQueueStateMessage(msg, deps);
+      break;
+    case "prompt":
+      handlePromptMessage(msg, deps);
+      break;
+    case "session_git_request":
+      handleSessionGitRequestMessage(msg, deps);
+      break;
+    case "rename_session_branch":
+      handleRenameSessionBranchMessage(msg, deps);
+      break;
+    case "session_archived":
+      handleSessionArchivedMessage(msg, deps);
+      break;
+    case "session_discarded":
+      handleSessionDiscardedMessage(msg, deps);
+      break;
+    case "revert_turn_snapshot":
+      handleRevertTurnSnapshotMessage(msg, deps);
+      break;
+    case "cursor_request_response":
+      handleSessionRequestResponseMessage(msg, deps);
+      break;
+  }
 }
 
-// src/routing/handlers/file-browser-messages.ts
-function handleFileBrowserRequestMessage(msg, { getWs, e2ee, sessionWorktreeManager }) {
-  if (typeof msg.id !== "string" || typeof msg.path !== "string") return;
-  const socket = getWs();
-  if (!socket) return;
-  handleFileBrowserRequest(msg, socket, e2ee, sessionWorktreeManager);
+// src/skills/preview.ts
+import { spawn as spawn10 } from "node:child_process";
+var PREVIEW_API_BASE_PATH = "/__preview";
+var PREVIEW_SECRET_HEADER = "X-Preview-Secret";
+var DEFAULT_PORT = 3e3;
+var DEFAULT_COMMAND = "npm run preview";
+var PREVIEW_COMMAND_ENV = "BUILDAUTOMATON_PREVIEW_COMMAND";
+var PREVIEW_PORT_ENV = "BUILDAUTOMATON_PREVIEW_PORT";
+var previewProcess = null;
+var previewPort = DEFAULT_PORT;
+var previewSecret = "";
+function getPreviewCommand() {
+  return process.env[PREVIEW_COMMAND_ENV]?.trim() || DEFAULT_COMMAND;
 }
-function handleFileBrowserSearchMessage(msg, { getWs, e2ee, sessionWorktreeManager }) {
-  if (typeof msg.id !== "string") return;
-  const socket = getWs();
-  if (!socket) return;
-  handleFileBrowserSearch(
-    msg,
-    socket,
-    e2ee,
-    sessionWorktreeManager
-  );
+function randomSecret() {
+  const bytes = new Uint8Array(32);
+  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+    crypto.getRandomValues(bytes);
+  }
+  return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
 }
-
-// src/code-nav/handlers/send-code-nav-response.ts
-var ENCRYPTED_FIELDS = ["definition", "definitions", "references", "symbols", "confidentTarget"];
-function sendCodeNavResponse(socket, e2ee, payload) {
-  const fieldsToEncrypt = ENCRYPTED_FIELDS.filter((field) => field in payload && payload[field] !== void 0);
-  sendWsMessage(
-    socket,
-    e2ee && fieldsToEncrypt.length > 0 ? e2ee.encryptFields(payload, [...fieldsToEncrypt]) : payload
-  );
+async function requestPreviewApi(port, secret, method, path84, body) {
+  const url2 = `http://127.0.0.1:${port}${path84}`;
+  const headers = {
+    [PREVIEW_SECRET_HEADER]: secret,
+    "Content-Type": "application/json"
+  };
+  const res = await fetch(url2, {
+    method,
+    headers,
+    body: body !== void 0 ? JSON.stringify(body) : void 0
+  });
+  const data = await res.json().catch(() => ({}));
+  if (!res.ok) {
+    throw new Error(data?.error ?? `Preview API ${method} ${path84}: ${res.status}`);
+  }
+  return data;
 }
+var OPERATIONS = [
+  {
+    id: "start",
+    description: "Start the preview server process (runs the configured command with PORT and PREVIEW_SECRET).",
+    params: [
+      { name: "port", description: "Port for the preview server", type: "number", required: false }
+    ]
+  },
+  {
+    id: "stop",
+    description: "Stop the preview server via POST /__preview/stop (graceful shutdown).",
+    params: []
+  },
+  {
+    id: "status",
+    description: "Return status from GET /__preview/status (running, url).",
+    params: []
+  }
+];
+var previewSkill = {
+  id: "preview",
+  name: "Preview",
+  description: "Start and manage a local preview server that implements the BuildAutomaton Preview Server API. Configure the command with BUILDAUTOMATON_PREVIEW_COMMAND (default: npm run preview). The server receives PORT and PREVIEW_SECRET and must expose /__preview/status and /__preview/stop.",
+  operations: OPERATIONS,
+  async execute(operationId, params) {
+    const command = getPreviewCommand();
+    switch (operationId) {
+      case "start": {
+        if (previewProcess) {
+          return {
+            ok: false,
+            message: "Preview server already running",
+            url: `http://localhost:${previewPort}`
+          };
+        }
+        const port = params.port ?? (Number(process.env[PREVIEW_PORT_ENV]) || DEFAULT_PORT);
+        previewPort = port;
+        previewSecret = randomSecret();
+        const isWindows = process.platform === "win32";
+        const parts = command.split(/\s+/);
+        const exe = parts[0];
+        const args = parts.slice(1);
+        previewProcess = spawn10(isWindows && exe === "npm" ? "npm.cmd" : exe, args, {
+          cwd: getBridgeRoot(),
+          stdio: ["ignore", "pipe", "pipe"],
+          env: {
+            ...process.env,
+            PORT: String(port),
+            PREVIEW_SECRET: previewSecret
+          }
+        });
+        previewProcess.stdout?.on("data", (d) => process.stdout.write(d));
+        previewProcess.stderr?.on("data", (d) => process.stderr.write(d));
+        previewProcess.on("exit", (code) => {
+          previewProcess = null;
+          if (code !== null && code !== 0) {
+            process.stderr.write(`Preview server exited with code ${code}
+`);
+          }
+        });
+        return {
+          ok: true,
+          message: `Preview server starting (${command}, port=${port})`,
+          url: `http://localhost:${port}`,
+          port
+        };
+      }
+      case "stop": {
+        if (!previewProcess) {
+          return { ok: true, message: "No preview server was running" };
+        }
+        if (!previewSecret) {
+          previewProcess.kill("SIGTERM");
+          previewProcess = null;
+          return { ok: true, message: "Preview process stopped (no secret)" };
+        }
+        try {
+          await requestPreviewApi(
+            previewPort,
+            previewSecret,
+            "POST",
+            `${PREVIEW_API_BASE_PATH}/stop`
+          );
+        } catch (e) {
+          previewProcess.kill("SIGTERM");
+        }
+        previewProcess = null;
+        previewSecret = "";
+        return { ok: true, message: "Preview server stop requested" };
+      }
+      case "status": {
+        if (!previewProcess || !previewSecret) {
+          return {
+            running: previewProcess != null,
+            url: previewProcess ? `http://localhost:${previewPort}` : void 0,
+            message: previewProcess ? `Process running at http://localhost:${previewPort}` : "No preview server running"
+          };
+        }
+        try {
+          const status = await requestPreviewApi(
+            previewPort,
+            previewSecret,
+            "GET",
+            `${PREVIEW_API_BASE_PATH}/status`
+          );
+          return {
+            running: status.status === "running",
+            status: status.status,
+            url: status.url ?? `http://localhost:${previewPort}`,
+            message: status.message ?? (status.status === "running" ? "Preview server running" : "Stopping")
+          };
+        } catch {
+          return {
+            running: previewProcess != null,
+            url: `http://localhost:${previewPort}`,
+            message: "Process running but status endpoint unreachable (server may not implement Preview Server API yet)"
+          };
+        }
+      }
+      default:
+        throw new Error(`Unknown operation: ${operationId}`);
+    }
+  }
+};
 
-// src/code-nav/handlers/handle-code-nav-request.ts
-function handleCodeNavRequest(msg, socket, e2ee, sessionWorktreeManager) {
-  void (async () => {
-    const body = await executeCodeNavRequest(msg, sessionWorktreeManager);
-    sendCodeNavResponse(socket, e2ee, {
-      type: "code_nav_response",
-      id: msg.id,
-      ...body
-    });
-  })();
+// src/skills/index.ts
+var skills = [previewSkill];
+function getSkill(id) {
+  return skills.find((s) => s.id === id);
+}
+async function callSkill(skillId, operationId, params) {
+  const skill = getSkill(skillId);
+  if (!skill) throw new Error(`Skill not found: ${skillId}`);
+  return skill.execute(operationId, params);
 }
 
-// src/code-nav/handlers/trigger-symbol-index-build.ts
-init_normalize_resolved_path();
+// src/skills/handle-skill-call.ts
+function handleSkillCall(msg, socket, log2) {
+  callSkill(msg.skillId, msg.operationId, msg.params ?? {}).then((result) => {
+    sendWsMessage(socket, { type: "skill_result", id: msg.id, result });
+  }).catch((err) => {
+    sendWsMessage(socket, { type: "skill_result", id: msg.id, error: String(err) });
+    log2(`[Bridge service] Skill invocation failed (${msg.skillId}/${msg.operationId}): ${err}`);
+  });
+}
 
-// src/routing/handlers/code-nav-messages.ts
-function handleFileBrowserCodeNavMessage(msg, { getWs, e2ee, sessionWorktreeManager }) {
-  if (typeof msg.id !== "string" || typeof msg.path !== "string") return;
+// src/routing/handlers/skill-call.ts
+var handleSkillCallMessage = (msg, { getWs, log: log2 }) => {
+  const skillId = typeof msg.skillId === "string" ? msg.skillId : "";
+  const operationId = typeof msg.operationId === "string" ? msg.operationId : "";
+  if (!skillId || !operationId) return;
   const socket = getWs();
   if (!socket) return;
-  handleCodeNavRequest(
-    {
-      id: msg.id,
-      type: "code_nav",
-      op: msg.op === "references" ? "references" : msg.op === "symbols" ? "symbols" : msg.op === "definitions" ? "definitions" : "definition",
-      path: msg.path,
-      line: typeof msg.line === "number" ? msg.line : 1,
-      column: typeof msg.column === "number" ? msg.column : 0,
-      sessionId: msg.sessionId
-    },
+  handleSkillCall(
+    { id: msg.id, skillId, operationId, params: msg.params },
     socket,
-    e2ee,
-    sessionWorktreeManager
+    log2
   );
-}
+};
 
 // src/routing/handlers/skill-layout-request.ts
 function handleSkillLayoutRequest(msg, deps) {
@@ -52585,413 +52830,409 @@ function isValidRemoteSkillInstallItem(item) {
 
 // src/skills/install/install-remote-skills-async.ts
 init_yield_to_event_loop();
-import fs60 from "node:fs";
-import path81 from "node:path";
+import fs61 from "node:fs";
+import path80 from "node:path";
 
 // src/skills/install/constants.ts
 var INSTALL_SKILLS_YIELD_EVERY = 16;
 
 // src/skills/install/install-remote-skills-async.ts
 async function writeInstallFileAsync(skillDir, f, filesWritten) {
-  if (typeof f.path !== "string" || !f.text && !f.base64) return;
-  if (++filesWritten.count % INSTALL_SKILLS_YIELD_EVERY === 0) {
-    await yieldToEventLoop();
-  }
-  const dest = path81.join(skillDir, f.path);
-  await fs60.promises.mkdir(path81.dirname(dest), { recursive: true });
-  if (f.text !== void 0) {
-    await fs60.promises.writeFile(dest, f.text, "utf8");
-  } else if (f.base64) {
-    await fs60.promises.writeFile(dest, Buffer.from(f.base64, "base64"));
-  }
-}
-async function installRemoteSkillsAsync(cwd, targetDir, items) {
-  const installed2 = [];
-  if (!Array.isArray(items)) {
-    return { success: false, error: "Invalid items" };
-  }
-  const filesWritten = { count: 0 };
-  try {
-    for (const item of items) {
-      if (!isValidRemoteSkillInstallItem(item)) continue;
-      const skillDir = path81.join(cwd, targetDir, item.skillName);
-      for (const f of item.files) {
-        await writeInstallFileAsync(skillDir, f, filesWritten);
-      }
-      installed2.push({
-        sourceId: item.sourceId,
-        skillName: item.skillName,
-        versionHash: item.versionHash
-      });
-    }
-    return { success: true, installed: installed2 };
-  } catch (e) {
-    return { success: false, error: e instanceof Error ? e.message : String(e) };
-  }
-}
-
-// src/routing/handlers/install-skills.ts
-var handleInstallSkillsMessage = (msg, deps) => {
-  const id = typeof msg.id === "string" ? msg.id : "";
-  const targetDir = typeof msg.targetDir === "string" && msg.targetDir.trim() ? msg.targetDir.trim() : ".agents/skills";
-  const rawItems = msg.items;
-  const cwd = getBridgeRoot();
-  void (async () => {
-    const socket = deps.getWs();
-    const result = await installRemoteSkillsAsync(cwd, targetDir, rawItems);
-    if (!result.success) {
-      const err = result.error ?? "Invalid items";
-      deps.log(`[Bridge service] Install skills failed: ${err}`);
-      if (socket) {
-        sendWsMessage(socket, { type: "install_skills_result", id, success: false, error: err });
-      }
-      return;
-    }
-    if (socket) {
-      sendWsMessage(socket, { type: "install_skills_result", id, success: true, installed: result.installed });
-    }
-  })();
-};
-
-// src/routing/handlers/refresh-local-skills.ts
-var handleRefreshLocalSkills = (_msg, deps) => {
-  setImmediate(() => {
-    deps.sendLocalSkillsReport?.();
-  });
-};
-
-// src/routing/handlers/git/handle-session-git-commit.ts
-async function handleSessionGitCommitAction(deps, sessionId, msg, reply) {
-  const branch = typeof msg.branch === "string" ? msg.branch : "";
-  const message = typeof msg.message === "string" ? msg.message : "";
-  const pushAfterCommit = msg.pushAfterCommit === true;
-  if (!branch.trim() || !message.trim()) {
-    reply({ ok: false, error: "branch and message are required for commit" });
-    return;
-  }
-  const commitRes = await deps.sessionWorktreeManager.commitSession({
-    sessionId,
-    branch: branch.trim(),
-    message: message.trim(),
-    push: pushAfterCommit
-  });
-  if (!commitRes.ok) {
-    reply({ ok: false, error: commitRes.error ?? "Commit failed" });
-    return;
-  }
-  const st = await deps.sessionWorktreeManager.getSessionWorkingTreeStatus(sessionId);
-  reply({
-    ok: true,
-    hasUncommittedChanges: st.hasUncommittedChanges,
-    hasUnpushedCommits: st.hasUnpushedCommits,
-    uncommittedFileCount: st.uncommittedFileCount
-  });
-}
-
-// src/routing/handlers/git/session-git-changes-params.ts
-function readString(value) {
-  return typeof value === "string" ? value.trim() : "";
-}
-function readChangesObject(msg) {
-  const changes = msg.changes;
-  if (!changes || typeof changes !== "object" || Array.isArray(changes)) return null;
-  return changes;
-}
-function parseSessionGitChangesParams(msg) {
-  const nested = readChangesObject(msg);
-  const file2 = nested?.file && typeof nested.file === "object" && !Array.isArray(nested.file) ? nested.file : null;
-  const repoRelPath = readString(nested?.repoRelPath) || readString(msg.changesRepoRelPath);
-  const viewRaw = nested?.view ?? msg.changesView;
-  const view = viewRaw === "commit" ? "commit" : "working";
-  const commitSha = readString(nested?.commitSha) || readString(msg.changesCommitSha);
-  const recentCommitsLimit = nested?.recentCommitsLimit ?? msg.changesRecentCommitsLimit;
-  return {
-    repoRelPath,
-    view,
-    commitSha,
-    recentCommitsLimit: typeof recentCommitsLimit === "number" || typeof recentCommitsLimit === "string" ? recentCommitsLimit : void 0,
-    fileWorkspaceRelPath: readString(file2?.workspaceRelPath),
-    fileChange: readString(file2?.change),
-    fileMovedFromWorkspaceRelPath: readString(file2?.movedFromWorkspaceRelPath)
-  };
-}
-
-// src/routing/handlers/git/handle-session-git-get-change-file-patch.ts
-async function handleSessionGitGetChangeFilePatchAction(deps, msg, reply) {
-  const changes = parseSessionGitChangesParams(msg);
-  const { repoRelPath: repoRel, view, commitSha, fileWorkspaceRelPath, fileChange, fileMovedFromWorkspaceRelPath } = changes;
-  const change = parseWorkingTreeChangeKind(fileChange);
-  if (!repoRel || !fileWorkspaceRelPath || !change) {
-    reply({
-      ok: false,
-      error: "changes.repoRelPath, changes.file.workspaceRelPath, and changes.file.change are required"
-    });
-    return;
-  }
-  if (view === "commit" && !commitSha) {
-    reply({ ok: false, error: "changes.commitSha is required for commit file patch" });
-    return;
-  }
-  const patch = await deps.sessionWorktreeManager.getSessionWorkingTreeChangeFilePatch(msg.sessionId, {
-    repoRelPath: repoRel,
-    workspaceRelPath: fileWorkspaceRelPath,
-    change,
-    movedFromWorkspaceRelPath: fileMovedFromWorkspaceRelPath || null,
-    basis: view === "commit" ? { kind: "commit", sha: commitSha } : { kind: "working" }
-  });
-  reply(
-    {
-      ok: true,
-      patchContent: patch.patchContent ?? null,
-      totalLines: patch.totalLines
-    },
-    ["patchContent"]
-  );
-}
-
-// src/routing/handlers/git/coalesce-list-changes.ts
-var listChangesInflight = /* @__PURE__ */ new Map();
-function normalizeListChangesRepoPathRelativeToWorkspaceRoot(repoRelPath) {
-  if (!repoRelPath?.trim()) return "";
-  return normalizeRepoPathRelativeToWorkspaceRoot(repoRelPath.trim());
-}
-function listChangesInflightKey(sessionId, opts) {
-  const basis = opts?.basis;
-  return [
-    sessionId,
-    normalizeListChangesRepoPathRelativeToWorkspaceRoot(opts?.repoRelPath),
-    basis?.kind === "commit" ? `commit:${basis.sha}` : "working",
-    String(opts?.recentCommitsLimit ?? "")
-  ].join("|");
+  if (typeof f.path !== "string" || !f.text && !f.base64) return;
+  if (++filesWritten.count % INSTALL_SKILLS_YIELD_EVERY === 0) {
+    await yieldToEventLoop();
+  }
+  const dest = path80.join(skillDir, f.path);
+  await fs61.promises.mkdir(path80.dirname(dest), { recursive: true });
+  if (f.text !== void 0) {
+    await fs61.promises.writeFile(dest, f.text, "utf8");
+  } else if (f.base64) {
+    await fs61.promises.writeFile(dest, Buffer.from(f.base64, "base64"));
+  }
 }
-function getSessionWorkingTreeChangeDetailsCoalesced(sessionWorktreeManager, sessionId, opts) {
-  const key = listChangesInflightKey(sessionId, opts);
-  const existing = listChangesInflight.get(key);
-  if (existing) return existing;
-  const promise2 = sessionWorktreeManager.getSessionWorkingTreeChangeDetails(sessionId, opts).finally(() => {
-    if (listChangesInflight.get(key) === promise2) listChangesInflight.delete(key);
-  });
-  listChangesInflight.set(key, promise2);
-  return promise2;
+async function installRemoteSkillsAsync(cwd, targetDir, items) {
+  const installed2 = [];
+  if (!Array.isArray(items)) {
+    return { success: false, error: "Invalid items" };
+  }
+  const filesWritten = { count: 0 };
+  try {
+    for (const item of items) {
+      if (!isValidRemoteSkillInstallItem(item)) continue;
+      const skillDir = path80.join(cwd, targetDir, item.skillName);
+      for (const f of item.files) {
+        await writeInstallFileAsync(skillDir, f, filesWritten);
+      }
+      installed2.push({
+        sourceId: item.sourceId,
+        skillName: item.skillName,
+        versionHash: item.versionHash
+      });
+    }
+    return { success: true, installed: installed2 };
+  } catch (e) {
+    return { success: false, error: e instanceof Error ? e.message : String(e) };
+  }
 }
 
-// src/routing/handlers/git/handle-session-git-list-changes.ts
-async function handleSessionGitListChangesAction(deps, msg, reply) {
-  const changes = parseSessionGitChangesParams(msg);
-  const { repoRelPath: repoRel, view, commitSha, recentCommitsLimit } = changes;
-  if (view === "commit") {
-    if (!repoRel || !commitSha) {
-      reply({
-        ok: false,
-        error: "changes.repoRelPath and changes.commitSha are required for commit view"
-      });
+// src/routing/handlers/install-skills.ts
+var handleInstallSkillsMessage = (msg, deps) => {
+  const id = typeof msg.id === "string" ? msg.id : "";
+  const targetDir = typeof msg.targetDir === "string" && msg.targetDir.trim() ? msg.targetDir.trim() : ".agents/skills";
+  const rawItems = msg.items;
+  const cwd = getBridgeRoot();
+  void (async () => {
+    const socket = deps.getWs();
+    const result = await installRemoteSkillsAsync(cwd, targetDir, rawItems);
+    if (!result.success) {
+      const err = result.error ?? "Invalid items";
+      deps.log(`[Bridge service] Install skills failed: ${err}`);
+      if (socket) {
+        sendWsMessage(socket, { type: "install_skills_result", id, success: false, error: err });
+      }
       return;
     }
-  }
-  const opts = repoRel && view === "commit" && commitSha ? {
-    repoRelPath: repoRel,
-    basis: { kind: "commit", sha: commitSha },
-    recentCommitsLimit
-  } : repoRel ? { repoRelPath: repoRel, basis: { kind: "working" }, recentCommitsLimit } : recentCommitsLimit !== void 0 ? { recentCommitsLimit } : void 0;
-  const repos = await getSessionWorkingTreeChangeDetailsCoalesced(
-    deps.sessionWorktreeManager,
-    msg.sessionId,
-    opts
-  );
-  reply({ ok: true, repos }, ["repos"]);
+    if (socket) {
+      sendWsMessage(socket, { type: "install_skills_result", id, success: true, installed: result.installed });
+    }
+  })();
+};
+
+// src/agents/install/commands/run-npm-global-install.ts
+import { execFile as execFile9 } from "node:child_process";
+import { promisify as promisify10 } from "node:util";
+var execFileAsync8 = promisify10(execFile9);
+async function runNpmGlobalInstall(packageName, env, timeoutMs = 3e5) {
+  await execFileAsync8("npm", ["install", "-g", packageName], { timeout: timeoutMs, env });
 }
 
-// src/routing/handlers/git/handle-session-git-push.ts
-async function handleSessionGitPushAction(deps, sessionId, reply) {
-  const pushRes = await deps.sessionWorktreeManager.pushSessionUpstream(sessionId);
-  if (!pushRes.ok) {
-    reply({ ok: false, error: pushRes.error ?? "Push failed" });
-    return;
+// src/agents/install/commands/claude-code.ts
+var claudeCodeInstallCommand = {
+  agentType: "claude-code",
+  detectCommand: "claude",
+  async install(ctx) {
+    ctx.onProgress?.("Installing Anthropic Claude Code");
+    await runNpmGlobalInstall("@anthropic-ai/claude-code", {
+      ...ctx.env,
+      ANTHROPIC_API_KEY: ctx.authToken
+    });
   }
-  const st = await deps.sessionWorktreeManager.getSessionWorkingTreeStatus(sessionId);
-  reply({
-    ok: true,
-    hasUncommittedChanges: st.hasUncommittedChanges,
-    hasUnpushedCommits: st.hasUnpushedCommits,
-    uncommittedFileCount: st.uncommittedFileCount
-  });
-}
+};
 
-// src/routing/handlers/git/handle-session-git-status.ts
-async function handleSessionGitStatusAction(deps, sessionId, reply) {
-  const r = await deps.sessionWorktreeManager.getSessionWorkingTreeStatus(sessionId);
-  reply({
-    ok: true,
-    hasUncommittedChanges: r.hasUncommittedChanges,
-    hasUnpushedCommits: r.hasUnpushedCommits,
-    uncommittedFileCount: r.uncommittedFileCount
-  });
-}
+// src/agents/install/commands/codex-acp.ts
+var codexAcpInstallCommand = {
+  agentType: "codex-acp",
+  detectCommand: "codex",
+  async install(ctx) {
+    ctx.onProgress?.("Installing Codex");
+    await runNpmGlobalInstall("@openai/codex", {
+      ...ctx.env,
+      OPENAI_API_KEY: ctx.authToken
+    });
+  }
+};
 
-// src/routing/handlers/git/send-session-git-result.ts
-function sendSessionGitResult(ws, id, payload, e2ee, encryptedFields = []) {
-  if (!ws) return;
-  const message = { type: "session_git_result", id, ...payload };
-  let wire = message;
-  if (e2ee && encryptedFields.length > 0) {
-    wire = e2ee.encryptFields(message, encryptedFields);
+// src/agents/install/commands/cursor-cli.ts
+import { execFile as execFile10 } from "node:child_process";
+import { promisify as promisify11 } from "node:util";
+var execFileAsync9 = promisify11(execFile10);
+var cursorCliInstallCommand = {
+  agentType: "cursor-cli",
+  detectCommand: "agent",
+  async install(ctx) {
+    ctx.onProgress?.("Installing Cursor CLI");
+    await execFileAsync9("bash", ["-lc", "curl -fsSL https://cursor.com/install | bash"], {
+      timeout: 3e5,
+      env: { ...ctx.env, CURSOR_API_KEY: ctx.authToken }
+    });
   }
-  sendWsMessage(ws, wire);
+};
+
+// src/agents/install/commands/opencode.ts
+var opencodeInstallCommand = {
+  agentType: "opencode",
+  detectCommand: "opencode",
+  async install(ctx) {
+    ctx.onProgress?.("Installing OpenCode");
+    await runNpmGlobalInstall("opencode-ai", {
+      ...ctx.env,
+      OPENCODE_API_KEY: ctx.authToken
+    });
+  }
+};
+
+// src/agents/install/commands/index.ts
+var COMMANDS = [
+  claudeCodeInstallCommand,
+  codexAcpInstallCommand,
+  cursorCliInstallCommand,
+  opencodeInstallCommand
+];
+var byType = new Map(COMMANDS.map((c) => [c.agentType, c]));
+function getAgentInstallCommand(agentType) {
+  return byType.get(agentType);
+}
+
+// src/agents/install/install-local-agent.ts
+async function installLocalAgentOnBridge(params) {
+  const spec = INSTALLABLE_BRIDGE_AGENTS.find((a) => a.value === params.agentType);
+  if (!spec) return { success: false, error: `Unsupported agent type: ${params.agentType}` };
+  const command = getAgentInstallCommand(params.agentType);
+  if (!command) return { success: false, error: `No install command for ${params.agentType}` };
+  params.onProgress?.(`Configuring ${spec.label} credentials`);
+  try {
+    await command.install({
+      authToken: params.authToken,
+      onProgress: params.onProgress,
+      env: { ...process.env, [spec.tokenEnvVar]: params.authToken }
+    });
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    return { success: false, error: msg };
+  }
+  const found = await isCommandOnPath(command.detectCommand);
+  if (!found) {
+    return { success: false, error: `${command.detectCommand} not found on PATH after install` };
+  }
+  return { success: true };
 }
 
-// src/routing/handlers/git/session-git-request.ts
-var handleSessionGitRequestMessage = (msg, deps) => {
-  if (typeof msg.id !== "string") return;
-  const sessionId = typeof msg.sessionId === "string" ? msg.sessionId : "";
-  const action = msg.action;
-  if (!sessionId || action !== "status" && action !== "push" && action !== "commit" && action !== "list_changes" && action !== "file_diff")
-    return;
+// src/routing/handlers/install-agent.ts
+var handleInstallAgentMessage = (msg, deps) => {
+  const processId = typeof msg.processId === "string" ? msg.processId : "";
+  const agentId = typeof msg.agentId === "string" ? msg.agentId : "";
+  const tokenId = typeof msg.tokenId === "string" ? msg.tokenId : "";
+  const agentType = typeof msg.agentType === "string" ? msg.agentType : "";
+  const authToken = typeof msg.authToken === "string" ? msg.authToken : "";
+  if (!processId || !agentId || !tokenId || !agentType || !authToken) return;
   void (async () => {
-    const ws = deps.getWs();
-    const reply = (payload, encryptedFields = []) => sendSessionGitResult(ws, msg.id, payload, deps.e2ee, encryptedFields);
-    try {
-      if (action === "status") {
-        await handleSessionGitStatusAction(deps, sessionId, reply);
-        return;
-      }
-      if (action === "list_changes") {
-        await handleSessionGitListChangesAction(deps, { ...msg, sessionId }, reply);
-        return;
-      }
-      if (action === "file_diff") {
-        await handleSessionGitGetChangeFilePatchAction(deps, { ...msg, sessionId }, reply);
-        return;
-      }
-      if (action === "push") {
-        await handleSessionGitPushAction(deps, sessionId, reply);
-        return;
+    const socket = deps.getWs();
+    const report = (step, message) => {
+      if (socket) {
+        sendWsMessage(socket, {
+          type: "install_agent_progress",
+          processId,
+          agentId,
+          tokenId,
+          agentType,
+          step,
+          message
+        });
       }
-      await handleSessionGitCommitAction(deps, sessionId, msg, reply);
-    } catch (e) {
-      reply({ ok: false, error: e instanceof Error ? e.message : String(e) });
+    };
+    const result = await installLocalAgentOnBridge({
+      agentType,
+      authToken,
+      onProgress: (message) => report("agent_install_package", message)
+    });
+    if (socket) {
+      sendWsMessage(socket, {
+        type: "install_agent_result",
+        processId,
+        agentId,
+        tokenId,
+        agentType,
+        success: result.success,
+        error: result.error
+      });
+    }
+    if (!result.success) {
+      deps.log(`[Bridge service] Install agent failed: ${result.error ?? "unknown"}`);
     }
   })();
 };
 
-// src/routing/handlers/rename-session-branch.ts
-var handleRenameSessionBranchMessage = (msg, deps) => {
-  const sessionId = typeof msg.sessionId === "string" ? msg.sessionId : "";
-  const newBranch = typeof msg.newBranch === "string" ? msg.newBranch : "";
-  if (!sessionId || !newBranch) return;
-  void deps.sessionWorktreeManager.renameSessionBranch(sessionId, newBranch);
+// src/routing/handlers/refresh-local-skills.ts
+var handleRefreshLocalSkills = (_msg, deps) => {
+  setImmediate(() => {
+    deps.sendLocalSkillsReport?.();
+  });
 };
 
-// src/routing/handlers/session-archived.ts
-var handleSessionArchivedMessage = (msg, deps) => {
-  const sessionId = typeof msg.sessionId === "string" ? msg.sessionId : "";
-  if (!sessionId) return;
-  void deps.sessionWorktreeManager.removeSessionWorktrees(sessionId);
-};
+// src/routing/dispatch/skills.ts
+function dispatchBridgeSkillsMessage(msg, deps) {
+  switch (msg.type) {
+    case "skill_call":
+      handleSkillCallMessage(msg, deps);
+      break;
+    case "skill_layout_request":
+      handleSkillLayoutRequest(msg, deps);
+      break;
+    case "install_skills":
+      handleInstallSkillsMessage(msg, deps);
+      break;
+    case "install_agent":
+      handleInstallAgentMessage(msg, deps);
+      break;
+    case "refresh_local_skills":
+      handleRefreshLocalSkills(msg, deps);
+      break;
+  }
+}
 
-// src/routing/handlers/session-discarded.ts
-var handleSessionDiscardedMessage = (msg, deps) => {
-  const sessionId = typeof msg.sessionId === "string" ? msg.sessionId : "";
-  if (!sessionId) return;
-  void deps.sessionWorktreeManager.removeSessionWorktrees(sessionId);
-};
+// src/files/browser/send-file-browser-message.ts
+function sendFileBrowserMessage(socket, e2ee, payload) {
+  sendWsMessage(socket, e2ee ? e2ee.encryptFields(payload, ["entries", "content", "totalLines", "size", "lineOffset"]) : payload);
+}
 
-// src/routing/handlers/revert-turn-snapshot.ts
-import * as fs61 from "node:fs";
-var handleRevertTurnSnapshotMessage = (msg, deps) => {
-  const id = typeof msg.id === "string" ? msg.id : "";
-  const sessionId = typeof msg.sessionId === "string" ? msg.sessionId : "";
-  const turnId = typeof msg.turnId === "string" ? msg.turnId : "";
-  if (!id || !sessionId || !turnId) return;
-  const { getWs, log: log2, sessionWorktreeManager } = deps;
+// src/files/browser/handle-file-browser-list.ts
+async function handleFileBrowserList(socket, e2ee, id, reqPath, sessionParentPath, gitScope) {
+  const result = await executeFileBrowserList({ reqPath, sessionParentPath, gitScope });
+  if ("error" in result) {
+    sendWsMessage(socket, { type: "file_browser_response", id, error: result.error });
+    return;
+  }
+  sendFileBrowserMessage(socket, e2ee, { type: "file_browser_response", id, entries: result.entries });
+}
+
+// src/files/browser/handle-file-browser-read.ts
+async function handleFileBrowserRead(socket, e2ee, msg, reqPath, sessionParentPath, gitScope) {
+  const result = await executeFileBrowserRead({ msg, reqPath, sessionParentPath, gitScope });
+  if ("error" in result) {
+    sendWsMessage(socket, { type: "file_browser_response", id: msg.id, error: result.error });
+    return;
+  }
+  const payload = {
+    type: "file_browser_response",
+    id: msg.id,
+    content: result.content,
+    totalLines: result.totalLines,
+    size: result.size
+  };
+  if (result.lineOffset != null) payload.lineOffset = result.lineOffset;
+  if (result.mimeType != null) payload.mimeType = result.mimeType;
+  if (result.resolvedPath != null) payload.resolvedPath = result.resolvedPath;
+  sendFileBrowserMessage(socket, e2ee, payload);
+}
+
+// src/files/browser/index.ts
+init_in_flight();
+function handleFileBrowserRequest(msg, socket, e2ee, sessionWorktreeManager) {
+  beginFileBrowserRequest();
   void (async () => {
-    const s = getWs();
-    if (!s) return;
-    const agentBase = sessionWorktreeManager.getSessionWorktreeRootForSession(sessionId) ?? getBridgeRoot();
-    const file2 = snapshotFilePath(agentBase, turnId);
     try {
-      await fs61.promises.access(file2, fs61.constants.F_OK);
-    } catch {
-      sendWsMessage(s, {
-        type: "revert_turn_snapshot_result",
-        id,
-        ok: false,
-        error: "No snapshot found for this turn (git state may be unavailable)."
-      });
-      return;
+      const reqPath = msg.path.replace(/^\/+/, "") || ".";
+      const sessionParentPath = sessionWorktreeManager != null ? await resolveFileBrowserSessionParent(sessionWorktreeManager, msg.sessionId) : void 0;
+      const gitScope = resolveGitBranchScope(msg);
+      if (msg.source === "git_branch" && typeof msg.repoRelPath === "string" && typeof msg.branch === "string" && msg.branch.trim().length > 0 && !gitScope) {
+        sendWsMessage(socket, { type: "file_browser_response", id: msg.id, error: "Invalid repository path" });
+        return;
+      }
+      if (msg.op === "read") {
+        await handleFileBrowserRead(socket, e2ee, msg, reqPath, sessionParentPath, gitScope);
+      } else {
+        await handleFileBrowserList(socket, e2ee, msg.id, reqPath, sessionParentPath, gitScope);
+      }
+    } finally {
+      endFileBrowserRequest();
     }
-    const res = await applyPreTurnSnapshot(file2, log2);
-    sendWsMessage(s, {
-      type: "revert_turn_snapshot_result",
-      id,
-      ok: res.ok,
-      ...res.error ? { error: res.error } : {}
-    });
   })();
-};
-
-// src/routing/handlers/preview-environment-control.ts
-var handlePreviewEnvironmentControl = (msg, deps) => {
-  let wire;
-  try {
-    wire = deps.e2ee ? deps.e2ee.decryptMessage(msg) : msg;
-  } catch (e) {
-    deps.log(`[E2EE] Could not decrypt preview environment command: ${e instanceof Error ? e.message : String(e)}`);
-    return;
-  }
-  const environmentId = typeof wire.environmentId === "string" ? wire.environmentId : "";
-  const action = wire.action === "start" || wire.action === "stop" ? wire.action : null;
-  if (!environmentId || !action) return;
-  deps.previewEnvironmentManager?.handleControl(environmentId, action);
-};
+}
 
-// src/routing/handlers/preview-environments-config.ts
-var VALID_PORT = (p) => typeof p === "number" && Number.isInteger(p) && p > 0 && p < 65536;
-var handlePreviewEnvironmentsConfig = (msg, deps) => {
-  const previewEnvironments = msg.previewEnvironments;
-  const proxyPorts = Array.isArray(msg.proxyPorts) ? msg.proxyPorts.filter(VALID_PORT) : void 0;
-  setImmediate(() => {
-    deps.previewEnvironmentManager?.applyConfig(previewEnvironments ?? []);
-    const environmentIds = parsePreviewEnvironmentDefs(previewEnvironments ?? []).map((d) => d.environmentId);
-    void deps.previewWorktreeManager?.syncConfiguredEnvironments(environmentIds);
-    if (proxyPorts !== void 0) {
-      deps.updateFirehoseProxyPorts?.(proxyPorts);
+// src/files/handle-file-browser-search.ts
+init_yield_to_event_loop();
+import path81 from "node:path";
+var SEARCH_LIMIT = 100;
+function handleFileBrowserSearch(msg, socket, e2ee, sessionWorktreeManager) {
+  void (async () => {
+    await yieldToEventLoop();
+    const q = typeof msg.q === "string" ? msg.q : "";
+    const sessionParentPath = path81.resolve(
+      sessionWorktreeManager != null ? await resolveFileBrowserSessionParent(sessionWorktreeManager, msg.sessionId) : getBridgeRoot()
+    );
+    if (!await bridgeFileIndexIsPopulated(sessionParentPath)) {
+      triggerFileIndexBuild(sessionParentPath);
+      const payload2 = {
+        type: "file_browser_search_response",
+        id: msg.id,
+        paths: [],
+        indexReady: false
+      };
+      sendWsMessage(socket, e2ee ? e2ee.encryptFields(payload2, ["paths"]) : payload2);
+      return;
     }
+    const results = await searchBridgeFilePathsAsync(sessionParentPath, q, SEARCH_LIMIT);
+    const payload = {
+      type: "file_browser_search_response",
+      id: msg.id,
+      paths: results,
+      indexReady: true
+    };
+    sendWsMessage(socket, e2ee ? e2ee.encryptFields(payload, ["paths"]) : payload);
+  })();
+}
+function triggerFileIndexBuild(sessionParentPath = getBridgeRoot()) {
+  setImmediate(() => {
+    void ensureFileIndexAsync(sessionParentPath).catch((e) => {
+      console.error("[file-index] Background build failed:", e);
+    });
   });
-};
-
-// src/routing/handlers/send-deploy-session-to-preview-result.ts
-function sendDeploySessionToPreviewResult(ws, id, payload) {
-  if (!ws) return;
-  sendWsMessage(ws, { type: "deploy_session_to_preview_result", id, ...payload });
 }
 
-// src/routing/handlers/deploy-session-to-preview.ts
-var handleDeploySessionToPreviewMessage = (msg, deps) => {
+// src/routing/handlers/file-browser-messages.ts
+function handleFileBrowserRequestMessage(msg, { getWs, e2ee, sessionWorktreeManager }) {
+  if (typeof msg.id !== "string" || typeof msg.path !== "string") return;
+  const socket = getWs();
+  if (!socket) return;
+  handleFileBrowserRequest(msg, socket, e2ee, sessionWorktreeManager);
+}
+function handleFileBrowserSearchMessage(msg, { getWs, e2ee, sessionWorktreeManager }) {
   if (typeof msg.id !== "string") return;
-  const sessionId = typeof msg.sessionId === "string" ? msg.sessionId : "";
-  const environmentId = typeof msg.environmentId === "string" ? msg.environmentId : "";
-  if (!sessionId || !environmentId) return;
+  const socket = getWs();
+  if (!socket) return;
+  handleFileBrowserSearch(
+    msg,
+    socket,
+    e2ee,
+    sessionWorktreeManager
+  );
+}
+
+// src/code-nav/handlers/send-code-nav-response.ts
+var ENCRYPTED_FIELDS = ["definition", "definitions", "references", "symbols", "confidentTarget"];
+function sendCodeNavResponse(socket, e2ee, payload) {
+  const fieldsToEncrypt = ENCRYPTED_FIELDS.filter((field) => field in payload && payload[field] !== void 0);
+  sendWsMessage(
+    socket,
+    e2ee && fieldsToEncrypt.length > 0 ? e2ee.encryptFields(payload, [...fieldsToEncrypt]) : payload
+  );
+}
+
+// src/code-nav/handlers/handle-code-nav-request.ts
+function handleCodeNavRequest(msg, socket, e2ee, sessionWorktreeManager) {
   void (async () => {
-    const ws = deps.getWs();
-    const reply = (payload) => sendDeploySessionToPreviewResult(ws, msg.id, payload);
-    try {
-      if (!deps.previewWorktreeManager) {
-        reply({ ok: false, error: "Preview worktree manager unavailable" });
-        return;
-      }
-      const result = await deploySessionToPreviewEnvironment({
-        sessionWorktreeManager: deps.sessionWorktreeManager,
-        previewWorktreeManager: deps.previewWorktreeManager,
-        sessionId,
-        environmentId,
-        log: deps.log
-      });
-      reply(result);
-    } catch (e) {
-      reply({ ok: false, error: e instanceof Error ? e.message : String(e) });
-    }
+    const body = await executeCodeNavRequest(msg, sessionWorktreeManager);
+    sendCodeNavResponse(socket, e2ee, {
+      type: "code_nav_response",
+      id: msg.id,
+      ...body
+    });
   })();
-};
+}
+
+// src/code-nav/handlers/trigger-symbol-index-build.ts
+init_normalize_resolved_path();
+
+// src/routing/handlers/code-nav-messages.ts
+function handleFileBrowserCodeNavMessage(msg, { getWs, e2ee, sessionWorktreeManager }) {
+  if (typeof msg.id !== "string" || typeof msg.path !== "string") return;
+  const socket = getWs();
+  if (!socket) return;
+  handleCodeNavRequest(
+    {
+      id: msg.id,
+      type: "code_nav",
+      op: msg.op === "references" ? "references" : msg.op === "symbols" ? "symbols" : msg.op === "definitions" ? "definitions" : "definition",
+      path: msg.path,
+      line: typeof msg.line === "number" ? msg.line : 1,
+      column: typeof msg.column === "number" ? msg.column : 0,
+      sessionId: msg.sessionId
+    },
+    socket,
+    e2ee,
+    sessionWorktreeManager
+  );
+}
 
 // src/git/bridge-git-context.ts
 import * as path82 from "node:path";
@@ -53138,80 +53379,64 @@ function handleListRepoBranchesRequestMessage(msg, getWs) {
   })();
 }
 
-// src/routing/dispatch-bridge-message.ts
+// src/routing/dispatch/file-browser.ts
+function dispatchBridgeFileBrowserMessage(msg, deps) {
+  switch (msg.type) {
+    case "file_browser_request":
+      handleFileBrowserRequestMessage(msg, deps);
+      break;
+    case "file_browser_search":
+      handleFileBrowserSearchMessage(msg, deps);
+      break;
+    case "code_nav":
+      handleFileBrowserCodeNavMessage(msg, deps);
+      break;
+    case "bridge_git_context_request":
+      handleBridgeGitContextRequestMessage(msg, deps.getWs);
+      break;
+    case "list_repo_branches_request":
+      handleListRepoBranchesRequestMessage(msg, deps.getWs);
+      break;
+  }
+}
+
+// src/routing/dispatch/index.ts
 function dispatchBridgeMessage(msg, deps) {
   switch (msg.type) {
     case "auth_token":
-      handleAuthToken(msg, deps);
-      break;
     case "bridge_identified":
-      handleBridgeIdentified(msg, deps);
-      break;
     case "ha":
-      handleBridgeHeartbeatAck(msg, deps);
+      dispatchBridgeConnectionMessage(msg, deps);
       break;
     case "preview_environments_config":
-      handlePreviewEnvironmentsConfig(msg, deps);
-      break;
     case "preview_environment_control":
-      handlePreviewEnvironmentControl(msg, deps);
-      break;
     case "deploy_session_to_preview":
-      handleDeploySessionToPreviewMessage(msg, deps);
+      dispatchBridgePreviewMessage(msg, deps);
       break;
     case "agent_config":
-      handleAgentConfigMessage(msg, deps);
-      break;
     case "prompt_queue_state":
-      handlePromptQueueStateMessage(msg, deps);
-      break;
     case "prompt":
-      handlePromptMessage(msg, deps);
-      break;
     case "session_git_request":
-      handleSessionGitRequestMessage(msg, deps);
-      break;
     case "rename_session_branch":
-      handleRenameSessionBranchMessage(msg, deps);
-      break;
     case "session_archived":
-      handleSessionArchivedMessage(msg, deps);
-      break;
     case "session_discarded":
-      handleSessionDiscardedMessage(msg, deps);
-      break;
     case "revert_turn_snapshot":
-      handleRevertTurnSnapshotMessage(msg, deps);
-      break;
     case "cursor_request_response":
-      handleSessionRequestResponseMessage(msg, deps);
+      dispatchBridgeSessionMessage(msg, deps);
       break;
     case "skill_call":
-      handleSkillCallMessage(msg, deps);
-      break;
-    case "file_browser_request":
-      handleFileBrowserRequestMessage(msg, deps);
-      break;
-    case "file_browser_search":
-      handleFileBrowserSearchMessage(msg, deps);
-      break;
-    case "code_nav":
-      handleFileBrowserCodeNavMessage(msg, deps);
-      break;
     case "skill_layout_request":
-      handleSkillLayoutRequest(msg, deps);
-      break;
     case "install_skills":
-      handleInstallSkillsMessage(msg, deps);
-      break;
+    case "install_agent":
     case "refresh_local_skills":
-      handleRefreshLocalSkills(msg, deps);
+      dispatchBridgeSkillsMessage(msg, deps);
       break;
+    case "file_browser_request":
+    case "file_browser_search":
+    case "code_nav":
     case "bridge_git_context_request":
-      handleBridgeGitContextRequestMessage(msg, deps.getWs);
-      break;
     case "list_repo_branches_request":
-      handleListRepoBranchesRequestMessage(msg, deps.getWs);
+      dispatchBridgeFileBrowserMessage(msg, deps);
       break;
   }
 }