@bty/customer-service-cli 0.5.2 → 0.5.3

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.5.3 (2026-05-28)
+
+- 新增 `activity` 主语，覆盖活动 V2（Issue #34）增删改查 + per-tenant 总开关。对接 `customer-servhub-api /v1/activity*`，契约详情参见 [`docs/devkit/specs/2026-05-28-activity-v2-api-reference.md`](../../docs/devkit/specs/2026-05-28-activity-v2-api-reference.md)：
+  - `activity list --agent <id> [--page N] [--page-size N] [--search <text>]`：列出活动（含 `total`、`v2_activity_enabled`、`items[]`）。
+  - `activity by-product --agent <id> --product-id <id>`：按 product_id 反查当前生效活动（仅 enabled，items[].products 恒为 []）。
+  - `activity create --data <json|@file>`：创建活动（完整 `IActivityWritePayload`，文件路径加 `@` 前缀走 JSON 解析）。
+  - `activity update <activity_id> --data <json|@file>`：整体更新活动（products 整组替换，非增量 diff；customer_agent_config_id 不可变更）。
+  - `activity set-enabled <activity_id> --enabled true|false`：列表行 toggle 用，PATCH `/enabled`，仅写 enabled 一个字段。
+  - `activity delete <activity_id>`：软删活动 + 级联软删 activity_product 关联。
+  - `activity v2-enabled --agent <id> --enabled true|false`：per-tenant 总开关，写 `agent_activity_setting.v2_activity_enabled`，控制 sop V2 链路是否生效。
+- `activity_id` 路径参数本地校验为正整数；`--enabled` 仅接受 `true|false`，非法值直接报错优于让服务端 500。
+- 业务失败统一服务端 200 + `code:400`，CLI 透传为 `exit 1` + `INVALID_PAYLOAD: …` 消息。
+
 ## 0.5.2 (2026-05-28)
 
 **修复：`repair-record` 命令 404 问题**

package/README.md

@@ -255,6 +255,47 @@ cs-cli product update-sku --agent <id> --sku-id 6072595054179 --update '{"补充
 ```
 
 
+### 活动管理 (`activity`)
+
+活动 V2（Issue #34）增删改查 + per-tenant V2 总开关。服务端 `customer-servhub-api /v1/activity*`；契约详情参见 [`docs/devkit/specs/2026-05-28-activity-v2-api-reference.md`](../../docs/devkit/specs/2026-05-28-activity-v2-api-reference.md)。
+
+| 命令 | 说明 |
+| --- | --- |
+| `activity list --agent <id> [--page N] [--page-size N] [--search <text>]` | 列出活动（返回 `total` / `v2_activity_enabled` / `items[]`） |
+| `activity by-product --agent <id> --product-id <id>` | 按 `product_id` 反查当前生效活动（仅 enabled、product_scope='all' 必入） |
+| `activity create --data <json\|@file>` | 创建活动（payload 见 `IActivityWritePayload`） |
+| `activity update <activity_id> --data <json\|@file>` | 整体更新活动（products 整组替换，非增量） |
+| `activity set-enabled <activity_id> --enabled <true\|false>` | 切换单条活动启用状态（仅写 enabled） |
+| `activity delete <activity_id>` | 软删活动 + 级联软删关联 |
+| `activity v2-enabled --agent <id> --enabled <true\|false>` | per-tenant 启停 V2 链路 |
+
+- `--agent <id>` 对应服务端 `customer_agent_config_id`（与 `sa` / `product` 命令同口径）。
+- `activity create` / `update` payload 必填：`customer_agent_config_id`、`activity_name`、`effective_type`、`activity_rule`；`effective_type=time_range` 要求 `start_time` + `end_time`；`product_scope='specific'`（缺省）要求 `products ≥ 1`。
+- 业务失败（参数非法 / 跨 workspace / 不存在）服务端返 HTTP 200 + `code:400`，CLI 转为 `exit 1` 并打印 `INVALID_PAYLOAD: …`。
+
+```bash
+# 列出活动
+cs-cli activity list --agent <cfg_id> --search 返现
+
+# 按商品反查
+cs-cli activity by-product --agent <cfg_id> --product-id 914494989518
+
+# 创建活动（从文件读 payload）
+cs-cli activity create --data @activity.json
+
+# 整体更新
+cs-cli activity update 6 --data @activity.json
+
+# 列表行 toggle 启用
+cs-cli activity set-enabled 6 --enabled false
+
+# 软删活动
+cs-cli activity delete 6
+
+# 为某 agent 启用 V2 链路
+cs-cli activity v2-enabled --agent <cfg_id> --enabled true
+```
+
 ### 工单管理 (`issue`)
 
 

package/dist/bin.js

@@ -487,26 +487,66 @@ function buildCookieHeaders() {
   return { Cookie: `auth_token=${creds.accessToken}` };
 }
 
-// src/client/agent-api.ts
-async function listAgents(opts) {
-  const wsId = getWorkspaceId(opts.workspaceId);
+// src/client/activity-api.ts
+var PATH_PREFIX = "/v1/activity";
+async function listActivities(opts) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/customer-agent/list", {
+  const query = {
+    customer_agent_config_id: opts.customerAgentConfigId,
+    page: opts.page ?? 1,
+    page_size: opts.pageSize ?? 20
+  };
+  if (opts.search) query.search = opts.search;
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/list`, {
     method: "GET",
-    query: { page: opts.page ?? 1, page_size: opts.pageSize ?? 20, workspace_id: wsId }
+    query
   });
 }
