@lingya-ai/agents-sdk 0.4.0 → 0.7.0

package/dist/esm/browser.d.ts

@@ -0,0 +1,14 @@
+/** Browser entry: only single-use token authentication is available. */
+import { AgentsUserClient } from './client-core';
+import { type ClientOptions, type TokenAuth } from './token';
+export * from './runtime';
+export * from './models/index';
+export * from './bound';
+export * from './client-core';
+export * from './token';
+export { decodeAiChatBriefEvent, decodeToolExtension, type AiChatBriefEvent, type ToolExtension } from './events';
+export * from './sse';
+export type AgentsClientOptions = ClientOptions<TokenAuth>;
+export declare class AgentsClient extends AgentsUserClient {
+    constructor(options: AgentsClientOptions);
+}

package/dist/esm/browser.js

@@ -0,0 +1,47 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { abortable, ApiError, checkSignal } from './lifecycle';
+/** Browser entry: only single-use token authentication is available. */
+import { AgentsUserClient } from './client-core';
+import { Configuration } from './runtime';
+import { createTokenFetch } from './token';
+export * from './runtime';
+export * from './models/index';
+export * from './bound';
+export * from './client-core';
+export * from './token';
+export { decodeAiChatBriefEvent, decodeToolExtension } from './events';
+export * from './sse';
+export class AgentsClient extends AgentsUserClient {
+    constructor(options) {
+        if (!options.channelId)
+            throw new Error('channelId must not be empty');
+        if (options.auth.type !== 'token')
+            throw new Error('Browser clients require token authentication');
+        const transport = createTokenFetch(options.auth.tokenProvider, options.channelId, options.fetch);
+        super(options.channelId, new Configuration({ basePath: options.baseUrl.replace(/\/+$/, ''), fetchApi: transport }), transport, options.baseUrl, true, (url, signal) => __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            let token;
+            try {
+                token = yield abortable(Promise.resolve().then(() => { var _a; return options.auth.tokenProvider({ channelId: options.channelId, signal, fetch: (_a = options.fetch) !== null && _a !== void 0 ? _a : globalThis.fetch }); }), signal);
+            }
+            catch (error) {
+                if (signal.aborted)
+                    throw error;
+                throw new ApiError('', '', undefined, '', { kind: 'authentication' });
+            }
+            if (typeof token !== 'string' || !/^[!#-~]+$/.test(token))
+                throw new ApiError('', '', undefined, '', { kind: 'authentication' });
+            const factory = (_a = options.webSocketFactory) !== null && _a !== void 0 ? _a : ((address, init) => new WebSocket(address, init.protocols));
+            checkSignal(signal);
+            return factory(url, { protocols: [`xlt-openapi-token.${token}`] });
+        }));
+    }
+}

package/dist/esm/client-core.d.ts

