aai-lark-bridge 0.2.45 → 0.2.47

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.
@@ -10,9 +10,10 @@ const SUBCOMMANDS = {
10
10
  'list-chat-messages': { '--chat-id': 'chatId', '--page-size': 'pageSize', '--page-token': 'pageToken', '--sort': 'sortType' },
11
11
  'search-docs': { '--query': 'query', '--page-size': 'pageSize', '--page-token': 'pageToken' },
12
12
  'fetch-doc': { '--doc': 'doc' },
13
+ 'read-base': { '--url': 'url', '--table': 'table', '--offset': 'offset', '--limit': 'limit' },
13
14
  'read-file': { '--message-id': 'messageId', '--file-key': 'fileKey', '--sheet': 'sheet', '--offset': 'offset', '--limit': 'limit', '--grep': 'grep' },
14
15
  };
15
- const REQUIRED = { 'search-messages': ['query'], 'get-message': ['messageId'], 'list-chat-messages': ['chatId'], 'search-docs': ['query'], 'fetch-doc': ['doc'], 'read-file': ['messageId', 'fileKey'] };
16
+ const REQUIRED = { 'search-messages': ['query'], 'get-message': ['messageId'], 'list-chat-messages': ['chatId'], 'search-docs': ['query'], 'fetch-doc': ['doc'], 'read-file': ['messageId', 'fileKey'], 'read-base': ['url'] };
16
17
  const SORT = { asc: 'ByCreateTimeAsc', desc: 'ByCreateTimeDesc' };
17
18
 
18
19
  const USAGE = `用法:aai-user-read <子命令> [参数]
@@ -21,6 +22,7 @@ const USAGE = `用法:aai-user-read <子命令> [参数]
21
22
  list-chat-messages --chat-id oc_xxx [--page-size N] [--page-token T] [--sort asc|desc]
22
23
  search-docs --query <关键词> [--page-size N] [--page-token T]
23
24
  fetch-doc --doc <文档链接或 token>
