@reachv2/sdk 0.1.0

package/dist/resources/internalAgent.js

@@ -0,0 +1,60 @@
+export class InternalAgentResource {
+    constructor(request) {
+        this.request = request;
+    }
+    // ── 企业级共享知识库（按商户隔离，namespace = ent-{merchant_id}）──
+    /** 列出企业知识文档 */
+    listEnterpriseDocs() {
+        return this.request("GET", "/api/merchant/knowledge/enterprise");
+    }
+    /** 插入企业知识文档（文本） */
+    insertEnterpriseDoc(params) {
+        return this.request("POST", "/api/merchant/knowledge/enterprise", params);
+    }
+    /** 删除企业知识文档 */
+    deleteEnterpriseDoc(docId) {
+        return this.request("DELETE", `/api/merchant/knowledge/enterprise/${encodeURIComponent(docId)}`);
+    }
+    /** 查询企业知识库（返回上下文，不生成 LLM 回答） */
+    queryEnterprise(params) {
+        return this.request("POST", "/api/merchant/knowledge/enterprise/query", params);
+    }
+    // ── 监控连接器 ──
+    /** 列出某 bot 的监控连接器 */
+    listConnectors(projectId, botId) {
+        return this.request("GET", `/api/merchant/projects/${encodeURIComponent(projectId)}/bots/${encodeURIComponent(botId)}/connectors`);
+    }
+    /**
+     * 创建监控连接器。
+     * kind = http_poll（平台轮询，需 config.url）| webhook（平台接收推送）| local（本地部署 agent 回传）。
+     * webhook / local 返回 token（仅创建时一次），供上报/本地部署配置使用。
+     */
+    createConnector(projectId, botId, params) {
+        return this.request("POST", `/api/merchant/projects/${encodeURIComponent(projectId)}/bots/${encodeURIComponent(botId)}/connectors`, params);
+    }
+    /** 更新连接器（name / status / config） */
+    updateConnector(projectId, botId, connectorId, params) {
+        return this.request("PATCH", `/api/merchant/projects/${encodeURIComponent(projectId)}/bots/${encodeURIComponent(botId)}/connectors/${encodeURIComponent(connectorId)}`, params);
+    }
+    /** 删除连接器 */
+    deleteConnector(projectId, botId, connectorId) {
+        return this.request("DELETE", `/api/merchant/projects/${encodeURIComponent(projectId)}/bots/${encodeURIComponent(botId)}/connectors/${encodeURIComponent(connectorId)}`);
+    }
+    /** 查询监控事件（新→旧，支持 limit / keyword / sinceHours 过滤） */
+    queryMonitorEvents(projectId, botId, params) {
+        const qs = new URLSearchParams();
+        if (params?.limit)
+            qs.set("limit", String(params.limit));
+        if (params?.keyword)
+            qs.set("keyword", params.keyword);
+        if (params?.sinceHours != null)
+            qs.set("sinceHours", String(params.sinceHours));
+        const query = qs.toString() ? `?${qs.toString()}` : "";
+        return this.request("GET", `/api/merchant/projects/${encodeURIComponent(projectId)}/bots/${encodeURIComponent(botId)}/monitor/events${query}`);
+    }
+    // ── 监控事件入口（公开，token 校验）──
+    /** webhook 推送 / 本地部署 agent 上报事件（无需 JWT，凭连接器 token） */
+    ingestEvent(params) {
+        return this.request("POST", "/api/monitor/ingest", params);
+    }
+}

package/dist/resources/knowledge.d.ts

@@ -0,0 +1,17 @@
+import { RequestMethod, KnowledgeDoc, KnowledgeRecommendation, BotType } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+export declare class KnowledgeResource {
+    private request;
+    constructor(request: RequestFn);
+    upload(botId: string, params: {
+        content: string;
+        title: string;
+        format?: string;
+    }): Promise<KnowledgeDoc>;
+    list(botId: string): Promise<KnowledgeDoc[]>;
+    delete(id: string): Promise<{
+        deleted: boolean;
+    }>;
+    recommendations(botType: BotType): Promise<KnowledgeRecommendation[]>;
+}
+export {};

package/dist/resources/knowledge.js

@@ -0,0 +1,17 @@
+export class KnowledgeResource {
+    constructor(request) {
+        this.request = request;
+    }
+    upload(botId, params) {
+        return this.request("POST", `/api/v1/bots/${botId}/knowledge`, params);
+    }
+    list(botId) {
+        return this.request("GET", `/api/v1/bots/${botId}/knowledge`);
+    }
+    delete(id) {
+        return this.request("DELETE", `/api/v1/knowledge/${id}`);
+    }
+    recommendations(botType) {
+        return this.request("GET", `/api/v1/knowledge/recommendations?botType=${botType}`);
+    }
+}

