@reachv2/sdk 0.1.0

package/dist/resources/agent-api.js

@@ -0,0 +1,112 @@
+/**
+ * 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、agentx/agents 走 server），
+ * 待 2.4.5 统一网关后全部走网关（A.2.4：SDK 只走网关）。
+ * 统一 Agent 资源模型：S「Bot 可发布为 Agent」+ A「平台原生 Agent 市场」，见 A.2.5。
+ */
+export class AgentApi {
+    constructor(gatewayRequest, serverRequest) {
+        this.gatewayRequest = gatewayRequest;
+        this.serverRequest = serverRequest;
+    }
+    // ═══ 调用方 Agent（gateway /api/v1/agents/*，S agent 基线；吸收 A agents.list/get）═══
+    /** 列出调用方可用的 agent（可按 projectId / type 过滤） */
+    list(params) {
+        const query = new URLSearchParams();
+        if (params?.projectId)
+            query.set("projectId", params.projectId);
+        if (params?.type)
+            query.set("type", params.type);
+        const qs = query.toString();
+        return this.gatewayRequest("GET", `/api/v1/agents${qs ? `?${qs}` : ""}`);
+    }
+    /** 获取单个 agent 详情 */
+    get(id) {
+        return this.gatewayRequest("GET", `/api/v1/agents/${id}`);
+    }
+    /** 该 agent 支持什么：类型、可用链、可执行的链上操作类型 */
+    capabilities(id) {
+        return this.gatewayRequest("GET", `/api/v1/agents/${id}/capabilities`);
+    }
+    /** 直接与该 agent 对话（RAG + 交易构造由服务端完成，返回 transaction 载荷） */
+    chat(id, params) {
+        return this.gatewayRequest("POST", `/api/v1/agents/${id}/chat`, params);
+    }
+    /** 构造链上交易（不签名；返回步骤/calldata，由调用方 wallet 弹窗确认） */
+    prepareTransaction(id, intent) {
+        return this.gatewayRequest("POST", `/api/v1/agents/${id}/transaction/prepare`, intent);
+    }
+    // ═══ Agent 运行 / 克隆（server /api/agents/*，A agents）═══
+    /** 运行一个 agent（A：平台原生 Agent 市场模式） */
+    run(id, message, skillNames = []) {
+        return this.serverRequest("POST", `/api/agents/${id}/run`, {
+            message,
+            skillNames,
+        });
+    }
+    /** 克隆 agent 到工作区 */
+    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） */
+    listMarketplace(params) {
+        const query = new URLSearchParams();
+        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);
+    }
+}

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

@@ -0,0 +1,42 @@
+import { RequestMethod } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/** API Key data returned from list (no full key) */
+export interface ApiKeyInfo {
+    id: number;
+    key_prefix: string;
+    app_name: string;
+    tenant_id: number | null;
+    permissions: string[];
+    is_active: boolean;
+    created_by: string;
+    last_used_at: string | null;
+    created_at: string;
+    revoked_at: string | null;
+}
+/** API Key creation response (full key shown once) */
+export interface ApiKeyCreated {
+    key: string;
+    keyPrefix: string;
+    appName: string;
+    permissions: string[];
+    message: string;
+}
+export declare class ApiKeyResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 创建新的 API Key（需要 admin JWT），返回完整 key（仅显示一次） */
+    create(params: {
+        appName: string;
+        tenantId?: number;
+        permissions?: string[];
+    }): Promise<ApiKeyCreated>;
+    /** 列出所有 API Key（需要 admin JWT），不返回完整 key */
+    list(): Promise<{
+        keys: ApiKeyInfo[];
+    }>;
+    /** 吊销（停用）一个 API Key（需要 admin JWT） */
+    revoke(keyId: number): Promise<{
+        revoked: boolean;
+    }>;
+}
+export {};

package/dist/resources/api-key.js

@@ -0,0 +1,17 @@
+export class ApiKeyResource {
+    constructor(request) {
+        this.request = request;
+    }
+    /** 创建新的 API Key（需要 admin JWT），返回完整 key（仅显示一次） */
+    create(params) {
+        return this.request("POST", "/api/v1/api-keys", params);
+    }
+    /** 列出所有 API Key（需要 admin JWT），不返回完整 key */
+    list() {
+        return this.request("GET", "/api/v1/api-keys");
+    }
+    /** 吊销（停用）一个 API Key（需要 admin JWT） */
+    revoke(keyId) {
+        return this.request("DELETE", `/api/v1/api-keys/${keyId}`);
+    }
+}

