@iamlbccc/tdxd 1.1.0

package/lib/ui.mjs

@@ -0,0 +1,102 @@
+// 零依赖交互式提示（跨平台）：ask / confirm / select
+// TTY：方向键选择；非 TTY（管道/CI）：自动降级为编号输入
+import readline from "node:readline";
+import readlinePromises from "node:readline/promises";
+import { once } from "node:events";
+import process from "node:process";
+
+const isTTY = process.stdin.isTTY && process.stdout.isTTY;
+const C = { cyan: (s) => `\x1b[36m${s}\x1b[0m`, green: (s) => `\x1b[32m${s}\x1b[0m`, dim: (s) => `\x1b[2m${s}\x1b[0m`, bold: (s) => `\x1b[1m${s}\x1b[0m` };
+
+export function out(s = "") { process.stdout.write(s + "\n"); }
+
+// TTY：共享单个 readline 逐问读取
+let sharedRl = null;
+function getRl() {
+  return sharedRl ??= readlinePromises.createInterface({ input: process.stdin, output: process.stdout });
+}
+export function closePrompt() { sharedRl?.close(); sharedRl = null; }
+
+// 非TTY（管道/CI）：readline 管道模式在首个应答后会暂停输入流，顺序提问必挂；
+// 改为启动即挂常驻 line 监听，一次性收完全部输入，提问从队列按序取
+let lineQueue = null;
+let queueReady = null;
+function warmupNonTty() {
+  if (!queueReady) {
+    const lines = [];
+    const rl = readline.createInterface({ input: process.stdin, terminal: false });
+    rl.on("line", (l) => lines.push(l));
+    queueReady = once(rl, "close").then(() => { lineQueue = lines; });
+  }
+  return queueReady;
+}
+
+async function question(prompt) {
+  if (!isTTY) {
+    process.stdout.write(prompt);
+    await warmupNonTty();
+    return (lineQueue.shift() ?? "").trim();
+  }
+  const rl = getRl();
+  try { return ((await rl.question(prompt)) ?? "").trim(); }
+  catch { return ""; }
+}
+
+export async function ask(message, def = "") {
+  const suffix = def !== "" && def != null ? C.dim(` (${def})`) : "";
+  const v = await question(`${C.cyan("?")} ${message}${suffix}: `);
+  return v === "" ? String(def ?? "") : v;
+}
+
+export async function confirm(message, def = true) {
+  const hint = def ? "Y/n" : "y/N";
+  const v = (await question(`${C.cyan("?")} ${message} ${C.dim(`(${hint})`)}: `)).toLowerCase();
+  if (v === "") return def;
+  return v.startsWith("y");
+}
+
+/** 选项选择：TTY 用 ↑↓+回车；非 TTY 用编号。返回 { value, label } */
+export async function select(message, options, defIndex = 0) {
+  if (!isTTY) {
+    out(`${C.cyan("?")} ${message}`);
+    options.forEach((o, i) => out(`  ${C.bold(i + 1)}. ${o.label}${o.description ? C.dim(`  — ${o.description}`) : ""}`));
+    const v = await question(`  输入编号 ${C.dim(`[1-${options.length}, 默认 ${defIndex + 1}]`)}: `);
+    const i = Number(v) - 1;
+    return options[Number.isInteger(i) && i >= 0 && i < options.length ? i : defIndex];
+  }
+  return new Promise((resolve) => {
+    let idx = defIndex;
+    const render = () => {
+      readline.cursorTo(process.stdout, 0, 0);
+      readline.clearScreenDown(process.stdout);
+      out(`${C.cyan("?")} ${message} ${C.dim("(↑↓ 选择, 回车确认)")}`);
+      options.forEach((o, i) => out(`  ${i === idx ? C.green("❯") : " "} ${i === idx ? C.green(o.label) : o.label}${o.description ? C.dim(`  — ${o.description}`) : ""}`));
+    };
+    readline.emitKeypressEvents(process.stdin);
+    process.stdin.setRawMode(true);
+    const rawCols = process.stdout.columns;
+    process.stdout.rows = options.length + 2;
+    if (!rawCols) process.stdout.columns = 80;
+    render();
+    process.stdin.resume();
+    const onData = (_, key) => {
+      if (key.name === "up") { idx = (idx - 1 + options.length) % options.length; render(); }
+      else if (key.name === "down") { idx = (idx + 1) % options.length; render(); }
+      else if (key.name === "return" || key.name === "space") {
+        cleanup(); resolve(options[idx]);
+      } else if (key.name === "c" && key.ctrl) {
+        cleanup(); process.exit(130);
+      } else if (key.sequence === "3") { /* 忽略 */ }
+    };
+    const origCols = rawCols;
+    function cleanup() {
+      process.stdin.removeListener("keypress", onData);
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+      process.stdout.columns = origCols;
+      readline.cursorTo(process.stdout, 0, options.length + 1);
+      out(C.dim(`  已选: ${options[idx].label}`));
+    }
+    process.stdin.on("keypress", onData);
+  });
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@iamlbccc/tdxd",
+  "version": "1.1.0",
+  "description": "TDX-Daemon — remote daemon for Paperclip TDX-Adapter: drives ACP agents (opencode) with session-per-process, permission approval loop, usage metering; ships cross-platform tdxd-ctl (init/scaffold/start/stop/status)",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=24"
+  },
+  "bin": {
+    "tdxd": "./tdxd.mjs",
+    "tdxd-ctl": "./tdxd-ctl.mjs"
+  },
+  "files": [
+    "tdxd.mjs",
+    "tdxd-ctl.mjs",
+    "lib/",
+    "config.example.json",
+    "README.md"
+  ],
+  "keywords": [
+    "paperclip",
+    "acp",
+    "agent",
+    "opencode",
+    "daemon",
+    "cli"
+  ]
+}

