@bty/customer-service-cli 0.4.6 → 0.4.8

package/README.md

@@ -316,6 +316,7 @@ Agent 关联的通用规则知识库（`suffix_type=_common`），与 FAQ / 商
 | `conversation list [--agent <id>] [--equipment-id <设备ID>] [--user <用户名>] [--start <日期>] [--end <日期>]` | 搜索会话     |
 | `conversation records <conversation_id> [--page-size N] [--direction prev|next]` | 获取会话聊天记录 |
 | `conversation context-search --query <文本> [--start <时间>] [--end <时间>]` | 通过上下文内容模糊搜索对话记录（返回匹配消息详情，时间范围最多 3 天） |
+| `conversation transfer-human --agent <customer_agent_config_id> --start <时间> --end <时间> [--page N]` | 查询转人工会话及对应转人工消息记录（时间范围最多 7 天，分页大小固定 100） |
 
 
 ### Agent 调试 (`debug`)
@@ -647,6 +648,12 @@ cs-cli product add --agent <id> --data @products.json --source batch --no-identi
 # 通过上下文内容模糊搜索对话记录（自动使用当前工作空间，查询窗口最多 3 天）
 cs-cli conversation context-search --query "退款问题" --start 2026-03-22T00:00:00 --end 2026-03-22T23:59:59
 
+# 查询转人工会话及对应转人工消息记录（按 MANUAL_TAKEOVER_REQUIRED 事件时间过滤，查询窗口最多 7 天）
+cs-cli conversation transfer-human --agent <customer_agent_config_id> --start 2026-05-24T00:00:00 --end 2026-05-24T23:59:59
+
+# 查询第 2 页转人工会话
+cs-cli conversation transfer-human --agent <customer_agent_config_id> --start 2026-05-24T00:00:00 --end 2026-05-24T23:59:59 --page 2
+
 # 复现某条回复（自动获取上下文、原始用户名、Agent 配置）
 cs-cli debug reproduce <record_id>
 

package/dist/bin.js

@@ -1004,6 +1004,7 @@ function registerConfigCommand(program2) {
 
 // src/client/conversation-api.ts
 var MAX_CONTEXT_SEARCH_RANGE_MS = 3 * 24 * 60 * 60 * 1e3;
+var MAX_TRANSFER_HUMAN_RANGE_MS = 7 * 24 * 60 * 60 * 1e3;
 function parseSearchTime(value, fieldName) {
   const parsed = new Date(value);
   if (Number.isNaN(parsed.getTime())) {
@@ -1022,6 +1023,16 @@ function validateContextSearchRange(startTime, endTime) {
     throw new Error("\u67E5\u8BE2\u65F6\u95F4\u8303\u56F4\u4E0D\u80FD\u8D85\u8FC73\u5929");
   }
 }
+function validateTransferHumanRange(startTime, endTime) {
+  const start = parseSearchTime(startTime, "\u5F00\u59CB\u65F6\u95F4");
+  const end = parseSearchTime(endTime, "\u7ED3\u675F\u65F6\u95F4");
+  if (end.getTime() < start.getTime()) {
+    throw new Error("\u7ED3\u675F\u65F6\u95F4\u4E0D\u80FD\u65E9\u4E8E\u5F00\u59CB\u65F6\u95F4");
+  }
+  if (end.getTime() - start.getTime() > MAX_TRANSFER_HUMAN_RANGE_MS) {
+    throw new Error("\u67E5\u8BE2\u65F6\u95F4\u8303\u56F4\u4E0D\u80FD\u8D85\u8FC77\u5929");
+  }
+}
 async function contextSearchRecords(opts) {
   validateContextSearchRange(opts.startTime, opts.endTime);
   const wsId = getWorkspaceId(opts.workspaceId);
@@ -1063,6 +1074,19 @@ async function listConversations(opts) {
     }
   });
 }
+async function listTransferHumanConversations(opts) {
+  validateTransferHumanRange(opts.startDate, opts.endDate);
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), "/v1/chat/conversations/transfer-human", {
+    method: "GET",
+    query: {
+      customer_agent_config_id: opts.customerAgentConfigId,
+      start_date: opts.startDate,
+      end_date: opts.endDate,
+      page: opts.page ?? 1
+    }
+  });
+}
 
 // src/commands/conversation.ts
 function registerConversationCommand(program2) {
@@ -1117,6 +1141,20 @@ function registerConversationCommand(program2) {
       process.exit(toExitCode(err));
     }
   });
+  conversation.command("transfer-human").description("\u67E5\u8BE2\u8F6C\u4EBA\u5DE5\u4F1A\u8BDD\u53CA\u5BF9\u5E94\u8F6C\u4EBA\u5DE5\u6D88\u606F\u8BB0\u5F55").requiredOption("--agent <config_id>", "Agent \u914D\u7F6E ID\uFF08customer_agent_config_id\uFF09").requiredOption("--start <date>", "\u5F00\u59CB\u65F6\u95F4\uFF08ISO \u683C\u5F0F\uFF0C\u5982 2026-05-20T00:00:00\uFF09").requiredOption("--end <date>", "\u7ED3\u675F\u65F6\u95F4\uFF08ISO \u683C\u5F0F\uFF0C\u5982 2026-05-20T23:59:59\uFF09").option("--page <number>", "\u9875\u7801", "1").action(async (opts) => {
+    try {
+      const data = await listTransferHumanConversations({
+        customerAgentConfigId: opts.agent,
+        startDate: opts.start,
+        endDate: opts.end,
+        page: Number(opts.page)
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
 }
 
 // src/client/debug-api.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bty/customer-service-cli",
-  "version": "0.4.6",
+  "version": "0.4.8",
   "description": "AI Customer Service CLI - Agent friendly",
   "type": "module",
   "main": "./dist/bin.js",