@termhub/agent 0.1.7 → 0.2.0

package/dist/cli.js

@@ -39,6 +39,9 @@ var sessionName = z.string().min(1).max(128).regex(SESSION_RE);
 var machinePath = z.string().min(1).max(4096).refine((p) => (p === "~" || p.startsWith("~/") || p.startsWith("/")) && !/[\0\n\r]/.test(p), "invalid path");
 var pasteName = z.string().min(1).max(255).regex(/^[A-Za-z0-9._-]+$/);
 var aiProvider = z.enum(["claude", "chatgpt", "gemini", "antigravity"]);
+var TMUX_KEYS = ["Enter", "Escape", "C-c", "Up", "Down", "Tab", "y", "n", "1", "2", "3", "4", "5", "6", "7", "8", "9"];
+var tmuxKey = z.enum(TMUX_KEYS);
+var TEXT_MAX_CHARS = 4e3;
 var rpcErrorSchema = z.object({
   /** `failed`: the operation ran on the machine and `message` says why it failed, in words meant for the user. */
   code: z.enum(["eperm", "notfound", "no_tmux", "timeout", "invalid", "internal", "failed"]),
@@ -51,6 +54,11 @@ var RPC = {
   "tmux.list": def(z.object({}), z.object({ sessions: z.array(sessionName) })),
   "tmux.kill": def(z.object({ session: sessionName }), z.object({ killed: z.boolean() })),
   "tmux.capture": def(z.object({ session: sessionName, lines: z.number().int().min(1).max(5e3) }), z.object({ text: z.string() })),
+  /** Idempotent: creates the detached session in `cwd` when it is missing. `created` says whether it had to. */
+  "tmux.ensure": def(z.object({ session: sessionName, cwd: machinePath }), z.object({ created: z.boolean() }), 1e4),
+  /** Types `text` literally, then (with `enter`) presses Enter on its own after a short pause. */
+  "tmux.sendText": def(z.object({ session: sessionName, text: z.string().max(TEXT_MAX_CHARS), enter: z.boolean() }), z.object({ sent: z.literal(true) }), 1e4),
+  "tmux.sendKey": def(z.object({ session: sessionName, key: tmuxKey }), z.object({ sent: z.literal(true) }), 1e4),
   "tools.detect": def(z.object({}), z.object({ os: z.string().nullable(), tools: z.array(z.string().max(32)) })),
   "hw.probe": def(z.object({}), z.object({ stdout: z.string() }), 15e3),
   "fs.list": def(z.object({ path: machinePath }), z.object({ stdout: z.string() })),
@@ -1117,6 +1125,7 @@ async function pasteFile(params) {
 }
 
 // src/rpc/tmux.ts
+var ENTER_PAUSE_MS = 300;
 function processFailure2(r) {
   if (r.timedOut) return new RpcFailure("timeout", "tmux timed out");
   if (r.error === "enoent") return new RpcFailure("no_tmux", "tmux not found");
@@ -1144,6 +1153,42 @@ async function capture(params) {
   if (r.code !== 0) throw new RpcFailure("notfound", "session not found");
   return { text: r.stdout };
 }
+var pane = (session) => `=${session}:`;
+var why = (stderr, fallback) => stderr.trim().split("\n")[0] || fallback;
+async function ensure(params) {
+  const has = await run(tmuxPath(), ["has-session", "-t", `=${params.session}`]);
+  const hasFailure = processFailure2(has);
+  if (hasFailure) throw hasFailure;
+  if (has.code === 0) return { created: false };
+  const made = await run(tmuxPath(), ["new-session", "-d", "-s", params.session, "-c", params.cwd]);
+  const madeFailure = processFailure2(made);
+  if (madeFailure) throw madeFailure;
+  if (made.code !== 0) throw new RpcFailure("failed", why(made.stderr, "tmux new-session falhou"), params.cwd);
+  return { created: true };
+}
+async function sendText(params) {
+  if (params.text) {
+    const typed = await run(tmuxPath(), ["send-keys", "-t", pane(params.session), "-l", "--", params.text]);
+    const failure = processFailure2(typed);
+    if (failure) throw failure;
+    if (typed.code !== 0) throw new RpcFailure("notfound", why(typed.stderr, "session not found"));
+    if (params.enter) await new Promise((r) => setTimeout(r, ENTER_PAUSE_MS));
+  }
+  if (params.enter) {
+    const entered = await run(tmuxPath(), ["send-keys", "-t", pane(params.session), "Enter"]);
+    const failure = processFailure2(entered);
+    if (failure) throw failure;
+    if (entered.code !== 0) throw new RpcFailure("notfound", why(entered.stderr, "session not found"));
+  }
+  return { sent: true };
+}
+async function sendKey(params) {
+  const r = await run(tmuxPath(), ["send-keys", "-t", pane(params.session), params.key]);
+  const failure = processFailure2(r);
+  if (failure) throw failure;
+  if (r.code !== 0) throw new RpcFailure("notfound", why(r.stderr, "session not found"));
+  return { sent: true };
+}
 
 // src/rpc/tools.ts
 async function detect(_params) {
@@ -1159,6 +1204,9 @@ var handlers = {
   "tmux.list": list2,
   "tmux.kill": kill,
   "tmux.capture": capture,
+  "tmux.ensure": ensure,
+  "tmux.sendText": sendText,
+  "tmux.sendKey": sendKey,
   "tools.detect": detect,
   "hw.probe": probe,
   "fs.list": list,
@@ -1254,7 +1302,7 @@ async function status(deps = {}) {
 }
 
 // src/version.ts
-var AGENT_VERSION = "0.1.7";
+var AGENT_VERSION = "0.2.0";
 
 // src/run.ts
 function detectOs(platform = process.platform) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@termhub/agent",
-  "version": "0.1.7",
+  "version": "0.2.0",
   "description": "Agente do termhub: conecta esta máquina ao servidor por WebSocket de saída (sem SSH) e expõe os terminais tmux no navegador.",
   "license": "MIT",
   "private": false,