25
+ read-base --url <多维表格链接> [--table 数据表名或 tbl_ 开头的 ID] [--offset N] [--limit N]
24
26
  read-file --message-id om_xxx --file-key file_xxx [--sheet 工作表名] [--offset N] [--limit N] [--grep 关键词]`;
25
27
 
26
28
  export function parseArgs(argv) {
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.45",
7
+ version: "0.2.47",
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",
@@ -7531,10 +7531,13 @@ var PROMPT_TOOL = `## \u7528\u63D0\u95EE\u4EBA\u7684\u8EAB\u4EFD\u53EA\u8BFB\uFF
7531
7531
  - \`aai-user-read list-chat-messages --chat-id oc_xxx [--page-size N] [--page-token T] [--sort asc|desc]\`\uFF1A\u62C9\u4E00\u4E2A\u4F1A\u8BDD\u7684\u5386\u53F2
7532
7532
  - \`aai-user-read search-docs --query <\u5173\u952E\u8BCD> [--page-size N] [--page-token T]\`\uFF1A\u641C\u4ED6\u80FD\u770B\u7684\u6587\u6863
7533
7533
  - \`aai-user-read fetch-doc --doc <\u6587\u6863\u94FE\u63A5\u6216 token>\`\uFF1A\u8BFB\u6587\u6863\u6B63\u6587
7534
+ - \`aai-user-read read-base --url <\u591A\u7EF4\u8868\u683C\u94FE\u63A5> [--table \u6570\u636E\u8868\u540D\u6216 tbl_ \u5F00\u5934\u7684 ID] [--offset N] [--limit N]\`\uFF1A\u8BFB\u591A\u7EF4\u8868\u683C\uFF08\u98DE\u4E66\u91CC\u53EB\u300C\u591A\u7EF4\u8868\u683C\u300D\u6216 Base\uFF0C\u94FE\u63A5\u91CC\u5E38\u6709 /base/\uFF0C\u4E5F\u53EF\u80FD\u662F\u77E5\u8BC6\u5E93\u91CC\u7684 /wiki/ \u94FE\u63A5\uFF09
7534
7535
  - \`aai-user-read read-file --message-id om_xxx --file-key file_xxx [--sheet \u5DE5\u4F5C\u8868\u540D] [--offset N] [--limit N] [--grep \u5173\u952E\u8BCD]\`\uFF1A\u8BFB\u6D88\u606F\u91CC\u7684\u9644\u4EF6\uFF0C\u8F6C\u6210\u6587\u5B57
7535
7536
 
7536
7537
  \u8BFB\u9644\u4EF6\uFF1A\u6D88\u606F\u5185\u5BB9\u91CC\u7684 \`<file key="file_v3_\u2026" name="\u2026.xlsx"/>\` \u5C31\u662F\u9644\u4EF6\uFF0Ckey \u662F \`--file-key\`\uFF0C\u6D88\u606F\u53F7\u662F \`--message-id\`\uFF08\u7528 \`get-message\`\u3001\`list-chat-messages\`\u3001\`search-messages\` \u62FF\uFF09\u3002\u652F\u6301 Excel\uFF08xlsx\uFF09\u3001Word\uFF08docx\uFF09\u3001PPT\uFF08pptx\uFF09\u3001csv\u3001txt\u3001md\u3001json\u3002\u4E0D\u5E26 \`--sheet\` \u65F6\u8FD4\u56DE\u5DE5\u4F5C\u8868\u6E05\u5355\uFF08\u540D\u79F0\u3001\u884C\u6570\u3001\u5217\u6570\uFF09\u548C\u7B2C\u4E00\u5F20\u8868\u7684\u7B2C\u4E00\u9875\uFF1B\u6BCF\u9875\u6700\u591A 200 \u884C\u6216 100KB\uFF0C\`hasMore\` \u4E3A\u771F\u5C31\u7528 \`nextOffset\` \u4F5C \`--offset\` \u7FFB\u9875\uFF1B\u627E\u67D0\u4E9B\u884C\u7528 \`--grep \u5173\u952E\u8BCD\`\uFF08\u53EA\u8FD4\u56DE\u542B\u5173\u952E\u8BCD\u7684\u884C\uFF0C\`--offset\` \u6309\u547D\u4E2D\u5E8F\u53F7\u7FFB\uFF09\uFF1BExcel \u7684\u6BCF\u4E00\u884C\u5F00\u5934\u662F\u539F\u8868\u884C\u53F7\u3002\u4E0D\u8981\u4E3A\u4E86\u627E\u51E0\u884C\u628A\u6574\u5F20\u5927\u8868\u4E00\u9875\u9875\u7FFB\u5B8C\uFF0C\u5148\u770B\u6E05\u5355\uFF0C\u518D\u7528 \`--grep\`\u3002\u8FD4\u56DE \`unsupported_type\`\uFF08PDF\u3001\u65E7\u7248 xls\u3001doc\u3001ppt\u3001\u56FE\u7247\u7B49\uFF09\uFF1A\u544A\u8BC9\u4ED6\u8FD9\u4E2A\u683C\u5F0F\u8BFB\u4E0D\u4E86\uFF0C\u8BF7\u4ED6\u8F6C\u6210 xlsx\u3001docx\u3001pptx \u6216 csv \u518D\u53D1\uFF1B\`too_large\`\uFF1A\u6587\u4EF6\u8D85\u8FC7 20MB\uFF1B\`unreadable\`\uFF1A\u6587\u4EF6\u635F\u574F\u6216\u592A\u590D\u6742\uFF1B\`busy\`\uFF1A\u7A0D\u540E\u518D\u8BD5\uFF1B\`lark_error\`\uFF1A\u4ED6\u770B\u4E0D\u5230\u8FD9\u6761\u6D88\u606F\u6216\u6587\u4EF6\u3002\u8BFB\u4E0D\u5230\u9644\u4EF6\u65F6\u5982\u5B9E\u8BF4\uFF0C\u522B\u62FF\u7FA4\u91CC\u7684\u7ED3\u8BBA\u5F53\u6210\u9010\u884C\u6838\u5BF9\u8FC7\u7684\u3002
7537
7538
 
7539
+ \u8BFB\u591A\u7EF4\u8868\u683C\uFF1Afetch-doc \u8BFB\u4E0D\u4E86\u591A\u7EF4\u8868\u683C\uFF0C\u7528 \`read-base\`\u3002\u53EA\u7ED9 \`--url\` \u4E14\u94FE\u63A5\u6CA1\u6307\u5230\u67D0\u5F20\u6570\u636E\u8868\u65F6\uFF0C\u8FD4\u56DE\u6570\u636E\u8868\u6E05\u5355\uFF08\`kind\` \u4E3A tables\uFF09\uFF1B\u518D\u5E26 \`--table\`\uFF08\u8868\u540D\u6216 tbl \u5F00\u5934\u7684 ID\uFF09\u8BFB\u8BB0\u5F55\uFF08\`kind\` \u4E3A records\uFF0C\`markdown\` \u662F\u8868\u683C\u6587\u5B57\uFF0C\u6BCF\u6B21\u6700\u591A \`--limit\` \u884C\uFF0C\u9ED8\u8BA4 100\u3001\u6700\u5927 200\uFF1B\u8FD8\u8981\u540E\u9762\u7684\u884C\u5C31\u7528 \`--offset\` \u7FFB\u9875\uFF0C\u8FD4\u56DE\u7684\u884C\u6570\u7B49\u4E8E limit \u65F6\u591A\u534A\u8FD8\u6709\uFF1B\`truncated\` \u4E3A\u771F\u8BF4\u660E\u6587\u5B57\u88AB\u622A\u65AD\uFF0C\u8C03\u5C0F \`--limit\`\uFF09\u3002\u627E\u4E0D\u5230\u7684\u6570\u636E\u4E0D\u8981\u51ED\u5370\u8C61\u8865\uFF0C\u5148\u770B\u6E05\u5355\u518D\u8BFB\u5BF9\u7684\u90A3\u5F20\u8868\u3002\u8FD4\u56DE \`lark_error\`\uFF1A\u4ED6\u770B\u4E0D\u5230\u8FD9\u5F20\u8868\uFF0C\u6216\u94FE\u63A5\u4E0D\u662F\u591A\u7EF4\u8868\u683C\u3002\u6388\u6743\u91CC\u7F3A\u8BFB\u591A\u7EF4\u8868\u683C\u7684\u6743\u9650\u65F6\uFF0C\u7F51\u5173\u4F1A\u6309 need_auth \u5904\u7406\uFF08\u91CD\u53D1\u6388\u6743\u5361\u7247\uFF09\uFF0C\u4E0D\u7528\u53EB\u4ED6\u64A4\u9500\u6388\u6743\u3002
7540
+
7538
7541
  \u8F93\u51FA\u662F JSON\u3002\u53EA\u5728\u56DE\u7B54\u4ED6\u7684\u95EE\u9898\u9700\u8981\u65F6\u8BFB\uFF0C\u8BFB\u5230\u7684\u5185\u5BB9\u53EA\u7528\u6765\u56DE\u7B54\u8FD9\u4E2A\u4EBA\uFF0C\u522B\u8F6C\u8FF0\u5230\u522B\u5904\u3002\u8FD4\u56DE expired \u8BF4\u660E\u8FD9\u4E00\u8F6E\u7684\u6388\u6743\u5DF2\u8FC7\u671F\uFF0C\u544A\u8BC9\u4ED6\u91CD\u65B0\u53D1\u4E00\u6B21\u95EE\u9898\u3002\u8FD4\u56DE need_auth \u8BF4\u660E\u4ED6\u7684\u6388\u6743\u5931\u6548\u4E86\uFF08\u592A\u4E45\u6CA1\u7528\u6216\u5728\u98DE\u4E66\u91CC\u64A4\u9500\u8FC7\uFF09\uFF0C\u7CFB\u7EDF\u5DF2\u7ECF\u7ED9\u4ED6\u91CD\u53D1\u4E86\u4E00\u5F20\u6388\u6743\u5361\u7247\uFF1A\u544A\u8BC9\u4ED6\u70B9\u5361\u7247\u91CD\u65B0\u6388\u6743\uFF0C\u6388\u6743\u540E\u518D\u95EE\u4E00\u6B21\u3002\u8FD4\u56DE auth_failed \u8BF4\u660E\u6388\u6743\u5931\u6548\u3001\u800C\u4E14\u5361\u7247\u6CA1\u53D1\u51FA\u53BB\uFF1A\u544A\u8BC9\u4ED6\u7A0D\u540E\u518D\u95EE\u4E00\u6B21\u3002
7539
7542
 
7540
7543
  \u6388\u6743\u72B6\u6001\u4EE5\u8FD9\u4E00\u8F6E\u8FD9\u6BB5\u8BF4\u660E\u4E3A\u51C6\uFF1A\u5BF9\u8BDD\u91CC\u66F4\u65E9\u8BF4\u8FC7\u7684\u300C\u8FD8\u6CA1\u6388\u6743\u300D\u300C\u8BF7\u70B9\u6388\u6743\u5361\u7247\u300D\u90FD\u5DF2\u8FC7\u65F6\u3002\u9700\u8981\u8BFB\u4ED6\u7684\u6570\u636E\u65F6\u76F4\u63A5\u8DD1 \`aai-user-read\`\uFF0C\u4EE5\u5B83\u7684\u8FD4\u56DE\u4E3A\u51C6\uFF0C\u4E0D\u8981\u5148\u7528 \`lark-cli auth status\` \u4E4B\u7C7B\u7684\u547D\u4EE4\u786E\u8BA4\u6388\u6743\u3002`;
