@reachv2/sdk 0.3.3 → 0.5.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），现统一为 **37 个资源类 / 287 个资源方法**。一个客户端覆盖客服 / 销售引导、社群维护与社媒运营全部资源（含商户入驻与商户控制台、通道/群发、邮件通道、计费与配额、效果追踪、SEO/GEO、内容规则与数据源）。
 
 - 运行时：Node.js >= 18（ESM）
 - 类型：完整 TypeScript 类型定义（自带 `dist/index.d.ts`）
@@ -8,7 +8,7 @@ Reach（reach.codes）统一平台的官方 TypeScript SDK —— 由 aiservicer
 
 ## 文档
 
-- **[API Reference](docs/API-REFERENCE.md)**（P2.6，v0.3.0 补 P-REACH 四域）：全部 27 个资源类 + `ReachClient` 共 **203 个资源方法**（另含 `ReachClient.setToken` / `request`）的签名 / 端点 / 参数 / 返回类型 / 错误 / 示例，与 `sdk/src` 源码一一对应。
+- **[API Reference](docs/API-REFERENCE.md)**（P2.6，v0.3.0 补 P-REACH 四域，v0.4.0 补商户/通道，v0.5.0 补计费/配额）：全部 37 个资源类 + `ReachClient` 共 **287 个资源方法**（另含 `ReachClient.setToken` / `request`）的签名 / 端点 / 参数 / 返回类型 / 错误 / 示例，与 `sdk/src` 源码一一对应。
 
 ## 安装
 
