@konglx/rotom 2.21.0

package/dist/cli/issue.js

@@ -0,0 +1,202 @@
+/**
+ * rotom issue — issue list/show/events/messages/comment/create/update/cancel/delete.
+ */
+import { api, printJson, printTable, fail, flagStr, flagInt, requireFlag, pretty, } from "./common.js";
+import { route, qs, usage, unknownSubcommand } from "./routes.js";
+import { ISSUE_STATUSES } from "../shared/constants.js";
+export async function cmdIssue(agent, rest, flags) {
+    const sub = rest[0];
+    if (sub === "list") {
+        const groupId = rest[1];
+        if (!groupId)
+            usage("issue list", "<groupId> [--status S] [--type task]");
+        const status = flagStr(flags, "status");
+        const type = flagStr(flags, "type");
+        const routePath = `${route("/groups/:groupId/issues", groupId)}${qs({ status, type })}`;
+        const data = await api(agent, "GET", routePath);
+        printTable(data.map((i) => ({
+            id: i.id,
+            type: i.type,
+            status: i.status,
+            priority: i.priority,
+            title: (i.title || "").slice(0, 60),
+        })), ["id", "type", "status", "priority", "title"]);
+        return;
+    }
+    if (sub === "show") {
+        const id = rest[1];
+        if (!id)
+            usage("issue show", "<issueId>");
+        const data = await api(agent, "GET", route("/issues/:id", id));
+        printJson(data);
+        return;
+    }
+    if (sub === "events") {
+        const id = rest[1];
+        if (!id)
+            usage("issue events", "<issueId> [--content-len N] [--no-clean]");
+        const contentLen = flagInt(flags, "content-len") ?? 200;
+        const clean = flags["clean"] !== false;
+        const data = await api(agent, "GET", route("/issues/:id/events", id));
+        printTable(data.map((e) => {
+            let content = (e.content || "").replace(/\s+/g, " ");
+            if (clean) {
+                content = content
+                    .replace(/\[(\w[\w-]*(?::\w[\w-]*)?)\].*?\[\/\1\]/g, "")
+                    .replace(/\s+/g, " ")
+                    .trim();
+            }
+            return {
+                time: e.created_at,
+                type: e.event_type,
+                agent: e.agent_name,
+                content: content.slice(0, contentLen),
+            };
+        }), ["time", "type", "agent", "content"]);
+        return;
+    }
+    if (sub === "messages") {
+        const id = rest[1];
+        if (!id)
+            usage("issue messages", "<issueId>");
+        const data = await api(agent, "GET", route("/issues/:id/messages", id));
+        if (pretty) {
+            printTable(data.map((m) => {
+                const quoted = m.quoted
+                    ? `> ${(m.quoted.agent_name || "").slice(0, 10)}: ${(m.quoted.content || "").slice(0, 30)}`
+                    : "";
+                return {
+                    id: m.id,
+                    type: m.event_type,
+                    agent: m.agent_name,
+                    content: (m.content || "").slice(0, 60),
+                    quoted,
+                    created_at: m.created_at,
+                };
+            }), ["id", "type", "agent", "content", "quoted", "created_at"]);
+        }
+        else {
+            printJson(data);
+        }
+        return;
+    }
+    if (sub === "comment") {
+        const id = rest[1];
+        if (!id)
+            usage("issue comment", "<issueId> --message M [--reply-to <eventId>]");
+        const message = requireFlag(flags, "message");
+        const replyTo = flagInt(flags, "reply-to");
+        const data = await api(agent, "POST", route("/issues/:id/comments", id), {
+            agentName: agent.name, content: message, replyTo: replyTo ?? undefined,
+        });
+        printJson(data);
+        return;
+    }
+    if (sub === "create") {
+        const groupId = rest[1];
+        if (!groupId)
+            usage("issue create", "<groupId> --description D [--title T] [--priority P] [--assignee A] [--approval-policy r_allow|rw_allow] [--run]");
+        const title = flagStr(flags, "title");
+        const description = flagStr(flags, "description") || "";
+        const priority = flagStr(flags, "priority") || "medium";
+        const assignee = flagStr(flags, "assignee");
+        const approvalPolicyRaw = flagStr(flags, "approval-policy");
+        const run = flags.run === true;
+        if (!description && !title) {
+            fail("--description (or --title) is required");
+        }
+        if (approvalPolicyRaw && approvalPolicyRaw !== "r_allow" && approvalPolicyRaw !== "rw_allow") {
+            fail('--approval-policy must be "r_allow" or "rw_allow"');
+        }
+        if (run && !assignee) {
+            fail("--run requires --assignee (cannot start an unassigned issue)");
+        }
+        const body = { description, priority, createdBy: agent.name };
+        if (title)
+            body.title = title;
+        if (approvalPolicyRaw)
+            body.approvalPolicy = approvalPolicyRaw;
+        const created = await api(agent, "POST", route("/groups/:groupId/issues", groupId), body);
+        const issueId = created?.id;
+        if (!issueId) {
+            printJson(created);
+            return;
+        }
+        let assigned = false;
+        let runPushed = null;
+        if (assignee) {
+            await api(agent, "PUT", route("/issues/:id", issueId), { assignedTo: assignee });
+            assigned = true;
+        }
+        if (run) {
+            const prompt = description.trim() || (title || "").trim();
+            runPushed = await api(agent, "POST", route("/issues/:id/append", issueId), {
+                prompt, appendedBy: agent.name,
+            });
+        }
+        printJson({ ...created, assignedTo: assigned ? assignee : null, run: runPushed });
+        return;
+    }
+    if (sub === "update") {
+        const id = rest[1];
+        if (!id)
+            usage("issue update", "<issueId> [--title T] [--description D] [--priority low|medium|high|critical] [--assignee A | --unassign] [--approval-policy r_allow|rw_allow] [--status open|in_progress|completed|failed|cancelled]");
+        const title = flagStr(flags, "title");
+        const description = flagStr(flags, "description");
+        const priority = flagStr(flags, "priority");
+        const assignee = flagStr(flags, "assignee");
+        const unassign = flags.unassign === true;
+        const approvalPolicyRaw = flagStr(flags, "approval-policy");
+        const statusRaw = flagStr(flags, "status");
+        if (assignee !== undefined && unassign) {
+            fail("--assignee and --unassign are mutually exclusive");
+        }
+        if (priority !== undefined && !["low", "medium", "high", "critical"].includes(priority)) {
+            fail(`--priority must be one of low|medium|high|critical (got: ${priority})`);
+        }
+        if (approvalPolicyRaw !== undefined && approvalPolicyRaw !== "r_allow" && approvalPolicyRaw !== "rw_allow") {
+            fail(`--approval-policy must be "r_allow" or "rw_allow" (got: ${approvalPolicyRaw})`);
+        }
+        if (statusRaw !== undefined && !ISSUE_STATUSES.includes(statusRaw)) {
+            fail(`--status must be one of ${ISSUE_STATUSES.join("|")} (got: ${statusRaw})`);
+        }
+        const body = {};
+        if (title !== undefined)
+            body.title = title;
+        if (description !== undefined)
+            body.description = description;
+        if (priority !== undefined)
+            body.priority = priority;
+        if (assignee !== undefined)
+            body.assignedTo = assignee;
+        if (unassign)
+            body.assignedTo = null;
+        if (approvalPolicyRaw !== undefined)
+            body.approvalPolicy = approvalPolicyRaw;
+        if (statusRaw !== undefined)
+            body.status = statusRaw;
+        if (Object.keys(body).length === 0) {
+            fail("no fields to update — pass at least one flag");
+        }
+        const data = await api(agent, "PUT", route("/issues/:id", id), body);
+        printJson(data);
+        return;
+    }
+    if (sub === "cancel") {
+        const id = rest[1];
+        if (!id)
+            usage("issue cancel", "<issueId>");
+        const data = await api(agent, "PUT", route("/issues/:id", id), { status: "cancelled" });
+        printJson(data);
+        return;
+    }
+    if (sub === "delete") {
+        const id = rest[1];
+        if (!id)
+            usage("issue delete", "<issueId>");
+        const data = await api(agent, "DELETE", route("/issues/:id", id));
+        printJson(data);
+        return;
+    }
+    unknownSubcommand("issue", sub);
+}