@@ -0,0 +1,101 @@
+import { ApiError } from './lifecycle';
+import { type WebSocketConnector } from './subscription';
+export * from './lifecycle';
+export * from './subscription';
+import { Configuration } from './runtime';
+import { type AiChatBriefEvent } from './events';
+import { AgentsLowLevelApis, ChatApi as BoundChatApi, ConfigurationApi as BoundConfigurationApi, ConversationsApi as BoundConversationsApi, EventsApi as BoundEventsApi, FilesApi as BoundFilesApi, InteractionsApi as BoundInteractionsApi, KnowledgeApi as BoundKnowledgeApi, MessagesApi as BoundMessagesApi, SqlApi, WorkspaceApi as BoundWorkspaceApi } from './bound';
+/** 已绑定外部用户的强类型 API 集合。 / Strongly typed API collection bound to one external user. */
+export declare class AgentsUserClient {
+    readonly channelId: string;
+    private readonly signedFetch;
+    private readonly baseUrl;
+    /** 发起新聊天和流探针。 / Starts chats and stream probes. */
+    readonly chat: BoundChatApi;
+    /** 读取 Agent 与会话配置。 / Reads Agent and conversation configuration. */
+    readonly configuration: BoundConfigurationApi;
+    /** 管理会话、状态、分享和异步任务。 / Manages conversations, status, shares, and async tasks. */
+    readonly conversations: BoundConversationsApi;
+    /** 查询已持久化事件。 / Reads persisted events. */
+    readonly events: BoundEventsApi;
+    /** 管理附件与预签名 URL。 / Manages attachments and pre-signed URLs. */
+    readonly files: BoundFilesApi;
+    /** 回答用户问题并处理计划审批。 / Handles user answers and plan approval. */
+    readonly interactions: BoundInteractionsApi;
+    /** 查询引用元数据。 / Reads citation metadata. */
+    readonly knowledge: BoundKnowledgeApi;
+    /** 查询消息并控制排队消息。 / Reads messages and controls queued messages. */
+    readonly messages: BoundMessagesApi;
+    /** 查询、导出 SQL 结果与图表数据。 / Reads and exports SQL results and chart data. */
+    readonly sql: SqlApi;
+    /** 查询工作区文件及预览。 / Reads workspace files and previews. */
+    readonly workspace: BoundWorkspaceApi;
+    /**
+     * 兼容旧版本的原始生成 API；正常业务调用应使用绑定门面。 / Raw generated APIs retained for migration only.
+     *
+     * @deprecated 将在 1.0 移除。 / Scheduled for removal in 1.0.
+     */
+    readonly lowLevel: AgentsLowLevelApis;
+    constructor(channelId: string, configuration: Configuration, signedFetch: typeof fetch, baseUrl: string, tokenAuth?: boolean, connector?: WebSocketConnector);
+    /**
+     * 调用契约端点并按指定类型返回 JSON；优先使用上方生成的强类型 API。 / Calls a contract endpoint and decodes typed JSON.
+     *
+     * @param method - 大写 HTTP method。
+     * @param suffix - 相对于 channel chat 根路径的已编码路径。
+     * @param bodyJson - 最终发送并参与签名的 UTF-8 JSON 字符串；无请求体时省略。
+     * @param query - 已按最终顺序组装的查询参数，允许重复键。
+     * @returns 调用方指定的响应类型。
+     * @throws [ApiError] 当服务端返回非 2xx 状态。
+     */
+    /** @deprecated 使用对应的业务分组方法。 / Use the matching grouped facade operation. */
+    request<T>(method: string, suffix: string, bodyJson?: string, query?: URLSearchParams): Promise<T>;
+    /**
+     * 调用无响应正文的契约端点。 / Calls a contract endpoint that has no response body.
+     *
+     * @param method - 大写 HTTP method。
+     * @param suffix - 相对于 channel chat 根路径的已编码路径。
+     * @param bodyJson - 最终发送并参与签名的 UTF-8 JSON 字符串。
+     * @param query - 保留顺序的查询参数。
+     * @returns 2xx HTTP 状态码。
+     */
+    /** @deprecated 使用对应的业务分组方法。 / Use the matching grouped facade operation. */
+    requestStatus(method: string, suffix: string, bodyJson?: string, query?: URLSearchParams): Promise<number>;
+    /**
+     * 下载二进制响应，返回精确响应字节。 / Downloads an exact binary response.
+     *
+     * @param method - HTTP method，通常为 `GET`。
+     * @param suffix - 已编码的相对路径。
+     * @param query - 保留顺序的查询参数。
+     * @returns 未经文本转换的响应字节。
+     */
+    /** @deprecated 使用对应的业务分组方法。 / Use the matching grouped facade operation. */
+    requestBinary(method: string, suffix: string, query?: URLSearchParams): Promise<Uint8Array>;
+    /**
+     * 订阅对话 SSE，事件按契约判别联合返回。 / Streams SSE as the contract discriminated union.
+     *
+     * @param conversationId - 要订阅的会话 ID。
+     * @param messageId - 触发本次生成的消息 ID。
+     * @returns 支持取消的异步事件序列；未知 type 保留 `rawJson`。
+     */
+    /** @deprecated 使用 `chat.streamChatEvents(conversationId, { messageId })`。 / Use the channel-bound chat facade. */
+    streamChatEvents(conversationId: string, messageId: string): AsyncGenerator<AiChatBriefEvent>;
+    /**
+     * 发送底层受控请求；调用前固定最终 path、query、Content-Type 与 body 字节。 / Sends an exactly signed low-level request.
+     *
+     * 每次调用重新生成 timestamp 与 nonce，不对写请求自动重试。
+     *
+     * @param method - HTTP method。
+     * @param suffix - 已完成路径转义的相对路径；本方法不会二次编码。
+     * @param bodyJson - 最终 JSON 字符串，最大 2 MiB；省略时 Content-Type 为空。
+     * @param query - 最终查询参数；顺序和重复键均参与签名。
+     * @param accept - 精确的 Accept 值，例如 `application/json`、`text/event-stream` 或 `text/csv`。
+     * @returns 成功的原始 Fetch Response。
+     * @throws [ApiError] 当服务端返回非 2xx 状态。
+     */
+    /** @deprecated 使用 `lowLevel`，或使用对应的业务分组方法。 / Use `lowLevel` or a grouped facade operation. */
+    rawRequest(method: string, suffix: string, bodyJson?: string, query?: URLSearchParams, accept?: string, requestId?: string, signal?: AbortSignal): Promise<Response>;
+}
+/** @deprecated Use [AgentsUserClient]. */
+export { AgentsUserClient as LingyaAgentsUserClient };
+/** @deprecated Use [ApiError]. */
+export { ApiError as LingyaApiError };

