termdock 1.4.302 → 1.4.304

package/dist/server/agent/nativeResumeOwner.js

@@ -0,0 +1,53 @@
+import { integrationError } from './integrationStore.js';
+/** A tmux remains observable without a browser/PTY attachment, including after
+ * service restart. Inventory UUIDs never filter the candidate set. */
+export function collectNativeResumeOwnerCandidates(inventory, backends) {
+    const candidates = [];
+    const seenTmux = new Set(), seenBackend = new Set();
+    for (const entry of inventory) {
+        if (entry.mode !== 'tmux' || !entry.tmuxSessionName || seenTmux.has(entry.tmuxSessionName))
+            continue;
+        const backend = entry.backendSessionId ? backends.get(entry.backendSessionId) : null;
+        candidates.push({ backendSessionId: entry.backendSessionId ?? `inventory:${entry.sessionId}`,
+            tmuxSessionName: entry.tmuxSessionName, cachedSlug: backend?.agent?.slug ?? entry.agentResume?.slug ?? null,
+            cachedNativeId: backend?.agentSession?.sessionId ?? entry.agentResume?.sessionId ?? null });
+        seenTmux.add(entry.tmuxSessionName);
+        if (entry.backendSessionId)
+            seenBackend.add(entry.backendSessionId);
+    }
+    for (const [backendSessionId, backend] of backends) {
+        if (seenBackend.has(backendSessionId) || backend.mode === 'tmux' && backend.tmuxSessionName && seenTmux.has(backend.tmuxSessionName))
+            continue;
+        candidates.push({ backendSessionId, tmuxSessionName: backend.mode === 'tmux' ? backend.tmuxSessionName : null,
+            cachedSlug: backend.agent?.slug ?? null, cachedNativeId: backend.agentSession?.sessionId ?? null });
+        if (backend.mode === 'tmux' && backend.tmuxSessionName)
+            seenTmux.add(backend.tmuxSessionName);
+    }
+    return candidates;
+}
+/** Only process observations prove presence or absence of another owner.
+ * Cached UUIDs cannot exclude a terminal; the caller verifies its own pane. */
+export async function assertNativeResumeAvailable(target, excludedBackendSessionId, candidates, observe) {
+    let uncertain = false;
+    for (const candidate of candidates) {
+        if (candidate.backendSessionId === excludedBackendSessionId)
+            continue;
+        let processes;
+        try {
+            processes = await observe(candidate);
+        }
+        catch {
+            uncertain = true;
+            continue;
+        }
+        for (const process of processes) {
+            if (process.confirmed && process.agentSlug === target.slug && process.nativeId === target.nativeSessionId) {
+                integrationError('NATIVE_SESSION_ALREADY_RUNNING', 'Another terminal process proves the exact native conversation is running', 409);
+            }
+            if (!process.confirmed || process.agentSlug === target.slug && !process.nativeId)
+                uncertain = true;
+        }
+    }
+    if (uncertain)
+        integrationError('NATIVE_SESSION_OWNER_UNCONFIRMED', 'A possible native owner cannot be verified; inspect its terminal before restoring', 409);
+}

package/dist/server/routes/terminal.js

@@ -1,5 +1,6 @@
 import { collaborationSessionDisplayName } from '../utils/sessionDisplayName.js';
 import { integrationError } from '../agent/integrationStore.js';
+import { assertNativeResumeAvailable, collectNativeResumeOwnerCandidates } from '../agent/nativeResumeOwner.js';
 import { integrationLaunchCommand } from '../agent/integrationSessions.js';
 import { ensureTeam } from '../agent/collaborationTeam.js';
 import { androidRecordings } from '../android/recording.js';
@@ -1899,11 +1900,52 @@ export const integrationSessionAdapter = {
         const agent = agentBySlug(record.agent_slug);
         if (!record.agent_native_session_id || !agent || !buildResumeCommand(agent, record.agent_native_session_id, null))
             integrationError('EXACT_RESUME_UNSUPPORTED', 'Agent plugin must support exact native resume');
-        if (findActiveAgentResumeOwner('', { slug: record.agent_slug, nativeSessionId: record.agent_native_session_id, command: '' }))
-            integrationError('NATIVE_SESSION_ALREADY_RUNNING', 'Native Agent conversation is already running', 409);
+        await assertIntegrationNativeResumeAvailable(record);
         await launchIntegrationTerminal(record, true, prepared);
     },
 };