package/dist/cli/join.js

@@ -0,0 +1,170 @@
+/**
+ * rotom join — 首次申请 token 落盘到 ~/.rotom/
+ *
+ * 给"本地交互式 codex 作为 mesh host"模式用:本机不跑 executor daemon,
+ * codex 直接通过 Bash 调 rotom CLI 与 mesh 交互。本命令一次性完成:
+ *   1. POST http://<master>/api/agents { name, domain } → 拿到 plaintext token + configTemplate
+ *   2. 落盘 configTemplate 到 ~/.rotom/agents/<name>.json(resolveAgentFromEntry 直接能读)
+ *   3. 在 ~/.rotom/config.json 的 agents[name] 注册一条 { configPath, kind: "openclaw" }
+ *   4. 若 defaultAgent 未设 → 设为 name
+ *
+ * 之后 codex 通过 Bash 调 `rotom ...`(用 defaultAgent)或 `rotom --as <name> ...`,
+ * resolveAgent 自动从本地文件解出 master+token,executor daemon 完全不用起。
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { ROTOM_HOME, fail, flagStr, printJson, } from "./common.js";
+import { masterFetch, masterHttpBase, masterWsBase } from "./routes.js";
+const DEFAULT_PORT = 28800;
+function parseMasterSpec(spec) {
+    let s = spec.trim().replace(/^ws:\/\//, "").replace(/^wss:\/\//, "").replace(/^https?:\/\//, "");
+    s = s.replace(/\/+$/, "");
+    let host = s;
+    let port = DEFAULT_PORT;
+    const colon = s.lastIndexOf(":");
+    if (colon !== -1 && /^\d+$/.test(s.slice(colon + 1))) {
+        host = s.slice(0, colon);
+        port = parseInt(s.slice(colon + 1), 10);
+    }
+    if (!host)
+        fail(`invalid master spec: ${spec}`);
+    return { host, port, httpUrl: masterHttpBase(host, port), wsUrl: masterWsBase(host, port) };
+}
+const VALID_CLI_TOOLS = ["claude", "codex", "hermes", "openclaw"];
+function detectCliTool() {
+    // 跟 rotom init 的 detectCliTools 同款逻辑,但只返回第一个命中的。
+    for (const tool of VALID_CLI_TOOLS) {
+        try {
+            const { execSync } = require("node:child_process");
+            const p = execSync(`command -v ${tool}`, { stdio: ["ignore", "pipe", "ignore"] }).toString().trim();
+            if (p)
+                return tool;
+        }
+        catch { /* not installed */ }
+    }
+    return null;
+}
+export async function cmdJoin(rest, flags) {
+    const masterSpec = rest[0];
+    if (!masterSpec) {
+        fail("usage: rotom join <masterHost:port> --name <agentName> --domain <domain>\n" +
+            "                            --cli-tool <claude|codex|hermes|openclaw> [--working-dir PATH]\n" +
+            "                            [--profile-position P] [--profile-bio B] [--force]\n" +
+            "  首次申请 token 落盘到 ~/.rotom/。一个机器一个 CLI 一个 agent:每次换 CLI 用不同\n" +
+            "  --name + --cli-tool 注册,之后 `rotom --as <name> ...` 自动解出 master+token+cliTool。");
+    }
+    const name = flagStr(flags, "name");
+    const domain = flagStr(flags, "domain");
+    if (!name)
+        fail("--name is required (the agent name you want to register on master)");
+    if (!domain)
+        fail("--domain is required (use an existing domain on master; see dashboard)");
+    let cliToolRaw = flagStr(flags, "cli-tool");
+    if (!cliToolRaw) {
+        cliToolRaw = detectCliTool() ?? "";
+        if (!cliToolRaw) {
+            fail(`--cli-tool not given and auto-detect failed (none of ${VALID_CLI_TOOLS.join(",")} found in PATH)`);
+        }
+        process.stderr.write(`[rotom] --cli-tool not given, auto-detected: ${cliToolRaw}\n`);
+    }
+    if (!VALID_CLI_TOOLS.includes(cliToolRaw)) {
+        fail(`--cli-tool must be one of ${VALID_CLI_TOOLS.join("|")} (got: ${cliToolRaw})`);
+    }
+    const cliTool = cliToolRaw;
+    const workingDir = flagStr(flags, "working-dir") || process.cwd();
+    const profilePosition = flagStr(flags, "profile-position");
+    const profileBio = flagStr(flags, "profile-bio");
+    const profile = {};
+    if (profilePosition)
+        profile.position = profilePosition;
+    if (profileBio)
+        profile.bio = profileBio;
+    const force = flags.force === true;
+    const { httpUrl, wsUrl } = parseMasterSpec(masterSpec);
+    const cfgPath = path.join(ROTOM_HOME, "config.json");
+    const cfgExists = fs.existsSync(cfgPath);
+    if (cfgExists) {
+        // 读取已有 config 检查重名
+        try {
+            const existing = JSON.parse(fs.readFileSync(cfgPath, "utf-8"));
+            if (existing.agents?.[name] && !force) {
+                fail(`agent "${name}" already registered in ${cfgPath}.\n` +
+                    `  重新申请 token(旧 token 作废)请加 --force。`);
+            }
+        }
+        catch {
+            // 配置文件损坏 → 当作不存在,继续
+        }
+    }
+    // 1. POST /api/agents 申请 token
+    const registerUrl = `${httpUrl}/api/agents`;
+    let resp;
+    try {
+        resp = await masterFetch(registerUrl, {
+            method: "POST",
+            body: JSON.stringify({ name, domain }),
+        });
+    }
+    catch (e) {
+        fail(`failed to reach master at ${httpUrl}: ${e.message}\n  run \`rotom status\` to verify reachability`);
+    }
+    const { status, data: rawData } = resp;
+    const text = rawData === null ? "" : typeof rawData === "string" ? rawData : JSON.stringify(rawData);
+    const data = rawData;
+    if (status < 200 || status >= 300) {
+        const detail = typeof data === "object" && data?.error ? data.error : text;
+        fail(`master rejected agent registration (HTTP ${status}): ${detail}`);
+    }
+    const token = data?.token;
+    const agentId = data?.id;
+    if (!token || !agentId) {
+        fail(`master did not return token/id in registration response: ${text}`);
+    }
+    // 2. 落盘到 ~/.rotom/agents/<name>.json —— 扁平结构,对齐 executor.config.json
+    //    workers[] 单条 entry + master 字段。{ master, name, token, cliTool, workingDir, profile }
+    const agentsDir = path.join(ROTOM_HOME, "agents");
+    fs.mkdirSync(agentsDir, { recursive: true });
+    const agentFile = path.join(agentsDir, `${name}.json`);
+    const agentConfig = {
+        master: wsUrl,
+        name,
+        token,
+        cliTool,
+        workingDir,
+    };
+    if (Object.keys(profile).length > 0)
+        agentConfig.profile = profile;
+    fs.writeFileSync(agentFile, JSON.stringify(agentConfig, null, 2));
+    // 3. 写 ~/.rotom/config.json 的 agents[name] = { configPath, kind: "local" }
+    fs.mkdirSync(ROTOM_HOME, { recursive: true });
+    let cfg = {};
+    if (cfgExists) {
+        try {
+            cfg = JSON.parse(fs.readFileSync(cfgPath, "utf-8"));
+        }
+        catch { /* 损坏则覆盖 */ }
+    }
+    if (!cfg.agents || typeof cfg.agents !== "object")
+        cfg.agents = {};
+    cfg.agents[name] = {
+        configPath: agentFile,
+        kind: "local",
+    };
+    // 4. 若 defaultAgent 未设 → 设为 name
+    let defaultSet = false;
+    if (!cfg.defaultAgent) {
+        cfg.defaultAgent = name;
+        defaultSet = true;
+    }
+    fs.writeFileSync(cfgPath, JSON.stringify(cfg, null, 2));
+    printJson({
+        id: agentId,
+        name,
+        master: wsUrl,
+        cliTool,
+        workingDir,
+        configFile: agentFile,
+        defaultAgent: defaultSet ? name : "(unchanged)",
+        hint: `验证: rotom whoami   # 应显示 ${name}`,
+    });
+}

