@epoch-agent/server 0.13.0 → 0.15.0

package/dist/index.d.ts

@@ -2709,39 +2709,31 @@ interface SessionLoopView {
  *
  * 另一项（`usedTokens`）反过来**只有浏览器有**，见 {@link readModelSetBody}。
  *
- * ## ✅ 2026-08-16 合并时收掉了（原文是一张 📮，留着当判据）
+ * ## ⚠️ 斜杠命令的 `model:` 必须按会话取，**别让它再借进程那一份**
  *
- * 自定义斜杠命令 frontmatter 的 `model:`（「这一条命令只换这一轮」）走的是
- * [commands.ts](./commands.ts) 的 `scopeTurn()`，它读的**曾经**是 `runtime.model`
- * 那一格 —— 也就是引导会话那一份。模型选择这一轮变成会话级之后，那条路在
- * 第二个会话上的表现是：
+ * 自定义斜杠命令 frontmatter 的 `model:`（「这一条命令只换这一轮」）走
+ * [commands.ts](./commands.ts) 的 `scopeTurn()`。那一格的真源是
+ * `ctx.runtime.sessionFactory.get(sessionId)?.model`，由调用方递进来
+ * （形状照 `checkpointsOf(ctx, sessionId)`）—— **`commands.ts` 上没有、也别再加回
+ * 一个 `model: ModelTurnsView | null`**：那种借法借到的恒是引导会话那一份。
  *
- * - 那条命令的 `model:` **对这个会话一点作用都没有**（B 的循环读的是 B 自己
+ * 借错了的症状有两半，第二半更糟：
+ *
+ * - 那条命令的 `model:` **对当前这个会话一点作用都没有**（B 的循环读的是 B 自己
  *   那个 router，而 `enterTurn` 换的是引导会话那个）；
- * - 更糟的一半：它**顺带把引导会话的选择换掉了一轮**。A 正好在跑的话，
- *   A 那一轮会用上 B 那条命令点名的模型。
- *
- * ⚠️ **这不是这一轮引入的一个新 bug，是一个旧 bug 换了形状**：在会话级之前，
- * B 那条命令换的是**所有人共用**的那个选择，A 同样会被拖下水。两版都错，
- * 而这一版多了「对 B 无效」这一半。如实记着，别当成没动过。
- *
- * **写这张 📮 的那一轮不改**：`commands.ts` / `api.ts` 不归它，而正确的改法要动
- * 它们两个（[方案 30 §十二](../../../docs/verify/VERIFY_RECORD-30-web-multi-session.md)
- * 的第 3 条：不绕过去、不伸手改、就地写下来）。合并的那一轮照着三步收完了：
- *
- * 1. `RuntimeCommandModel`（`commands.ts` 上那个 `model: ModelTurnsView | null`）
- *    **整个删掉**了 —— 它借的恒是进程那一份。`expandUserContent()` /
- *    `scopeTurn()` 改成从调用方收这一格，形状照 `checkpointsOf(ctx, sessionId)`；
- * 2. 真源本来就在手边：`ctx.runtime.sessionFactory.get(sessionId)?.model`。
- *    **runtime 一个字没加** —— `ModelControl` 上五个动词一直都全，
- *    只差 server 这一跳；
- * 3. `enterTurn` 加进了 `sessions/scope.ts` 那份镜像。原文说这一步「有意留给
- *    收的人做」，因为加它等于承认「这条路上有一个和 `run()` 成对的还原动作」——
- *    那句话由 `commands.ts` 说了，判据抄在 `SessionModelView.enterTurn` 上。
- *
- * ⚠️ 一处**没有**跟着变的：取不到会话（冷却中、或 `sessionFactory` 里没有）时
+ * - 它**顺带把引导会话的选择换掉了一轮** —— A 正好在跑的话，A 那一轮会用上
+ *   B 那条命令点名的模型。
+ *
+ * ⚠️ 这在会话级之前是**同一个 bug 的另一个形状**：那时 B 那条命令换的是所有人
+ * 共用的那个选择，A 同样被拖下水。两版都错，如实记着，别当成没动过。
+ *
+ * ⚠️ 一处**刻意不跟着变**：取不到会话（冷却中、或 `sessionFactory` 里没有）时
  * 传 null，`withModelScope` 对 null 是零开销直通 —— 命令正文照跑，只有 `model:`
  * 那一半不生效。**和 provider 没配起来时同一档**，判据在 `api.ts` 那一处。
+ *
+ * ⚠️ `enterTurn` 在 `sessions/scope.ts` 那份镜像里是有意加的：加它等于承认
+ * 「这条路上有一个和 `run()` 成对的还原动作」，那句话由 `commands.ts` 说，
+ * 判据抄在 `SessionModelView.enterTurn` 上。
  */
 
 /**
@@ -3052,6 +3044,19 @@ interface MarketplaceView {
     entries: number;
     addedAt: number;
     local: boolean;
+    /** 这个市场声明的分类层级（2026-09-21）。缺席 = 它没声明，判据在 runtime 那一格上 */
+    categories?: readonly CategoryView[];
+}
+/**
+ * `MarketplaceCategory`（core，经 runtime 原样透出）的镜像。
+ *
+ * ⚠️ **两格都可选**，和网线上那一份刻意不同形：补齐是这一层的活
+ * （{@link toWireCategory}），而镜像要如实描述**收到的**是什么。
+ */
+interface CategoryView {
+    id: string;
+    label?: string;
+    children?: readonly CategoryView[];
 }
 /** 加 / 移除一个市场的结局。移除成功那一档没有 `marketplace` —— 它已经不在表里了 */
 type MarketOutcomeView = {
@@ -3385,6 +3390,8 @@ interface ScheduleCreateView {
     /** 不给就落到 `~/.epoch/automation/<id>/`，**不是**服务进程的 cwd */
     workDir?: string;
     model?: string;
+    /** 「召唤专家」——这条任务用哪个身份跑。见 `WireScheduleCreateRequest.role` */
+    role?: string;
     permission: PermissionLevel;
     allowTools?: readonly string[];
     allowOperations?: readonly OperationType[];
@@ -3397,11 +3404,16 @@ interface ScheduleCreateView {
     startDate?: string;
     endDate?: string;
     enabled?: boolean;
+    /**
+     * 跑完的会话直接进会话列表吗。不给 = 收进归档，判据全文在
+     * `ScheduleDefinition.showInSessionList` 上。
+     */
+    showInSessionList?: boolean;
 }
 /**
  * 改一条任务 —— core 的 `UpdateScheduleInput`。没给的字段一个都不动。
  *
- * ⚠️ **四格收 `null` = 清空这一格**，和网线上那份（`WireScheduleUpdateRequest`）
+ * ⚠️ **五格收 `null` = 清空这一格**，和网线上那份（`WireScheduleUpdateRequest`）
  * 逐字段对得上。别写成 `Partial<ScheduleCreateView>`（2026-09-07 之前就是那样）：
  * 那一版比真身**窄**，而窄的方向 TS 不报 —— 入参是逆变的，一个「什么都收得下」
  * 的真身赋给一个「只收 string」的镜像永远合法。于是这一层压根表达不出「清空」，
@@ -3411,10 +3423,12 @@ interface ScheduleCreateView {
  * 也就是说**这一格的正确性没有编译器守着**，只有这段注释和用例。判据全文在
  * core 的 `UpdateScheduleInput` 上。
  */
-type ScheduleUpdateView = Partial<Omit<ScheduleCreateView, 'workDir' | 'model' | 'startDate' | 'endDate'>> & {
+type ScheduleUpdateView = Partial<Omit<ScheduleCreateView, 'workDir' | 'model' | 'role' | 'startDate' | 'endDate'>> & {
     /** `null` = 不绑工作区了 → 落回 `~/.epoch/automation/<id>/`（runtime 那一层解析） */
     workDir?: string | null;
     model?: string | null;
+    /** `null` = 回到默认 agent */
+    role?: string | null;
     startDate?: string | null;
     endDate?: string | null;
 };
@@ -3736,68 +3750,42 @@ interface WorkspaceView {
  * 是 `<root>/.epoch/policies`），**那时这里要改**：`runtime.policy` 得按
  * `workspaces.of(sessionId)` 重算，而不是读装配时那一份。
  *
- * ## ✅ 收掉了（2026-08-17）：`permission.level` 这一格曾经答的是**引导会话**
+ * ## ⚠️ `permission.level` 必须按会话取 —— **别动 `session` 那个参数**
+ *
+ * 这一格今天对了，靠的是 [api.ts](./api.ts) 的 `getSecurity()` 递进来的那一个实参
+ * （第 4 个）：`ctx.runtime.sessionFactory.get(sessionId)?.permissions ?? null`。
  *
- * 下面整节是那张 📮 的原文，**一个字没改**。它留着不是纪念品：这一格今天对了
- * 靠的是 `api.ts` 里那**一个实参**，而那一行看上去像是可有可无的第四个参数。
- * 哪天有人为了「少传一个东西」把它删回三参，症状就是下面写的那些 ——
- * 印错一个词、外加一张在最该发黄的时候是绿的卡。**判据比修法长，是因为
- * 这类 bug 编译得过、跑得通、每一条用例都绿。**
+ * 它看上去像是可有可无的一个。**删掉它，症状是下面这些 —— 而它编译得过、
+ * 跑得通、每一条用例都绿**，所以判据写得比修法长：
  *
- * {@link collectSecurity} 里那句 `perms.level()` 读的是 {@link PermissionsView}，
- * 也就是 `WebRuntimeView.permissions`。runtime 的 `buildPermissionsControl()`
- * 把 `level` / `setLevel` 两格**整个转发给引导会话那一份**（那边逐字是
- * `level: () => bootstrap?.level() ?? services.config.permission`）。
+ * 少了它，{@link collectSecurity} 里那句 `perms.level()` 读的是
+ * {@link PermissionsView}（`WebRuntimeView.permissions`），而 runtime 的
+ * `buildPermissionsControl()` 把 `level` / `setLevel` 两格**整个转发给引导会话
+ * 那一份**（逐字是 `level: () => bootstrap?.level() ?? services.config.permission`）。
  * 于是浏览器看着会话 B 时，安全中心那一格印的是会话 A 那一档。
  *
  * 这和 2026-08-15 治掉的 `config.workspace` 是同一类病（方案 30 §10.4 第 1 条）：
  * **端点按会话取，载荷里那一格却是进程级的。** 契约那边早把它说死了 ——
  * `WirePermissionState.level` 的 JSDoc 逐字写着「安全中心那一格和底栏这一格印的
- * **必须是同一个名词**」，而底栏那一格从 2026-08-16 起按会话取
- * （[permission.ts](./permission.js) 的 `permissionState()`）。今天这两格能不一样。
+ * **必须是同一个名词**」，而底栏那一格按会话取
+ * （[permission.ts](./permission.js) 的 `permissionState()`）。
  *
  * ⚠️ **代价不止是印错一个词。** 那一屏顶上四张状态卡的第一条纪律是「取最差的
  * 那一处」，而档位那张卡的色带就照这个值算：会话 B 在 `bypass` 上、引导会话在
  * `default` 上时，**那张卡是绿的**。一屏「我现在安不安全」的界面，在最该发黄的
  * 那一刻答了别人的状态。
  *
- * **缺的那一段只有一处，而它在 [api.ts](./api.ts) 里，那个文件这一轮不归我改**
- * （✅ 这一段就是收掉的那一笔，`getSecurity()` 里现在逐字是这个 diff）：
- *
- * ```diff
- *    // api.ts / getSecurity()
- *    const payload = collectSecurity(
- *      ctx.runtime,
- *      ctx.runtime.workspaces,
- *      ctx.runtime.workspaces.of(sessionId),
- * +    ctx.runtime.sessionFactory.get(sessionId)?.permissions ?? null,
- *    );
- * ```
- *
- * 这一层跟着收第四个参数
- * `session: Pick<SessionPermissionsView, 'level'> | null`（类型在
- * [sessions/scope.ts](./sessions/scope.js)，**那一层已经镜像好了，不用动
- * core / runtime**），投影里 `level` 改成 `session?.level() ?? perms.level()` ——
- * 这个进程没在跑那段会话（只剩历史 / 被冷却）时退回进程那一份，那仍然是一句
- * 真话，判据逐字同 `permissionState()` 那条兜底。
+ * ⚠️ **这个参数是必填的，不是可选的**，`null` 由调用方显式写出来。回落发生在投影里
+ * （`session?.level() ?? perms.level()` —— 这个进程没在跑那段会话时退回进程那一份，
+ * 那仍然是一句真话，判据同 `permissionState()` 那条兜底），**而不是发生在
+ * 「忘了传」这件事上**。区别不在行为上（都退回进程那一份），在于**下一个新加
+ * 调用点的人会不会被编译器拦住**：可选参数不拦，必填参数拦。类型在
+ * [sessions/scope.ts](./sessions/scope.js)，core / runtime 不用动。
  *
  * ⚠️ **`rules` / `shadows` / `managed` / `audit` / `cached` 五样一个都不许跟着搬。**
  * 判据在 core 的 `permission/shared.ts`：它们**没有**跟着会话分家。搬过去的
  * 具体代价是这一屏只剩下这一个会话判过的那几行 ——
  * **一本漏了行的安全流水比没有账更坏，因为它看起来是完整的。**
- *
- * ⚠️ 这一轮**刻意没有**顺手加一个「不传就回落到进程那一份」的可选第四参。
- * 那个形状编译得过、跑得通、只是答错会话，正是 `context.ts` 删掉进程级
- * `checkpoints` 那一段点名的病；而且半接上的参数会让下一个人以为这条已经收了。
- * 要么四个实参一起到位，要么这一格照旧是一处**写在文件头上的**缺陷。
- *
- * > ✅ **收的时候按这句办了：第四参是必填的，不是可选的。** 唯一的调用点
- * > （`api.ts` 的 `getSecurity()`）传的是
- * > `sessionFactory.get(sessionId)?.permissions ?? null` —— **`null` 是显式的**，
- * > 由调用方写出来，不是省略出来的。回落发生在投影里
- * > （`session?.level() ?? perms.level()`），而不是发生在「忘了传」这件事上。
- * > 这两者的区别不在行为上（都退回进程那一份），在于**下一个新加调用点的人
- * > 会不会被编译器拦住**：可选参数不拦，必填参数拦。
  */
 
 /**
@@ -4438,7 +4426,10 @@ declare function unavailableToHttp(lang?: Lang): {
  * 两边都可能单独存在，所以两边都不能当成必要条件：
  *
  * - **只有 Hub 有**：会话刚建出来、一条消息都还没落盘。DB 那半全 null，
- *   但它必须出现在列表里 —— 否则用户新建一个会话，列表上什么都没有
+ *   但它必须出现在列表里 —— 否则用户新建一个会话，列表上什么都没有。
+ *   ⚠️ 2026-09-20 起这一条有**唯一一个例外**：没人用过的那段引导会话
+ *   （判据在 `listSessionSummaries` 的 `unusedBootstrapId` 和下面那条 `fresh`
+ *   通道上）。例外只此一个，而且划得掉的只有「Hub 里有、DB 里没有」那一半
  * - **只有 DB 有**：上次进程留下的会话，或者本进程里被冷却掉的。它照样要出现，
  *   `live: false` 说明「Hub 手里没有它」，重新打开时走 `GET /messages` 回放
  *

package/dist/index.js

@@ -1,5 +1,5 @@
 import { createServer } from 'http';
-import { createLogger, t, ApprovalRelay, QuestionRelay, serializeStream, withRoleScope, withModelScope, withToolScope, nextRunAt, observeBackgroundTasks, skillIndexDescription, SANDBOX_EXCLUDES, SANDBOX_COVERS, isSystemOpenable, backgroundTaskOutput, listBackgroundTasks, providerLabel, MAX_REASON_CHARS, MAX_OBJECTIVE_CHARS, MAX_GOAL_MAX_ROUNDS, DEFAULT_GOAL_MAX_ROUNDS, SCHEDULE_DEFAULT_ALLOWLIST, SCHEDULE_DEFAULTS, coalesceRecording, readRecording } from '@epoch-agent/runtime';
+import { createLogger, t, ApprovalRelay, QuestionRelay, serializeStream, withRoleScope, withModelScope, withToolScope, nextRunAt, observeBackgroundTasks, skillIndexDescription, SANDBOX_EXCLUDES, SANDBOX_COVERS, canProbeGit, guardSpawn, isSystemOpenable, backgroundTaskOutput, listBackgroundTasks, providerLabel, MAX_REASON_CHARS, MAX_OBJECTIVE_CHARS, MAX_GOAL_MAX_ROUNDS, DEFAULT_GOAL_MAX_ROUNDS, SCHEDULE_DEFAULT_ALLOWLIST, SCHEDULE_FORM_BUDGET_USD, SCHEDULE_DEFAULTS, coalesceRecording, readRecording } from '@epoch-agent/runtime';
 import { timingSafeEqual, randomBytes } from 'crypto';
 import { PLAN_OUTCOMES, WIRE_AUTH_COOKIE, WIRE_AUTH_COOKIE_ATTRS, WIRE_AUTH_TOKEN_PARAM, extractAllMentions, MAX_ATTACH_FILES, utf8ByteLength, MAX_SESSION_REFS, attachSessionSurface, isWireRewindScope, WIRE_REWIND_SCOPES, mcpConnectorState, MAX_ATTACH_TOTAL_BYTES, MAX_ATTACH_BYTES, truncateToBudget, WIRE_LANG_PARAM, isLang, conformsToWire, WIRE_LAST_SESSION_FIELDS, isQuestionAnswerMap, isProviderType, apiKeyEnvVar, WIRE_FILE_STAT_MAX, WIRE_SETTING_WRITE_LAYERS, isWirePlanAction, WIRE_PLAN_ACTIONS, isPermissionLevel, PERMISSION_LEVELS, WIRE_TRUST_REQUEST_FIELDS, WIRE_FORGET_WORKSPACE_FIELDS, collectPendingApprovals, unfixedRules, isWireSettingWriteLayer, parseModelRef, WIRE_GOAL_ACTIONS, OPERATION_TYPES, isOperationType, WIRE_PLUGIN_UPLOAD_FORM_FIELDS } from '@epoch-agent/protocol';
 import { resolve, join, relative, isAbsolute, sep, dirname, basename, extname } from 'path';
@@ -390,7 +390,7 @@ function toWireSummaryWorkspace(bound, live, row) {
   }
   return row?.workspaceState === "none" ? { state: "none" } : { state: "unknown" };
 }
-function listSessionSummaries(hubStates, catalog, query, workspaceOf = () => null, roleOf = () => null, limit = DEFAULT_SESSION_LIST_LIMIT, archived = false) {
+function listSessionSummaries(hubStates, catalog, query, workspaceOf = () => null, roleOf = () => null, limit = DEFAULT_SESSION_LIST_LIMIT, archived = false, unusedBootstrapId = null) {
   const byId = new Map(hubStates.map((s) => [s.id, s]));
   if (query) {
     if (!catalog) return [];
@@ -417,7 +417,7 @@ function listSessionSummaries(hubStates, catalog, query, workspaceOf = () => nul
     })
   );
   const known = new Set(rows.map((r) => r.id));
-  const fresh = archived ? [] : hubStates.filter((s) => !known.has(s.id)).filter((s) => catalog?.get(s.id)?.archived !== true).map(
+  const fresh = archived ? [] : hubStates.filter((s) => !known.has(s.id)).filter((s) => catalog?.get(s.id)?.archived !== true).filter((s) => s.id !== unusedBootstrapId).map(
     (s) => toWireSummary(s.id, s, null, { workspace: workspaceOf(s.id), role: roleOf(s.id) })
   );
   return [...fresh, ...summaries].sort(compareSummaries).slice(0, limit);
@@ -1074,6 +1074,11 @@ function toWireSkillBody(name, body) {
   const safe = Buffer.byteLength(cut, "utf-8") > MAX_SKILL_BODY_BYTES ? cut.slice(0, -1) : cut;
   return { name, body: safe, truncated: true, bytes };
 }
+function getRoles(ctx, res) {
+  sendJson(res, 200, {
+    roles: ctx.runtime.agentRoles.map((r) => toWireRole(r, ctx.runtime.agentRoleNotices))
+  });
+}
 function getSkillBody(ctx, res, sessionId, name, lang) {
   if (!ctx.hub.has(sessionId) && !ctx.runtime.sessions?.get(sessionId)) {
     return sendUnknownSession(res, sessionId);
@@ -1684,10 +1689,16 @@ function listSessions(ctx, res, query, _lang, archived = false) {
     (id) => ctx.runtime.workspaces.of(id),
     (id) => ctx.runtime.sessionFactory.get(id)?.role ?? null,
     void 0,
-    archived
+    archived,
+    unusedBootstrap(ctx)
   );
   sendJson(res, 200, { sessions });
 }
+function unusedBootstrap(ctx) {
+  const { lastSessionId } = lastSessionField(ctx);
+  if (!lastSessionId || lastSessionId === ctx.runtime.sessionId) return null;
+  return ctx.runtime.sessionId;
+}
 function getSession(ctx, res, sessionId, lang) {
   const hub = ctx.hub.listSessions().find((one) => one.id === sessionId);
   const row = ctx.runtime.sessions?.get(sessionId) ?? null;
@@ -2759,7 +2770,15 @@ function toWireMarketplace(market) {
     source: market.source,
     entries: market.entries,
     addedAt: market.addedAt,
-    local: market.local
+    local: market.local,
+    categories: (market.categories ?? []).map(toWireCategory)
+  };
+}
+function toWireCategory(node) {
+  return {
+    id: node.id,
+    label: node.label ?? node.id,
+    children: (node.children ?? []).map(toWireCategory)
   };
 }
 function toWirePreview2(preview) {
@@ -3334,7 +3353,7 @@ function numberList(value) {
   }
   return out;
 }
-var CLEARABLE = ["model", "workDir", "startDate", "endDate"];
+var CLEARABLE = ["model", "role", "workDir", "startDate", "endDate"];
 function optionals(raw, allowClear, lang) {
   const out = {};
   const bad = (field) => ({
@@ -3384,11 +3403,13 @@ function optionals(raw, allowClear, lang) {
     }
     out.allowOperations = ops;
   }
-  if (raw["enabled"] !== void 0) {
-    if (typeof raw["enabled"] !== "boolean") {
-      return { ok: false, message: t("web.schedule_bad_field", { field: "enabled" }, lang) };
+  for (const key of ["enabled", "showInSessionList"]) {
+    const value = raw[key];
+    if (value === void 0) continue;
+    if (typeof value !== "boolean") {
+      return { ok: false, message: t("web.schedule_bad_field", { field: key }, lang) };
     }
-    out.enabled = raw["enabled"];
+    out[key] = value;
   }
   if (raw["permission"] !== void 0) {
     const level = raw["permission"];
@@ -3465,6 +3486,7 @@ function defaultsOf(ctx) {
   return {
     maxTurns: ctx.runtime.config.maxTurns,
     timeoutMs: SCHEDULE_DEFAULTS.timeoutMs,
+    maxBudgetUsd: SCHEDULE_FORM_BUDGET_USD,
     allowTools: SCHEDULE_DEFAULT_ALLOWLIST.allowTools,
     allowOperations: SCHEDULE_DEFAULT_ALLOWLIST.allowOperations,
     allowRules: SCHEDULE_DEFAULT_ALLOWLIST.allowRules
@@ -4078,25 +4100,34 @@ async function pickNativeDirectory(opts) {
   }
 }
 var execFileRunner = (command, args, signal) => new Promise((done) => {
-  execFile(
-    command,
-    [...args],
-    {
-      ...signal ? { signal } : {},
-      encoding: "utf-8",
-      windowsHide: true,
-      maxBuffer: 1024 * 1024
-    },
-    (error, stdout, stderr) => {
-      const err = error;
-      done({
-        code: err?.code ?? 0,
-        stdout,
-        stderr,
-        missing: err?.code === "ENOENT",
-        message: err?.message ?? ""
-      });
-    }
+  guardSpawn(
+    () => execFile(
+      command,
+      [...args],
+      {
+        ...signal ? { signal } : {},
+        encoding: "utf-8",
+        windowsHide: true,
+        maxBuffer: 1024 * 1024
+      },
+      (error, stdout, stderr) => {
+        const err = error;
+        done({
+          code: err?.code ?? 0,
+          stdout,
+          stderr,
+          missing: err?.code === "ENOENT",
+          message: err?.message ?? ""
+        });
+      }
+    ),
+    (err) => done({
+      code: err.code ?? 1,
+      stdout: "",
+      stderr: "",
+      missing: err.code === "ENOENT" || err.code === "ENOTDIR",
+      message: `${err.message} (command=${command})`
+    })
   );
 });
 // src/workspace/dirs.ts
@@ -4426,15 +4457,19 @@ async function forgetWorkspace(ctx, sessionId, req, res, lang) {
 var GIT_TIMEOUT_MS = 1e4;
 var GIT_MAX_BUFFER = 16 * 1024 * 1024;
 function runGit(cwd, args) {
+  if (!canProbeGit()) return Promise.resolve({ ok: false, error: "git unavailable" });
   return new Promise((resolve4) => {
-    execFile(
-      "git",
-      [...args],
-      { cwd, timeout: GIT_TIMEOUT_MS, maxBuffer: GIT_MAX_BUFFER, encoding: "buffer" },
-      (err, stdout) => {
-        if (err) return resolve4({ ok: false, error: err.message });
-        resolve4({ ok: true, stdout });
-      }
+    guardSpawn(
+      () => execFile(
+        "git",
+        [...args],
+        { cwd, timeout: GIT_TIMEOUT_MS, maxBuffer: GIT_MAX_BUFFER, encoding: "buffer" },
+        (err, stdout) => {
+          if (err) return resolve4({ ok: false, error: err.message });
+          resolve4({ ok: true, stdout });
+        }
+      ),
+      (err) => resolve4({ ok: false, error: `${err.message} (cwd=${cwd})` })
     );
   });
 }
@@ -4911,6 +4946,9 @@ async function handleApi(opts, req, res, method, segments, lang) {
   if (resource === "mcp" && first === void 0 && method === "POST") {
     return addMcp(ctx, req, res, lang);
   }
+  if (resource === "roles" && first === void 0 && isRead(method)) {
+    return getRoles(ctx, res);
+  }
   if (resource === "roles" && first === void 0 && method === "POST") {
     return addRole(ctx, req, res, lang);
   }