package/dist/resources/lightrag.d.ts

@@ -0,0 +1,80 @@
+import { LightRAGKeyInfo, LightRAGDocumentParams, LightRAGQueryParams, LightRAGQueryResult, LightRAGBatchResult, RequestMethod } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/**
+ * LightRAG Knowledge Base management.
+ *
+ * One botId = one LightRAG tenant.  External apps can:
+ * - Manage API keys for direct LightRAG service access
+ * - Insert/query/delete documents in the RAG vector store
+ *
+ * Per-user isolation: pass `namespace` to scope documents/queries to a specific user.
+ * Defaults to botId (shared knowledge).
+ */
+export declare class LightRAGResource {
+    private request;
+    constructor(request: RequestFn);
+    /**
+     * List all active API keys for a bot's knowledge base.
+     */
+    listKeys(botId: string): Promise<{
+        keys: LightRAGKeyInfo[];
+    }>;
+    /**
+     * Generate a new API key for a bot's knowledge base.
+     * The full key is returned only once — save it immediately.
+     *
+     * @param botId - Bot ID (tenant)
+     * @param name - Key label (e.g. "production", "dev")
+     * @param expiresDays - Days until expiration (0 = never)
+     */
+    generateKey(botId: string, name?: string, expiresDays?: number): Promise<LightRAGKeyInfo & {
+        key: string;
+    }>;
+    /**
+     * Revoke an API key. Takes effect immediately.
+     */
+    revokeKey(keyId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Insert/update a text document into the bot's RAG knowledge base.
+     *
+     * @param botId - Bot ID (tenant)
+     * @param params - Document text + optional file_name and namespace
+     */
+    insertDocument(botId: string, params: LightRAGDocumentParams): Promise<{
+        success: boolean;
+        doc_id: string;
+    }>;
+    /**
+     * Batch insert multiple documents into the bot's RAG knowledge base.
+     * 服务端逐篇直传（不依赖 InfraX 异步任务），返回每篇上传结果。
+     *
+     * @param botId - Bot ID (tenant)
+     * @param documents - Array of { text, file_name? }
+     * @param namespace - Per-user namespace (optional)
+     */
+    insertDocuments(botId: string, documents: {
+        text: string;
+        file_name?: string;
+    }[], namespace?: string): Promise<LightRAGBatchResult>;
+    /**
+     * Delete a document from the bot's RAG knowledge base.
+     *
+     * @param botId - Bot ID (tenant)
+     * @param docId - Document ID (file_name used at insert)
+     * @param namespace - Per-user namespace (optional)
+     */
+    deleteDocument(botId: string, docId: string, namespace?: string): Promise<{
+        deleted: boolean;
+    }>;
+    /**
+     * Query the bot's RAG knowledge base for relevant context.
+     * Returns raw context (entities, relations, chunks) — no LLM answer.
+     *
+     * @param botId - Bot ID (tenant)
+     * @param params - Query text, optional mode and namespace
+     */
+    query(botId: string, params: LightRAGQueryParams): Promise<LightRAGQueryResult>;
+}
+export {};

package/dist/resources/lightrag.js

@@ -0,0 +1,92 @@
+/**
+ * LightRAG Knowledge Base management.
+ *
+ * One botId = one LightRAG tenant.  External apps can:
+ * - Manage API keys for direct LightRAG service access
+ * - Insert/query/delete documents in the RAG vector store
+ *
+ * Per-user isolation: pass `namespace` to scope documents/queries to a specific user.
+ * Defaults to botId (shared knowledge).
+ */
+export class LightRAGResource {
+    constructor(request) {
+        this.request = request;
+    }
+    // ── API Key Management ─────────────────────────────
+    /**
+     * List all active API keys for a bot's knowledge base.
+     */
+    async listKeys(botId) {
+        return this.request("GET", `/api/v1/lightrag-keys/${botId}`);
+    }
+    /**
+     * Generate a new API key for a bot's knowledge base.
+     * The full key is returned only once — save it immediately.
+     *
+     * @param botId - Bot ID (tenant)
+     * @param name - Key label (e.g. "production", "dev")
+     * @param expiresDays - Days until expiration (0 = never)
+     */
+    async generateKey(botId, name = "default", expiresDays = 0) {
+        return this.request("POST", `/api/v1/lightrag-keys/${botId}`, { name, expires_days: expiresDays });
+    }
+    /**
+     * Revoke an API key. Takes effect immediately.
+     */
+    async revokeKey(keyId) {
+        return this.request("POST", `/api/v1/lightrag-keys/${keyId}/revoke`);
+    }
+    // ── Document Operations ─────────────────────────────
+    /**
+     * Insert/update a text document into the bot's RAG knowledge base.
+     *
+     * @param botId - Bot ID (tenant)
+     * @param params - Document text + optional file_name and namespace
+     */
+    async insertDocument(botId, params) {
+        return this.request("POST", `/api/v1/bots/${botId}/lightrag/documents`, {
+            text: params.text,
+            file_name: params.file_name,
+            namespace: params.namespace,
+        });
+    }
+    /**
+     * Batch insert multiple documents into the bot's RAG knowledge base.
+     * 服务端逐篇直传（不依赖 InfraX 异步任务），返回每篇上传结果。
+     *
+     * @param botId - Bot ID (tenant)
+     * @param documents - Array of { text, file_name? }
+     * @param namespace - Per-user namespace (optional)
+     */
+    async insertDocuments(botId, documents, namespace) {
+        return this.request("POST", `/api/v1/bots/${botId}/lightrag/documents/batch`, {
+            documents,
+            namespace,
+        });
+    }
+    /**
+     * Delete a document from the bot's RAG knowledge base.
+     *
+     * @param botId - Bot ID (tenant)
+     * @param docId - Document ID (file_name used at insert)
+     * @param namespace - Per-user namespace (optional)
+     */
+    async deleteDocument(botId, docId, namespace) {
+        const nsQuery = namespace ? `?namespace=${encodeURIComponent(namespace)}` : "";
+        return this.request("DELETE", `/api/v1/bots/${botId}/lightrag/documents/${encodeURIComponent(docId)}${nsQuery}`);
+    }
+    /**
+     * Query the bot's RAG knowledge base for relevant context.
+     * Returns raw context (entities, relations, chunks) — no LLM answer.
+     *
+     * @param botId - Bot ID (tenant)
+     * @param params - Query text, optional mode and namespace
+     */
+    async query(botId, params) {
+        return this.request("POST", `/api/v1/bots/${botId}/lightrag/query`, {
+            query: params.query,
+            mode: params.mode,
+            namespace: params.namespace,
+        });
+    }
+}

package/dist/resources/orchestration.d.ts

@@ -0,0 +1,46 @@
+import { RequestMethod, ConversationCapabilities, ConversationSession, ConversationTask, OrchestrateParams, OrchestrateResult } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/**
+ * Conversation Orchestration（多 task × 多 agent）
+ * 基于 Reach Server 的 /api/conversation/* 端点（内部转发 AgentX ConversationClient）。
+ * 任务为后台执行，创建即返回（status: queued），轮询 getTask/listTasks 获取结果。
+ */
+export declare class OrchestrationResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 能力探测：parallelTasks 等。parallelTasks=false 时不应使用 orchestrate。 */
+    capabilities(): Promise<ConversationCapabilities>;
+    /** 创建会话（多个任务的容器） */
+    createSession(params?: {
+        title?: string;
+        agentId?: number;
+    }): Promise<ConversationSession>;
+    /** 创建单个后台任务（agentId 或 inline prompt/skills 模式） */
+    createTask(params: {
+        sessionId: string;
+        agentId?: number;
+        message: string;
+        prompt?: string;
+        skills?: Record<string, unknown>[];
+        enableMemory?: boolean;
+        history?: {
+            role: "user" | "assistant";
+            content: string;
+        }[];
+    }): Promise<ConversationTask>;
+    /** 查询单个任务 */
+    getTask(taskId: string): Promise<ConversationTask>;
+    /** 列出会话下的所有任务 */
+    listTasks(sessionId: string): Promise<{
+        tasks: ConversationTask[];
+    }>;
+    /** 取消任务（queued → 直接取消，running → 中止） */
+    cancelTask(taskId: string): Promise<ConversationTask>;
+    /**
+     * 多 Agent 并行编排：一次创建多个任务（每个任务可指定不同 agent）。
+     * AgentX 侧禁用并行任务时返回 HTTP 403（parallel_tasks_disabled），
+     * 调用方应降级为 createTask 逐个创建或单轮 chat()。
+     */
+    orchestrate(params: OrchestrateParams): Promise<OrchestrateResult>;
+}
+export {};

