npm - @fengye404/termpilot - Versions diffs - 0.1.1 → 0.1.4 - Mend

@fengye404/termpilot 0.1.1 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/README.md +59 -3
package/app/dist/assets/index-CCXqowYd.css +1 -0
package/app/dist/assets/index-CyNBuXm-.js +20 -0
package/app/dist/index.html +2 -2
package/app/dist/sw.js +1 -1
package/dist/cli.js +244 -15
package/docs/development.md +6 -1
package/package.json +2 -2
package/app/dist/assets/index-CahDnY4p.js +0 -20
package/app/dist/assets/index-nVgFrQ_J.css +0 -1

package/app/dist/index.html CHANGED Viewed

@@ -5,8 +5,8 @@
     <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
     <meta name="theme-color" content="#0f172a" />
     <title>TermPilot</title>
-    <script type="module" crossorigin src="/assets/index-CahDnY4p.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-nVgFrQ_J.css">
+    <script type="module" crossorigin src="/assets/index-CyNBuXm-.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-CCXqowYd.css">
   <link rel="manifest" href="/manifest.webmanifest"><script id="vite-plugin-pwa:register-sw" src="/registerSW.js"></script></head>
   <body class="bg-slate-950">
     <div id="root"></div>

package/app/dist/sw.js CHANGED Viewed

	@@ -1 +1 @@
1	- if(!self.define){let e,s={};const i=(i,n)=>(i=new URL(i+".js",n).href,s[i]\|\|new Promise(s=>{if("document"in self){const e=document.createElement("script");e.src=i,e.onload=s,document.head.appendChild(e)}else e=i,importScripts(i),s()}).then(()=>{let e=s[i];if(!e)throw new Error(`Module ${i} didn’t register its module`);return e}));self.define=(n,r)=>{const t=e\|\|("document"in self?document.currentScript.src:"")\|\|location.href;if(s[t])return;let o={};const c=e=>i(e,t),l={module:{uri:t},exports:o,require:c};s[t]=Promise.all(n.map(e=>l[e]\|\|c(e))).then(e=>(r(...e),o))}}define(["./workbox-1d3d89e3"],function(e){"use strict";self.skipWaiting(),e.clientsClaim(),e.precacheAndRoute([{url:"registerSW.js",revision:"1872c500de691dce40960bb85481de07"},{url:"index.html",revision:"~~f1a3a3f6666c9005d10396510a143f11~~"},{url:"assets/index-~~nVgFrQ_J.css~~",revision:null},{url:"assets/index-~~CahDnY4p~~.js",revision:null},{url:"manifest.webmanifest",revision:"97cf47c913710ef5ce3dc79cf9c7c245"}],{}),e.cleanupOutdatedCaches(),e.registerRoute(new e.NavigationRoute(e.createHandlerBoundToURL("index.html")))});
1	+ if(!self.define){let e,s={};const i=(i,n)=>(i=new URL(i+".js",n).href,s[i]\|\|new Promise(s=>{if("document"in self){const e=document.createElement("script");e.src=i,e.onload=s,document.head.appendChild(e)}else e=i,importScripts(i),s()}).then(()=>{let e=s[i];if(!e)throw new Error(`Module ${i} didn’t register its module`);return e}));self.define=(n,r)=>{const t=e\|\|("document"in self?document.currentScript.src:"")\|\|location.href;if(s[t])return;let o={};const c=e=>i(e,t),d={module:{uri:t},exports:o,require:c};s[t]=Promise.all(n.map(e=>d[e]\|\|c(e))).then(e=>(r(...e),o))}}define(["./workbox-1d3d89e3"],function(e){"use strict";self.skipWaiting(),e.clientsClaim(),e.precacheAndRoute([{url:"registerSW.js",revision:"1872c500de691dce40960bb85481de07"},{url:"index.html",revision:"62d1459fd4ff940e1a94025c3dc4d076"},{url:"assets/index-CyNBuXm-.js",revision:null},{url:"assets/index-CCXqowYd.css",revision:null},{url:"manifest.webmanifest",revision:"97cf47c913710ef5ce3dc79cf9c7c245"}],{}),e.cleanupOutdatedCaches(),e.registerRoute(new e.NavigationRoute(e.createHandlerBoundToURL("index.html")))});

