@reachv2/sdk 0.3.2 → 0.4.0

package/dist/resources/channel-admin.js

@@ -0,0 +1,155 @@
+/**
+ * ChannelAdminResource — 商户侧通道管理（客服工作台 / 群运营）。
+ *
+ * 端点：Server API `/api/merchant/projects/:id/bots/:botId/channels/*` 与 `.../groups/*`，
+ * 全部要求 `role=merchant` 的 JWT（见 v0.4.0 商户入驻说明）。
+ *
+ * 不含 Telegram `upload-send`（multipart/form-data 文件直传），该端点请直接用 fetch。
+ */
+export class ChannelAdminResource {
+    constructor(request) {
+        this.request = request;
+    }
+    botBase(projectId, botId) {
+        return `/api/merchant/projects/${encodeURIComponent(projectId)}/bots/${encodeURIComponent(botId)}`;
+    }
+    // ═══ 通道总览 ═══
+    /** 该 Bot 的通道配置（telegram / whatsapp / web；botToken 已脱敏） */
+    listChannels(projectId, botId) {
+        return this.request("GET", `${this.botBase(projectId, botId)}/channels`);
+    }
+    // ═══ Telegram ═══
+    /** 配置 Telegram Bot Token（立即启动 Bot 并回写状态） */
+    connectTelegram(projectId, botId, botToken) {
+        return this.request("POST", `${this.botBase(projectId, botId)}/channels/telegram`, { botToken });
+    }
+    /** 断开 Telegram（删除配置） */
+    disconnectTelegram(projectId, botId) {
+        return this.request("DELETE", `${this.botBase(projectId, botId)}/channels/telegram`);
+    }
+    /** Telegram 已入群列表 */
+    listTelegramGroups(projectId, botId) {
+        return this.request("GET", `${this.botBase(projectId, botId)}/channels/telegram/groups`);
+    }
+    /** 重新扫描 Telegram 群组 */
+    rescanTelegramGroups(projectId, botId) {
+        return this.request("POST", `${this.botBase(projectId, botId)}/channels/telegram/rescan`);
+    }
+    /** Telegram 发送文本（群/私聊 chatId） */
+    sendTelegramText(projectId, botId, params) {
+        return this.request("POST", `${this.botBase(projectId, botId)}/channels/telegram/send-text`, params);
+    }
+    /** Telegram 发送该 Bot 已上传的文档 */
+    sendTelegramFile(projectId, botId, params) {
+        return this.request("POST", `${this.botBase(projectId, botId)}/channels/telegram/send-file`, params);
+    }
+    // ═══ WhatsApp（Baileys 扫码配对） ═══
+    /** 发起 WhatsApp 配对（返回 status / qr；进度轮询 whatsappStatus） */
+    pairWhatsApp(projectId, botId) {
+        return this.request("POST", `${this.botBase(projectId, botId)}/channels/whatsapp`);
+    }
+    /** WhatsApp 配对状态（QR / 手机号 / 连接状态） */
+    whatsappStatus(projectId, botId) {
+        return this.request("GET", `${this.botBase(projectId, botId)}/channels/whatsapp/status`);
+    }
+    /** 断开 WhatsApp（已配对凭证保留，重新配对可恢复） */
+    disconnectWhatsApp(projectId, botId) {
+        return this.request("POST", `${this.botBase(projectId, botId)}/channels/whatsapp/disconnect`);
+    }
+    /** WhatsApp 群列表 */
+    listWhatsAppGroups(projectId, botId) {
+        return this.request("GET", `${this.botBase(projectId, botId)}/channels/whatsapp/groups`);
+    }
+    /** WhatsApp 发送文本（群/私聊 jid） */
+    sendWhatsAppText(projectId, botId, params) {
+        return this.request("POST", `${this.botBase(projectId, botId)}/channels/whatsapp/send-text`, params);
+    }
+    // ═══ Discord ═══
+    /** 配置 Discord Bot Token */
+    connectDiscord(projectId, botId, botToken) {
+        return this.request("POST", `${this.botBase(projectId, botId)}/channels/discord`, { botToken });
+    }
+    /** 断开 Discord */
+    disconnectDiscord(projectId, botId) {
+        return this.request("POST", `${this.botBase(projectId, botId)}/channels/discord/disconnect`);
+    }
+    /** Discord 频道（群）列表 */
+    listDiscordGroups(projectId, botId) {
+        return this.request("GET", `${this.botBase(projectId, botId)}/channels/discord/groups`);
+    }
+    /** Discord 发送文本（频道 chatId） */
+    sendDiscordText(projectId, botId, params) {
+        return this.request("POST", `${this.botBase(projectId, botId)}/channels/discord/send-text`, params);
+    }
+    /** 读取 Discord DM opt-in 状态 */
+    getDiscordDmOptIn(projectId, botId, userId) {
+        return this.request("GET", `${this.botBase(projectId, botId)}/channels/discord/dm/opt-in?userId=${encodeURIComponent(userId)}`);
+    }
+    /** 写入 / 撤回 Discord DM opt-in */
+    setDiscordDmOptIn(projectId, botId, params) {
+        return this.request("PUT", `${this.botBase(projectId, botId)}/channels/discord/dm/opt-in`, params);
+    }
+    /** Discord DM 资格（opt-in / 历史入站 / 同 guild） */
+    getDiscordDmEligibility(projectId, botId, userId) {
+        return this.request("GET", `${this.botBase(projectId, botId)}/channels/discord/dm/eligibility?userId=${encodeURIComponent(userId)}`);
+    }
+    /** 发送 Discord 1v1 私信（默认强制 opt-in 校验） */
+    sendDiscordDm(projectId, botId, params) {
+        return this.request("POST", `${this.botBase(projectId, botId)}/channels/discord/dm`, params);
+    }
+    // ═══ 群组管理（Bot 级） ═══
+    /** 群列表（可按 platform 过滤） */
+    listGroups(projectId, botId, platform) {
+        const qs = platform ? `?platform=${encodeURIComponent(platform)}` : "";
+        return this.request("GET", `${this.botBase(projectId, botId)}/groups${qs}`);
+    }
+    /** 群成员 */
+    groupMembers(projectId, botId, groupId) {
+        return this.request("GET", `${this.botBase(projectId, botId)}/groups/${encodeURIComponent(groupId)}/members`);
+    }
+    /** 更新群配置 */
+    updateGroupConfig(projectId, botId, groupId, patch) {
+        return this.request("PATCH", `${this.botBase(projectId, botId)}/groups/${encodeURIComponent(groupId)}/config`, patch);
+    }
+    /** 群成员操作（ban / unban / kick / mute / unmute） */
+    groupMemberOp(projectId, botId, groupId, op, params) {
+        return this.request("POST", `${this.botBase(projectId, botId)}/groups/${encodeURIComponent(groupId)}/member/${op}`, params);
+    }
+    /** 置顶 / 取消置顶消息 */
+    pinMessage(projectId, botId, groupId, params, pinned = true) {
+        return this.request("POST", `${this.botBase(projectId, botId)}/groups/${encodeURIComponent(groupId)}/${pinned ? "pin" : "unpin"}`, params);
+    }
+    /** Bot 级群发（同一 Bot 的多个 chatId） */
+    broadcast(projectId, botId, params) {
+        return this.request("POST", `${this.botBase(projectId, botId)}/groups/broadcast`, params);
+    }
+    // ═══ 项目级群发（跨 Bot） ═══
+    /** 项目内全部群（跨 Bot 视图） */
+    listProjectGroups(projectId) {
+        return this.request("GET", `/api/merchant/projects/${encodeURIComponent(projectId)}/groups`);
+    }
+    /** 项目级群发（创建异步任务） */
+    broadcastProject(projectId, params) {
+        return this.request("POST", `/api/merchant/projects/${encodeURIComponent(projectId)}/groups/broadcast`, params);
+    }
+    /** 群发任务列表 */
+    listBroadcastJobs(projectId) {
+        return this.request("GET", `/api/merchant/projects/${encodeURIComponent(projectId)}/groups/broadcast-jobs`);
+    }
+    /** 群发任务详情 */
+    getBroadcastJob(projectId, jobId) {
+        return this.request("GET", `/api/merchant/projects/${encodeURIComponent(projectId)}/groups/broadcast-jobs/${encodeURIComponent(jobId)}`);
+    }
+    /** 群发任务目标与逐群结果 */
+    getBroadcastJobTargets(projectId, jobId) {
+        return this.request("GET", `/api/merchant/projects/${encodeURIComponent(projectId)}/groups/broadcast-jobs/${encodeURIComponent(jobId)}/targets`);
+    }
+    /** 取消群发任务 */
+    cancelBroadcastJob(projectId, jobId) {
+        return this.request("POST", `/api/merchant/projects/${encodeURIComponent(projectId)}/groups/broadcast-jobs/${encodeURIComponent(jobId)}/cancel`);
+    }
+    /** 重试群发任务（仅失败目标） */
+    retryBroadcastJob(projectId, jobId) {
+        return this.request("POST", `/api/merchant/projects/${encodeURIComponent(projectId)}/groups/broadcast-jobs/${encodeURIComponent(jobId)}/retry`);
+    }
+}

