termdock 1.4.43 → 1.4.46

package/dist/server/routes/terminal.js

@@ -14,7 +14,8 @@ import { getPtyHostManager } from '../ptyhost/manager.js';
 import { pathValidator } from '../utils/pathValidator.js';
 import { TERMINAL, TMUX } from '../config.js';
 import { localAccessManager } from '../utils/localAccess.js';
-import { normalizeLocalAccessName, getActivityReorderSetting, getLocaleSetting, setActivityReorderSetting, setLocaleSetting, } from '../utils/settings.js';
+import { normalizeLocalAccessName, getLocaleSetting, setLocaleSetting, getContextDraftHeightSetting, setContextDraftHeightSetting, } from '../utils/settings.js';
+import { loadContextDraft, saveContextDraft } from '../utils/contextDraft.js';
 import { getOnboardingServerUrl } from '../onboardingServer.js';
 import { getFocusSequence, removeClientFocusState, scanFocusTrackingMode, setClientFocusState, } from '../utils/tmuxFocus.js';
 import { extractProgramLabelFromArgs, normalizeProgramName, normalizeTmuxMetadataProgram, selectTmuxForegroundProgram, tmuxMetadataChanged, } from '../utils/tmuxProgramDetection.js';
@@ -23,7 +24,8 @@ import { applyAgentEvent, defaultAgentSessionState, parseAgentEvent, } from '../
 import { listAllHookAgents, refreshStaleHooksAtLaunch, installHooksForSlug, uninstallHooksForSlug, } from '../agent/installers.js';
 import { loadPlugins, savePlugin, removePlugin, readPluginIcon, } from '../agent/plugins.js';
 import { registerPluginAgents } from '../agent/registry.js';
-import { notifyAgentTransition } from '../notifications/pushService.js';
+import { notifyAgentTransition, notifyTerminalExit } from '../notifications/pushService.js';
+import { setClientViewingSession } from '../notifications/pushViewers.js';
 import { getQuotaStatus, refreshQuota, startQuotaManager, } from '../quota/QuotaManager.js';
 const router = express.Router();
 const execFileAsync = promisify(execFile);
@@ -106,81 +108,6 @@ let lastBroadcastClientStateSignature = null;
 const inventoryOpenLocks = new Map();
 const CONTROL_BROADCAST_COALESCE_MS = 50;
 const SESSION_INVENTORY_CACHE_TTL_MS = 1500;
