aai-lark-bridge 0.2.19 → 0.2.20

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.
package/dist/cli.js CHANGED
@@ -4,7 +4,7 @@ import { Command } from "commander";
4
4
  // package.json
5
5
  var package_default = {
6
6
  name: "aai-lark-bridge",
7
- version: "0.2.19",
7
+ version: "0.2.20",
8
8
  description: "Lark AI Native Bridge - Lark\u57FA\u7840\u8BBE\u65BD\u5C42\u548CCLI\u96C6\u6210",
9
9
  type: "module",
10
10
  main: "./dist/index.js",
@@ -7426,7 +7426,10 @@ async function requestUserRead(cfg, messageId, deps = {}) {
7426
7426
  kind: "handle",
7427
7427
  gatewayRunId,
7428
7428
  env: { [HANDLE_ENV]: r.handle, [GATEWAY_ENV]: cfg.gatewayUrl },
7429
- prompt: PROMPT_TOOL
7429
+ // 网关按查库名单决定这个句柄能不能查库(intent 0049);能查才把部署方写的说明给 agent
7430
+ prompt: r.db === true && cfg.dbPrompt ? `${PROMPT_TOOL}
7431
+
7432
+ ${cfg.dbPrompt}` : PROMPT_TOOL
7430
7433
  };
7431
7434
  }
7432
7435
  log.info("user-read", "no-handle", { messageId, status: String(r.status) });
@@ -19249,6 +19252,58 @@ import { spawnSync as spawnSync5 } from "child_process";
19249
19252
  import { existsSync as existsSync10 } from "fs";
19250
19253
  import { join as join28 } from "path";
19251
19254
 
19255
+ // src/bridge/user-gateway/db-query.ts
19256
+ import { spawn as spawn3 } from "child_process";
19257
+ var DB_QUERY_TIMEOUT_MS = 16e4;
19258
+ var TASK_HANDLE_TTL_MS = 150 * 6e4;
19259
+ var SQL_LOG_MAX = 2e3;
19260
+ var LOCK_WAIT_SEC = 60;
19261
+ var DB_NAME = /^[a-z0-9_-]{1,40}$/;
19262
+ var OPEN_ID = /^ou_[A-Za-z0-9_-]{1,100}$/;
19263
+ function dbFromEnv(env, cmd = "") {
19264
+ const argv = cmd.trim() ? cmd.trim().split(/\s+/) : [];
19265
+ const readers = (env.SDLC_DB_READERS ?? "").split(",").map((s) => s.trim()).filter((s) => OPEN_ID.test(s));
19266
+ return { enabled: (env.SDLC_DB_GATEWAY ?? "").trim() === "on" && argv.length > 0, readers, cmd: argv };
19267
+ }
19268
+ function realDbRunner(cmd) {
19269
+ return (args, timeoutMs) => new Promise((resolve3) => {
19270
+ const [bin, ...pre] = cmd;
19271
+ const p3 = spawn3(bin, [...pre, ...args], {
19272
+ env: { ...process.env, SDLC_Q_MODE: "direct", SDLC_Q_LOCK_WAIT: String(LOCK_WAIT_SEC) },
19273
+ stdio: ["ignore", "pipe", "pipe"]
19274
+ });
19275
+ let stdout = "";
19276
+ let stderr = "";
19277
+ let timedOut = false;
19278
+ const t = setTimeout(() => {
19279
+ timedOut = true;
19280
+ p3.kill("SIGTERM");
19281
+ }, timeoutMs);
19282
+ p3.stdout.on("data", (d) => stdout += d.toString("utf8"));
19283
+ p3.stderr.on("data", (d) => stderr += d.toString("utf8"));
19284
+ p3.on("error", (err) => {
19285
+ clearTimeout(t);
19286
+ resolve3({ code: null, stdout, stderr: String(err), timedOut });
19287
+ });
19288
+ p3.on("close", (code) => {
19289
+ clearTimeout(t);
19290
+ resolve3({ code, stdout, stderr, timedOut });
19291
+ });
19292
+ });
19293
+ }
19294
+ function csvRows(csv) {
19295
+ const lines = csv.split("\n").filter((l) => l && !l.startsWith("\uFF08\u7ED3\u679C\u8D85\u8FC7"));
19296
+ return Math.max(0, lines.length - 1);
19297
+ }
19298
+ function toResult(r) {
19299
+ const detail = r.stderr.trim().slice(0, 500);
19300
+ if (r.timedOut) return { status: "failed", detail: "\u67E5\u8BE2\u8D85\u65F6" };
19301
+ if (r.code === 0) return { status: "ok", csv: r.stdout };
19302
+ if (r.code === 2) return { status: "rejected", detail };
19303
+ if (r.code === 3) return { status: "busy" };
19304
+ return { status: "failed", detail };
19305
+ }
19306
+
19252
19307
  // src/bridge/user-gateway/gateway.ts
