@social-data/social-neuron-user-query 0.0.0-stage → 1.0.0-beta.1

package/bin/cli.js

@@ -0,0 +1,277 @@
+#!/usr/bin/env node
+"use strict";
+
+// ⚠️ 本文件由 core/cli/gen.py 生成,请勿手改;要改改 gen.py 的 _CLI_JS 后重跑 gen。
+//
+// 能力 CLI —— 通用薄运行时(纯 JS,零依赖):一能力一命令、一包、一配置文件,互不影响。
+//   <cmd> <action> [--flags]                       调用一条命令
+//   <cmd> [-h] / <cmd> <action> -h                 帮助
+//   <cmd> bind --api-url <url> --token <token>     写 ~/.social-neuron/<key>_config.json
+//   <cmd> bind --logout                            删除该配置文件
+//   <cmd> skills install [dir]                     覆盖写入 SKILL.md
+// 能力 key / 命令名全部来自同包 manifest.json(见 CAPABILITY / COMMAND);换能力只改 manifest。
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+const MANIFEST = require(path.join(__dirname, "..", "manifest.json"));
+const VERSION = require(path.join(__dirname, "..", "package.json")).version;
+const CAPABILITY = MANIFEST.capability;                                 // ← 能力 key(来自 manifest)
+const COMMAND = MANIFEST.command || ("social-neuron-" + CAPABILITY);    // ← 命令名(来自 manifest)
+
+const EXIT = { auth_error: 3, validation: 2, config: 2, network: 4, outdated: 2 };
+
+// 配置:一能力一文件 ~/.social-neuron/<key>_config.json,扁平 {api_url, token}(不区分环境)。
+function configPath() {
+  const dir = process.env.NEURON_CONFIG_DIR || path.join(os.homedir(), ".social-neuron");
+  return path.join(dir, CAPABILITY + "_config.json");
+}
+function resolveConfig() {
+  let api = process.env.NEURON_API_BASE_URL || "";
+  let token = process.env.NEURON_TOKEN || "";
+  try {
+    const cfg = JSON.parse(fs.readFileSync(configPath(), "utf8"));
+    api = api || cfg.api_url || "";
+    token = token || cfg.token || "";
+  } catch (_e) { /* 无配置文件:仅用 env */ }
+  return { api: api.replace(/\/+$/, ""), token };
+}
+
+function emit(env) {
+  process.stdout.write(JSON.stringify(env) + "\n");
+  const dataExit = env.ok && env.data && env.data.meta && env.data.meta.exit_code;
+  const status = env.ok
+    ? ([0, 1, 2].includes(dataExit) ? dataExit : 0)
+    : (EXIT[env.error && env.error.type] ?? 1);
+  process.exit(status);
+}
+function fail(type, code, message, extra) {
+  emit({ ok: false, error: { type, code, message, ...(extra || {}) } });
+}
+
+// 网关统一 {code,msg,data}(code=0 成功)→ 归一化 {ok,data|error}。
+function forgeType(code) {
+  const s = String(code);
+  if (s.startsWith("401") || s.startsWith("403")) return "auth_error";
+  if (s.startsWith("426")) return "outdated";
+  if (s.startsWith("422") || s.startsWith("400")) return "validation";
+  return "api_error";
+}
+function normalize(body) {
+  if (body && typeof body.ok === "boolean") return body;
+  if (body && Object.prototype.hasOwnProperty.call(body, "code")) {
+    if (body.code === 0) return { ok: true, data: body.data };
+    const type = forgeType(body.code);
+    let message = body.msg || "";
+    if (type === "outdated") message += "(升级后请重新加载 SKILL.md 与 manifest 再调用)";
+    // 网关在 data 里带审计 trace_id 的业务错误(如查询失败):透出供 get-query 回查。
+    const extra = body.data && body.data.trace_id ? { trace_id: body.data.trace_id } : {};
+    return { ok: false, error: { type, code: body.code, message, ...extra } };
+  }
+  return { ok: false, error: { type: "api_error", code: "UNKNOWN", message: JSON.stringify(body).slice(0, 200) } };
+}
+
+function findCmd(action) { return MANIFEST.tools.find((t) => t.action === action); }
+function _flag(a, name) { const i = a.indexOf(name); return i >= 0 ? a[i + 1] : undefined; }
+
+// bind:只写本能力自己的配置文件(原子写 + 0600);--logout 删该文件。互不影响其它能力。
+function doBind(a) {
+  const cfgPath = configPath();
+  if (a.includes("--logout")) {
+    try { fs.unlinkSync(cfgPath); process.stderr.write("[" + COMMAND + "] 已清除配置 " + cfgPath + "\n"); }
+    catch (_e) { process.stderr.write("[" + COMMAND + "] 无配置可清除\n"); }
+    return;
+  }
+  const api = _flag(a, "--api-url");
+  const token = _flag(a, "--token");
+  if (!api || !token) {
+    return fail("validation", "BIND_ARGS", "bind 需要 --api-url 与 --token", {
+      usage: { example: COMMAND + " bind --api-url http://host/api/v2 --token <token>" },
+    });
+  }
+  const cfg = { api_url: api.replace(/\/+$/, ""), token };
+  fs.mkdirSync(path.dirname(cfgPath), { recursive: true });
+  const tmp = cfgPath + ".tmp";
+  fs.writeFileSync(tmp, JSON.stringify(cfg, null, 2), { mode: 0o600 });
+  fs.renameSync(tmp, cfgPath); // 原子替换
+  process.stderr.write("[" + COMMAND + "] 已绑定 → " + cfg.api_url + "  (" + cfgPath + ")\n");
+  printWelcome();
+}
+
+function skillsDir() { return process.env.OPENCLAW_SKILLS_DIR || path.join(os.homedir(), ".openclaw", "skills"); }
+function printWelcome() {
+  const w = (s) => process.stderr.write(s + "\n");
+  const skill = MANIFEST.skill;
+  const dir = skillsDir();
+  w("");
+  w("──────────────────────────────────────────────");
+  w("  " + COMMAND + " v" + VERSION + " · 已就绪(能力:" + CAPABILITY + ")");
+  w("  命令:");
+  for (const t of MANIFEST.tools) w("      " + COMMAND + " " + t.action + "  —  " + t.summary);
+  if (skill) { w(""); w("  Agent 需加载 SKILL.md:"); w("      " + path.join(dir, skill.slug, "SKILL.md")); }
+  w("");
+  w("  下一步:" + COMMAND + " <action> -h 查看入参;" + COMMAND + " skills install 重写技能文件");
+  w("──────────────────────────────────────────────");
+}
+
+// ── 嵌套对象形状:object(json) / list[object](json) 这类 flag 光看类型名没法拼 JSON,
+//    这里把 input_schema.$defs 里**被引用到的**对象摊开印出来(与 SKILL.md 同源同内容)。
+//    没有这段时,调用方只能靠 422 报错反推字段名。
+function typeStr(node) {
+  if (!node || typeof node !== "object") return "any";
+  if (typeof node.$ref === "string") return node.$ref.split("/").pop();
+  const union = node.anyOf || node.oneOf;
+  if (union) {
+    const parts = union.filter((n) => n && n.type !== "null").map(typeStr);
+    return parts.length ? parts.join("|") : "any";
+  }
+  if (Array.isArray(node.enum)) return "enum(" + node.enum.join("|") + ")";
+  if (node.type === "array") return "list[" + typeStr(node.items) + "]";
+  return node.type || "any";
+}
+function refsOf(node, acc) {
+  if (!node || typeof node !== "object") return acc;
+  if (Array.isArray(node)) { for (const n of node) refsOf(n, acc); return acc; }
+  if (typeof node.$ref === "string") acc.add(node.$ref.split("/").pop());
+  for (const k of Object.keys(node)) if (k !== "$defs") refsOf(node[k], acc);
+  return acc;
+}
+function objectBlocks(schema) {
+  const defs = (schema && schema.$defs) || {};
+  const queue = [...refsOf((schema && schema.properties) || {}, new Set())], seen = new Set();
+  while (queue.length) {                       // 递归:GroupLevel 会引用自己、Leaf 会被 AndNode 引用
+    const name = queue.shift();
+    if (seen.has(name) || !defs[name]) continue;
+    seen.add(name);
+    for (const r of refsOf(defs[name], new Set())) queue.push(r);
+  }
+  const out = [];
+  for (const name of [...seen].sort()) {
+    const d = defs[name], props = d.properties;
+    if (!props) continue;
+    const required = new Set(d.required || []);
+    const rows = Object.keys(props).map((k) => [k, typeStr(props[k]), required.has(k) ? "required" : "optional",
+                                                props[k].description || ""]);
+    const w0 = Math.max(...rows.map((r) => r[0].length)), w1 = Math.max(...rows.map((r) => r[1].length));
+    out.push("对象 " + name + ":" + (d.description ? "  " + d.description.split("\n")[0] : ""));
+    for (const r of rows) out.push("  " + r[0].padEnd(w0) + "  " + r[1].padEnd(w1) + "  " + r[2].padEnd(8) + "  " + r[3]);
+  }
+  return out;
+}
+
+function usageOf(cmd) {
+  const line = (f) => "  " + f.flag + "  " + f.type + (f.required ? "  required" : "  optional") + "  " + (f.desc || "");
+  const req = cmd.flags.filter((f) => f.required), opt = cmd.flags.filter((f) => !f.required);
+  const blocks = objectBlocks(cmd.input_schema);
+  return {
+    command: COMMAND + " " + cmd.action,
+    required: req.map((f) => ({ flag: f.flag, type: f.type, desc: f.desc })),
+    optional: opt.map((f) => ({ flag: f.flag, type: f.type, desc: f.desc })),
+    objects: blocks,                            // 同样带进 INVALID_ARGS 报错里,拼错时直接能看到形状
+    example: (COMMAND + " " + cmd.action + " " + req.map((f) => f.flag + " <v>").join(" ")).trim(),
+    _text: [COMMAND + " " + cmd.action + " — " + cmd.summary, "Inputs:", ...cmd.flags.map(line),
+            ...(blocks.length ? ["", ...blocks] : [])].join("\n"),
+  };
+}
+function printHelp(action) {
+  const w = (s) => process.stderr.write(s + "\n");
+  if (action) {
+    const c = findCmd(action);
+    if (!c) return fail("validation", "UNKNOWN_COMMAND", "未知命令 " + action);
+    const u = usageOf(c); w(u._text); w(""); w("示例:" + u.example); return process.exit(0);
+  }
+  w(COMMAND + " v" + VERSION + " — Social Neuron 能力 CLI(能力:" + CAPABILITY + ";供 AI agent 调用)");
+  w("");
+  w("用法:" + COMMAND + " <action> [--flags]");
+  w("  标量 --flag v;数组/对象一律 JSON:--flag '[\"a\",\"b\"]' / --flag '{\"k\":\"v\"}';写/删/触发加 -y");
+  w("");
+  w("命令:");
+  for (const c of MANIFEST.tools) w("  " + COMMAND + " " + c.action + "  —  " + c.summary);
+  w("");
+  w("其它:");
+  w("  " + COMMAND + " <action> -h                       查看某命令完整入参/出参");
+  w("  " + COMMAND + " bind --api-url <url> --token <t>  绑定网关+令牌(写 " + configPath() + ")");
+  w("  " + COMMAND + " bind --logout                     删除本能力配置");
+  w("  " + COMMAND + " skills install [dir]              覆盖写入 SKILL.md 到 ~/.openclaw/skills");
+  w("  " + COMMAND + " --version");
+  w("");
+  w("鉴权/网关:env NEURON_API_BASE_URL / NEURON_TOKEN 覆盖配置;令牌走头 X-Social-Neuron-CLI-Key。");
+  process.exit(0);
+}
+
+function parseArgs(cmd, argv) {
+  const byFlag = Object.fromEntries(cmd.flags.map((f) => [f.flag, f]));
+  const args = {};
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "-y") continue;
+    if (!a.startsWith("--")) continue;
+    const f = byFlag[a];
+    if (!f) return { err: fail("validation", "UNKNOWN_FLAG", "未知参数 " + a) };
+    const raw = argv[++i];
+    if (raw === undefined) return { err: fail("validation", "MISSING_VALUE", a + " 缺少取值") };
+    let val = raw;
+    if (f.type.indexOf("(json)") >= 0) {
+      // 数组/对象一律按 JSON 解析(与 MCP 入参同形)。不做「逗号分隔」这类特例:
+      // 同一份文档要能同时用于两个出口,取值写法就只能有一种。
+      try { val = JSON.parse(raw); } catch {
+        const hint = f.type.startsWith("list") ? "JSON 数组,如 '[\"a\",\"b\"]'" : "JSON 对象,如 '{\"k\":\"v\"}'";
+        return { err: fail("validation", "BAD_JSON", a + " 需为 " + hint + "(当前取值:" + raw + ")") };
+      }
+      if (f.type.startsWith("list") && !Array.isArray(val)) {
+        return { err: fail("validation", "BAD_JSON", a + " 需为 JSON 数组,如 '[\"a\",\"b\"]';单个取值也要写成数组") };
+      }
+    }
+    else if (f.type === "integer") val = Number(raw);
+    args[f.field] = val;
+  }
+  return { args };
+}
+
+async function main() {
+  let argv = process.argv.slice(2);
+  if (argv.length === 0 && MANIFEST.default_action) argv = [MANIFEST.default_action];
+  if (argv.length === 0 || argv[0] === "--help" || argv[0] === "-h") return printHelp();
+  if (argv[0] === "--version" || argv[0] === "-V") { process.stdout.write(VERSION + "\n"); return; }
+  if (argv[0] === "bind") return doBind(argv.slice(1));
+  if (argv[0] === "skills" && argv[1] === "install") { require(path.join(__dirname, "install-skills.js")).installTo(argv[2]); return; }
+
+  const [action, ...rest] = argv;
+  if (rest.includes("--help") || rest.includes("-h")) return printHelp(action);
+
+  const cmd = findCmd(action);
+  if (!cmd) return fail("validation", "UNKNOWN_COMMAND", "未知命令 " + action);
+
+  const parsed = parseArgs(cmd, rest);
+  if (parsed.err) return;
+  const { args } = parsed;
+  const missing = cmd.flags.filter((f) => f.required && args[f.field] === undefined).map((f) => f.flag);
+  if (missing.length) return fail("validation", "INVALID_ARGS", "缺少必填参数:" + missing.join(" "), { usage: usageOf(cmd) });
+
+  const { api, token } = resolveConfig();
+  if (!api) return fail("config", "CONFIG", "未配置网关地址(" + COMMAND + " bind 或 env NEURON_API_BASE_URL)");
+  if (!token) return fail("auth_error", "AUTH_MISSING", "未配置 token(" + COMMAND + " bind 或 env NEURON_TOKEN)");
+
+  try {
+    // 直达能力级出口 /{key}/{op};body 即该 op 的入参对象(send=args)。
+    const res = await fetch(api + cmd.transport.path, {
+      method: cmd.transport.method,
+      headers: {
+        "X-Social-Neuron-CLI-Key": token,
+        "Content-Type": "application/json",
+        "X-Caller": "ai-agent",
+        "X-Neuron-CLI-Version": VERSION,
+        "X-Neuron-Manifest-Rev": String(MANIFEST.revision),
+      },
+      body: JSON.stringify(args),
+      signal: AbortSignal.timeout(30000),
+    });
+    const text = await res.text();
+    let body;
+    try { body = JSON.parse(text); } catch { return fail("api_error", "HTTP_" + res.status, text.slice(0, 200)); }
+    emit(normalize(body));
+  } catch (e) { fail("network", "NETWORK", "连接网关失败: " + e.message); }
+}
+
+main();