package/dist/resources/auth.d.ts

@@ -0,0 +1,24 @@
+import { RequestMethod, WalletChallenge, WalletLoginParams, AuthResult, CaptchaResponse, CaptchaAnswer } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+export declare class AuthResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 获取钱包签名挑战 */
+    getChallenge(walletAddress: string): Promise<WalletChallenge>;
+    /** 钱包签名登录，返回 token + user */
+    walletLogin(params: WalletLoginParams): Promise<AuthResult>;
+    /**
+     * 获取数学验证码（login/register 前置）。
+     * svg 为 `data:image/svg+xml;base64,...`，算式形如 "7 + 5 = ?"，结果恒为非负。
+     */
+    getCaptcha(): Promise<CaptchaResponse>;
+    /** 用户名密码登录（服务端强制要求验证码，必须传 captcha） */
+    login(username: string, password: string, captcha?: CaptchaAnswer): Promise<AuthResult>;
+    /** 用户名密码注册（服务端强制要求验证码，必须传 captcha） */
+    register(username: string, password: string, opts?: {
+        name?: string;
+        email?: string;
+        captcha?: CaptchaAnswer;
+    }): Promise<AuthResult>;
+}
+export {};

package/dist/resources/auth.js

@@ -0,0 +1,40 @@
+export class AuthResource {
+    constructor(request) {
+        this.request = request;
+    }
+    /** 获取钱包签名挑战 */
+    getChallenge(walletAddress) {
+        return this.request("POST", "/api/auth/wallet-challenge", { address: walletAddress });
+    }
+    /** 钱包签名登录，返回 token + user */
+    walletLogin(params) {
+        return this.request("POST", "/api/auth/wallet-login", params);
+    }
+    /**
+     * 获取数学验证码（login/register 前置）。
+     * svg 为 `data:image/svg+xml;base64,...`，算式形如 "7 + 5 = ?"，结果恒为非负。
+     */
+    getCaptcha() {
+        return this.request("POST", "/api/auth/captcha");
+    }
+    /** 用户名密码登录（服务端强制要求验证码，必须传 captcha） */
+    login(username, password, captcha) {
+        return this.request("POST", "/api/auth/login", {
+            username,
+            password,
+            captchaToken: captcha?.token,
+            captchaAnswer: captcha?.answer,
+        });
+    }
+    /** 用户名密码注册（服务端强制要求验证码，必须传 captcha） */
+    register(username, password, opts) {
+        return this.request("POST", "/api/auth/register", {
+            username,
+            password,
+            name: opts?.name,
+            email: opts?.email,
+            captchaToken: opts?.captcha?.token,
+            captchaAnswer: opts?.captcha?.answer,
+        });
+    }
+}

package/dist/resources/bot.d.ts

@@ -0,0 +1,17 @@
+import { RequestMethod, Bot, BotCreateParams, BotUpdateParams, ChatParams, ChatResponse } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+export declare class BotResource {
+    private request;
+    constructor(request: RequestFn);
+    create(params: BotCreateParams): Promise<Bot>;
+    list(projectId: string): Promise<Bot[]>;
+    get(id: string): Promise<Bot>;
+    update(id: string, params: BotUpdateParams): Promise<Bot>;
+    delete(id: string): Promise<{
+        deleted: boolean;
+    }>;
+    start(id: string): Promise<Bot>;
+    stop(id: string): Promise<Bot>;
+    chat(botId: string, params: ChatParams): Promise<ChatResponse>;
+}
+export {};

package/dist/resources/bot.js

@@ -0,0 +1,29 @@
+export class BotResource {
+    constructor(request) {
+        this.request = request;
+    }
+    create(params) {
+        return this.request("POST", "/api/v1/bots", params);
+    }
+    list(projectId) {
+        return this.request("GET", `/api/v1/bots?projectId=${projectId}`);
+    }
+    get(id) {
+        return this.request("GET", `/api/v1/bots/${id}`);
+    }
+    update(id, params) {
+        return this.request("PATCH", `/api/v1/bots/${id}`, params);
+    }
+    delete(id) {
+        return this.request("DELETE", `/api/v1/bots/${id}`);
+    }
+    start(id) {
+        return this.request("POST", `/api/v1/bots/${id}/start`);
+    }
+    stop(id) {
+        return this.request("POST", `/api/v1/bots/${id}/stop`);
+    }
+    chat(botId, params) {
+        return this.request("POST", `/api/v1/bots/${botId}/chat`, params);
+    }
+}