+async function assertIntegrationNativeResumeAvailable(record) {
+    const own = integrationTerminalRecord(record);
+    // Refresh the shared Linux process snapshot once for this restore decision.
+    // Never use a recovered hook or the last-known UUID as live-owner proof.
+    if (process.platform === 'linux')
+        await getProcessSnapshot(true);
+    const candidates = collectNativeResumeOwnerCandidates(globalSessionState.sessions, terminalSessions);
+    await assertNativeResumeAvailable({ slug: record.agent_slug, nativeSessionId: record.agent_native_session_id }, own?.backendSessionId ?? null, candidates, async (candidate) => {
+        const backend = terminalSessions.get(candidate.backendSessionId);
+        const tmuxSessionName = candidate.tmuxSessionName;
+        // Duplicate inventory attachments to the original owned pane are not
+        // another process; launchIntegrationTerminal verifies that pane again.
+        if (tmuxSessionName && tmuxSessionName === own?.tmuxSessionName)
+            return [];
+        if (tmuxSessionName) {
+            try {
+                await runTmux(['has-session', '-t', `=${tmuxSessionName}`]);
+            }
+            catch (error) {
+                if (/can't find session|no server running|no sessions|error connecting.*No such file/i.test(getErrorMessage(error)))
+                    return [];
+                throw error;
+            }
+            const layout = await getTmuxLayout(tmuxSessionName);
+            return Promise.all(layout.windows.flatMap(window => window.panes).map(async (pane) => {
+                const program = await resolveTmuxPaneProgram(pane, true, true);
+                const agent = detectAgentFromCommand(program?.rawArgs ?? program?.command ?? '', agentCustomCommands());
+                const shell = !agent && await integrationPaneIsIdleShell({ panePid: pane.pid,
+                    isShell: shellNamesBackend.has(normalizeProgramName(program?.command ?? '')?.toLowerCase() ?? '') });
+                return { confirmed: shell || program?.source === 'tmux-tty' && Boolean(program.rawArgs),
+                    agentSlug: agent?.slug ?? null,
+                    nativeId: agent && program?.rawArgs ? inferResumeSessionId(agent, splitCommandToArgv(program.rawArgs)) : null };
+            }));
+        }
+        if (!backend)
+            return [];
+        const program = await detectShellActiveProgram(backend);
+        const agent = detectAgentFromCommand(program?.rawArgs ?? program?.command ?? '', agentCustomCommands());
+        return [{ confirmed: !!program && program.source !== 'unknown', agentSlug: agent?.slug ?? null,
+                nativeId: agent && program?.rawArgs ? inferResumeSessionId(agent, splitCommandToArgv(program.rawArgs)) : null }];
+    });
+}
 async function launchIntegrationTerminal(record, restoring, prepared) {
     await collaborationDeliveryWorker.reconfigure(record.session_id, async () => {
         const group = collaborationStore.getGroup(record.group_id);
@@ -3826,9 +3868,9 @@ function parseProcessSnapshot(stdout) {
     })
         .filter((row) => row !== null);
 }
-async function getProcessSnapshot() {
+async function getProcessSnapshot(refresh = false) {
     const now = Date.now();
-    if (processSnapshot && now - processSnapshot.fetchedAt < PROCESS_SNAPSHOT_CACHE_TTL_MS) {
+    if (!refresh && processSnapshot && now - processSnapshot.fetchedAt < PROCESS_SNAPSHOT_CACHE_TTL_MS) {
         return processSnapshot.rows;
     }
     if (processSnapshotPromise)
@@ -3846,7 +3888,7 @@ async function getProcessSnapshot() {
     });
     return processSnapshotPromise;
 }
-async function resolveTmuxPaneProgram(pane, requireArgs = false) {
+async function resolveTmuxPaneProgram(pane, requireArgs = false, refreshTty = false) {
     // If pane command is a known shell, try to find a child foreground process
     const command = normalizeProgramName(pane.command);
     const commandKey = command?.toLowerCase() ?? null;
@@ -3891,7 +3933,7 @@ async function resolveTmuxPaneProgram(pane, requireArgs = false) {
                     };
                 })
                     .filter((row) => row !== null);
-            });
+            }, refreshTty);
         }
         const selected = selectTmuxForegroundProgram({
             panePid: pane.pid,

package/docs/integrations.md

@@ -3,7 +3,9 @@
 最低 CLI / 运行服务版本：**termdock 1.4.300**，两者都必须升级并重启服务。
 启动输入条件与保留凭据的策略更新要求 **CLI / 实际运行服务均至少 1.4.301**；协议仍为 1。
 插件原生 ID 的前台 argv 回读及服务重启后的运行中 restore 核验修复要求
-**实际运行服务至少 1.4.302**；建议 CLI 与服务同步安装 1.4.302（CLI 最低仍为 1.4.301）。
+**实际运行服务至少 1.4.302**。退出后的重复原生会话检查修复要求
+**实际运行服务至少 1.4.303**。没有 PTY 附着的已登记 tmux 的重复保护修复要求
+**实际运行服务至少 1.4.304**；建议 CLI 与服务同步安装 1.4.304（CLI 最低仍为 1.4.301）。
 现有 `--session`、消息投递、任务报告与自动协作入口继续兼容；旧的
 `task create --integration` 仍表示代码集成子任务，新身份使用 `--principal`。
 
@@ -90,6 +92,9 @@ CLI 使用当前运行服务的端口，默认 9834。每个端口的身份、
 
 TraeX 的恢复画面可能仅在 footer 显示模型，没有 `model:` 标题；因此示例不要求
 该前缀。管理员须同时核对冷启动和恢复画面，条件不匹配时保持待投递。
+模型 footer 可能被 Git 错误或键盘提示替换，此时含模型文字的 `allOf` 条件不会
+匹配。请选择实际画面中稳定且能区分加载阶段的文字；TD 不用原生 UUID ready、
+历史模型文字或推测的忙闲状态代替配置条件，超时也不会自动放宽。
 
 `allOf` 的每个字面文本都须出现，`noneOf` 的每个文本都须缺席；区分大小写，
 连续横向空白折叠为一个空格，不使用正则或终端历史。每组最多 16 项，每项
@@ -292,11 +297,24 @@ session 事件；get 也会现场核验。120 秒内未形成绑定返回 `SESSI
 服务重启后，原 pane 中精确 UUID 已在运行时 get 应回读 ready，restore 返回原
 operation/pane，不启动第二个 Agent；进程携带不同 UUID 时继续拒绝。
 
+1.4.303 起，集成 restore 排除自己的已核验终端；其他已登记终端须用当前前台
+进程证明同一个 UUID 才返回 `NATIVE_SESSION_ALREADY_RUNNING`。已退出到 shell、
+已消失或实际运行另一 UUID 的终端，其缓存/last-known 记录不算运行中所有者。
+可能持有原 UUID 的终端无法核验、或相同 Agent 正在运行但没有精确 ID 证据时，
+返回 `NATIVE_SESSION_OWNER_UNCONFIRMED` 并停止恢复；应检查该终端，不绕过保护。
+此检查覆盖服务已登记终端，不声称枚举其他应用中全部原生会话。
+
+1.4.304 起，检查合并持久终端清单和当前 PTY backend；服务重启后无需网页挂接，
+已登记 tmux 的每个 pane 都会现场核验。旧登记 UUID C 不会排除当前实际运行 UUID A
+的终端，终端的协作路由为 recovering/offline 或绑定不匹配也不会跳过检查。
+仅在确认 tmux 已消失或当前进程排除冲突时继续；未知进程、同 Agent 缺少精确 UUID、
+观察失败均返回 `NATIVE_SESSION_OWNER_UNCONFIRMED`，不以旧 UUID 证明没有冲突。
+
 常见失败码（每项都是完整字符串）：
 
 - 配置/权限：`LAUNCH_PROFILE_DENIED`, `LAUNCHER_UNAVAILABLE`, `COLLAB_AGENT_UNAVAILABLE`, `SESSION_CWD_MISSING`, `SESSION_CWD_DENIED`, `INTEGRATION_SESSION_NOT_FOUND`, `INTEGRATION_SESSION_LIMIT`。
 - 终端/身份：`SESSION_BACKEND_UNAVAILABLE`, `SESSION_TARGET_NOT_SHELL`, `SESSION_IDENTITY_MISMATCH`, `NATIVE_SESSION_ID_MISMATCH`, `NATIVE_SESSION_ID_INVALID`, `NATIVE_SESSION_ID_MISSING`。
-- 启动/恢复：`SESSION_CREATE_OUTCOME_UNKNOWN`, `SESSION_OPERATION_IN_PROGRESS`, `SESSION_BINDING_TIMEOUT`, `EXACT_RESUME_UNSUPPORTED`, `NATIVE_SESSION_ALREADY_RUNNING`, `AGENT_NOT_RUNNING`。
+- 启动/恢复：`SESSION_CREATE_OUTCOME_UNKNOWN`, `SESSION_OPERATION_IN_PROGRESS`, `SESSION_BINDING_TIMEOUT`, `EXACT_RESUME_UNSUPPORTED`, `NATIVE_SESSION_ALREADY_RUNNING`, `NATIVE_SESSION_OWNER_UNCONFIRMED`, `AGENT_NOT_RUNNING`。
 - 未分类异常：`SESSION_LAUNCH_FAILED`, `SESSION_OBSERVATION_FAILED`；错误不包含包装器输出、密钥或原始堆栈。
 
 ## 验收边界
@@ -311,8 +329,13 @@ operation/pane，不启动第二个 Agent；进程携带不同 UUID 时继续拒
 原 UUID、TD ID、attempt 和 artifact 保持一致。使用方已报告 1.4.301 冷启动首条
 仅写一次并收到明确 complete，超时保持 pending/0 次写入，策略更新保持凭据。
 维护机另外用真实 tmux/native fixture 验证插件 argv 回读、记录重载后运行中恢复
-不重复启动、不同 UUID 拒绝；**1.4.302 的真实 TraeX 服务重启回读/精确恢复
-仍须使用方升级实际运行服务后实机复验**，维护机没有代替完成该项。
+不重复启动、不同 UUID 拒绝，以及进程退出后缓存 UUID 不再阻挡恢复。使用方已报告
+1.4.302 真实 TraeX 服务重启回读、运行中恢复不重启、不同 UUID 拒绝通过；显式恢复
+原 UUID 也已回读 ready，但配置的模型 footer 条件被暂态提示替换，输入仍保持待投递。
+使用方已报告 1.4.303 退出后精确恢复通过，也发现未挂接 PTY 的已登记 tmux 重复保护
+遗漏；维护机已用“旧 UUID C、实际运行 UUID A、无 PTY 附着”的真实隔离 tmux 复现，
+并验证 1.4.304 编译后检查在该状态下拒绝再次启动。
+**1.4.304 的真实 TraeX 重复保护与稳定输入条件仍须使用方实机复验**。
 回读 capabilities 后，应核对原 TD ID、真实 TraeX UUID 与原 argv/cwd/包装器快照，
 并验证 Agent 真正加载原对话。
 先完成测试环境的创建→追问→关联答复，再验重复键、追加咨询、断线重投和精确恢复。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termdock",
-  "version": "1.4.302",
+  "version": "1.4.304",
   "description": "A complete web-based terminal application with modern UI",
   "type": "module",
   "main": ".desktop-dist/main.js",

package/runtime-manifest.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": 1,
   "packageName": "termdock",
-  "version": "1.4.302",
+  "version": "1.4.304",
   "runtimeProtocolVersion": 1,
   "minimumDesktopVersion": "1.4.46",
   "nodeMajor": 22,
   "dependencyHash": "sha256-E9GDa4nrCXADRXdyPKufusZt6IcCr4m2mGdx5h34KMQ=",
-  "serverBundleHash": "sha256-rfW/aLzCmUQ9yrcKgstqe1a3KYd/sfH9yKP5jUXWiHk=",
+  "serverBundleHash": "sha256-7LaEwk0ur5djmnXCjBBkhMPg2z5dB5dcYm7tmh14Pko=",
   "clientBundleHash": "sha256-HOoNMOYhnph9XwUhSYE5W2CdI9Vb4g0c64ubW49LnXE=",
   "entrypoint": "dist/server/cli.js",
   "clientEntrypoint": "dist/client/index.html"