termdock 1.4.4 → 1.4.6

package/dist/server/cli.js

@@ -147,10 +147,22 @@ Options:
                      Print one hunk's diff/context by Termdock hunk ID.
   --change-audit-explain <id> [cwd]
                      Read a natural-language explanation from stdin and inject
-                     it for the specified Termdock hunk ID.
+                      it for the specified Termdock hunk ID.
+  --plugin-init      Print the agent plugin manifest schema reference
+  --plugin-create <file>
+                     Create a plugin from a manifest JSON file
+  --plugin-list      List installed agent plugins
+  --plugin-remove <slug>
+                     Remove an installed agent plugin
   -h, --help         Show this help message
 
 Short commands:
+  pi                 Same as --plugin-init
+  plugin-create <file>
+                     Same as --plugin-create <file>
+  plugin-list        Same as --plugin-list
+  plugin-remove <slug>
+                     Same as --plugin-remove <slug>
   s                  Same as --status
   st                 Same as --status
   x                  Same as --stop
@@ -466,6 +478,10 @@ function parseArgs(argv) {
     let changeAuditList;
     let changeAuditShow;
     let injectChangeAuditHunk;
+    let pluginInit = false;
+    let pluginCreate;
+    let pluginList = false;
+    let pluginRemove;
     // Short command aliases for the common path. Keep these positional-only so
     // long-form flags remain the single source of truth for option semantics.
     if (argv[0] && !argv[0].startsWith('-')) {
@@ -561,6 +577,34 @@ function parseArgs(argv) {
                 injectChangeAuditHunk = { id: next, cwd };
             argv = argv.slice(cwd ? 3 : 2);
         }
+        else if (command === 'pi' || command === 'plugin-init') {
+            pluginInit = true;
+            argv = argv.slice(1);
+        }
+        else if (command === 'pcreate' || command === 'plugin-create') {
+            if (next && !next.startsWith('-')) {
+                pluginCreate = next;
+                argv = argv.slice(2);
+            }
+            else {
+                pluginCreate = undefined;
+                argv = argv.slice(1);
+            }
+        }
+        else if (command === 'pinfo' || command === 'plugin-list') {
+            pluginList = true;
+            argv = argv.slice(1);
+        }
+        else if (command === 'premove' || command === 'plugin-remove') {
+            if (next && !next.startsWith('-')) {
+                pluginRemove = next;
+                argv = argv.slice(2);
+            }
+            else {
+                pluginRemove = undefined;
+                argv = argv.slice(1);
+            }
+        }
     }
     for (let index = 0; index < argv.length; index += 1) {
         const arg = argv[index];
@@ -737,6 +781,36 @@ function parseArgs(argv) {
             index += cwd ? 2 : 1;
             continue;
         }
+        if (arg === '--plugin-init') {
+            pluginInit = true;
+            continue;
+        }
+        if (arg === '--plugin-create') {
+            const next = argv[index + 1];
+            if (next && !next.startsWith('-')) {
+                pluginCreate = next;
+                index += 1;
+            }
+            else {
+                pluginCreate = undefined;
+            }
+            continue;
+        }
+        if (arg === '--plugin-list') {
+            pluginList = true;
+            continue;
+        }
+        if (arg === '--plugin-remove') {
+            const next = argv[index + 1];
+            if (next && !next.startsWith('-')) {
+                pluginRemove = next;
+                index += 1;
+            }
+            else {
+                pluginRemove = undefined;
+            }
+            continue;
+        }
         if (!arg.startsWith('-')) {
             if (attachTmux && !attachTmuxName) {
                 attachTmuxName = arg;
@@ -778,6 +852,10 @@ function parseArgs(argv) {
         changeAuditList,
         changeAuditShow,
         injectChangeAuditHunk,
+        pluginInit,
+        pluginCreate,
+        pluginList,
+        pluginRemove,
     };
 }
 // Reads a single line from stdin without echoing keystrokes. Used for password
@@ -936,6 +1014,32 @@ async function postLocalJson(baseUrl, token, endpoint, payload) {
         req.end();
     });
 }
+async function getLocalJson(baseUrl, token, endpoint) {
+    const url = new URL(endpoint, baseUrl);
+    const isHttps = url.protocol === 'https:';
+    const requestImpl = isHttps ? https.request : http.request;
+    const ca = isHttps && fs.existsSync(defaultHttpsCaPath) ? fs.readFileSync(defaultHttpsCaPath) : undefined;
+    return new Promise((resolve, reject) => {
+        const req = requestImpl({
+            protocol: url.protocol,
+            hostname: url.hostname,
+            port: url.port,
+            path: `${url.pathname}${url.search}`,
+            method: 'GET',
+            ca,
+            headers: {
+                'X-Termdock-Local-Token': token,
+            },
+        }, (res) => {
+            let responseBody = '';
+            res.setEncoding('utf8');
+            res.on('data', (chunk) => { responseBody += chunk; });
+            res.on('end', () => resolve({ statusCode: res.statusCode ?? 0, body: responseBody }));
+        });
+        req.on('error', reject);
+        req.end();
+    });
+}
 async function runInjectChangeAudit(source) {
     const raw = source === true
         ? await readStdinText()
@@ -1476,6 +1580,225 @@ async function runInjectChangeAuditHunk(request) {
     };
     await postChangeAuditPayload(payload);
 }
+// ── Agent plugin CLI commands ──
+function resolveServerBaseUrl(state) {
+    return state.localUrl ?? `${state.scheme ?? 'http'}://${state.host === '0.0.0.0' ? 'localhost' : state.host}:${state.port}`;
+}
+function requireRunningServer() {
+    const state = getRunningState();
+    if (!state) {
+        console.error(`${ICON.err} ${c.red('Termdock is not running. Start it first: td')}`);
+        process.exit(1);
+    }
+    const token = state.localApiToken;
+    if (!token) {
+        console.error(`${ICON.err} ${c.red('Running server has no local API token. Restart Termdock first.')}`);
+        process.exit(1);
+    }
+    return { baseUrl: resolveServerBaseUrl(state), token };
+}
+function runPluginInit() {
+    console.log(`\
+${c.bold('Agent Plugin Reference')}
+${c.dim('─────────────────────')}
+
+A plugin is a directory under ${c.cyan('~/.termdock/agent-plugins/<slug>/')} containing:
+
+  ${c.cyan('manifest.json')}    required – agent identity, hooks, and resume config
+  ${c.cyan('icon.svg')}         optional – brand icon (rendered as mask silhouette or native)
+
+${c.bold('manifest.json schema')}
+${c.dim('───────────────────')}
+
+{
+  ${c.dim('// Manifest version. Must be')} ${c.green('1')}${c.dim('.')}
+  "version": 1,
+
+  ${c.dim('// Unique slug (lowercase alphanum + hyphens, max 40 chars).')}
+  ${c.dim('// Must not collide with built-in agent slugs.')}
+  "slug": "trae",
+
+  ${c.dim('// Human-readable label shown in tabs and settings.')}
+  "displayName": "Trae Agent",
+
+  ${c.dim('// Command names that identify this agent at runtime.')}
+  ${c.dim('// First alias is the primary binary name; extras match npm/pip wrappers.')}
+  "aliases": ["trae", "traecli"],
+
+  ${c.dim('// Brand accent color as 6-digit hex. Used for avatar background in mask mode,')}
+  ${c.dim('// and as the status-dot color. Must be Flexoki-family or brand theme-safe.')}
+  "accentColor": "#4385BE",
+
+  ${c.dim('// ── optional ──')}
+  ${c.dim('// Icon rendering mode (default "mask"):')}
+  ${c.dim('//   "mask"   - SVG is a white-on-accent silhouette (CSS mask). Mono-color.')}
+  ${c.dim('//   "native" - SVG rendered directly, preserving original fills/gradients.')}
+  "iconMode": "native",
+
+  ${c.dim('// ── optional: hook installation (bring your own hooks.json surface) ──')}
+  "hooks": {
+    ${c.dim("// Path to the agent's hooks config file (~-abbreviated).")}
+    ${c.dim('// termdock inserts marker-carrying entries; leaves user entries untouched.')}
+    "target": "~/.trae/settings.json",
+
+    ${c.dim('// Event mappings: agent-native hook name → termdock sentinel event.')}
+    ${c.dim('// Optional matcher narrows the subscription (e.g. permission type).')}
+    "events": [
+      { "hook": "SessionStart",       "event": "session-start" },
+      { "hook": "UserPromptSubmit",   "event": "prompt-submit" },
+      { "hook": "Notification",       "event": "notification", "matcher": "elicitation_dialog" },
+      { "hook": "PostToolUse",        "event": "tool-complete" },
+      { "hook": "Stop",               "event": "stop" },
+      { "hook": "SessionEnd",         "event": "session-end" }
+    ]
+  },
+
+  ${c.dim('// ── optional: resume command (for session picker re-entry) ──')}
+  "resume": {
+    ${c.dim('// Shell command template. {sessionId} is replaced with the native session id.')}
+    "command": "trae --resume {sessionId}",
+    ${c.dim('// Flags to strip from the original launch argv when replaying the resume.')}
+    "staleFlags": ["--resume", "-r", "--session-id", "--continue"]
+  }
+}
+
+${c.bold('Sentinel event kinds')}
+${c.dim('─────────────────────')}
+
+  session-start           Agent session opened (binary started / first prompt)
+  prompt-submit           A new prompt/turn was submitted
+  permission-request      Agent is blocked waiting for a tool-permission grant
+  question-asked          Agent asked the user a question (elicitation dialog)
+  tool-complete           A tool execution completed (unblocks waiting state)
+  notification            Generic notification from the agent (heuristic gated)
+  stop                    Agent turn finished / went idle
+  session-end             Agent session closed / binary exited
+
+${c.bold('Creating a plugin')}
+${c.dim('──────────────────')}
+
+  # 1. Create the plugin directory with manifest + icon
+  mkdir -p ~/.termdock/agent-plugins/trae
+  cp manifest.json icon.svg ~/.termdock/agent-plugins/trae/
+
+  ${c.dim('# 2. Install the plugin via CLI (needs running server)')}
+  td plugin-create ~/.termdock/agent-plugins/trae/manifest.json
+
+  ${c.dim('# 3. Or create directly from the manifest JSON')}
+  td plugin-create ./trae-manifest.json
+
+  ${c.dim('# 4. List installed plugins')}
+  td plugin-list
+
+  ${c.dim('# 5. Remove a plugin')}
+  td plugin-remove trae
+
+${c.bold('Manifest validation at startup')}
+${c.dim('───────────────────────────────')}
+
+  Termdock validates every plugin manifest on server start. Errors are logged
+  to ${c.cyan('~/.termdock/server.log')} and visible via ${c.cyan('td plugin-list')}${c.dim('.')}
+  Slugs/aliases that collide with built-in agents are skipped.
+`);
+}
+async function runPluginCreate(manifestPath) {
+    const resolved = path.resolve(manifestPath);
+    let raw;
+    try {
+        raw = fs.readFileSync(resolved, 'utf8');
+    }
+    catch {
+        console.error(`${ICON.err} ${c.red(`Cannot read manifest file: ${resolved}`)}`);
+        process.exit(1);
+    }
+    let manifest;
+    try {
+        manifest = JSON.parse(raw);
+    }
+    catch (error) {
+        console.error(`${ICON.err} ${c.red(`Invalid JSON in ${resolved}: ${error.message}`)}`);
+        process.exit(1);
+    }
+    const { baseUrl, token } = requireRunningServer();
+    const response = await postLocalJson(baseUrl, token, '/api/terminal/agent-plugins', manifest);
+    const body = JSON.parse(response.body || '{}');
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        console.error(`${ICON.err} ${c.red(body.error || 'Failed to create plugin')}`);
+        process.exit(1);
+    }
+    console.log(`${ICON.ok} ${c.green(`Plugin "${body.slug}" created.`)}`);
+    console.log(`  ${c.dim('Directory:')} ${c.cyan(body.dir ?? resolved)}`);
+    console.log(`  ${c.dim('Restart Termdock to activate:')} ${c.cyan('td --stop && td')}`);
+}
+async function runPluginList() {
+    const { baseUrl, token } = requireRunningServer();
+    const response = await getLocalJson(baseUrl, token, '/api/terminal/agent-plugins');
+    const body = JSON.parse(response.body || '{}');
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        console.error(`${ICON.err} ${c.red('Failed to list plugins')}`);
+        process.exit(1);
+    }
+    const plugins = body.plugins ?? [];
+    if (plugins.length === 0) {
+        console.log(`${c.dim('No plugins installed.')}`);
+        console.log(`  ${c.dim('See:')} ${c.cyan('td plugin-init')}`);
+    }
+    else {
+        console.log(`${c.bold('Installed plugins')} ${c.dim(`(${plugins.length})`)}`);
+        console.log('');
+        for (const p of plugins) {
+            const flags = [];
+            if (p.hasIcon)
+                flags.push('icon');
+            if (p.hasHooks)
+                flags.push('hooks');
+            if (p.hasResume)
+                flags.push('resume');
+            if (p.iconMode !== 'mask')
+                flags.push(p.iconMode);
+            console.log(`  ${c.cyan(p.slug)}  ${c.dim(p.displayName)}  ${c.gray(p.accentColor)}  ${c.dim(flags.length > 0 ? `[${flags.join(', ')}]` : '')}`);
+        }
+    }
+    const errors = body.errors ?? [];
+    if (errors.length > 0) {
+        console.log('');
+        console.log(`${c.yellow('Validation errors')}`);
+        for (const e of errors) {
+            console.log(`  ${c.red('✗')} ${c.cyan(e.slug)}${c.dim(':')} ${e.errors.join('; ')}`);
+        }
+    }
+}
+async function runPluginRemove(slug) {
+    const { baseUrl, token } = requireRunningServer();
+    const response = await new Promise((resolve, reject) => {
+        const url = new URL(`/api/terminal/agent-plugins/${encodeURIComponent(slug)}`, baseUrl);
+        const isHttps = url.protocol === 'https:';
+        const requestImpl = isHttps ? https.request : http.request;
+        const ca = isHttps && fs.existsSync(defaultHttpsCaPath) ? fs.readFileSync(defaultHttpsCaPath) : undefined;
+        const req = requestImpl({
+            protocol: url.protocol,
+            hostname: url.hostname,
+            port: url.port,
+            path: url.pathname,
+            method: 'DELETE',
+            ca,
+            headers: { 'X-Termdock-Local-Token': token },
+        }, (res) => {
+            let responseBody = '';
+            res.setEncoding('utf8');
+            res.on('data', (chunk) => { responseBody += chunk; });
+            res.on('end', () => resolve({ statusCode: res.statusCode ?? 0, body: responseBody }));
+        });
+        req.on('error', reject);
+        req.end();
+    });
+    const body = JSON.parse(response.body || '{}');
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        console.error(`${ICON.err} ${c.red(body.error || `Failed to remove plugin "${slug}"`)}`);
+        process.exit(1);
+    }
+    console.log(`${ICON.ok} ${c.green(`Plugin "${body.slug ?? slug}" removed.`)}`);
+}
 const options = parseArgs(process.argv.slice(2));
 if (options.setPassword && options.clearPassword) {
     console.error(`${ICON.err} ${c.red('Cannot use --set-password and --clear-password together.')}`);
@@ -2375,6 +2698,30 @@ async function main() {
         runClearPassword();
         process.exit(0);
     }
+    if (options.pluginInit) {
+        runPluginInit();
+        process.exit(0);
+    }
+    if (options.pluginCreate !== undefined) {
+        if (!options.pluginCreate) {
+            console.error(`${ICON.err} ${c.red('plugin-create requires a manifest file path')}`);
+            process.exit(1);
+        }
+        await runPluginCreate(options.pluginCreate);
+        process.exit(0);
+    }
+    if (options.pluginList) {
+        await runPluginList();
+        process.exit(0);
+    }
+    if (options.pluginRemove !== undefined) {
+        if (!options.pluginRemove) {
+            console.error(`${ICON.err} ${c.red('plugin-remove requires a plugin slug')}`);
+            process.exit(1);
+        }
+        await runPluginRemove(options.pluginRemove);
+        process.exit(0);
+    }
     const localApiToken = getOrCreateLocalApiToken();
     await refreshDefaultHttpsCertificateSafely();
     const https = resolveHttpsOptions(options);

package/dist/server/routes/terminal.js

@@ -4573,8 +4573,14 @@ router.get('/:sessionId/health', (req, res) => {
     const { sessionId } = req.params;
     const session = terminalSessions.get(sessionId);
     if (!session) {
-        console.log(`Health check: session ${sessionId} not found`);
-        return res.status(404).json({ healthy: false, error: 'Session not found' });
+        // TD 重启后 terminalSessions 清空，但从 globalSessionState（持久化到磁盘）
+        // 可恢复 mode / tmuxSessionName，避免前端把 tmux 会话误重建为 shell。
+        const persistedRecord = globalSessionState.sessions.find((s) => s.backendSessionId === sessionId) ?? null;
+        const recovered = persistedRecord
+            ? { mode: persistedRecord.mode, tmuxSessionName: persistedRecord.tmuxSessionName }
+            : {};
+        console.log(`Health check: session ${sessionId} not found${persistedRecord ? `, recovered mode=${persistedRecord.mode} from persisted state` : ''}`);
+        return res.status(404).json({ healthy: false, error: 'Session not found', ...recovered });
     }
     console.log(`Health check: session ${sessionId} healthy, cwd=${session.cwd}, clients=${getTotalClients(sessionId)}, lastActivity=${Date.now() - session.lastActivity}ms ago`);
     res.json({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termdock",
-  "version": "1.4.4",
+  "version": "1.4.6",
   "description": "A complete web-based terminal application with modern UI",
   "type": "module",
   "bin": {

package/dist/client/assets/channel-CD9EYHvd.js

@@ -1 +0,0 @@
-import{U as a,C as n}from"./mermaid.core-D4Ax3qLz.js";const t=(r,o)=>a.lang.round(n.parse(r)[o]);export{t as c};

package/dist/client/assets/classDiagram-OUVF2IWQ-D46YHcok.js

@@ -1 +0,0 @@
-import{s as a,a as s,c as t,C as e}from"./chunk-V7JOEXUC-UyB55Fb4.js";import{b as i}from"./mermaid.core-D4Ax3qLz.js";import"./chunk-5VM5RSS4-D48bXYje.js";import"./chunk-XXDRQBXY-DwM4iNfy.js";import"./chunk-VR4S4FIN-C-xnKkZn.js";import"./chunk-32BRIVSS-BbMLiuF9.js";import"./purify.es-CC4Brkr_.js";import"./index-uR9bCvK3.js";import"./react-XDCjal2T.js";import"./dnd-BCFAPC0L.js";import"./terminal-C7X98Amf.js";var g={parser:t,get db(){return new e},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{g as diagram};

package/dist/client/assets/classDiagram-v2-EOCWNBFH-D46YHcok.js

@@ -1 +0,0 @@
-import{s as a,a as s,c as t,C as e}from"./chunk-V7JOEXUC-UyB55Fb4.js";import{b as i}from"./mermaid.core-D4Ax3qLz.js";import"./chunk-5VM5RSS4-D48bXYje.js";import"./chunk-XXDRQBXY-DwM4iNfy.js";import"./chunk-VR4S4FIN-C-xnKkZn.js";import"./chunk-32BRIVSS-BbMLiuF9.js";import"./purify.es-CC4Brkr_.js";import"./index-uR9bCvK3.js";import"./react-XDCjal2T.js";import"./dnd-BCFAPC0L.js";import"./terminal-C7X98Amf.js";var g={parser:t,get db(){return new e},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{g as diagram};