@@ -20496,9 +20499,14 @@ var USER_READ_SCOPES = [
20496
20499
  "docx:document:readonly",
20497
20500
  "wiki:node:read",
20498
20501
  "drive:drive.metadata:readonly",
20502
+ // 读多维表格(intent 0104):解析链接、列数据表、读记录
20503
+ "base:app:read",
20504
+ "base:table:read",
20505
+ "base:field:read",
20506
+ "base:record:read",
20499
20507
  "offline_access"
20500
20508
  ];
20501
- var READ_APIS = ["search-messages", "get-message", "list-chat-messages", "search-docs", "fetch-doc", "read-file"];
20509
+ var READ_APIS = ["search-messages", "get-message", "list-chat-messages", "search-docs", "fetch-doc", "read-file", "read-base"];
20502
20510
  var HANDLE_TTL_MS = 5 * 6e4;
20503
20511
  var MESSAGE_MAX_AGE_MS = 2 * 6e4;
20504
20512
  var CLOCK_SKEW_MS = 3e4;
@@ -20506,6 +20514,7 @@ var MAX_HANDLES_PER_MESSAGE = 5;
20506
20514
  var MAX_FILE_BYTES = 20 * 1024 * 1024;
20507
20515
  var MAX_TMP_BYTES = 500 * 1024 * 1024;
