@reachv2/sdk 0.3.3 → 0.5.0

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/lightrag.d.ts

@@ -9,6 +9,10 @@ type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Pro
  *
  * Per-user isolation: pass `namespace` to scope documents/queries to a specific user.
  * Defaults to botId (shared knowledge).
+ *
+ * Platform shared namespaces: Keel RAG 侧维护共享 namespace 白名单（默认 `market` / `onchain`，
+ * 用于跨租户只读的行情 / 链上知识）。查询时可直接作为 `namespace` 传入；
+ * 写入（insertDocument / insertDocuments）到这两个 namespace 会被 Keel 以只读拒绝。
  */
 export declare class LightRAGResource {
     private request;

package/dist/resources/lightrag.js

@@ -7,6 +7,10 @@
  *
  * Per-user isolation: pass `namespace` to scope documents/queries to a specific user.
  * Defaults to botId (shared knowledge).
+ *
+ * Platform shared namespaces: Keel RAG 侧维护共享 namespace 白名单（默认 `market` / `onchain`，
+ * 用于跨租户只读的行情 / 链上知识）。查询时可直接作为 `namespace` 传入；
+ * 写入（insertDocument / insertDocuments）到这两个 namespace 会被 Keel 以只读拒绝。
  */
 export class LightRAGResource {
     constructor(request) {

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 {};

package/dist/resources/merchant.js

@@ -0,0 +1,143 @@
+/**
+ * MerchantResource — 商户域（客服工作台 / 商户控制台）。
+ *
+ * 端点：Server API `/api/merchant/*`，全部要求 `role=merchant` 的 JWT
+ * （邮箱/钱包注册后需先 `auth.merchantOnboard()` 或接受商户邀请，见 v0.4.0 说明）。
+ *
+ * 注意：商户域直接返回 db 行（snake_case），与网关 `/api/v1` 的 camelCase 不同。
+ */
+export class MerchantResource {
+    constructor(request) {
+        this.request = request;
+    }
+    // ═══ 看板 / 工单 ═══
+    /** 商户看板（项目/Bot/会话/文档/token 配额 + 近 14 天趋势） */
+    dashboard() {
+        return this.request("GET", "/api/merchant/dashboard");
+    }
+    /** 转人工工单列表（近期 200 条） */
+    listTickets() {
+        return this.request("GET", "/api/merchant/tickets");
+    }
+    /** 更新工单状态 / 处理人（resolved 会同步会话状态） */
+    updateTicket(id, params) {
+        return this.request("PATCH", `/api/merchant/tickets/${encodeURIComponent(id)}`, params);
+    }
+    // ═══ 项目 / Bot ═══
+    /** 项目列表（含 bot_count / total_tokens / total_conversations 聚合） */
+    listProjects() {
+        return this.request("GET", "/api/merchant/projects");
+    }
+    /** 项目详情 */
+    getProject(projectId) {
+        return this.request("GET", `/api/merchant/projects/${encodeURIComponent(projectId)}`);
+    }
+    /** 新建项目（默认名「新项目」） */
+    createProject(params) {
+        return this.request("POST", "/api/merchant/projects", params);
+    }
+    /** 更新项目（name / description 等） */
+    updateProject(projectId, patch) {
+        return this.request("PATCH", `/api/merchant/projects/${encodeURIComponent(projectId)}`, patch);
+    }
+    /** 项目下 Bot 列表 */
+    listBots(projectId) {
+        return this.request("GET", `/api/merchant/projects/${encodeURIComponent(projectId)}/bots`);
+    }
+    /** 在项目下新建 Bot（type 由服务端固定为 support） */
+    createBot(projectId, params) {
+        return this.request("POST", `/api/merchant/projects/${encodeURIComponent(projectId)}/bots`, params);
+    }
+    /** 更新 Bot（name / prompt / status 等） */
+    updateBot(projectId, botId, patch) {
+        return this.request("PATCH", `/api/merchant/projects/${encodeURIComponent(projectId)}/bots/${encodeURIComponent(botId)}`, patch);
+    }
+    // ═══ Bot LLM 配置（BYOK / 平台托管） ═══
+    /** 读取 Bot 的 LLM 配置（未配置返回 null） */
+    getLlmConfig(projectId, botId) {
+        return this.request("GET", `/api/merchant/projects/${encodeURIComponent(projectId)}/bots/${encodeURIComponent(botId)}/llm-config`);
+    }
+    /** 写入 Bot 的 LLM 配置（BYOK） */
+    setLlmConfig(projectId, botId, params) {
+        return this.request("POST", `/api/merchant/projects/${encodeURIComponent(projectId)}/bots/${encodeURIComponent(botId)}/llm-config`, params);
+    }
+    /** 重置回平台托管 LLM */
+    resetLlmConfig(projectId, botId) {
+        return this.request("DELETE", `/api/merchant/projects/${encodeURIComponent(projectId)}/bots/${encodeURIComponent(botId)}/llm-config`);
+    }
+    // ═══ 链 ═══
+    /** 可用链列表（内置链 + 商户自定义链） */
+    listChains() {
+        return this.request("GET", "/api/merchant/chains");
+    }
+    /** 添加自定义链 */
+    addChain(params) {
+        return this.request("POST", "/api/merchant/chains", params);
+    }
+    /** 删除自定义链 */
+    removeChain(chainId) {
+        return this.request("DELETE", `/api/merchant/chains/${chainId}`);
+    }
+    // ═══ 团队（owner/admin 可管理） ═══
+    /** 团队成员列表（owner + 成员 + 待接受邀请） */
+    getTeam() {
+        return this.request("GET", "/api/merchant/team");
+    }
+    /** 直接加人（目标账户需已注册；email 或 wallet 二选一） */
+    addTeamMember(params) {
+        return this.request("POST", "/api/merchant/team/members", params);
+    }
+    /** 生成邀请（邮箱未注册亦可；受邀者登录后接受） */
+    createTeamInvite(params) {
+        return this.request("POST", "/api/merchant/team/invites", params);
+    }
+    /** 撤销未接受的邀请 */
+    revokeTeamInvite(token) {
+        return this.request("POST", `/api/merchant/team/invites/${encodeURIComponent(token)}/revoke`);
+    }
+    /** 修改成员角色 */
+    updateTeamMemberRole(accountId, role) {
+        return this.request("PUT", `/api/merchant/team/members/${encodeURIComponent(accountId)}`, { role });
+    }
+    /** 移除成员 */
+    removeTeamMember(accountId) {
+        return this.request("DELETE", `/api/merchant/team/members/${encodeURIComponent(accountId)}`);
+    }
+    // ═══ 权限 / 审计（governance） ═══
+    /** 当前账户在本商户的权限码 */
+    myPermissions() {
+        return this.request("GET", "/api/merchant/my-permissions");
+    }
+    /** 角色目录（RBAC） */
+    listRoles() {
+        return this.request("GET", "/api/merchant/roles");
+    }
+    /** 可分配角色选项 */
+    roleOptions() {
+        return this.request("GET", "/api/merchant/role-options");
+    }
+    /** 成员及其角色 */
+    listMembers() {
+        return this.request("GET", "/api/merchant/members");
+    }
+    /** 修改成员角色集合 */
+    updateMemberRoles(userId, roles) {
+        return this.request("PUT", `/api/merchant/members/${encodeURIComponent(userId)}/roles`, { roles });
+    }
+    /** 审计日志（action / resourceType / status / limit / offset） */
+    listAuditLogs(params = {}) {
+        const query = new URLSearchParams();
+        if (params.action)
+            query.set("action", params.action);
+        if (params.resourceType)
+            query.set("resourceType", params.resourceType);
+        if (params.status)
+            query.set("status", params.status);
+        if (params.limit != null)
+            query.set("limit", String(params.limit));
+        if (params.offset != null)
+            query.set("offset", String(params.offset));
+        const qs = query.toString();
+        return this.request("GET", `/api/merchant/audit-logs${qs ? `?${qs}` : ""}`);
+    }
+}

package/dist/resources/quota.d.ts

@@ -0,0 +1,30 @@
+import { RequestMethod } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/** 单资源配额项 */
+export interface QuotaEntry {
+    /** 本月额度（0 = 未配置/不限） */
+    limit: number;
+    used: number;
+    remaining: number;
+    allowed: boolean;
+}
+/** `/api/quota/summary` 的输出 key（前端契约） */
+export type QuotaResourceKey = "copywriting" | "tts" | "video" | "poster";
+export interface QuotaSummaryResult {
+    /** 当前生效套餐名（无套餐时为 free） */
+    plan: string;
+    quotas: Record<QuotaResourceKey, QuotaEntry>;
+}
+/**
+ * QuotaResource — 社媒域本月配额（Server API `/api/quota/*`）。
+ *
+ * `GET /api/quota/summary` 支持 API Key 或 JWT（`authAny`），按登录主体所属租户统计。
+ * 注意：与网关侧 `dashboard.quota()`（`/api/v1/quota`，crm 域）不是同一端点。
+ */
+export declare class QuotaResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 本月各资源配额用量（copywriting / tts / video / poster） */
+    summary(): Promise<QuotaSummaryResult>;
+}
+export {};

package/dist/resources/quota.js

@@ -0,0 +1,15 @@
+/**
+ * QuotaResource — 社媒域本月配额（Server API `/api/quota/*`）。
+ *
+ * `GET /api/quota/summary` 支持 API Key 或 JWT（`authAny`），按登录主体所属租户统计。
+ * 注意：与网关侧 `dashboard.quota()`（`/api/v1/quota`，crm 域）不是同一端点。
+ */
+export class QuotaResource {
+    constructor(request) {
+        this.request = request;
+    }
+    /** 本月各资源配额用量（copywriting / tts / video / poster） */
+    summary() {
+        return this.request("GET", "/api/quota/summary");
+    }
+}

package/dist/resources/shared-billing.d.ts

@@ -0,0 +1,205 @@
+import { RequestMethod } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/** 订阅关联的套餐摘要 */
+export interface SharedSubscriptionPlanRef {
+    id: string;
+    name: string;
+    displayName?: string;
+    llmTokensPerMonth?: number;
+}
+/** 平台/席位订阅行（`GET /api/shared/billing/subscriptions`） */
+export interface SharedSubscription {
+    id: string;
+    tenantId: string;
+    planId?: string | null;
+    planName: string;
+    scope?: "platform" | "seat" | string;
+    seatNo?: number | null;
+    agentKey?: string;
+    status?: string;
+    rail?: string;
+    autoRenew?: boolean;
+    currentPeriodStart?: string | null;
+    currentPeriodEnd?: string | null;
+    amountUsd?: number | null;
+    plan?: SharedSubscriptionPlanRef;
+    [key: string]: unknown;
+}
+/** 单资源配额（`/subscriptions/current` → quota.resources） */
+export interface SubscriptionQuotaResource {
+    quota: number;
+    used: number;
+    remaining: number | null;
+}
+/** 当前订阅 + 本月用量 + 统一 token 池 */
+export interface SubscriptionUsage {
+    subscription: SharedSubscription | null;
+    quota: null | {
+        plan: {
+            name: string;
+            llmTokensPerMonth: number;
+        };
+        usage: Record<string, {
+            quantity: number;
+            tokensUsed: number;
+        }>;
+        resources: Record<string, SubscriptionQuotaResource>;
+        tokensUsedThisMonth: number;
+        tokensRemaining: number;
+        seats: {
+            active: number;
+            monthlyQuota: number;
+            tokenBalance: number;
+            pool: number;
+        };
+    };
+}
+export interface RecordUsageParams {
+    tenantId: string;
+    /** 资源类型，如 `llm_tokens` / `content:generate` / `tts:synthesize` */
+    resourceType: string;
+    quantity?: number;
+    tokensUsed?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface UsageRecordResult {
+    id: string;
+    tenantId: string;
+    accountId?: string | null;
+    resourceType: string;
+    quantity: number;
+    tokensUsed?: number | null;
+    metadata?: Record<string, unknown>;
+    createdAt?: string;
+    [key: string]: unknown;
+}
+export interface SharedTokenPackPurchaseParams {
+    tenantId: string;
+    packId: string;
+    successUrl?: string;
+    cancelUrl?: string;
+    /** 用站内推广余额全额抵扣本人自购 */
+    usePartnerBalance?: boolean;
+}
+export interface SharedTokenPackPurchaseResult {
+    id?: string;
+    tenantId?: string;
+    packId?: string | null;
+    packName?: string;
+    tokens?: number;
+    amountUsd?: number;
+    paymentMethod?: string;
+    status?: string;
+    /** 支付通道未配置时为 true（pending 单待运营开通） */
+    manual?: boolean;
+    sessionUrl?: string;
+    paymentId?: string;
+    remark?: string;
+    [key: string]: unknown;
+}
+/** 已开放的加密收款通道（`{ enabled, chains }`） */
+export interface CryptoMethodsResult {
+    enabled: boolean;
+    chains: Array<Record<string, unknown>>;
+}
+export interface CryptoOrderParams {
+    tenantId: string;
+    /** 商品类型：plan / seat / seat_add / token_pack / browser_pack */
+    kind: string;
+    targetId: string;
+    chain: string;
+    asset: string;
+    payerWallet?: string;
+    seatCount?: number;
+    taxCountry?: string;
+}
+/** 加密订单对外视图（不含 enginePaymentId / receipt 原文） */
+export interface CryptoOrder {
+    orderId: string;
+    kind: string;
+    targetId: string;
+    targetName?: string;
+    chain: string;
+    chainId?: number | string;
+    assetSymbol: string;
+    assetAddress?: string;
+    decimals?: number;
+    payTo?: string;
+    amountWei?: string;
+    amountDisplay?: string;
+    amountUsd?: number;
+    seatCount?: number;
+    seatKind?: string | null;
+    periodStart?: string | null;
+    periodEnd?: string | null;
+    tax?: {
+        country: string | null;
+        rate: number;
+        amount: number;
+        inclusive: boolean;
+    };
+    pspFee?: number;
+    reserveAmount?: number;
+    netAmount?: number;
+    status: string;
+    txHash?: string | null;
+    creditedWei?: string | null;
+    expiresAt?: string;
+    createdAt?: string;
+    /** confirm 时订单已支付 */
+    alreadyPaid?: boolean;
+    /** confirm 时本次生效结果 */
+    activated?: unknown;
+    duplicate?: boolean;
+    [key: string]: unknown;
+}
+export interface CryptoOrderListResult {
+    orders: CryptoOrder[];
+}
+export interface CryptoOrderConfirmParams {
+    tenantId: string;
+    txHash: string;
+}
+/**
+ * SharedBillingResource — 统一计费（Server API `/api/shared/billing/*`）。
+ *
+ * 鉴权：订阅 / 用量 / 加密收款端点均要求 **账户 JWT**（`requireAuth`）+ 租户成员
+ * （`tenantId` 显式传参，服务端用登录账号校验成员身份）；`plans` / `token-packs` /
+ * `crypto/methods` 公开。
+ *
+ * 未封装：
+ * - `POST /subscriptions`（已退役，恒 410 PLATFORM_PLAN_RETIRED；新购走 `/api/seats`）
+ * - `POST /webhook` / `POST /payments-events`（Stripe/引擎回调，验签即认证，不属于 SDK 调用面）
+ */
+export declare class SharedBillingResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 席位档位套餐列表（**裸数组**，与 `/api/billing/plans` 的 `{ plans }` 不同） */
+    listPlans(): Promise<Array<Record<string, unknown>>>;
+    /** 可购买 Token 包列表（**裸数组**，含 cryptoAmount / price 等全字段） */
+    listTokenPacks(): Promise<Array<Record<string, unknown>>>;
+    /** 租户平台订阅列表（含 plan 摘要，按创建时间倒序） */
+    listSubscriptions(tenantId: string): Promise<SharedSubscription[]>;
+    /** 当前订阅 + 本月用量 + 分资源配额 + 席位/token 池（无套餐且无席位时 subscription/quota 为 null） */
+    getCurrentSubscription(tenantId: string): Promise<SubscriptionUsage>;
+    /** 记录用量（统一账本；`llm_tokens` 的 token 数落在 quantity） */
+    recordUsage(params: RecordUsageParams): Promise<UsageRecordResult>;
+    /**
+     * 购买 Token 包（fiat Stripe Checkout；渠道未配置时落 pending 单并返回 `manual: true`）。
+     * `usePartnerBalance: true` 时用推广余额全额抵扣，成功即 completed。
+     */
+    purchaseTokenPack(params: SharedTokenPackPurchaseParams): Promise<SharedTokenPackPurchaseResult>;
+    /** 已开放的加密收款通道（链 + 稳定币；未开放返回 `enabled: false`） */
+    listCryptoMethods(): Promise<CryptoMethodsResult>;
+    /** 创建加密订单（返回 payTo / amountWei / 过期时间，用户链上转账后用返回的 orderId confirm） */
+    createCryptoOrder(params: CryptoOrderParams): Promise<CryptoOrder>;
+    /** 我的加密订单列表（读取时惰性把超时 pending 单置 expired） */
+    listCryptoOrders(tenantId: string): Promise<CryptoOrderListResult>;
+    /** 加密订单详情 */
+    getCryptoOrder(orderId: string, tenantId: string): Promise<CryptoOrder>;
+    /** 取消待付款订单（仅 pending/expired 可取消，已支付不可） */
+    cancelCryptoOrder(orderId: string, tenantId: string): Promise<CryptoOrder>;
+    /** 提交链上 txHash 换取引擎回执并生效 */
+    confirmCryptoOrder(orderId: string, params: CryptoOrderConfirmParams): Promise<CryptoOrder>;
+}
+export {};