package/dist/cli.js CHANGED Viewed

@@ -5,7 +5,10 @@ import path3 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 // agent/src/cli.ts
+import { spawn as spawn2 } from "child_process";
+import { openSync as openSync2 } from "fs";
 import { cwd as processCwd2 } from "process";
+import { setTimeout as delay2 } from "timers/promises";
 // agent/src/daemon.ts
 import { setTimeout as delay } from "timers/promises";
@@ -44,6 +47,12 @@ function getAgentHome() {
 function getStateFilePath() {
   return path.join(getAgentHome(), "state.json");
 }
+function getAgentRuntimeFilePath() {
+  return path.join(getAgentHome(), "agent-runtime.json");
+}
+function getAgentLogFilePath() {
+  return path.join(getAgentHome(), "agent.log");
+}
 function getStateLockPath() {
   return `${getStateFilePath()}.lock`;
 }
@@ -136,6 +145,36 @@ function updateSession(sid, updater) {
     return nextState;
   });
 }
+function loadAgentRuntime() {
+  ensureAgentHome();
+  try {
+    const raw = readFileSync(getAgentRuntimeFilePath(), "utf8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.pid !== "number" || typeof parsed.relayUrl !== "string" || typeof parsed.deviceId !== "string" || typeof parsed.startedAt !== "string") {
+      return null;
+    }
+    return {
+      pid: parsed.pid,
+      relayUrl: parsed.relayUrl,
+      deviceId: parsed.deviceId,
+      startedAt: parsed.startedAt
+    };
+  } catch {
+    return null;
+  }
+}
+function saveAgentRuntime(runtime) {
+  ensureAgentHome();
+  writeFileSync(getAgentRuntimeFilePath(), `${JSON.stringify(runtime, null, 2)}
+`, "utf8");
+}
+function clearAgentRuntime(expectedPid) {
+  const current = loadAgentRuntime();
+  if (expectedPid !== void 0 && current?.pid !== expectedPid) {
+    return;
+  }
+  rmSync(getAgentRuntimeFilePath(), { force: true });
+}
 // agent/src/tmux-backend.ts
 import { randomUUID as randomUUID2 } from "crypto";