package/dist/resources/channel.d.ts

@@ -0,0 +1,23 @@
+import { RequestMethod, Channel, ChannelConfigureParams } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+export declare class ChannelResource {
+    private request;
+    constructor(request: RequestFn);
+    configure(botId: string, params: ChannelConfigureParams): Promise<Channel>;
+    list(botId: string): Promise<Channel[]>;
+    /** 获取单个通道详情 */
+    get(botId: string, type: string): Promise<Channel>;
+    /** 更新单个通道配置 */
+    update(botId: string, type: string, params: {
+        config?: Record<string, unknown>;
+        status?: string;
+    }): Promise<Channel>;
+    getWidgetId(botId: string): Promise<{
+        widgetId: string;
+        embedCode: string;
+    }>;
+    remove(channelId: string): Promise<{
+        removed: boolean;
+    }>;
+}
+export {};

package/dist/resources/channel.js

@@ -0,0 +1,25 @@
+export class ChannelResource {
+    constructor(request) {
+        this.request = request;
+    }
+    configure(botId, params) {
+        return this.request("POST", `/api/v1/bots/${botId}/channels`, params);
+    }
+    list(botId) {
+        return this.request("GET", `/api/v1/bots/${botId}/channels`);
+    }
+    /** 获取单个通道详情 */
+    get(botId, type) {
+        return this.request("GET", `/api/v1/bots/${botId}/channels/${type}`);
+    }
+    /** 更新单个通道配置 */
+    update(botId, type, params) {
+        return this.request("PATCH", `/api/v1/bots/${botId}/channels/${type}`, params);
+    }
+    getWidgetId(botId) {
+        return this.request("GET", `/api/v1/bots/${botId}/channels/widget`);
+    }
+    remove(channelId) {
+        return this.request("DELETE", `/api/v1/channels/${channelId}`);
+    }
+}

package/dist/resources/chat.d.ts

@@ -0,0 +1,9 @@
+import { RequestMethod, ServerChatParams, ServerChatResponse } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+export declare class ChatResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 通过 Server API 发送聊天消息（支持 RAG + AgentX AgentLoop） */
+    send(params: ServerChatParams): Promise<ServerChatResponse>;
+}
+export {};

package/dist/resources/chat.js

@@ -0,0 +1,9 @@
+export class ChatResource {
+    constructor(request) {
+        this.request = request;
+    }
+    /** 通过 Server API 发送聊天消息（支持 RAG + AgentX AgentLoop） */
+    send(params) {
+        return this.request("POST", "/api/chat", params);
+    }
+}

package/dist/resources/content.d.ts

@@ -0,0 +1,25 @@
+import { RequestMethod } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/**
+ * Content 资源 — 社媒文案生成与内容管理（源自 aiops-saas @aiops/sdk ContentApi）。
+ * 端点走 Server API（/api/content/*），与社媒域 MCP 工具同源。
+ */
+export declare class ContentResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 生成社媒文案 */
+    generate(topic: string, platform?: string, style?: string, opts?: Record<string, unknown>): Promise<any>;
+    /** 内容列表（分页） */
+    list(params?: Record<string, unknown>): Promise<any>;
+    /** 支持的平台 */
+    platforms(): Promise<any>;
+    /** 支持的写作风格 */
+    styles(): Promise<any>;
+    /** 单个内容 */
+    get(id: string): Promise<any>;
+    /** 更新内容 */
+    update(id: string, data: unknown): Promise<any>;
+    /** 删除内容 */
+    delete(id: string): Promise<any>;
+}
+export {};

package/dist/resources/content.js