package/dist/resources/orchestration.js

@@ -0,0 +1,42 @@
+/**
+ * Conversation Orchestration（多 task × 多 agent）
+ * 基于 Reach Server 的 /api/conversation/* 端点（内部转发 AgentX ConversationClient）。
+ * 任务为后台执行，创建即返回（status: queued），轮询 getTask/listTasks 获取结果。
+ */
+export class OrchestrationResource {
+    constructor(request) {
+        this.request = request;
+    }
+    /** 能力探测：parallelTasks 等。parallelTasks=false 时不应使用 orchestrate。 */
+    capabilities() {
+        return this.request("GET", "/api/conversation/capabilities");
+    }
+    /** 创建会话（多个任务的容器） */
+    createSession(params) {
+        return this.request("POST", "/api/conversation/sessions", params || {});
+    }
+    /** 创建单个后台任务（agentId 或 inline prompt/skills 模式） */
+    createTask(params) {
+        return this.request("POST", "/api/conversation/tasks", params);
+    }
+    /** 查询单个任务 */
+    getTask(taskId) {
+        return this.request("GET", `/api/conversation/tasks/${taskId}`);
+    }
+    /** 列出会话下的所有任务 */
+    listTasks(sessionId) {
+        return this.request("GET", `/api/conversation/sessions/${sessionId}/tasks`);
+    }
+    /** 取消任务（queued → 直接取消，running → 中止） */
+    cancelTask(taskId) {
+        return this.request("POST", `/api/conversation/tasks/${taskId}/cancel`);
+    }
+    /**
+     * 多 Agent 并行编排：一次创建多个任务（每个任务可指定不同 agent）。
+     * AgentX 侧禁用并行任务时返回 HTTP 403（parallel_tasks_disabled），
+     * 调用方应降级为 createTask 逐个创建或单轮 chat()。
+     */
+    orchestrate(params) {
+        return this.request("POST", "/api/conversation/orchestrate", params);
+    }
+}