package/dist/resources/data-sources.d.ts

@@ -2,37 +2,19 @@ import { RequestMethod } from "../types.js";
 import { QueryParams } from "./query.js";
 type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
 /**
- * DataSources 资源 — 数据源适配器（指标明细/趋势/告警/定时同步）。
+ * DataSources 资源 — 数据源指标读取。
  * 端点走 Server API（/api/data-sources/*），与社媒域 MCP data_sources_* 工具同源。
- * 全部 authenticate（需 JWT 登录态）；内置 effect_monitor 源拒绝改/删/同步（400）。
- * 创建入口不提供：P3.7.1 后无可创建的外部适配器（ADAPTERS 为空）。
+ * 全部 authenticate（需 JWT 登录态）。
+ *
+ * 说明（v0.4.0）：用户侧 CRUD / 适配器 / 同步 / 告警 / 定时调度已于 2026-09-19 下线，
+ * 服务端仅保留 `metrics` / `trend`；其余方法调用必 404，已移除。
  */
 export declare class DataSourcesResource {
     private request;
     constructor(request: RequestFn);
-    /** 数据源列表（含内置效果监测源） */
-    list(): Promise<any>;
-    /** 适配器类型注册表（type + meta.fields 驱动动态表单） */
-    adapters(): Promise<any>;
-    /** 数据源详情 */
-    get(id: string): Promise<any>;
-    /** 更新数据源（name/config/status） */
-    update(id: string, patch: unknown): Promise<any>;
-    /** 状态机 active/paused/archived */
-    activate(id: string, status: "active" | "paused" | "archived"): Promise<any>;
-    /** 删除数据源（连同指标与定时规则） */
-    delete(id: string): Promise<any>;
-    /** 手动拉取指标 */
-    sync(id: string): Promise<any>;
     /** 指标明细（可按 metric/entity/from/to/limit 过滤） */
     metrics(id: string, params?: QueryParams): Promise<any>;
     /** 按天趋势聚合（metric/days） */
     trend(id: string, params?: QueryParams): Promise<any>;
-    /** 告警记录（days） */
-    alerts(id: string, params?: QueryParams): Promise<any>;
-    /** 设置定时同步 {cron, timezone?} */
-    setSchedule(id: string, data: unknown): Promise<any>;
-    /** 移除定时同步 */
-    removeSchedule(id: string): Promise<any>;
 }
 export {};

