@termhub/agent 0.5.3 → 0.7.0

package/dist/cli.js

@@ -85,6 +85,12 @@ var RPC = {
     recursive: z.boolean().optional()
   }), z.object({ stdout: z.string() })),
   "ai.credential": def(z.object({ provider: aiProvider, config_dir: machinePath.nullable() }), z.object({ stdout: z.string() }), 1e4),
+  /** Symlinks a Claude Code transcript into another account's config dir so `claude --resume` finds it there (since agent 0.7.0). */
+  "claude.linkSession": def(z.object({
+    transcript_path: machinePath,
+    session_id: z.string().regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/),
+    config_dir: machinePath.nullable()
+  }), z.object({ status: z.enum(["linked", "same_account", "no_transcript", "no_config_dir", "conflict"]) }), 1e4),
   "file.paste": def(z.object({ name: pasteName, data_b64: z.string().min(1).max(28 * 1024 * 1024) }), z.object({ path: z.string() }), 6e4),
   /** Monitor hooks (see @termhub/machine-ops hooks.ts): the agent writes the script, env and config entries under its own $HOME. */
   /** `claude_dirs`: Claude config dirs besides ~/.claude (accounts with CLAUDE_CONFIG_DIR), hooked when they exist; since agent 0.1.5. */
@@ -128,6 +134,8 @@ var closedReason = z2.enum(["cli_missing", "run_failed", "killed", "missing_sess
 var CAPABILITY_CLAUDE = "claude";
 var CAPABILITY_CLAUDE_SYSTEM_PROMPT = "claude.system_prompt";
 var CAPABILITY_SIM = "sim";
+var CAPABILITY_CLAUDE_STREAM_INPUT = "claude.stream_input";
+var STREAM_END_INPUT_LINE = '{"type":"termhub_end_input"}';
 var helloMessage = z2.object({
   type: z2.literal("hello"),
   protocol: z2.number().int().min(1),
@@ -171,9 +179,13 @@ var claudeOpenParams = z2.object({
   // belongs at, so there is no separate, later place to hand it over.
   token: z2.string(),
   model: z2.string().nullable().optional(),
-  // Project chats only: the server-composed focus text forwarded onto the CLI's argv (see
+  // Project chats and streamed runs: the server-composed text forwarded onto the CLI's argv (see
   // `CAPABILITY_CLAUDE_SYSTEM_PROMPT`). Absent for the account-wide chat, whose argv must not change.
-  append_system_prompt: z2.string().max(4e3).nullable().optional()
+  // 8000 because a streamed run carries the orchestrator prompt next to a project's (at most 4000
+  // each); only agents that advertise `CAPABILITY_CLAUDE_STREAM_INPUT` are ever sent more than 4000.
+  append_system_prompt: z2.string().max(8e3).nullable().optional(),
+  // See `CAPABILITY_CLAUDE_STREAM_INPUT`. Absent on every one-shot run, whose open frame must not change.
+  stream_input: z2.boolean().optional()
 });
 var tcpOpenParams = z2.object({ port: wdaPort }).strict();
 var openPty = z2.object({ type: z2.literal("open"), ch: channel, kind: z2.literal("pty"), params: ptyOpenParams });
@@ -658,7 +670,7 @@ function claudeConfigDirs(accountDirs) {
 function expandHome(dir, home) {
   return dir.startsWith("~/") ? `${home}/${dir.slice(2)}` : dir;
 }
-var CLAUDE_HOOK_EVENTS = ["SessionStart", "UserPromptSubmit", "PreToolUse", "PermissionRequest", "Notification", "Stop", "SessionEnd"];
+var CLAUDE_HOOK_EVENTS = ["SessionStart", "UserPromptSubmit", "PreToolUse", "PermissionRequest", "Notification", "Stop", "StopFailure", "SessionEnd"];
 var CLAUDE_TOOL_EVENTS = /* @__PURE__ */ new Set(["PreToolUse", "PermissionRequest"]);
 var CURSOR_HOOK_EVENTS = ["sessionStart", "beforeSubmitPrompt", "afterAgentResponse", "stop", "sessionEnd"];
 var HOOK_SCRIPT = `#!/bin/sh
@@ -903,6 +915,32 @@ function stripCursorHooks(current) {
 `;
 }
 
+// ../../packages/machine-ops/dist/claude-session.js
+var CLAUDE_LINK_STATUSES = ["linked", "same_account", "no_transcript", "no_config_dir", "conflict"];
+function claudeLinkScript(transcriptPath, sessionId, configDir) {
+  return [
+    configDirPrefix(configDir, ".claude"),
+    `SRC=${shellQuote(transcriptPath)}; SID=${shellQuote(sessionId)}`,
+    '[ -f "$SRC" ] || { echo no_transcript; exit 0; }',
+    'SLUGDIR=$(dirname "$SRC"); SLUG=$(basename "$SLUGDIR"); SRCROOT=$(dirname "$(dirname "$SLUGDIR")")',
+    '[ -d "$D" ] || { echo no_config_dir; exit 0; }',
+    'if [ "$(cd "$SRCROOT" && pwd -P)" = "$(cd "$D" && pwd -P)" ]; then echo same_account; exit 0; fi',
+    'mkdir -p "$D/projects/$SLUG" 2>/dev/null || { echo no_config_dir; exit 0; }',
+    'T="$D/projects/$SLUG/$SID.jsonl"',
+    'if [ -e "$T" ] || [ -L "$T" ]; then [ "$T" -ef "$SRC" ] || { echo conflict; exit 0; }; else ln -s "$SRC" "$T" 2>/dev/null || { echo conflict; exit 0; }; fi',
+    'if [ -d "$SLUGDIR/$SID" ] && [ ! -e "$D/projects/$SLUG/$SID" ] && [ ! -L "$D/projects/$SLUG/$SID" ]; then ln -s "$SLUGDIR/$SID" "$D/projects/$SLUG/$SID" 2>/dev/null; fi',
+    "echo linked"
+  ].join("\n");
+}
+function parseClaudeLinkStatus(stdout) {
+  const words = stdout.split(/\s+/).filter(Boolean);
+  for (let i = words.length - 1; i >= 0; i--) {
+    if (CLAUDE_LINK_STATUSES.includes(words[i]))
+      return words[i];
+  }
+  return null;
+}
+
 // ../../packages/machine-ops/dist/discover.js
 var CLAUDE_MARKERS = ["settings.json", "projects", ".credentials.json"];
 var CLAUDE_DIR_NAME = /^\.claude[A-Za-z0-9._-]*$/;
@@ -1300,6 +1338,10 @@ async function uninstall(params, home = os3.homedir()) {
 
 // ../../packages/claude-cli/dist/index.js
 var DISALLOWED_TOOLS = "Bash,Read,Write,Edit,WebFetch,WebSearch";
+var BACKGROUND_AGENT_HOOK = `input=$(cat); case "$input" in *'"agent_id"'*) exit 0;; esac; printf '%s' "$input" | grep -Eq '"run_in_background"[[:space:]]*:[[:space:]]*true' && exit 0; echo 'No chat do termhub todo subagente roda em segundo plano: repita esta chamada do Agent com run_in_background: true.' >&2; exit 2`;
+var CONCIERGE_SETTINGS = JSON.stringify({
+  hooks: { PreToolUse: [{ matcher: "Agent|Task", hooks: [{ type: "command", command: BACKGROUND_AGENT_HOOK }] }] }
+});
 function buildClaudeArgs(spec) {
   return [
     "-p",
@@ -1322,6 +1364,7 @@ function buildClaudeArgs(spec) {
     "mcp__termhub__*",
     "--disallowed-tools",
     DISALLOWED_TOOLS,
+    ...spec.stream_input ? ["--input-format", "stream-json", "--replay-user-messages", "--settings", CONCIERGE_SETTINGS] : [],
     ...spec.model ? ["--model", spec.model] : [],
     // Last, and only when set: the account-wide chat's argv stays exactly what it was. It is our own
     // server-composed text (a project's name, key and paths), never the user's prompt, which still
@@ -1346,6 +1389,8 @@ import { mkdtempSync, rmSync, writeFileSync } from "fs";
 import { tmpdir } from "os";
 import { join } from "path";
 var DEFAULT_TIMEOUT_MS2 = 10 * 60 * 1e3;
+var STREAM_TIMEOUT_MS = 60 * 60 * 1e3;
+var MAX_PENDING_INPUT_BYTES = 256 * 1024;
 var KILL_GRACE_MS = 2e3;
 var PROMPT_TIMEOUT_MS = 3e4;
 var MAX_LINE_BYTES = MAX_FRAME - HEADER_BYTES - 1;
@@ -1378,7 +1423,8 @@ function createClaudeManager(deps) {
       }
       const runDir = dir;
       socket.sendControl({ type: "opened", ch });
-      deps.log("claude run starting", { ch, resume: params.resume, model: params.model ?? null });
+      const stream = params.stream_input === true;
+      deps.log("claude run starting", { ch, resume: params.resume, model: params.model ?? null, stream });
       const env2 = { ...deps.env ?? agentEnv() };
       if (params.config_dir === null) delete env2.CLAUDE_CONFIG_DIR;
       else env2.CLAUDE_CONFIG_DIR = params.config_dir;
@@ -1387,7 +1433,8 @@ function createClaudeManager(deps) {
         resume: params.resume,
         mcp_config_path: mcpConfigPath,
         model: params.model ?? null,
-        append_system_prompt: params.append_system_prompt ?? null
+        append_system_prompt: params.append_system_prompt ?? null,
+        stream_input: stream
       });
       let child;
       try {
@@ -1463,10 +1510,11 @@ function createClaudeManager(deps) {
           deps.log("claude stream send failed", { ch, error: message(err) });
         }
       }
+      const timeoutMs = deps.timeoutMs ?? (stream ? STREAM_TIMEOUT_MS : DEFAULT_TIMEOUT_MS2);
       const timer = setTimeout(() => {
-        deps.log("claude run timed out", { ch, timeoutMs: deps.timeoutMs ?? DEFAULT_TIMEOUT_MS2 });
+        deps.log("claude run timed out", { ch, timeoutMs });
         killRun();
-      }, deps.timeoutMs ?? DEFAULT_TIMEOUT_MS2);
+      }, timeoutMs);
       timer.unref();
       const promptTimer = setTimeout(() => {
         deps.log("claude run got no prompt", { ch, promptTimeoutMs: deps.promptTimeoutMs ?? PROMPT_TIMEOUT_MS });
@@ -1479,7 +1527,11 @@ function createClaudeManager(deps) {
         promptSent: false,
         kill: killRun,
         promptArrived: () => clearTimeout(promptTimer),
-        settle
+        settle,
+        stream,
+        inputTail: "",
+        inputEnded: false,
+        discarding: false
       };
       runs.set(ch, run2);
       child.stdin?.on("error", () => {
@@ -1525,13 +1577,51 @@ function createClaudeManager(deps) {
     write(ch, data) {
       const run2 = runs.get(ch);
       if (!run2) return false;
-      if (run2.promptSent) {
-        deps.log("extra data on a claude channel ignored", { ch, bytes: data.length });
+      if (!run2.stream) {
+        if (run2.promptSent) {
+          deps.log("extra data on a claude channel ignored", { ch, bytes: data.length });
+          return true;
+        }
+        run2.promptSent = true;
+        run2.promptArrived();
+        run2.child.stdin?.end(data);
         return true;
       }
       run2.promptSent = true;
       run2.promptArrived();
-      run2.child.stdin?.end(data);
+      if (run2.inputEnded) {
+        deps.log("claude input after its end ignored", { ch, bytes: data.length });
+        return true;
+      }
+      let text = data.toString("utf8");
+      if (run2.discarding) {
+        const nl = text.indexOf("\n");
+        if (nl === -1) return true;
+        deps.log("claude input line too large, rest dropped", { ch, bytes: Buffer.byteLength(text.slice(0, nl), "utf8") });
+        run2.discarding = false;
+        text = text.slice(nl + 1);
+      }
+      run2.inputTail += text;
+      for (; ; ) {
+        const nl = run2.inputTail.indexOf("\n");
+        if (nl === -1) break;
+        const line = run2.inputTail.slice(0, nl);
+        run2.inputTail = run2.inputTail.slice(nl + 1);
+        if (line === STREAM_END_INPUT_LINE) {
+          run2.inputEnded = true;
+          if (run2.inputTail.length > 0) deps.log("claude input after its end ignored", { ch, bytes: Buffer.byteLength(run2.inputTail, "utf8") });
+          run2.inputTail = "";
+          run2.child.stdin?.end();
+          return true;
+        }
+        if (line.trim()) run2.child.stdin?.write(`${line}
+`);
+      }
+      if (Buffer.byteLength(run2.inputTail, "utf8") > (deps.maxPendingInputBytes ?? MAX_PENDING_INPUT_BYTES)) {
+        deps.log("claude input line too large, dropped", { ch, bytes: Buffer.byteLength(run2.inputTail, "utf8") });
+        run2.inputTail = "";
+        run2.discarding = true;
+      }
       return true;
     },
     close(ch) {
@@ -1943,6 +2033,21 @@ async function credential(params) {
   return { stdout: r.stdout };
 }
 
+// src/rpc/claude.ts
+async function linkSession(params) {
+  let script;
+  try {
+    script = claudeLinkScript(params.transcript_path, params.session_id, params.config_dir);
+  } catch (err) {
+    throw new RpcFailure("invalid", err instanceof Error ? err.message : "invalid config dir");
+  }
+  const r = await sh(script);
+  if (r.timedOut) throw new RpcFailure("timeout", "claude.linkSession timed out");
+  const status4 = parseClaudeLinkStatus(r.stdout);
+  if (r.code !== 0 || !status4) throw new RpcFailure("internal", `claude.linkSession exited with code ${r.code}`);
+  return { status: status4 };
+}
+
 // src/rpc/fs.ts
 function processFailure(method, r) {
   if (r.timedOut) return new RpcFailure("timeout", `${method} timed out`);
@@ -2326,7 +2431,7 @@ async function status3() {
 }
 
 // src/version.ts
-var AGENT_VERSION = "0.5.3";
+var AGENT_VERSION = "0.7.0";
 
 // src/rpc/update.ts
 var PACKAGE = "@termhub/agent";
@@ -2446,6 +2551,7 @@ var handlers = {
   "fs.list": list,
   "fs.mkdir": mkdir2,
   "ai.credential": credential,
+  "claude.linkSession": linkSession,
   "file.paste": pasteFile,
   "hooks.install": install,
   "hooks.uninstall": uninstall,
@@ -2465,7 +2571,7 @@ function detectOs(platform = process.platform) {
   if (platform === "linux") return "linux";
   return null;
 }
-var CAPABILITIES = [CAPABILITY_CLAUDE, CAPABILITY_CLAUDE_SYSTEM_PROMPT];
+var CAPABILITIES = [CAPABILITY_CLAUDE, CAPABILITY_CLAUDE_SYSTEM_PROMPT, CAPABILITY_CLAUDE_STREAM_INPUT];
 function capabilitiesFor(osName) {
   return osName === "macos" ? [...CAPABILITIES, CAPABILITY_SIM] : [...CAPABILITIES];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@termhub/agent",
-  "version": "0.5.3",
+  "version": "0.7.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,