-async function getAgent(configId) {
+async function listActivitiesByProduct(opts) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), `/v1/customer-agent/${configId}`, {
-    method: "GET"
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/by-product`, {
+    method: "GET",
+    query: {
+      customer_agent_config_id: opts.customerAgentConfigId,
+      product_id: opts.productId
+    }
   });
 }
-async function updateAgent(configId, data) {
+async function createActivity(body) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), `/v1/customer-agent/${configId}`, {
+  return request(getCustomerServiceUrl(), PATH_PREFIX, {
+    method: "POST",
+    body
+  });
+}
+async function updateActivity(activityId, body) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/${activityId}`, {
     method: "PUT",
-    body: data
+    body
+  });
+}
+async function patchActivityEnabled(activityId, enabled) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/${activityId}/enabled`, {
+    method: "PATCH",
+    body: { enabled }
+  });
+}
+async function deleteActivity(activityId) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/${activityId}`, {
+    method: "DELETE"
+  });
+}
+async function setV2Enabled(opts) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/v2-enabled`, {
+    method: "PUT",
+    body: {
+      customer_agent_config_id: opts.customerAgentConfigId,
+      enabled: opts.enabled
+    }
   });
 }
 
@@ -540,6 +580,141 @@ function parseDataOption(value) {
   }
 }
 
+// src/commands/activity.ts
+function parseEnabledFlag(raw) {
+  if (raw === "true") return true;
+  if (raw === "false") return false;
+  throw new Error("--enabled \u4EC5\u63A5\u53D7 true | false");
+}
+function parseActivityId(raw) {
+  const n = Number(raw);
+  if (!Number.isInteger(n) || n <= 0) {
+    throw new Error(`\u975E\u6CD5\u7684 activity_id: ${raw}\uFF08\u5FC5\u987B\u4E3A\u6B63\u6574\u6570\uFF09`);
+  }
+  return n;
+}
+function registerActivityCommand(program2) {
+  const activity = program2.command("activity").description(
+    "\u6D3B\u52A8 V2 \u7BA1\u7406 \u2014\u2014 \u589E\u5220\u6539\u67E5\u6D3B\u52A8\u3001\u6309\u5546\u54C1\u53CD\u67E5\u3001\u5355\u6761\u542F\u7528 toggle\u3001per-tenant V2 \u603B\u5F00\u5173\u3002\u670D\u52A1\u7AEF\uFF1Acustomer-servhub-api /v1/activity*\uFF1B\u5951\u7EA6\u53C2\u8003 docs/devkit/specs/2026-05-28-activity-v2-api-reference.md"
+  );
+  activity.command("list").description(
+    "\u5217\u51FA\u6D3B\u52A8\uFF08\u5206\u9875 + \u540D\u79F0\u641C\u7D22\uFF09\u3002\u8FD4\u56DE total / v2_activity_enabled / items[]\uFF0Citems \u542B id\u3001activity_name\u3001effective_type\u3001enabled\u3001product_scope\u3001products \u7B49"
+  ).requiredOption("--agent <id>", "customer_agent_config_id\uFF08agent \u914D\u7F6E ID\uFF0C\u4ECE agent list \u83B7\u53D6\uFF09").option("--page <number>", "\u9875\u7801\uFF08\u22651\uFF09", "1").option("--page-size <number>", "\u6BCF\u9875\u6570\u91CF\uFF081-100\uFF09", "20").option("--search <text>", "\u6309\u6D3B\u52A8\u540D\u6A21\u7CCA\u5339\u914D").action(async (opts) => {
+    try {
+      const data = await listActivities({
+        customerAgentConfigId: opts.agent,
+        page: Number(opts.page),
+        pageSize: Number(opts.pageSize),
+        search: opts.search
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  activity.command("by-product").description(
+    "\u6309 product_id \u53CD\u67E5\u5F53\u524D\u751F\u6548\u6D3B\u52A8\uFF08enabled=true \u4E14\u672A\u8F6F\u5220\uFF1Bproduct_scope='all' \u5FC5\u5165\uFF0C'specific' \u8D70 activity_product \u53CD\u67E5\uFF1B\u54CD\u5E94 items[].products \u6052\u4E3A []\uFF09"
+  ).requiredOption("--agent <id>", "customer_agent_config_id").requiredOption("--product-id <id>", "\u5916\u90E8\u5546\u54C1 ID\uFF08\u4E0E activity_product.product_id \u540C\u6E90\uFF09").action(async (opts) => {
+    try {
+      const data = await listActivitiesByProduct({
+        customerAgentConfigId: opts.agent,
+        productId: opts.productId
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  activity.command("create").description(
+    "\u521B\u5EFA\u6D3B\u52A8\u3002--data \u4E3A\u5B8C\u6574 IActivityWritePayload\uFF08JSON \u6216 @\u6587\u4EF6\uFF09\u3002\u5FC5\u586B\u5B57\u6BB5\uFF1Acustomer_agent_config_id\u3001activity_name\u3001effective_type\u3001activity_rule\uFF1Beffective_type=time_range \u65F6 start_time + end_time \u5FC5\u586B\uFF1Bproduct_scope='specific'\uFF08\u7F3A\u7701\uFF09\u8981\u6C42 products \u2265 1 \u884C"
+  ).requiredOption("--data <json>", "\u6D3B\u52A8 payload\uFF08JSON \u5B57\u7B26\u4E32\u6216 @\u6587\u4EF6\u8DEF\u5F84\uFF09").action(async (opts) => {
+    try {
+      const body = parseDataOption(opts.data);
+      const data = await createActivity(body);
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  activity.command("update").description(
+    "\u6574\u4F53\u66F4\u65B0\u6D3B\u52A8\uFF08products \u6574\u7EC4\u66FF\u6362\uFF0C\u4E0D\u505A\u589E\u91CF diff\uFF09\u3002customer_agent_config_id \u4E0D\u53EF\u53D8\u66F4\uFF0C\u4E0E\u73B0\u884C\u4E0D\u4E00\u81F4\u4F1A\u4E1A\u52A1\u5931\u8D25 400"
+  ).argument("<activity_id>", "\u6D3B\u52A8 ID\uFF08\u4ECE activity list \u8FD4\u56DE\u7684 id \u83B7\u53D6\uFF09").requiredOption("--data <json>", "\u5B8C\u6574 IActivityWritePayload\uFF08JSON \u5B57\u7B26\u4E32\u6216 @\u6587\u4EF6\u8DEF\u5F84\uFF09").action(async (activityIdRaw, opts) => {
+    try {
+      const activityId = parseActivityId(activityIdRaw);
+      const body = parseDataOption(opts.data);
+      const data = await updateActivity(activityId, body);
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  activity.command("set-enabled").description(
+    "\u5207\u6362\u5355\u6761\u6D3B\u52A8\u542F\u7528\u72B6\u6001\uFF08\u5217\u8868\u884C toggle \u7528\uFF0CPATCH /enabled\uFF09\u3002\u4EC5\u5199 enabled \u4E00\u4E2A\u5B57\u6BB5\uFF0C\u5176\u5B83 payload \u5B57\u6BB5\u5FFD\u7565"
+  ).argument("<activity_id>", "\u6D3B\u52A8 ID").requiredOption("--enabled <bool>", "true | false").action(async (activityIdRaw, opts) => {
+    try {
+      const activityId = parseActivityId(activityIdRaw);
+      const enabled = parseEnabledFlag(opts.enabled);
+      const data = await patchActivityEnabled(activityId, enabled);
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  activity.command("delete").description("\u8F6F\u5220\u6D3B\u52A8 + \u7EA7\u8054\u8F6F\u5220 activity_product \u5173\u8054").argument("<activity_id>", "\u6D3B\u52A8 ID").action(async (activityIdRaw) => {
+    try {
+      const activityId = parseActivityId(activityIdRaw);
+      const data = await deleteActivity(activityId);
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  activity.command("v2-enabled").description(
+    "per-tenant V2 \u603B\u5F00\u5173 \u2014\u2014 \u5199 agent_activity_setting.v2_activity_enabled\uFF0C\u63A7\u5236 sop V2 \u94FE\u8DEF\u662F\u5426\u751F\u6548"
+  ).requiredOption("--agent <id>", "customer_agent_config_id").requiredOption("--enabled <bool>", "true | false").action(async (opts) => {
+    try {
+      const enabled = parseEnabledFlag(opts.enabled);
+      const data = await setV2Enabled({
+        customerAgentConfigId: opts.agent,
+        enabled
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+}
+
+// src/client/agent-api.ts
+async function listAgents(opts) {
+  const wsId = getWorkspaceId(opts.workspaceId);
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), "/v1/customer-agent/list", {
+    method: "GET",
+    query: { page: opts.page ?? 1, page_size: opts.pageSize ?? 20, workspace_id: wsId }
+  });
+}
+async function getAgent(configId) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), `/v1/customer-agent/${configId}`, {
+    method: "GET"
+  });
+}
+async function updateAgent(configId, data) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), `/v1/customer-agent/${configId}`, {
+    method: "PUT",
+    body: data
+  });
+}
+
 // src/commands/agent.ts
 function registerAgentCommand(program2) {
   const agent = program2.command("agent").description(
@@ -3595,7 +3770,7 @@ function registerMonitorCommand(program2) {
 }
 
 // src/client/operations-record-api.ts
-var PATH_PREFIX = "/v1/agent_operations_records";
+var PATH_PREFIX2 = "/v1/agent_operations_records";
 async function listOperationsRecords(opts) {
   const request = createRequest();
   const query = {};
@@ -3603,34 +3778,34 @@ async function listOperationsRecords(opts) {
   if (opts.agentId) query.agent_id = opts.agentId;
   if (opts.page) query.page = opts.page;
   if (opts.pageSize) query.page_size = opts.pageSize;
-  return request(getCustomerServiceUrl(), PATH_PREFIX, {
+  return request(getCustomerServiceUrl(), PATH_PREFIX2, {
     method: "GET",
     query
   });
 }
 async function getOperationsRecord(recordId) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/${recordId}`, {
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX2}/${recordId}`, {
     method: "GET"
   });
 }
 async function createOperationsRecord(data) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), PATH_PREFIX, {
+  return request(getCustomerServiceUrl(), PATH_PREFIX2, {
     method: "POST",
     body: data
   });
 }
 async function updateOperationsRecord(recordId, data) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/${recordId}`, {
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX2}/${recordId}`, {
     method: "PUT",
     body: data
   });
 }
 async function deleteOperationsRecord(recordId) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/${recordId}`, {
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX2}/${recordId}`, {
     method: "DELETE"
   });
 }
@@ -3998,7 +4173,7 @@ function registerProductCommand(program2) {
 }
 
 // src/client/repair-record-api.ts
-var PATH_PREFIX2 = "/api/repair-records";
+var PATH_PREFIX3 = "/api/repair-records";
 async function listRepairRecords(opts) {
   const request = createRequest();
   const query = {};
@@ -4007,21 +4182,21 @@ async function listRepairRecords(opts) {
   if (opts.workspaceId) query.workspace_id = opts.workspaceId;
   if (opts.page) query.page = opts.page;
   if (opts.pageSize) query.page_size = opts.pageSize;
-  return request(getCsAdminUrl(), PATH_PREFIX2, {
+  return request(getCsAdminUrl(), PATH_PREFIX3, {
     method: "GET",
     query
   });
 }
 async function createRepairRecord(data) {
   const request = createRequest();
-  return request(getCsAdminUrl(), PATH_PREFIX2, {
+  return request(getCsAdminUrl(), PATH_PREFIX3, {
     method: "POST",
     body: data
   });
 }
 async function updateRepairRecord(recordId, data) {
   const request = createRequest();
-  return request(getCsAdminUrl(), `${PATH_PREFIX2}/${recordId}`, {
+  return request(getCsAdminUrl(), `${PATH_PREFIX3}/${recordId}`, {
     method: "PUT",
     body: data
   });
@@ -4993,6 +5168,7 @@ registerAgentCommand(program);
 registerSACommand(program);
 registerProductCommand(program);
 registerKnowledgeCommand(program);
+registerActivityCommand(program);
 registerIssueCommand(program);
 registerChatHistoryCommand(program);
 registerFaqCommand(program);

package/package.json

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