package/dist/cli/link.js

@@ -0,0 +1,47 @@
+/**
+ * rotom link — link daemon CLI 入口。
+ *
+ *   rotom link join <coordEndpoint> [--hostname <name>]   一次性:probe coord,生成 masterId,写 link.json
+ *   rotom link start [--port N]                            启动 daemon(读 ~/.rotom/link.json)
+ *   rotom link stop                                        停 daemon
+ *   rotom link restart                                     重启
+ *   rotom link status                                      查状态(含 /health 探活)
+ *   rotom link logs                                        打印最近 200 行日志
+ *
+ * link.json 持久化 masterId(永不改),hostname 可改(--hostname 覆盖)。
+ */
+import os from "node:os";
+import { fail, flagStr, runShellScript } from "./common.js";
+import { linkJoin } from "../link/server.js";
+export async function cmdLink(rest, flags) {
+    const sub = rest[0];
+    if (!sub) {
+        fail("usage: rotom link <join|start|stop|restart|status|logs> [args]\n" +
+            "  join <coordEndpoint> [--hostname <name>]   生成 masterId + 写 link.json (一次性)\n" +
+            "  start [--port N]                          启动 link daemon (默认端口 28900)\n" +
+            "  stop / restart / status / logs");
+    }
+    const args = rest.slice(1);
+    switch (sub) {
+        case "join": {
+            const coordEndpoint = args[0];
+            if (!coordEndpoint) {
+                fail("usage: rotom link join <coordEndpoint> [--hostname <name>]\n  e.g. ws://192.168.1.5:28800");
+            }
+            const hostname = flagStr(flags, "hostname") || process.env.ROTOM_HOSTNAME || os.hostname();
+            await linkJoin(coordEndpoint, hostname);
+            process.stdout.write(`✅ joined. link.json written. Run \`rotom link start\` to launch the daemon.\n`);
+            return;
+        }
+        case "start":
+        case "stop":
+        case "restart":
+        case "status":
+        case "logs": {
+            const code = await runShellScript("bin/rotom-link.sh", [sub, ...args]);
+            process.exit(code);
+        }
+        default:
+            fail(`unknown link subcommand: ${sub}\nRun 'rotom link' for usage.`);
+    }
+}

