@dotobokuri/fleet-console 1.60.0 → 1.61.0

package/dist/fleet-plugins/terminal/routes.mjs

@@ -46487,6 +46487,13 @@ function agentLaunchProviderFromModel(model) {
 function isAgentLaunchProvider(value) {
   return value === "claude" || GATEWAY_PROVIDERS.includes(value);
 }
+function agentLaunchProviderFromCliId(cliId) {
+  if (!cliId) return void 0;
+  if (cliId === "claude-gateway" || cliId === "claude") return "claude";
+  const separator = cliId.indexOf(GATEWAY_MODEL_SEPARATOR);
+  const candidate = separator > 0 ? cliId.slice(0, separator) : cliId;
+  return GATEWAY_PROVIDERS.includes(candidate) ? candidate : void 0;
+}
 var BACKGROUND_PENDING_TTL_MS = 30 * 6e4;
 var EMPTY_SETTLED_AGENT_IDS = /* @__PURE__ */ new Set();
 function createConsoleObservabilityStore(deps = {}) {
@@ -46984,18 +46991,38 @@ function readAnalysisProviderSession(value) {
   };
 }
 var MAX_TOOL_DETAIL_CHARS = 160;
+var MAX_TOOL_RESULT_CHARS = 120;
 var MAX_TEXT_CHARS = 6e4;
-function chatEventsFromTranscriptLine(raw, options = {}) {
+var WRITE_TOOLS = /* @__PURE__ */ new Set(["Write", "Edit", "MultiEdit", "NotebookEdit"]);
+var CONTENT_RESULT_TOOLS = /* @__PURE__ */ new Set([
+  "Read",
+  "NotebookRead",
+  "Glob",
+  "Grep",
+  "WebFetch",
+  "WebSearch",
+  "Task",
+  "Agent"
+]);
+var PATH_KEYS = ["file_path", "path", "notebook_path"];
+function chatReplayFromTranscriptLine(raw, options = {}) {
   let line;
   try {
     line = JSON.parse(raw);
   } catch {
-    return [];
+    return { events: [] };
   }
+  const parsedAt = typeof line.timestamp === "string" ? Date.parse(line.timestamp) : Number.NaN;
+  const events = eventsFromTranscriptLine(line, options);
+  return Number.isFinite(parsedAt) ? { at: parsedAt, events } : { events };
+}
+function eventsFromTranscriptLine(line, options) {
   if (line.isMeta === true || line.isSidechain === true || line.isCompactSummary === true) return [];
   const at = typeof line.timestamp === "string" ? Date.parse(line.timestamp) : Number.NaN;
   const atField = Number.isFinite(at) ? { at } : {};
   if (line.type === "user") {
+    const results = toolResultsFrom(line.message?.content, options);
+    if (results.length > 0) return results;
     const text2 = readUserText(line.message?.content);
     return text2 ? [{ kind: "dispatch", text: text2, ...atField }] : [];
   }
@@ -47008,7 +47035,17 @@ function chatEventsFromSdkMessage(message, options = {}) {
   if (message.type === "stream_event") {
     const inner = message.event;
     if (!inner || typeof inner !== "object") return [];
-    if (inner.type !== "content_block_delta") return [];
+    const innerType = inner.type;
+    if (innerType === "content_block_start") {
+      const block = inner.content_block;
+      if (!block || typeof block !== "object") return [];
+      const start = block;
+      if (start.type !== "tool_use") return [];
+      if (typeof start.id !== "string" || start.id.length === 0) return [];
+      if (typeof start.name !== "string" || start.name.length === 0) return [];
+      return [{ kind: "tool-start", id: start.id, name: start.name }];
+    }
+    if (innerType !== "content_block_delta") return [];
     const delta = inner.delta;
     if (!delta || typeof delta !== "object") return [];
     const text2 = delta;
@@ -47021,6 +47058,10 @@ function chatEventsFromSdkMessage(message, options = {}) {
     const body = message.message;
     return eventsFromAssistantContent(body?.content, options);
   }
+  if (message.type === "user") {
+    const body = message.message;
+    return toolResultsFrom(body?.content, options);
+  }
   if (message.type === "result") {
     const durationMs = message.duration_ms;
     const ok = message.is_error !== true;
@@ -47044,11 +47085,37 @@ function eventsFromAssistantContent(content, options) {
       continue;
     }
     if (block.type === "tool_use" && typeof block.name === "string" && block.name.length > 0) {
-      events.push({ kind: "tool", name: block.name, detail: summarizeToolInput(block.input, options) });
+      const change = changeFromToolInput(block.name, block.input, options);
+      events.push({
+        kind: "tool",
+        name: block.name,
+        detail: summarizeToolInput(block.input, options),
+        ...typeof block.id === "string" && block.id.length > 0 ? { id: block.id } : {},
+        ...pathIsOutsideCwd(block.input, options.cwd) ? { outside: true } : {},
+        ...change ? { change } : {}
+      });
     }
   }
   return events;
 }
+function toolResultsFrom(content, options) {
+  if (!Array.isArray(content)) return [];
+  const events = [];
+  for (const block of content) {
+    if (!block || typeof block !== "object" || block.type !== "tool_result") continue;
+    if (typeof block.tool_use_id !== "string" || block.tool_use_id.length === 0) continue;
+    const ok = block.is_error !== true;
+    const tool = options.toolNames?.get(block.tool_use_id);
+    const quiet = ok && tool !== void 0 && (CONTENT_RESULT_TOOLS.has(tool) || WRITE_TOOLS.has(tool));
+    events.push({
+      kind: "tool-result",
+      id: block.tool_use_id,
+      ok,
+      summary: quiet ? "" : summarizeToolResult(block.content, options)
+    });
+  }
+  return events;
+}
 function readUserText(content) {
   if (typeof content === "string") return normalizeDispatchText(content);
   if (!Array.isArray(content)) return null;
@@ -47068,16 +47135,107 @@ function normalizeDispatchText(text2) {
 function summarizeToolInput(input, options = {}) {
   if (!input || typeof input !== "object" || Array.isArray(input)) return "";
   const record7 = input;
-  for (const key of ["file_path", "path", "command", "pattern", "url", "query", "description", "prompt", "subject"]) {
+  for (const key of PATH_KEYS.concat(["command", "pattern", "url", "query", "description", "prompt", "subject"])) {
     const value = record7[key];
     if (typeof value === "string" && value.trim().length > 0) {
       const flat = value.replace(/\s+/g, " ").trim();
-      const shown = key === "file_path" || key === "path" ? displayPath(flat, options.cwd) : normalizePathTokens(flat, options.cwd);
+      const shown = PATH_KEYS.includes(key) ? displayPath(flat, options.cwd) : normalizePathTokens(flat, options.cwd);
       return shown.length > MAX_TOOL_DETAIL_CHARS ? `${shown.slice(0, MAX_TOOL_DETAIL_CHARS - 1)}\u2026` : shown;
     }
   }
   return "";
 }
+function summarizeToolResult(content, options = {}) {
+  const text2 = readResultText(content);
+  if (text2 === null) return "";
+  const first = text2.split("\n").map((line) => line.trim()).find((line) => line.length > 0);
+  if (first === void 0) return "";
+  const flat = normalizePathTokens(first.replace(/\s+/g, " ").trim(), options.cwd);
+  const masked = maskSecrets(abbreviateAbsolutePaths(flat));
+  return masked.length > MAX_TOOL_RESULT_CHARS ? `${masked.slice(0, MAX_TOOL_RESULT_CHARS - 1)}\u2026` : masked;
+}
+var QUOTED_ABSOLUTE_PATH = /(['"`])((?:[A-Za-z]:[\\/]|\\\\|\/)[^'"`\n]*)\1/g;
+var BARE_ABSOLUTE_PATH = /(?<![^\s'"`([{=<])(?:[A-Za-z]:[\\/]|\\\\|\/)[^\s'"`,;:()[\]<>]+/g;
+function abbreviateAbsolutePaths(value) {
+  return value.replace(QUOTED_ABSOLUTE_PATH, (_match, quote, path46) => `${quote}${foldPath(path46)}${quote}`).replace(BARE_ABSOLUTE_PATH, (match) => foldPath(match));
+}
+function foldPath(path46) {
+  const segments = path46.split(/[\\/]/).filter((segment) => segment.length > 0 && !/^[A-Za-z]:$/.test(segment));
+  if (segments.length === 0) return path46;
+  return `\u2026/${segments.slice(-2).join("/")}`;
+}
+function readResultText(content) {
+  if (typeof content === "string") return content;
+  if (!Array.isArray(content)) return null;
+  const parts = [];
+  for (const block of content) {
+    if (block?.type === "text" && typeof block.text === "string") parts.push(block.text);
+  }
+  return parts.length > 0 ? parts.join("\n") : null;
+}
+function maskSecrets(value) {
+  return value.replace(/\b(sk|pk|rk)-[A-Za-z0-9_-]{16,}/g, "$1-\u2026").replace(/\b(gh[pousr]|xox[baprs])_[A-Za-z0-9_-]{16,}/g, "$1_\u2026").replace(/\bAKIA[0-9A-Z]{12,}/g, "AKIA\u2026").replace(/\b(?:Bearer|Authorization:)\s+[A-Za-z0-9._~+/=-]{16,}/gi, "Bearer \u2026").replace(/\beyJ[A-Za-z0-9._-]{24,}/g, "eyJ\u2026");
+}
+function changeFromToolInput(name, input, options = {}) {
+  if (!WRITE_TOOLS.has(name)) return null;
+  if (!input || typeof input !== "object" || Array.isArray(input)) return null;
+  const record7 = input;
+  const raw = PATH_KEYS.map((key) => record7[key]).find((value) => typeof value === "string" && value.trim().length > 0) ?? null;
+  if (raw === null) return null;
+  const file2 = displayPath(raw.trim(), options.cwd);
+  if (name === "Write") {
+    return { file: file2, added: lineCount(record7.content), removed: 0 };
+  }
+  if (name === "Edit") {
+    return { file: file2, added: lineCount(record7.new_string), removed: lineCount(record7.old_string) };
+  }
+  if (name === "MultiEdit") {
+    let added = 0;
+    let removed = 0;
+    const edits = Array.isArray(record7.edits) ? record7.edits : [];
+    for (const edit of edits) {
+      if (!edit || typeof edit !== "object") continue;
+      const entry = edit;
+      added += lineCount(entry.new_string);
+      removed += lineCount(entry.old_string);
+    }
+    return { file: file2, added, removed };
+  }
+  return { file: file2, added: 0, removed: 0 };
+}
+function lineCount(value) {
+  if (typeof value !== "string" || value.length === 0) return 0;
+  return value.replace(/\n$/, "").split("\n").length;
+}
+function pathIsOutsideCwd(input, cwd) {
+  if (!cwd || !input || typeof input !== "object" || Array.isArray(input)) return false;
+  const record7 = input;
+  for (const key of PATH_KEYS) {
+    const value = record7[key];
+    if (typeof value !== "string" || value.trim().length === 0) continue;
+    const normalized = resolveDotSegments(value.trim().replace(/\\/g, "/"));
+    if (!normalized.startsWith("/") && !/^[A-Za-z]:\//.test(normalized)) return false;
+    const root = resolveDotSegments(cwd.replace(/\\/g, "/")).replace(/\/+$/, "");
+    if (root.length <= 1) return false;
+    return normalized !== root && !normalized.startsWith(`${root}/`);
+  }
+  return false;
+}
+function resolveDotSegments(path46) {
+  if (!path46.includes("./") && !path46.endsWith("/.") && !path46.endsWith("/..")) return path46;
+  const parts = path46.split("/");
+  const out = [];
+  for (const part of parts) {
+    if (part === ".") continue;
+    if (part === "..") {
+      if (out.length > 1 || out.length === 1 && out[0] !== "") out.pop();
+      continue;
+    }
+    out.push(part);
+  }
+  const joined = out.join("/");
+  return joined.length > 0 ? joined : "/";
+}
 function normalizePathTokens(value, cwd) {
   let result = value;
   if (cwd) {
@@ -47089,10 +47247,10 @@ function normalizePathTokens(value, cwd) {
   return result;
 }
 function displayPath(value, cwd) {
-  const normalized = value.replace(/\\/g, "/");
+  const normalized = resolveDotSegments(value.replace(/\\/g, "/"));
   if (!normalized.startsWith("/") && !/^[A-Za-z]:\//.test(normalized)) return value;
   if (cwd) {
-    const root = cwd.replace(/\\/g, "/").replace(/\/+$/, "");
+    const root = resolveDotSegments(cwd.replace(/\\/g, "/")).replace(/\/+$/, "");
     if (normalized === root) return ".";
     if (normalized.startsWith(`${root}/`)) return normalized.slice(root.length + 1);
   }
@@ -47105,6 +47263,7 @@ function capText(text2) {
 
 // ../fleet-plugins/terminal/server/agent-api/chat-session.ts
 var JOURNAL_CAP = 2e3;
+var TOOL_NAME_CAP = 500;
 var AgentChatSession = class {
   operationId;
   seed;
@@ -47122,6 +47281,12 @@ var AgentChatSession = class {
   turnFlight = Promise.resolve();
   pendingTurns = 0;
   disposed = false;
+  /**
+   * tool_use id → 도구 이름. 결과 블록은 자기가 어떤 도구의 결말인지 모르는데, 무엇을 요약해도
+   * 되는지는 도구가 정한다(읽기·쓰기 계열의 성공 결과는 내용이라 싣지 않는다). 긴 세션에서
+   * 무한히 자라지 않게 상한을 두고 오래된 것부터 버린다 — 결과는 호출 직후에 오므로 잃을 게 없다.
+   */
+  toolNames = /* @__PURE__ */ new Map();
   constructor(operationId, seed, createSdk) {
     this.operationId = operationId;
     this.seed = seed;
@@ -47136,15 +47301,32 @@ var AgentChatSession = class {
     const transcriptPath = this.seed.origin.transcriptPath;
     this.push({ kind: "replay-start" });
     let turns = 0;
+    let turnAt = null;
+    let lastAt = null;
+    const closeReplayedTurn = () => {
+      if (turnAt !== null && lastAt !== null && lastAt > turnAt) {
+        this.push({ kind: "turn-end", ok: true, durationMs: lastAt - turnAt });
+      }
+      turnAt = null;
+      lastAt = null;
+    };
     try {
       const raw = await promises.readFile(transcriptPath, "utf8");
       for (const line of raw.split("\n")) {
         if (line.trim().length === 0) continue;
-        for (const event of chatEventsFromTranscriptLine(line, { cwd: this.seed.cwd })) {
-          if (event.kind === "dispatch") turns += 1;
+        const mapped = chatReplayFromTranscriptLine(line, { cwd: this.seed.cwd, toolNames: this.toolNames });
+        for (const event of mapped.events) {
+          if (event.kind === "dispatch") {
+            closeReplayedTurn();
+            turns += 1;
+            turnAt = mapped.at ?? null;
+          }
+          this.rememberTool(event);
           this.push(event);
         }
+        if (mapped.events.length > 0 && mapped.at !== void 0) lastAt = mapped.at;
       }
+      closeReplayedTurn();
     } catch {
       this.push({ kind: "error", code: "chat_replay_unavailable" });
     }
@@ -47185,6 +47367,16 @@ var AgentChatSession = class {
     await this.turnFlight.catch(() => void 0);
     this.listeners.clear();
   }
+  /** 도구 이벤트가 지나갈 때 id→이름을 적어 둔다. 결과 요약 정책이 이 축 위에서 결정된다. */
+  rememberTool(event) {
+    if (event.kind !== "tool" && event.kind !== "tool-start") return;
+    if (event.id === void 0) return;
+    this.toolNames.set(event.id, event.name);
+    if (this.toolNames.size > TOOL_NAME_CAP) {
+      const oldest = this.toolNames.keys().next();
+      if (!oldest.done) this.toolNames.delete(oldest.value);
+    }
+  }
   push(event) {
     const entry = { seq: ++this.seq, event };
     this.journal.push(entry);
@@ -47264,9 +47456,10 @@ var AgentChatSession = class {
           if (typeof message.session_id === "string" && message.session_id.length > 0) {
             this.latestSessionId = message.session_id;
           }
-          for (const event of chatEventsFromSdkMessage(message, { cwd: this.seed.cwd })) {
+          for (const event of chatEventsFromSdkMessage(message, { cwd: this.seed.cwd, toolNames: this.toolNames })) {
             if (event.kind === "turn-end") sawResult = true;
-            if (event.kind === "text-delta") this.pushEphemeral(event);
+            this.rememberTool(event);
+            if (event.kind === "text-delta" || event.kind === "tool-start") this.pushEphemeral(event);
             else this.push(event);
           }
         }
@@ -47727,7 +47920,10 @@ function buildAgentLaunchKindBackfillPatch(operation) {
 function buildAgentLaunchProviderBackfillPatch(operation) {
   if (operation.pluginId !== TERMINAL_PLUGIN_ID || operation.type !== AGENT_OPERATION_TYPE) return null;
   if (isAgentLaunchProvider(operation.payload[AGENT_LAUNCH_PROVIDER_PAYLOAD_KEY])) return null;
-  return { payload: { ...operation.payload, [AGENT_LAUNCH_PROVIDER_PAYLOAD_KEY]: "claude" } };
+  const cliId = typeof operation.payload.cliId === "string" ? operation.payload.cliId : void 0;
+  const provider = agentLaunchProviderFromCliId(cliId);
+  if (!provider) return null;
+  return { payload: { ...operation.payload, [AGENT_LAUNCH_PROVIDER_PAYLOAD_KEY]: provider } };
 }
 function buildGatewayLoadoutTools(deps) {
   const readAiGatewaySettings = deps.readAiGatewaySettings;
@@ -48129,7 +48325,7 @@ async function createAgentApi(ctx, terminalRuntime, deps) {
       if (launchOptions.attachmentIds && launchOptions.attachmentIds.length > 0) {
         launchAttachments.unreserve(launchOptions.attachmentIds);
       }
-      ctx.host.http.writeJson(res, 409, { error: "agent_cli_unavailable" });
+      ctx.host.http.writeJson(res, 409, { error: meta3 && !meta3.available ? "agent_cli_not_installed" : "agent_cli_signed_out" });
       return;
     }
     const sessionId = crypto5.randomUUID();
@@ -48205,7 +48401,7 @@ async function createAgentApi(ctx, terminalRuntime, deps) {
       }
       pendingRuntimeSessions.delete(sessionId);
       observability.updateTerminalSessionStatus(sessionId, "error");
-      ctx.host.http.writeJson(res, 503, { error: "terminal_unavailable" });
+      ctx.host.http.writeJson(res, 503, { error: classifyLaunchSpawnFailure(error51) });
     }
   }
   async function handleResume(req, res, sessionId) {
@@ -48730,7 +48926,12 @@ async function createAgentApi(ctx, terminalRuntime, deps) {
         terminalRuntime.invalidateTicketsForSession(operationId);
         observability.notifySessionUpdated(dormant);
         const exitCwd = readPayloadString(ctx.host.operations.get(operationId)?.payload ?? {}, "cwd") ?? "";
-        ctx.host.operations.patch(operationId, { payload: toOperationPayload(ctx.host.operations.get(operationId)?.payload, exitCwd, dormant, providerSession, observability.getDurableOperation(operationId)?.providerTitle) });
+        ctx.host.operations.patch(operationId, {
+          payload: {
+            ...toOperationPayload(ctx.host.operations.get(operationId)?.payload, exitCwd, dormant, providerSession, observability.getDurableOperation(operationId)?.providerTitle),
+            restoredDormant: true
+          }
+        });
       }
     } else {
       observability.removeTerminalSession(operationId);
@@ -48838,14 +49039,23 @@ async function createAgentApi(ctx, terminalRuntime, deps) {
       if (operation.pluginId !== ctx.pluginId || operation.type !== AGENT_OPERATION_TYPE) continue;
       const providerSession = readProviderSession(operation.payload);
       const chatBorn = operation.payload[CHAT_BORN_PAYLOAD_KEY] === true;
-      if (!providerSession && !chatBorn || observability.getTerminalSessionInfo(operation.id)) continue;
+      if (observability.getTerminalSessionInfo(operation.id)) continue;
+      if (!providerSession && !chatBorn) {
+        ctx.host.operations.patch(operation.id, { payload: { ...operation.payload, restoredDormant: true } });
+        continue;
+      }
       const dormant = injectOperation(operation);
       if (operation.payload[CHAT_MODE_PAYLOAD_KEY] === true) {
         const adopted = observability.setTerminalSessionChatActive(operation.id, true);
         if (adopted) observability.notifySessionUpdated(adopted);
       }
       const cwd = readPayloadString(operation.payload, "cwd") || (ctx.host.paths.resolveTheaterPath(operation.theaterId) ?? "");
-      ctx.host.operations.patch(operation.id, { payload: toOperationPayload(operation.payload, cwd, dormant, providerSession, observability.getDurableOperation(operation.id)?.providerTitle) });
+      ctx.host.operations.patch(operation.id, {
+        payload: {
+          ...toOperationPayload(operation.payload, cwd, dormant, providerSession, observability.getDurableOperation(operation.id)?.providerTitle),
+          restoredDormant: true
+        }
+      });
     }
   }
   function backfillAgentOperationLaunchAxes() {
@@ -48894,7 +49104,7 @@ function createTerminalWikiToolSpecs(fleetDataDir) {
 }
 function toOperationPayload(existing, cwd, session, providerSession, providerTitle) {
   const payload = { ...existing ?? {} };
-  for (const key of ["cwd", "cliId", "launchKindId", "cliLabel", "providerSession", "labelSource", "providerTitle"]) {
+  for (const key of ["cwd", "cliId", "launchKindId", "cliLabel", "providerSession", "labelSource", "providerTitle", "restoredDormant"]) {
     delete payload[key];
   }
   return {
@@ -48980,6 +49190,12 @@ function readHookPrompt(value) {
     return void 0;
   }
 }
+function classifyLaunchSpawnFailure(error51) {
+  const code = error51?.code;
+  if (code === "ENOENT") return "agent_cli_binary_missing";
+  if (code === "EACCES" || code === "EPERM") return "agent_cli_not_executable";
+  return "terminal_unavailable";
+}
 var DEFAULT_MAX_READ = 4 * 1024 * 1024;
 var DEFAULT_MAX_REFRESH = 32 * 1024 * 1024;
 var CONTINUITY_BYTES = 4 * 1024;
@@ -50479,6 +50695,7 @@ function formatSignInFailureMessage(displayName, status) {
 var OPERATION_RESTORED_EVENT_CHANNEL2 = "operation:restored";
 var RESTORED_DORMANT_PAYLOAD_KEY = "restoredDormant";
 function registerShellRoutes(ctx, runtime) {
+  markRestoredShellOperations(ctx);
   const unsubscribeRestore = ctx.host.events.subscribe(OPERATION_RESTORED_EVENT_CHANNEL2, (payload) => {
     if (!isRestoredShellEvent(payload, ctx.pluginId)) return;
     const operation = ctx.host.operations.get(payload.operationId);
@@ -50579,6 +50796,13 @@ function registerShellRoutes(ctx, runtime) {
     { method: "POST", path: "/:operationId/relaunch", summary: "Relaunch a dormant Shell session.", category: "Terminal Plugin", gate: "origin-write", transport: "http" }
   ]);
 }
+function markRestoredShellOperations(ctx) {
+  for (const operation of ctx.host.operations.list()) {
+    if (operation.pluginId !== ctx.pluginId || operation.type !== "shell") continue;
+    if (operation.payload[RESTORED_DORMANT_PAYLOAD_KEY] === true) continue;
+    ctx.host.operations.patch(operation.id, { payload: { ...operation.payload, [RESTORED_DORMANT_PAYLOAD_KEY]: true } });
+  }
+}
 function isRestoredShellEvent(value, pluginId) {
   if (!value || typeof value !== "object") return false;
   const event = value;

package/dist/fleet.mjs

@@ -46753,23 +46753,88 @@ function buildFleetHelpText(options = {}) {
 
 // core/host/console-lifecycle.ts
 init_src();
+var SPAWN_GRACE_MS = 250;
 function openBrowser(url2, deps = {}) {
   const platform = deps.platform ?? os3__default.platform();
-  const spawnBrowser = deps.spawnBrowser ?? ((command2, args, options) => {
-    const child = spawn(command2, [...args], options);
-    child.once("error", () => {
+  const spawnBrowser = deps.spawnBrowser ?? defaultSpawnBrowser;
+  const options = { detached: true, stdio: "ignore", windowsHide: true };
+  if (platform === "darwin") return normalize(spawnBrowser("open", [url2], options));
+  if (platform === "win32") return normalize(spawnBrowser("cmd", ["/c", "start", "", url2], options));
+  return normalize(spawnBrowser("xdg-open", [url2], options));
+}
+async function normalize(result) {
+  const resolved = await result;
+  return resolved ?? { opened: true };
+}
+function defaultSpawnBrowser(command2, args, options) {
+  return new Promise((resolve3) => {
+    let child;
+    try {
+      child = spawn(command2, [...args], options);
+    } catch (error51) {
+      resolve3({ opened: false, reason: describe3(error51, command2) });
+      return;
+    }
+    const timer = setTimeout(() => {
+      child.unref();
+      resolve3({ opened: true });
+    }, SPAWN_GRACE_MS);
+    child.once("error", (error51) => {
+      clearTimeout(timer);
+      child.unref();
+      resolve3({ opened: false, reason: describe3(error51, command2) });
+    });
+    child.once("exit", (code) => {
+      clearTimeout(timer);
+      child.unref();
+      if (code === null || code === 0) resolve3({ opened: true });
+      else resolve3({ opened: false, reason: `${command2} exited with status ${code}` });
     });
-    child.unref();
   });
-  if (platform === "darwin") {
-    spawnBrowser("open", [url2], { detached: true, stdio: "ignore", windowsHide: true });
-    return;
-  }
-  if (platform === "win32") {
-    spawnBrowser("cmd", ["/c", "start", "", url2], { detached: true, stdio: "ignore", windowsHide: true });
-    return;
+}
+function describe3(error51, command2) {
+  const code = error51?.code;
+  if (code === "ENOENT") return `${command2} is not on PATH`;
+  if (code === "EACCES") return `${command2} is not executable`;
+  return error51 instanceof Error ? error51.message : String(error51);
+}
+
+// core/host/failure-notice.ts
+function formatFailureNotice(notice) {
+  const lines = [notice.what, `  Why   ${notice.why}`];
+  notice.next.forEach((step, index) => {
+    lines.push(`  ${index === 0 ? "Next " : "     "} ${step}`);
+  });
+  return lines.join("\n");
+}
+function describeConsoleLaunch(successLine, outcome) {
+  if (outcome.browserOpened) return successLine;
+  return formatFailureNotice({
+    what: "Fleet Console is running, but no browser opened on this machine.",
+    why: outcome.browserError ?? "the browser launcher did not start",
+    next: [`Open this address yourself: ${outcome.url}`]
+  });
+}
+function describeDaemonStartFailure(input) {
+  if (input.spawnError) {
+    return formatFailureNotice({
+      what: "Fleet Console server did not start.",
+      why: `the server process could not be spawned \u2014 ${input.spawnError}`,
+      next: [
+        "Check that this Node install can run the Console: node --version",
+        "Reinstall if the package is incomplete: npm install -g @dotobokuri/fleet-console"
+      ]
+    });
   }
-  spawnBrowser("xdg-open", [url2], { detached: true, stdio: "ignore", windowsHide: true });
+  return formatFailureNotice({
+    what: "Fleet Console server did not start.",
+    why: input.probeError ? `it was started but never answered a health check \u2014 ${input.probeError}` : "it was started but never answered a health check within 3 seconds",
+    next: [
+      `Check that this directory is writable: ${input.dataDir}`,
+      "Show the current state: fleet console status",
+      "Then try again: fleet console restart"
+    ]
+  });
 }
 
 // core/host/health.ts
@@ -52693,7 +52758,8 @@ var SHIM_NAMED_EXPORTS = {
   "@fleet-console/sdk/settings/browser": ["ExperimentalBadge", "SettingsCard", "SettingsField", "SettingsRow", "SettingsSelect", "SettingsToggle", "defineSettingsSection"],
   "@fleet-console/sdk/operations/browser": ["ApiError", "OperationBody", "assertOperationNode", "fetchOperationCatalog", "hasForbiddenBrowserPayloadKey"],
   "@fleet-console/sdk/notifications/browser": ["defineNotificationKind"],
-  "@fleet-console/sdk/react/browser": ["PluginErrorBoundary", "React", "Select", "useSelect"]
+  "@fleet-console/sdk/react/browser": ["PluginErrorBoundary", "React", "Select", "useSelect"],
+  "@fleet-console/sdk/components/failure-notice": ["FailureNotice"]
 };
 
 // core/host/plugin-host/plugin-host.ts
@@ -52826,7 +52892,8 @@ var SHIM_DEFINITIONS = [
   { name: "sdk-settings-browser", specifier: "@fleet-console/sdk/settings/browser", globalKey: "@fleet-console/sdk/settings/browser", namedExports: SHIM_NAMED_EXPORTS["@fleet-console/sdk/settings/browser"] ?? [] },
   { name: "sdk-operations-browser", specifier: "@fleet-console/sdk/operations/browser", globalKey: "@fleet-console/sdk/operations/browser", namedExports: SHIM_NAMED_EXPORTS["@fleet-console/sdk/operations/browser"] ?? [] },
   { name: "sdk-notifications-browser", specifier: "@fleet-console/sdk/notifications/browser", globalKey: "@fleet-console/sdk/notifications/browser", namedExports: SHIM_NAMED_EXPORTS["@fleet-console/sdk/notifications/browser"] ?? [] },
-  { name: "sdk-react-browser", specifier: "@fleet-console/sdk/react/browser", globalKey: "@fleet-console/sdk/react/browser", namedExports: SHIM_NAMED_EXPORTS["@fleet-console/sdk/react/browser"] ?? [] }
+  { name: "sdk-react-browser", specifier: "@fleet-console/sdk/react/browser", globalKey: "@fleet-console/sdk/react/browser", namedExports: SHIM_NAMED_EXPORTS["@fleet-console/sdk/react/browser"] ?? [] },
+  { name: "sdk-components-failure-notice", specifier: "@fleet-console/sdk/components/failure-notice", globalKey: "@fleet-console/sdk/components/failure-notice", namedExports: SHIM_NAMED_EXPORTS["@fleet-console/sdk/components/failure-notice"] ?? [] }
 ];
 var SHIM_URL_BY_SPECIFIER = new Map(SHIM_DEFINITIONS.map((definition) => [definition.specifier, `/plugin-runtime/shim/${definition.name}.mjs`]));
 var SHIM_BY_NAME = new Map(SHIM_DEFINITIONS.map((definition) => [definition.name, definition]));
@@ -52837,9 +52904,11 @@ var NODE_BUILTINS = /* @__PURE__ */ new Set([
 function createPluginClientAssets(deps) {
   const clientSources = /* @__PURE__ */ new Map();
   const preparedPlugins = /* @__PURE__ */ new Set();
+  const skippedPlugins = /* @__PURE__ */ new Map();
   async function prepare() {
     clientSources.clear();
     preparedPlugins.clear();
+    skippedPlugins.clear();
     for (const plugin of deps.plugins) {
       if (!plugin.external || !plugin.clientEntry) continue;
       try {
@@ -52848,17 +52917,24 @@ function createPluginClientAssets(deps) {
         preparedPlugins.add(plugin.manifest.id);
       } catch (error51) {
         console.warn(`[fleet-console] Plugin ${plugin.manifest.id} client skipped: ${error51 instanceof Error ? error51.message : String(error51)}`);
+        skippedPlugins.set(plugin.manifest.id, {
+          id: plugin.manifest.id,
+          ...plugin.manifest.name ? { name: plugin.manifest.name } : {},
+          reason: error51?.message === "unsupported_client_entry" ? "unsupported_client_entry" : "client_build_failed"
+        });
       }
     }
   }
   function manifest() {
+    const skipped = [...skippedPlugins.values()];
     return {
       plugins: deps.plugins.filter((plugin) => plugin.external && !!plugin.clientEntry && preparedPlugins.has(plugin.manifest.id)).map((plugin) => ({
         id: plugin.manifest.id,
         ...plugin.manifest.name ? { name: plugin.manifest.name } : {},
         clientUrl: `/plugin-runtime/client/${plugin.manifest.id}.mjs`,
         apiVersion: plugin.manifest.apiVersion ?? SDK_API_VERSION
-      }))
+      })),
+      ...skipped.length > 0 ? { skipped } : {}
     };
   }
   function getClient(id) {
@@ -56601,9 +56677,11 @@ function createConsoleDaemonLifecycle(deps = {}) {
   const childEnv = env.FLEET_CONSOLE_NO_SYSTEM_CA === "1" ? env : withNodeSystemCa(env);
   const execPath = deps.execPath ?? V2.execPath;
   const serverModulePath = deps.serverModulePath ?? resolveDefaultServerModulePath2();
+  let lastSpawnError = null;
   const spawnDetached = deps.spawnDetached ?? ((bin, args, options) => {
     const child = spawn(bin, [...args], options);
-    child.once("error", () => {
+    child.once("error", (error51) => {
+      lastSpawnError = error51 instanceof Error ? error51.message : String(error51);
     });
     child.unref();
   });
@@ -56656,13 +56734,20 @@ function createConsoleDaemonLifecycle(deps = {}) {
       if (typeof probeResult.health?.workspaceCount === "number" && probeResult.health.workspaceCount > 0) return current.endpoint;
     }
     if (current) await stop();
+    lastSpawnError = null;
     spawnDetached(execPath, [serverModulePath, "serve"], withHidden({ detached: true, env: childEnv, stdio: "ignore" }));
+    let lastProbeError = null;
     for (let i = 0; i < 30; i += 1) {
       await sleep(100);
       const next = await probe();
       if (next.healthy && next.lock) return next.lock.endpoint;
+      if (next.error) lastProbeError = next.error;
     }
-    throw new Error("Fleet Console server did not become healthy");
+    throw new Error(describeDaemonStartFailure({
+      spawnError: lastSpawnError,
+      probeError: lastProbeError,
+      dataDir: paths.dir
+    }));
   }
   return { ensureDaemon, probe, runServer, stop };
   function readTrustedLock(options = {}) {
@@ -56691,8 +56776,9 @@ async function openFleetConsole(deps = {}) {
     throw new Error("Fleet Console server is not healthy after ensure");
   }
   const url2 = `${status2.lock.endpoint}console/`;
-  (deps.openBrowser ?? openBrowser)(url2);
-  return { url: url2 };
+  const browser = await (deps.openBrowser ?? openBrowser)(url2);
+  const result = browser ?? { opened: true };
+  return result.opened ? { url: url2, browserOpened: true } : { url: url2, browserOpened: false, browserError: result.reason };
 }
 async function runConsoleStatus(deps = {}) {
   const lifecycle = deps.lifecycle ?? createConsoleDaemonLifecycle();
@@ -56805,14 +56891,14 @@ async function dispatchFleetArgv(argv, options) {
         return 0;
       }
       if (mode === "restart") {
-        await runConsoleRestart();
-        io.stdout.write(`Fleet Console restarted.
+        const restarted = await runConsoleRestart();
+        io.stdout.write(`${describeConsoleLaunch("Fleet Console restarted.", restarted)}
 ${await runConsoleStatus()}
 `);
         return 0;
       }
-      await openFleetConsole();
-      io.stdout.write(`Fleet Console opened.
+      const opened = await openFleetConsole();
+      io.stdout.write(`${describeConsoleLaunch("Fleet Console opened.", opened)}
 ${await runConsoleStatus()}
 `);
       return 0;