@@ -0,0 +1,43 @@
+/**
+ * Content 资源 — 社媒文案生成与内容管理（源自 aiops-saas @aiops/sdk ContentApi）。
+ * 端点走 Server API（/api/content/*），与社媒域 MCP 工具同源。
+ */
+export class ContentResource {
+    constructor(request) {
+        this.request = request;
+    }
+    /** 生成社媒文案 */
+    generate(topic, platform = "twitter", style = "casual", opts = {}) {
+        return this.request("POST", "/api/content/generate", {
+            topic,
+            platform,
+            style,
+            ...opts,
+        });
+    }
+    /** 内容列表（分页） */
+    list(params = {}) {
+        const qs = new URLSearchParams(params).toString();
+        return this.request("GET", `/api/content/list${qs ? `?${qs}` : ""}`);
+    }
+    /** 支持的平台 */
+    platforms() {
+        return this.request("GET", "/api/content/platforms");
+    }
+    /** 支持的写作风格 */
+    styles() {
+        return this.request("GET", "/api/content/styles");
+    }
+    /** 单个内容 */
+    get(id) {
+        return this.request("GET", `/api/content/${id}`);
+    }
+    /** 更新内容 */
+    update(id, data) {
+        return this.request("PATCH", `/api/content/${id}`, data);
+    }
+    /** 删除内容 */
+    delete(id) {
+        return this.request("DELETE", `/api/content/${id}`);
+    }
+}

package/dist/resources/conversation.d.ts

@@ -0,0 +1,19 @@
+import { RequestMethod, Conversation, Message, PaginatedResponse } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+export declare class ConversationResource {
+    private request;
+    constructor(request: RequestFn);
+    list(botId: string, params?: {
+        page?: number;
+        pageSize?: number;
+    }): Promise<PaginatedResponse<Conversation>>;
+    get(id: string): Promise<{
+        conversation: Conversation;
+        messages: Message[];
+    }>;
+    reply(id: string, message: string): Promise<Message>;
+    transfer(id: string, reason?: string): Promise<{
+        transferred: boolean;
+    }>;
+}
+export {};

package/dist/resources/conversation.js

@@ -0,0 +1,24 @@
+export class ConversationResource {
+    constructor(request) {
+        this.request = request;
+    }
+    list(botId, params) {
+        const query = params
+            ? "?" + new URLSearchParams(Object.entries(params)
+                .filter(([, v]) => v !== undefined)
+                .map(([k, v]) => [k, String(v)])).toString()
+            : "";
+        return this.request("GET", `/api/v1/bots/${botId}/conversations${query}`);
+    }
+    get(id) {
+        return this.request("GET", `/api/v1/conversations/${id}`);
+    }
+    reply(id, message) {
+        return this.request("POST", `/api/v1/conversations/${id}/reply`, {
+            message,
+        });
+    }
+    transfer(id, reason) {
+        return this.request("POST", `/api/v1/conversations/${id}/transfer`, { reason });
+    }
+}

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

@@ -0,0 +1,31 @@
+import { RequestMethod, DashboardData, BotMetrics, GlobalAnalytics, ChatUsageSummary } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/**
+ * DashboardApi — 统一数据看板（P2.4.4 合版，A.2.3 按 crm/social 域参数化聚合）。
+ *
+ * 吸收：
+ * - S analytics（网关 /api/v1/*，客服指标）：global / dashboard / botMetrics / summaryByUser
+ * - A dashboard（server /api/dashboard/*，社媒运营看板）：overview / quota / trend
+ *
+ * 端点保持两侧现状，待 2.4.5 统一网关后全部走网关。
+ */
+export declare class DashboardApi {
+    private gatewayRequest;
+    private serverRequest;
+    constructor(gatewayRequest: RequestFn, serverRequest: RequestFn);
+    /** 全局分析（跨所有 bot） */
+    global(): Promise<GlobalAnalytics>;
+    /** 项目级看板 */
+    dashboard(projectId: string): Promise<DashboardData>;
+    /** Bot 级指标 */
+    botMetrics(botId: string): Promise<BotMetrics>;
+    /** 按用户地址汇总 token 用量（日维度 + 累计），用于成本核算与对账 */
+    summaryByUser(userAddress: string, days?: number): Promise<ChatUsageSummary>;
+    /** 每日用量概览 */
+    overview(): Promise<any>;
+    /** 配额 / 限额 */
+    quota(): Promise<any>;
+    /** 用量趋势（默认 30 天） */
+    trend(days?: number): Promise<any>;
+}
+export {};

package/dist/resources/dashboard-api.js