package/bin/install-skills.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+"use strict";
+
+// ⚠️ 本文件由 core/cli/gen.py 生成,请勿手改。
+// postinstall:把包内 SKILL.md 覆盖写到 OpenClaw 技能目录(OPENCLAW_SKILLS_DIR 或 ~/.openclaw/skills)。
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+function installTo(dir) {
+  const dst = dir || process.env.OPENCLAW_SKILLS_DIR || path.join(os.homedir(), ".openclaw", "skills");
+  const src = path.join(__dirname, "..", "skills");
+  if (!fs.existsSync(src)) { console.error("[neuron] no bundled skills; skip"); return; }
+  const written = [];
+  for (const name of fs.readdirSync(src)) {
+    const from = path.join(src, name);
+    if (!fs.statSync(from).isDirectory()) continue;
+    const to = path.join(dst, name);
+    fs.mkdirSync(to, { recursive: true });
+    for (const f of fs.readdirSync(from)) { fs.copyFileSync(path.join(from, f), path.join(to, f)); written.push(path.join(to, f)); }
+  }
+  console.error("[neuron] skills → " + dst + " (" + written.length + " files)");
+  for (const f of written.filter((p) => p.endsWith(".md"))) console.error("[neuron]   加载:" + f);
+}
+
+module.exports = { installTo };
+
+if (require.main === module) {
+  try { installTo(); } catch (e) { console.error("[neuron] install-skills skipped:", e.message); }
+}