@lingya-ai/agents-sdk 0.1.2 → 0.4.0

package/dist/esm/client.d.ts

@@ -1,13 +1,13 @@
 import { Configuration } from './runtime';
-import { ChatApi, ConfigurationApi, ConversationsApi, EventsApi, FilesApi, InteractionsApi, KnowledgeApi, MessagesApi, SQLApi, WorkspaceApi } from './apis';
 import { type OpenApiCredentials } from './hmac';
-import { type LingyaAiChatBriefEvent } from './events';
+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] 创建的用户客户端可以发起请求。
  */
-export declare class LingyaAgentsClient {
+export declare class AgentsClient {
     private readonly baseUrl;
     readonly channelId: string;
     private readonly credentials;
@@ -25,33 +25,39 @@ export declare class LingyaAgentsClient {
      * @param externalUserId - 调用方系统的稳定用户 ID，UTF-8 编码后为 1..256 字节且不能含 NUL。
      * @returns 注入用户身份并可调用全部契约 API 的客户端。
      */
-    forUser(externalUserId: string): LingyaAgentsUserClient;
+    forUser(externalUserId: string): AgentsUserClient;
 }
 /** 已绑定外部用户的强类型 API 集合。 / Strongly typed API collection bound to one external user. */
-export declare class LingyaAgentsUserClient {
+export declare class AgentsUserClient {
     readonly channelId: string;
     private readonly signedFetch;
     private readonly baseUrl;
     /** 发起新聊天和流探针。 / Starts chats and stream probes. */
-    readonly chat: ChatApi;
+    readonly chat: BoundChatApi;
     /** 读取 Agent 与会话配置。 / Reads Agent and conversation configuration. */
-    readonly configuration: ConfigurationApi;
+    readonly configuration: BoundConfigurationApi;
     /** 管理会话、状态、分享和异步任务。 / Manages conversations, status, shares, and async tasks. */
-    readonly conversations: ConversationsApi;
+    readonly conversations: BoundConversationsApi;
     /** 查询已持久化事件。 / Reads persisted events. */
-    readonly events: EventsApi;
+    readonly events: BoundEventsApi;
     /** 管理附件与预签名 URL。 / Manages attachments and pre-signed URLs. */
-    readonly files: FilesApi;
+    readonly files: BoundFilesApi;
     /** 回答用户问题并处理计划审批。 / Handles user answers and plan approval. */
-    readonly interactions: InteractionsApi;
+    readonly interactions: BoundInteractionsApi;
     /** 查询引用元数据。 / Reads citation metadata. */
-    readonly knowledge: KnowledgeApi;
+    readonly knowledge: BoundKnowledgeApi;
     /** 查询消息并控制排队消息。 / Reads messages and controls queued messages. */
-    readonly messages: MessagesApi;
+    readonly messages: BoundMessagesApi;
     /** 查询、导出 SQL 结果与图表数据。 / Reads and exports SQL results and chart data. */
-    readonly sql: SQLApi;
+    readonly sql: SqlApi;
     /** 查询工作区文件及预览。 / Reads workspace files and previews. */
-    readonly workspace: WorkspaceApi;
+    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.
@@ -61,8 +67,9 @@ export declare class LingyaAgentsUserClient {
      * @param bodyJson - 最终发送并参与签名的 UTF-8 JSON 字符串；无请求体时省略。
      * @param query - 已按最终顺序组装的查询参数，允许重复键。
      * @returns 调用方指定的响应类型。
-     * @throws [LingyaApiError] 当服务端返回非 2xx 状态。
+     * @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.
@@ -73,6 +80,7 @@ export declare class LingyaAgentsUserClient {
      * @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.
@@ -82,6 +90,7 @@ export declare class LingyaAgentsUserClient {
      * @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.
@@ -90,7 +99,8 @@ export declare class LingyaAgentsUserClient {
      * @param messageId - 触发本次生成的消息 ID。
      * @returns 支持取消的异步事件序列；未知 type 保留 `rawJson`。
      */
-    streamChatEvents(conversationId: string, messageId: string): AsyncGenerator<LingyaAiChatBriefEvent>;
+    /** @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.
      *
@@ -102,15 +112,22 @@ export declare class LingyaAgentsUserClient {
      * @param query - 最终查询参数；顺序和重复键均参与签名。
      * @param accept - 精确的 Accept 值，例如 `application/json`、`text/event-stream` 或 `text/csv`。
      * @returns 成功的原始 Fetch Response。
-     * @throws [LingyaApiError] 当服务端返回非 2xx 状态。
+     * @throws [ApiError] 当服务端返回非 2xx 状态。
      */
-    rawRequest(method: string, suffix: string, bodyJson?: string, query?: URLSearchParams, accept?: string): Promise<Response>;
+    /** @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 LingyaApiError extends Error {
+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 };

package/dist/esm/client.js

@@ -7,37 +7,16 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
-var __asyncValues = (this && this.__asyncValues) || function (o) {
-    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
-    var m = o[Symbol.asyncIterator], i;
-    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
-    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
-    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
-};
-var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
-    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
-    var g = generator.apply(thisArg, _arguments || []), i, q = [];
-    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
-    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
-    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
-    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
-    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
-    function fulfill(value) { resume("next", value); }
-    function reject(value) { resume("throw", value); }
-    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
-};
 import { Configuration } from './runtime';
 import { ChatApi, ConfigurationApi, ConversationsApi, EventsApi, FilesApi, InteractionsApi, KnowledgeApi, MessagesApi, SQLApi, WorkspaceApi } from './apis';
 import { createSignedFetch } from './hmac';
-import { decodeSse } from './sse';
-import { decodeAiChatBriefEvent } 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] 创建的用户客户端可以发起请求。
  */
-export class LingyaAgentsClient {
+export class AgentsClient {
     /**
      * 创建 channel 范围的客户端。 / Creates a channel-scoped client.
      *
@@ -61,25 +40,37 @@ export class LingyaAgentsClient {
     forUser(externalUserId) {
         const signedFetch = createSignedFetch(this.credentials, externalUserId);
         const configuration = new Configuration({ basePath: this.baseUrl.replace(/\/+$/, ''), fetchApi: signedFetch });
-        return new LingyaAgentsUserClient(this.channelId, configuration, signedFetch, this.baseUrl);
+        return new AgentsUserClient(this.channelId, configuration, signedFetch, this.baseUrl);
     }
 }
 /** 已绑定外部用户的强类型 API 集合。 / Strongly typed API collection bound to one external user. */
-export class LingyaAgentsUserClient {
+export class AgentsUserClient {
     constructor(channelId, configuration, signedFetch, baseUrl) {
         this.channelId = channelId;
         this.signedFetch = signedFetch;
         this.baseUrl = baseUrl;
-        this.chat = new ChatApi(configuration);
-        this.configuration = new ConfigurationApi(configuration);
-        this.conversations = new ConversationsApi(configuration);
-        this.events = new EventsApi(configuration);
-        this.files = new FilesApi(configuration);
-        this.interactions = new InteractionsApi(configuration);
-        this.knowledge = new KnowledgeApi(configuration);
-        this.messages = new MessagesApi(configuration);
-        this.sql = new SQLApi(configuration);
-        this.workspace = new WorkspaceApi(configuration);
+        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);
+        this.configuration = new BoundConfigurationApi(channelId, configurationApi);
+        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.
@@ -89,8 +80,9 @@ export class LingyaAgentsUserClient {
      * @param bodyJson - 最终发送并参与签名的 UTF-8 JSON 字符串；无请求体时省略。
      * @param query - 已按最终顺序组装的查询参数，允许重复键。
      * @returns 调用方指定的响应类型。
-     * @throws [LingyaApiError] 当服务端返回非 2xx 状态。
+     * @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');
@@ -106,6 +98,7 @@ export class LingyaAgentsUserClient {
      * @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;
@@ -119,6 +112,7 @@ export class LingyaAgentsUserClient {
      * @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');
@@ -132,27 +126,9 @@ export class LingyaAgentsUserClient {
      * @param messageId - 触发本次生成的消息 ID。
      * @returns 支持取消的异步事件序列；未知 type 保留 `rawJson`。
      */
+    /** @deprecated 使用 `chat.streamChatEvents(conversationId, { messageId })`。 / Use the channel-bound chat facade. */
     streamChatEvents(conversationId, messageId) {
-        return __asyncGenerator(this, arguments, function* streamChatEvents_1() {
-            var _a, e_1, _b, _c;
-            const suffix = `/conversations/${encodeURIComponent(conversationId)}/stream`;
-            const response = yield __await(this.rawRequest('POST', suffix, JSON.stringify({ messageId }), undefined, 'text/event-stream'));
-            try {
-                for (var _d = true, _e = __asyncValues(decodeSse(response)), _f; _f = yield __await(_e.next()), _a = _f.done, !_a; _d = true) {
-                    _c = _f.value;
-                    _d = false;
-                    const data = _c;
-                    yield yield __await(decodeAiChatBriefEvent(data));
-                }
-            }
-            catch (e_1_1) { e_1 = { error: e_1_1 }; }
-            finally {
-                try {
-                    if (!_d && !_a && (_b = _e.return)) yield __await(_b.call(_e));
-                }
-                finally { if (e_1) throw e_1.error; }
-            }
-        });
+        return this.chat.streamChatEvents(conversationId, { messageId });
     }
     /**
      * 发送底层受控请求；调用前固定最终 path、query、Content-Type 与 body 字节。 / Sends an exactly signed low-level request.
@@ -165,31 +141,38 @@ export class LingyaAgentsUserClient {
      * @param query - 最终查询参数；顺序和重复键均参与签名。
      * @param accept - 精确的 Accept 值，例如 `application/json`、`text/event-stream` 或 `text/csv`。
      * @returns 成功的原始 Fetch Response。
-     * @throws [LingyaApiError] 当服务端返回非 2xx 状态。
+     * @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') {
+        return __awaiter(this, arguments, void 0, function* (method, suffix, bodyJson, query, accept = 'application/json', requestId) {
             const root = `${this.baseUrl.replace(/\/+$/, '')}/api/agents/channel/openapi/v1/${encodeURIComponent(this.channelId)}/chat`;
             const url = `${root}${suffix}${query === undefined || query.size === 0 ? '' : `?${query.toString()}`}`;
             const response = yield this.signedFetch(url, {
                 method,
-                headers: Object.assign({ Accept: accept }, (bodyJson === undefined ? {} : { 'Content-Type': 'application/json' })),
+                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 LingyaApiError(method, suffix, response.status, yield response.text());
+                throw new ApiError(method, suffix, response.status, yield response.text());
             return response;
         });
     }
 }
 /** 不含凭证的 HTTP 错误。 / HTTP failure that never includes credentials. */
-export class LingyaApiError extends Error {
+export class ApiError extends Error {
     constructor(method, path, status, responseBody) {
         super(`${method} ${path} returned HTTP ${status}`);
         this.method = method;
         this.path = path;
         this.status = status;
         this.responseBody = responseBody;
-        this.name = 'LingyaApiError';
+        this.name = 'ApiError';
     }
 }
+/** @deprecated Use [AgentsClient]. */
+export { AgentsClient as LingyaAgentsClient };
+/** @deprecated Use [AgentsUserClient]. */
+export { AgentsUserClient as LingyaAgentsUserClient };
+/** @deprecated Use [ApiError]. */
+export { ApiError as LingyaApiError };

package/dist/esm/events.d.ts

@@ -1,8 +1,8 @@
-import type { AiChatBriefEvent, ToolExtension, UnknownAiChatBriefEvent, UnknownToolExtension } from './models';
+import type { AiChatBriefEvent as GeneratedAiChatBriefEvent, ToolExtension as GeneratedToolExtension, UnknownAiChatBriefEvent, UnknownToolExtension } from './models';
 /** 包含全部已知事件以及携带原始 JSON 的未知事件。 / All known events plus a raw-JSON fallback for future event types. */
-export type LingyaAiChatBriefEvent = AiChatBriefEvent | UnknownAiChatBriefEvent;
+export type AiChatBriefEvent = GeneratedAiChatBriefEvent | UnknownAiChatBriefEvent;
 /** 包含全部已知工具扩展以及携带原始 JSON 的未知扩展。 / All known tool extensions plus a raw-JSON fallback. */
-export type LingyaToolExtension = ToolExtension | UnknownToolExtension;
+export type ToolExtension = GeneratedToolExtension | UnknownToolExtension;
 /**
  * 按 type 判别事件；未知值只暴露 type 与 rawJson。 / Decodes by type with an exact JSON fallback.
  *
@@ -10,7 +10,7 @@ export type LingyaToolExtension = ToolExtension | UnknownToolExtension;
  * @returns 已知事件联合，或保存输入原文的未知事件。
  * @throws SyntaxError 当输入不是有效 JSON。
  */
-export declare function decodeAiChatBriefEvent(rawJson: string): LingyaAiChatBriefEvent;
+export declare function decodeAiChatBriefEvent(rawJson: string): AiChatBriefEvent;
 /**
  * 按 category 判别工具扩展。 / Decodes a tool extension by category.
  *
@@ -18,4 +18,8 @@ export declare function decodeAiChatBriefEvent(rawJson: string): LingyaAiChatBri
  * @returns 12 种已知扩展之一，或保存输入原文的未知扩展。
  * @throws SyntaxError 当输入不是有效 JSON。
  */
-export declare function decodeToolExtension(rawJson: string): LingyaToolExtension;
+export declare function decodeToolExtension(rawJson: string): ToolExtension;
+/** @deprecated Use [AiChatBriefEvent]. */
+export type LingyaAiChatBriefEvent = AiChatBriefEvent;
+/** @deprecated Use [ToolExtension]. */
+export type LingyaToolExtension = ToolExtension;

package/dist/esm/index.d.ts

@@ -1,7 +1,7 @@
 export * from './runtime';
-export * from './apis/index';
 export * from './models/index';
 export * from './client';
+export * from './bound';
 export * from './hmac';
 export * from './sse';
-export * from './events';
+export { decodeAiChatBriefEvent, decodeToolExtension, type AiChatBriefEvent, type ToolExtension, type LingyaAiChatBriefEvent, type LingyaToolExtension, } from './events';

package/dist/esm/index.js

@@ -1,9 +1,9 @@
 /* tslint:disable */
 /* eslint-disable */
 export * from './runtime';
-export * from './apis/index';
 export * from './models/index';
 export * from './client';
+export * from './bound';
 export * from './hmac';
 export * from './sse';
-export * from './events';
+export { decodeAiChatBriefEvent, decodeToolExtension, } from './events';

package/dist/events.d.ts

@@ -1,8 +1,8 @@
-import type { AiChatBriefEvent, ToolExtension, UnknownAiChatBriefEvent, UnknownToolExtension } from './models';
+import type { AiChatBriefEvent as GeneratedAiChatBriefEvent, ToolExtension as GeneratedToolExtension, UnknownAiChatBriefEvent, UnknownToolExtension } from './models';
 /** 包含全部已知事件以及携带原始 JSON 的未知事件。 / All known events plus a raw-JSON fallback for future event types. */
-export type LingyaAiChatBriefEvent = AiChatBriefEvent | UnknownAiChatBriefEvent;
+export type AiChatBriefEvent = GeneratedAiChatBriefEvent | UnknownAiChatBriefEvent;
 /** 包含全部已知工具扩展以及携带原始 JSON 的未知扩展。 / All known tool extensions plus a raw-JSON fallback. */
-export type LingyaToolExtension = ToolExtension | UnknownToolExtension;
+export type ToolExtension = GeneratedToolExtension | UnknownToolExtension;
 /**
  * 按 type 判别事件；未知值只暴露 type 与 rawJson。 / Decodes by type with an exact JSON fallback.
  *
@@ -10,7 +10,7 @@ export type LingyaToolExtension = ToolExtension | UnknownToolExtension;
  * @returns 已知事件联合，或保存输入原文的未知事件。
  * @throws SyntaxError 当输入不是有效 JSON。
  */
-export declare function decodeAiChatBriefEvent(rawJson: string): LingyaAiChatBriefEvent;
+export declare function decodeAiChatBriefEvent(rawJson: string): AiChatBriefEvent;
 /**
  * 按 category 判别工具扩展。 / Decodes a tool extension by category.
  *
@@ -18,4 +18,8 @@ export declare function decodeAiChatBriefEvent(rawJson: string): LingyaAiChatBri
  * @returns 12 种已知扩展之一，或保存输入原文的未知扩展。
  * @throws SyntaxError 当输入不是有效 JSON。
  */
-export declare function decodeToolExtension(rawJson: string): LingyaToolExtension;
+export declare function decodeToolExtension(rawJson: string): ToolExtension;
+/** @deprecated Use [AiChatBriefEvent]. */
+export type LingyaAiChatBriefEvent = AiChatBriefEvent;
+/** @deprecated Use [ToolExtension]. */
+export type LingyaToolExtension = ToolExtension;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export * from './runtime';
-export * from './apis/index';
 export * from './models/index';
 export * from './client';
+export * from './bound';
 export * from './hmac';
 export * from './sse';
-export * from './events';
+export { decodeAiChatBriefEvent, decodeToolExtension, type AiChatBriefEvent, type ToolExtension, type LingyaAiChatBriefEvent, type LingyaToolExtension, } from './events';

package/dist/index.js

@@ -14,12 +14,15 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeToolExtension = exports.decodeAiChatBriefEvent = void 0;
 /* tslint:disable */
 /* eslint-disable */
 __exportStar(require("./runtime"), exports);
-__exportStar(require("./apis/index"), exports);
 __exportStar(require("./models/index"), exports);
 __exportStar(require("./client"), exports);
+__exportStar(require("./bound"), exports);
 __exportStar(require("./hmac"), exports);
 __exportStar(require("./sse"), exports);
-__exportStar(require("./events"), exports);
+var events_1 = require("./events");
+Object.defineProperty(exports, "decodeAiChatBriefEvent", { enumerable: true, get: function () { return events_1.decodeAiChatBriefEvent; } });
+Object.defineProperty(exports, "decodeToolExtension", { enumerable: true, get: function () { return events_1.decodeToolExtension; } });

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@lingya-ai/agents-sdk",
-  "version": "0.1.2",
+  "version": "0.4.0",
   "description": "Strongly typed server-side TypeScript SDK for Lingya Agents OpenAPI",
   "author": "Lingya AI",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/lingya-ai/lingya-agents-sdk-typescript.git"
+    "url": "git+https://github.com/lingya-ai/lingya-agents-sdk-typescript.git"
   },
   "homepage": "https://github.com/lingya-ai/lingya-agents-sdk-typescript#readme",
   "bugs": {
@@ -40,8 +40,10 @@
     "registry": "https://registry.npmjs.org"
   },
   "scripts": {
-    "build": "tsc && tsc -p tsconfig.esm.json",
-    "check": "npm run build && npm run test && npm run audit:models && npm run package:smoke",
+    "generate:bound": "node scripts/generate-bound-api.mjs",
+    "build": "npm run generate:bound && tsc && tsc -p tsconfig.esm.json",
+    "check": "npm run build && npm run typecheck && npm run test && npm run audit:models && npm run package:smoke",
+    "typecheck": "tsc -p tsconfig.types.json",
     "test": "tsx --test test/*.test.ts",
     "test:live": "tsx --test test/live.test.ts",
     "audit:models": "node scripts/audit-models.mjs",