meshy-node 0.3.2 → 0.3.3

package/main.cjs

@@ -34555,6 +34555,7 @@ var NODE_KIND_BY_LEGACY = {
   "node-workdir-branch-create": "node.workdir.branch-create",
   "node-sessions-list": "node.sessions.list",
   devtunnel: "node.transport.set",
+  "node-agent-upgrade": "node.agent.upgrade",
   "task-cancel": "task.cancel",
   "task-logs": "task.logs",
   "task-output-summary": "task.output.summary",
@@ -35601,6 +35602,9 @@ function compareUpdatedSessions(left, right) {
   const rightTime = right.updatedAt ? Date.parse(right.updatedAt) : 0;
   return rightTime - leftTime || left.sessionId.localeCompare(right.sessionId);
 }
+function getNativeHomeDir() {
+  return process.env.HOME || process.env.USERPROFILE || os4.homedir();
+}
 function findMatchingFiles(rootDir, predicate) {
   if (!fs7.existsSync(rootDir)) {
     return [];
@@ -35747,7 +35751,7 @@ function findClaudeSessionSummary(entries, sessionId) {
   };
 }
 function loadCodexSessionIndex() {
-  const indexPath = path7.join(os4.homedir(), ".codex", "session_index.jsonl");
+  const indexPath = path7.join(getNativeHomeDir(), ".codex", "session_index.jsonl");
   const index = /* @__PURE__ */ new Map();
   for (const entry of readJsonLines(indexPath)) {
     if (typeof entry.id !== "string" || !entry.id.trim()) {
@@ -35797,7 +35801,7 @@ function findCodexSessionSummary(entries, filePath, sessionIndex) {
   };
 }
 function loadClaudeSessionHistory(sessionId) {
-  const projectsDir = path7.join(os4.homedir(), ".claude", "projects");
+  const projectsDir = path7.join(getNativeHomeDir(), ".claude", "projects");
   const sessionFile = findFirstMatchingFile(projectsDir, (filePath) => {
     if (filePath.includes(`${path7.sep}subagents${path7.sep}`)) {
       return false;
@@ -35816,7 +35820,7 @@ function loadClaudeSessionHistory(sessionId) {
   return { logs, sourcePath: sessionFile };
 }
 function loadCodexSessionHistory(sessionId) {
-  const sessionsDir = path7.join(os4.homedir(), ".codex", "sessions");
+  const sessionsDir = path7.join(getNativeHomeDir(), ".codex", "sessions");
   const sessionFile = findFirstMatchingFile(sessionsDir, (filePath) => path7.basename(filePath).toLowerCase().includes(sessionId.toLowerCase()) && filePath.toLowerCase().endsWith(".jsonl"));
   if (!sessionFile) {
     return { logs: [], sourcePath: null };
@@ -35852,7 +35856,7 @@ function loadNativeSessionHistory(input) {
 function listNativeSessions(input) {
   const limit = Math.min(Math.max(1, input.limit ?? 50), 100);
   if (input.agent === "claudecode") {
-    const projectsDir = path7.join(os4.homedir(), ".claude", "projects");
+    const projectsDir = path7.join(getNativeHomeDir(), ".claude", "projects");
     return findMatchingFiles(projectsDir, (filePath) => {
       if (filePath.includes(`${path7.sep}subagents${path7.sep}`)) {
         return false;
@@ -35871,7 +35875,7 @@ function listNativeSessions(input) {
     }).filter((session) => session !== null).sort(compareUpdatedSessions).slice(0, limit);
   }
   const sessionIndex = loadCodexSessionIndex();
-  const sessionsDir = path7.join(os4.homedir(), ".codex", "sessions");
+  const sessionsDir = path7.join(getNativeHomeDir(), ".codex", "sessions");
   return findMatchingFiles(sessionsDir, (filePath) => filePath.toLowerCase().endsWith(".jsonl")).map((filePath) => {
     const summary = findCodexSessionSummary(readJsonLines(filePath), filePath, sessionIndex);
     if (!summary) {
@@ -38287,7 +38291,7 @@ async function apiFetch(ctx, port, apiPath) {
     const body = await res.json().catch(() => null);
     throw new Error(body?.error?.message ?? `API error: ${res.status} ${res.statusText}`);
   }
-  return res.json();
+  return await res.json();
 }
 async function apiWrite(ctx, method, port, apiPath, body) {
   const res = await ctx.fetchImpl(`http://localhost:${port}${apiPath}`, {
@@ -38299,7 +38303,7 @@ async function apiWrite(ctx, method, port, apiPath, body) {
     const data = await res.json().catch(() => null);
     throw new Error(data?.error?.message ?? `HTTP ${res.status}`);
   }
-  return res.json();
+  return await res.json();
 }
 function writeLines(stream, lines) {
   stream.write(`${lines.join("\n")}
@@ -42827,7 +42831,15 @@ var SystemAgentInfoSchema = external_exports.object({
   version: external_exports.string().nullable(),
   checkedAt: external_exports.string(),
   detail: external_exports.string().nullable().optional(),
-  metadataStatus: external_exports.string().nullable().optional()
+  metadataStatus: external_exports.string().nullable().optional(),
+  update: external_exports.object({
+    packageName: external_exports.string(),
+    currentVersion: external_exports.string().nullable(),
+    latestVersion: external_exports.string().nullable(),
+    updateAvailable: external_exports.boolean(),
+    checkedAt: external_exports.string(),
+    detail: external_exports.string().nullable().optional()
+  }).optional()
 });
 var NodeSettingsSnapshotSchema = external_exports.object({
   collectedAt: external_exports.number(),
@@ -44152,7 +44164,7 @@ function getGitDiff(dirPath) {
   const branch = git2(["rev-parse", "--abbrev-ref", "HEAD"], dirPath) || null;
   const staged = git2(["diff", "--cached"], dirPath);
   const unstaged = git2(["diff"], dirPath);
-  const statusOutput = git2(["status", "--porcelain"], dirPath);
+  const statusOutput = git2(["status", "--porcelain", "-uall"], dirPath);
   const changedFiles = [];
   const untrackedFiles = [];
   for (const line of statusOutput.split("\n")) {
@@ -44385,6 +44397,7 @@ var LEGACY_KIND_BY_NODE_MESSAGE = {
   "node.workdir.branch-create": "node-workdir-branch-create",
   "node.sessions.list": "node-sessions-list",
   "node.transport.set": "devtunnel",
+  "node.agent.upgrade": "node-agent-upgrade",
   "task.cancel": "task-cancel",
   "task.logs": "task-logs",
   "task.output.summary": "task-output-summary",
@@ -45144,6 +45157,289 @@ async function createPreviewSessionPayload(deps, taskId, entryPath, requestOrigi
   };
 }
 
+// ../../packages/api/src/node/agent-upgrade-service.ts
+var import_node_child_process9 = require("child_process");
+
+// ../../packages/api/src/app/system-info.ts
+var os6 = __toESM(require("os"), 1);
+var import_node_child_process8 = require("child_process");
+var RUNTIME_TOOLS = [
+  { id: "claude", label: "Claude Code", command: "claude", packageName: "@anthropic-ai/claude-code" },
+  { id: "codex", label: "Codex", command: "codex", packageName: "@openai/codex" }
+];
+var runtimeToolUpdateCache = /* @__PURE__ */ new Map();
+function clearRuntimeToolUpdateCache(packageName) {
+  if (packageName) {
+    runtimeToolUpdateCache.delete(packageName);
+    return;
+  }
+  runtimeToolUpdateCache.clear();
+}
+function runRuntimeToolCommand(command, args, platform2) {
+  const result = (0, import_node_child_process8.spawnSync)(command, args, {
+    encoding: "utf-8",
+    shell: platform2 === "win32" && command !== "where",
+    windowsHide: true,
+    timeout: 2500
+  });
+  return {
+    status: result.status,
+    stdout: typeof result.stdout === "string" ? result.stdout : "",
+    stderr: typeof result.stderr === "string" ? result.stderr : "",
+    error: result.error?.message ?? null
+  };
+}
+function normalizeOutput(output) {
+  if (!output) {
+    return null;
+  }
+  const firstLine = output.split(/\r?\n/).map((line) => line.trim()).find(Boolean);
+  return firstLine ?? null;
+}
+function formatLocalDate(date) {
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  return `${year}-${month}-${day}`;
+}
+function resolveCommandPath(command, commandRunner, platform2) {
+  const lookupCommand = platform2 === "win32" ? "where" : "which";
+  const result = commandRunner(lookupCommand, [command]);
+  if (result.status === 0) {
+    return { path: normalizeOutput(result.stdout) };
+  }
+  return {
+    path: null,
+    detail: normalizeOutput(result.stderr) ?? result.error ?? null
+  };
+}
+function extractSemver(value) {
+  return value?.match(/\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?/)?.[0] ?? null;
+}
+function normalizePackageVersion(output) {
+  if (!output) return null;
+  const trimmed = output.trim();
+  try {
+    const parsed = JSON.parse(trimmed);
+    if (typeof parsed === "string") {
+      return parsed.trim() || null;
+    }
+  } catch {
+  }
+  return normalizeOutput(trimmed);
+}
+function normalizeInstalledPackageVersion(output, packageName) {
+  if (!output) return null;
+  const trimmed = output.trim();
+  try {
+    const parsed = JSON.parse(trimmed);
+    const version2 = parsed.dependencies?.[packageName]?.version;
+    if (typeof version2 === "string") {
+      return version2.trim() || null;
+    }
+  } catch {
+  }
+  return extractSemver(normalizeOutput(trimmed));
+}
+function resolveInstalledPackageVersion(definition, commandRunner) {
+  const result = commandRunner("npm", ["list", "-g", definition.packageName, "--depth=0", "--json"]);
+  return normalizeInstalledPackageVersion(result.stdout ?? null, definition.packageName);
+}
+function compareSemver(left, right) {
+  const leftParts = left.split(/[.-]/).map((part) => Number.parseInt(part, 10));
+  const rightParts = right.split(/[.-]/).map((part) => Number.parseInt(part, 10));
+  for (let index = 0; index < 3; index += 1) {
+    const delta = (leftParts[index] || 0) - (rightParts[index] || 0);
+    if (delta !== 0) return delta;
+  }
+  return 0;
+}
+function checkToolUpdate(definition, installedVersion, checkedAt, commandRunner, checkedOn, updateCache) {
+  const currentVersion = extractSemver(installedVersion);
+  const cached = updateCache.get(definition.packageName);
+  let latestVersion = cached?.latestVersion ?? null;
+  let detail = cached?.detail ?? null;
+  let updateCheckedAt = cached?.checkedAt ?? checkedAt;
+  if (cached?.checkedOn !== checkedOn) {
+    const latestResult = commandRunner("npm", ["view", definition.packageName, "version", "--json"]);
+    latestVersion = latestResult.status === 0 ? normalizePackageVersion(latestResult.stdout ?? null) : null;
+    detail = latestResult.status === 0 ? null : normalizeOutput(latestResult.stderr) ?? latestResult.error ?? "Update check failed";
+    updateCheckedAt = checkedAt;
+    updateCache.set(definition.packageName, {
+      checkedOn,
+      checkedAt,
+      latestVersion,
+      detail
+    });
+  }
+  return {
+    packageName: definition.packageName,
+    currentVersion,
+    latestVersion,
+    updateAvailable: Boolean(currentVersion && latestVersion && compareSemver(latestVersion, currentVersion) > 0),
+    checkedAt: updateCheckedAt,
+    detail
+  };
+}
+function inspectTool(definition, commandRunner, checkedAt, checkedOn, updateCache, platform2) {
+  const resolved = resolveCommandPath(definition.command, commandRunner, platform2);
+  if (!resolved.path) {
+    return {
+      id: definition.id,
+      label: definition.label,
+      command: definition.command,
+      available: false,
+      path: null,
+      version: null,
+      checkedAt,
+      detail: resolved.detail ?? "Command not found on PATH",
+      update: checkToolUpdate(definition, null, checkedAt, commandRunner, checkedOn, updateCache)
+    };
+  }
+  const versionResult = commandRunner(definition.command, ["--version"]);
+  const commandVersion = normalizeOutput(versionResult.stdout) ?? normalizeOutput(versionResult.stderr);
+  const version2 = extractSemver(commandVersion) ? commandVersion : resolveInstalledPackageVersion(definition, commandRunner);
+  const detail = versionResult.status === 0 ? null : normalizeOutput(versionResult.stderr) ?? versionResult.error ?? "Version check failed";
+  return {
+    id: definition.id,
+    label: definition.label,
+    command: definition.command,
+    available: true,
+    path: resolved.path,
+    version: version2,
+    checkedAt,
+    detail,
+    update: checkToolUpdate(definition, version2, checkedAt, commandRunner, checkedOn, updateCache)
+  };
+}
+function inspectRuntimeTools(options = {}) {
+  const platform2 = options.platform ?? process.platform;
+  const commandRunner = options.commandRunner ?? ((command, args) => runRuntimeToolCommand(command, args, platform2));
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  const checkedAt = now.toISOString();
+  const checkedOn = formatLocalDate(now);
+  const updateCache = options.updateCache ?? runtimeToolUpdateCache;
+  return RUNTIME_TOOLS.map((definition) => inspectTool(definition, commandRunner, checkedAt, checkedOn, updateCache, platform2));
+}
+function getOsSnapshot() {
+  const cpus2 = os6.cpus();
+  return {
+    platform: os6.platform(),
+    release: os6.release(),
+    arch: os6.arch(),
+    hostname: os6.hostname(),
+    cpuModel: cpus2[0]?.model ?? null,
+    cpuCount: cpus2.length,
+    totalMemoryBytes: os6.totalmem(),
+    freeMemoryBytes: os6.freemem()
+  };
+}
+function buildNodeSettingsSnapshot(options) {
+  const uptime = process.uptime();
+  const runtimeMetadata = options.runtimeMetadata;
+  const agents = (options.inspectRuntimeTools?.() ?? inspectRuntimeTools()).map((agent) => ({
+    ...agent,
+    metadataStatus: runtimeMetadata?.components?.[agent.id]?.status ?? null
+  }));
+  return {
+    collectedAt: Date.now(),
+    version: runtimeMetadata?.packageVersion ?? "0.1.0",
+    packageName: runtimeMetadata?.packageName ?? "meshy",
+    uptime,
+    auth: options.auth,
+    os: getOsSnapshot(),
+    runtime: {
+      nodeVersion: process.version,
+      pid: process.pid,
+      startedAt: Date.now() - Math.floor(uptime * 1e3),
+      cwd: process.cwd(),
+      workDir: options.workDir ?? null,
+      storagePath: options.storagePath ?? null,
+      localDashboardOrigin: options.localDashboardOrigin ?? null
+    },
+    agents,
+    startupRequirements: {
+      lastCheckedAt: runtimeMetadata?.startupRequirementsLastCheckedAt,
+      lastCheckedOn: runtimeMetadata?.startupRequirementsLastCheckedOn,
+      components: runtimeMetadata?.components ?? {}
+    },
+    components: runtimeMetadata?.components ?? {},
+    repository: runtimeMetadata?.repository ?? {},
+    packages: runtimeMetadata?.packages ?? {}
+  };
+}
+
+// ../../packages/api/src/node/agent-upgrade-service.ts
+var AGENT_PACKAGES = {
+  claude: "@anthropic-ai/claude-code",
+  codex: "@openai/codex"
+};
+var OUTPUT_LIMIT = 4e3;
+function summarizeOutput(value) {
+  const text = value ?? "";
+  return text.length > OUTPUT_LIMIT ? `${text.slice(0, OUTPUT_LIMIT)}\u2026` : text;
+}
+function defaultCommandRunner(command, args) {
+  const result = (0, import_node_child_process9.spawnSync)(command, args, {
+    encoding: "utf-8",
+    shell: process.platform === "win32",
+    windowsHide: true,
+    timeout: 18e4
+  });
+  return {
+    status: result.status,
+    stdout: typeof result.stdout === "string" ? result.stdout : "",
+    stderr: typeof result.stderr === "string" ? result.stderr : "",
+    error: result.error?.message ?? null
+  };
+}
+function isRuntimeAgentId(value) {
+  return value === "claude" || value === "codex";
+}
+function buildUpgradeArgs(agent, packageName) {
+  const args = ["install", "-g", `${packageName}@latest`];
+  if (agent === "claude") {
+    args.push("--include=optional", "--ignore-scripts=false");
+  }
+  return args;
+}
+function upgradeRuntimeAgent(agent, options = {}) {
+  const packageName = AGENT_PACKAGES[agent];
+  if (!packageName) {
+    throw new MeshyError("VALIDATION_ERROR", `Unsupported upgrade agent: ${agent}`, 400);
+  }
+  const command = "npm";
+  const args = buildUpgradeArgs(agent, packageName);
+  const result = (options.commandRunner ?? defaultCommandRunner)(command, args);
+  const ok = result.status === 0 && !result.error;
+  if (ok) {
+    clearRuntimeToolUpdateCache(packageName);
+  }
+  const detail = result.error ?? (summarizeOutput(result.stderr) || "Agent upgrade failed");
+  return {
+    ok,
+    agent,
+    packageName,
+    command,
+    args,
+    status: result.status,
+    stdout: summarizeOutput(result.stdout),
+    stderr: summarizeOutput(result.stderr),
+    detail: ok ? null : detail
+  };
+}
+function upgradeRuntimeAgentForDeps(deps, agent) {
+  const result = deps.upgradeRuntimeAgent?.(agent) ?? upgradeRuntimeAgent(agent);
+  if (result.ok) {
+    const settingsSnapshot = deps.refreshSettingsSnapshot?.();
+    if (settingsSnapshot) {
+      deps.nodeRegistry.updateSettingsSnapshot(deps.nodeRegistry.getSelf().id, settingsSnapshot);
+      return { ...result, settingsSnapshot };
+    }
+  }
+  return result;
+}
+
 // ../../packages/api/src/node/worker-control.ts
 function jsonResponse(requestId, statusCode, body) {
   return {
@@ -45303,6 +45599,14 @@ async function executeWorkerControlRequest(deps, request) {
         });
         break;
       }
+      case "node.agent.upgrade": {
+        const agent = payloadValue(request, "agent", "");
+        if (!isRuntimeAgentId(agent)) {
+          throw new MeshyError("VALIDATION_ERROR", `Unsupported upgrade agent: ${agent}`, 400);
+        }
+        response = jsonResponse(request.id, 200, upgradeRuntimeAgentForDeps(deps, agent));
+        break;
+      }
       case "task.cancel": {
         const taskId = payloadValue(request, "taskId", "");
         const result = cancelTaskOnCurrentNode({
@@ -45446,6 +45750,84 @@ function sendLocalNodeNativeSessions(req, res, nodeId, options = {}) {
   res.json(getLocalNodeNativeSessions(self2.id, query.agent, query.limit));
 }
 
+// ../../packages/api/src/routes/node-agent-upgrade.ts
+function isRecord5(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readSettingsSnapshot(value) {
+  if (!isRecord5(value)) return void 0;
+  const snapshot = value.settingsSnapshot;
+  if (!isRecord5(snapshot)) return void 0;
+  return snapshot;
+}
+function applySyncedSettingsSnapshot(deps, nodeId, body) {
+  const settingsSnapshot = readSettingsSnapshot(body);
+  if (settingsSnapshot) {
+    deps.nodeRegistry.updateSettingsSnapshot(nodeId, settingsSnapshot);
+  }
+}
+function parseAgent(value) {
+  if (isRuntimeAgentId(value)) return value;
+  throw new MeshyError("VALIDATION_ERROR", `Unsupported upgrade agent: ${value}`, 400);
+}
+function upgradeSelfNode(deps, nodeId, agent) {
+  const result = upgradeRuntimeAgentForDeps(deps, agent);
+  applySyncedSettingsSnapshot(deps, nodeId, result);
+  return result;
+}
+async function fallbackUpgrade(deps, res, nodeId, agent) {
+  if (!canRequestNodeMessage(deps.heartbeat)) {
+    throw new MeshyError("NODE_OFFLINE", `Cannot reach node ${nodeId} to upgrade ${agent}`, 502);
+  }
+  const controlResponse = await requestFallbackNodeMessage(
+    deps.heartbeat,
+    nodeId,
+    createNodeMessage("node.agent.upgrade", { agent }, { expectsResponse: true })
+  );
+  applySyncedSettingsSnapshot(deps, nodeId, controlResponse.body);
+  sendWorkerControlResponse(res, controlResponse);
+}
+async function proxyUpgrade(deps, nodeId, agent) {
+  const node = deps.nodeRegistry.getNode(nodeId);
+  if (!node) {
+    throw new MeshyError("NODE_NOT_FOUND", `Node ${nodeId} not found`, 404);
+  }
+  const { response } = await fetchNodeWithFallback(node, `/api/nodes/${nodeId}/agents/${agent}/upgrade`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" }
+  }, void 0, void 0, { preferPublicEndpoint: true });
+  const body = await response.json().catch(() => ({ error: response.statusText }));
+  if (!response.ok) {
+    throw new MeshyError("NODE_OFFLINE", `Remote node returned ${response.status}`, response.status, body);
+  }
+  applySyncedSettingsSnapshot(deps, nodeId, body);
+  return body;
+}
+async function sendNodeAgentUpgrade(req, res, nodeId, agentParam) {
+  const deps = req.app.locals.deps;
+  const agent = parseAgent(agentParam);
+  const self2 = deps.nodeRegistry.getSelf();
+  const isSelf = nodeId === self2.id;
+  if (!isSelf && !deps.election.isLeader()) {
+    throw new MeshyError("NOT_LEADER", "Only the leader can upgrade agents on other nodes", 403);
+  }
+  if (isSelf) {
+    res.json(upgradeSelfNode(deps, nodeId, agent));
+    return;
+  }
+  const canPushToNode = deps.heartbeat?.canPushToNode?.(nodeId) ?? true;
+  if (!canPushToNode) {
+    await fallbackUpgrade(deps, res, nodeId, agent);
+    return;
+  }
+  try {
+    res.json(await proxyUpgrade(deps, nodeId, agent));
+  } catch (err) {
+    if (!canRequestNodeMessage(deps.heartbeat)) throw err;
+    await fallbackUpgrade(deps, res, nodeId, agent);
+  }
+}
+
 // ../../packages/api/src/routes/nodes.ts
 var NODE_WORKDIR_PROXY_TIMEOUT_MS = 1e4;
 var NODE_WORKDIR_BRANCH_PROXY_TIMEOUT_MS = 25e3;
@@ -45785,35 +46167,38 @@ function createNodeRoutes() {
     const query = NodeListQuery.parse(req.query);
     let nodes = nodeRegistry.getAllNodes();
     if (query.status) {
-      nodes = nodes.filter((n) => n.status === query.status);
+      nodes = nodes.filter((node) => node.status === query.status);
     }
-    if (query.capability) {
+    const capability = query.capability;
+    if (capability) {
       nodes = nodes.filter(
-        (n) => n.capabilities && n.capabilities.includes(query.capability)
+        (node) => node.capabilities && node.capabilities.includes(capability)
       );
     }
     res.json({ nodes });
   }));
   router.get("/:id", asyncHandler3(async (req, res) => {
     const { nodeRegistry } = req.app.locals.deps;
-    const node = nodeRegistry.getNode(req.params.id);
+    const nodeId = req.params.id;
+    const node = nodeRegistry.getNode(nodeId);
     if (!node) {
-      throw new MeshyError("NODE_NOT_FOUND", `Node ${req.params.id} not found`, 404);
+      throw new MeshyError("NODE_NOT_FOUND", `Node ${nodeId} not found`, 404);
     }
     res.json(node);
   }));
   router.get("/:id/status", asyncHandler3(async (req, res) => {
     const { nodeRegistry, taskEngine } = req.app.locals.deps;
-    const node = nodeRegistry.getNode(req.params.id);
+    const nodeId = req.params.id;
+    const node = nodeRegistry.getNode(nodeId);
     if (!node) {
-      throw new MeshyError("NODE_NOT_FOUND", `Node ${req.params.id} not found`, 404);
-    }
-    const { tasks } = taskEngine.listTasks({ assignedTo: req.params.id });
-    const taskSummary = tasks.map((t) => ({
-      id: t.id,
-      title: t.title,
-      status: t.status,
-      priority: t.priority
+      throw new MeshyError("NODE_NOT_FOUND", `Node ${nodeId} not found`, 404);
+    }
+    const { tasks } = taskEngine.listTasks({ assignedTo: nodeId });
+    const taskSummary = tasks.map((task) => ({
+      id: task.id,
+      title: task.title,
+      status: task.status,
+      priority: task.priority
     }));
     res.json({ node, tasks: taskSummary });
   }));
@@ -45849,6 +46234,9 @@ function createNodeRoutes() {
     }
     sendLocalNodeWorkDirBranchCreate(req, res, nodeId);
   }));
+  router.post("/:id/agents/:agent/upgrade", asyncHandler3(async (req, res) => {
+    await sendNodeAgentUpgrade(req, res, req.params.id, req.params.agent);
+  }));
   router.patch("/:id", asyncHandler3(async (req, res) => {
     const { nodeRegistry, persistNodeNamePreference } = req.app.locals.deps;
     const updates = UpdateNodeBody.parse(req.body);
@@ -45874,14 +46262,15 @@ function createNodeRoutes() {
   }));
   router.delete("/:id", asyncHandler3(async (req, res) => {
     const { nodeRegistry, election } = req.app.locals.deps;
+    const nodeId = req.params.id;
     if (!election.isLeader()) {
       throw new MeshyError("NOT_LEADER", "Only the leader node can delete nodes", 403);
     }
-    const node = nodeRegistry.getNode(req.params.id);
+    const node = nodeRegistry.getNode(nodeId);
     if (!node) {
-      throw new MeshyError("NODE_NOT_FOUND", `Node ${req.params.id} not found`, 404);
+      throw new MeshyError("NODE_NOT_FOUND", `Node ${nodeId} not found`, 404);
     }
-    nodeRegistry.removeNode(req.params.id);
+    nodeRegistry.removeNode(nodeId);
     res.json({ ok: true });
   }));
   router.post("/:id/devtunnel", asyncHandler3(async (req, res) => {
@@ -46371,14 +46760,15 @@ async function sendTaskLogsResponse(req, res, taskId) {
       selfId
     });
   }
-  if (needsProxy) {
-    const node = nodeRegistry.getNode(task.assignedTo);
+  const assignedTo = task.assignedTo;
+  if (needsProxy && assignedTo) {
+    const node = nodeRegistry.getNode(assignedTo);
     log2.debug("proxy target", { nodeId: node?.id, endpoint: node?.endpoint, devtunnel: node?.devtunnelEndpoint, status: node?.status });
     if (node) {
       const seededLogs = await seedTaskSnapshotOnWorker(task, [], node, log2).catch((err) => {
         log2.warn("failed to seed task snapshot before task logs proxy", {
           taskId,
-          assignedTo: task.assignedTo,
+          assignedTo,
           ...describeProxyError3(err)
         });
         return [];
@@ -46397,24 +46787,24 @@ async function sendTaskLogsResponse(req, res, taskId) {
         const proxyUrl = `${endpoint}${proxyPath}`;
         log2.info("proxying task logs request", {
           taskId,
-          assignedTo: task.assignedTo,
+          assignedTo,
           endpoint,
           proxyPath,
           url: proxyUrl
         });
         if (!proxyRes.ok) throw new MeshyError("NODE_OFFLINE", `Worker log proxy failed (${proxyRes.status})`, 502);
         const data = await proxyRes.json();
-        log2.debug("proxy returned", { logs: data?.logs?.length ?? 0, total: data?.total });
+        log2.debug("proxy returned", { logs: data.logs?.length ?? 0, total: data.total });
         res.json(data);
         return;
       } catch (err) {
         log2.warn("task logs proxy failed; falling back to keepalive control", {
           taskId,
-          assignedTo: task.assignedTo,
+          assignedTo,
           timeoutMs: TASK_LOG_PROXY_TIMEOUT_MS,
           ...describeProxyError3(err)
         });
-        const fallback = await requestTaskLogsOverKeepalive(heartbeat, task.assignedTo, task, after);
+        const fallback = await requestTaskLogsOverKeepalive(heartbeat, assignedTo, task, after);
         if (fallback) {
           sendWorkerControlResponse(res, fallback);
           return;
@@ -47062,13 +47452,14 @@ function createTaskRoutes() {
     const { taskEngine, nodeRegistry, logger: rootLogger } = req.app.locals.deps;
     const log2 = rootLogger.child("tasks/patch");
     const updates = UpdateTaskBody.parse(req.body);
-    const existing = taskEngine.getTask(req.params.id);
+    const taskId = req.params.id;
+    const existing = taskEngine.getTask(taskId);
     if (!existing) {
-      throw new MeshyError("TASK_NOT_FOUND", `Task ${req.params.id} not found`, 404);
+      throw new MeshyError("TASK_NOT_FOUND", `Task ${taskId} not found`, 404);
     }
     if (updates.status !== void 0 && TERMINAL_STATUSES3.has(existing.status) && ACTIVE_STATUSES.has(updates.status)) {
       log2.warn("ignoring stale status regression for terminal task", {
-        taskId: req.params.id,
+        taskId,
         currentStatus: existing.status,
         incomingStatus: updates.status
       });
@@ -47084,33 +47475,35 @@ function createTaskRoutes() {
     }
     if (updates.status !== void 0 && existing.status === "archived" && updates.status !== "archived") {
       log2.warn("ignoring status change for archived task", {
-        taskId: req.params.id,
+        taskId,
         currentStatus: existing.status,
         incomingStatus: updates.status
       });
       res.json(withAssignedNodeMetadata(existing, nodeRegistry));
       return;
     }
-    const task = taskEngine.updateTask(req.params.id, updates);
+    const task = taskEngine.updateTask(taskId, updates);
     if (!task) {
-      throw new MeshyError("TASK_NOT_FOUND", `Task ${req.params.id} not found`, 404);
+      throw new MeshyError("TASK_NOT_FOUND", `Task ${taskId} not found`, 404);
     }
     res.json(withAssignedNodeMetadata(task, nodeRegistry));
   }));
   router.delete("/:id", asyncHandler6(async (req, res) => {
     const { taskEngine } = req.app.locals.deps;
-    const result = taskEngine.deleteTask(req.params.id);
+    const taskId = req.params.id;
+    const result = taskEngine.deleteTask(taskId);
     if (!result) {
-      throw new MeshyError("TASK_NOT_FOUND", `Task ${req.params.id} not found`, 404);
+      throw new MeshyError("TASK_NOT_FOUND", `Task ${taskId} not found`, 404);
     }
     res.json({ ok: true });
   }));
   router.post("/:id/cancel", asyncHandler6(async (req, res) => {
     const { taskEngine, nodeRegistry, engineRegistry, heartbeat, logger: rootLogger } = req.app.locals.deps;
     const log2 = rootLogger.child("tasks/cancel");
-    const task = taskEngine.getTask(req.params.id);
+    const taskId = req.params.id;
+    const task = taskEngine.getTask(taskId);
     if (!task) {
-      throw new MeshyError("TASK_NOT_FOUND", `Task ${req.params.id} not found`, 404);
+      throw new MeshyError("TASK_NOT_FOUND", `Task ${taskId} not found`, 404);
     }
     if (TERMINAL_STATUSES3.has(task.status)) {
       throw new MeshyError("VALIDATION_ERROR", `Task ${task.id} cannot be cancelled (status: ${task.status})`, 400);
@@ -47160,9 +47553,10 @@ function createTaskRoutes() {
     const { taskEngine, engineRegistry, nodeRegistry, heartbeat, logger: rootLogger } = req.app.locals.deps;
     const log2 = rootLogger.child("tasks/message");
     const body = SendMessageBody.parse(req.body);
-    const task = taskEngine.getTask(req.params.id);
+    const taskId = req.params.id;
+    const task = taskEngine.getTask(taskId);
     if (!task) {
-      throw new MeshyError("TASK_NOT_FOUND", `Task ${req.params.id} not found`, 404);
+      throw new MeshyError("TASK_NOT_FOUND", `Task ${taskId} not found`, 404);
     }
     if (!supportsFollowUpAgent(task.agent)) {
       throw new MeshyError("VALIDATION_ERROR", `Agent ${task.agent} does not support chat messages`, 400);
@@ -47594,123 +47988,6 @@ function normalizeNodeMessageResponse(value) {
 
 // ../../packages/api/src/routes/system.ts
 var import_express11 = __toESM(require_express2(), 1);
-
-// ../../packages/api/src/app/system-info.ts
-var os6 = __toESM(require("os"), 1);
-var import_node_child_process8 = require("child_process");
-var RUNTIME_TOOLS = [
-  { id: "claude", label: "Claude Code", command: "claude" },
-  { id: "codex", label: "Codex", command: "codex" }
-];
-function normalizeOutput(output) {
-  if (!output) {
-    return null;
-  }
-  const firstLine = output.split(/\r?\n/).map((line) => line.trim()).find(Boolean);
-  return firstLine ?? null;
-}
-function resolveCommandPath(command) {
-  const lookupCommand = process.platform === "win32" ? "where" : "which";
-  const result = (0, import_node_child_process8.spawnSync)(lookupCommand, [command], {
-    encoding: "utf-8",
-    shell: false,
-    windowsHide: true,
-    timeout: 1500
-  });
-  if (result.status === 0) {
-    return { path: normalizeOutput(result.stdout) };
-  }
-  return {
-    path: null,
-    detail: normalizeOutput(result.stderr) ?? result.error?.message ?? null
-  };
-}
-function inspectTool(definition) {
-  const checkedAt = (/* @__PURE__ */ new Date()).toISOString();
-  const resolved = resolveCommandPath(definition.command);
-  if (!resolved.path) {
-    return {
-      id: definition.id,
-      label: definition.label,
-      command: definition.command,
-      available: false,
-      path: null,
-      version: null,
-      checkedAt,
-      detail: resolved.detail ?? "Command not found on PATH"
-    };
-  }
-  const versionResult = (0, import_node_child_process8.spawnSync)(definition.command, ["--version"], {
-    encoding: "utf-8",
-    shell: process.platform === "win32",
-    windowsHide: true,
-    timeout: 2500
-  });
-  const version2 = normalizeOutput(versionResult.stdout) ?? normalizeOutput(versionResult.stderr);
-  const detail = versionResult.status === 0 ? null : normalizeOutput(versionResult.stderr) ?? versionResult.error?.message ?? "Version check failed";
-  return {
-    id: definition.id,
-    label: definition.label,
-    command: definition.command,
-    available: true,
-    path: resolved.path,
-    version: version2,
-    checkedAt,
-    detail
-  };
-}
-function inspectRuntimeTools() {
-  return RUNTIME_TOOLS.map(inspectTool);
-}
-function getOsSnapshot() {
-  const cpus2 = os6.cpus();
-  return {
-    platform: os6.platform(),
-    release: os6.release(),
-    arch: os6.arch(),
-    hostname: os6.hostname(),
-    cpuModel: cpus2[0]?.model ?? null,
-    cpuCount: cpus2.length,
-    totalMemoryBytes: os6.totalmem(),
-    freeMemoryBytes: os6.freemem()
-  };
-}
-function buildNodeSettingsSnapshot(options) {
-  const uptime = process.uptime();
-  const runtimeMetadata = options.runtimeMetadata;
-  const agents = (options.inspectRuntimeTools?.() ?? inspectRuntimeTools()).map((agent) => ({
-    ...agent,
-    metadataStatus: runtimeMetadata?.components?.[agent.id]?.status ?? null
-  }));
-  return {
-    collectedAt: Date.now(),
-    version: runtimeMetadata?.packageVersion ?? "0.1.0",
-    packageName: runtimeMetadata?.packageName ?? "meshy",
-    uptime,
-    auth: options.auth,
-    os: getOsSnapshot(),
-    runtime: {
-      nodeVersion: process.version,
-      pid: process.pid,
-      startedAt: Date.now() - Math.floor(uptime * 1e3),
-      cwd: process.cwd(),
-      workDir: options.workDir ?? null,
-      storagePath: options.storagePath ?? null,
-      localDashboardOrigin: options.localDashboardOrigin ?? null
-    },
-    agents,
-    startupRequirements: {
-      lastCheckedAt: runtimeMetadata?.startupRequirementsLastCheckedAt,
-      lastCheckedOn: runtimeMetadata?.startupRequirementsLastCheckedOn,
-      components: runtimeMetadata?.components ?? {}
-    },
-    components: runtimeMetadata?.components ?? {},
-    repository: runtimeMetadata?.repository ?? {},
-    packages: runtimeMetadata?.packages ?? {}
-  };
-}
-
-// ../../packages/api/src/routes/system.ts
 function asyncHandler9(fn) {
   return (req, res, next) => fn(req, res, next).catch(next);
 }
@@ -47776,8 +48053,8 @@ function createSystemRoutes() {
       return;
     }
     const { type } = req.body;
-    if (!type || !["direct", "devtunnel", "tailscale"].includes(type)) {
-      res.status(400).json({ error: "Invalid transport type. Must be: direct, devtunnel, or tailscale" });
+    if (!type || !["direct", "devtunnel"].includes(type)) {
+      res.status(400).json({ error: "Invalid transport type. Must be: direct or devtunnel" });
       return;
     }
     const newEndpoint = await switchTransport(type);
@@ -47860,6 +48137,7 @@ function createEventRoutes() {
   const router = (0, import_express12.Router)();
   router.get("/", (req, res) => {
     const { eventBus } = req.app.locals.deps;
+    const stream = res;
     const categories = parseFilter(req.query.filter);
     res.writeHead(200, {
       "Content-Type": "text/event-stream",
@@ -47876,20 +48154,14 @@ data: ${JSON.stringify(data)}
 
 `;
         res.write(payload);
-        if (typeof res.flush === "function") {
-          ;
-          res.flush();
-        }
+        stream.flush?.();
       };
       listeners.set(eventName, listener);
       eventBus.on(eventName, listener);
     }
     const heartbeatTimer = setInterval(() => {
       res.write(": heartbeat\n\n");
-      if (typeof res.flush === "function") {
-        ;
-        res.flush();
-      }
+      stream.flush?.();
     }, HEARTBEAT_INTERVAL_MS);
     req.on("close", () => {
       clearInterval(heartbeatTimer);
@@ -48141,10 +48413,10 @@ var DirectTransport = class {
 };
 
 // ../../packages/transport/src/devtunnel.ts
-var import_node_child_process9 = require("child_process");
+var import_node_child_process10 = require("child_process");
 function isInstalled(cmd) {
   try {
-    (0, import_node_child_process9.execSync)(process.platform === "win32" ? `where ${cmd}` : `command -v ${cmd}`, { stdio: "pipe" });
+    (0, import_node_child_process10.execSync)(process.platform === "win32" ? `where ${cmd}` : `command -v ${cmd}`, { stdio: "pipe" });
     return true;
   } catch {
     return false;
@@ -48167,14 +48439,14 @@ var DevTunnelTransport = class {
       );
     }
     try {
-      (0, import_node_child_process9.execSync)("devtunnel user show", { stdio: "pipe" });
+      (0, import_node_child_process10.execSync)("devtunnel user show", { stdio: "pipe" });
     } catch {
       throw new Error(
         "Not logged in to devtunnel. Run: devtunnel user login"
       );
     }
     const hostArgs = this.buildHostArgs(localPort);
-    const child = (0, import_node_child_process9.spawn)("devtunnel", hostArgs, {
+    const child = (0, import_node_child_process10.spawn)("devtunnel", hostArgs, {
       stdio: ["pipe", "pipe", "pipe"]
     });
     this.process = child;
@@ -48279,7 +48551,7 @@ ${lines.join("")}`
       return;
     }
     try {
-      (0, import_node_child_process9.execFileSync)("devtunnel", ["access", "create", tunnelId, "--tenant"], { stdio: "pipe" });
+      (0, import_node_child_process10.execFileSync)("devtunnel", ["access", "create", tunnelId, "--tenant"], { stdio: "pipe" });
     } catch (err) {
       if (isExistingTenantAccessError(err)) {
         return;
@@ -48295,7 +48567,7 @@ ${lines.join("")}`
       return void 0;
     }
     try {
-      (0, import_node_child_process9.execFileSync)("devtunnel", ["show", tunnelId], { stdio: "pipe" });
+      (0, import_node_child_process10.execFileSync)("devtunnel", ["show", tunnelId], { stdio: "pipe" });
       return tunnelId;
     } catch {
       const createArgs = ["create", tunnelId];
@@ -48303,7 +48575,7 @@ ${lines.join("")}`
         createArgs.push("-a");
       }
       try {
-        (0, import_node_child_process9.execFileSync)("devtunnel", createArgs, { stdio: "pipe" });
+        (0, import_node_child_process10.execFileSync)("devtunnel", createArgs, { stdio: "pipe" });
         return tunnelId;
       } catch (err) {
         throw new Error(
@@ -48315,13 +48587,13 @@ ${lines.join("")}`
   ensureTunnelPort(tunnelId, localPort) {
     const ports = this.listTunnelPorts(tunnelId);
     for (const stalePort of ports.filter((p) => p !== localPort)) {
-      (0, import_node_child_process9.execFileSync)("devtunnel", ["port", "delete", tunnelId, "-p", String(stalePort)], { stdio: "pipe" });
+      (0, import_node_child_process10.execFileSync)("devtunnel", ["port", "delete", tunnelId, "-p", String(stalePort)], { stdio: "pipe" });
     }
     if (ports.includes(localPort)) {
       return;
     }
     try {
-      (0, import_node_child_process9.execFileSync)(
+      (0, import_node_child_process10.execFileSync)(
         "devtunnel",
         ["port", "create", tunnelId, "-p", String(localPort), "--protocol", "http"],
         { stdio: "pipe" }
@@ -48337,7 +48609,7 @@ ${lines.join("")}`
   }
   listTunnelPorts(tunnelId) {
     try {
-      const output = (0, import_node_child_process9.execFileSync)("devtunnel", ["port", "list", tunnelId, "-j"], { stdio: "pipe" });
+      const output = (0, import_node_child_process10.execFileSync)("devtunnel", ["port", "list", tunnelId, "-j"], { stdio: "pipe" });
       const parsed = JSON.parse(output.toString());
       const items = Array.isArray(parsed) ? parsed : parsed && typeof parsed === "object" && Array.isArray(parsed.ports) ? parsed.ports : parsed && typeof parsed === "object" && Array.isArray(parsed.value) ? parsed.value : [];
       return items.map((item) => getPortNumber(item)).filter((value) => value !== void 0);
@@ -48349,7 +48621,7 @@ ${lines.join("")}`
   }
   hasTunnelPort(tunnelId, localPort) {
     try {
-      (0, import_node_child_process9.execFileSync)(
+      (0, import_node_child_process10.execFileSync)(
         "devtunnel",
         ["port", "show", tunnelId, "-p", String(localPort), "-j"],
         { stdio: "pipe" }
@@ -48426,16 +48698,42 @@ function createTransport(config) {
   }
 }
 
+// src/bootstrap/terminal-writer.ts
+function formatDetail(detail) {
+  if (detail instanceof Error) {
+    return detail.stack ?? detail.message;
+  }
+  if (typeof detail === "string") {
+    return detail;
+  }
+  try {
+    return JSON.stringify(detail);
+  } catch {
+    return String(detail);
+  }
+}
+var terminalWriter = {
+  error(message, ...details) {
+    const suffix = details.length > 0 ? ` ${details.map(formatDetail).join(" ")}` : "";
+    process.stderr.write(`${message}${suffix}
+`);
+  },
+  line(message = "") {
+    process.stdout.write(`${message}
+`);
+  }
+};
+
 // src/startup.ts
 var fs19 = __toESM(require("fs"), 1);
 var path20 = __toESM(require("path"), 1);
 var readline = __toESM(require("readline/promises"), 1);
-var import_node_child_process10 = require("child_process");
+var import_node_child_process11 = require("child_process");
 function getDefaultNodeName() {
   return getDeviceNodeName();
 }
 var DEFAULT_NODE_NAME = getDefaultNodeName();
-var SUPPORTED_TRANSPORTS = ["direct", "devtunnel", "tailscale"];
+var SUPPORTED_TRANSPORTS = ["direct", "devtunnel"];
 var STARTUP_REQUIREMENTS = ["az", "devtunnel", "claude", "codex"];
 function createDefaultConfig(storagePath = resolveDefaultStoragePath(), nodeName = DEFAULT_NODE_NAME) {
   return {
@@ -48476,7 +48774,7 @@ function createPromptSession(prompt) {
 }
 function createDefaultCommandRunner(platform2) {
   return (command, args, interactive = false) => {
-    const result = (0, import_node_child_process10.spawnSync)(command, args, {
+    const result = (0, import_node_child_process11.spawnSync)(command, args, {
       encoding: "utf-8",
       shell: platform2 === "win32",
       stdio: interactive ? "inherit" : "pipe"
@@ -48505,7 +48803,7 @@ function writeStartupMetadataFile(storagePath, metadata) {
   fs19.mkdirSync(storagePath, { recursive: true });
   fs19.writeFileSync(getNodeMetadataPath2(storagePath), JSON.stringify(metadata, null, 2) + "\n", "utf-8");
 }
-function formatLocalDate(now) {
+function formatLocalDate2(now) {
   const year = now.getFullYear();
   const month = String(now.getMonth() + 1).padStart(2, "0");
   const day = String(now.getDate()).padStart(2, "0");
@@ -48596,7 +48894,7 @@ function resolveStartupRequirementsMetadata(storagePath) {
 }
 function shouldSkipStartupRequirementsCheck(storagePath, now = /* @__PURE__ */ new Date()) {
   const metadata = resolveStartupRequirementsMetadata(storagePath);
-  if (metadata.lastCheckedOn !== formatLocalDate(now)) {
+  if (metadata.lastCheckedOn !== formatLocalDate2(now)) {
     return false;
   }
   return STARTUP_REQUIREMENTS.every((requirement) => isRequirementSatisfied(requirement, metadata.components?.[requirement]));
@@ -48680,7 +48978,7 @@ async function ensureStartupRequirements(storagePath, options = {}) {
     await current.close();
   };
   const checkedAt = now.toISOString();
-  const checkedOn = formatLocalDate(now);
+  const checkedOn = formatLocalDate2(now);
   const components = {};
   try {
     for (const requirement of STARTUP_REQUIREMENTS) {
@@ -48820,13 +49118,13 @@ async function promptStartOptions(args, fileConfig, defaults, prompt) {
           result.port = port;
           break;
         }
-        console.log("Invalid port. Enter a positive integer.");
+        terminalWriter.line("Invalid port. Enter a positive integer.");
       }
     }
     if (result.transport === void 0) {
       while (true) {
         const input = normalizePromptValue(
-          await ask(formatPrompt("Transport (direct/devtunnel/tailscale)", merged.transport.type))
+          await ask(formatPrompt("Transport (direct/devtunnel)", merged.transport.type))
         );
         if (!input) {
           result.transport = merged.transport.type;
@@ -48836,7 +49134,7 @@ async function promptStartOptions(args, fileConfig, defaults, prompt) {
           result.transport = input;
           break;
         }
-        console.log("Invalid transport. Use direct, devtunnel, or tailscale.");
+        terminalWriter.line("Invalid transport. Use direct or devtunnel.");
       }
     }
     if (result.join === void 0) {
@@ -48924,7 +49222,7 @@ function formatLoadedStartMetadata(info, authEnabled) {
 // src/runtime-metadata.ts
 var fs20 = __toESM(require("fs"), 1);
 var path21 = __toESM(require("path"), 1);
-var import_node_child_process11 = require("child_process");
+var import_node_child_process12 = require("child_process");
 var runtimeDir = resolveRuntimeDir();
 var appRoot = resolveAppRoot(runtimeDir);
 var repoRoot = path21.resolve(appRoot, "../..");
@@ -49020,7 +49318,7 @@ function readRepositoryUrlFromManifest(manifest) {
 }
 function readGitValue(args) {
   try {
-    const output = (0, import_node_child_process11.execFileSync)("git", args, {
+    const output = (0, import_node_child_process12.execFileSync)("git", args, {
       cwd: repoRoot,
       encoding: "utf-8",
       stdio: ["ignore", "pipe", "ignore"],
@@ -49069,11 +49367,7 @@ function buildRuntimeMetadata(storagePath) {
 function createSettingsSnapshotProvider(options) {
   let cachedSnapshot = null;
   let cachedSnapshotAt = 0;
-  return function getSettingsSnapshot() {
-    const now = Date.now();
-    if (cachedSnapshot && now - cachedSnapshotAt < 3e4) {
-      return structuredClone(cachedSnapshot);
-    }
+  function buildSnapshot() {
     cachedSnapshot = buildNodeSettingsSnapshot({
       auth: options.authMetadata,
       localDashboardOrigin: options.localDashboardOrigin,
@@ -49081,8 +49375,23 @@ function createSettingsSnapshotProvider(options) {
       storagePath: options.storagePath,
       workDir: options.workDir
     });
-    cachedSnapshotAt = now;
+    cachedSnapshotAt = Date.now();
     return structuredClone(cachedSnapshot);
+  }
+  function getSettingsSnapshot() {
+    const now = Date.now();
+    if (cachedSnapshot && now - cachedSnapshotAt < 3e4) {
+      return structuredClone(cachedSnapshot);
+    }
+    return buildSnapshot();
+  }
+  return {
+    getSettingsSnapshot,
+    refreshSettingsSnapshot: () => {
+      cachedSnapshot = null;
+      cachedSnapshotAt = 0;
+      return buildSnapshot();
+    }
   };
 }
 async function resolveStartConfig(args) {
@@ -49369,13 +49678,13 @@ function registerShutdownHandlers(options) {
   let shuttingDown = false;
   async function shutdown() {
     if (shuttingDown) {
-      console.log("Force exit.");
+      terminalWriter.line("Force exit.");
       process.exit(130);
     }
     shuttingDown = true;
-    console.log("\nShutting down...");
+    terminalWriter.line("\nShutting down...");
     const forceExitTimer = setTimeout(() => {
-      console.log("Force exit.");
+      terminalWriter.line("Force exit.");
       process.exit(0);
     }, 1e4);
     forceExitTimer.unref?.();
@@ -49385,10 +49694,10 @@ function registerShutdownHandlers(options) {
       await options.tunnelManager.stop();
       await options.meshyNode.stop();
       clearTimeout(forceExitTimer);
-      console.log("Goodbye!");
+      terminalWriter.line("Goodbye!");
       process.exit(0);
     } catch (err) {
-      console.error("Error during shutdown:", err);
+      terminalWriter.error("Error during shutdown:", err);
       process.exit(1);
     }
   }
@@ -49397,9 +49706,9 @@ function registerShutdownHandlers(options) {
 }
 async function startNode(args) {
   const { authMetadata, config, hydratedArgs, runtimeMetadata, storageRoot } = await resolveStartConfig(args);
-  console.log("Checking startup requirements (az, devtunnel, claude, codex)...");
+  terminalWriter.line("Checking startup requirements (az, devtunnel, claude, codex)...");
   const startupRequirements = await ensureStartupRequirements(config.storage.path);
-  console.log(
+  terminalWriter.line(
     startupRequirements.skipped ? "Startup requirements already verified today; skipping checks." : "Startup requirements check complete."
   );
   const localDashboardOrigin = `http://localhost:${config.node.port}`;
@@ -49413,9 +49722,9 @@ async function startNode(args) {
     settingsProvider: () => authMetadata
   });
   if (hydratedArgs.loaded) {
-    console.log("");
-    console.log(formatLoadedStartMetadata(hydratedArgs.loaded, authMetadata.enabled));
-    console.log("");
+    terminalWriter.line("");
+    terminalWriter.line(formatLoadedStartMetadata(hydratedArgs.loaded, authMetadata.enabled));
+    terminalWriter.line("");
   }
   if (authMetadata.enabled) {
     await nodeAuth.warmup();
@@ -49423,13 +49732,14 @@ async function startNode(args) {
   } else {
     setRequestAuthHeadersProvider(null);
   }
-  const getSettingsSnapshot = createSettingsSnapshotProvider({
+  const settingsSnapshotProvider = createSettingsSnapshotProvider({
     authMetadata,
     localDashboardOrigin,
     runtimeMetadata,
     storagePath: config.storage.path,
     workDir: nodePath2.resolve(config.node.workDir ?? process.cwd())
   });
+  const { getSettingsSnapshot, refreshSettingsSnapshot } = settingsSnapshotProvider;
   const meshyNode = new MeshyNode(config, {
     logger: logger27,
     transportFactory: createTransport,
@@ -49512,6 +49822,8 @@ async function startNode(args) {
     },
     isDevTunnelEnabled: () => meshyNode.isDevTunnelEnabled(),
     localDashboardOrigin,
+    upgradeRuntimeAgent,
+    refreshSettingsSnapshot,
     dashboardOrigin: tunnelManager.getDashboardOrigin(),
     shareOrigin: tunnelManager.getShareOrigin(),
     ensureShareTunnel: () => tunnelManager.ensureShareTunnel(),
@@ -49539,9 +49851,9 @@ async function startNode(args) {
       port: config.node.port,
       dashboardOrigin: tunnelManager.getDashboardOrigin()
     });
-    console.log("");
-    console.log(banner);
-    console.log("");
+    terminalWriter.line("");
+    terminalWriter.line(banner);
+    terminalWriter.line("");
   });
   registerShutdownHandlers({
     server,