@volter/supercode-teams 0.2.71 → 0.2.73

package/README.md

@@ -82,6 +82,7 @@ supercode teams machine start                        # local door only
 supercode open --new bash --detach                   # a pane; prints its contextKey
 supercode open <ctx>                                 # attach; ctrl-] detaches
 supercode teams input <ctx> "make test"
+supercode teams input <ctx> --key Escape             # keys by tmux name: C-c, "Down Enter", …
 supercode teams title set <ctx> "rate-limit rescue"  # also names the owned tmux window
 supercode teams suspend <ctx>                        # remote input refused; observe keeps streaming
 supercode teams resume <ctx> --input "carry on"      # the input that hands the pane back

package/bin/teams.mjs

@@ -10,7 +10,7 @@
 //   machine status                                               the running daemon, if any
 //   describe                                     the host-key-signed statement
 //   panes ls | capture <pane> | close <pane>
-//   input <pane> <text> [--no-enter]
+//   input <pane> <text> [--no-enter] | input <pane> --key NAMES   text, or keys by tmux name (Escape, C-c, Down …)
 //   suspend <pane> [--interrupt] | resume <pane> [--input text]   refuse/allow remote input on a pane
 //   files ls|get|put|stat|search <path> [--out f] [--in f] [--query q]
 //   ports ls | resolve <pane>          port <pane>/<n> [--listen host:port]
@@ -45,7 +45,7 @@ import { NODE_PROTOCOL } from '@volter/teams/channel';
 
 const MACHINE_VERBS = new Set(['machine', 'describe', 'panes', 'input', 'suspend', 'resume', 'files', 'ports', 'port', 'browser', 'stream', 'jobs', 'workspace', 'title', 'attention', 'watch', 'rpc', 'log', 'mail']);
 // Every flag a machine verb reads; any other is refused rather than silently ignored.
-const KNOWN_FLAGS = new Set(['home', 'machine', 'context', 'floor', 'supercode', 'tmux-socket', 'verbose', 'lines', 'input', 'name', 'for', 'urgency', 'reason', 'interrupt', 'query', 'out', 'in', 'interval', 'no-enter', 'when-composer-empty', 'listen', 'list', 'from', 'to', 'path', 'to-path']);
+const KNOWN_FLAGS = new Set(['home', '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']);
 
 const argv = process.argv.slice(2);
 const flags = {};
@@ -90,6 +90,18 @@ const out = (value) => process.stdout.write((typeof value === 'string' ? value :
 const die = (message, code = 2) => { process.stderr.write(`supercode teams: ${message}\n`); process.exit(code); };
 if (!workspaceVerb) for (const flag of Object.keys(flags)) if (!KNOWN_FLAGS.has(flag)) die(`unknown flag: --${flag}`);
 
+/** Named keys (tmux's names) as the bytes a terminal sends for them: `panes.input` delivers
+ *  them (`keys`) as a keystream, which every terminal host turns back into keys. */
+const KEY_BYTES = { Escape: '\u001b', Enter: '\r', Tab: '\t', BTab: '\u001b[Z', BSpace: '\u007f', Space: ' ', Up: '\u001b[A', Down: '\u001b[B', Right: '\u001b[C', Left: '\u001b[D', Home: '\u001b[H', End: '\u001b[F', PPage: '\u001b[5~', NPage: '\u001b[6~', DC: '\u001b[3~' };
+function keyBytes(names) {
+  return names.split(/[\s,]+/u).filter(Boolean).map((name) => {
+    const control = /^C-([a-z])$/iu.exec(name);
+    if (control) return String.fromCharCode(control[1].toLowerCase().charCodeAt(0) - 96);
+    if (!Object.hasOwn(KEY_BYTES, name)) die(`unknown key ${name}: one of ${Object.keys(KEY_BYTES).join(', ')}, C-a … C-z`);
+    return KEY_BYTES[name];
+  }).join('');
+}
+
 async function machineChannel() {
   return openMachine({ machine: flags.machine ? String(flags.machine) : null, context: flags.context ? String(flags.context) : null, home });
 }
@@ -198,6 +210,10 @@ async function main() {
       // `input <pane> <text>`: one delivery through the host's own sendInput; gated like control.
       // `--when-composer-empty`: a user's own turn, typed only into an empty composer
       // (answers `delivered: false` with the reason when it holds a draft).
+      if (flags.key !== undefined) {
+        if (flags.key === true || rest.length) die('input <pane> --key NAMES: keys by tmux name, space- or comma-separated (Escape, Enter, Tab, BTab, BSpace, Space, Up, Down, Left, Right, Home, End, PPage, NPage, DC, C-a … C-z)');
+        return withNode(async (rpc) => out(await rpc.call('panes.input', { pane: sub, text: keyBytes(String(flags.key)), submit: false, keys: true })));
+      }
       if (flags['when-composer-empty']) return withNode(async (rpc) => out(await rpc.call('panes.turn', { pane: sub, text: rest.join(' ') })));
       return withNode(async (rpc) => out(await rpc.call('panes.input', { pane: sub, text: rest.join(' '), submit: !flags['no-enter'] })));
     case 'port': {

package/machine.mjs

@@ -1243,7 +1243,9 @@ export class TeamsMachine extends MachineCore {
         if (this.suspended.has(params.pane)) throw Object.assign(new Error(`pane ${params.pane} is suspended: remote input is refused until resume`), { code: 423 });
         // `deadlineMs` is how long the caller will wait (default 10 s, which covers `retry`'s 5.5 s of
         // submit presses; at most 30 s); the terminal host takes an absolute deadline.
-        const delivery = await this.host.sendInput(session.id, submission(params.text, params.submit !== false), { submitMode: params.submit === false ? 'single' : 'retry', deadlineMs: Date.now() + Math.min(Number(params.deadlineMs) || 10_000, 30_000) });
+        // `keys`: the bytes of named keys, delivered as they are (a trailing Enter is a key, not a line ending).
+        const data = params.keys ? String(params.text ?? '') : submission(params.text, params.submit !== false);
+        const delivery = await this.host.sendInput(session.id, data, { submitMode: params.submit === false || params.keys ? 'single' : 'retry', deadlineMs: Date.now() + Math.min(Number(params.deadlineMs) || 10_000, 30_000) });
         act('control', `pane:${params.pane}`, 'input');
         return { delivered: true, delivery };
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/supercode-teams",
-  "version": "0.2.71",
+  "version": "0.2.73",
   "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",