package/dist/resources/project.d.ts

@@ -0,0 +1,14 @@
+import { RequestMethod, Project, ProjectCreateParams, ProjectUpdateParams } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+export declare class ProjectResource {
+    private request;
+    constructor(request: RequestFn);
+    create(params: ProjectCreateParams): Promise<Project>;
+    list(): Promise<Project[]>;
+    get(id: string): Promise<Project>;
+    update(id: string, params: ProjectUpdateParams): Promise<Project>;
+    delete(id: string): Promise<{
+        deleted: boolean;
+    }>;
+}
+export {};

package/dist/resources/project.js

@@ -0,0 +1,20 @@
+export class ProjectResource {
+    constructor(request) {
+        this.request = request;
+    }
+    create(params) {
+        return this.request("POST", "/api/v1/projects", params);
+    }
+    list() {
+        return this.request("GET", "/api/v1/projects");
+    }
+    get(id) {
+        return this.request("GET", `/api/v1/projects/${id}`);
+    }
+    update(id, params) {
+        return this.request("PATCH", `/api/v1/projects/${id}`, params);
+    }
+    delete(id) {
+        return this.request("DELETE", `/api/v1/projects/${id}`);
+    }
+}

package/dist/resources/scheduledTasks.d.ts

@@ -0,0 +1,29 @@
+import { RequestMethod, ScheduledTask, ScheduledTaskTriggerType } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/**
+ * Scheduled Tasks（主 agent 定时任务）
+ * 对话内主 agent 通过 schedule_task 工具创建；此资源用于商户侧
+ * 查看/创建/取消，管理同一 scheduled_tasks 存储。
+ */
+export declare class ScheduledTasksResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 列出某 bot 的定时任务（新→旧） */
+    list(botId: string): Promise<{
+        tasks: ScheduledTask[];
+    }>;
+    /** 创建定时任务（once 一次性 / cron 重复） */
+    create(params: {
+        botId: string;
+        projectId?: string;
+        description?: string;
+        message: string;
+        triggerType: ScheduledTaskTriggerType;
+        cronExpr?: string;
+        runAt?: string;
+        agentId?: number;
+    }): Promise<ScheduledTask>;
+    /** 取消定时任务 */
+    cancel(id: string): Promise<ScheduledTask>;
+}
+export {};

package/dist/resources/scheduledTasks.js

