@termhub/agent 0.1.6 → 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() })),
@@ -490,14 +498,26 @@ function buildPasteScript(name) {
 }
 
 // ../../packages/machine-ops/dist/ai-credentials.js
+var CREDENTIAL_SEPARATOR = "---termhub-credential---";
 function credentialScript(provider) {
   switch (provider) {
     case "claude":
       return [
-        `if [ -f "$D/.credentials.json" ]; then cat "$D/.credentials.json"`,
-        `elif [ "$(uname -s)" = Darwin ]; then security find-generic-password -s "Claude Code-credentials" -w 2>/dev/null || true`,
+        `SEP=${shellQuote(CREDENTIAL_SEPARATOR)}`,
+        // 1. the on-disk copy (Linux, and macOS when the keychain entry is missing/disabled)
+        `if [ -f "$D/.credentials.json" ]; then cat "$D/.credentials.json" 2>/dev/null || true; fi`,
+        `printf '\\n%s\\n' "$SEP"`,
+        `if [ "$(uname -s 2>/dev/null)" = Darwin ]; then`,
+        `  D=\${D%/}`,
+        // 2a. the per-config-dir keychain item (CLAUDE_CONFIG_DIR accounts)
+        `  H=$(printf %s "$D" | shasum -a 256 2>/dev/null | cut -c1-8) || true`,
+        `  if [ -n "$H" ]; then security find-generic-password -s "Claude Code-credentials-$H" -w 2>/dev/null || true; fi`,
+        `  printf '\\n%s\\n' "$SEP"`,
+        // 2b. the unsuffixed item, only for the default dir (it belongs to a different account otherwise)
+        `  if [ "$D" = "$HOME/.claude" ]; then security find-generic-password -s "Claude Code-credentials" -w 2>/dev/null || true; fi`,
+        `  printf '\\n%s\\n' "$SEP"`,
         `fi`
-      ].join("; ");
+      ].join("\n");
     case "chatgpt":
       return `if [ -f "$D/auth.json" ]; then cat "$D/auth.json"; fi`;
     case "gemini":
@@ -1105,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");
@@ -1132,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) {
@@ -1147,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,
@@ -1242,7 +1302,7 @@ async function status(deps = {}) {
 }
 
 // src/version.ts
-var AGENT_VERSION = "0.1.6";
+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.6",
+  "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,