@xdxer/dingtalk-agent 0.1.1 → 0.1.4-beta.0

package/dist/src/dws.js

@@ -0,0 +1,270 @@
+// dws 硬化包装 —— 这一层是「拦」（TypeScript source）。
+//
+// **上面的每个模块都必须走它，不许自己 spawn dws。**
+//
+// ════════════════════════════════════════════════════════════════
+// 【六条工程纪律】—— 每一条都是踩出来的，违反必出错，而且是【静默】出错
+// ════════════════════════════════════════════════════════════════
+//
+// 1. **拿不到就响亮地死，绝不当成"是空的"。**
+//    不同接口把数据藏在不同层级。读错层级 → 拿到 undefined → 当成"表是空的"
+//    → **一整天的数据可以这么无声丢掉，而且不报错。**
+//    「查到 0 条」和「读错地方了」**必须分得开**。分不开就 die。
+//
+// 2. **分页会静默截断。** 默认页大小有上限，超了就悄悄少给你，
+//    **而且不一定有信号告诉你被截断了。**
+//    **拿不到分页信号 ≠ 没有下一页，那叫「没有信号」。**
+//    **半张表算出来的结果是错的，不是"差不多"。**
+//
+// 3. **创建类：报错了也可能其实建成功了。**
+//    **绝不看返回信封** —— 按名回查 + 内容回读定成败。
+//    推论：**创建类永不盲重试**（会造重复件），失败先按幂等键回查。
+//
+// 4. **写操作报错 ≠ 失败。** 回读实态才定成败。返回 success 也不算验收。
+//
+// 5. **字段读写不对称。** 写进去的形状 ≠ 读回来的形状。**写完必回读。**
+//
+// 6. **markdown 会被重排版。重排版不是漂移。**
+//    判漂移必须剥掉 markdown 符号只看文字流 —— 用行级 diff 会每次都误报，
+//    **然后你就会开始无脑 --force，真漂移也一起覆盖掉。**
+//
+// 一句话：**所有这些坑的形状都一样 —— 它不报错，它给你一个看起来很正常的答案。**
+// 这一层做的就是：**把「看起来正常」和「真的正常」分开。**
+import { spawnSync } from 'node:child_process';
+export class Blocked extends Error {
+}
+export function die(msg) {
+    console.error('[FAIL] ' + msg);
+    throw new Blocked(msg);
+}
+const sleep = (ms) => Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+/** 跑一条 dws。限流退避；超时不当成"空"；坏响应响亮地死。 */
+export function run(args, { allowFail = false, timeout = 180_000, retries = 2 } = {}) {
+    let last = '';
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        const p = spawnSync('dws', [...args, '--format', 'json'], { encoding: 'utf8', timeout, maxBuffer: 64 * 1024 * 1024 });
+        if (p.error) {
+            if (p.error.code === 'ENOENT') {
+                if (allowFail)
+                    return null;
+                die('dws 跑不起来 —— 先 export PATH="$HOME/.local/bin:$PATH"');
+            }
+            last = String(p.error);
+            sleep(2000 * (attempt + 1));
+            continue;
+        }
+        const out = p.stdout || p.stderr || '';
+        last = out.slice(0, 300);
+        const i = out.indexOf('{');
+        if (i < 0) {
+            sleep(2000 * (attempt + 1));
+            continue;
+        }
+        let d;
+        try {
+            d = JSON.parse(out.slice(i, lastBrace(out) + 1));
+        }
+        catch {
+            sleep(2000 * (attempt + 1));
+            continue;
+        }
+        const err = d.error || {};
+        if (err && (err.code || err.message)) {
+            const s = JSON.stringify(err).toLowerCase();
+            if (s.includes('limit') || s.includes('frequen') || s.includes('flow')) {
+                sleep(3000 * (attempt + 1));
+                continue; // 限流 → 退避
+            }
+            if (allowFail)
+                return null;
+            die(`dws 失败 ${args.slice(0, 4).join(' ')}\n  ${JSON.stringify(err).slice(0, 300)}`);
+        }
+        if (p.status !== 0) {
+            if (allowFail)
+                return null;
+            die(`dws 以退出码 ${p.status} 结束，但没有结构化 error: ${args.slice(0, 4).join(' ')}\n  ${last}`);
+        }
+        return d;
+    }
+    if (allowFail)
+        return null;
+    die(`dws 无响应(重试 ${retries} 次) ${args.slice(0, 4).join(' ')}\n  ${last}`);
+}
+function lastBrace(s) {
+    // dws 有时在 JSON 后面粘一行 WARN / INFO —— 从最后一个 } 截断
+    for (let i = s.length - 1; i >= 0; i--)
+        if (s[i] === '}')
+            return i;
+    return s.length - 1;
+}
+// ──────────────── 三个层级，各读各的 ────────────────
+const inner = (d) => (d && typeof d.data === 'object' && d.data !== null ? d.data : d);
+/** 列表类查询的记录。拿不到就 die —— 绝不当成"表是空的"。 */
+export function records(d) {
+    const x = inner(d);
+    if (!('records' in x)) {
+        die(`返回里没有 records(顶层键=${Object.keys(d)}) —— 接口形状可能变了。` +
+            `**绝不把它当成【表是空的】。**`);
+    }
+    if (x.hasMore || x.partial) {
+        die('分页未收敛 —— **部分结果不许当完整结果用。** 半张表算出来的是错的。');
+    }
+    return x.records || [];
+}
+/** 文档正文。**层级和列表类查询不一样** —— 两种形状都兜住，拿不到就 die。 */
+export function markdown(d) {
+    const md = inner(d).markdown ?? d.markdown;
+    if (md === undefined || md === null) {
+        die(`拿不到文档正文(顶层键=${Object.keys(d)}) —— **绝不当成【这篇是空的】。**`);
+    }
+    return md;
+}
+/** 目录节点。 */
+export const nodes = (d) => inner(d).nodes || [];
+/**
+ * 待办翻页 —— **这是唯一有分页信号的读法。**
+ *
+ * ⚠️ **不要把页开大**。超过这个大小，分页信号会消失，
+ *    你拿到 undefined、当成 false，然后**静默漏掉剩下的**。
+ *    心跳的收件靠它 —— 漏了循环件就是「静默收工且不自知」。
+ */
+export function todosPage(status = 'false', page = 1) {
+    const d = run(['todo', 'task', 'list', '--status', status, '--size', '20', '--page', String(page)]);
+    const r = d.result || {};
+    if (!('todoCards' in r)) {
+        die(`待办返回里没有 todoCards(result 键=${Object.keys(r)}) —— 绝不当成【没有待办】。`);
+    }
+    return { cards: r.todoCards || [], more: Boolean(r.hasMore) };
+}
+/** 把待办【拉全】。只看第一页会漏掉循环件。 */
+export function todosAll(status = 'false', maxPages = 20) {
+    const out = [];
+    for (let page = 1; page <= maxPages; page++) {
+        const { cards, more } = todosPage(status, page);
+        out.push(...cards);
+        if (!more)
+            return out;
+    }
+    die(`待办翻页超过 ${maxPages} 页还没收敛 —— 不许把部分结果当完整。`);
+}
+// ──────────────── 创建类：报错也可能成功 → 按名回查 ────────────────
+/** 目录列表可能把扩展名单列，比对时要拼回去。 */
+export function findChild(folder, name) {
+    for (const n of nodes(run(['doc', 'list', '--folder', folder, '--page-size', '50']))) {
+        const nm = n.name || '', ext = n.extension || '';
+        if (nm === name || (ext && `${nm}.${ext}` === name))
+            return n.nodeId;
+    }
+    return null;
+}
+/** 建文档。**不看返回信封** —— 一律按名回查定成败。 */
+export function createDoc(folder, name, file) {
+    const exist = findChild(folder, name);
+    if (exist)
+        return exist;
+    run(['doc', 'create', '--name', name, '--folder', folder,
+        '--content-file', file, '--content-format', 'markdown', '--yes'], { allowFail: true }); // ← **报错也可能其实成功了**
+    sleep(1200);
+    const nid = findChild(folder, name);
+    if (!nid)
+        die(`建不出文档 ${name} —— 别把它当成【建成功了】。`);
+    return nid;
+}
+export const updateDoc = (node, file) => run(['doc', 'update', '--node', node, '--content-file', file,
+    '--content-format', 'markdown', '--mode', 'overwrite', '--yes']);
+export const readDoc = (node, profile = '') => markdown(run([
+    'doc', 'read', '--node', node, ...profileArgs(profile),
+]));
+export const docInfo = (node, profile = '') => inner(run([
+    'doc', 'info', '--node', node, ...profileArgs(profile),
+]));
+// ──────────────── 漂移判定：重排版【不是】漂移 ────────────────
+/**
+ * 剥掉 markdown 语法和转义装饰，只留【文字本身】。
+ *
+ * 钉钉会重排版你推上去的 markdown。**重排版不是漂移。**
+ * 用行级 diff 判漂移 → 每次 sync 都误报 →
+ * **然后你就会开始无脑 --force，真正的漂移也一起覆盖掉了。**
+ */
+export function words(s) {
+    let t = String(s ?? '');
+    for (let i = 0; i < 3; i++)
+        t = unescapeHtml(t); // 可能被多次转义
+    t = t.replace(/&#(\d+);/g, (_, n) => String.fromCharCode(+n));
+    t = t.replace(/\[打开\]\([^)]*\)/g, ''); // 钉钉自动加的链接装饰
+    return t.replace(/[`*_>#|\\~\-\s]+/g, '');
+}
+function unescapeHtml(s) {
+    return s.replace(/&(amp|lt|gt|quot|#39);/g, (m, e) => ({ amp: '&', lt: '<', gt: '>', quot: '"', '#39': "'" })[e]);
+}
+export const same = (a, b) => words(a) === words(b);
+// ──────────────── 数字员工的消息原子动作（typed，目标不可自由拼装） ────────────────
+function profileArgs(profile) {
+    return profile ? ['--profile', profile] : [];
+}
+function assertReplyTarget(target) {
+    const missing = [];
+    if (!target?.conversationId)
+        missing.push('conversationId');
+    if (!target?.messageId)
+        missing.push('messageId');
+    if (!target?.senderOpenDingTalkId)
+        missing.push('senderOpenDingTalkId');
+    if (missing.length)
+        die(`固定回复目标缺少 ${missing.join(' / ')}`);
+}
+/** ack 没有服务端 UUID，因此绝不自动重试。 */
+export function ackMessage(target, { emoji = '收到', profile = '' } = {}) {
+    assertReplyTarget(target);
+    return run([
+        'chat', 'message', 'add-emoji',
+        '--conversation-id', target.conversationId,
+        '--msg-id', target.messageId,
+        '--emoji', emoji,
+        ...profileArgs(profile),
+    ], { retries: 0 });
+}
+/** reply/ask 共用同一传输；uuid 在调用前已持久化，重试也必须复用。 */
+export function replyMessage(target, text, { uuid = '', profile = '' } = {}) {
+    assertReplyTarget(target);
+    if (!String(text || '').trim())
+        die('回复正文不能为空');
+    if (!uuid)
+        die('回复前必须先持久化 uuid 幂等键');
+    return run([
+        'chat', 'message', 'reply',
+        '--conversation-id', target.conversationId,
+        '--ref-msg-id', target.messageId,
+        '--ref-sender', target.senderOpenDingTalkId,
+        '--text', text,
+        '--uuid', uuid,
+        '--ai-tag=true',
+        ...profileArgs(profile),
+        '--yes',
+    ], { retries: 1 });
+}
+export function readMessageEmotions(messageId, profile = '') {
+    return run([
+        'chat', 'message', 'list-emotion-replies', '--msg-ids', messageId,
+        ...profileArgs(profile),
+    ], { allowFail: true, retries: 0 });
+}
+export function querySendStatus(openTaskId, profile = '') {
+    return run([
+        'chat', 'message', 'query-send-status', '--open-task-id', openTaskId,
+        ...profileArgs(profile),
+    ], { allowFail: true, retries: 1 });
+}
+export function readMessagesByIds(messageId, profile = '') {
+    return run([
+        'chat', 'message', 'list-by-ids', '--msg-ids', messageId,
+        ...profileArgs(profile),
+    ], { allowFail: true, retries: 1 });
+}
+/** 外发前核对 profile 对应的真实执行身份。 */
+export function getSelf(profile = '') {
+    return run([
+        'contact', 'user', 'get-self', ...profileArgs(profile),
+    ], { retries: 1 });
+}
+//# sourceMappingURL=dws.js.map

package/dist/src/dws.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dws.js","sourceRoot":"","sources":["../../src/dws.ts"],"names":[],"mappings":"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","sourcesContent":["// dws 硬化包装 —— 这一层是「拦」（TypeScript source）。\n//\n// **上面的每个模块都必须走它，不许自己 spawn dws。**\n//\n// ════════════════════════════════════════════════════════════════\n// 【六条工程纪律】—— 每一条都是踩出来的，违反必出错，而且是【静默】出错\n// ════════════════════════════════════════════════════════════════\n//\n// 1. **拿不到就响亮地死，绝不当成\"是空的\"。**\n//    不同接口把数据藏在不同层级。读错层级 → 拿到 undefined → 当成\"表是空的\"\n//    → **一整天的数据可以这么无声丢掉，而且不报错。**\n//    「查到 0 条」和「读错地方了」**必须分得开**。分不开就 die。\n//\n// 2. **分页会静默截断。** 默认页大小有上限，超了就悄悄少给你，\n//    **而且不一定有信号告诉你被截断了。**\n//    **拿不到分页信号 ≠ 没有下一页，那叫「没有信号」。**\n//    **半张表算出来的结果是错的，不是\"差不多\"。**\n//\n// 3. **创建类：报错了也可能其实建成功了。**\n//    **绝不看返回信封** —— 按名回查 + 内容回读定成败。\n//    推论：**创建类永不盲重试**（会造重复件），失败先按幂等键回查。\n//\n// 4. **写操作报错 ≠ 失败。** 回读实态才定成败。返回 success 也不算验收。\n//\n// 5. **字段读写不对称。** 写进去的形状 ≠ 读回来的形状。**写完必回读。**\n//\n// 6. **markdown 会被重排版。重排版不是漂移。**\n//    判漂移必须剥掉 markdown 符号只看文字流 —— 用行级 diff 会每次都误报，\n//    **然后你就会开始无脑 --force，真漂移也一起覆盖掉。**\n//\n// 一句话：**所有这些坑的形状都一样 —— 它不报错，它给你一个看起来很正常的答案。**\n// 这一层做的就是：**把「看起来正常」和「真的正常」分开。**\n\nimport { spawnSync } from 'node:child_process'\n\nexport class Blocked extends Error {}\n\nexport function die(msg): never {\n  console.error('[FAIL] ' + msg)\n  throw new Blocked(msg)\n}\n\nconst sleep = (ms) => Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms)\n\n/** 跑一条 dws。限流退避；超时不当成\"空\"；坏响应响亮地死。 */\nexport function run(args, { allowFail = false, timeout = 180_000, retries = 2 } = {}) {\n  let last = ''\n  for (let attempt = 0; attempt <= retries; attempt++) {\n    const p = spawnSync('dws', [...args, '--format', 'json'],\n      { encoding: 'utf8', timeout, maxBuffer: 64 * 1024 * 1024 })\n    if (p.error) {\n      if ((p.error as NodeJS.ErrnoException).code === 'ENOENT') {\n        if (allowFail) return null\n        die('dws 跑不起来 —— 先 export PATH=\"$HOME/.local/bin:$PATH\"')\n      }\n      last = String(p.error); sleep(2000 * (attempt + 1)); continue\n    }\n    const out = p.stdout || p.stderr || ''\n    last = out.slice(0, 300)\n    const i = out.indexOf('{')\n    if (i < 0) { sleep(2000 * (attempt + 1)); continue }\n    let d\n    try { d = JSON.parse(out.slice(i, lastBrace(out) + 1)) }\n    catch { sleep(2000 * (attempt + 1)); continue }\n    const err = d.error || {}\n    if (err && (err.code || err.message)) {\n      const s = JSON.stringify(err).toLowerCase()\n      if (s.includes('limit') || s.includes('frequen') || s.includes('flow')) {\n        sleep(3000 * (attempt + 1)); continue          // 限流 → 退避\n      }\n      if (allowFail) return null\n      die(`dws 失败 ${args.slice(0, 4).join(' ')}\\n  ${JSON.stringify(err).slice(0, 300)}`)\n    }\n    if (p.status !== 0) {\n      if (allowFail) return null\n      die(`dws 以退出码 ${p.status} 结束，但没有结构化 error: ${args.slice(0, 4).join(' ')}\\n  ${last}`)\n    }\n    return d\n  }\n  if (allowFail) return null\n  die(`dws 无响应(重试 ${retries} 次) ${args.slice(0, 4).join(' ')}\\n  ${last}`)\n}\n\nfunction lastBrace(s) {\n  // dws 有时在 JSON 后面粘一行 WARN / INFO —— 从最后一个 } 截断\n  for (let i = s.length - 1; i >= 0; i--) if (s[i] === '}') return i\n  return s.length - 1\n}\n\n// ──────────────── 三个层级，各读各的 ────────────────\nconst inner = (d) => (d && typeof d.data === 'object' && d.data !== null ? d.data : d)\n\n/** 列表类查询的记录。拿不到就 die —— 绝不当成\"表是空的\"。 */\nexport function records(d) {\n  const x = inner(d)\n  if (!('records' in x)) {\n    die(`返回里没有 records(顶层键=${Object.keys(d)}) —— 接口形状可能变了。` +\n        `**绝不把它当成【表是空的】。**`)\n  }\n  if (x.hasMore || x.partial) {\n    die('分页未收敛 —— **部分结果不许当完整结果用。** 半张表算出来的是错的。')\n  }\n  return x.records || []\n}\n\n/** 文档正文。**层级和列表类查询不一样** —— 两种形状都兜住，拿不到就 die。 */\nexport function markdown(d) {\n  const md = inner(d).markdown ?? d.markdown\n  if (md === undefined || md === null) {\n    die(`拿不到文档正文(顶层键=${Object.keys(d)}) —— **绝不当成【这篇是空的】。**`)\n  }\n  return md\n}\n\n/** 目录节点。 */\nexport const nodes = (d) => inner(d).nodes || []\n\n/**\n * 待办翻页 —— **这是唯一有分页信号的读法。**\n *\n * ⚠️ **不要把页开大**。超过这个大小，分页信号会消失，\n *    你拿到 undefined、当成 false，然后**静默漏掉剩下的**。\n *    心跳的收件靠它 —— 漏了循环件就是「静默收工且不自知」。\n */\nexport function todosPage(status = 'false', page = 1) {\n  const d = run(['todo', 'task', 'list', '--status', status, '--size', '20', '--page', String(page)])\n  const r = d.result || {}\n  if (!('todoCards' in r)) {\n    die(`待办返回里没有 todoCards(result 键=${Object.keys(r)}) —— 绝不当成【没有待办】。`)\n  }\n  return { cards: r.todoCards || [], more: Boolean(r.hasMore) }\n}\n\n/** 把待办【拉全】。只看第一页会漏掉循环件。 */\nexport function todosAll(status = 'false', maxPages = 20) {\n  const out: any[] = []\n  for (let page = 1; page <= maxPages; page++) {\n    const { cards, more } = todosPage(status, page)\n    out.push(...cards)\n    if (!more) return out\n  }\n  die(`待办翻页超过 ${maxPages} 页还没收敛 —— 不许把部分结果当完整。`)\n}\n\n// ──────────────── 创建类：报错也可能成功 → 按名回查 ────────────────\n/** 目录列表可能把扩展名单列，比对时要拼回去。 */\nexport function findChild(folder, name) {\n  for (const n of nodes(run(['doc', 'list', '--folder', folder, '--page-size', '50']))) {\n    const nm = n.name || '', ext = n.extension || ''\n    if (nm === name || (ext && `${nm}.${ext}` === name)) return n.nodeId\n  }\n  return null\n}\n\n/** 建文档。**不看返回信封** —— 一律按名回查定成败。 */\nexport function createDoc(folder, name, file) {\n  const exist = findChild(folder, name)\n  if (exist) return exist\n  run(['doc', 'create', '--name', name, '--folder', folder,\n       '--content-file', file, '--content-format', 'markdown', '--yes'],\n      { allowFail: true })                     // ← **报错也可能其实成功了**\n  sleep(1200)\n  const nid = findChild(folder, name)\n  if (!nid) die(`建不出文档 ${name} —— 别把它当成【建成功了】。`)\n  return nid\n}\n\nexport const updateDoc = (node, file) =>\n  run(['doc', 'update', '--node', node, '--content-file', file,\n       '--content-format', 'markdown', '--mode', 'overwrite', '--yes'])\n\nexport const readDoc = (node, profile = '') => markdown(run([\n  'doc', 'read', '--node', node, ...profileArgs(profile),\n]))\nexport const docInfo = (node, profile = '') => inner(run([\n  'doc', 'info', '--node', node, ...profileArgs(profile),\n]))\n\n// ──────────────── 漂移判定：重排版【不是】漂移 ────────────────\n/**\n * 剥掉 markdown 语法和转义装饰，只留【文字本身】。\n *\n * 钉钉会重排版你推上去的 markdown。**重排版不是漂移。**\n * 用行级 diff 判漂移 → 每次 sync 都误报 →\n * **然后你就会开始无脑 --force，真正的漂移也一起覆盖掉了。**\n */\nexport function words(s) {\n  let t = String(s ?? '')\n  for (let i = 0; i < 3; i++) t = unescapeHtml(t)     // 可能被多次转义\n  t = t.replace(/&#(\\d+);/g, (_, n) => String.fromCharCode(+n))\n  t = t.replace(/\\[打开\\]\\([^)]*\\)/g, '')             // 钉钉自动加的链接装饰\n  return t.replace(/[`*_>#|\\\\~\\-\\s]+/g, '')\n}\n\nfunction unescapeHtml(s) {\n  return s.replace(/&(amp|lt|gt|quot|#39);/g, (m, e) =>\n    ({ amp: '&', lt: '<', gt: '>', quot: '\"', '#39': \"'\" })[e])\n}\n\nexport const same = (a, b) => words(a) === words(b)\n\n// ──────────────── 数字员工的消息原子动作（typed，目标不可自由拼装） ────────────────\nfunction profileArgs(profile) {\n  return profile ? ['--profile', profile] : []\n}\n\nfunction assertReplyTarget(target) {\n  const missing: string[] = []\n  if (!target?.conversationId) missing.push('conversationId')\n  if (!target?.messageId) missing.push('messageId')\n  if (!target?.senderOpenDingTalkId) missing.push('senderOpenDingTalkId')\n  if (missing.length) die(`固定回复目标缺少 ${missing.join(' / ')}`)\n}\n\n/** ack 没有服务端 UUID，因此绝不自动重试。 */\nexport function ackMessage(target, { emoji = '收到', profile = '' } = {}) {\n  assertReplyTarget(target)\n  return run([\n    'chat', 'message', 'add-emoji',\n    '--conversation-id', target.conversationId,\n    '--msg-id', target.messageId,\n    '--emoji', emoji,\n    ...profileArgs(profile),\n  ], { retries: 0 })\n}\n\n/** reply/ask 共用同一传输；uuid 在调用前已持久化，重试也必须复用。 */\nexport function replyMessage(\n  target,\n  text,\n  { uuid = '', profile = '' }: { uuid?: string; profile?: string } = {},\n) {\n  assertReplyTarget(target)\n  if (!String(text || '').trim()) die('回复正文不能为空')\n  if (!uuid) die('回复前必须先持久化 uuid 幂等键')\n  return run([\n    'chat', 'message', 'reply',\n    '--conversation-id', target.conversationId,\n    '--ref-msg-id', target.messageId,\n    '--ref-sender', target.senderOpenDingTalkId,\n    '--text', text,\n    '--uuid', uuid,\n    '--ai-tag=true',\n    ...profileArgs(profile),\n    '--yes',\n  ], { retries: 1 })\n}\n\nexport function readMessageEmotions(messageId, profile = '') {\n  return run([\n    'chat', 'message', 'list-emotion-replies', '--msg-ids', messageId,\n    ...profileArgs(profile),\n  ], { allowFail: true, retries: 0 })\n}\n\nexport function querySendStatus(openTaskId, profile = '') {\n  return run([\n    'chat', 'message', 'query-send-status', '--open-task-id', openTaskId,\n    ...profileArgs(profile),\n  ], { allowFail: true, retries: 1 })\n}\n\nexport function readMessagesByIds(messageId, profile = '') {\n  return run([\n    'chat', 'message', 'list-by-ids', '--msg-ids', messageId,\n    ...profileArgs(profile),\n  ], { allowFail: true, retries: 1 })\n}\n\n/** 外发前核对 profile 对应的真实执行身份。 */\nexport function getSelf(profile = '') {\n  return run([\n    'contact', 'user', 'get-self', ...profileArgs(profile),\n  ], { retries: 1 })\n}\n"]}

package/dist/src/events.js

@@ -0,0 +1,233 @@
+// 钉钉原始事件 → 与平台细节解耦的内部 Event Contract（TypeScript source）。
+// 消息正文始终是 data；只有 envelope 中的 ID 才能决定作用域和回复目标。
+import { createHash } from 'node:crypto';
+const KIND = {
+    user_im_message_receive_at: 'im.message.mentioned',
+    user_im_message_receive_o2o: 'im.message.dm',
+    user_im_message_receive_group: 'im.message.group',
+    heartbeat: 'agent.heartbeat',
+    'agent.heartbeat': 'agent.heartbeat',
+};
+export function digest(value) {
+    return createHash('sha256').update(String(value)).digest('hex');
+}
+export function stableStringify(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(stableStringify).join(',')}]`;
+    return `{${Object.keys(value).sort().map((k) => `${JSON.stringify(k)}:${stableStringify(value[k])}`).join(',')}}`;
+}
+export function parseEventInput(value) {
+    if (typeof value !== 'string')
+        return value;
+    const text = value.trim();
+    if (!text)
+        throw new Error('事件输入是空的');
+    try {
+        return JSON.parse(text);
+    }
+    catch (e) {
+        throw new Error(`事件不是合法 JSON: ${e.message}`);
+    }
+}
+/**
+ * dws event consume 的 stdout 是 envelope，业务字段在 data JSON 字符串内。
+ * 同时兼容 schema 已展开的测试 fixture 和更底层的 payload.body 形状。
+ */
+export function normalizeEvent(input) {
+    const envelope = parseEventInput(input);
+    if (!envelope || typeof envelope !== 'object' || Array.isArray(envelope)) {
+        throw new Error('事件必须是 JSON object');
+    }
+    const envelopeRecord = envelope;
+    const body = unwrapData(envelopeRecord);
+    const rawType = string(first(body, [
+        'type', 'event_key', 'eventKey', 'event_type', 'payload.type',
+    ]) || first(envelopeRecord, ['type', 'event_key', 'eventKey']));
+    const kind = string(first(body, ['kind'])) || KIND[rawType] || rawType;
+    if (!kind)
+        throw new Error('事件缺少 type/kind，无法选择 Basic Behavior');
+    const messageId = string(first(body, [
+        'message_id', 'messageId', 'openMessageId', 'payload.body.openMessageId',
+    ]));
+    const conversationId = string(first(body, [
+        'conversation_id', 'conversationId', 'openConversationId',
+        'payload.body.openConversationId',
+    ]));
+    const senderOpenId = string(first(body, [
+        'sender_open_dingtalk_id', 'senderOpenDingTalkId', 'actor.openDingTalkId',
+        'payload.body.senderOpenDingTalkId',
+    ]));
+    const senderUserId = string(first(body, [
+        'sender_user_id', 'senderUserId', 'actor.userId', 'payload.body.senderUserId',
+    ]));
+    const senderName = string(first(body, [
+        'sender', 'sender_name', 'senderName', 'actor.displayName', 'payload.body.sender',
+    ]));
+    const text = string(first(body, [
+        'content', 'text', 'message.text', 'payload.body.content',
+    ]), true);
+    const threadId = string(first(body, [
+        'thread_id', 'threadId', 'openConvThreadId', 'payload.body.openConvThreadId',
+    ]));
+    const rootMessageId = string(first(body, [
+        'root_message_id', 'rootMessageId', 'payload.body.rootMessageId',
+    ]));
+    const taskId = string(first(body, ['task_id', 'taskId', 'issue_id', 'issueId']));
+    const suppliedCorrelation = string(first(body, [
+        'correlation_id', 'correlationId', 'session_key', 'sessionKey',
+    ]));
+    const occurredAt = asTime(first(body, [
+        'event_time', 'eventTime', 'timestamp', 'occurredAtMs', 'create_time',
+        'createTime', 'payload.event_time', 'payload.body.createTime',
+    ]));
+    const tenantId = string(first(body, [
+        'tenant_id', 'tenantId', 'corp_id', 'corpId', 'event_corp_id', 'eventCorpId',
+        'payload.corpId', 'payload.body.corpId',
+    ]) || first(envelopeRecord, ['tenant_id', 'tenantId', 'corp_id', 'corpId', 'event_corp_id']));
+    const rawEventId = string(first(body, [
+        'event_id', 'eventId', 'id', 'payload.event_id',
+    ]) || first(envelopeRecord, ['event_id', 'eventId', 'id']));
+    // 即使源事件漏了时间，同一份原始输入也必须得到同一个派生 ID。
+    const derivedSeed = stableStringify(envelopeRecord);
+    const eventId = rawEventId || `derived_${digest(derivedSeed).slice(0, 24)}`;
+    const isMessage = String(kind).startsWith('im.message.');
+    if (isMessage) {
+        const missing = [];
+        if (!conversationId)
+            missing.push('conversation_id');
+        if (!messageId)
+            missing.push('message_id');
+        if (!senderOpenId)
+            missing.push('sender_open_dingtalk_id');
+        if (missing.length) {
+            throw new Error(`消息事件缺少 ${missing.join(' / ')}；不能安全固定回复目标`);
+        }
+    }
+    const correlation = suppliedCorrelation
+        ? { source: 'correlation', key: suppliedCorrelation }
+        : taskId
+            ? { source: 'task', key: taskId }
+            : threadId
+                ? { source: 'thread', key: threadId }
+                : rootMessageId
+                    ? { source: 'message-topic', key: rootMessageId }
+                    : messageId
+                        ? { source: 'message-topic', key: messageId }
+                        : { source: 'event', key: eventId };
+    return {
+        $schema: 'dingtalk-agent/event@1',
+        id: eventId,
+        idSource: rawEventId ? 'source' : 'derived',
+        kind,
+        occurredAt,
+        source: {
+            adapter: rawType.startsWith('user_im_') ? 'dws-event' : 'custom',
+            type: rawType || kind,
+            subscribeId: string(first(body, ['subscribe_id', 'subscribeId', 'subId'])),
+        },
+        tenant: { id: tenantId },
+        actor: {
+            id: senderOpenId || senderUserId || 'system',
+            openDingTalkId: senderOpenId,
+            userId: senderUserId,
+            displayName: senderName,
+        },
+        conversation: {
+            id: conversationId,
+            type: conversationType(kind, first(body, ['conversation_type', 'conversationType'])),
+        },
+        message: {
+            id: messageId,
+            text,
+            threadId,
+            rootMessageId,
+        },
+        correlation,
+        replyTarget: isMessage ? {
+            tenantId,
+            conversationId,
+            messageId,
+            senderOpenDingTalkId: senderOpenId,
+        } : null,
+    };
+}
+/** Agent/Driver 共用的极简语义事件；原始平台 envelope 另行留档。 */
+export function compactEvent(event, contextId) {
+    return {
+        $schema: 'dingtalk-agent/trigger@1',
+        id: event.id,
+        type: event.kind,
+        contextId,
+        occurredAt: event.occurredAt,
+        conversationId: event.conversation.id,
+        messageId: event.message.id,
+        actorId: event.actor.openDingTalkId || event.actor.userId || event.actor.id,
+        actorName: event.actor.displayName,
+        text: event.message.text,
+    };
+}
+function unwrapData(envelope) {
+    if (typeof envelope.data !== 'string')
+        return envelope.data && typeof envelope.data === 'object'
+            ? envelope.data
+            : envelope;
+    try {
+        const parsed = JSON.parse(envelope.data);
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+            ? parsed
+            : envelope;
+    }
+    catch (e) {
+        throw new Error(`事件 data 不是合法 JSON 字符串: ${e.message}`);
+    }
+}
+function first(obj, paths) {
+    for (const path of paths) {
+        let value = obj;
+        for (const key of path.split('.')) {
+            if (value === null || value === undefined || typeof value !== 'object') {
+                value = undefined;
+                break;
+            }
+            value = value[key];
+        }
+        if (value !== undefined && value !== null && value !== '')
+            return value;
+    }
+    return undefined;
+}
+function string(value, keepEmpty = false) {
+    if (value === undefined || value === null)
+        return '';
+    if (typeof value === 'object')
+        return '';
+    const out = String(value);
+    return keepEmpty ? out : out.trim();
+}
+function asTime(value) {
+    if (value === undefined || value === null || value === '')
+        return null;
+    const n = Number(value);
+    if (Number.isFinite(n) && String(value).trim() !== '') {
+        const ms = n < 10_000_000_000 ? n * 1000 : n;
+        const d = new Date(ms);
+        if (!Number.isNaN(d.getTime()))
+            return d.toISOString();
+    }
+    const d = new Date(String(value));
+    return Number.isNaN(d.getTime()) ? null : d.toISOString();
+}
+function conversationType(kind, supplied) {
+    if (supplied)
+        return String(supplied);
+    if (kind === 'im.message.dm')
+        return 'dm';
+    if (kind === 'im.message.group')
+        return 'group';
+    if (kind === 'im.message.mentioned')
+        return 'mentioned-context';
+    return 'none';
+}
+//# sourceMappingURL=events.js.map

package/dist/src/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":"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","sourcesContent":["// 钉钉原始事件 → 与平台细节解耦的内部 Event Contract（TypeScript source）。\n// 消息正文始终是 data；只有 envelope 中的 ID 才能决定作用域和回复目标。\n\nimport { createHash } from 'node:crypto'\nimport type { CompactEvent, EventKind, NormalizedEvent } from './types.js'\n\nconst KIND: Record<string, EventKind> = {\n  user_im_message_receive_at: 'im.message.mentioned',\n  user_im_message_receive_o2o: 'im.message.dm',\n  user_im_message_receive_group: 'im.message.group',\n  heartbeat: 'agent.heartbeat',\n  'agent.heartbeat': 'agent.heartbeat',\n}\n\nexport function digest(value: unknown): string {\n  return createHash('sha256').update(String(value)).digest('hex')\n}\n\nexport function stableStringify(value: any): string {\n  if (value === null || typeof value !== 'object') return JSON.stringify(value)\n  if (Array.isArray(value)) return `[${value.map(stableStringify).join(',')}]`\n  return `{${Object.keys(value).sort().map((k) =>\n    `${JSON.stringify(k)}:${stableStringify(value[k])}`).join(',')}}`\n}\n\nexport function parseEventInput(value: unknown): unknown {\n  if (typeof value !== 'string') return value\n  const text = value.trim()\n  if (!text) throw new Error('事件输入是空的')\n  try { return JSON.parse(text) }\n  catch (e) { throw new Error(`事件不是合法 JSON: ${e.message}`) }\n}\n\n/**\n * dws event consume 的 stdout 是 envelope，业务字段在 data JSON 字符串内。\n * 同时兼容 schema 已展开的测试 fixture 和更底层的 payload.body 形状。\n */\nexport function normalizeEvent(input: unknown): NormalizedEvent {\n  const envelope = parseEventInput(input)\n  if (!envelope || typeof envelope !== 'object' || Array.isArray(envelope)) {\n    throw new Error('事件必须是 JSON object')\n  }\n  const envelopeRecord = envelope as Record<string, any>\n  const body = unwrapData(envelopeRecord)\n  const rawType = string(first(body, [\n    'type', 'event_key', 'eventKey', 'event_type', 'payload.type',\n  ]) || first(envelopeRecord, ['type', 'event_key', 'eventKey']))\n  const kind = string(first(body, ['kind'])) || KIND[rawType] || rawType\n  if (!kind) throw new Error('事件缺少 type/kind，无法选择 Basic Behavior')\n\n  const messageId = string(first(body, [\n    'message_id', 'messageId', 'openMessageId', 'payload.body.openMessageId',\n  ]))\n  const conversationId = string(first(body, [\n    'conversation_id', 'conversationId', 'openConversationId',\n    'payload.body.openConversationId',\n  ]))\n  const senderOpenId = string(first(body, [\n    'sender_open_dingtalk_id', 'senderOpenDingTalkId', 'actor.openDingTalkId',\n    'payload.body.senderOpenDingTalkId',\n  ]))\n  const senderUserId = string(first(body, [\n    'sender_user_id', 'senderUserId', 'actor.userId', 'payload.body.senderUserId',\n  ]))\n  const senderName = string(first(body, [\n    'sender', 'sender_name', 'senderName', 'actor.displayName', 'payload.body.sender',\n  ]))\n  const text = string(first(body, [\n    'content', 'text', 'message.text', 'payload.body.content',\n  ]), true)\n  const threadId = string(first(body, [\n    'thread_id', 'threadId', 'openConvThreadId', 'payload.body.openConvThreadId',\n  ]))\n  const rootMessageId = string(first(body, [\n    'root_message_id', 'rootMessageId', 'payload.body.rootMessageId',\n  ]))\n  const taskId = string(first(body, ['task_id', 'taskId', 'issue_id', 'issueId']))\n  const suppliedCorrelation = string(first(body, [\n    'correlation_id', 'correlationId', 'session_key', 'sessionKey',\n  ]))\n  const occurredAt = asTime(first(body, [\n    'event_time', 'eventTime', 'timestamp', 'occurredAtMs', 'create_time',\n    'createTime', 'payload.event_time', 'payload.body.createTime',\n  ]))\n  const tenantId = string(first(body, [\n    'tenant_id', 'tenantId', 'corp_id', 'corpId', 'event_corp_id', 'eventCorpId',\n    'payload.corpId', 'payload.body.corpId',\n  ]) || first(envelopeRecord, ['tenant_id', 'tenantId', 'corp_id', 'corpId', 'event_corp_id']))\n\n  const rawEventId = string(first(body, [\n    'event_id', 'eventId', 'id', 'payload.event_id',\n  ]) || first(envelopeRecord, ['event_id', 'eventId', 'id']))\n  // 即使源事件漏了时间，同一份原始输入也必须得到同一个派生 ID。\n  const derivedSeed = stableStringify(envelopeRecord)\n  const eventId = rawEventId || `derived_${digest(derivedSeed).slice(0, 24)}`\n\n  const isMessage = String(kind).startsWith('im.message.')\n  if (isMessage) {\n    const missing: string[] = []\n    if (!conversationId) missing.push('conversation_id')\n    if (!messageId) missing.push('message_id')\n    if (!senderOpenId) missing.push('sender_open_dingtalk_id')\n    if (missing.length) {\n      throw new Error(`消息事件缺少 ${missing.join(' / ')}；不能安全固定回复目标`)\n    }\n  }\n\n  const correlation = suppliedCorrelation\n    ? { source: 'correlation', key: suppliedCorrelation }\n    : taskId\n      ? { source: 'task', key: taskId }\n      : threadId\n        ? { source: 'thread', key: threadId }\n        : rootMessageId\n          ? { source: 'message-topic', key: rootMessageId }\n          : messageId\n            ? { source: 'message-topic', key: messageId }\n            : { source: 'event', key: eventId }\n\n  return {\n    $schema: 'dingtalk-agent/event@1',\n    id: eventId,\n    idSource: rawEventId ? 'source' : 'derived',\n    kind,\n    occurredAt,\n    source: {\n      adapter: rawType.startsWith('user_im_') ? 'dws-event' : 'custom',\n      type: rawType || kind,\n      subscribeId: string(first(body, ['subscribe_id', 'subscribeId', 'subId'])),\n    },\n    tenant: { id: tenantId },\n    actor: {\n      id: senderOpenId || senderUserId || 'system',\n      openDingTalkId: senderOpenId,\n      userId: senderUserId,\n      displayName: senderName,\n    },\n    conversation: {\n      id: conversationId,\n      type: conversationType(kind, first(body, ['conversation_type', 'conversationType'])),\n    },\n    message: {\n      id: messageId,\n      text,\n      threadId,\n      rootMessageId,\n    },\n    correlation,\n    replyTarget: isMessage ? {\n      tenantId,\n      conversationId,\n      messageId,\n      senderOpenDingTalkId: senderOpenId,\n    } : null,\n  }\n}\n\n/** Agent/Driver 共用的极简语义事件；原始平台 envelope 另行留档。 */\nexport function compactEvent(event: NormalizedEvent, contextId: string): CompactEvent {\n  return {\n    $schema: 'dingtalk-agent/trigger@1',\n    id: event.id,\n    type: event.kind,\n    contextId,\n    occurredAt: event.occurredAt,\n    conversationId: event.conversation.id,\n    messageId: event.message.id,\n    actorId: event.actor.openDingTalkId || event.actor.userId || event.actor.id,\n    actorName: event.actor.displayName,\n    text: event.message.text,\n  }\n}\n\nfunction unwrapData(envelope: Record<string, any>): Record<string, any> {\n  if (typeof envelope.data !== 'string') return envelope.data && typeof envelope.data === 'object'\n    ? envelope.data as Record<string, any>\n    : envelope\n  try {\n    const parsed = JSON.parse(envelope.data)\n    return parsed && typeof parsed === 'object' && !Array.isArray(parsed)\n      ? parsed as Record<string, any>\n      : envelope\n  } catch (e) {\n    throw new Error(`事件 data 不是合法 JSON 字符串: ${e.message}`)\n  }\n}\n\nfunction first(obj: Record<string, any>, paths: string[]): unknown {\n  for (const path of paths) {\n    let value: any = obj\n    for (const key of path.split('.')) {\n      if (value === null || value === undefined || typeof value !== 'object') {\n        value = undefined\n        break\n      }\n      value = value[key]\n    }\n    if (value !== undefined && value !== null && value !== '') return value\n  }\n  return undefined\n}\n\nfunction string(value: unknown, keepEmpty = false): string {\n  if (value === undefined || value === null) return ''\n  if (typeof value === 'object') return ''\n  const out = String(value)\n  return keepEmpty ? out : out.trim()\n}\n\nfunction asTime(value: unknown): string | null {\n  if (value === undefined || value === null || value === '') return null\n  const n = Number(value)\n  if (Number.isFinite(n) && String(value).trim() !== '') {\n    const ms = n < 10_000_000_000 ? n * 1000 : n\n    const d = new Date(ms)\n    if (!Number.isNaN(d.getTime())) return d.toISOString()\n  }\n  const d = new Date(String(value))\n  return Number.isNaN(d.getTime()) ? null : d.toISOString()\n}\n\nfunction conversationType(kind: EventKind, supplied: unknown): string {\n  if (supplied) return String(supplied)\n  if (kind === 'im.message.dm') return 'dm'\n  if (kind === 'im.message.group') return 'group'\n  if (kind === 'im.message.mentioned') return 'mentioned-context'\n  return 'none'\n}\n"]}