19253
19308
  import { randomBytes as randomBytes10 } from "crypto";
19254
19309
  import { existsSync as existsSync9 } from "fs";
@@ -19256,7 +19311,7 @@ import { mkdir as mkdir19, rm as rm14, writeFile as writeFile9 } from "fs/promis
19256
19311
  import { join as join27 } from "path";
19257
19312
 
19258
19313
  // src/bridge/user-gateway/app-token.ts
19259
- import { spawn as spawn3 } from "child_process";
19314
+ import { spawn as spawn4 } from "child_process";
19260
19315
  import { readFileSync as readFileSync5 } from "fs";
19261
19316
  var APP_TOKEN_REFRESH_BEFORE_MS = 5 * 6e4;
19262
19317
  var APP_TOKEN_FAIL_BACKOFF_MS = 6e4;
@@ -19311,7 +19366,7 @@ process.stdin.on('data', (c) => chunks.push(c)).on('end', async () => {
19311
19366
  });`;
19312
19367
  function run(command, args, input, env, timeoutMs) {
19313
19368
  return new Promise((resolve3, reject4) => {
19314
- const p3 = spawn3(command, args, { env, stdio: ["pipe", "pipe", "ignore"] });
19369
+ const p3 = spawn4(command, args, { env, stdio: ["pipe", "pipe", "ignore"] });
19315
19370
  let out = "";
19316
19371
  const t = setTimeout(() => p3.kill("SIGTERM"), timeoutMs).unref();
19317
19372
  p3.stdout.on("data", (d) => out += d.toString("utf8"));
@@ -19375,7 +19430,7 @@ var RATE_LIMIT_BACKOFF_MS = [2e3, 5e3, 1e4];
19375
19430
  var REVOKE_TEXT2 = "\u64A4\u9500\u6388\u6743";
19376
19431
  var MESSAGE_ID = /^om_[A-Za-z0-9_-]{1,100}$/;
19377
19432
  var CHAT_ID = /^oc_[A-Za-z0-9_-]{1,100}$/;
19378
- var OPEN_ID = /^ou_[A-Za-z0-9_-]{1,100}$/;
19433
+ var OPEN_ID2 = /^ou_[A-Za-z0-9_-]{1,100}$/;
19379
19434
  var RUN_ID = /^[A-Za-z0-9._:-]{1,200}$/;
19380
19435
  var NONCE = /^[0-9a-f]{32}$/;
19381
19436
  var TASK_GUID = /^[A-Za-z0-9-]{8,100}$/;
@@ -19564,7 +19619,7 @@ function createGateway(opts) {
19564
19619
  return msg.code === 0 ? "not_found" : "lark_error";
19565
19620
  }
19566
19621
  const sender = isRecord6(item.sender) ? item.sender : {};
19567
- if (sender.sender_type !== "user" || sender.id_type !== "open_id" || typeof sender.id !== "string" || !OPEN_ID.test(sender.id)) {
19622
+ if (sender.sender_type !== "user" || sender.id_type !== "open_id" || typeof sender.id !== "string" || !OPEN_ID2.test(sender.id)) {
19568
19623
  return "not_user";
19569
19624
  }
19570
19625
  const created = Number(item.create_time);
@@ -19642,6 +19697,8 @@ function createGateway(opts) {
19642
19697
  const members = Array.isArray(task.members) ? task.members : [];
19643
19698
  return members.filter((m) => isRecord6(m) && m.role === "assignee" && typeof m.id === "string").map((m) => m.id);
19644
19699
  }
19700
+ const db = opts.db ?? { enabled: false, readers: [], cmd: [] };
19701
+ const runDb = opts.dbRunner ?? realDbRunner(db.cmd);
19645
19702
  const seat = createClaudeSeat({
19646
19703
  stateDir: opts.stateDir,
19647
19704
  appId: opts.appId,
@@ -19730,9 +19787,10 @@ function createGateway(opts) {
19730
19787
  }
19731
19788
  const handle2 = randomBytes10(32).toString("base64url");
19732
19789
  const expiresAt = now() + HANDLE_TTL_MS;
19733
- handles.set(handle2, { openId: v.openId, messageId, runId, expiresAt });
19734
- log.info("user-gateway", "handle.issued", { identity: "user", sender: tail6(v.openId), messageId, runId });
19735
- return { status: "ok", handle: handle2, expiresAt };
19790
+ const canDb = db.enabled && db.readers.includes(v.openId);
19791
+ handles.set(handle2, { openId: v.openId, messageId, runId, expiresAt, kind: "dm", db: canDb });
19792
+ log.info("user-gateway", "handle.issued", { identity: "user", sender: tail6(v.openId), messageId, runId, db: canDb });
19793
+ return { status: "ok", handle: handle2, expiresAt, db: canDb };
19736
19794
  },
19737
19795
  /** DELETE /handles/{runId}:运行结束,作废这次运行的句柄。 */
19738
19796
  dropHandles(runId) {
@@ -19750,7 +19808,7 @@ function createGateway(opts) {
19750
19808
  async read(handle2, api, input) {
19751
19809
  sweep();
19752
19810
  const h = handles.get(handle2);
19753
- if (!h) return { status: "expired" };
19811
+ if (!h || h.kind !== "dm") return { status: "expired" };
19754
19812
  let args;
19755
19813
  try {
19756
19814
  args = readArgs(api, input);
@@ -19824,7 +19882,7 @@ function createGateway(opts) {
19824
19882
  let taskGuid, openId, runId;
19825
19883
  try {
19826
19884
  taskGuid = str2(input, "taskGuid", TASK_GUID);
19827
- openId = str2(input, "openId", OPEN_ID);
19885
+ openId = str2(input, "openId", OPEN_ID2);
19828
19886
  runId = str2(input, "runId", RUN_ID);
19829
19887
  } catch {
19830
19888
  return { status: "bad_request" };
@@ -19846,7 +19904,7 @@ function createGateway(opts) {
19846
19904
  let openId, card, nonce;
19847
19905
  const code = typeof input.code === "string" ? input.code.trim() : "";
19848
19906
  try {
19849
- openId = str2(input, "openId", OPEN_ID);
19907
+ openId = str2(input, "openId", OPEN_ID2);
19850
19908
  card = str2(input, "cardMessageId", MESSAGE_ID);
19851
19909
  nonce = str2(input, "nonce", NONCE);
19852
19910
  } catch {
@@ -19869,6 +19927,53 @@ function createGateway(opts) {
19869
19927
  if (v.text?.trim() !== LOGOUT_TEXT) return { status: "not_logout" };
19870
19928
  return { status: await seat.logout(v.openId) };
19871
19929
  },
19930
+ /**
19931
+ * POST /db/task-handle:调度的只读运行(只读分析、出文档、补报告)起 claude 前凭任务申请查库句柄(intent 0049 R-04)。
19932
+ * 负责人得是这个任务的 assignee(网关向飞书核对,同 0048 的 /claude/task-token);不看私聊查库名单(spec D-3)。
19933
+ */
19934
+ async dbTaskHandle(input) {
19935
+ let taskGuid, openId, runId;
19936
+ try {
19937
+ taskGuid = str2(input, "taskGuid", TASK_GUID);
19938
+ openId = str2(input, "openId", OPEN_ID2);
19939
+ runId = str2(input, "runId", RUN_ID);
19940
+ } catch {
19941
+ return { status: "bad_request" };
19942
+ }
19943
+ if (!db.enabled) return { status: "off" };
19944
+ const assignees = await taskAssignees(taskGuid);
19945
+ if (assignees === "lark_error") return { status: "lark_error" };
19946
+ if (!assignees.includes(openId)) {
19947
+ log.warn("user-gateway", "db.handle-refused", { sender: tail6(openId), runId, result: "not_assignee" });
19948
+ return { status: "not_assignee" };
19949
+ }
19950
+ const handle2 = randomBytes10(32).toString("base64url");
19951
+ const expiresAt = now() + TASK_HANDLE_TTL_MS;
19952
+ handles.set(handle2, { openId, messageId: "", runId, expiresAt, kind: "task", db: true });
19953
+ log.info("user-gateway", "db.handle-issued", { sender: tail6(openId), runId, task: taskGuid });
19954
+ return { status: "ok", handle: handle2, expiresAt };
19955
+ },
19956
+ /** POST /db/query:凭句柄替 agent 查一条,每次记一条 db.query(intent 0049 R-01、R-03、R-05)。 */
19957
+ async dbQuery(handle2, input) {
19958
+ if (!db.enabled) return { status: "off" };
19959
+ sweep();
19960
+ const h = handles.get(handle2);
19961
+ if (!h) return { status: "expired" };
19962
+ const name = typeof input.db === "string" && input.db ? input.db : "lotus";
19963
+ const sql = typeof input.sql === "string" ? input.sql : "";
19964
+ const fields = { sender: tail6(h.openId), runId: h.runId, kind: h.kind, db: name, sql: sql.slice(0, SQL_LOG_MAX) };
19965
+ if (!h.db) {
19966
+ log.warn("user-gateway", "db.query", { ...fields, rows: 0, ms: 0, result: "not_allowed" });
19967
+ return { status: "not_allowed" };
19968
+ }
19969
+ if (!DB_NAME.test(name) || !sql.trim()) return { status: "bad_request", detail: !sql.trim() ? "\u7A7A\u67E5\u8BE2" : `\u5E93\u540D\u4E0D\u5BF9\uFF1A${name}` };
19970
+ const t0 = now();
19971
+ const r = toResult(await runDb(["--db", name, sql], DB_QUERY_TIMEOUT_MS));
19972
+ const rows = r.status === "ok" ? csvRows(r.csv) : 0;
19973
+ const detail = "detail" in r ? { detail: r.detail.slice(0, 200) } : {};
19974
+ (r.status === "ok" ? log.info : log.warn)("user-gateway", "db.query", { ...fields, rows, ms: now() - t0, result: r.status, ...detail });
19975
+ return r;
19976
+ },
19872
19977
  /** 测试用:等正在进行的授权轮询结束。 */
19873
19978
  async settle() {
19874
19979
  await Promise.all([...pendingAuth.values()]);
@@ -19881,6 +19986,8 @@ import { createHash as createHash8, timingSafeEqual as timingSafeEqual3 } from "
19881
19986
  import { createServer as createServer2 } from "http";
19882
19987
  var MAX_BODY = 16 * 1024;
19883
19988
  var CLAUDE_ROUTES = /* @__PURE__ */ new Set(["/claude/token", "/claude/task-token", "/claude/login-submit", "/claude/logout"]);
19989
+ var DB_TASK_HANDLE = "/db/task-handle";
19990
+ var DB_QUERY = "/db/query";
19884
19991
  var digest = (s) => createHash8("sha256").update(s).digest();
19885
19992
  function tokenOk(given, expected) {
19886
19993
  if (typeof given !== "string" || !given) return false;
@@ -19923,7 +20030,7 @@ function createGatewayServer(opts) {
19923
20030
  const path = url.pathname;
19924
20031
  const method = req.method ?? "GET";
19925
20032
  if (method === "GET" && path === "/healthz") return send2(res, 200, { status: "ok" });
19926
- const claude = method === "POST" && CLAUDE_ROUTES.has(path);
20033
+ const claude = method === "POST" && (CLAUDE_ROUTES.has(path) || path === DB_TASK_HANDLE);
19927
20034
  const admin = claude || method === "POST" && (path === "/handles" || path === "/revoke") || method === "DELETE" && path.startsWith("/handles/");
19928
20035
  if (admin) {
19929
20036
  if (!tokenOk(req.headers["x-gateway-token"], expected)) {
@@ -19935,6 +20042,7 @@ function createGatewayServer(opts) {
19935
20042
  return send2(res, 200, { status: "ok", dropped: gateway.dropHandles(runId) });
19936
20043
  }
19937
20044
  const body = await readBody(req);
20045
+ if (path === DB_TASK_HANDLE) return send2(res, 200, await gateway.dbTaskHandle(body));
19938
20046
  if (path === "/claude/token") return send2(res, 200, await gateway.claudeToken(body));
19939
20047
  if (path === "/claude/task-token") return send2(res, 200, await gateway.claudeTaskToken(body));
19940
20048
  if (path === "/claude/login-submit") return send2(res, 200, await gateway.claudeLoginSubmit(body));
@@ -19942,12 +20050,20 @@ function createGatewayServer(opts) {
19942
20050
  if (path === "/handles") return send2(res, 200, await gateway.requestHandle(body));
19943
20051
  return send2(res, 200, await gateway.revoke(body));
19944
20052
  }
20053
+ const bearer = () => {
20054
+ const auth = req.headers.authorization;
20055
+ return typeof auth === "string" && auth.startsWith("Bearer ") ? auth.slice(7).trim() : "";
20056
+ };
20057
+ if (method === "POST" && path === DB_QUERY) {
20058
+ const handle2 = bearer();
20059
+ if (!handle2) return send2(res, 200, { status: "expired" });
20060
+ return send2(res, 200, await gateway.dbQuery(handle2, await readBody(req)));
20061
+ }
19945
20062
  const read = method === "POST" ? /^\/read\/([a-z-]+)$/.exec(path) : null;
19946
20063
  if (read) {
19947
20064
  const api = read[1] ?? "";
19948
20065
  if (!isReadApi(api)) return send2(res, 404, { status: "unknown_api" });
19949
- const auth = req.headers.authorization;
19950
- const handle2 = typeof auth === "string" && auth.startsWith("Bearer ") ? auth.slice(7).trim() : "";
20066
+ const handle2 = bearer();
19951
20067
  if (!handle2) return send2(res, 200, { status: "expired" });
19952
20068
  return send2(res, 200, await gateway.read(handle2, api, await readBody(req)));
19953
20069
  }
@@ -19983,12 +20099,14 @@ async function runUserGateway(opts) {
19983
20099
  larkSourceConfig: opts.larkSourceConfig,
19984
20100
  exec: defaultExec,
19985
20101
  // Claude 席位开关(intent 0048):容器的 SDLC_CLAUDE_SEAT、SDLC_CLAUDE_SEAT_LIST,缺省关
19986
- seat: seatFromEnv(process.env)
20102
+ seat: seatFromEnv(process.env),
20103
+ // 查库开关(intent 0049):容器的 SDLC_DB_GATEWAY、SDLC_DB_READERS,缺省关
20104
+ db: dbFromEnv(process.env, opts.dbCmd)
19987
20105
  });
19988
20106
  const pass = fetchToken(opts.tokenCmd);
19989
20107
  const server = createGatewayServer({ gateway, gatewayToken: pass });
19990
20108
  await new Promise((resolve3) => server.listen(port, opts.host ?? "0.0.0.0", resolve3));
19991
- log.info("user-gateway", "started", { port, claudeSeat: seatFromEnv(process.env).mode });
20109
+ log.info("user-gateway", "started", { port, claudeSeat: seatFromEnv(process.env).mode, db: dbFromEnv(process.env, opts.dbCmd).enabled });
19992
20110
  console.log(`user-gateway listening on ${opts.host ?? "0.0.0.0"}:${port}`);
19993
20111
  await new Promise((resolve3) => {
19994
20112
  const stop2 = () => server.close(() => resolve3());
@@ -20006,7 +20124,7 @@ program.command("run").description("Run the bridge in the foreground (was `start
20006
20124
  program.command("migrate").description("Migrate legacy bridge config/state into the current profile layout").option("-c, --config <path>", "path to config file").option("--profile <name>", "target profile name for legacy v1 config migration").option("--agent <kind>", "agent kind for legacy v1 profile migration (claude or codex)").action(async (opts) => {
20007
20125
  await runMigrate(opts);
20008
20126
  });