@@ -0,0 +1,45 @@
+/**
+ * DashboardApi — 统一数据看板（P2.4.4 合版，A.2.3 按 crm/social 域参数化聚合）。
+ *
+ * 吸收：
+ * - S analytics（网关 /api/v1/*，客服指标）：global / dashboard / botMetrics / summaryByUser
+ * - A dashboard（server /api/dashboard/*，社媒运营看板）：overview / quota / trend
+ *
+ * 端点保持两侧现状，待 2.4.5 统一网关后全部走网关。
+ */
+export class DashboardApi {
+    constructor(gatewayRequest, serverRequest) {
+        this.gatewayRequest = gatewayRequest;
+        this.serverRequest = serverRequest;
+    }
+    // ═══ crm 域 — 客服指标（gateway /api/v1/*，S analytics 基线）═══
+    /** 全局分析（跨所有 bot） */
+    global() {
+        return this.gatewayRequest("GET", "/api/v1/analytics");
+    }
+    /** 项目级看板 */
+    dashboard(projectId) {
+        return this.gatewayRequest("GET", `/api/v1/projects/${projectId}/analytics`);
+    }
+    /** Bot 级指标 */
+    botMetrics(botId) {
+        return this.gatewayRequest("GET", `/api/v1/bots/${botId}/analytics`);
+    }
+    /** 按用户地址汇总 token 用量（日维度 + 累计），用于成本核算与对账 */
+    summaryByUser(userAddress, days = 7) {
+        return this.gatewayRequest("GET", `/api/v1/usage/summary?userAddress=${encodeURIComponent(userAddress)}&days=${days}`);
+    }
+    // ═══ social 域 — 社媒运营看板（server /api/dashboard/*，A dashboard 基线）═══
+    /** 每日用量概览 */
+    overview() {
+        return this.serverRequest("GET", "/api/dashboard/overview");
+    }
+    /** 配额 / 限额 */
+    quota() {
+        return this.serverRequest("GET", "/api/dashboard/quota");
+    }
+    /** 用量趋势（默认 30 天） */
+    trend(days = 30) {
+        return this.serverRequest("GET", `/api/dashboard/trend?days=${days}`);
+    }
+}

package/dist/resources/internalAgent.d.ts

@@ -0,0 +1,70 @@
+import { RequestMethod, EnterpriseDoc, MonitorConnector, MonitorConnectorKind, MonitorEvent } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+export declare class InternalAgentResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 列出企业知识文档 */
+    listEnterpriseDocs(): Promise<EnterpriseDoc[]>;
+    /** 插入企业知识文档（文本） */
+    insertEnterpriseDoc(params: {
+        text: string;
+        fileName?: string;
+    }): Promise<{
+        success: boolean;
+        doc_id: string;
+        namespace: string;
+    }>;
+    /** 删除企业知识文档 */
+    deleteEnterpriseDoc(docId: string): Promise<{
+        success: boolean;
+        doc_id: string;
+        deleted: boolean;
+    }>;
+    /** 查询企业知识库（返回上下文，不生成 LLM 回答） */
+    queryEnterprise(params: {
+        query: string;
+        mode?: string;
+    }): Promise<{
+        context: string;
+        mode: string;
+    }>;
+    /** 列出某 bot 的监控连接器 */
+    listConnectors(projectId: string, botId: string): Promise<MonitorConnector[]>;
+    /**
+     * 创建监控连接器。
+     * kind = http_poll（平台轮询，需 config.url）| webhook（平台接收推送）| local（本地部署 agent 回传）。
+     * webhook / local 返回 token（仅创建时一次），供上报/本地部署配置使用。
+     */
+    createConnector(projectId: string, botId: string, params: {
+        kind: MonitorConnectorKind;
+        name?: string;
+        config?: Record<string, unknown>;
+    }): Promise<MonitorConnector & {
+        token?: string;
+    }>;
+    /** 更新连接器（name / status / config） */
+    updateConnector(projectId: string, botId: string, connectorId: string, params: {
+        name?: string;
+        status?: string;
+        config?: Record<string, unknown>;
+    }): Promise<MonitorConnector>;
+    /** 删除连接器 */
+    deleteConnector(projectId: string, botId: string, connectorId: string): Promise<{
+        success: boolean;
+    }>;
+    /** 查询监控事件（新→旧，支持 limit / keyword / sinceHours 过滤） */
+    queryMonitorEvents(projectId: string, botId: string, params?: {
+        limit?: number;
+        keyword?: string;
+        sinceHours?: number;
+    }): Promise<MonitorEvent[]>;
+    /** webhook 推送 / 本地部署 agent 上报事件（无需 JWT，凭连接器 token） */
+    ingestEvent(params: {
+        connectorId: string;
+        token: string;
+        payload: Record<string, unknown>;
+    }): Promise<{
+        success: boolean;
+    }>;
+}
+export {};