package/dist/esm/client-core.js

@@ -0,0 +1,142 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { ApiError } from './lifecycle';
+import { ChatSubscription } from './subscription';
+export * from './lifecycle';
+export * from './subscription';
+import { ChatApi, ConfigurationApi, ConversationsApi, EventsApi, FilesApi, InteractionsApi, KnowledgeApi, MessagesApi, SQLApi, WorkspaceApi } from './apis';
+import { AgentsLowLevelApis, ChatApi as BoundChatApi, ConfigurationApi as BoundConfigurationApi, ConversationsApi as BoundConversationsApi, EventsApi as BoundEventsApi, FilesApi as BoundFilesApi, InteractionsApi as BoundInteractionsApi, KnowledgeApi as BoundKnowledgeApi, MessagesApi as BoundMessagesApi, SqlApi, WorkspaceApi as BoundWorkspaceApi, } from './bound';
+/** 已绑定外部用户的强类型 API 集合。 / Strongly typed API collection bound to one external user. */
+export class AgentsUserClient {
+    constructor(channelId, configuration, signedFetch, baseUrl, tokenAuth = false, connector) {
+        this.channelId = channelId;
+        this.signedFetch = signedFetch;
+        this.baseUrl = baseUrl;
+        const chat = new ChatApi(configuration);
+        const configurationApi = new ConfigurationApi(configuration);
+        const conversations = new ConversationsApi(configuration);
+        const events = new EventsApi(configuration);
+        const files = new FilesApi(configuration);
+        const interactions = new InteractionsApi(configuration);
+        const knowledge = new KnowledgeApi(configuration);
+        const messages = new MessagesApi(configuration);
+        const sql = new SQLApi(configuration);
+        const workspace = new WorkspaceApi(configuration);
+        this.lowLevel = new AgentsLowLevelApis(configurationApi, chat, conversations, sql, messages, events, interactions, files, knowledge, workspace);
+        const rawRequest = this.rawRequest.bind(this);
+        this.chat = new BoundChatApi(channelId, chat, rawRequest, (conversationId, input, options) => {
+            const suffix = `/conversations/${encodeURIComponent(conversationId)}/stream`;
+            const url = new URL(`${this.baseUrl.replace(/\/+$/, '')}/api/agents/channel/openapi/v1/${encodeURIComponent(channelId)}/chat${suffix}/ws`);
+            url.protocol = url.protocol === 'https:' ? 'wss:' : 'ws:';
+            url.searchParams.set('messageId', input.messageId);
+            return new ChatSubscription(signal => rawRequest('POST', suffix, JSON.stringify(input), undefined, 'text/event-stream', options.xRequestID, signal), url.toString(), input.messageId, options, connector);
+        });
+        this.configuration = new BoundConfigurationApi(channelId, configurationApi, tokenAuth);
+        this.conversations = new BoundConversationsApi(channelId, conversations);
+        this.events = new BoundEventsApi(channelId, events);
+        this.files = new BoundFilesApi(channelId, files);
+        this.interactions = new BoundInteractionsApi(channelId, interactions);
+        this.knowledge = new BoundKnowledgeApi(channelId, knowledge);
+        this.messages = new BoundMessagesApi(channelId, messages);
+        this.sql = new SqlApi(channelId, sql);
+        this.workspace = new BoundWorkspaceApi(channelId, workspace);
+    }
+    /**
+     * 调用契约端点并按指定类型返回 JSON；优先使用上方生成的强类型 API。 / Calls a contract endpoint and decodes typed JSON.
+     *
+     * @param method - 大写 HTTP method。
+     * @param suffix - 相对于 channel chat 根路径的已编码路径。
+     * @param bodyJson - 最终发送并参与签名的 UTF-8 JSON 字符串；无请求体时省略。
+     * @param query - 已按最终顺序组装的查询参数，允许重复键。
+     * @returns 调用方指定的响应类型。
+     * @throws [ApiError] 当服务端返回非 2xx 状态。
+     */
+    /** @deprecated 使用对应的业务分组方法。 / Use the matching grouped facade operation. */
+    request(method, suffix, bodyJson, query) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.rawRequest(method, suffix, bodyJson, query, 'application/json');
+            return yield response.json();
+        });
+    }
+    /**
+     * 调用无响应正文的契约端点。 / Calls a contract endpoint that has no response body.
+     *
+     * @param method - 大写 HTTP method。
+     * @param suffix - 相对于 channel chat 根路径的已编码路径。
+     * @param bodyJson - 最终发送并参与签名的 UTF-8 JSON 字符串。
+     * @param query - 保留顺序的查询参数。
+     * @returns 2xx HTTP 状态码。
+     */
+    /** @deprecated 使用对应的业务分组方法。 / Use the matching grouped facade operation. */
+    requestStatus(method, suffix, bodyJson, query) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return (yield this.rawRequest(method, suffix, bodyJson, query, 'application/json')).status;
+        });
+    }
+    /**
+     * 下载二进制响应，返回精确响应字节。 / Downloads an exact binary response.
+     *
+     * @param method - HTTP method，通常为 `GET`。
+     * @param suffix - 已编码的相对路径。
+     * @param query - 保留顺序的查询参数。
+     * @returns 未经文本转换的响应字节。
+     */
+    /** @deprecated 使用对应的业务分组方法。 / Use the matching grouped facade operation. */
+    requestBinary(method, suffix, query) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.rawRequest(method, suffix, undefined, query, 'application/octet-stream');
+            return new Uint8Array(yield response.arrayBuffer());
+        });
+    }
+    /**
+     * 订阅对话 SSE，事件按契约判别联合返回。 / Streams SSE as the contract discriminated union.
+     *
+     * @param conversationId - 要订阅的会话 ID。
+     * @param messageId - 触发本次生成的消息 ID。
+     * @returns 支持取消的异步事件序列；未知 type 保留 `rawJson`。
+     */
+    /** @deprecated 使用 `chat.streamChatEvents(conversationId, { messageId })`。 / Use the channel-bound chat facade. */
+    streamChatEvents(conversationId, messageId) {
+        return this.chat.streamChatEvents(conversationId, { messageId });
+    }
+    /**
+     * 发送底层受控请求；调用前固定最终 path、query、Content-Type 与 body 字节。 / Sends an exactly signed low-level request.
+     *
+     * 每次调用重新生成 timestamp 与 nonce，不对写请求自动重试。
+     *
+     * @param method - HTTP method。
+     * @param suffix - 已完成路径转义的相对路径；本方法不会二次编码。
+     * @param bodyJson - 最终 JSON 字符串，最大 2 MiB；省略时 Content-Type 为空。
+     * @param query - 最终查询参数；顺序和重复键均参与签名。
+     * @param accept - 精确的 Accept 值，例如 `application/json`、`text/event-stream` 或 `text/csv`。
+     * @returns 成功的原始 Fetch Response。
+     * @throws [ApiError] 当服务端返回非 2xx 状态。
+     */
+    /** @deprecated 使用 `lowLevel`，或使用对应的业务分组方法。 / Use `lowLevel` or a grouped facade operation. */
+    rawRequest(method_1, suffix_1, bodyJson_1, query_1) {
+        return __awaiter(this, arguments, void 0, function* (method, suffix, bodyJson, query, accept = 'application/json', requestId, signal) {
+            var _a;
+            const root = `${this.baseUrl.replace(/\/+$/, '')}/api/agents/channel/openapi/v1/${encodeURIComponent(this.channelId)}/chat`;
+            const url = `${root}${suffix}${query === undefined || query.toString() === '' ? '' : `?${query.toString()}`}`;
+            const response = yield this.signedFetch(url, {
+                method, signal,
+                headers: Object.assign(Object.assign({ Accept: accept }, (bodyJson === undefined ? {} : { 'Content-Type': 'application/json' })), (requestId === undefined ? {} : { 'X-Request-ID': requestId })),
+                body: bodyJson,
+            });
+            if (!response.ok)
+                throw new ApiError(method, suffix, response.status, yield response.text(), { requestId: (_a = response.headers.get('X-Request-ID')) !== null && _a !== void 0 ? _a : undefined });
+            return response;
+        });
+    }
+}
+/** @deprecated Use [AgentsUserClient]. */
+export { AgentsUserClient as LingyaAgentsUserClient };
+/** @deprecated Use [ApiError]. */
+export { ApiError as LingyaApiError };

