@reachv2/sdk 0.3.3 → 0.4.0

package/README.md

@@ -1,6 +1,6 @@
 # @reachv2/sdk
 
-Reach（reach.codes）统一平台的官方 TypeScript SDK —— 由 aiservicer SDK（crm 域，18 资源）与 aiops-saas SDK（social 域，5 资源）合并而来（P2.4），现统一为 **31 个资源类 / 210 个资源方法**。一个客户端覆盖客服 / 销售引导、社群维护与社媒运营全部资源（含效果追踪、SEO/GEO、内容规则与数据源）。
+Reach（reach.codes）统一平台的官方 TypeScript SDK —— 由 aiservicer SDK（crm 域，18 资源）与 aiops-saas SDK（social 域，5 资源）合并而来（P2.4），现统一为 **34 个资源类 / 267 个资源方法**。一个客户端覆盖客服 / 销售引导、社群维护与社媒运营全部资源（含商户入驻与商户控制台、通道/群发、邮件通道、效果追踪、SEO/GEO、内容规则与数据源）。
 
 - 运行时：Node.js >= 18（ESM）
 - 类型：完整 TypeScript 类型定义（自带 `dist/index.d.ts`）
@@ -125,7 +125,7 @@ const client = new ReachClient({
 
 | 资源 | 主要能力 | API 域 |
 |------|----------|--------|
-| `client.auth` | 验证码（getCaptcha）、登录、注册、钱包登录（MFA/SSO） | Server |
+| `client.auth` | 验证码（getCaptcha）、登录、注册、钱包登录、邮箱验证码登录、**商户入驻（merchantOnboard）/ 商户邀请**、refresh / logout / me（MFA/SSO） | Server |
 | `client.admin` | 平台仪表盘、商户、计费、LLM 设置（需管理员 JWT） | Admin |
 | `client.apiKeys` | API Key 创建/列表/吊销 | Gateway |
 | `client.dashboard` | **统一看板**（DashboardApi）：crm 客服指标 + social 社媒运营看板 | 双域 |
@@ -162,7 +162,7 @@ const client = new ReachClient({
 |------|----------|--------|
 | `client.content` | 社媒文案生成（generate/list/platforms/styles/get/update/delete） | Server |
 | `client.tts` | 文本转语音（synthesize/voices/history） | Server |
-| `client.accounts` | 社媒账号矩阵（list/connect） | Server |
+| `client.accounts` | 社媒账号矩阵（list/create） | Server |
 | `client.contentPlans` | **内容计划（ContentPlansResource）**：计划名 + 主题时间轴（list/create） | Server |
 | `client.publishPlans` | **发布计划（PublishPlansResource）**：多站点分步编排，get 返回每步待审草稿，approve/reject 完成审批（list/get/approve/reject） | Server |
 | `client.browserTemplates` | **浏览器操作模板（BrowserTemplatesResource）**：流程编排模板（list/update） | Server |
@@ -172,10 +172,22 @@ const client = new ReachClient({
 
 | 资源 | 主要能力 | API 域 |
 |------|----------|--------|
-| `client.effect` | **效果追踪（EffectResource）**：指标字典、日快照、目标、汇总/ROI/归因/周报、告警、GEO 探针问题集（22 方法） | Server |
+| `client.effect` | **效果追踪（EffectResource）**：指标字典、日快照、汇总/ROI/归因/周报、告警、GEO 探针问题集（18 方法） | Server |
 | `client.seoGeo` | **SEO/GEO 域（SeoGeoResource）**：品牌档案 / 渠道集 / 内容矩阵（草稿→发布→回采）/ GEO 资产（24 方法） | Server |
 | `client.contentRules` | **内容规则引擎（ContentRulesResource）**：规则 CRUD + 发布前打分/优化 + 发布后效果/GEO 评估 + 记录趋势（12 方法） | Server |
-| `client.dataSources` | **数据源适配器（DataSourcesResource）**：明细/趋势/告警/定时同步（12 方法；无创建入口，内置源只读） | Server |
+| `client.dataSources` | **数据源适配器（DataSourcesResource）**：指标明细 / 趋势（2 方法；其余 CRUD/适配器/同步/告警/调度已于 2026-09-19 下线） | Server |
+
+### 商户域 — P0（入驻 / 控制台 / 通道，v0.4.0 新增）
+
+| 资源 | 主要能力 | API 域 |
+|------|----------|--------|
+| `client.merchant` | **商户控制台（MerchantResource）**：看板/工单、项目与 Bot、Bot LLM 配置（BYOK）、自定义链、团队与邀请、RBAC 权限/成员/审计（28 方法） | Server |
+| `client.channelAdmin` | **通道管理（ChannelAdminResource）**：通道总览、Telegram / WhatsApp / Discord 连接与发消息、群组管理与群发、项目级异步群发任务（33 方法；不含 multipart `upload-send`） | Server |
+| `client.emailChannel` | **客服邮件通道（EmailChannelResource）**：邮箱账号 CRUD、SMTP 发信、IMAP 拉取、原始邮件投递、邮件线程（10 方法） | Server |
+
+> `/api/merchant/*` 全部要求 JWT 带 `role=merchant`：邮箱/钱包注册后需先 `client.auth.merchantOnboard({ name })`
+> 或接受商户邀请（`client.auth.acceptMerchantInvite(token)`），再 `setToken(返回的 accessToken)`。
+> 商户域直接返回 db 行（多为 snake_case），与网关 `/api/v1` 的 camelCase 不同。
 
 > crm 客服指标（原 `client.analytics`）与社媒运营看板（原 `client.dashboard`）已统一为 `client.dashboard`（DashboardApi）；AgentX（原 `client.agentx`）与社媒 Agent 市场已统一为 `client.agents`（AgentApi）。
 
@@ -202,7 +214,7 @@ npm test          # node --test，覆盖 test/*.test.mjs
 | 测试文件 | 覆盖 |
 |----------|------|
 | `test/client.test.mjs` | ReachClient 核心行为：构造校验（`MISSING_AUTH`）、认证 Header、双 base 路由、body 序列化、错误语义 |
-| `test/resources.test.mjs` | **全量** 27 资源类 203 方法的 method / path / body 断言（要求每个方法至少被一条用例覆盖） |
+| `test/resources.test.mjs` | **全量** 34 资源类 267 方法的 method / path / body 断言（要求每个方法至少被一条用例覆盖） |
 | `test/smoke.test.mjs` | 导出面 + 资源方法面快照 |
 
 > 测试跑 **`dist/` 产物**，改完 `src/` 必须先 `npm run build`。

package/dist/client.d.ts

@@ -30,6 +30,9 @@ import { DashboardApi } from "./resources/dashboard-api.js";
 import { HealthResource } from "./resources/health.js";
 import { TenantsResource } from "./resources/tenants.js";
 import { TeamResource } from "./resources/team.js";
+import { MerchantResource } from "./resources/merchant.js";
+import { ChannelAdminResource } from "./resources/channel-admin.js";
+import { EmailChannelResource } from "./resources/email-channel.js";
 export declare class ReachClient {
     private apiKey?;
     private token?;
@@ -67,6 +70,9 @@ export declare class ReachClient {
     tenants: TenantsResource;
     team: TeamResource;
     health: HealthResource;
+    merchant: MerchantResource;
+    channelAdmin: ChannelAdminResource;
+    emailChannel: EmailChannelResource;
     constructor(config: ReachClientConfig);
     /** Set token after wallet login */
     setToken(token: string): void;

package/dist/client.js

@@ -30,6 +30,9 @@ import { DashboardApi } from "./resources/dashboard-api.js";
 import { HealthResource } from "./resources/health.js";
 import { TenantsResource } from "./resources/tenants.js";
 import { TeamResource } from "./resources/team.js";
+import { MerchantResource } from "./resources/merchant.js";
+import { ChannelAdminResource } from "./resources/channel-admin.js";
+import { EmailChannelResource } from "./resources/email-channel.js";
 export class ReachClient {
     constructor(config) {
         if (!config.apiKey && !config.token) {
@@ -72,6 +75,9 @@ export class ReachClient {
         this.tenants = new TenantsResource(this.requestServer.bind(this));
         this.team = new TeamResource(this.requestServer.bind(this));
         this.health = new HealthResource(this.requestServer.bind(this));
+        this.merchant = new MerchantResource(this.requestServer.bind(this));
+        this.channelAdmin = new ChannelAdminResource(this.requestServer.bind(this));
+        this.emailChannel = new EmailChannelResource(this.requestServer.bind(this));
     }
     /** Set token after wallet login */
     setToken(token) {
@@ -124,6 +130,9 @@ export class ReachClient {
                 `Request failed with status ${response.status}`;
             throw new ReachError(message, "API_ERROR", response.status, errorBody);
         }
+        // 204 No Content（如 POST /api/auth/logout）没有响应体
+        if (response.status === 204)
+            return undefined;
         return response.json();
     }
 }

package/dist/index.d.ts

@@ -31,5 +31,10 @@ export { DataSourcesResource } from "./resources/data-sources.js";
 export { HealthResource } from "./resources/health.js";
 export { TenantsResource } from "./resources/tenants.js";
 export { TeamResource } from "./resources/team.js";
-export type { ReachClientConfig, BotType, AgentType, BotStatus, ChannelType, ChannelStatus, KnowledgeStatus, Pagination, PaginatedResponse, Project, ProjectCreateParams, ProjectUpdateParams, TransactionBotConfig, Bot, BotStats, BotCreateParams, BotUpdateParams, KnowledgeDoc, KnowledgeRecommendation, Channel, ChannelConfigureParams, Conversation, Message, ChatParams, ChatResponse, ChatToolDefinition, ChatToolFunction, DashboardData, BotMetrics, TxIntent, TxStep, PreparedTransaction, ContractInfo, ContractMethod, SimulationResult, DecodedCalldata, ProtocolSummary, ProtocolRegistryEntry, ChainDeployment, ProtocolAction, ParamHint, WalletNonce, WalletLoginParams, AuthAccount, AuthResult, MfaRequiredResult, CaptchaResponse, CaptchaAnswer, AgentXAgent, AgentXAgentDetail, AgentXMarketplaceResult, AgentXSubscriptionPlans, AgentXSubscriptionCheck, AgentXAgentContext, AgentXPublishParams, AgentXPublishResult, AgentXSkill, AgentXSkillCreateParams, AgentXAgentStatus, AgentXAgentUsage, AgentXSubscriptionDetail, AgentXSubscriptionList, ServerChatParams, ServerChatResponse, ChatUsage, ChatUsageSummary, AgentSummary, AgentListResult, AgentListParams, AgentChainInfo, AgentActionType, AgentCapabilities, AgentChatParams, AgentChatResult, LightRAGKeyInfo, LightRAGDocumentParams, LightRAGQueryParams, LightRAGQueryResult, LightRAGBatchItem, LightRAGBatchError, LightRAGBatchResult, GlobalAnalytics, AdminDashboard, AdminMerchant, AdminMerchantDetail, AdminBillingRecord, AdminCreateBillingParams, LlmSettings, LlmUpdateParams, ConversationTask, ConversationTaskStatus, ConversationSession, ConversationCapabilities, ConversationMessage, OrchestrationTaskParams, OrchestrateParams, OrchestratedTaskResult, OrchestrateResult, ScheduledTask, ScheduledTaskStatus, ScheduledTaskTriggerType, MonitorConnectorKind, EnterpriseDoc, MonitorConnector, MonitorEvent, MerchantAbi, MerchantAbiCreateParams, SimpleResult, TenantType, TenantMemberRole, TenantMemberStatus, Tenant, TenantMemberInfo, TenantInvite, PublicInviteInfo, InviteAcceptResult, MemberRoleUpdateResult, TransferOwnerResult, TeamMemberItem, TeamInviteResult, HealthInfo, } from "./types.js";
+export { MerchantResource } from "./resources/merchant.js";
+export { ChannelAdminResource } from "./resources/channel-admin.js";
+export { EmailChannelResource } from "./resources/email-channel.js";
+export type { ReachClientConfig, BotType, AgentType, BotStatus, ChannelType, ChannelStatus, KnowledgeStatus, Pagination, PaginatedResponse, Project, ProjectCreateParams, ProjectUpdateParams, TransactionBotConfig, Bot, BotStats, BotCreateParams, BotUpdateParams, KnowledgeDoc, KnowledgeRecommendation, Channel, ChannelConfigureParams, Conversation, Message, ChatParams, ChatResponse, ChatToolDefinition, ChatToolFunction, DashboardData, BotMetrics, TxIntent, TxStep, PreparedTransaction, ContractInfo, ContractMethod, SimulationResult, DecodedCalldata, ProtocolSummary, ProtocolRegistryEntry, ChainDeployment, ProtocolAction, ParamHint, WalletNonce, WalletLoginParams, AuthAccount, AuthResult, MfaRequiredResult, CaptchaResponse, CaptchaAnswer, AgentXAgent, AgentXAgentDetail, AgentXMarketplaceResult, AgentXSubscriptionPlans, AgentXSubscriptionCheck, AgentXAgentContext, AgentXPublishParams, AgentXPublishResult, AgentXSkill, AgentXSkillCreateParams, AgentXAgentStatus, AgentXAgentUsage, AgentXSubscriptionDetail, AgentXSubscriptionList, ServerChatParams, ServerChatResponse, ChatUsage, ChatUsageSummary, AgentSummary, AgentListResult, AgentListParams, AgentChainInfo, AgentActionType, AgentCapabilities, AgentChatParams, AgentChatResult, LightRAGKeyInfo, LightRAGDocumentParams, LightRAGQueryParams, LightRAGQueryResult, LightRAGBatchItem, LightRAGBatchError, LightRAGBatchResult, GlobalAnalytics, AdminDashboard, AdminMerchant, AdminMerchantDetail, AdminBillingRecord, AdminCreateBillingParams, LlmSettings, LlmUpdateParams, ConversationTask, ConversationTaskStatus, ConversationSession, ConversationCapabilities, ConversationMessage, OrchestrationTaskParams, OrchestrateParams, OrchestratedTaskResult, OrchestrateResult, ScheduledTask, ScheduledTaskStatus, ScheduledTaskTriggerType, MonitorConnectorKind, EnterpriseDoc, MonitorConnector, MonitorEvent, MerchantAbi, MerchantAbiCreateParams, SimpleResult, TenantType, TenantMemberRole, TenantMemberStatus, Tenant, TenantMemberInfo, TenantInvite, PublicInviteInfo, InviteAcceptResult, MemberRoleUpdateResult, TransferOwnerResult, TeamMemberItem, TeamInviteResult, HealthInfo, MerchantOnboardParams, MerchantAuthResult, MerchantInviteInfo, EmailCodeSendResult, EmailCodeLoginParams, AccountMeResult, MerchantDashboardStats, MerchantTicket, MerchantTicketUpdateParams, MerchantProject, MerchantBot, MerchantProjectCreateParams, MerchantBotCreateParams, MerchantLlmConfig, MerchantLlmConfigInput, MerchantChain, MerchantChainAddParams, MerchantChainList, MerchantTeamRole, MerchantTeamMember, MerchantTeamResult, MerchantTeamMemberAddParams, MerchantTeamInviteParams, MerchantTeamInviteResult, ChannelActionResult, SendTextParams, TelegramSendFileParams, DiscordDmParams, DiscordDmOptInParams, MerchantGroupList, EmailMailbox, EmailMailboxCreateParams, EmailThreadList, } from "./types.js";
 export type { ApiKeyInfo, ApiKeyCreated } from "./resources/api-key.js";
+export type { SocialAccountCreateParams } from "./resources/accounts.js";
+export type { EmailSendParams, EmailPollParams, EmailInboundParams, } from "./resources/email-channel.js";

package/dist/index.js

@@ -31,3 +31,6 @@ export { DataSourcesResource } from "./resources/data-sources.js";
 export { HealthResource } from "./resources/health.js";
 export { TenantsResource } from "./resources/tenants.js";
 export { TeamResource } from "./resources/team.js";
+export { MerchantResource } from "./resources/merchant.js";
+export { ChannelAdminResource } from "./resources/channel-admin.js";
+export { EmailChannelResource } from "./resources/email-channel.js";

package/dist/resources/accounts.d.ts

@@ -1,5 +1,13 @@
 import { RequestMethod } from "../types.js";
 type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+export interface SocialAccountCreateParams {
+    /** twitter / facebook / instagram / xiaohongshu / tiktok / linkedin / email */
+    platform: string;
+    /** 展示名（服务端必填） */
+    name: string;
+    credentials?: Record<string, unknown>;
+    usageType?: "general" | "nurture" | "execute";
+}
 /**
  * Accounts 资源 — 社媒账号矩阵（源自 aiops-saas @aiops/sdk AccountsApi）。
  * 端点走 Server API（/api/accounts/*）。
@@ -7,9 +15,13 @@ type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Pro
 export declare class AccountsResource {
     private request;
     constructor(request: RequestFn);
-    /** 账号列表 */
-    list(): Promise<any>;
-    /** 连接平台账号（OAuth 凭据） */
-    connect(platform: string, credentials: Record<string, unknown>): Promise<any>;
+    /** 账号列表（?usageType=general|nurture|execute） */
+    list(usageType?: "general" | "nurture" | "execute"): Promise<any>;
+    /**
+     * 新增平台账号（POST /api/accounts；凭据服务端加密入库）。
+     * v0.4.0 修复：旧 `connect(platform, credentials)` 指向不存在的
+     * `/api/accounts/:platform/connect`，调用必 404。
+     */
+    create(params: SocialAccountCreateParams): Promise<any>;
 }
 export {};

package/dist/resources/accounts.js

@@ -6,12 +6,17 @@ export class AccountsResource {
     constructor(request) {
         this.request = request;
     }
-    /** 账号列表 */
-    list() {
-        return this.request("GET", "/api/accounts");
+    /** 账号列表（?usageType=general|nurture|execute） */
+    list(usageType) {
+        const qs = usageType ? `?usageType=${encodeURIComponent(usageType)}` : "";
+        return this.request("GET", `/api/accounts${qs}`);
     }
-    /** 连接平台账号（OAuth 凭据） */
-    connect(platform, credentials) {
-        return this.request("POST", `/api/accounts/${platform}/connect`, credentials);
+    /**
+     * 新增平台账号（POST /api/accounts；凭据服务端加密入库）。
+     * v0.4.0 修复：旧 `connect(platform, credentials)` 指向不存在的
+     * `/api/accounts/:platform/connect`，调用必 404。
+     */
+    create(params) {
+        return this.request("POST", "/api/accounts", params);
     }
 }

package/dist/resources/agent-api.d.ts

@@ -1,16 +1,15 @@
-import { RequestMethod, AgentListParams, AgentListResult, AgentSummary, AgentCapabilities, AgentChatParams, AgentChatResult, TxIntent, PreparedTransaction, AgentXMarketplaceResult, AgentXAgentDetail, AgentXSubscriptionPlans, AgentXSubscriptionCheck, AgentXAgentContext, AgentXPublishParams, AgentXPublishResult, AgentXSkill, AgentXSkillCreateParams, AgentXAgentStatus, AgentXAgentUsage, AgentXSubscriptionList } from "../types.js";
+import { RequestMethod, AgentListParams, AgentListResult, AgentSummary, AgentCapabilities, AgentChatParams, AgentChatResult, TxIntent, PreparedTransaction, AgentXMarketplaceResult } from "../types.js";
 type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
 /**
  * AgentApi — Reach 唯一 Agent 入口（P2.4.3 统一）。
  *
- * 吸收三侧方法面（A.5.2/A.2.3 AgentX 合版）：
- * - S agent（网关 /api/v1/agents/*）：list / get / capabilities / chat / prepareTransaction
- * - S agentx（server /api/agentx/* + /api/merchant/*）：链上市场 / 订阅 / 状态用量 / 发布 / 技能
- * - A agents（server /api/agents/*）：marketplace → listMarketplace、run / clone
+ * 方法面：
+ * - 调用方 Agent（网关 /api/v1/agents/*）：list / get / capabilities / chat / prepareTransaction
+ * - 运行 / 克隆 + 市场搜索（server /api/agents/*）：run / clone / listMarketplace
  *
- * 端点保持两侧现状（agent 走网关 /api/v1、agentx/agents 走 server），
- * 待 2.4.5 统一网关后全部走网关（A.2.4：SDK 只走网关）。
- * 统一 Agent 资源模型：S「Bot 可发布为 Agent」+ A「平台原生 Agent 市场」，见 A.2.5。
+ * 说明（v0.4.0）：`/api/agentx/*` 与 `/api/merchant/.../publish-agentx|agentx-skills`
+ * 在本服务端并未挂载（调用必 404），相关方法已移除；Agent 市场统一走
+ * `/api/agents/marketplace/search`。
  */
 export declare class AgentApi {
     private gatewayRequest;
@@ -30,32 +29,13 @@ export declare class AgentApi {
     run(id: string, message: string, skillNames?: string[]): Promise<any>;
     /** 克隆 agent 到工作区 */
     clone(id: string): Promise<any>;
-    /** 列出 AgentX 链上市场中的 Agent（吸收 A agents.marketplace → /api/agents/marketplace/search） */
+    /** 搜索 Agent 市场（keyword / category / 分页 / 排序） */
     listMarketplace(params?: {
+        keyword?: string;
+        category?: string;
+        sortBy?: string;
         page?: number;
         pageSize?: number;
-        search?: string;
-        type?: string;
     }): Promise<AgentXMarketplaceResult>;
-    /** 获取 AgentX Agent 详情 */
-    getAgent(agentId: number): Promise<AgentXAgentDetail>;
-    /** 获取 Agent 的订阅计划 */
-    getPlans(agentId: number): Promise<AgentXSubscriptionPlans>;
-    /** 检查用户对 Agent 的订阅状态 */
-    checkSubscription(agentId: number, subscriberAddress: string): Promise<AgentXSubscriptionCheck>;
-    /** 列出用户的所有订阅 */
-    listSubscriptions(subscriberAddress: string): Promise<AgentXSubscriptionList>;
-    /** 获取 Agent 运行状态（在线/离线/延迟等） */
-    getAgentStatus(agentId: number): Promise<AgentXAgentStatus>;
-    /** 获取 Agent 用量统计（调用次数、Token 消耗、活跃订阅者） */
-    getAgentUsage(agentId: number): Promise<AgentXAgentUsage>;
-    /** 加载 Agent 上下文（需要有效订阅） */
-    loadAgentContext(agentId: number, subscriberAddress: string): Promise<AgentXAgentContext>;
-    /** 将 Bot 发布到 AgentX 市场，返回链上交易参数 */
-    publishBot(projectId: string, botId: string, params?: AgentXPublishParams): Promise<AgentXPublishResult>;
-    /** 获取 Bot 的 A2A 技能列表 */
-    listSkills(projectId: string, botId: string): Promise<AgentXSkill[]>;
-    /** 给 Bot 添加 A2A 技能（链接到另一个 AgentX Agent） */
-    addSkill(projectId: string, botId: string, params: AgentXSkillCreateParams): Promise<AgentXSkill>;
 }
 export {};

package/dist/resources/agent-api.js

@@ -1,14 +1,13 @@
 /**
  * AgentApi — Reach 唯一 Agent 入口（P2.4.3 统一）。
  *
- * 吸收三侧方法面（A.5.2/A.2.3 AgentX 合版）：
- * - S agent（网关 /api/v1/agents/*）：list / get / capabilities / chat / prepareTransaction
- * - S agentx（server /api/agentx/* + /api/merchant/*）：链上市场 / 订阅 / 状态用量 / 发布 / 技能
- * - A agents（server /api/agents/*）：marketplace → listMarketplace、run / clone
+ * 方法面：
+ * - 调用方 Agent（网关 /api/v1/agents/*）：list / get / capabilities / chat / prepareTransaction
+ * - 运行 / 克隆 + 市场搜索（server /api/agents/*）：run / clone / listMarketplace
  *
- * 端点保持两侧现状（agent 走网关 /api/v1、agentx/agents 走 server），
- * 待 2.4.5 统一网关后全部走网关（A.2.4：SDK 只走网关）。
- * 统一 Agent 资源模型：S「Bot 可发布为 Agent」+ A「平台原生 Agent 市场」，见 A.2.5。
+ * 说明（v0.4.0）：`/api/agentx/*` 与 `/api/merchant/.../publish-agentx|agentx-skills`
+ * 在本服务端并未挂载（调用必 404），相关方法已移除；Agent 市场统一走
+ * `/api/agents/marketplace/search`。
  */
 export class AgentApi {
     constructor(gatewayRequest, serverRequest) {
@@ -54,59 +53,21 @@ export class AgentApi {
     clone(id) {
         return this.serverRequest("POST", `/api/agents/${id}/clone`, {});
     }
-    // ═══ AgentX 链上市场（server /api/agentx/*，S agentx；marketplace 吸收 A agents.marketplace）═══
-    /** 列出 AgentX 链上市场中的 Agent（吸收 A agents.marketplace → /api/agents/marketplace/search） */
+    // ═══ Agent 市场（server /api/agents/marketplace/search）═══
+    /** 搜索 Agent 市场（keyword / category / 分页 / 排序） */
     listMarketplace(params) {
         const query = new URLSearchParams();
+        if (params?.keyword)
+            query.set("keyword", params.keyword);
+        if (params?.category)
+            query.set("category", params.category);
+        if (params?.sortBy)
+            query.set("sortBy", params.sortBy);
         if (params?.page)
             query.set("page", String(params.page));
         if (params?.pageSize)
             query.set("pageSize", String(params.pageSize));
-        if (params?.search)
-            query.set("search", params.search);
-        if (params?.type)
-            query.set("type", params.type);
-        return this.serverRequest("GET", `/api/agentx/marketplace?${query.toString()}`);
-    }
-    /** 获取 AgentX Agent 详情 */
-    getAgent(agentId) {
-        return this.serverRequest("GET", `/api/agentx/agents/${agentId}`);
-    }
-    /** 获取 Agent 的订阅计划 */
-    getPlans(agentId) {
-        return this.serverRequest("GET", `/api/agentx/agents/${agentId}/plans`);
-    }
-    /** 检查用户对 Agent 的订阅状态 */
-    checkSubscription(agentId, subscriberAddress) {
-        return this.serverRequest("GET", `/api/agentx/subscriptions/check?agentId=${agentId}&subscriberAddress=${encodeURIComponent(subscriberAddress)}`);
-    }
-    /** 列出用户的所有订阅 */
-    listSubscriptions(subscriberAddress) {
-        return this.serverRequest("GET", `/api/agentx/subscriptions/my?subscriberAddress=${encodeURIComponent(subscriberAddress)}`);
-    }
-    /** 获取 Agent 运行状态（在线/离线/延迟等） */
-    getAgentStatus(agentId) {
-        return this.serverRequest("GET", `/api/agentx/agents/${agentId}/status`);
-    }
-    /** 获取 Agent 用量统计（调用次数、Token 消耗、活跃订阅者） */
-    getAgentUsage(agentId) {
-        return this.serverRequest("GET", `/api/agentx/agents/${agentId}/usage`);
-    }
-    /** 加载 Agent 上下文（需要有效订阅） */
-    loadAgentContext(agentId, subscriberAddress) {
-        return this.serverRequest("POST", `/api/agentx/agents/${agentId}/load-context`, { subscriberAddress });
-    }
-    // ═══ AgentX 发布与技能（server /api/merchant/*，S agentx）═══
-    /** 将 Bot 发布到 AgentX 市场，返回链上交易参数 */
-    publishBot(projectId, botId, params) {
-        return this.serverRequest("POST", `/api/merchant/projects/${projectId}/bots/${botId}/publish-agentx`, params || {});
-    }
-    /** 获取 Bot 的 A2A 技能列表 */
-    listSkills(projectId, botId) {
-        return this.serverRequest("GET", `/api/merchant/projects/${projectId}/bots/${botId}/agentx-skills`);
-    }
-    /** 给 Bot 添加 A2A 技能（链接到另一个 AgentX Agent） */
-    addSkill(projectId, botId, params) {
-        return this.serverRequest("POST", `/api/merchant/projects/${projectId}/bots/${botId}/agentx-skills`, params);
+        const qs = query.toString();
+        return this.serverRequest("GET", `/api/agents/marketplace/search${qs ? `?${qs}` : ""}`);
     }
 }

package/dist/resources/auth.d.ts

@@ -1,4 +1,4 @@
-import { RequestMethod, WalletNonce, WalletLoginParams, AuthResult, CaptchaResponse, CaptchaAnswer } from "../types.js";
+import { RequestMethod, WalletNonce, WalletLoginParams, AuthResult, CaptchaResponse, CaptchaAnswer, MerchantAuthResult, MerchantInviteInfo, EmailCodeSendResult, EmailCodeLoginParams, AccountMeResult } from "../types.js";
 type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
 export declare class AuthResource {
     private request;
@@ -24,5 +24,29 @@ export declare class AuthResource {
         email?: string;
         captcha?: CaptchaAnswer;
     }): Promise<AuthResult>;
+    /**
+     * 个人账户升级为商户（owner）：创建商户并重签带 merchant claims 的 token。
+     * 已绑定商户时幂等（直接续签）。**必须携带 access token**（端点在 requireAuth 之后）。
+     */
+    merchantOnboard(params: {
+        name: string;
+    }): Promise<MerchantAuthResult>;
+    /** 公开查询商户邀请（登录前即可展示商户名 / 角色 / 受邀邮箱） */
+    getMerchantInvite(token: string): Promise<MerchantInviteInfo>;
+    /** 登录后接受商户邀请（**必须携带 access token**），返回重签后的 token */
+    acceptMerchantInvite(token: string): Promise<MerchantAuthResult>;
+    /** 发送邮箱验证码（登录/注册共用；10 分钟有效，60s 冷却） */
+    sendEmailCode(email: string): Promise<EmailCodeSendResult>;
+    /**
+     * 验证码登录（验证码即凭证，新邮箱自动建档）。
+     * 启用 MFA 的账户首次调用返回 `{ mfaRequired: true }`，需带 mfaCode 重提（验证码不会被消费）。
+     */
+    emailCodeLogin(params: EmailCodeLoginParams): Promise<AuthResult>;
+    /** 轮换刷新令牌（一次性，旧 token 作废） */
+    refresh(refreshToken: string): Promise<AuthResult>;
+    /** 撤销刷新令牌（服务端 204） */
+    logout(refreshToken?: string): Promise<void>;
+    /** 当前账户 + 租户成员关系（需 access token） */
+    me(): Promise<AccountMeResult>;
 }
 export {};

package/dist/resources/auth.js

@@ -40,4 +40,45 @@ export class AuthResource {
             captchaAnswer: opts?.captcha?.answer,
         });
     }
+    // ═══ 商户入驻 / 邀请 ═══
+    /**
+     * 个人账户升级为商户（owner）：创建商户并重签带 merchant claims 的 token。
+     * 已绑定商户时幂等（直接续签）。**必须携带 access token**（端点在 requireAuth 之后）。
+     */
+    merchantOnboard(params) {
+        return this.request("POST", "/api/auth/merchant-onboard", params);
+    }
+    /** 公开查询商户邀请（登录前即可展示商户名 / 角色 / 受邀邮箱） */
+    getMerchantInvite(token) {
+        return this.request("GET", `/api/auth/merchant-invites/${encodeURIComponent(token)}`);
+    }
+    /** 登录后接受商户邀请（**必须携带 access token**），返回重签后的 token */
+    acceptMerchantInvite(token) {
+        return this.request("POST", `/api/auth/merchant-invites/${encodeURIComponent(token)}/accept`);
+    }
+    // ═══ 邮箱验证码登录 ═══
+    /** 发送邮箱验证码（登录/注册共用；10 分钟有效，60s 冷却） */
+    sendEmailCode(email) {
+        return this.request("POST", "/api/auth/email-code/send", { email });
+    }
+    /**
+     * 验证码登录（验证码即凭证，新邮箱自动建档）。
+     * 启用 MFA 的账户首次调用返回 `{ mfaRequired: true }`，需带 mfaCode 重提（验证码不会被消费）。
+     */
+    emailCodeLogin(params) {
+        return this.request("POST", "/api/auth/email-code/login", params);
+    }
+    // ═══ 会话 ═══
+    /** 轮换刷新令牌（一次性，旧 token 作废） */
+    refresh(refreshToken) {
+        return this.request("POST", "/api/auth/refresh", { refreshToken });
+    }
+    /** 撤销刷新令牌（服务端 204） */
+    logout(refreshToken) {
+        return this.request("POST", "/api/auth/logout", { refreshToken });
+    }
+    /** 当前账户 + 租户成员关系（需 access token） */
+    me() {
+        return this.request("GET", "/api/auth/me");
+    }
 }

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

@@ -0,0 +1,94 @@
+import { RequestMethod, ChannelActionResult, SendTextParams, TelegramSendFileParams, DiscordDmParams, DiscordDmOptInParams, MerchantGroupList } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+type GroupMemberOp = {
+    userId: string;
+} & Record<string, unknown>;
+type PinOp = {
+    messageId: string | number;
+} & Record<string, unknown>;
+type BroadcastParams = {
+    chatIds?: string[];
+    text?: string;
+    imageUrl?: string;
+    [key: string]: unknown;
+};
+/**
+ * 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 declare class ChannelAdminResource {
+    private request;
+    constructor(request: RequestFn);
+    private botBase;
+    /** 该 Bot 的通道配置（telegram / whatsapp / web；botToken 已脱敏） */
+    listChannels(projectId: string, botId: string): Promise<Record<string, unknown>>;
+    /** 配置 Telegram Bot Token（立即启动 Bot 并回写状态） */
+    connectTelegram(projectId: string, botId: string, botToken: string): Promise<ChannelActionResult>;
+    /** 断开 Telegram（删除配置） */
+    disconnectTelegram(projectId: string, botId: string): Promise<ChannelActionResult>;
+    /** Telegram 已入群列表 */
+    listTelegramGroups(projectId: string, botId: string): Promise<MerchantGroupList>;
+    /** 重新扫描 Telegram 群组 */
+    rescanTelegramGroups(projectId: string, botId: string): Promise<ChannelActionResult>;
+    /** Telegram 发送文本（群/私聊 chatId） */
+    sendTelegramText(projectId: string, botId: string, params: SendTextParams): Promise<ChannelActionResult>;
+    /** Telegram 发送该 Bot 已上传的文档 */
+    sendTelegramFile(projectId: string, botId: string, params: TelegramSendFileParams): Promise<ChannelActionResult>;
+    /** 发起 WhatsApp 配对（返回 status / qr；进度轮询 whatsappStatus） */
+    pairWhatsApp(projectId: string, botId: string): Promise<ChannelActionResult>;
+    /** WhatsApp 配对状态（QR / 手机号 / 连接状态） */
+    whatsappStatus(projectId: string, botId: string): Promise<ChannelActionResult>;
+    /** 断开 WhatsApp（已配对凭证保留，重新配对可恢复） */
+    disconnectWhatsApp(projectId: string, botId: string): Promise<ChannelActionResult>;
+    /** WhatsApp 群列表 */
+    listWhatsAppGroups(projectId: string, botId: string): Promise<MerchantGroupList>;
+    /** WhatsApp 发送文本（群/私聊 jid） */
+    sendWhatsAppText(projectId: string, botId: string, params: SendTextParams): Promise<ChannelActionResult>;
+    /** 配置 Discord Bot Token */
+    connectDiscord(projectId: string, botId: string, botToken: string): Promise<ChannelActionResult>;
+    /** 断开 Discord */
+    disconnectDiscord(projectId: string, botId: string): Promise<ChannelActionResult>;
+    /** Discord 频道（群）列表 */
+    listDiscordGroups(projectId: string, botId: string): Promise<MerchantGroupList>;
+    /** Discord 发送文本（频道 chatId） */
+    sendDiscordText(projectId: string, botId: string, params: SendTextParams): Promise<ChannelActionResult>;
+    /** 读取 Discord DM opt-in 状态 */
+    getDiscordDmOptIn(projectId: string, botId: string, userId: string): Promise<ChannelActionResult>;
+    /** 写入 / 撤回 Discord DM opt-in */
+    setDiscordDmOptIn(projectId: string, botId: string, params: DiscordDmOptInParams): Promise<ChannelActionResult>;
+    /** Discord DM 资格（opt-in / 历史入站 / 同 guild） */
+    getDiscordDmEligibility(projectId: string, botId: string, userId: string): Promise<ChannelActionResult>;
+    /** 发送 Discord 1v1 私信（默认强制 opt-in 校验） */
+    sendDiscordDm(projectId: string, botId: string, params: DiscordDmParams): Promise<ChannelActionResult>;
+    /** 群列表（可按 platform 过滤） */
+    listGroups(projectId: string, botId: string, platform?: string): Promise<MerchantGroupList>;
+    /** 群成员 */
+    groupMembers(projectId: string, botId: string, groupId: string): Promise<Record<string, unknown>>;
+    /** 更新群配置 */
+    updateGroupConfig(projectId: string, botId: string, groupId: string, patch: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** 群成员操作（ban / unban / kick / mute / unmute） */
+    groupMemberOp(projectId: string, botId: string, groupId: string, op: "ban" | "unban" | "kick" | "mute" | "unmute", params: GroupMemberOp): Promise<Record<string, unknown>>;
+    /** 置顶 / 取消置顶消息 */
+    pinMessage(projectId: string, botId: string, groupId: string, params: PinOp, pinned?: boolean): Promise<Record<string, unknown>>;
+    /** Bot 级群发（同一 Bot 的多个 chatId） */
+    broadcast(projectId: string, botId: string, params: BroadcastParams): Promise<Record<string, unknown>>;
+    /** 项目内全部群（跨 Bot 视图） */
+    listProjectGroups(projectId: string): Promise<Record<string, unknown>>;
+    /** 项目级群发（创建异步任务） */
+    broadcastProject(projectId: string, params: BroadcastParams): Promise<Record<string, unknown>>;
+    /** 群发任务列表 */
+    listBroadcastJobs(projectId: string): Promise<Record<string, unknown>>;
+    /** 群发任务详情 */
+    getBroadcastJob(projectId: string, jobId: string): Promise<Record<string, unknown>>;
+    /** 群发任务目标与逐群结果 */
+    getBroadcastJobTargets(projectId: string, jobId: string): Promise<Record<string, unknown>>;
+    /** 取消群发任务 */
+    cancelBroadcastJob(projectId: string, jobId: string): Promise<Record<string, unknown>>;
+    /** 重试群发任务（仅失败目标） */
+    retryBroadcastJob(projectId: string, jobId: string): Promise<Record<string, unknown>>;
+}
+export {};