@@ -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 社媒运营看板 | 双域 |
@@ -143,7 +143,7 @@ const client = new ReachClient({
 
 | 资源 | 主要能力 | API 域 |
 |------|----------|--------|
-| `client.agents` | **统一 Agent 入口**（AgentApi）：调用方 agent（list/get/capabilities/chat/prepareTransaction）+ AgentX 链上市场/订阅/状态/用量/发布/技能 + 市场 run/clone | 双域 |
+| `client.agents` | **统一 Agent 入口**（AgentApi）：调用方 agent（list/get/capabilities/chat/prepareTransaction）+ 市场搜索（listMarketplace → `/api/agents/marketplace/search`）+ 市场 run/clone | 双域 |
 | `client.project` | 项目 CRUD、列表 | Gateway |
 | `client.bot` | Bot（客服/销售/交易/自定义）CRUD、启停、统计 | Gateway |
 | `client.knowledge` | 知识文档 CRUD、推荐 | Gateway |
@@ -151,7 +151,7 @@ const client = new ReachClient({
 | `client.conversation` | 对话记录与消息 | Gateway |
 | `client.transaction` | 交易意图解析/构造/模拟、协议/合约/calldata 查询 | Gateway |
 | `client.chat` | 服务端对话（含 function calling tools、A2A 编排） | Server |
-| `client.lightrag` | RAG Key 管理 + 文档 CRUD + 查询（per-user namespace） | Gateway |
+| `client.lightrag` | RAG Key 管理 + 文档 CRUD + 查询（per-user namespace；平台共享 namespace `market` / `onchain` 只读可查） | Gateway |
 | `client.scheduledTasks` | 主 agent 定时任务管理 | Server |
 | `client.internal` | 企业内 Agent：企业级共享知识库 + 监控连接器/事件（`internal` bot） | Server |
 | `client.abis` | 商户租户合约 ABI 管理：list/add/remove（交易 agent 上传 ABI 后即可按函数构造链上调用） | Server |
@@ -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,16 +172,41 @@ 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 不同。
+
+### 计费 / 配额 — P1（v0.5.0 新增）
+
+| 资源 | 主要能力 | API 域 |
+|------|----------|--------|
+| `client.billing` | **社媒域计费（BillingResource）**：套餐 / Token 包 / 价格（公开）、Token 包购买（Stripe Checkout，未配置时落 pending）、Customer Portal、浏览器实例配额与购买流水（7 方法） | Server |
+| `client.sharedBilling` | **统一计费（SharedBillingResource）**：订阅列表 / 当前订阅与本月用量、用量记账、Token 包购买（支持推广余额抵扣）、加密收款（通道 / 下单 / 列表 / 详情 / 取消 / 确认）（12 方法） | Server |
+| `client.quota` | **社媒域本月配额（QuotaResource）**：`copywriting` / `tts` / `video` / `poster` 的 limit / used / remaining / allowed（1 方法） | Server |
+
+> 两个计费资源路径不同：`client.billing` → `/api/billing/*`（社媒域），`client.sharedBilling` → `/api/shared/billing/*`（统一账本）。
+> 订阅 / 用量 / 加密收款需 **账户 JWT + 租户成员**，`tenantId` 显式传参；`plans` / `token-packs` / `prices` / `crypto/methods` 公开。
+> 已退役端点未封装：`POST /api/billing/checkout` 与 `POST /api/shared/billing/subscriptions` 恒 410（新购走 `/api/seats`）；
+> `webhook` / `payments-events` 为服务端验签回调，不属于 SDK 调用面。
 
 > crm 客服指标（原 `client.analytics`）与社媒运营看板（原 `client.dashboard`）已统一为 `client.dashboard`（DashboardApi）；AgentX（原 `client.agentx`）与社媒 Agent 市场已统一为 `client.agents`（AgentApi）。
 
 ## 统一入口说明
 
-- **AgentApi（`client.agents`）**：唯一 Agent 入口（P2.4.3）。吸收 S agent（网关 `/api/v1/agents/*`：list/get/capabilities/chat/prepareTransaction）、S agentx（server `/api/agentx/*` + `/api/merchant/*`：市场/计划/订阅/状态/用量/上下文/发布/技能）与 A agents（server `/api/agents/*`：run/clone，marketplace→listMarketplace）。统一 Agent 资源模型见 REACH_MERGE_PLAN A.2.3/A.2.5。
+- **AgentApi（`client.agents`）**：唯一 Agent 入口（P2.4.3）。吸收 S agent（网关 `/api/v1/agents/*`：list/get/capabilities/chat/prepareTransaction）、市场（server `/api/agents/marketplace/search`：listMarketplace）与 A agents（server `/api/agents/*`：run/clone）。`/api/agentx/*` 服务端未挂载，相关方法已于 v0.4.0 移除。统一 Agent 资源模型见 REACH_MERGE_PLAN A.2.3/A.2.5。
 - **DashboardApi（`client.dashboard`）**：唯一看板入口（P2.4.4）。crm 域（`global` / `dashboard(projectId)` / `botMetrics` / `summaryByUser`）+ social 域（`overview` / `quota` / `trend`）。
 
 ## Function Calling（工具回调）
@@ -202,7 +227,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` | **全量** 37 资源类 287 方法的 method / path / body 断言（要求每个方法至少被一条用例覆盖） |
 | `test/smoke.test.mjs` | 导出面 + 资源方法面快照 |
 
 > 测试跑 **`dist/` 产物**，改完 `src/` 必须先 `npm run build`。

package/dist/client.d.ts

@@ -30,6 +30,12 @@ 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";
+import { BillingResource } from "./resources/billing.js";
+import { SharedBillingResource } from "./resources/shared-billing.js";
+import { QuotaResource } from "./resources/quota.js";
 export declare class ReachClient {
     private apiKey?;
     private token?;
@@ -67,6 +73,12 @@ export declare class ReachClient {
     tenants: TenantsResource;
     team: TeamResource;
     health: HealthResource;
+    merchant: MerchantResource;
+    channelAdmin: ChannelAdminResource;
+    emailChannel: EmailChannelResource;
+    billing: BillingResource;
+    sharedBilling: SharedBillingResource;
+    quota: QuotaResource;
     constructor(config: ReachClientConfig);
     /** Set token after wallet login */
     setToken(token: string): void;

package/dist/client.js

@@ -30,6 +30,12 @@ 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";
+import { BillingResource } from "./resources/billing.js";
+import { SharedBillingResource } from "./resources/shared-billing.js";
+import { QuotaResource } from "./resources/quota.js";
 export class ReachClient {
     constructor(config) {
         if (!config.apiKey && !config.token) {
@@ -72,6 +78,12 @@ 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));
+        this.billing = new BillingResource(this.requestServer.bind(this));
+        this.sharedBilling = new SharedBillingResource(this.requestServer.bind(this));
+        this.quota = new QuotaResource(this.requestServer.bind(this));
     }
     /** Set token after wallet login */
     setToken(token) {
@@ -124,6 +136,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,16 @@ 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 { BillingResource } from "./resources/billing.js";
+export { SharedBillingResource } from "./resources/shared-billing.js";
+export { QuotaResource } from "./resources/quota.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";
+export type { BillingPlan, BillingPlansResult, BillingTokenPack, BillingTokenPacksResult, BillingPrice, BillingPricesResult, TokenPackCheckoutResult, BrowserQuotaStatus, BrowserPackPurchase, BrowserPackPurchasesResult, } from "./resources/billing.js";
+export type { SharedSubscriptionPlanRef, SharedSubscription, SubscriptionQuotaResource, SubscriptionUsage, RecordUsageParams, UsageRecordResult, SharedTokenPackPurchaseParams, SharedTokenPackPurchaseResult, CryptoMethodsResult, CryptoOrderParams, CryptoOrder, CryptoOrderListResult, CryptoOrderConfirmParams, } from "./resources/shared-billing.js";
+export type { QuotaEntry, QuotaResourceKey, QuotaSummaryResult, } from "./resources/quota.js";

package/dist/index.js

@@ -31,3 +31,9 @@ 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";
+export { BillingResource } from "./resources/billing.js";
+export { SharedBillingResource } from "./resources/shared-billing.js";
+export { QuotaResource } from "./resources/quota.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");
+    }
 }