termdock 1.4.97 → 1.4.99

package/dist/server/cli.js

@@ -181,6 +181,14 @@ Short commands:
   agent-event <slug> <event> [status]
                      Emit one lifecycle/status event from an Agent hook.
   pi                 Same as agent-plugin
+  collab status      Show this Session's collaboration groups and peers
+  collab inbox       Read and acknowledge collaboration messages
+  collab send <session-id> <message>
+                     Send a durable message to a related Session
+  collab handoff <session-id> <summary>
+                     Hand off work and context to another Session
+  collab reply <message-id> <message>
+                     Reply in the original collaboration thread
   plugin-create <file>
                      Same as --plugin-create <file>
   plugin-install <source>
@@ -543,6 +551,7 @@ function parseArgs(argv) {
     let pluginHooks;
     let pluginRemove;
     let agentEvent;
+    let collab;
     // 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('-')) {
@@ -659,6 +668,27 @@ function parseArgs(argv) {
                 process.exit(1);
             }
         }
+        else if (command === 'collab') {
+            const action = (next || 'status');
+            const json = argv.includes('--json');
+            if (action === 'status' || action === 'inbox') {
+                collab = { action, json };
+            }
+            else if (action === 'send' || action === 'handoff' || action === 'reply') {
+                const target = argv[2];
+                const message = argv.slice(3).filter((part) => part !== '--json').join(' ').trim();
+                if (!target || !message) {
+                    console.error(`${ICON.err} ${c.red(`Usage: td collab ${action} <${action === 'reply' ? 'message-id' : 'session-id'}> <message>`)}`);
+                    process.exit(1);
+                }
+                collab = { action, target, message, json };
+            }
+            else {
+                console.error(`${ICON.err} ${c.red('Usage: td collab <status|inbox|send|handoff|reply>')}`);
+                process.exit(1);
+            }
+            argv = [];
+        }
         else if (command === 'pcreate' || command === 'plugin-create') {
             if (next && !next.startsWith('-')) {
                 pluginCreate = next;
@@ -1020,6 +1050,7 @@ function parseArgs(argv) {
         pluginHooks,
         pluginRemove,
         agentEvent,
+        collab,
     };
 }
 // Reads a single line from stdin without echoing keystrokes. Used for password
@@ -1204,6 +1235,98 @@ async function getLocalJson(baseUrl, token, endpoint) {
         req.end();
     });
 }