@@ -0,0 +1,22 @@
+/**
+ * Scheduled Tasks（主 agent 定时任务）
+ * 对话内主 agent 通过 schedule_task 工具创建；此资源用于商户侧
+ * 查看/创建/取消，管理同一 scheduled_tasks 存储。
+ */
+export class ScheduledTasksResource {
+    constructor(request) {
+        this.request = request;
+    }
+    /** 列出某 bot 的定时任务（新→旧） */
+    list(botId) {
+        return this.request("GET", `/api/merchant/bots/${encodeURIComponent(botId)}/scheduled-tasks`);
+    }
+    /** 创建定时任务（once 一次性 / cron 重复） */
+    create(params) {
+        return this.request("POST", "/api/scheduled-tasks", params);
+    }
+    /** 取消定时任务 */
+    cancel(id) {
+        return this.request("POST", `/api/scheduled-tasks/${id}/cancel`);
+    }
+}

package/dist/resources/transaction.d.ts

@@ -0,0 +1,28 @@
+import { RequestMethod, TxIntent, PreparedTransaction, ContractInfo, SimulationResult, DecodedCalldata, ProtocolRegistryEntry, ProtocolSummary } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+export declare class TransactionResource {
+    private request;
+    constructor(request: RequestFn);
+    prepare(botId: string, intent: TxIntent): Promise<PreparedTransaction>;
+    simulate(params: {
+        to: string;
+        data: string;
+        value: string;
+        chainId: number;
+        from: string;
+    }): Promise<SimulationResult>;
+    lookupContract(params: {
+        contractAddress: string;
+        chainId: number;
+    }): Promise<ContractInfo>;
+    decodeCalldata(params: {
+        data: string;
+        contractAddress: string;
+        chainId: number;
+    }): Promise<DecodedCalldata>;
+    listProtocols(chainId?: number): Promise<ProtocolSummary[]>;
+    registerProtocol(protocol: ProtocolRegistryEntry): Promise<{
+        registered: boolean;
+    }>;
+}
+export {};

package/dist/resources/transaction.js

@@ -0,0 +1,24 @@
+export class TransactionResource {
+    constructor(request) {
+        this.request = request;
+    }
+    prepare(botId, intent) {
+        return this.request("POST", `/api/v1/bots/${botId}/transaction/prepare`, intent);
+    }
+    simulate(params) {
+        return this.request("POST", "/api/v1/transaction/simulate", params);
+    }
+    lookupContract(params) {
+        return this.request("POST", "/api/v1/transaction/lookup-contract", params);
+    }
+    decodeCalldata(params) {
+        return this.request("POST", "/api/v1/transaction/decode-calldata", params);
+    }
+    listProtocols(chainId) {
+        const query = chainId ? `?chainId=${chainId}` : "";
+        return this.request("GET", `/api/v1/transaction/protocols${query}`);
+    }
+    registerProtocol(protocol) {
+        return this.request("POST", "/api/v1/transaction/protocols", protocol);
+    }
+}

package/dist/resources/tts.d.ts

@@ -0,0 +1,17 @@
+import { RequestMethod } from "../types.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/**
+ * TTS 资源 — 文本转语音（源自 aiops-saas @aiops/sdk TtsApi）。
+ * 端点走 Server API（/api/tts/*），与社媒域 MCP 工具同源。
+ */
+export declare class TtsResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 文本转语音 */
+    synthesize(text: string, voice?: string, opts?: Record<string, unknown>): Promise<any>;
+    /** 可用语音列表 */
+    voices(language?: string): Promise<any>;
+    /** TTS 历史（分页） */
+    history(params?: Record<string, unknown>): Promise<any>;
+}
+export {};

package/dist/resources/tts.js

@@ -0,0 +1,22 @@
+/**
+ * TTS 资源 — 文本转语音（源自 aiops-saas @aiops/sdk TtsApi）。
+ * 端点走 Server API（/api/tts/*），与社媒域 MCP 工具同源。
+ */
+export class TtsResource {
+    constructor(request) {
+        this.request = request;
+    }
+    /** 文本转语音 */
+    synthesize(text, voice = "zh-CN-XiaoxiaoNeural", opts = {}) {
+        return this.request("POST", "/api/tts/synthesize", { text, voice, ...opts });
+    }
+    /** 可用语音列表 */
+    voices(language = "") {
+        return this.request("GET", `/api/tts/voices${language ? `?language=${language}` : ""}`);
+    }
+    /** TTS 历史（分页） */
+    history(params = {}) {
+        const qs = new URLSearchParams(params).toString();
+        return this.request("GET", `/api/tts/history${qs ? `?${qs}` : ""}`);
+    }
+}