@@ -182,7 +221,7 @@ async function createSession(input = {}) {
   const name = input.name?.trim() || `session-${sid.slice(0, 6)}`;
   const shell = input.shell?.trim() || process.env.SHELL || "/bin/zsh";
   const workingDirectory = input.cwd?.trim() || processCwd();
-  const deviceId = input.deviceId || DEFAULT_DEVICE_ID;
+  const deviceId = input.deviceId?.trim() || process.env.TERMPILOT_DEVICE_ID || DEFAULT_DEVICE_ID;
   const startedAt = now();
   const tmuxSessionName = buildTmuxSessionName(sid, name);
   await runTmux(["new-session", "-d", "-s", tmuxSessionName, "-c", workingDirectory, shell]);
@@ -677,6 +716,11 @@ function printHelp() {
   console.log(`TermPilot agent \u7528\u6CD5\uFF1A
   termpilot agent
+  termpilot agent --foreground
+  termpilot agent status
+  termpilot agent stop
+  termpilot claude code
+  termpilot run -- claude code
   termpilot create --name claude-main --cwd /path/to/project
   termpilot list
   termpilot kill --sid <sid>
@@ -771,6 +815,175 @@ function getDeviceId(argv) {
   const args = parseArgs(argv);
   return resolveDeviceId(typeof args.deviceId === "string" ? args.deviceId : void 0);
 }
+function getRelayUrl() {
+  return process.env.TERMPILOT_RELAY_URL ?? "ws://127.0.0.1:8787/ws";
+}
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function readRuntimeStatus() {
+  const runtime = loadAgentRuntime();
+  if (!runtime) {
+    return { runtime: null, alive: false };
+  }
+  const alive = isProcessAlive(runtime.pid);
+  if (!alive) {
+    clearAgentRuntime(runtime.pid);
+    return { runtime: null, alive: false };
+  }
+  return { runtime, alive };
+}
+async function waitForPairingCode(deviceId) {
+  let lastError = null;
+  for (let attempt = 0; attempt < 12; attempt += 1) {
+    try {
+      return await createPairingCode(deviceId);
+    } catch (error) {
+      lastError = error;
+      await delay2(500);
+    }
+  }
+  if (lastError instanceof Error) {
+    console.warn(`\u540E\u53F0 agent \u5DF2\u542F\u52A8\uFF0C\u4F46\u6682\u65F6\u8FD8\u6CA1\u62FF\u5230\u914D\u5BF9\u7801\uFF1A${lastError.message}`);
+  }
+  return null;
+}
+async function runStart(argv) {
+  const args = parseArgs(argv);
+  if (args.foreground) {
+    await runDaemon();
+    return;
+  }
+  const deviceId = getDeviceId(argv);
+  const relayUrl = getRelayUrl();
+  const existing = readRuntimeStatus();
+  if (existing.runtime && existing.alive) {
+    console.log(`\u540E\u53F0 agent \u5DF2\u5728\u8FD0\u884C\uFF0CPID: ${existing.runtime.pid}`);
+    console.log(`\u8BBE\u5907: ${existing.runtime.deviceId}`);
+    console.log(`relay: ${existing.runtime.relayUrl}`);
+    const pairing2 = await waitForPairingCode(deviceId);
+    if (pairing2) {
+      console.log(`\u914D\u5BF9\u7801: ${pairing2.pairingCode}`);
+      console.log(`\u6709\u6548\u671F\u81F3: ${pairing2.expiresAt}`);
+    }
+    return;
+  }
+  clearAgentRuntime();
+  const logFilePath = getAgentLogFilePath();
+  const logFd = openSync2(logFilePath, "a");
+  const child = spawn2(process.execPath, [process.argv[1], "agent-daemon"], {
+    detached: true,
+    stdio: ["ignore", logFd, logFd],
+    env: process.env
+  });
+  child.unref();
+  if (!child.pid) {
+    throw new Error("\u540E\u53F0 agent \u542F\u52A8\u5931\u8D25\uFF0C\u672A\u83B7\u53D6\u5230\u5B50\u8FDB\u7A0B PID\u3002");
+  }
+  saveAgentRuntime({
+    pid: child.pid,
+    relayUrl,
+    deviceId,
+    startedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  console.log(`\u540E\u53F0 agent \u5DF2\u542F\u52A8\uFF0CPID: ${child.pid}`);
+  console.log(`\u8BBE\u5907: ${deviceId}`);
+  console.log(`relay: ${relayUrl}`);
+  console.log(`\u65E5\u5FD7: ${logFilePath}`);
+  const pairing = await waitForPairingCode(deviceId);
+  if (pairing) {
+    console.log(`\u914D\u5BF9\u7801: ${pairing.pairingCode}`);
+    console.log(`\u6709\u6548\u671F\u81F3: ${pairing.expiresAt}`);
+    console.log("\u624B\u673A\u7AEF\u76F4\u63A5\u6253\u5F00 relay \u9875\u9762\u5E76\u8F93\u5165\u8FD9\u4E2A\u914D\u5BF9\u7801\u5373\u53EF\u3002");
+  }
+}
+function runStatus() {
+  const { runtime, alive } = readRuntimeStatus();
+  if (!runtime || !alive) {
+    console.log("\u540E\u53F0 agent \u5F53\u524D\u672A\u8FD0\u884C\u3002");
+    console.log(`\u72B6\u6001\u76EE\u5F55: ${getAgentHome()}`);
+    console.log(`\u65E5\u5FD7: ${getAgentLogFilePath()}`);
+    return;
+  }
+  const sessions = loadState().sessions.filter((session) => session.deviceId === runtime.deviceId);
+  const runningSessions = sessions.filter((session) => session.status === "running").length;
+  console.log("\u540E\u53F0 agent \u6B63\u5728\u8FD0\u884C\u3002");
+  console.log(`PID: ${runtime.pid}`);
+  console.log(`\u8BBE\u5907: ${runtime.deviceId}`);
+  console.log(`relay: ${runtime.relayUrl}`);
+  console.log(`\u542F\u52A8\u65F6\u95F4: ${runtime.startedAt}`);
+  console.log(`\u65E5\u5FD7: ${getAgentLogFilePath()}`);
+  console.log(`\u4F1A\u8BDD: ${runningSessions} \u4E2A\u8FD0\u884C\u4E2D / ${sessions.length} \u4E2A\u603B\u8BA1`);
+}
+async function runStop() {
+  const { runtime, alive } = readRuntimeStatus();
+  if (!runtime || !alive) {
+    console.log("\u540E\u53F0 agent \u5F53\u524D\u672A\u8FD0\u884C\u3002");
+    clearAgentRuntime();
+    return;
+  }
+  process.kill(runtime.pid, "SIGTERM");
+  for (let attempt = 0; attempt < 20; attempt += 1) {
+    if (!isProcessAlive(runtime.pid)) {
+      clearAgentRuntime(runtime.pid);
+      console.log(`\u540E\u53F0 agent \u5DF2\u505C\u6B62\uFF0CPID: ${runtime.pid}`);
+      return;
+    }
+    await delay2(100);
+  }
+  process.kill(runtime.pid, "SIGKILL");
+  clearAgentRuntime(runtime.pid);
+  console.log(`\u540E\u53F0 agent \u5DF2\u5F3A\u5236\u505C\u6B62\uFF0CPID: ${runtime.pid}`);
+}
+function buildQuickSessionName(commandArgs) {
+  const raw = commandArgs.join("-").trim().toLowerCase();
+  const normalized = raw.replace(/[^a-z0-9_-]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  return normalized.slice(0, 32) || "task";
+}
+async function runManagedCommand(argv) {
+  const commandArgs = argv[0] === "--" ? argv.slice(1) : argv;
+  if (commandArgs.length === 0) {
+    throw new Error("\u8BF7\u5728 termpilot \u540E\u9762\u63D0\u4F9B\u8981\u8FD0\u884C\u7684\u547D\u4EE4\uFF0C\u4F8B\u5982\uFF1Atermpilot claude code");
+  }
+  const session = await createSession({
+    name: buildQuickSessionName(commandArgs),
+    cwd: processCwd2(),
+    deviceId: resolveDeviceId()
+  });
+  console.log(`\u5DF2\u521B\u5EFA\u4F1A\u8BDD ${session.sid} (${session.name})`);
+  await sendInput(session, `${commandArgs.join(" ")}
+`);
+  await attachSession(session);
+}
+async function runDaemon() {
+  await ensureTmuxAvailable();
+  const relayUrl = getRelayUrl();
+  const deviceId = resolveDeviceId();
+  saveAgentRuntime({
+    pid: process.pid,
+    relayUrl,
+    deviceId,
+    startedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  const daemon = createDaemonFromEnv();
+  const stop = () => {
+    void daemon.stop().finally(() => {
+      clearAgentRuntime(process.pid);
+      process.exit(0);
+    });
+  };
+  process.on("SIGINT", stop);
+  process.on("SIGTERM", stop);
+  process.on("exit", () => {
+    clearAgentRuntime(process.pid);
+  });
+  await daemon.start();
+}
 async function runPair(argv) {
   const deviceId = getDeviceId(argv);
   const payload = await createPairingCode(deviceId);
@@ -833,16 +1046,17 @@ async function runAgentCli(argv = process.argv.slice(2)) {
     return;
   }
   switch (command) {
+    case "start":
+      await runStart(rest);
+      return;
+    case "status":
+      runStatus();
+      return;
+    case "stop":
+      await runStop();
+      return;
     case "daemon": {
-      await ensureTmuxAvailable();
-      const daemon = createDaemonFromEnv();
-      process.on("SIGINT", () => {
-        void daemon.stop().finally(() => process.exit(0));
-      });
-      process.on("SIGTERM", () => {
-        void daemon.stop().finally(() => process.exit(0));
-      });
-      await daemon.start();
+      await runDaemon();
       return;
     }
     case "create":
@@ -875,9 +1089,13 @@ async function runAgentCli(argv = process.argv.slice(2)) {
     case "revoke":
       await runRevoke(rest);
       return;
+    case "run":
+      await ensureTmuxAvailable();
+      await runManagedCommand(rest);
+      return;
     default:
-      printHelp();
-      process.exitCode = 1;
+      await ensureTmuxAvailable();
+      await runManagedCommand(argv);
   }
 }
@@ -1883,6 +2101,10 @@ function printHelp2() {
   termpilot relay [--host 0.0.0.0] [--port 8787]
   termpilot agent [--relay ws://127.0.0.1:8787/ws] [--device-id pc-main]
+  termpilot agent status
+  termpilot agent stop
+  termpilot claude code
+  termpilot run -- claude code
   termpilot pair [--device-id pc-main]
   termpilot create --name claude-main [--cwd /path/to/project]
@@ -1935,7 +2157,15 @@ async function main(argv = process.argv.slice(2)) {
     }
     case "agent": {
       const agentArgs = applyEnvFlags(rest, AGENT_ENV_FLAGS);
-      await runAgentCli(agentArgs.length > 0 ? agentArgs : ["daemon"]);
+      if (agentArgs[0] === "status" || agentArgs[0] === "stop" || agentArgs[0] === "daemon") {
+        await runAgentCli(agentArgs);
+      } else {
+        await runAgentCli(["start", ...agentArgs]);
+      }
+      return;
+    }
+    case "agent-daemon": {
+      await runAgentCli(["daemon", ...rest]);
       return;
     }
     case "pair":
@@ -1952,8 +2182,7 @@ async function main(argv = process.argv.slice(2)) {
       return;
     }
     default:
-      printHelp2();
-      process.exitCode = 1;
+      await runAgentCli([command, ...rest]);
   }
 }
 void main().catch((error) => {

package/docs/development.md CHANGED Viewed

@@ -18,6 +18,11 @@ pnpm test:ui-smoke
 pnpm check:stability
 ```
+说明：
+- `pnpm test:ui-smoke` 现在按手机视口跑，覆盖配对、切会话、关闭会话、清除绑定，以及“查看后终端区进入可视区”
+- `pnpm check:stability` 会验证 relay / agent 长时间运行下的输出缓冲和重连一致性
 ## 当前仓库形态
 - 根入口：`src/cli.ts`
@@ -32,7 +37,7 @@ pnpm check:stability
 2. 运行 `pnpm build`
 3. 运行 `pnpm test:ui-smoke`
 4. 运行 `pnpm check:stability`
-5. 执行 `npm publish`
+5. 执行 `npm publish --access public`
 当前已发布包名：

package/package.json CHANGED Viewed

@@ -1,11 +1,11 @@
 {
   "name": "@fengye404/termpilot",
-  "version": "0.1.1",
+  "version": "0.1.4",
   "type": "module",
   "packageManager": "pnpm@10.31.0",
   "description": "一个基于 tmux 的终端会话跨端查看与控制原型。",
   "bin": {
-    "termpilot": "./dist/cli.js"
+    "termpilot": "dist/cli.js"
   },
   "files": [
     "dist",