-// 最近活跃优先排序：不是竞速榜，只分「最近活跃」和「非活跃」两组。
-// 活跃组整体在前，组内保持当前相对顺序，避免两个持续输出的 session
-// 按毫秒级 lastActivity 来回抢第一个位置。
-const RECENT_ACTIVITY_WINDOW_MS = 60_000;
-const ACTIVITY_REORDER_COOLDOWN_MS = 5_000;
-const ACTIVITY_REORDER_PERIODIC_MS = 30_000;
-let activityReorderTimer = null;
-let activityReorderPeriodicTimer = null;
-let activityReorderEnabled = getActivityReorderSetting();
-function getEffectiveLastActivity(session) {
-    // 只用 PTY 输出时间判断「最近活跃」——resize / input / connect
-    // 不参与排序，避免拖窗口尺寸等非输出操作导致 session 跳到前面。
-    if (session.backendSessionId) {
-        const backend = terminalSessions.get(session.backendSessionId);
-        if (backend)
-            return backend.lastOutputAt;
-    }
-    return session.lastActivity;
-}
-function applyActivityBasedReorder() {
-    if (!activityReorderEnabled)
-        return;
-    const sessions = globalSessionState.sessions;
-    if (sessions.length <= 1)
-        return;
-    const now = Date.now();
-    const recentlyActive = [];
-    const inactive = [];
-    for (const session of sessions) {
-        const la = getEffectiveLastActivity(session);
-        if (now - la <= RECENT_ACTIVITY_WINDOW_MS) {
-            recentlyActive.push(session);
-        }
-        else {
-            inactive.push(session);
-        }
-    }
-    // 两个 bucket 内各自保持原有相对顺序，只是活跃组整体提前
-    const reordered = [...recentlyActive, ...inactive];
-    const orderChanged = sessions.map(s => s.sessionId).join('\x00') !== reordered.map(s => s.sessionId).join('\x00');
-    if (!orderChanged)
-        return;
-    globalSessionState = {
-        sessions: reordered,
-        updatedAt: Date.now(),
-    };
-    persistAndBroadcastGlobalState();
-}
-function scheduleActivityReorder() {
-    if (activityReorderTimer)
-        return;
-    activityReorderTimer = setTimeout(() => {
-        activityReorderTimer = null;
-        applyActivityBasedReorder();
-    }, ACTIVITY_REORDER_COOLDOWN_MS);
-    activityReorderTimer.unref?.();
-}
-function startActivityReorderPeriodic() {
-    if (activityReorderPeriodicTimer)
-        return;
-    activityReorderPeriodicTimer = setInterval(() => {
-        applyActivityBasedReorder();
-    }, ACTIVITY_REORDER_PERIODIC_MS);
-    activityReorderPeriodicTimer.unref?.();
-}
-function stopActivityReorderPeriodic() {
-    if (activityReorderPeriodicTimer) {
-        clearInterval(activityReorderPeriodicTimer);
-        activityReorderPeriodicTimer = null;
-    }
-    if (activityReorderTimer) {
-        clearTimeout(activityReorderTimer);
-        activityReorderTimer = null;
-    }
-}
 async function getSessionInventorySnapshot(options = {}) {
     const now = Date.now();
     if (!options.refresh && latestSessionInventory && now - latestSessionInventoryAt < SESSION_INVENTORY_CACHE_TTL_MS) {
@@ -462,8 +389,8 @@ function flushPersistAndExit() {
     }
     catch { /* best effort */ }
 }
-process.on('SIGTERM', () => { stopActivityReorderPeriodic(); flushPersistAndExit(); void persistToolbarPresetsNow(); caffeinateManager.shutdown(); process.exit(0); });
-process.on('SIGINT', () => { stopActivityReorderPeriodic(); flushPersistAndExit(); void persistToolbarPresetsNow(); caffeinateManager.shutdown(); process.exit(0); });
+process.on('SIGTERM', () => { flushPersistAndExit(); void persistToolbarPresetsNow(); caffeinateManager.shutdown(); process.exit(0); });
+process.on('SIGINT', () => { flushPersistAndExit(); void persistToolbarPresetsNow(); caffeinateManager.shutdown(); process.exit(0); });
 // 服务启动时从磁盘加载（带去重，防止历史累积的重复条目复活）
 void (async () => {
     await loadGlobalSessionStateFromDisk();
@@ -476,8 +403,6 @@ void (async () => {
     });
     pruneOrphanSessions();
     await backfillPersistedTmuxMetadata();
-    startActivityReorderPeriodic();
-    applyActivityBasedReorder();
 })();
 caffeinateManager.startNetworkMonitor();
 // 清理磁盘恢复后后端已不存在的 session 引用。
@@ -2777,10 +2702,26 @@ async function enableTmuxFocusEvents() {
     await runTmux(['set-option', '-g', 'focus-events', 'on']);
     console.log('[tmux-focus] enabled global focus-events');
 }
+// Let tmux forward modified Enter keys (Ctrl/Shift/Alt+Enter) to pane apps.
+// The option only exists in tmux >= 3.2; on older versions the probe fails
+// and we silently skip.
+async function enableTmuxExtendedKeys() {
+    try {
+        const current = (await runTmux(['show-options', '-gqv', 'extended-keys'])).trim();
+        if (current === 'on')
+            return;
+        await runTmux(['set-option', '-g', 'extended-keys', 'on']);
+        console.log('[tmux] enabled global extended-keys');
+    }
+    catch {
+        // extended-keys unsupported on this tmux; nothing to do
+    }
+}
 async function ensureSharedTmuxServerReady() {
     await ensureTmuxColorEnvironment();
     await applyTmuxScrollbackProfile();
     await enableTmuxFocusEvents();
+    await enableTmuxExtendedKeys();
     await configureTmuxWheelBindings();
 }
 async function stampTmuxMetadata(sessionName) {
@@ -3310,7 +3251,6 @@ function processSessionOutput(sessionId, session, data, opts) {
         session.lastActivity = Date.now();
         session.lastOutputAt = Date.now();
         session.hasWrittenData = true;
-        scheduleActivityReorder();
     }
     let seq;
     if (session.mode === 'shell') {
@@ -3384,6 +3324,17 @@ function setupPtyHandlers(sessionId, session) {
     session.exitDisposable = session.ptyProcess.onExit(({ exitCode, signal }) => {
         console.log(`Terminal session ${sessionId} exited with code ${exitCode}, signal ${signal}`);
         broadcastEvent(sessionId, { type: 'exit', exitCode, signal });
+        // User-initiated closes dispose this listener before killing the pty, so
+        // reaching here means the process exited on its own. Sessions with a live
+        // agent already get their exit covered by notifyAgentTransition — skip
+        // those to avoid two notifications for one event.
+        const snapshot = lastAgentStatusSnapshots.get(sessionId);
+        const hasLiveAgent = snapshot
+            ? JSON.parse(snapshot).agentStatus !== null
+            : false;
+        if (!hasLiveAgent) {
+            notifyTerminalExit(sessionId, typeof exitCode === 'number' ? exitCode : null);
+        }
         cleanupSession(sessionId, { killProcess: false });
     });
 }
@@ -3982,7 +3933,6 @@ router.get('/client-state', async (_req, res) => {
 });
 router.get('/session-inventory', async (_req, res) => {
     try {
-        applyActivityBasedReorder();
         const inventory = await getSessionInventorySnapshot();
         res.json(inventory);
     }
@@ -4153,6 +4103,7 @@ async function getSettingsPayload() {
         caffeinateActive: caffeinateManager.isActive(),
         networkAvailable: caffeinateManager.isNetworkAvailable(),
         locale: getLocaleSetting(),
+        contextDraftHeight: getContextDraftHeightSetting(),
         localAccess: {
             ...localAccess,
             interfaces,
@@ -4160,29 +4111,6 @@ async function getSettingsPayload() {
         },
     };
 }
-// ── Activity reorder preference ──────────────────────────────────────
-router.get('/settings/activity-reorder', (_req, res) => {
-    res.json({ enabled: activityReorderEnabled });
-});
-router.put('/settings/activity-reorder', (req, res) => {
-    const body = req.body ?? {};
-    if (typeof body.enabled === 'boolean') {
-        setActivityReorderSetting(body.enabled);
-        activityReorderEnabled = body.enabled;
-        // 关闭后立刻停掉还在队列里的 reorder timer
-        if (!activityReorderEnabled && activityReorderTimer) {
-            clearTimeout(activityReorderTimer);
-            activityReorderTimer = null;
-        }
-        // 如果重新开启,立刻执行一次排序
-        if (activityReorderEnabled) {
-            applyActivityBasedReorder();
-        }
-        res.json({ enabled: activityReorderEnabled });
-        return;
-    }
-    res.status(400).json({ error: '"enabled" must be a boolean' });
-});
 // ── Settings (prevent sleep) ──────────────────────────────────────────
 router.get('/settings', async (_req, res) => {
     res.json(await getSettingsPayload());
@@ -4195,6 +4123,18 @@ router.put('/settings', async (req, res) => {
     if (typeof body.locale === 'string' && (body.locale === 'zh' || body.locale === 'en')) {
         setLocaleSetting(body.locale);
     }
+    if (body.contextDraftHeight && typeof body.contextDraftHeight === 'object') {
+        const heightBody = body.contextDraftHeight;
+        for (const device of ['mobile', 'desktop']) {
+            const value = heightBody[device];
+            if (value === null) {
+                setContextDraftHeightSetting(device, null);
+            }
+            else if (typeof value === 'number' && Number.isFinite(value) && value >= 56 && value <= 4000) {
+                setContextDraftHeightSetting(device, Math.round(value));
+            }
+        }
+    }
     if (body.localAccess && typeof body.localAccess === 'object') {
         const localAccessBody = body.localAccess;
         if (localAccessBody.reset === true) {
@@ -4215,6 +4155,27 @@ router.put('/settings', async (req, res) => {
     }
     res.json(await getSettingsPayload());
 });
+// ── Context draft (cross-device realtime sync) ────────────────────────
+// 草稿内容存服务端（~/.termdock/context-draft.json），PUT 后通过 control
+// WebSocket 广播给其它客户端；携带 origin 让发送方忽略自己的回声。
+router.get('/context-draft', (_req, res) => {
+    res.json(loadContextDraft());
+});
+router.put('/context-draft', (req, res) => {
+    const body = req.body ?? {};
+    if (typeof body.text !== 'string') {
+        res.status(400).json({ error: 'Invalid draft text', code: 'INVALID_CONTEXT_DRAFT' });
+        return;
+    }
+    const doc = saveContextDraft(body.text);
+    broadcastControlEvent({
+        type: 'context-draft',
+        text: doc.text,
+        updatedAt: doc.updatedAt,
+        origin: typeof body.origin === 'string' ? body.origin : null,
+    });
+    res.json(doc);
+});
 // ── Agent hooks API (rich status channel installers, built-in + plugin) ──
 router.get('/agent-hooks', (_req, res) => {
     res.json({ agents: listAllHookAgents() });
@@ -5355,6 +5316,18 @@ export function handleTerminalWebSocket(ws, sessionId, clientId, options = {}) {
                     updateClientFocusState(sessionId, session, clientId, focused, reason);
                     break;
                 }
+                case 'viewing': {
+                    // Push suppression: while this client is actively viewing the
+                    // session, its agent-transition push is redundant — skip it.
+                    // Kept separate from 'focus' (which requires textarea focus for
+                    // tmux focus tracking): on mobile the keyboard is routinely
+                    // dismissed while the user is still watching the session.
+                    if (options.pushClientId) {
+                        const viewing = msg.viewing === true;
+                        setClientViewingSession(options.pushClientId, sessionId, viewing);
+                    }
+                    break;
+                }
                 case 'flow-control': {
                     if (typeof msg.paused === 'boolean') {
                         const reason = typeof msg.reason === 'string' ? msg.reason : 'client-flow-control';
@@ -5404,6 +5377,9 @@ export function handleTerminalWebSocket(ws, sessionId, clientId, options = {}) {
             }
         }
         removeClientFocus(sessionId, session, clientId);
+        if (options.pushClientId) {
+            setClientViewingSession(options.pushClientId, sessionId, false);
+        }
         removeClientFlowPaused(sessionId, session, clientId, 'client-disconnect');
         syncClientCountToTmux(sessionId);
         broadcastClientState();

package/dist/server/utils/contextDraft.js

@@ -0,0 +1,36 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+const DRAFT_DIR = path.join(os.homedir(), '.termdock');
+const DRAFT_FILE = path.join(DRAFT_DIR, 'context-draft.json');
+// 草稿是纯文本提示词，200k 上限足够宽裕，也避免异常请求写爆磁盘
+export const CONTEXT_DRAFT_MAX_LENGTH = 200_000;
+function normalizeDraft(value) {
+    const raw = value && typeof value === 'object'
+        ? value
+        : {};
+    return {
+        text: typeof raw.text === 'string' ? raw.text.slice(0, CONTEXT_DRAFT_MAX_LENGTH) : '',
+        updatedAt: typeof raw.updatedAt === 'number' ? raw.updatedAt : 0,
+    };
+}
+export function loadContextDraft() {
+    try {
+        const raw = fs.readFileSync(DRAFT_FILE, 'utf-8');
+        return normalizeDraft(JSON.parse(raw));
+    }
+    catch { /* ignore missing/malformed draft */ }
+    return { text: '', updatedAt: 0 };
+}
+export function saveContextDraft(text) {
+    const doc = {
+        text: text.slice(0, CONTEXT_DRAFT_MAX_LENGTH),
+        updatedAt: Date.now(),
+    };
+    try {
+        fs.mkdirSync(DRAFT_DIR, { recursive: true });
+        fs.writeFileSync(DRAFT_FILE, JSON.stringify(doc), 'utf-8');
+    }
+    catch { /* best effort */ }
+    return doc;
+}

package/dist/server/utils/requestDeadline.js

@@ -0,0 +1,104 @@
+import { writeErrorLog } from './serverLogger.js';
+/**
+ * 全局请求兜底超时（系统性保险丝）。
+ *
+ * 背景：浏览器对同源 HTTP/1.1 只有 6 条并发连接。任何一个 handler 挂起
+ * （忘了加超时、外部依赖 wedge、客户端半开连接），就永久占住一条；占满后
+ * 所有后续请求在浏览器侧排队，用户看到"整个服务 io 全部超时"，只能重启。
+ *
+ * 这个中间件保证：无论 handler 自己是否记得加超时，每个进入 Express 的
+ * 请求都有死亡上界。到期后销毁 socket，浏览器立即释放连接槽，其余请求
+ * 照常进行。显式的长连接端点（watch NDJSON 流、终端 SSE）按表豁免，
+ * 慢但合法的端点（搜索、大文件下载）给更长档位；路由也可以通过
+ * `res.locals.requestDeadlineMs` 自行调档。
+ */
+const DEFAULT_DEADLINE_MS = 30_000;
+const DEADLINE_RULES = [
+    // 无限流：文件监听 NDJSON、终端 SSE。
+    { method: 'GET', pattern: /^\/api\/terminal\/fs\/watch$/, deadlineMs: null },
+    { method: 'GET', pattern: /^\/api\/terminal\/[^/]+\/stream$/, deadlineMs: null },
+    // 有限但可能很久：大目录搜索（有 done 事件的进度流）、大文件下载。
+    { method: 'GET', pattern: /^\/api\/terminal\/fs\/search$/, deadlineMs: 120_000 },
+    { method: 'GET', pattern: /^\/api\/terminal\/fs\/download$/, deadlineMs: 300_000 },
+    // 上传最多 100MB×50 文件，弱网下接收请求体可能要几分钟。注意 Node 内置
+    // requestTimeout（默认 300s，本项目未改）管「请求体接收」阶段并在超时后
+    // 回 408，所以这里必须低于 300s——让我们的 503+日志先出手，而不是被
+    // Node 的裸 408 抢先。
+    { method: 'POST', pattern: /^\/api\/terminal\/fs\/upload$/, deadlineMs: 280_000 },
+    // 会话打开/创建/重启内部串了多段 tmux 命令（各有 5s 超时），tmux 退化时
+    // 合法完成也可能要 20-40s——给 60s，超过才算真挂起。
+    { method: 'POST', pattern: /^\/api\/terminal\/session-inventory\/open$/, deadlineMs: 60_000 },
+    { method: 'POST', pattern: /^\/api\/terminal\/create$/, deadlineMs: 60_000 },
+    { method: 'POST', pattern: /^\/api\/terminal\/[^/]+\/restart$/, deadlineMs: 60_000 },
+];
+function resolveDeadlineMs(method, pathname) {
+    for (const rule of DEADLINE_RULES) {
+        if (rule.method && rule.method !== method)
+            continue;
+        if (rule.pattern.test(pathname))
+            return rule.deadlineMs;
+    }
+    return DEFAULT_DEADLINE_MS;
+}
+export function requestDeadlineMiddleware(options = {}) {
+    const defaultDeadlineMs = options.defaultDeadlineMs ?? DEFAULT_DEADLINE_MS;
+    return (req, res, next) => {
+        let pathname;
+        try {
+            pathname = new URL(req.originalUrl || req.url, 'http://localhost').pathname;
+        }
+        catch {
+            pathname = req.path || req.url || '';
+        }
+        const ruleDeadline = resolveDeadlineMs(req.method, pathname);
+        const effectiveDeadline = ruleDeadline === DEFAULT_DEADLINE_MS ? defaultDeadlineMs : ruleDeadline;
+        if (effectiveDeadline === null) {
+            next();
+            return;
+        }
+        const startedAt = Date.now();
+        let timer = null;
+        const clear = () => {
+            if (timer) {
+                clearTimeout(timer);
+                timer = null;
+            }
+        };
+        const onFire = () => {
+            const elapsed = Date.now() - startedAt;
+            // 路由在 handler 里调过档：按新档位重新计时（null = 豁免）。
+            const override = res.locals.requestDeadlineMs;
+            if (override === null) {
+                clear();
+                return;
+            }
+            if (typeof override === 'number' && override > elapsed) {
+                timer = setTimeout(onFire, override - elapsed);
+                return;
+            }
+            console.warn(`[request-deadline] ${req.method} ${pathname} exceeded ${elapsed}ms — aborting request`);
+            writeErrorLog({
+                source: 'request-deadline',
+                method: req.method,
+                path: pathname,
+                durationMs: elapsed,
+                clientId: req.clientId,
+            });
+            if (!res.headersSent) {
+                // 未发头：socket 是健康的，干净地回 503 即可，连接还能继续复用。
+                res.status(503).json({
+                    error: 'Request took too long and was aborted by the server. Please retry.',
+                    code: 'REQUEST_DEADLINE',
+                });
+                return;
+            }
+            // 已发头但流卡死（含客户端消失的半开连接）：无法写出合法响应，
+            // 销毁底层 socket，浏览器立即释放该连接槽。
+            req.socket.destroy();
+        };
+        timer = setTimeout(onFire, effectiveDeadline);
+        res.on('finish', clear);
+        res.on('close', clear);
+        next();
+    };
+}

package/dist/server/utils/runtimeClient.js

@@ -0,0 +1,41 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+function readManifest(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function resolveRuntimeClientDist(defaultClientDist, homeDir = os.homedir()) {
+    try {
+        const defaultPackageRoot = path.resolve(defaultClientDist, '..', '..');
+        const runningManifest = readManifest(path.join(defaultPackageRoot, 'runtime-manifest.json'));
+        if (runningManifest?.schemaVersion !== 1
+            || typeof runningManifest.serverBundleHash !== 'string') {
+            return defaultClientDist;
+        }
+        const runtimeRoot = path.join(homeDir, '.termdock', 'desktop-runtime');
+        const versionsRoot = fs.realpathSync(path.join(runtimeRoot, 'versions'));
+        const selectedVersionRoot = fs.realpathSync(path.join(runtimeRoot, 'client-current'));
+        const relative = path.relative(versionsRoot, selectedVersionRoot);
+        if (!relative || relative.startsWith('..') || path.isAbsolute(relative))
+            return defaultClientDist;
+        const selectedPackageRoot = path.join(selectedVersionRoot, 'package');
+        const selectedManifest = readManifest(path.join(selectedPackageRoot, 'runtime-manifest.json'));
+        if (selectedManifest?.schemaVersion !== 1
+            || selectedManifest.serverBundleHash !== runningManifest.serverBundleHash
+            || selectedManifest.clientEntrypoint !== 'dist/client/index.html') {
+            return defaultClientDist;
+        }
+        const selectedClientDist = path.join(selectedPackageRoot, 'dist', 'client');
+        if (!fs.existsSync(path.join(selectedClientDist, 'index.html')))
+            return defaultClientDist;
+        return selectedClientDist;
+    }
+    catch {
+        return defaultClientDist;
+    }
+}

package/dist/server/utils/settings.js

@@ -44,6 +44,15 @@ function normalizeLocalAccessSettings(value) {
         source: normalizedName ? source : 'auto',
     };
 }
+function normalizeContextDraftHeight(value) {
+    const raw = value && typeof value === 'object'
+        ? value
+        : {};
+    const normalizeOne = (input) => typeof input === 'number' && Number.isFinite(input) && input >= 56 && input <= 4000
+        ? Math.round(input)
+        : null;
+    return { mobile: normalizeOne(raw.mobile), desktop: normalizeOne(raw.desktop) };
+}
 function normalizeSettings(value) {
     const raw = value && typeof value === 'object'
         ? value
@@ -51,10 +60,10 @@ function normalizeSettings(value) {
     return {
         version: 1,
         preventSleep: raw.preventSleep === true,
-        activityReorderEnabled: raw.activityReorderEnabled !== false,
         localAccess: normalizeLocalAccessSettings(raw.localAccess),
         firstRunCompleted: raw.firstRunCompleted === true,
         locale: typeof raw.locale === 'string' && raw.locale === 'zh' ? 'zh' : 'en',
+        contextDraftHeight: normalizeContextDraftHeight(raw.contextDraftHeight),
         updatedAt: typeof raw.updatedAt === 'number' ? raw.updatedAt : Date.now(),
     };
 }
@@ -128,14 +137,6 @@ export async function setPreventSleepSettingAsync(enabled) {
         settings.preventSleep = enabled;
     });
 }
-export function getActivityReorderSetting() {
-    return loadSettings().activityReorderEnabled;
-}
-export function setActivityReorderSetting(enabled) {
-    return updateSettings((settings) => {
-        settings.activityReorderEnabled = enabled;
-    });
-}
 export function getLocalAccessSetting() {
     return loadSettings().localAccess;
 }
@@ -173,3 +174,11 @@ export function setLocaleSetting(locale) {
         settings.locale = locale;
     });
 }
+export function getContextDraftHeightSetting() {
+    return loadSettings().contextDraftHeight;
+}
+export function setContextDraftHeightSetting(device, height) {
+    return updateSettings((settings) => {
+        settings.contextDraftHeight[device] = height;
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termdock",
-  "version": "1.4.43",
+  "version": "1.4.46",
   "description": "A complete web-based terminal application with modern UI",
   "type": "module",
   "main": ".desktop-dist/main.js",
@@ -13,6 +13,7 @@
   },
   "files": [
     "dist",
+    "runtime-manifest.json",
     "README.md",
     "LICENSE",
     "scripts"
@@ -22,19 +23,21 @@
     "dev": "concurrently \"npm run dev:client\" \"npm run dev:server\"",
     "dev:client": "vite",
     "dev:server": "cross-env PORT=9835 tsx watch src/server/entry.ts",
-    "build": "npm run clean && npm run build:client && npm run build:server",
+    "build": "npm run clean && npm run build:client && npm run build:server && npm run build:runtime-manifest",
     "build:desktop": "node scripts/prepare-desktop-tokens.mjs && tsc -p tsconfig.desktop.json",
     "desktop:dev": "npm run build && npm run build:desktop && electron-forge start",
     "desktop:prepare": "npm run build && npm run build:desktop && node scripts/prepare-desktop-runtime.mjs",
     "desktop:make": "npm run desktop:prepare && electron-forge make",
     "build:client": "vite build",
     "build:server": "tsc -p tsconfig.server.json && node -e \"require('fs').chmodSync('dist/server/cli.js', 0o755)\"",
+    "build:runtime-manifest": "node scripts/generate-runtime-manifest.mjs",
     "generate:pwa-assets": "pwa-assets-generator --config pwa-assets.config.ts",
     "preview": "vite preview",
     "start": "node dist/server/cli.js",
     "lint": "tsc --noEmit",
     "trace:diff": "node scripts/inspect-diff-trace.mjs",
     "trace:fsio": "node scripts/inspect-fs-io.mjs",
+    "release:classify": "node scripts/classify-release.mjs",
     "test": "vitest --passWithNoTests",
     "test:ui": "vitest --ui",
     "prepublishOnly": "npm run build",

package/runtime-manifest.json

@@ -0,0 +1,12 @@
+{
+  "schemaVersion": 1,
+  "packageName": "termdock",
+  "version": "1.4.46",
+  "runtimeProtocolVersion": 1,
+  "minimumDesktopVersion": "1.4.46",
+  "nodeMajor": 22,
+  "dependencyHash": "sha256-aUokhQIdbogiFjsYarTRvcQ40Rva3j5CIot/0H1Lyl4=",
+  "serverBundleHash": "sha256-+mlh3Ar6V1IOLEJ5l39G2XsUQ+TOgtvmKInjzinHPsA=",
+  "entrypoint": "dist/server/cli.js",
+  "clientEntrypoint": "dist/client/index.html"
+}

package/scripts/classify-release.mjs

@@ -0,0 +1,88 @@
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+
+function git(args) {
+  return execFileSync('git', args, { cwd: root, encoding: 'utf8' }).trim();
+}
+
+function stable(value) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return value;
+  return Object.fromEntries(Object.keys(value).sort().map((key) => [key, stable(value[key])]));
+}
+
+function latestDesktopTag() {
+  return git(['tag', '--merged', 'HEAD', '--list', 'v*', '--sort=-version:refname'])
+    .split('\n')
+    .find(Boolean);
+}
+
+const requestedBase = process.argv.slice(2).find((argument) => !argument.startsWith('--'));
+const base = requestedBase || latestDesktopTag();
+if (!base) {
+  throw new Error('No desktop release tag found. Fetch tags or pass a base ref explicitly.');
+}
+
+const changedFiles = git(['diff', '--name-only', base, '--'])
+  .split('\n')
+  .map((file) => file.trim())
+  .filter(Boolean);
+const currentPackage = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));
+const basePackage = JSON.parse(git(['show', `${base}:package.json`]));
+const dependencyChanged = JSON.stringify(stable({
+  dependencies: currentPackage.dependencies ?? {},
+  engines: currentPackage.engines ?? {},
+})) !== JSON.stringify(stable({
+  dependencies: basePackage.dependencies ?? {},
+  engines: basePackage.engines ?? {},
+}));
+
+const desktopPatterns = [
+  /^desktop\//,
+  /^forge\.config\.cjs$/,
+  /^tsconfig\.desktop\.json$/,
+  /^scripts\/prepare-desktop-runtime\.mjs$/,
+  /^scripts\/prepare-desktop-tokens\.mjs$/,
+  /^\.github\/workflows\/release-macos\.yml$/,
+];
+const runtimePatterns = [
+  /^src\//,
+  /^public\//,
+  /^index\.html$/,
+  /^vite\.config\.ts$/,
+  /^tailwind\.config\.js$/,
+  /^postcss\.config\.js$/,
+  /^package(?:-lock)?\.json$/,
+  /^scripts\/generate-runtime-manifest\.mjs$/,
+];
+const testFile = /(?:^|\/)\w[^/]*\.test\.[cm]?[jt]sx?$/;
+const noReleaseFile = /^(?:docs\/|README|LICENSE|AGENTS|\.gitignore$|scripts\/classify-release\.mjs$)/;
+const desktopFiles = changedFiles.filter((file) =>
+  !testFile.test(file) && desktopPatterns.some((pattern) => pattern.test(file)));
+const runtimeFiles = changedFiles.filter((file) =>
+  !testFile.test(file) && runtimePatterns.some((pattern) => pattern.test(file)));
+const codeFiles = changedFiles.filter((file) => !noReleaseFile.test(file) && !testFile.test(file));
+const classified = new Set([...desktopFiles, ...runtimeFiles]);
+const unknownCodeFiles = codeFiles.filter((file) => !classified.has(file));
+const requiresDesktop = dependencyChanged || desktopFiles.length > 0 || unknownCodeFiles.length > 0;
+const requiresRuntime = runtimeFiles.length > 0 || requiresDesktop;
+const result = {
+  base,
+  requiresRuntime,
+  requiresDesktop,
+  dependencyChanged,
+  desktopFiles,
+  runtimeFiles,
+  unknownCodeFiles,
+};
+
+console.log(JSON.stringify(result, null, 2));
+if (process.argv.includes('--github-output') && process.env.GITHUB_OUTPUT) {
+  fs.appendFileSync(
+    process.env.GITHUB_OUTPUT,
+    `requires_runtime=${requiresRuntime}\nrequires_desktop=${requiresDesktop}\n`,
+  );
+}