package/dist/resources/data-sources.js

@@ -1,42 +1,16 @@
 import { buildQuery } from "./query.js";
 /**
- * DataSources 资源 — 数据源适配器（指标明细/趋势/告警/定时同步）。
+ * DataSources 资源 — 数据源指标读取。
  * 端点走 Server API（/api/data-sources/*），与社媒域 MCP data_sources_* 工具同源。
- * 全部 authenticate（需 JWT 登录态）；内置 effect_monitor 源拒绝改/删/同步（400）。
- * 创建入口不提供：P3.7.1 后无可创建的外部适配器（ADAPTERS 为空）。
+ * 全部 authenticate（需 JWT 登录态）。
+ *
+ * 说明（v0.4.0）：用户侧 CRUD / 适配器 / 同步 / 告警 / 定时调度已于 2026-09-19 下线，
+ * 服务端仅保留 `metrics` / `trend`；其余方法调用必 404，已移除。
  */
 export class DataSourcesResource {
     constructor(request) {
         this.request = request;
     }
-    /** 数据源列表（含内置效果监测源） */
-    list() {
-        return this.request("GET", "/api/data-sources");
-    }
-    /** 适配器类型注册表（type + meta.fields 驱动动态表单） */
-    adapters() {
-        return this.request("GET", "/api/data-sources/adapters");
-    }
-    /** 数据源详情 */
-    get(id) {
-        return this.request("GET", `/api/data-sources/${encodeURIComponent(id)}`);
-    }
-    /** 更新数据源（name/config/status） */
-    update(id, patch) {
-        return this.request("PUT", `/api/data-sources/${encodeURIComponent(id)}`, patch);
-    }
-    /** 状态机 active/paused/archived */
-    activate(id, status) {
-        return this.request("POST", `/api/data-sources/${encodeURIComponent(id)}/activate`, { status });
-    }
-    /** 删除数据源（连同指标与定时规则） */
-    delete(id) {
-        return this.request("DELETE", `/api/data-sources/${encodeURIComponent(id)}`);
-    }
-    /** 手动拉取指标 */
-    sync(id) {
-        return this.request("POST", `/api/data-sources/${encodeURIComponent(id)}/sync`);
-    }
     /** 指标明细（可按 metric/entity/from/to/limit 过滤） */
     metrics(id, params = {}) {
         return this.request("GET", `/api/data-sources/${encodeURIComponent(id)}/metrics${buildQuery(params)}`);
@@ -45,16 +19,4 @@ export class DataSourcesResource {
     trend(id, params = {}) {
         return this.request("GET", `/api/data-sources/${encodeURIComponent(id)}/trend${buildQuery(params)}`);
     }
-    /** 告警记录（days） */
-    alerts(id, params = {}) {
-        return this.request("GET", `/api/data-sources/${encodeURIComponent(id)}/alerts${buildQuery(params)}`);
-    }
-    /** 设置定时同步 {cron, timezone?} */
-    setSchedule(id, data) {
-        return this.request("POST", `/api/data-sources/${encodeURIComponent(id)}/schedule`, data);
-    }
-    /** 移除定时同步 */
-    removeSchedule(id) {
-        return this.request("POST", `/api/data-sources/${encodeURIComponent(id)}/schedule`, { remove: true });
-    }
 }

package/dist/resources/effect.d.ts

@@ -2,9 +2,11 @@ import { RequestMethod } from "../types.js";
 import { QueryParams } from "./query.js";
 type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
 /**
- * Effect 资源 — 效果追踪（P6.6）：指标字典 / 日快照 / 目标 / 汇总 ROI / 周报告警 / GEO 探针问题集。
+ * Effect 资源 — 效果追踪（P6.6）：指标字典 / 日快照 / 汇总 ROI / 周报告警 / GEO 探针问题集。
  * 端点走 Server API（/api/effect/*），与社媒域 MCP effect_* 工具同源。
  * 读接口 authAny（API Key 可读），写接口 authenticate（需 JWT 登录态）。
+ *
+ * 说明（v0.4.0）：`/api/effect/targets*` 在服务端未挂载（调用必 404），目标 CRUD 已移除。
  */
 export declare class EffectResource {
     private request;
@@ -21,15 +23,7 @@ export declare class EffectResource {
     writeMetrics(metrics: unknown[]): Promise<any>;
     /** 单指标按天趋势 */
     series(params?: QueryParams): Promise<any>;
-    /** 目标列表（可按 module/status 过滤） */
-    listTargets(params?: QueryParams): Promise<any>;
-    /** 创建目标（module/scope/metric/period/targetValue/periodStart/periodEnd） */
-    createTarget(data: unknown): Promise<any>;
-    /** 更新目标（部分字段） */
-    updateTarget(id: string, patch: unknown): Promise<any>;
-    /** 删除目标 */
-    deleteTarget(id: string): Promise<any>;
-    /** 模块汇总（指标实际值 + 目标达成） */
+    /** 模块汇总（指标实际值） */
     summary(params?: QueryParams): Promise<any>;
     /** 成本-效果（转化 vs 用量） */
     roi(params?: QueryParams): Promise<any>;

package/dist/resources/effect.js

@@ -1,8 +1,10 @@
 import { buildQuery } from "./query.js";
 /**
- * Effect 资源 — 效果追踪（P6.6）：指标字典 / 日快照 / 目标 / 汇总 ROI / 周报告警 / GEO 探针问题集。
+ * Effect 资源 — 效果追踪（P6.6）：指标字典 / 日快照 / 汇总 ROI / 周报告警 / GEO 探针问题集。
  * 端点走 Server API（/api/effect/*），与社媒域 MCP effect_* 工具同源。
  * 读接口 authAny（API Key 可读），写接口 authenticate（需 JWT 登录态）。
+ *
+ * 说明（v0.4.0）：`/api/effect/targets*` 在服务端未挂载（调用必 404），目标 CRUD 已移除。
  */
 export class EffectResource {
     constructor(request) {
@@ -34,25 +36,8 @@ export class EffectResource {
     series(params = {}) {
         return this.request("GET", `/api/effect/series${buildQuery(params)}`);
     }
-    // ── 目标 ──
-    /** 目标列表（可按 module/status 过滤） */
-    listTargets(params = {}) {
-        return this.request("GET", `/api/effect/targets${buildQuery(params)}`);
-    }
-    /** 创建目标（module/scope/metric/period/targetValue/periodStart/periodEnd） */
-    createTarget(data) {
-        return this.request("POST", "/api/effect/targets", data);
-    }
-    /** 更新目标（部分字段） */
-    updateTarget(id, patch) {
-        return this.request("PUT", `/api/effect/targets/${encodeURIComponent(id)}`, patch);
-    }
-    /** 删除目标 */
-    deleteTarget(id) {
-        return this.request("DELETE", `/api/effect/targets/${encodeURIComponent(id)}`);
-    }
     // ── 汇总 / ROI / 报告 / 告警 ──
-    /** 模块汇总（指标实际值 + 目标达成） */
+    /** 模块汇总（指标实际值） */
     summary(params = {}) {
         return this.request("GET", `/api/effect/summary${buildQuery(params)}`);
     }

package/dist/resources/email-channel.d.ts

@@ -0,0 +1,87 @@
+import { RequestMethod, EmailMailbox, EmailMailboxCreateParams, EmailThreadList } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+export interface EmailSendParams {
+    to: string | string[];
+    subject: string;
+    text?: string;
+    html?: string;
+    cc?: string[];
+    bcc?: string[];
+    inReplyTo?: string | null;
+    references?: string[];
+    attachments?: unknown[];
+    conversationId?: string | null;
+    agentKey?: string;
+    idempotencyKey?: string | null;
+}
+export interface EmailPollParams {
+    limit?: number;
+    /** 默认 true */
+    storeAttachments?: boolean;
+}
+export interface EmailInboundParams {
+    /** 原始邮件（RFC822 / 原始 source） */
+    source: string;
+    uid?: string | null;
+    storeAttachments?: boolean;
+}
+/**
+ * EmailChannelResource — 客服邮件通道（C9-1）。
+ *
+ * 端点：`/api/merchant/projects/:id/bots/:botId/channels/email/*`，
+ * 要求 `role=merchant` 的 JWT。邮箱凭证加密入库，对外永不返回密码。
+ */
+export declare class EmailChannelResource {
+    private request;
+    constructor(request: RequestFn);
+    private base;
+    /** 邮箱账号列表 */
+    listMailboxes(projectId: string, botId: string): Promise<{
+        mailboxes: EmailMailbox[];
+    }>;
+    /** 新增邮箱账号（SMTP/IMAP 凭证） */
+    createMailbox(projectId: string, botId: string, params: EmailMailboxCreateParams): Promise<{
+        mailbox: EmailMailbox;
+        binding: unknown;
+    }>;
+    /** 邮箱账号详情 */
+    getMailbox(projectId: string, botId: string, mailboxId: string): Promise<{
+        mailbox: EmailMailbox;
+    }>;
+    /** 更新邮箱账号（地址变更会同步通道绑定） */
+    updateMailbox(projectId: string, botId: string, mailboxId: string, patch: Partial<EmailMailboxCreateParams>): Promise<{
+        mailbox: EmailMailbox;
+    }>;
+    /** 删除邮箱账号（同时解绑通道） */
+    deleteMailbox(projectId: string, botId: string, mailboxId: string): Promise<{
+        success: boolean;
+        [key: string]: unknown;
+    }>;
+    /** 通过 SMTP 发信 */
+    sendMail(projectId: string, botId: string, mailboxId: string, params: EmailSendParams): Promise<{
+        success: boolean;
+        [key: string]: unknown;
+    }>;
+    /** 立即通过 IMAP 拉取一次收件 */
+    pollMailbox(projectId: string, botId: string, mailboxId: string, params?: EmailPollParams): Promise<{
+        success: boolean;
+        [key: string]: unknown;
+    }>;
+    /** 投递原始邮件（调试 / 外部收信 webhook；幂等键 = Message-ID） */
+    inboundEmail(projectId: string, botId: string, mailboxId: string, params: EmailInboundParams): Promise<{
+        success: boolean;
+        [key: string]: unknown;
+    }>;
+    /** 邮件线程列表（limit 默认 50，上限 200） */
+    listThreads(projectId: string, botId: string, mailboxId: string, params?: {
+        limit?: number;
+        threadKey?: string;
+        conversationId?: string;
+    }): Promise<EmailThreadList>;
+    /** 线程详情（含消息列表） */
+    getThread(projectId: string, botId: string, mailboxId: string, threadId: string): Promise<{
+        thread: Record<string, unknown>;
+        messages: unknown[];
+    }>;
+}
+export {};

package/dist/resources/email-channel.js

@@ -0,0 +1,62 @@
+/**
+ * EmailChannelResource — 客服邮件通道（C9-1）。
+ *
+ * 端点：`/api/merchant/projects/:id/bots/:botId/channels/email/*`，
+ * 要求 `role=merchant` 的 JWT。邮箱凭证加密入库，对外永不返回密码。
+ */
+export class EmailChannelResource {
+    constructor(request) {
+        this.request = request;
+    }
+    base(projectId, botId) {
+        return `/api/merchant/projects/${encodeURIComponent(projectId)}/bots/${encodeURIComponent(botId)}/channels/email`;
+    }
+    /** 邮箱账号列表 */
+    listMailboxes(projectId, botId) {
+        return this.request("GET", `${this.base(projectId, botId)}/mailboxes`);
+    }
+    /** 新增邮箱账号（SMTP/IMAP 凭证） */
+    createMailbox(projectId, botId, params) {
+        return this.request("POST", `${this.base(projectId, botId)}/mailboxes`, params);
+    }
+    /** 邮箱账号详情 */
+    getMailbox(projectId, botId, mailboxId) {
+        return this.request("GET", `${this.base(projectId, botId)}/mailboxes/${encodeURIComponent(mailboxId)}`);
+    }
+    /** 更新邮箱账号（地址变更会同步通道绑定） */
+    updateMailbox(projectId, botId, mailboxId, patch) {
+        return this.request("PUT", `${this.base(projectId, botId)}/mailboxes/${encodeURIComponent(mailboxId)}`, patch);
+    }
+    /** 删除邮箱账号（同时解绑通道） */
+    deleteMailbox(projectId, botId, mailboxId) {
+        return this.request("DELETE", `${this.base(projectId, botId)}/mailboxes/${encodeURIComponent(mailboxId)}`);
+    }
+    /** 通过 SMTP 发信 */
+    sendMail(projectId, botId, mailboxId, params) {
+        return this.request("POST", `${this.base(projectId, botId)}/mailboxes/${encodeURIComponent(mailboxId)}/send`, params);
+    }
+    /** 立即通过 IMAP 拉取一次收件 */
+    pollMailbox(projectId, botId, mailboxId, params = {}) {
+        return this.request("POST", `${this.base(projectId, botId)}/mailboxes/${encodeURIComponent(mailboxId)}/poll`, params);
+    }
+    /** 投递原始邮件（调试 / 外部收信 webhook；幂等键 = Message-ID） */
+    inboundEmail(projectId, botId, mailboxId, params) {
+        return this.request("POST", `${this.base(projectId, botId)}/mailboxes/${encodeURIComponent(mailboxId)}/inbound`, params);
+    }
+    /** 邮件线程列表（limit 默认 50，上限 200） */
+    listThreads(projectId, botId, mailboxId, params = {}) {
+        const query = new URLSearchParams();
+        if (params.limit != null)
+            query.set("limit", String(params.limit));
+        if (params.threadKey)
+            query.set("threadKey", params.threadKey);
+        if (params.conversationId)
+            query.set("conversationId", params.conversationId);
+        const qs = query.toString();
+        return this.request("GET", `${this.base(projectId, botId)}/mailboxes/${encodeURIComponent(mailboxId)}/threads${qs ? `?${qs}` : ""}`);
+    }
+    /** 线程详情（含消息列表） */
+    getThread(projectId, botId, mailboxId, threadId) {
+        return this.request("GET", `${this.base(projectId, botId)}/mailboxes/${encodeURIComponent(mailboxId)}/threads/${encodeURIComponent(threadId)}`);
+    }
+}

package/dist/resources/merchant.d.ts

@@ -0,0 +1,87 @@
+import { RequestMethod, MerchantDashboardStats, MerchantTicket, MerchantTicketUpdateParams, MerchantProject, MerchantBot, MerchantProjectCreateParams, MerchantBotCreateParams, MerchantLlmConfig, MerchantLlmConfigInput, MerchantChain, MerchantChainAddParams, MerchantChainList, MerchantTeamResult, MerchantTeamMemberAddParams, MerchantTeamInviteParams, MerchantTeamInviteResult, MerchantTeamRole, SimpleResult } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/**
+ * MerchantResource — 商户域（客服工作台 / 商户控制台）。
+ *
+ * 端点：Server API `/api/merchant/*`，全部要求 `role=merchant` 的 JWT
+ * （邮箱/钱包注册后需先 `auth.merchantOnboard()` 或接受商户邀请，见 v0.4.0 说明）。
+ *
+ * 注意：商户域直接返回 db 行（snake_case），与网关 `/api/v1` 的 camelCase 不同。
+ */
+export declare class MerchantResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 商户看板（项目/Bot/会话/文档/token 配额 + 近 14 天趋势） */
+    dashboard(): Promise<MerchantDashboardStats>;
+    /** 转人工工单列表（近期 200 条） */
+    listTickets(): Promise<{
+        tickets: MerchantTicket[];
+    }>;
+    /** 更新工单状态 / 处理人（resolved 会同步会话状态） */
+    updateTicket(id: string, params: MerchantTicketUpdateParams): Promise<MerchantTicket>;
+    /** 项目列表（含 bot_count / total_tokens / total_conversations 聚合） */
+    listProjects(): Promise<MerchantProject[]>;
+    /** 项目详情 */
+    getProject(projectId: string): Promise<MerchantProject>;
+    /** 新建项目（默认名「新项目」） */
+    createProject(params: MerchantProjectCreateParams): Promise<MerchantProject>;
+    /** 更新项目（name / description 等） */
+    updateProject(projectId: string, patch: Record<string, unknown>): Promise<MerchantProject>;
+    /** 项目下 Bot 列表 */
+    listBots(projectId: string): Promise<MerchantBot[]>;
+    /** 在项目下新建 Bot（type 由服务端固定为 support） */
+    createBot(projectId: string, params: MerchantBotCreateParams): Promise<MerchantBot>;
+    /** 更新 Bot（name / prompt / status 等） */
+    updateBot(projectId: string, botId: string, patch: Record<string, unknown>): Promise<MerchantBot>;
+    /** 读取 Bot 的 LLM 配置（未配置返回 null） */
+    getLlmConfig(projectId: string, botId: string): Promise<MerchantLlmConfig | null>;
+    /** 写入 Bot 的 LLM 配置（BYOK） */
+    setLlmConfig(projectId: string, botId: string, params: MerchantLlmConfigInput): Promise<SimpleResult & Record<string, unknown>>;
+    /** 重置回平台托管 LLM */
+    resetLlmConfig(projectId: string, botId: string): Promise<SimpleResult & Record<string, unknown>>;
+    /** 可用链列表（内置链 + 商户自定义链） */
+    listChains(): Promise<MerchantChainList>;
+    /** 添加自定义链 */
+    addChain(params: MerchantChainAddParams): Promise<{
+        success: boolean;
+        chain: MerchantChain;
+    }>;
+    /** 删除自定义链 */
+    removeChain(chainId: number): Promise<SimpleResult>;
+    /** 团队成员列表（owner + 成员 + 待接受邀请） */
+    getTeam(): Promise<MerchantTeamResult>;
+    /** 直接加人（目标账户需已注册；email 或 wallet 二选一） */
+    addTeamMember(params: MerchantTeamMemberAddParams): Promise<Record<string, unknown>>;
+    /** 生成邀请（邮箱未注册亦可；受邀者登录后接受） */
+    createTeamInvite(params: MerchantTeamInviteParams): Promise<MerchantTeamInviteResult>;
+    /** 撤销未接受的邀请 */
+    revokeTeamInvite(token: string): Promise<SimpleResult>;
+    /** 修改成员角色 */
+    updateTeamMemberRole(accountId: string, role: MerchantTeamRole): Promise<SimpleResult>;
+    /** 移除成员 */
+    removeTeamMember(accountId: string): Promise<SimpleResult>;
+    /** 当前账户在本商户的权限码 */
+    myPermissions(): Promise<{
+        permissions: string[];
+    }>;
+    /** 角色目录（RBAC） */
+    listRoles(): Promise<unknown>;
+    /** 可分配角色选项 */
+    roleOptions(): Promise<unknown>;
+    /** 成员及其角色 */
+    listMembers(): Promise<unknown>;
+    /** 修改成员角色集合 */
+    updateMemberRoles(userId: string, roles: string[]): Promise<unknown>;
+    /** 审计日志（action / resourceType / status / limit / offset） */
+    listAuditLogs(params?: {
+        action?: string;
+        resourceType?: string;
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        items: unknown[];
+        total: number;
+    }>;
+}
+export {};