20508
20516
  var DOWNLOAD_TIMEOUT_MS = 6e4;
20517
+ var BASE_MAX_CHARS = 1e5;
20509
20518
  var MAINTENANCE_MS = 6e4;
20510
20519
  var USED_TTL_MS = MESSAGE_MAX_AGE_MS + CLOCK_SKEW_MS + 6e4;
20511
20520
  var AUTH_POLL_MS = 5e3;
@@ -20613,6 +20622,9 @@ function readArgs(api, input) {
20613
20622
  }
20614
20623
  case "fetch-doc":
20615
20624
  return ["docs", "+fetch", "--as", "user", "--json", "--doc", str2(input, "doc", DOC_REF), "--doc-format", "markdown"];
20625
+ case "read-base":
20626
+ readBaseParams(input);
20627
+ return [];
20616
20628
  case "read-file":
20617
20629
  readFileParams(input);
20618
20630
  return [];
@@ -20624,6 +20636,26 @@ function intParam(input, key, min, max) {
20624
20636
  if (!Number.isInteger(v) || v < min || v > max) throw new BadRequest(`${key} \u8981\u662F ${min}\u2013${max} \u7684\u6574\u6570`);
20625
20637
  return v;
20626
20638
  }
20639
+ function readBaseParams(input) {
20640
+ const url = str2(input, "url", DOC_REF);
20641
+ let table;
20642
+ if (input.table !== void 0) {
20643
+ const t = input.table;
20644
+ if (typeof t !== "string" || !t.trim() || t.length > 100 || /[\u0000-\u001f]/.test(t)) throw new BadRequest("table \u8981 1\u2013100 \u4E2A\u5B57\u7B26");
20645
+ table = t;
20646
+ }
20647
+ return { url, table, offset: intParam(input, "offset", 0, 1e7) ?? 0, limit: intParam(input, "limit", 1, 200) ?? 100 };
20648
+ }
20649
+ function findString2(v, key, depth = 0) {
20650
+ if (depth > 5 || !v || typeof v !== "object") return void 0;
20651
+ const o = v;
20652
+ if (typeof o[key] === "string" && o[key]) return o[key];
20653
+ for (const x of Object.values(o)) {
20654
+ const f = findString2(x, key, depth + 1);
20655
+ if (f) return f;
20656
+ }
20657
+ return void 0;
20658
+ }
20627
20659
  function readFileParams(input) {
20628
20660
  const messageId = str2(input, "messageId", MESSAGE_ID);
20629
20661
  const fileKey = str2(input, "fileKey", FILE_KEY);
@@ -20965,7 +20997,8 @@ function createGateway(opts) {
20965
20997
  }, MAINTENANCE_MS).unref();