+async function runCollab(command) {
+    const runningState = getRunningState();
+    if (!runningState?.localApiToken) {
+        console.error(`${ICON.err} ${c.red('Termdock is not running or its local API token is unavailable.')}`);
+        process.exit(1);
+    }
+    const backendSessionId = process.env.TERMDOCK_BACKEND_SESSION_ID?.trim() || null;
+    let tmuxSessionName = null;
+    if (!backendSessionId && process.env.TMUX) {
+        try {
+            const { stdout } = await execFileAsync(process.env.TMUX_BIN || 'tmux', ['display-message', '-p', '#S'], {
+                timeout: 2_000,
+                maxBuffer: 16 * 1024,
+            });
+            const detected = stdout.trim();
+            if (detected && !detected.includes('\n') && detected.length <= 128)
+                tmuxSessionName = detected;
+        }
+        catch {
+            // The explicit backend id remains the primary path; tmux is a fallback
+            // for managed panes whose inner shell predates the attach wrapper env.
+        }
+    }
+    if (!backendSessionId && !tmuxSessionName) {
+        console.error(`${ICON.err} ${c.red('td collab must run inside a Termdock-managed Session.')}`);
+        process.exit(1);
+    }
+    const context = backendSessionId ? { backendSessionId } : { tmuxSessionName };
+    const contextQuery = new URLSearchParams(Object.entries(context).filter((entry) => typeof entry[1] === 'string')).toString();
+    const baseUrl = runningState.localUrl
+        ?? `${runningState.scheme ?? 'http'}://${runningState.host === '0.0.0.0' ? 'localhost' : runningState.host}:${runningState.port}`;
+    let response;
+    if (command.action === 'status') {
+        response = await getLocalJson(baseUrl, runningState.localApiToken, `/api/terminal/operations/orchestration/peers?${contextQuery}`);
+    }
+    else if (command.action === 'inbox') {
+        response = await getLocalJson(baseUrl, runningState.localApiToken, `/api/terminal/operations/orchestration/inbox?${contextQuery}&markRead=true`);
+    }
+    else if (command.action === 'reply') {
+        response = await postLocalJson(baseUrl, runningState.localApiToken, '/api/terminal/operations/orchestration/reply', {
+            ...context,
+            messageId: command.target,
+            content: command.message,
+        });
+    }
+    else {
+        response = await postLocalJson(baseUrl, runningState.localApiToken, '/api/terminal/operations/orchestration/send', {
+            ...context,
+            targetSessionId: command.target,
+            message: command.message,
+            kind: command.action === 'handoff' ? 'handoff' : 'message',
+        });
+    }
+    let body = {};
+    try {
+        body = JSON.parse(response.body || '{}');
+    }
+    catch { /* handled below */ }
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        console.error(`${ICON.err} ${c.red(typeof body.error === 'string' ? body.error : 'Collaboration request failed')}`);
+        process.exit(1);
+    }
+    if (command.json) {
+        console.log(JSON.stringify(body, null, 2));
+        return;
+    }
+    if (command.action === 'status') {
+        const groups = Array.isArray(body.groups) ? body.groups : [];
+        const peers = Array.isArray(body.peers) ? body.peers : [];
+        console.log(`${ICON.ok} ${c.green(`Collaboration: ${groups.length} group(s), ${peers.length} peer(s)`)}`);
+        for (const peer of peers) {
+            console.log(`  ${c.cyan(peer.name ?? peer.sessionId ?? 'Session')} ${c.dim(`[${peer.sessionId ?? ''}]`)}`);
+            console.log(`    ${peer.status ?? 'offline'} · ${peer.capability ?? ''}`);
+            if (peer.currentTask)
+                console.log(`    ${c.dim(peer.currentTask)}`);
+        }
+        return;
+    }
+    if (command.action === 'inbox') {
+        const messages = Array.isArray(body.messages) ? body.messages : [];
+        if (messages.length === 0) {
+            console.log(`${ICON.ok} ${c.dim('Collaboration inbox is empty.')}`);
+            return;
+        }
+        for (const message of messages) {
+            console.log(`${c.cyan(message.kind ?? 'message')} ${c.dim(`#${message.id ?? ''}`)} from ${message.fromSessionId ?? 'user'}`);
+            console.log(`  ${message.content ?? ''}`);
+        }
+        return;
+    }
+    console.log(`${ICON.ok} ${c.green(command.action === 'reply' ? 'Reply sent.' : command.action === 'handoff' ? 'Handoff sent.' : 'Message sent.')}`);
+}
 async function runInjectChangeAudit(source) {
     const raw = source === true
         ? await readStdinText()
@@ -1809,6 +1932,7 @@ const AGENT_PLUGIN_EXAMPLE = {
     slug: 'my-agent',
     displayName: 'My Agent',
     aliases: ['my-agent'],
+    capabilities: ['code-review', 'testing'],
     accentColor: '#4385BE',
     iconMode: 'mask',
     statuses: [
@@ -1872,6 +1996,11 @@ function runPluginInitJson() {
             indicator: 'Theme-safe visual indicator.',
             tone: 'Theme token; arbitrary status colors are not accepted.',
         },
+        collaboration: {
+            capabilities: 'Optional routing hints shown beside this Agent in collaboration groups.',
+            universalTransport: 'Every detected Agent receives durable inbox messages through its PTY and can use td collab when it has shell access.',
+            hooks: 'Hooks add busy/idle awareness so Termdock can defer delivery until a turn finishes; they are not required for collaboration.',
+        },
         security: {
             source: 'Only public HTTPS repository roots on approved Git hosts or explicit local paths are accepted; URL credentials are rejected.',
             package: 'Symlinks, active/external SVG content, oversized files, submodules, and excessive unpacked size are rejected.',
@@ -1906,6 +2035,7 @@ function runPluginInitJson() {
             'If the Agent hook format is not a Claude-style hooks map, configure native hooks to call td agent-event directly.',
             'Map the completed-turn hook to event "stop"; this is also the automatic-title trigger when the user enables titles for the Agent.',
             'Optionally declare titleNamer so this Agent can generate titles and dynamically publish its own model catalog.',
+            'Optionally declare capabilities so users and peer Agents can see what this Agent is suited for.',
             'Put optional model flags in titleNamer.modelArgs; keep the always-present prompt invocation in titleNamer.args.',
             'Run td plugin-doctor <slug> --json and fix every warning before sharing the repository.',
             'Tell the user that enabling a plugin title provider executes that plugin\'s declared CLI; installation alone never does.',
@@ -1972,6 +2102,9 @@ ${c.dim('───────────────────')}
   ${c.dim('// First alias is the primary binary name; extras match npm/pip wrappers.')}
   "aliases": ["trae", "traecli"],
 
+  ${c.dim('// Optional collaboration routing hints (max 32 short names).')}
+  "capabilities": ["code-review", "frontend", "testing"],
+
   ${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",
@@ -2181,6 +2314,8 @@ async function runPluginList(json = false) {
             if (p.updateAvailable)
                 flags.push('update');
             console.log(`  ${c.cyan(p.slug)}  ${c.dim(p.displayName)}  ${c.gray(p.accentColor)}  ${c.dim(flags.length > 0 ? `[${flags.join(', ')}]` : '')}`);
+            if (p.capabilities?.length)
+                console.log(`    ${c.dim(`capabilities: ${p.capabilities.join(', ')}`)}`);
             if (p.source)
                 console.log(`    ${c.dim(`${p.sourceType ?? 'source'}: ${p.source}${p.revision ? ` @ ${p.revision.slice(0, 8)}` : ''}`)}`);
         }
@@ -3239,6 +3374,10 @@ async function main() {
     if (options.agentEvent) {
         runAgentEvent(options.agentEvent);
     }
+    if (options.collab) {
+        await runCollab(options.collab);
+        process.exit(0);
+    }
     if (options.pluginInit) {
         if (options.pluginInitJson)
             runPluginInitJson();