package/dist/esm/client.d.ts

@@ -1,133 +1,35 @@
-import { Configuration } from './runtime';
+import { AgentsUserClient } from './client-core';
 import { type OpenApiCredentials } from './hmac';
-import { type AiChatBriefEvent } from './events';
-import { AgentsLowLevelApis, ChatApi as BoundChatApi, ConfigurationApi as BoundConfigurationApi, ConversationsApi as BoundConversationsApi, EventsApi as BoundEventsApi, FilesApi as BoundFilesApi, InteractionsApi as BoundInteractionsApi, KnowledgeApi as BoundKnowledgeApi, MessagesApi as BoundMessagesApi, SqlApi, WorkspaceApi as BoundWorkspaceApi } from './bound';
-/**
- * Lingya Agents SDK 入口，仅适用于可信服务端。 / Server-side Lingya Agents SDK entry point.
- *
- * 客户端保存 channel 范围的凭证，但只有 [forUser] 创建的用户客户端可以发起请求。
- */
+import { type TokenAuth, type ClientOptions } from './token';
+export * from './client-core';
+export * from './token';
+export type AgentsClientOptions = ClientOptions<TokenAuth | {
+    type: 'hmac';
+    accessKey: string;
+    secretKey: string;
+    externalUserId: string;
+}>;
+/** Channel client; options construction binds authentication and exposes API groups directly. */
 export declare class AgentsClient {
     private readonly baseUrl;
     readonly channelId: string;
-    private readonly credentials;
-    /**
-     * 创建 channel 范围的客户端。 / Creates a channel-scoped client.
-     *
-     * @param baseUrl - 服务根地址，不包含 `/api/.../chat`。 / Service root without the API path.
-     * @param channelId - OpenAPI channel ID，不得为空。 / Non-empty OpenAPI channel ID.
-     * @param credentials - 仅保存在当前服务端进程中的 HMAC 凭证。 / HMAC credentials kept in this server process.
-     */
+    private readonly credentials?;
+    private readonly bound?;
+    constructor(options: AgentsClientOptions);
     constructor(baseUrl: string, channelId: string, credentials: OpenApiCredentials);
-    /**
-     * 绑定外部用户身份；后续所有请求都以该身份独立签名。 / Binds one external user to all subsequent signed calls.
-     *
-     * @param externalUserId - 调用方系统的稳定用户 ID，UTF-8 编码后为 1..256 字节且不能含 NUL。
-     * @returns 注入用户身份并可调用全部契约 API 的客户端。
-     */
+    private bind;
     forUser(externalUserId: string): AgentsUserClient;
+    private get user();
+    get chat(): AgentsUserClient['chat'];
+    get configuration(): AgentsUserClient['configuration'];
+    get conversations(): AgentsUserClient['conversations'];
+    get events(): AgentsUserClient['events'];
+    get files(): AgentsUserClient['files'];
+    get interactions(): AgentsUserClient['interactions'];
+    get knowledge(): AgentsUserClient['knowledge'];
+    get messages(): AgentsUserClient['messages'];
+    get sql(): AgentsUserClient['sql'];
+    get workspace(): AgentsUserClient['workspace'];
+    get lowLevel(): AgentsUserClient['lowLevel'];
 }