20966
20998
  async function larkFailure(h, fields, r) {
20967
20999
  const e = larkError(r);
20968
- if (!r.timedOut && e.type === "authentication") {
21000
+ const missingOurScope = !r.timedOut && /missing_scope/.test(e.detail) && (e.detail.match(/[a-z][a-z_]*:[a-z_.:]*[a-z]/g) ?? []).some((x) => USER_READ_SCOPES.includes(x));
21001
+ if (!r.timedOut && (e.type === "authentication" || missingOurScope)) {
20969
21002
  await rm14(authorizedMark(h.openId), { force: true });
20970
21003
  for (const [k, v] of handles) if (v.openId === h.openId) forget(k, "auth", v.runId);
20971
21004
  try {
@@ -20980,6 +21013,31 @@ function createGateway(opts) {
20980
21013
  log.warn("user-gateway", "read.failed", { ...fields, result: "lark_error", detail: e.detail });
20981
21014
  return { status: "lark_error", detail: r.timedOut ? "\u547D\u4EE4\u8D85\u65F6" : e.detail };
20982
21015
  }
21016
+ async function readBase(h, input, fields) {
21017
+ const p3 = readBaseParams(input);
21018
+ const dir = env(userDir(h.openId));
21019
+ const run2 = (args) => opts.exec(["base", ...args, "--as", "user"], dir, 6e4);
21020
+ const resolved = await run2(["+url-resolve", "--url", p3.url, "--json"]);
21021
+ if (resolved.code !== 0) return larkFailure(h, fields, resolved);
21022
+ const parsed = parseJson4(resolved.stdout);
21023
+ const baseToken = findString2(parsed, "base_token");
21024
+ if (!baseToken || !/^[A-Za-z0-9_-]{8,64}$/.test(baseToken)) {
21025
+ log.warn("user-gateway", "read.failed", { ...fields, result: "lark_error", detail: "not-a-base" });
21026
+ return { status: "lark_error", detail: "\u8FD9\u4E2A\u94FE\u63A5\u4E0D\u662F\u591A\u7EF4\u8868\u683C" };
21027
+ }
21028
+ const tableId = p3.table ?? findString2(parsed, "table_id");
21029
+ let r;
21030
+ if (!tableId) {
21031
+ r = await run2(["+table-list", "--base-token", baseToken, "--json"]);
21032
+ } else {
21033
+ r = await run2(["+record-list", "--base-token", baseToken, "--table-id", tableId, "--offset", String(p3.offset), "--limit", String(p3.limit), "--format", "markdown"]);
21034
+ }
21035
+ if (r.code !== 0) return larkFailure(h, fields, r);
21036
+ log.info("user-gateway", "read.ok", { ...fields, result: "ok" });
21037
+ if (!tableId) return { status: "ok", data: { kind: "tables", tables: parseJson4(r.stdout) ?? r.stdout } };
21038
+ const text = r.stdout.length > BASE_MAX_CHARS ? r.stdout.slice(0, BASE_MAX_CHARS) : r.stdout;
21039
+ return { status: "ok", data: { kind: "records", table: tableId, offset: p3.offset, limit: p3.limit, truncated: text.length < r.stdout.length, markdown: text } };
21040
+ }
20983
21041
  async function readFile19(h, input, fields) {
20984
21042
  const started = Date.now();
20985
21043
  const { messageId, fileKey, opts: ropts } = readFileParams(input);
@@ -21136,6 +21194,7 @@ function createGateway(opts) {
21136
21194
  return { status: "lark_error", detail: String(err instanceof Error ? err.message : err) };
21137
21195
  }
21138
21196
  if (api === "read-file") return readFile19(h, input, fields);
21197
+ if (api === "read-base") return readBase(h, input, fields);
21139
21198
  const r = await opts.exec(args, env(userDir(h.openId)), 6e4);
21140
21199
  if (r.code !== 0) return larkFailure(h, fields, r);
21141
21200
  log.info("user-gateway", "read.ok", { ...fields, result: "ok" });