20009
- program.command("user-gateway").description("Run the per-sender user-token gateway (intent 0046); keeps user tokens out of the agent container").requiredOption("--app-id <id>", "App ID whose users authorize").requiredOption("--state-dir <path>", "gateway volume; user tokens live under user-tokens/<appId>/<open_id>/").requiredOption("--lark-source-config <path>", "lark-cli source config with the app id and secret provider").requiredOption("--token-cmd <cmd>", 'command printing the gateway token, e.g. "sdlc-secret gateway-token" (no shell)').option("--host <host>", "listen address", "0.0.0.0").option("--port <port>", "listen port", "8788").action(async (opts) => {
20127
+ program.command("user-gateway").description("Run the per-sender user-token gateway (intent 0046); keeps user tokens out of the agent container").requiredOption("--app-id <id>", "App ID whose users authorize").requiredOption("--state-dir <path>", "gateway volume; user tokens live under user-tokens/<appId>/<open_id>/").requiredOption("--lark-source-config <path>", "lark-cli source config with the app id and secret provider").requiredOption("--token-cmd <cmd>", 'command printing the gateway token, e.g. "sdlc-secret gateway-token" (no shell)').option("--host <host>", "listen address", "0.0.0.0").option("--port <port>", "listen port", "8788").option("--db-cmd <cmd>", "query command for /db/query (intent 0049), e.g. the q proxy; used only when SDLC_DB_GATEWAY=on").action(async (opts) => {
20010
20128
  await runUserGateway(opts);
20011
20129
  });
20012
20130
  var profile = program.command("profile").description("Manage local bridge profiles");