termdock 1.4.322 → 1.4.324

package/dist/server/utils/tmuxCopySelection.js

@@ -0,0 +1,94 @@
+import { randomUUID } from 'node:crypto';
+export const TMUX_COPY_MAX_BYTES = 256 * 1024;
+const FORMAT = '#{session_id}\t#{pane_id}\t#{pane_in_mode}\t#{selection_present}';
+function state(value) {
+    const parts = value.replace(/\r?\n$/, '').split('\t');
+    if (parts.length !== 4 || !/^\$\d+$/.test(parts[0]) || !/^%\d+$/.test(parts[1]) || !/^[01]$/.test(parts[2]) || !/^[01]?$/.test(parts[3]))
+        throw new Error('Tmux selection state was not confirmed');
+    return { session: parts[0], pane: parts[1], inMode: parts[2] === '1', selected: parts[3] === '1' };
+}
+/** Read this session's current selection through a unique, self-owned buffer.
+ * No global last-buffer read, shell copy command, clipboard write or mode exit. */
+export async function copyTmuxSelection(target, run) {
+    if (!target.trim() || /[\0\r\n]/.test(target))
+        throw new Error('Invalid tmux selection target');
+    const exact = `=${target}:`;
+    const read = () => run(['display-message', '-t', exact, '-p', FORMAT], { maxBuffer: 1024 }).then(state);
+    const before = await read();
+    const empty = () => ({ status: 'empty', paneId: before.pane, text: '', bytes: 0 });
+    if (!before.inMode || !before.selected)
+        return empty();
+    const prefix = `termdock-copy-${randomUUID()}-`;
+    const own = new RegExp(`^${prefix}[0-9]+$`);
+    const buffers = [];
+    let failed = false;
+    let primaryError;
+    const listArgs = ['list-buffers', '-f', `#{m:${prefix}*,#{buffer_name}}`, '-F', '#{buffer_name}\t#{buffer_size}'];
+    try {
+        await run(['send-keys', '-t', before.pane, '-X', 'copy-selection-no-clear', prefix], { maxBuffer: 1024 });
+        const metadata = await run(listArgs, { maxBuffer: 64 * 1024 });
+        for (const line of metadata.split('\n').filter(Boolean)) {
+            const [name, count] = line.split('\t');
+            if (!own.test(name))
+                throw new Error('Tmux returned an unowned selection buffer');
+            buffers.push({ name, bytes: Number(count) });
+            if (!/^\d+$/.test(count) || !Number.isSafeInteger(Number(count)))
+                throw new Error('Invalid owned tmux buffer metadata');
+        }
+        if (!buffers.length)
+            return empty();
+        if (buffers.length !== 1)
+            throw new Error('Tmux produced ambiguous selection buffers');
+        const buffer = buffers[0];
+        if (buffer.bytes > TMUX_COPY_MAX_BYTES)
+            throw new Error('Tmux selection exceeds the 256 KiB copy limit');
+        const text = await run(['save-buffer', '-b', buffer.name, '-'], { maxBuffer: TMUX_COPY_MAX_BYTES + 1 });
+        const after = await read();
+        if (after.session !== before.session || after.pane !== before.pane || !after.inMode || !after.selected)
+            throw new Error('Tmux selection target changed while copying');
+        const bytes = Buffer.byteLength(text, 'utf8');
+        if (bytes !== buffer.bytes || bytes > TMUX_COPY_MAX_BYTES)
+            throw new Error('Tmux selection was not read completely');
+        return bytes ? { status: 'copied', paneId: before.pane, text, bytes } : empty();
+    }
+    catch (error) {
+        failed = true;
+        primaryError = error;
+        throw error;
+    }
+    finally {
+        // A command may create its buffer before its reply fails. Enumerate only
+        // this UUID prefix even after metadata failure and attempt every own delete.
+        const names = new Set(buffers.map(buffer => buffer.name));
+        const cleanupErrors = [];
+        try {
+            const remaining = await run(listArgs, { maxBuffer: 64 * 1024 });
+            for (const line of remaining.split('\n').filter(Boolean)) {
+                const name = line.split('\t')[0];
+                if (!own.test(name)) {
+                    cleanupErrors.push(new Error('Tmux cleanup returned an unowned buffer'));
+                    continue;
+                }
+                names.add(name);
+            }
+        }
+        catch (error) {
+            cleanupErrors.push(error);
+        }
+        for (const name of names) {
+            try {
+                await run(['delete-buffer', '-b', name], { maxBuffer: 1024 });
+            }
+            catch (error) {
+                cleanupErrors.push(error);
+            }
+        }
+        if (cleanupErrors.length) {
+            const error = new AggregateError(cleanupErrors, 'Owned tmux copy buffer cleanup failed');
+            if (!failed)
+                throw error;
+            if (primaryError instanceof Error)
+                primaryError.cause = error;
+        }
+    }
+}

package/dist/server/utils/tmuxEmptyServerProbe.js

@@ -0,0 +1,15 @@
+/** A has-session failure is not evidence that tmux itself is unavailable.
+ * Confirm this one empty-server case without changing generic error handling. */
+export async function isConfirmedEmptyTmuxServer(error, target, run) {
+    if (!target.trim() || !error || typeof error !== 'object')
+        return false;
+    const value = error;
+    if (value.code !== 1 || typeof value.stderr !== 'string' || value.stderr.trim() !== 'no current target')
+        return false;
+    try {
+        return (await run(['list-sessions', '-F', '#{session_id}'])).trim() === '';
+    }
+    catch {
+        return false;
+    }
+}