package/dist/cli/master.js

@@ -0,0 +1,51 @@
+/**
+ * rotom master — master lifecycle control (start|stop|restart|status).
+ */
+import { fail, flagStr, runShellScript } from "./common.js";
+import { usage } from "./routes.js";
+/**
+ * Accept `master:start` colon alias, expand to [`start`, ...rest].
+ */
+function colonExpand(cmd, rest) {
+    const colon = cmd.indexOf(":");
+    if (colon === -1)
+        return rest;
+    return [cmd.slice(colon + 1), ...rest];
+}
+export { colonExpand };
+export async function cmdMaster(rest, flags) {
+    const sub = rest[0];
+    const args = [];
+    switch (sub) {
+        case "start":
+        case "stop":
+        case "status":
+        case "restart":
+            args.push(sub);
+            break;
+        default:
+            usage("master", "<start|stop|status|restart> [--daemon] [--port N] [--host A] [--data D] [--dev]\n" +
+                "       (also accepts colon form: rotom master:start | master:stop | master:status | master:restart)");
+    }
+    if (flags.daemon === true && (sub === "start" || sub === "restart"))
+        args.push("--daemon");
+    if (flags.dev === true && sub === "start")
+        args.push("--dev");
+    const port = flagStr(flags, "port");
+    if (port && sub === "start")
+        args.push("--port", port);
+    const host = flagStr(flags, "host");
+    if (host && sub === "start")
+        args.push("--host", host);
+    const data = flagStr(flags, "data");
+    if (data && sub === "start")
+        args.push("--data", data);
+    let code;
+    try {
+        code = await runShellScript("bin/mesh-master.sh", args);
+    }
+    catch (e) {
+        fail(`failed to invoke bin/mesh-master.sh: ${e.message}`);
+    }
+    process.exit(code);
+}