-/** 已绑定外部用户的强类型 API 集合。 / Strongly typed API collection bound to one external user. */
-export declare class AgentsUserClient {
-    readonly channelId: string;
-    private readonly signedFetch;
-    private readonly baseUrl;
-    /** 发起新聊天和流探针。 / Starts chats and stream probes. */
-    readonly chat: BoundChatApi;
-    /** 读取 Agent 与会话配置。 / Reads Agent and conversation configuration. */
-    readonly configuration: BoundConfigurationApi;
-    /** 管理会话、状态、分享和异步任务。 / Manages conversations, status, shares, and async tasks. */
-    readonly conversations: BoundConversationsApi;
-    /** 查询已持久化事件。 / Reads persisted events. */
-    readonly events: BoundEventsApi;
-    /** 管理附件与预签名 URL。 / Manages attachments and pre-signed URLs. */
-    readonly files: BoundFilesApi;
-    /** 回答用户问题并处理计划审批。 / Handles user answers and plan approval. */
-    readonly interactions: BoundInteractionsApi;
-    /** 查询引用元数据。 / Reads citation metadata. */
-    readonly knowledge: BoundKnowledgeApi;
-    /** 查询消息并控制排队消息。 / Reads messages and controls queued messages. */
-    readonly messages: BoundMessagesApi;
-    /** 查询、导出 SQL 结果与图表数据。 / Reads and exports SQL results and chart data. */
-    readonly sql: SqlApi;
-    /** 查询工作区文件及预览。 / Reads workspace files and previews. */
-    readonly workspace: BoundWorkspaceApi;
-    /**
-     * 兼容旧版本的原始生成 API；正常业务调用应使用绑定门面。 / Raw generated APIs retained for migration only.
-     *
-     * @deprecated 将在 1.0 移除。 / Scheduled for removal in 1.0.
-     */
-    readonly lowLevel: AgentsLowLevelApis;
-    constructor(channelId: string, configuration: Configuration, signedFetch: typeof fetch, baseUrl: string);
-    /**
-     * 调用契约端点并按指定类型返回 JSON；优先使用上方生成的强类型 API。 / Calls a contract endpoint and decodes typed JSON.
-     *
-     * @param method - 大写 HTTP method。
-     * @param suffix - 相对于 channel chat 根路径的已编码路径。
-     * @param bodyJson - 最终发送并参与签名的 UTF-8 JSON 字符串；无请求体时省略。
-     * @param query - 已按最终顺序组装的查询参数，允许重复键。
-     * @returns 调用方指定的响应类型。
-     * @throws [ApiError] 当服务端返回非 2xx 状态。
-     */
-    /** @deprecated 使用对应的业务分组方法。 / Use the matching grouped facade operation. */
-    request<T>(method: string, suffix: string, bodyJson?: string, query?: URLSearchParams): Promise<T>;
-    /**
-     * 调用无响应正文的契约端点。 / Calls a contract endpoint that has no response body.
-     *
-     * @param method - 大写 HTTP method。
-     * @param suffix - 相对于 channel chat 根路径的已编码路径。
-     * @param bodyJson - 最终发送并参与签名的 UTF-8 JSON 字符串。
-     * @param query - 保留顺序的查询参数。
-     * @returns 2xx HTTP 状态码。
-     */
-    /** @deprecated 使用对应的业务分组方法。 / Use the matching grouped facade operation. */
-    requestStatus(method: string, suffix: string, bodyJson?: string, query?: URLSearchParams): Promise<number>;
-    /**
-     * 下载二进制响应，返回精确响应字节。 / Downloads an exact binary response.
-     *
-     * @param method - HTTP method，通常为 `GET`。
-     * @param suffix - 已编码的相对路径。
-     * @param query - 保留顺序的查询参数。
-     * @returns 未经文本转换的响应字节。
-     */
-    /** @deprecated 使用对应的业务分组方法。 / Use the matching grouped facade operation. */
-    requestBinary(method: string, suffix: string, query?: URLSearchParams): Promise<Uint8Array>;
-    /**
-     * 订阅对话 SSE，事件按契约判别联合返回。 / Streams SSE as the contract discriminated union.
-     *
-     * @param conversationId - 要订阅的会话 ID。
-     * @param messageId - 触发本次生成的消息 ID。
-     * @returns 支持取消的异步事件序列；未知 type 保留 `rawJson`。
-     */
-    /** @deprecated 使用 `chat.streamChatEvents(conversationId, { messageId })`。 / Use the channel-bound chat facade. */
-    streamChatEvents(conversationId: string, messageId: string): AsyncGenerator<AiChatBriefEvent>;
-    /**
-     * 发送底层受控请求；调用前固定最终 path、query、Content-Type 与 body 字节。 / Sends an exactly signed low-level request.
-     *
-     * 每次调用重新生成 timestamp 与 nonce，不对写请求自动重试。
-     *
-     * @param method - HTTP method。
-     * @param suffix - 已完成路径转义的相对路径；本方法不会二次编码。
-     * @param bodyJson - 最终 JSON 字符串，最大 2 MiB；省略时 Content-Type 为空。
-     * @param query - 最终查询参数；顺序和重复键均参与签名。
-     * @param accept - 精确的 Accept 值，例如 `application/json`、`text/event-stream` 或 `text/csv`。
-     * @returns 成功的原始 Fetch Response。
-     * @throws [ApiError] 当服务端返回非 2xx 状态。
-     */
-    /** @deprecated 使用 `lowLevel`，或使用对应的业务分组方法。 / Use `lowLevel` or a grouped facade operation. */
-    rawRequest(method: string, suffix: string, bodyJson?: string, query?: URLSearchParams, accept?: string, requestId?: string): Promise<Response>;
-}
-/** 不含凭证的 HTTP 错误。 / HTTP failure that never includes credentials. */
-export declare class ApiError extends Error {
-    readonly method: string;
-    readonly path: string;
-    readonly status: number;
-    readonly responseBody: string;
-    constructor(method: string, path: string, status: number, responseBody: string);
-}
-/** @deprecated Use [AgentsClient]. */
 export { AgentsClient as LingyaAgentsClient };
-/** @deprecated Use [AgentsUserClient]. */
-export { AgentsUserClient as LingyaAgentsUserClient };
-/** @deprecated Use [ApiError]. */
-export { ApiError as LingyaApiError };