package/docs/integrations.md

@@ -1291,3 +1291,39 @@ runtime_resolved / queue_acquired / before_paste / before_submit`。时间是 TD
 确定性交错回归覆盖延迟改名/元数据回写、清除检查、持久化等待、输入队列等待、
 真实第二次启动、backend 替换及重新绑定；发生真实换代时，旧输入及旧的延迟回车
 仍被拒绝。测试证明 TD 一致性与终端写入边界，不代替私有 Agent 的实机消费验收。
+
+## 1.4.323：归档与恢复本机协作组显示
+
+最低 **CLI / 实际服务均为 1.4.323**，回读
+`admin_local_group_archive=true`、`admin_local_group_archive_min_version=1.4.323`。
+本机管理员可归档/恢复精确本机组；CLI 与服务均检查能力，旧服务返回
+`ADMIN_LOCAL_GROUP_ARCHIVE_UNSUPPORTED`。
+
+```sh
+td integration group get <精确group-id>
+td integration group archive <精确group-id> \
+  --expected-updated-at <当前updatedAt> --idempotency-key case-archive:v1
+td integration groups                         # 默认不列出归档组
+td integration groups --include-archived       # 显式查看
+td integration group unarchive <精确group-id> \
+  --expected-updated-at <当前updatedAt> --idempotency-key case-restore:v1
+```
+
+`group get` 对归档组仍可用，并在归档时返回 `archivedAt`。归档/恢复仅修改
+`archivedAt` 与组的 `updatedAt`，不改 `id`、名称、成员/角色、principal 固定组、
+TD/native session、运行承载、消息/reply、consumer 游标或历史；不关闭、释放、恢复
+会话，不停止业务调度，也不重放消息。Web 侧栏默认隐藏归档组，在“已归档协作组”
+中可查看并恢复显示；恢复组显示不会重启已关闭的 session。
+
+管理路由为 `POST /admin/groups/:id/archive` 与 `POST /admin/groups/:id/unarchive`，
+请求仅接受 `{expected_updated_at,idempotency_key}`。`GET /admin/groups` 默认隐藏归档
+组，传 `?include_archived=true` 显示归档组。归档/恢复 key 在同一操作范围内唯一，
+参数改变返回 `IDEMPOTENCY_CONFLICT`。成功回执分开返回当前 `group`、本次提交的
+`applied` 和 `replayed`；旧回执重放不会覆盖后来版本。并发版本过期返回
+`GROUP_CHANGED` 与 `currentUpdatedAt`，应先重新 get，再由调用者决定是否用新 key
+重试。同状态操作保留原 `archivedAt` 并记录幂等回执，不推进组版本。
+
+归档 journal 与组状态原子持久化，保留上限为 2000 条。状态/journal 不完整时返回
+`GROUP_ARCHIVE_STATE_UNCONFIRMED`，不会猜测或重建。只允许本机非 federated、未删除
+组；删除组、跨服务组和不确定的目标分别返回 `GROUP_NOT_FOUND`、`GROUP_NOT_LOCAL`、
+`GROUP_ARCHIVE_TARGET_UNAVAILABLE`。归档不延长消息历史保留期。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termdock",
-  "version": "1.4.322",
+  "version": "1.4.324",
   "description": "A complete web-based terminal application with modern UI",
   "type": "module",
   "main": ".desktop-dist/main.js",
@@ -43,7 +43,10 @@
     "test": "vitest --passWithNoTests",
     "test:ui": "vitest --ui",
     "prepublishOnly": "npm run build",
-    "postinstall": "node scripts/postinstall.mjs"
+    "postinstall": "node scripts/postinstall.mjs",
+    "preview:desktop:dev": "npm --prefix desktop-rust run dev",
+    "preview:desktop:build": "npm --prefix desktop-rust run build",
+    "preview:desktop:test": "npm --prefix desktop-rust run verify"
   },
   "dependencies": {
     "@chainsafe/libp2p-noise": "17.0.0",

package/runtime-manifest.json

@@ -1,13 +1,13 @@
 {
   "schemaVersion": 1,
   "packageName": "termdock",
-  "version": "1.4.322",
+  "version": "1.4.324",
   "runtimeProtocolVersion": 1,
   "minimumDesktopVersion": "1.4.46",
   "nodeMajor": 22,
   "dependencyHash": "sha256-oaGYi/P5ob8sd6VnNBOwshKozjhdV+hYiCmLAsn5x00=",
-  "serverBundleHash": "sha256-T9JZp3X9tfMUYciSrnZbiUIXuc+IHqHJuGp6Wf5bHs8=",
-  "clientBundleHash": "sha256-4wVT4/UzD+TMRQjVw307g0c0x0cJm6NknoDeybiIQfA=",
+  "serverBundleHash": "sha256-yjPt7bAXNp3KrOLjsqzi7sVLnPj/UD3Qz7jSJwgX9gU=",
+  "clientBundleHash": "sha256-AoWtEiTNIyzQQDP3vrVfbjymEXr6cyRy/8C++LTIBtc=",
   "entrypoint": "dist/server/cli.js",
   "clientEntrypoint": "dist/client/index.html"
 }