package/tdxd-ctl.mjs

@@ -0,0 +1,257 @@
+#!/usr/bin/env node
+// tdxd-ctl（Node 跨平台版）—— TDX-Daemon 实例管理器
+// 布局（agent-first）：$TDXD_HOME/agents/<name>/{config.json, secret.env, log/tdxd.log, run/pid}
+// 命令：init | list | start | stop | restart | status  [name|all]
+// init 支持交互式（TTY 方向键选择）；非 TTY / --yes 降级为默认值，可脚本化
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import crypto from "node:crypto";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { ask, confirm, select, out, closePrompt } from "./lib/ui.mjs";
+import { configTpl, opencodeJsonTpl, agentsMdTpl } from "./lib/tpl.mjs";
+
+const HOME = process.env.TDXD_HOME || path.join(os.homedir(), ".tdx");
+const AGENTS_DIR = path.join(HOME, "agents");
+const DAEMON_BIN = path.join(path.dirname(fileURLToPath(import.meta.url)), "tdxd.mjs");
+
+const NAME_RE = /^[a-z0-9][a-z0-9-]*$/;
+
+// ---------- 基础设施 ----------
+function listAgents() {
+  if (!fs.existsSync(AGENTS_DIR)) return [];
+  return fs.readdirSync(AGENTS_DIR)
+    .map((name) => {
+      const dir = path.join(AGENTS_DIR, name);
+      const cfgPath = path.join(dir, "config.json");
+      if (!fs.statSync(dir).isDirectory() || !fs.existsSync(cfgPath)) return null;
+      try { return { name, dir, cfgPath, cfg: JSON.parse(fs.readFileSync(cfgPath, "utf8")) }; }
+      catch { return { name, dir, cfgPath, cfg: null }; }
+    })
+    .filter(Boolean);
+}
+
+function pick(target) {
+  const agents = listAgents();
+  if (agents.length === 0) { out(`[ctl] 无实例（${AGENTS_DIR}/agents? 查 ${AGENTS_DIR}）`); process.exit(0); }
+  if (target === "all") return agents;
+  const a = agents.find((x) => x.name === target);
+  if (!a) { out(`[ctl] ✗ 未找到实例 "${target}"。现有: ${agents.map((x) => x.name).join(", ")}`); process.exit(1); }
+  return [a];
+}
+
+function readSecret(dir) {
+  const f = path.join(dir, "secret.env");
+  const sec = {};
+  if (fs.existsSync(f)) {
+    for (const line of fs.readFileSync(f, "utf8").split("\n")) {
+      const m = line.match(/^([A-Z_][A-Z0-9_]*)=(.*)$/);
+      if (m) sec[m[1]] = m[2];
+    }
+  }
+  return sec;
+}
+
+function pidFile(a) { return path.join(a.dir, "run", "pid"); }
+
+function pidOf(a) {
+  try {
+    const pid = Number(fs.readFileSync(pidFile(a), "utf8").trim());
+    if (!Number.isInteger(pid) || pid <= 0) return null;
+    process.kill(pid, 0); // 存活探测（权限/不存在都会 throw）
+    return pid;
+  } catch (e) { if (e.code === "EPERM") return Number(fs.readFileSync(pidFile(a), "utf8")); return null; }
+}
+
+async function healthOf(a, timeoutMs = 2500) {
+  const sec = readSecret(a.dir);
+  if (!sec.TDXD_TOKEN || !a.cfg?.port) return { code: 0, err: "缺 token/port" };
+  try {
+    const r = await fetch(`http://127.0.0.1:${a.cfg.port}/health`, {
+      headers: { authorization: `Bearer ${sec.TDXD_TOKEN}` },
+      signal: AbortSignal.timeout(timeoutMs),
+    });
+    const j = await r.json().catch(() => null);
+    return { code: r.status, json: j };
+  } catch { return { code: 0, err: "不可达" }; }
+}
+
+function lanIp() {
+  for (const ifaces of Object.values(os.networkInterfaces())) {
+    for (const i of ifaces ?? []) {
+      if (i.family === "IPv4" && !i.internal) return i.address;
+    }
+  }
+  return "127.0.0.1";
+}
+
+function suggestPort() {
+  const used = new Set(listAgents().map((a) => a.cfg?.port).filter(Boolean));
+  for (let p = 18200; p < 18300; p++) if (!used.has(p)) return p;
+  return 18300;
+}
+
+// ---------- init ----------
+async function cmdInit(flags, positionalName) {
+  out();
+  out("\x1b[1mTDX-Daemon Agent 初始化\x1b[0m");
+  out("\x1b[2m──────────────────────────\x1b[0m");
+  const y = flags.yes;
+
+  let name = flags.name || positionalName;
+  if (!name && !y) name = await ask("Agent 标识（slug，小写字母/数字/-）");
+  if (!name) { out("[ctl] ✗ 缺 name（--name 或位置参数，或交互输入）"); process.exit(1); }
+  if (!NAME_RE.test(name)) { out(`[ctl] ✗ 非法 name "${name}"（须匹配 ${NAME_RE}）`); process.exit(1); }
+  const dir = path.join(AGENTS_DIR, name);
+  if (fs.existsSync(path.join(dir, "config.json")) && !flags.force) {
+    out(`[ctl] ✗ 实例已存在：${dir}（--force 覆盖）`); process.exit(1);
+  }
+
+  const displayName = flags.display || (y ? name : await ask("显示名", name));
+  const persona = flags.persona || (y ? "coder" : (await select("角色模板", [
+    { value: "coder", label: "开发工程师", description: "读码-改动-验证-汇报" },
+    { value: "manager", label: "团队负责人", description: "拆任务/分派/跟踪/汇总" },
+    { value: "qa", label: "测试工程师", description: "用例设计/如实报告" },
+    { value: "blank", label: "空白模板", description: "自己写 AGENTS.md" },
+  ])).value);
+  const model = flags.model || (y ? "kimi-for-coding/kimi-for-coding" : await ask("模型（provider/model）", "kimi-for-coding/kimi-for-coding"));
+  const homeWs = path.join(os.homedir(), "workspaces", name);
+  const workspace = path.resolve(flags.workspace || (y ? homeWs : await ask("workspace 路径", homeWs)));
+  const port = Number(flags.port || (y ? suggestPort() : Number(await ask("端口", String(suggestPort())))));
+  const url = flags.url || (y ? "http://127.0.0.1:3100" : await ask("Paperclip 平台地址", "http://127.0.0.1:3100"));
+
+  let token = flags.token;
+  if (!token) {
+    const auto = y ? true : await confirm("自动生成共享 token?", true);
+    token = auto ? `tok-${crypto.randomBytes(16).toString("hex")}` : await ask("自定义 token");
+    if (!token) { out("[ctl] ✗ token 不能为空"); process.exit(1); }
+  }
+
+  // 落盘
+  fs.mkdirSync(path.join(dir, "log"), { recursive: true });
+  fs.mkdirSync(path.join(dir, "run"), { recursive: true });
+  fs.writeFileSync(path.join(dir, "config.json"), configTpl({ name, displayName, port, workspace, model, url }));
+  fs.writeFileSync(path.join(dir, "secret.env"), `TDXD_TOKEN=${token}\n# 平台回调用 agent key（UI 铸造后填入，选填）\n# TDXD_PAPERCLIP_KEY=pcp_xxx\n`, { mode: 0o600 });
+  fs.mkdirSync(path.join(workspace, ".opencode"), { recursive: true });
+  const oc = path.join(workspace, ".opencode", "opencode.json");
+  if (!fs.existsSync(oc)) fs.writeFileSync(oc, opencodeJsonTpl(model));
+  const am = path.join(workspace, "AGENTS.md");
+  if (!fs.existsSync(am)) fs.writeFileSync(am, agentsMdTpl(persona, displayName));
+
+  out();
+  out("\x1b[32m✓ 实例就绪\x1b[0m");
+  out(`  ${dir}`);
+  out(`  ${workspace}`);
+  out();
+  out("\x1b[1m接下来：\x1b[0m");
+  out(`  1. 启动并自检:   \x1b[36mtdxd-ctl start ${name} && tdxd-ctl status ${name}\x1b[0m`);
+  out("  2. 平台 UI hire Agent（TDX-Adapter），粘贴以下参数：");
+  out(`     adapterType:  tdx_adapter`);
+  out(`     endpoint:     http://${lanIp()}:${port}`);
+  out(`     \x1b[33mtoken:        ${token}\x1b[0m \x1b[2m(明文只显示这一次)\x1b[0m`);
+  out(`  3. 验收三步: /health 探活 → 真实唤醒一轮 → 第二轮日志确认 resume=true`);
+}
+
+// ---------- 生命周期 ----------
+function startOne(a) {
+  const pid = pidOf(a);
+  if (pid) {
+    out(`[ctl] ${a.name} 已在运行（pid ${pid}）`);
+    return "running";
+  }
+  const sec = readSecret(a.dir);
+  if (!sec.TDXD_TOKEN) { out(`[ctl] ✗ ${a.name} 缺 secret.env TDXD_TOKEN`); return false; }
+  if (!fs.existsSync(a.cfg.workspace)) { out(`[ctl] ✗ ${a.name} workspace 不存在: ${a.cfg.workspace}`); return false; }
+  fs.mkdirSync(path.dirname(pidFile(a)), { recursive: true });
+  const logFd = fs.openSync(path.join(a.dir, "log", "tdxd.log"), "a");
+  const child = spawn(process.execPath, [DAEMON_BIN, "--config", a.cfgPath], {
+    detached: true, stdio: ["ignore", logFd, logFd], windowsHide: true,
+    env: { ...process.env, ...sec },
+  });
+  child.unref();
+  fs.writeFileSync(pidFile(a), String(child.pid));
+  return "started";
+}
+
+async function waitHealth(a, ms = 15000) {
+  const t0 = Date.now();
+  while (Date.now() - t0 < ms) {
+    const h = await healthOf(a);
+    if (h.code === 200) return h;
+    await new Promise((r) => setTimeout(r, 800));
+  }
+  return { code: 0 };
+}
+
+async function stopOneAsync(a) {
+  const pid = pidOf(a);
+  if (!pid) { out(`[ctl] ${a.name} 无 pid 记录（未运行或由旧方式启动）`); return; }
+  try { process.kill(pid, "SIGTERM"); } catch { /* 已退 */ }
+  for (let i = 0; i < 25; i++) {
+    try { process.kill(pid, 0); } catch { break; }
+    await new Promise((r) => setTimeout(r, 200));
+  }
+  try { process.kill(pid, 0); process.kill(pid, "SIGKILL"); } catch { /* 已退 */ }
+  try { fs.unlinkSync(pidFile(a)); } catch { /* 无 */ }
+  out(`[ctl] ✓ ${a.name} 已停止`);
+}
+
+async function cmdStart(target) {
+  let ok = true;
+  for (const a of pick(target)) {
+    const r = startOne(a);
+    if (r === "running") continue;
+    if (!r) { ok = false; continue; }
+    const h = await waitHealth(a);
+    if (h.code === 200) out(`[ctl] ✓ ${a.name} 启动成功 :${a.cfg.port}（日志 ${path.join(a.dir, "log", "tdxd.log")}）`);
+    else { out(`[ctl] ✗ ${a.name} 健康检查未过（health=${h.code}），查日志: tail -20 ${path.join(a.dir, "log", "tdxd.log")}`); ok = false; }
+  }
+  if (!ok) process.exitCode = 1;
+}
+
+async function cmdRestart(target) {
+  for (const a of pick(target)) await stopOneAsync(a);
+  await cmdStart(target);
+}
+
+async function cmdStatus(target) {
+  for (const a of pick(target)) {
+    const pid = pidOf(a);
+    const h = await healthOf(a, 2000);
+    const sec = readSecret(a.dir);
+    const cb = sec.TDXD_PAPERCLIP_KEY ? "回调:启用" : "回调:未配置⚠";
+    const run = pid ? `运行(pid ${pid})` : "停";
+    const ver = h.json?.version ? ` v${h.json.version}` : "";
+    out(`${a.name}: ${run} | :${a.cfg?.port ?? "?"} health=${h.code}${ver} | ${cb}`);
+  }
+}
+
+// ---------- 入口 ----------
+function parseFlags(argv) {
+  const flags = {};
+  for (let i = 0; i < argv.length; i++) {
+    if (!argv[i].startsWith("--")) continue;
+    const k = argv[i].slice(2);
+    const boolOnly = ["yes", "force"];
+    if (boolOnly.includes(k)) flags[k] = true;
+    else flags[k] = argv[i + 1]?.startsWith("--") ? true : argv[++i];
+  }
+  return flags;
+}
+
+const [cmd = "status", targetArg, ...rest] = process.argv.slice(2);
+const target = targetArg ?? "all"; // init 场景须用 targetArg（可能为 undefined），不能吃这个默认值
+const flags = parseFlags(rest);
+switch (cmd) {
+  case "init": try { await cmdInit(flags, targetArg); } finally { closePrompt(); } break;
+  case "list": for (const a of listAgents()) out(`${a.name}\t:${a.cfg?.port}\t${a.cfg?.workspace}`); break;
+  case "start": await cmdStart(target); break;
+  case "stop": for (const a of pick(target)) await stopOneAsync(a); break;
+  case "restart": await cmdRestart(target); break;
+  case "status": await cmdStatus(target); break;
+  default:
+    out("用法: tdxd-ctl init|list|start|stop|restart|status [name|all] [--yes --name --display --workspace --model --persona --port --token --url --force]");
+    out(`实例目录: ${AGENTS_DIR}`);
+    process.exit(1);
+}