agent-loft 0.2.17 → 0.2.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-loft",
-  "version": "0.2.17",
+  "version": "0.2.19",
   "type": "module",
   "description": "多个 agent 的工作台：把本机 Claude Code / Codex 放到一处统一管理，用飞书和 Web 页面随时驱动——会话、审批、模型切换都共用",
   "keywords": [

package/src/agents/claude/driver.ts

@@ -116,6 +116,13 @@ export class ClaudeDriver implements AgentDriver {
     }
   }
 
+  async sessionTitle(id: string, cwd: string): Promise<string | undefined> {
+    if (!SESSION_ID.test(id)) return undefined;
+    // SDK 的 customTitle 已经是「手动改的名 || 自动生成的 aiTitle」，不含首条消息兜底
+    const info = await getSessionInfo(id, { dir: cwd });
+    return info?.customTitle?.replace(/\s+/g, " ").trim() || undefined;
+  }
+
   /**
    * 把会话记录整理成「一问一答」：用户一条，助手把这一轮所有文本拼成一条，
    * 中间的工具调用作为过程摘要挂在助手那条上。工具结果（type=user 的 tool_result）

package/src/agents/codex/driver.ts

@@ -102,6 +102,11 @@ export class CodexDriver implements AgentDriver {
     }
   }
 
+  async sessionTitle(id: string): Promise<string | undefined> {
+    const res = await appServer.call<{ thread: Thread }>("thread/read", { threadId: id, includeTurns: false });
+    return res.thread.name?.replace(/\s+/g, " ").trim() || undefined;
+  }
+
   async readHistory(id: string): Promise<HistoryMessage[]> {
     const res = await appServer.call<{
       thread: { turns?: { id?: string; items?: HistoryItem[]; startedAt?: number | null; completedAt?: number | null }[] };

package/src/channels/feishu/cards.ts

@@ -61,8 +61,8 @@ export function approvalCard(interaction: Interaction, ctx: CardCtx) {
   const id = interaction.id;
   const buttons = [
     button("允许一次", { a: "approval", r: id, d: "allow-once" }, ctx, "primary"),
-    ...(spec.alwaysLabel ? [button(spec.alwaysLabel, { a: "approval", r: id, d: "allow-always" }, ctx)] : []),
     ...(spec.allowSession ? [button("本会话全部允许", { a: "approval", r: id, d: "allow-session" }, ctx)] : []),
+    ...(spec.alwaysLabel ? [button(spec.alwaysLabel, { a: "approval", r: id, d: "allow-always" }, ctx)] : []),
     button("拒绝", { a: "approval", r: id, d: "deny" }, ctx, "danger"),
   ];
   return card(

package/src/channels/web/api.ts

@@ -434,7 +434,8 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
     if (!sub && method === "PATCH") {
       const body = await readJsonBody<{ title?: string; hidden?: boolean }>(req);
       updateConversation(key, {
-        ...(typeof body.title === "string" ? { title: body.title.trim().slice(0, 80) } : {}),
+        // 手动改过名，就不再拿 agent 生成的标题覆盖
+        ...(typeof body.title === "string" ? { title: body.title.trim().slice(0, 80), titleAuto: false } : {}),
         ...(typeof body.hidden === "boolean" ? { hidden: body.hidden } : {}),
       });
       hub.emitEvent(key, { type: "meta" });

package/src/channels/web/server.ts

@@ -13,6 +13,7 @@ import { parseCommand } from "../../core/commands.js";
 import { hub, type EventEnvelope } from "../../core/hub.js";
 import { interactions, type Interaction } from "../../core/interactions.js";
 import { getConversation } from "../../core/store.js";
+import { RUNNING_VERSION } from "../../core/upgrade.js";
 import type { Settlement } from "../../core/types.js";
 import { authed, handleApi, takeUploads } from "./api.js";
 import { authEvents, ensureSetupToken, validateSession } from "./auth.js";
@@ -60,18 +61,33 @@ const MIME: Record<string, string> = {
   ".webmanifest": "application/manifest+json",
 };
 
-function serveFile(res: http.ServerResponse, file: string, cache: string): void {
+/**
+ * 静态文件一律 no-cache + Last-Modified：每次都向服务端确认一下，没变就回 304。
+ * 升级后 app.js、style.css、vendor 都会变，但地址不变，带 max-age 的话刷新页面还会拿到旧的。
+ */
+function serveFile(req: http.IncomingMessage, res: http.ServerResponse, file: string): void {
   fs.stat(file, (err, stat) => {
     if (err || !stat.isFile()) {
       res.writeHead(404, SECURITY_HEADERS);
       res.end("not found");
       return;
     }
-    res.writeHead(200, {
+    const lastModified = new Date(Math.floor(stat.mtimeMs / 1000) * 1000);
+    const since = Date.parse(req.headers["if-modified-since"] ?? "");
+    const headers = {
       ...SECURITY_HEADERS,
+      "Cache-Control": "no-cache",
+      "Last-Modified": lastModified.toUTCString(),
+    };
+    if (!Number.isNaN(since) && lastModified.getTime() <= since) {
+      res.writeHead(304, headers);
+      res.end();
+      return;
+    }
+    res.writeHead(200, {
+      ...headers,
       "Content-Type": MIME[path.extname(file)] ?? "application/octet-stream",
       "Content-Length": stat.size,
-      "Cache-Control": cache,
     });
     fs.createReadStream(file).pipe(res);
   });
@@ -81,7 +97,7 @@ function serveStatic(req: http.IncomingMessage, res: http.ServerResponse, url: U
   const vendor = VENDOR[url.pathname];
   if (vendor) {
     try {
-      serveFile(res, vendor(), "public, max-age=86400");
+      serveFile(req, res, vendor());
     } catch {
       res.writeHead(404);
       res.end();
@@ -108,9 +124,7 @@ function serveStatic(req: http.IncomingMessage, res: http.ServerResponse, url: U
     res.end();
     return;
   }
-  // 页面本身别缓存：升级后要立刻生效
-  serveFile(res, file, rel === "/index.html" || rel === "/sw.js" ? "no-cache" : "public, max-age=300");
-  void req;
+  serveFile(req, res, file);
 }
 
 // ---------- WebSocket ----------
@@ -397,7 +411,7 @@ export async function startWeb(): Promise<void> {
         });
         ws.on("close", () => clients.delete(client));
         ws.on("error", () => clients.delete(client));
-        send(client, { t: "hello", seq: hub.currentSeq(), epoch: EPOCH });
+        send(client, { t: "hello", seq: hub.currentSeq(), epoch: EPOCH, version: RUNNING_VERSION });
       });
     } catch (err) {
       console.error("[web] WebSocket 握手出错:", err);

package/src/core/hub.ts

@@ -159,6 +159,8 @@ class Hub extends EventEmitter<{ event: [EventEnvelope] }> {
   private locks = new Map<string, Promise<unknown>>();
   /** 最近一次点停止的时间：紧接着冒出来的「被打断」错误是预期内的，不当错误显示 */
   private stoppedAt = new Map<string, number>();
+  /** 正在等 agent 标题的对话，避免一轮轮叠加重试 */
+  private titleSyncing = new Set<string>();
   /**
    * 每条会话的「生命周期代次」：开新会话、分叉、恢复、切 agent、切目录时加一。
    * 渠道收到消息后还要先做异步的事（飞书下载附件），期间会话被换掉了的话，
@@ -497,6 +499,7 @@ class Hub extends EventEmitter<{ event: [EventEnvelope] }> {
           recordFooter(holder.session?.sessionId ?? (conv ? agentBinding(conv, agent).sessionId : undefined), result.text, footer);
           this.setInflight(key, (this.inflight.get(key) ?? 1) - 1);
           this.refreshRuntimeOnce(key, liveId);
+          this.syncTitle(key, agent);
         },
         onError: (err) => {
           if (!alive()) return;
@@ -555,6 +558,47 @@ class Hub extends EventEmitter<{ event: [EventEnvelope] }> {
     return session;
   }
 
+  /**
+   * 自动标题换成 agent 自己起的。agent 的标题是异步生成的，一轮结束时未必已经有了，
+   * 所以隔一会儿再问几次。每轮结束都会再同步一次：agent 后来改了标题（比如在终端里 /rename）也能跟上。
+   */
+  private syncTitle(key: string, agent: string, attempt = 0): void {
+    const delays = [1_000, 5_000, 15_000, 45_000];
+    const driver = this.drivers.get(agent);
+    if (!driver?.sessionTitle) return;
+    if (attempt === 0) {
+      if (this.titleSyncing.has(key)) return; // 上一轮的重试还在跑
+      this.titleSyncing.add(key);
+    }
+    if (attempt >= delays.length) {
+      this.titleSyncing.delete(key);
+      return;
+    }
+    setTimeout(() => {
+      void (async () => {
+        const conv = getConversation(key);
+        const sessionId = conv && conv.agent === agent ? agentBinding(conv, agent).sessionId : undefined;
+        if (!conv?.titleAuto || !sessionId) return this.titleSyncing.delete(key);
+        const title = await driver.sessionTitle!(sessionId, conv.cwd).catch((err) => {
+          console.error(`[${agent}] 读取会话标题失败:`, err instanceof Error ? err.message : err);
+          return undefined;
+        });
+        // 等待期间用户可能改了名、切了会话
+        const now = getConversation(key);
+        if (!now?.titleAuto || now.agent !== agent || agentBinding(now, agent).sessionId !== sessionId) {
+          return this.titleSyncing.delete(key);
+        }
+        if (!title) return this.syncTitle(key, agent, attempt + 1);
+        this.titleSyncing.delete(key);
+        const clipped = title.slice(0, 80);
+        if (clipped !== now.title) {
+          updateConversation(key, { title: clipped });
+          this.emitEvent(key, { type: "meta" });
+        }
+      })();
+    }, delays[attempt]);
+  }
+
   /** 丢掉活着的会话（不动绑定）。挂着的审批一并取消，否则阻塞的那一轮永远走不完。 */
   async drop(key: string, note: string): Promise<void> {
     interactions.cancelAll(key, note);
@@ -713,7 +757,8 @@ class Hub extends EventEmitter<{ event: [EventEnvelope] }> {
     const lastActive = conv.activeAt;
     touchConversation(key);
     if (!conv.title && conv.channel === "web" && input.text.trim()) {
-      updateConversation(key, { title: input.text.trim().replace(/\s+/g, " ").slice(0, 40) });
+      // 先用首条消息占位，第一轮结束后换成 agent 自己生成的短标题（syncTitle）
+      updateConversation(key, { title: input.text.trim().replace(/\s+/g, " ").slice(0, 40), titleAuto: true });
       this.emitEvent(key, { type: "meta" });
     }
     this.emitEvent(key, shown);

package/src/core/store.ts

@@ -28,6 +28,11 @@ export type Conversation = {
   /** 渠道实例：飞书是机器人 id，Web 固定 web */
   channelId: string;
   title?: string;
+  /**
+   * 标题是自动起的（先用首条消息占位，之后换成 agent 生成的标题），可以继续被 agent 的标题覆盖。
+   * 用户手动改过名就清掉，之后不再动它。
+   */
+  titleAuto?: boolean;
   agent: string;
   cwd: string;
   /** cwd 是否用户显式指定。没指定过的跟随 workspaceRoot 变化 */

package/src/core/types.ts

@@ -201,6 +201,8 @@ export interface AgentDriver {
   /** cwd 为 undefined 时列全部目录 */
   listSessions(cwd: string | undefined, limit?: number): Promise<SessionSummary[]>;
   sessionExists(id: string, cwd: string): Promise<boolean>;
+  /** agent 自己给会话起的标题（模型总结的或在别处改过的）；还没生成就返回 undefined，不拿首条消息凑数 */
+  sessionTitle?(id: string, cwd: string): Promise<string | undefined>;
   readHistory(id: string, cwd: string): Promise<HistoryMessage[]>;
   /**
    * 把会话复制出一条新的、返回新会话 id。anchor（HistoryMessage / TurnResult 里的）给了就只保留到

package/web/app.js

@@ -38,7 +38,6 @@ const ICON = {
   stop: '<svg viewBox="0 0 24 24" fill="currentColor"><rect x="7" y="7" width="10" height="10" rx="1.5"/></svg>',
   clip: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m21.4 11.6-9.2 9.2a6 6 0 0 1-8.5-8.5l9.2-9.2a4 4 0 0 1 5.7 5.7l-9.2 9.2a2 2 0 0 1-2.8-2.8l8.5-8.5"/></svg>',
   mic: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="2" width="6" height="12" rx="3"/><path d="M5 10a7 7 0 0 0 14 0M12 17v5"/></svg>',
-  more: '<svg viewBox="0 0 24 24" fill="currentColor"><circle cx="5" cy="12" r="2"/><circle cx="12" cy="12" r="2"/><circle cx="19" cy="12" r="2"/></svg>',
   down: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round"><path d="m6 9 6 6 6-6"/></svg>',
   gear: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><path d="M19.4 15a1.7 1.7 0 0 0 .3 1.8l.1.1a2 2 0 1 1-2.8 2.8l-.1-.1a1.7 1.7 0 0 0-1.8-.3 1.7 1.7 0 0 0-1 1.5V21a2 2 0 1 1-4 0v-.1a1.7 1.7 0 0 0-1.1-1.5 1.7 1.7 0 0 0-1.8.3l-.1.1a2 2 0 1 1-2.8-2.8l.1-.1a1.7 1.7 0 0 0 .3-1.8 1.7 1.7 0 0 0-1.5-1H3a2 2 0 1 1 0-4h.1a1.7 1.7 0 0 0 1.5-1.1 1.7 1.7 0 0 0-.3-1.8l-.1-.1a2 2 0 1 1 2.8-2.8l.1.1a1.7 1.7 0 0 0 1.8.3H9a1.7 1.7 0 0 0 1-1.5V3a2 2 0 1 1 4 0v.1a1.7 1.7 0 0 0 1 1.5 1.7 1.7 0 0 0 1.8-.3l.1-.1a2 2 0 1 1 2.8 2.8l-.1.1a1.7 1.7 0 0 0-.3 1.8V9a1.7 1.7 0 0 0 1.5 1H21a2 2 0 1 1 0 4h-.1a1.7 1.7 0 0 0-1.5 1Z"/></svg>',
   fork: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="6" cy="5" r="2"/><circle cx="6" cy="19" r="2"/><circle cx="18" cy="7" r="2"/><path d="M6 7v10"/><path d="M18 9c0 5-6 4-11.2 8.6"/></svg>',
@@ -269,6 +268,12 @@ const desktop = window.agentLoftDesktop ?? null;
 const desktopQuota = typeof desktop?.onQuota === "function";
 // 桌面端里：顶栏、侧栏顶部可以按住拖动窗口（样式见 style.css 的 .in-desktop）
 if (desktop) document.documentElement.classList.add("in-desktop");
+/**
+ * 新版桌面端顶栏的「更多」里能打开每台服务器的设置，额度也在它的菜单栏里：侧栏底部的额度和设置就不显示了。
+ * 老版本桌面端没有这个入口，照旧显示，免得设置打不开。
+ */
+const desktopSettings = typeof desktop?.onOpenSettings === "function";
+if (desktopSettings) document.documentElement.classList.add("desktop-settings");
 
 // ---------- WebSocket ----------
 
@@ -402,6 +407,7 @@ function markGone(ix) {
 function onWsMessage(msg) {
   switch (msg.t) {
     case "hello": {
+      if (checkServerVersion(msg.version)) return;
       const restarted = WS.epoch && WS.epoch !== msg.epoch;
       WS.epoch = msg.epoch;
       WS.hellos += 1;
@@ -464,14 +470,31 @@ function onWsMessage(msg) {
   }
 }
 
-function setConnBanner(text) {
+function setConnBanner(text, onclick) {
   ui.banner?.remove();
   ui.banner = null;
   if (!text || !ui.main) return;
-  ui.banner = h("div", { class: "conn-banner" }, text);
+  ui.banner = onclick ? h("button", { class: "conn-banner clickable", onclick }, text) : h("div", { class: "conn-banner" }, text);
   ui.main.append(ui.banner);
 }
 
+/** 页面加载时连上的服务端版本。服务端升级重启后版本变了，页面上跑的还是旧前端，得刷新 */
+let loadedServerVersion = null;
+
+/** 服务端换了版本：刷新页面换上新前端。返回 true 表示已经在刷新了，后面不用再处理 */
+function checkServerVersion(version) {
+  if (!version) return false;
+  if (!loadedServerVersion) loadedServerVersion = version;
+  if (version === loadedServerVersion) return false;
+  // 输入框里有没发出去的字：别直接刷掉，提示一下让用户自己点
+  if (ui.input?.value.trim()) {
+    setConnBanner(`服务端已升级到 ${version}，点这里刷新页面`, () => location.reload());
+    return false;
+  }
+  location.reload();
+  return true;
+}
+
 // ---------- 登录 ----------
 
 async function showAuth() {
@@ -549,6 +572,12 @@ async function boot() {
   desktop?.onOpen((key) => {
     if (key && S.convs.has(key) && key !== S.current) void openConversation(key);
   });
+  // 桌面端「更多」里点了这台服务器的设置；已经开着就不再叠一层
+  if (desktopSettings) {
+    desktop.onOpenSettings(() => {
+      if (!document.querySelector(".overlay .settings")) void openSettings();
+    });
+  }
   if ("serviceWorker" in navigator) {
     navigator.serviceWorker.register("/sw.js").catch(() => {});
     clearAppBadge();
@@ -579,6 +608,13 @@ function renderLayout() {
     lastDown = { key, at: now };
   });
   ui.convList.addEventListener("contextmenu", (e) => {
+    // 飞书机器人那一行：右键看这个机器人的所有聊天
+    const bot = e.target.closest?.("[data-bot]")?.dataset.bot;
+    if (bot) {
+      e.preventDefault();
+      showMenu({ x: e.clientX, y: e.clientY }, [{ label: "历史会话…", onclick: () => openBotConversations(bot) }]);
+      return;
+    }
     const key = e.target.closest?.("[data-key]")?.dataset.key;
     if (!key || !S.convs.has(key)) return;
     e.preventDefault();
@@ -1025,6 +1061,7 @@ function renderSidebar() {
         "button",
         {
           class: `conv-item${cur?.channel === "feishu" && cur.channelId === bot.id ? " active" : ""}`,
+          "data-bot": bot.id,
           title: latest ? `飞书 · ${bot.name}\n${agentLabel(latest.agent)} · ${latest.cwd}` : `飞书 · ${bot.name}\n还没有会话`,
           onclick: () => (latest ? open(latest.key) : toast("这个机器人还没有会话，先在飞书里给它发条消息")),
         },
@@ -1117,13 +1154,9 @@ function renderSidebar() {
 
 function renderTopbar() {
   const c = S.current ? S.convs.get(S.current) : null;
-  const more = h("button", { class: "icon-btn", title: "更多", onclick: (e) => openMoreMenu(e.currentTarget) }, icon("more"));
   fill(ui.topbar,
-    ...[
-      h("button", { class: "icon-btn menu-btn", onclick: openSide, title: "会话列表" }, icon("menu")),
-      h("div", { class: "top-title" }, c ? h("span", { class: "conv-name", title: convTitle(c) }, convTitle(c)) : null),
-      c ? more : null,
-    ].filter(Boolean),
+    h("button", { class: "icon-btn menu-btn", onclick: openSide, title: "会话列表" }, icon("menu")),
+    h("div", { class: "top-title" }, c ? h("span", { class: "conv-name", title: convTitle(c) }, convTitle(c)) : null),
   );
   renderContext();
 }
@@ -1380,24 +1413,6 @@ function closeMenu() {
   removeEventListener("blur", closeMenu);
 }
 
-function openMoreMenu(anchor) {
-  const c = S.convs.get(S.current);
-  if (!c) return;
-  showMenu(anchor, [
-    // 飞书机器人在侧栏只占一行（点开最近活跃的那个聊天），它的其他聊天从这里找
-    ...(c.channel === "feishu" ? [{ label: "历史会话…", onclick: () => openBotConversations(c.channelId) }] : []),
-    { label: "开新会话（清空上下文）", onclick: () => doAction("new") },
-    c.canFork
-      ? { label: "分叉成新对话", onclick: () => forkConversation() }
-      : { label: "分叉当前会话", onclick: () => doAction("fork") },
-    { label: "切换工作目录…", onclick: () => changeCwd() },
-    { label: "查看状态", onclick: () => showStatus() },
-    "sep",
-    { label: "重命名", onclick: () => renameConv(S.current) },
-    ...(c.channel === "web" ? [{ label: "从列表删除", danger: true, onclick: () => deleteConv() }] : []),
-  ]);
-}
-
 /** 侧栏会话的右键菜单：分叉 / 重命名 / 删除 */
 function openConvContextMenu(key, at) {
   const c = S.convs.get(key);
@@ -1948,12 +1963,12 @@ function renderInteraction(item) {
             "div",
             { class: "ix-buttons" },
             h("button", { class: "btn accent", onclick: () => ixOp(ix.id, "decide", { decision: "allow-once" }) }, "允许一次"),
-            spec.alwaysLabel
-              ? h("button", { class: "btn", onclick: () => ixOp(ix.id, "decide", { decision: "allow-always" }) }, spec.alwaysLabel)
-              : null,
             spec.allowSession
               ? h("button", { class: "btn", onclick: () => ixOp(ix.id, "decide", { decision: "allow-session" }) }, "本会话全部允许")
               : null,
+            spec.alwaysLabel
+              ? h("button", { class: "btn", onclick: () => ixOp(ix.id, "decide", { decision: "allow-always" }) }, spec.alwaysLabel)
+              : null,
             h("button", { class: "btn danger", onclick: () => ixOp(ix.id, "decide", { decision: "deny" }) }, "拒绝"),
           ),
     );
@@ -2041,7 +2056,8 @@ function renderComposer() {
     },
   });
   ui.sendBtn = h("button", { class: "send-btn", title: "发送", onclick: () => (S.busy && !hasDraft() ? stopTurn() : sendMessage()) });
-  ui.micBtn = SpeechRec
+  // 桌面端（Electron）里不放语音输入
+  ui.micBtn = SpeechRec && !desktop
     ? h("button", { class: "icon-btn mic-btn", title: "语音输入", onclick: toggleVoice }, icon("mic"))
     : null;
   ui.ctxBar = h("div", { class: "ctx-bar" });
@@ -2945,15 +2961,6 @@ async function changeCwd() {
   await load(startRel);
 }
 
-async function showStatus() {
-  try {
-    const data = await api(`/api/conversations/${encodeURIComponent(S.current)}/status`);
-    modal({ title: "状态", body: h("div", { class: "modal-body" }, renderMarkdown("```\n" + data.text + "\n```")) });
-  } catch (err) {
-    toast(err.message);
-  }
-}
-
 /** 重命名：小弹窗，回车保存、Esc 取消，打开时全选原名 */
 function renameConv(key = S.current) {
   const c = S.convs.get(key);

package/web/style.css

@@ -550,6 +550,11 @@ button.conv-group:hover {
   margin-left: auto;
 }
 
+/* 桌面端里：额度在菜单栏、设置在顶栏「更多」里，侧栏底部整条不要 */
+.desktop-settings .side-bottom {
+  display: none;
+}
+
 /* ---- 侧栏底部的额度 ---- */
 .quota {
   position: relative;
@@ -2139,6 +2144,13 @@ button.ctx-item:hover {
   z-index: 5;
 }
 
+.conn-banner.clickable {
+  border: 0;
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+}
+
 /* ---------- 弹层 ---------- */
 
 .overlay {