@volter/supercode-teams 0.3.11 → 0.3.12

package/bin/teams.mjs

@@ -52,7 +52,7 @@ import { NODE_PROTOCOL } from '@volter/teams/channel';
 
 const MACHINE_VERBS = new Set(['machine', 'slow', 'describe', 'panes', 'input', 'suspend', 'resume', 'files', 'ports', 'port', 'browser', 'stream', 'jobs', 'workspace', 'title', 'attention', 'watch', 'rpc', 'launches', 'log', 'mail', 'health']);
 // Every flag a machine verb reads; any other is refused rather than silently ignored.
-const KNOWN_FLAGS = new Set(['home', 'since', 'machine', 'context', 'floor', 'supercode', 'tmux-socket', 'verbose', 'lines', 'input', 'name', 'for', 'urgency', 'reason', 'interrupt', 'query', 'out', 'in', 'interval', 'no-enter', 'when-composer-empty', 'key', 'listen', 'list', 'from', 'to', 'path', 'to-path', 'repo', 'branch', 'solo', 'card', 'create', 'presence-only', 'clear-draft', 'message-ids', 'json', 'all']);
+const KNOWN_FLAGS = new Set(['home', 'since', 'machine', 'context', 'floor', 'supercode', 'tmux-socket', 'verbose', 'lines', 'input', 'name', 'for', 'urgency', 'reason', 'interrupt', 'query', 'out', 'in', 'interval', 'no-enter', 'when-composer-empty', 'key', 'listen', 'list', 'from', 'to', 'path', 'to-path', 'repo', 'branch', 'solo', 'card', 'create', 'presence-only', 'processes', 'panes', 'clear-draft', 'message-ids', 'json', 'all']);
 
 const argv = process.argv.slice(2);
 const flags = {};
@@ -218,7 +218,11 @@ async function main() {
     case 'describe':
       return withNode(async (rpc) => out(await rpc.call('describe')));
     case 'panes': {
-      if (sub === 'ls') return withNode(async (rpc) => out(await rpc.call(flags['presence-only'] ? 'panes.present' : 'panes.list')));
+      // `--processes`: each pane and its root pid (no screens read); `--presence-only [--panes a,b]`: whether each pane's
+      // composer is idle, for the named panes only when named.
+      if (sub === 'ls') return withNode(async (rpc) => out(await rpc.call(
+        flags.processes ? 'panes.processes' : flags['presence-only'] ? 'panes.present' : 'panes.list',
+        flags['presence-only'] && typeof flags.panes === 'string' ? { panes: flags.panes.split(',').filter(Boolean) } : {})));
       if (sub === 'capture') return withNode(async (rpc) => out((await rpc.call('panes.capture', { pane: rest[0], lines: Number(flags.lines ?? 200) })).text));
       if (sub === 'close') return withNode(async (rpc) => out(await rpc.call('panes.close', { pane: rest[0] })));
       die('panes ls|capture|close');

package/machine.mjs

@@ -1727,7 +1727,9 @@ export class TeamsMachine extends MachineCore {
         // No harness callback: discovery may be the harness's own caller.
         const whole = operator || holds(admitted, 'view', '*');
         if (!whole && !observesPanes(admitted)) need('view', '*');
-        const sessions = (await this.host.listSessions()).filter(s => s.contextKey && !s.dead && (whole || holds(admitted, 'observe', `pane:${s.contextKey}`)));
+        // `panes`: only these are read (a caller that needs some panes' composers does not pay a capture of every pane).
+        const asked = Array.isArray(params.panes) ? new Set(params.panes.map(String)) : null;
+        const sessions = (await this.host.listSessions()).filter(s => s.contextKey && !s.dead && (!asked || asked.has(s.contextKey)) && (whole || holds(admitted, 'observe', `pane:${s.contextKey}`)));
         return Promise.all(sessions.map(async session => {
           const screen = await Promise.resolve().then(() => this.host.capture(session.id, { lines: 100, preserveEscapes: true })).catch(() => null);
           const kind = this.#paneKind(session.contextKey, session);
@@ -1735,6 +1737,15 @@ export class TeamsMachine extends MachineCore {
           return { pane: session.contextKey, idleComposer: composer != null && !/\besc to (?:interrupt|cancel)\b/iu.test(screen) };
         }));
       }
+      case 'panes.processes': {
+        // Each pane and its root process, from the pane listing alone: what a caller that maps processes to panes
+        // needs, without panes.list's screen capture of every pane (message list asked for that, t_23e47b73).
+        const whole = operator || holds(admitted, 'view', '*');
+        if (!whole && !observesPanes(admitted)) need('view', '*');
+        return (await this.host.listSessions())
+          .filter(s => s.contextKey && !s.dead && (whole || holds(admitted, 'observe', `pane:${s.contextKey}`)))
+          .map(s => ({ pane: s.contextKey, pid: s.rootPid ?? null }));
+      }
       case 'harness.v1.panes.list':
       case 'panes.list': {
         // A participant lists the panes its grants let it observe; view on the whole

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/supercode-teams",
-  "version": "0.3.11",
+  "version": "0.3.12",
   "type": "module",
   "description": "A machine daemon serving this machine's doors, and a local or remote Teams server for shared session discovery, OpenTelemetry ingestion and access to enrolled machines.",
   "license": "MIT",