botmux 3.14.0 → 3.16.0

package/dist/dashboard/web/agent-workbench-storage.js

@@ -0,0 +1,197 @@
+import { clampRailWidth, defaultWorkbenchLayout, isWorkbenchGroupDimension, normalizeWorkbenchLayout, } from './agent-workbench-model.js';
+const STORAGE_PREFIX = 'botmux.agent-workbench.layout.v1:';
+const RAIL_PREFS_KEY = 'botmux.agent-workbench.rail.v1';
+const SEEN_LEDGER_KEY = 'botmux.agent-workbench.seen.v1';
+const GROUP_DIMENSION_KEY = 'botmux.agent-workbench.group-dim.v1';
+const COLLAPSED_GROUPS_KEY = 'botmux.agent-workbench.collapsed.v1';
+/** 账本只是本地未读提示，不需要记住所有历史会话。超过这个数就按时间新旧砍掉最老的，
+ *  免得一台常年不关的机器把 localStorage 撑爆。 */
+const SEEN_LEDGER_MAX_ENTRIES = 500;
+/** 折叠状态存的是组 key。换一次分组维度就可能长出一批新组名（机器人名、会话名、
+ *  仓库名都是数据里的自由文本），不封顶的话这张表只会越堆越长。 */
+const COLLAPSED_GROUPS_MAX_ENTRIES = 200;
+export function workbenchLayoutStorageKey(sessionId) {
+    return `${STORAGE_PREFIX}${encodeURIComponent(sessionId)}`;
+}
+export function loadWorkbenchLayout(sessionId, storage) {
+    if (!storage)
+        return defaultWorkbenchLayout();
+    try {
+        const raw = storage.getItem(workbenchLayoutStorageKey(sessionId));
+        return raw ? normalizeWorkbenchLayout(JSON.parse(raw)) : defaultWorkbenchLayout();
+    }
+    catch {
+        return defaultWorkbenchLayout();
+    }
+}
+/** Persists layout primitives only. URLs, grants, cookies and frame state are never serialised. */
+export function saveWorkbenchLayout(sessionId, layout, storage) {
+    if (!storage)
+        return false;
+    try {
+        storage.setItem(workbenchLayoutStorageKey(sessionId), JSON.stringify(normalizeWorkbenchLayout(layout)));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function loadWorkbenchRailPrefs(storage) {
+    if (!storage)
+        return null;
+    try {
+        const raw = storage.getItem(RAIL_PREFS_KEY);
+        if (!raw)
+            return null;
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            return null;
+        const input = parsed;
+        return {
+            railWidth: clampRailWidth(Number(input.railWidth)),
+            railCollapsed: input.railCollapsed === true,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function saveWorkbenchRailPrefs(storage, prefs) {
+    if (!storage)
+        return false;
+    try {
+        storage.setItem(RAIL_PREFS_KEY, JSON.stringify({
+            railWidth: clampRailWidth(Number(prefs.railWidth)),
+            railCollapsed: prefs.railCollapsed === true,
+        }));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function emptyWorkbenchSeenLedger() {
+    return { seen: {}, unread: {} };
+}
+function isPlainRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+/** 丢掉坏条目，再按时间保留最近 N 条。 */
+function normalizeStamps(value, max) {
+    if (!isPlainRecord(value))
+        return {};
+    const entries = [];
+    for (const [sessionId, raw] of Object.entries(value)) {
+        const at = Number(raw);
+        if (!sessionId || !Number.isFinite(at) || at <= 0)
+            continue;
+        entries.push([sessionId, at]);
+    }
+    if (entries.length > max) {
+        entries.sort((a, b) => b[1] - a[1]);
+        entries.length = max;
+    }
+    return Object.fromEntries(entries);
+}
+export function pruneWorkbenchSeenLedger(ledger, max = SEEN_LEDGER_MAX_ENTRIES) {
+    return {
+        seen: normalizeStamps(ledger.seen, max),
+        unread: normalizeStamps(ledger.unread, max),
+    };
+}
+/** 坏数据（不是 JSON、不是对象、两张表都不成形）一律回 null，让调用方走首次基线。 */
+export function loadWorkbenchSeenLedger(storage) {
+    if (!storage)
+        return null;
+    try {
+        const raw = storage.getItem(SEEN_LEDGER_KEY);
+        if (!raw)
+            return null;
+        const parsed = JSON.parse(raw);
+        if (!isPlainRecord(parsed))
+            return null;
+        if (!isPlainRecord(parsed.seen) && !isPlainRecord(parsed.unread))
+            return null;
+        return pruneWorkbenchSeenLedger({
+            seen: (parsed.seen ?? {}),
+            unread: (parsed.unread ?? {}),
+        });
+    }
+    catch {
+        return null;
+    }
+}
+export function saveWorkbenchSeenLedger(storage, ledger) {
+    if (!storage)
+        return false;
+    try {
+        storage.setItem(SEEN_LEDGER_KEY, JSON.stringify(pruneWorkbenchSeenLedger(ledger)));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 分组维度是全局偏好（不分会话）。白名单外的值一律当没存过。 */
+export function loadWorkbenchGroupDimension(storage) {
+    if (!storage)
+        return null;
+    try {
+        const raw = storage.getItem(GROUP_DIMENSION_KEY);
+        return isWorkbenchGroupDimension(raw) ? raw : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function saveWorkbenchGroupDimension(storage, dimension) {
+    if (!storage || !isWorkbenchGroupDimension(dimension))
+        return false;
+    try {
+        storage.setItem(GROUP_DIMENSION_KEY, dimension);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 去重 + 封顶。数组按「加入顺序」存，所以超出上限时砍掉最前面的（最早折叠的那些组）。 */
+function pruneCollapsedGroups(keys, max = COLLAPSED_GROUPS_MAX_ENTRIES) {
+    const valid = keys.filter((key) => typeof key === 'string' && key.length > 0);
+    const unique = [...new Set(valid)];
+    return unique.length > max ? unique.slice(unique.length - max) : unique;
+}
+/**
+ * 折叠起来的分组 key（`bot:Builder` 这种带维度前缀的稳定 key，全维度唯一，
+ * 所以一份平铺的数组就够，不需要按维度分表）。
+ * 坏 JSON 或压根不是数组 → null，让调用方走「全部展开」的默认；数组里混进
+ * 非字符串只剔掉那一项，不为一颗老鼠屎丢掉整份记忆。
+ */
+export function loadWorkbenchCollapsedGroups(storage) {
+    if (!storage)
+        return null;
+    try {
+        const raw = storage.getItem(COLLAPSED_GROUPS_KEY);
+        if (!raw)
+            return null;
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return null;
+        return pruneCollapsedGroups(parsed);
+    }
+    catch {
+        return null;
+    }
+}
+export function saveWorkbenchCollapsedGroups(storage, keys) {
+    if (!storage)
+        return false;
+    try {
+        storage.setItem(COLLAPSED_GROUPS_KEY, JSON.stringify(pruneCollapsedGroups([...keys])));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=agent-workbench-storage.js.map

package/dist/dashboard/web/agent-workbench-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-workbench-storage.js","sourceRoot":"","sources":["../../../src/dashboard/web/agent-workbench-storage.ts"],"names":[],"mappings":"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"}

package/dist/dashboard/web/agent-workbench-touch.d.ts

@@ -0,0 +1,46 @@
+import type { WorkbenchApi } from './agent-workbench-api.js';
+/**
+ * 触屏鉴权契约（P1-17）。
+ *
+ * 工作台上凡是要把终端塞进浏览器的地方，鉴权走哪条路都不看登录态，只看「这个浏览器
+ * 发 WebSocket 时带不带 Cookie」：
+ *   • 桌面登录态 → 同源 `/s/<id>`。Cookie 带得过去，而且它捎带接管授权。
+ *   • 触屏（iOS WebView / 飞书内嵌浏览器）→ 必须换成带 `?viewToken=` 的能力地址。
+ *     iOS WebView 发起 WS 升级时不带 Cookie，同源地址即使页面本身能加载，紧接着的
+ *     握手也会被 403 掉，终端永远停在 disconnected。
+ *   • 未登录 → 同样只能走 viewToken。
+ *
+ * 这两个 hook 就是那份契约本身。以前它只长在终端面板里，会话坞另起一套「永远发裸
+ * /s/ 链接」的写法，于是手机上点开就是 403 空白——同一份判断只能有一处实现，坞和面板
+ * 都从这里取。
+ */
+/** 当前是不是触屏环境。matchMedia + change 订阅，卸载时退订；`maxTouchPoints` 兜住
+ *  那些同时报 hover 的混合设备（iPad 接键盘、Windows 触屏本）。 */
+export declare function useTouchEnvironment(): boolean;
+export interface TerminalViewLink {
+    sessionId: string;
+    url: string;
+    expiresAt: number | null;
+}
+export type TerminalViewLinkPhase = 'idle' | 'loading' | 'ready' | 'failed';
+export interface TerminalViewLinkState {
+    /** 当前可用的只读链接。`null` 表示还没拿到——调用方必须停在等待态，
+     *  **绝不能**回退到裸同源地址：那条路在触屏上必然是黑屏。 */
+    link: TerminalViewLink | null;
+    phase: TerminalViewLinkPhase;
+    /** 手动重试。effect 的 cleanup 会取消挂起的自动重试，所以连点不会叠定时器。 */
+    retry(): void;
+}
+/**
+ * 拉取并维护一条短时 viewToken 只读链接（`GET /api/sessions/<id>/view-link`）。
+ * 服务端只返回同源路径，api 层已经做了形状校验与同源改写（P1-5）。
+ *
+ * `enabled=false` 时不发任何请求，phase 停在 idle：桌面登录态、外部 Riff 终端这些
+ * 用不上能力凭证的场合就该一次都不问。
+ */
+export declare function useTerminalViewLink(params: {
+    api: WorkbenchApi;
+    sessionId: string;
+    enabled: boolean;
+}): TerminalViewLinkState;
+//# sourceMappingURL=agent-workbench-touch.d.ts.map

package/dist/dashboard/web/agent-workbench-touch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-workbench-touch.d.ts","sourceRoot":"","sources":["../../../src/dashboard/web/agent-workbench-touch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;;;;;;;;;GAcG;AAEH;+CAC+C;AAC/C,wBAAgB,mBAAmB,IAAI,OAAO,CAa7C;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5E,MAAM,WAAW,qBAAqB;IACpC;wCACoC;IACpC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,qBAAqB,CAAC;IAC7B,mDAAmD;IACnD,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,GAAG,EAAE,YAAY,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,qBAAqB,CA0DxB"}

package/dist/dashboard/web/agent-workbench-touch.js

@@ -0,0 +1,96 @@
+import { useCallback, useEffect, useState } from 'react';
+/**
+ * 触屏鉴权契约（P1-17）。
+ *
+ * 工作台上凡是要把终端塞进浏览器的地方，鉴权走哪条路都不看登录态，只看「这个浏览器
+ * 发 WebSocket 时带不带 Cookie」：
+ *   • 桌面登录态 → 同源 `/s/<id>`。Cookie 带得过去，而且它捎带接管授权。
+ *   • 触屏（iOS WebView / 飞书内嵌浏览器）→ 必须换成带 `?viewToken=` 的能力地址。
+ *     iOS WebView 发起 WS 升级时不带 Cookie，同源地址即使页面本身能加载，紧接着的
+ *     握手也会被 403 掉，终端永远停在 disconnected。
+ *   • 未登录 → 同样只能走 viewToken。
+ *
+ * 这两个 hook 就是那份契约本身。以前它只长在终端面板里，会话坞另起一套「永远发裸
+ * /s/ 链接」的写法，于是手机上点开就是 403 空白——同一份判断只能有一处实现，坞和面板
+ * 都从这里取。
+ */
+/** 当前是不是触屏环境。matchMedia + change 订阅，卸载时退订；`maxTouchPoints` 兜住
+ *  那些同时报 hover 的混合设备（iPad 接键盘、Windows 触屏本）。 */
+export function useTouchEnvironment() {
+    const [touch, setTouch] = useState(false);
+    useEffect(() => {
+        if (typeof window === 'undefined' || !window.matchMedia)
+            return undefined;
+        const query = window.matchMedia('(hover: none)');
+        const sync = () => setTouch((typeof navigator !== 'undefined' && navigator.maxTouchPoints > 0) || query.matches);
+        sync();
+        query.addEventListener?.('change', sync);
+        return () => query.removeEventListener?.('change', sync);
+    }, []);
+    return touch;
+}
+/**
+ * 拉取并维护一条短时 viewToken 只读链接（`GET /api/sessions/<id>/view-link`）。
+ * 服务端只返回同源路径，api 层已经做了形状校验与同源改写（P1-5）。
+ *
+ * `enabled=false` 时不发任何请求，phase 停在 idle：桌面登录态、外部 Riff 终端这些
+ * 用不上能力凭证的场合就该一次都不问。
+ */
+export function useTerminalViewLink(params) {
+    const { api, enabled, sessionId } = params;
+    const [link, setLink] = useState(null);
+    const [phase, setPhase] = useState('idle');
+    const [attempt, setAttempt] = useState(0);
+    useEffect(() => {
+        if (!enabled)
+            return undefined;
+        const controller = new AbortController();
+        let retry;
+        // 换会话才清掉手上的链接；同一会话的到期前换链（下面那个 effect 触发的重取）让旧
+        // 链接一直顶到新链接就位，避免闪一下「正在获取…」空态。
+        setLink(previous => (previous?.sessionId === sessionId ? previous : null));
+        setPhase('loading');
+        void api.getTerminalViewLink(sessionId, controller.signal)
+            .then(fresh => {
+            // Every failure — abort included — comes back as null rather than a
+            // rejection, so this still runs after cleanup. Never schedule past it.
+            if (controller.signal.aborted)
+                return;
+            if (fresh) {
+                setLink({ sessionId, url: fresh.url, expiresAt: fresh.expiresAt });
+                setPhase('ready');
+                return;
+            }
+            setPhase('failed');
+            // 手上的旧链接没过期就先继续用它顶着（后台重试换新）；已过期的链接 worker 端
+            // 已经关了 WS，留着只会是假活着的黑屏，撤下换诚实的失败态。
+            setLink(previous => (previous?.sessionId === sessionId && previous.expiresAt !== null && previous.expiresAt <= Date.now()
+                ? null
+                : previous));
+            // A missing link usually means the login lapsed or the worker has not
+            // registered its terminal yet; both recover without the viewer acting.
+            retry = setTimeout(() => setAttempt(value => value + 1), 8_000);
+        });
+        return () => {
+            controller.abort();
+            if (retry !== undefined)
+                clearTimeout(retry);
+        };
+    }, [api, attempt, enabled, sessionId]);
+    // 短时 viewToken（P1-5）到期前主动换链：提前 30 秒重拉一条 view-link，成功后调用方
+    // 平滑接续；真到期后 worker 会按签名边界关掉 WS，旧链接自己救不回来。至少 5 秒的
+    // 下限防止服务端给出过近的到期时间时打转。
+    useEffect(() => {
+        if (phase !== 'ready' || link?.expiresAt == null)
+            return undefined;
+        const lead = link.expiresAt - Date.now() - 30_000;
+        const timer = setTimeout(() => setAttempt(value => value + 1), Math.max(5_000, lead));
+        return () => clearTimeout(timer);
+    }, [link, phase]);
+    const retry = useCallback(() => {
+        setPhase('loading');
+        setAttempt(value => value + 1);
+    }, []);
+    return { link, phase, retry };
+}
+//# sourceMappingURL=agent-workbench-touch.js.map

package/dist/dashboard/web/agent-workbench-touch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-workbench-touch.js","sourceRoot":"","sources":["../../../src/dashboard/web/agent-workbench-touch.ts"],"names":[],"mappings":"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"}

package/dist/dashboard/web/agent-workbench-view.d.ts

@@ -0,0 +1,34 @@
+import { type WorkbenchSessionRow, type WorkbenchTerminalLocation } from './agent-workbench-model.js';
+import { type WorkbenchStorage } from './agent-workbench-storage.js';
+import type { FeishuJsApi, WorkbenchH5Context } from './agent-workbench-chat.js';
+import { type WorkbenchApi } from './agent-workbench-api.js';
+import type { WorkbenchCapabilities } from './agent-workbench-capabilities.js';
+export interface AgentWorkbenchViewProps {
+    sessions: readonly WorkbenchSessionRow[];
+    online: boolean;
+    authenticated: boolean;
+    /** P1-4：服务端投影的最小操作能力集。`authenticated` 只决定观察级形态（同源
+     *  终端链路、控制权状态拉取）；三类操作入口分别看 canLocate（定位按钮）、
+     *  canControl（终端接管）、canInteract（Preview 解锁）。必填——调用方必须显式
+     *  给出投影值（页面从 ui.workbenchCapabilities 取，缺省已是全 false）。 */
+    capabilities: WorkbenchCapabilities;
+    /** 本机**完整管理身份**（`/api/settings` 的 `authed`，即 Dashboard 既有的
+     *  owner 判据）。只用来决定「常驻链接」这一个入口画不画：那条端点只对 legacy
+     *  管理 cookie 开放，H5/平台身份点了必然 401。缺省 false = fail closed。
+     *  与 `authenticated`（能进工作台）和 `capabilities`（三类会话操作）都不同轴，
+     *  所以单独一个字段，不塞进能力集。 */
+    manageAuthed?: boolean;
+    initialSessionId?: string | null;
+    locale?: string;
+    now?: number;
+    viewportWidth?: number;
+    api?: WorkbenchApi;
+    storage?: WorkbenchStorage | null;
+    location?: WorkbenchTerminalLocation | null;
+    h5Context?: WorkbenchH5Context | null;
+    sdk?: FeishuJsApi | null;
+    demo?: boolean;
+    onRouteChange?(hash: string): void;
+}
+export declare function AgentWorkbenchView(props: AgentWorkbenchViewProps): JSX.Element;
+//# sourceMappingURL=agent-workbench-view.d.ts.map

package/dist/dashboard/web/agent-workbench-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-workbench-view.d.ts","sourceRoot":"","sources":["../../../src/dashboard/web/agent-workbench-view.tsx"],"names":[],"mappings":"AASA,OAAO,EAeL,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAWL,KAAK,gBAAgB,EACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAMjF,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAS/E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB;;;6DAGyD;IACzD,YAAY,EAAE,qBAAqB,CAAC;IACpC;;;;2BAIuB;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAC5C,SAAS,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACtC,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAgED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,GAAG,CAAC,OAAO,CA8gB9E"}