@social-data/social-neuron-subscription 1.0.0-beta.2 → 1.0.0-beta.20

package/bin/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 "use strict";
 
-// ⚠️ 本文件由 backend/app/cli_spec/gen.py 生成,请勿手改;要改改 gen.py 的 _CLI_JS 后重跑 gen。
+// ⚠️ 本文件由 core/cli/gen.py 生成,请勿手改;要改改 gen.py 的 _CLI_JS 后重跑 gen。
 //
 // 能力 CLI —— 通用薄运行时(纯 JS,零依赖):一能力一命令、一包、一配置文件,互不影响。
 //   <cmd> <action> [--flags]                       调用一条命令
@@ -40,7 +40,11 @@ function resolveConfig() {
 
 function emit(env) {
   process.stdout.write(JSON.stringify(env) + "\n");
-  process.exit(env.ok ? 0 : (EXIT[env.error && env.error.type] ?? 1));
+  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 || {}) } });
@@ -61,7 +65,9 @@ function normalize(body) {
     const type = forgeType(body.code);
     let message = body.msg || "";
     if (type === "outdated") message += "(升级后请重新加载 SKILL.md 与 manifest 再调用)";
-    return { ok: false, error: { type, code: body.code, message } };
+    // 网关在 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) } };
 }
@@ -109,15 +115,63 @@ function printWelcome() {
   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)].join("\n"),
+    _text: [COMMAND + " " + cmd.action + " — " + cmd.summary, "Inputs:", ...cmd.flags.map(line),
+            ...(blocks.length ? ["", ...blocks] : [])].join("\n"),
   };
 }
 function printHelp(action) {
@@ -130,7 +184,7 @@ function printHelp(action) {
   w(COMMAND + " v" + VERSION + " — Social Neuron 能力 CLI(能力:" + CAPABILITY + ";供 AI agent 调用)");
   w("");
   w("用法:" + COMMAND + " <action> [--flags]");
-  w("  标量 --flag v;数组 --flag a,b;对象 --flag '<json>';写/删/触发加 -y");
+  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);
@@ -158,8 +212,17 @@ function parseArgs(cmd, argv) {
     const raw = argv[++i];
     if (raw === undefined) return { err: fail("validation", "MISSING_VALUE", a + " 缺少取值") };
     let val = raw;
-    if (f.type.startsWith("list")) val = raw.split(",").map((s) => s.trim()).filter(Boolean);
-    else if (f.type.startsWith("object")) { try { val = JSON.parse(raw); } catch { return { err: fail("validation", "BAD_JSON", a + " 需为合法 JSON") }; } }
+    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;
   }
@@ -167,7 +230,8 @@ function parseArgs(cmd, argv) {
 }
 
 async function main() {
-  const argv = process.argv.slice(2);
+  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));

package/bin/install-skills.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 "use strict";
 
-// ⚠️ 本文件由 backend/app/cli_spec/gen.py 生成,请勿手改。
+// ⚠️ 本文件由 core/cli/gen.py 生成,请勿手改。
 // postinstall:把包内 SKILL.md 覆盖写到 OpenClaw 技能目录(OPENCLAW_SKILLS_DIR 或 ~/.openclaw/skills)。
 
 const fs = require("fs");