aai-lark-bridge 0.2.19 → 0.2.21

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