@lingya-ai/agents-sdk 0.5.0 → 0.7.1

package/dist/esm/token.d.ts

@@ -0,0 +1,20 @@
+import type { WebSocketFactory } from './subscription';
+/** A fresh token must be issued for every invocation, including concurrent calls. */
+export type TokenProvider = (context: {
+    channelId: string;
+    signal?: AbortSignal;
+    fetch: typeof fetch;
+}) => string | Promise<string>;
+export interface TokenAuth {
+    type: 'token';
+    tokenProvider: TokenProvider;
+}
+export interface ClientOptions<Auth> {
+    baseUrl: string;
+    channelId: string;
+    auth: Auth;
+    fetch?: typeof fetch;
+    webSocketFactory?: WebSocketFactory;
+}
+/** Browser-safe transport: no cache, HMAC headers, redirects, or automatic retries. */
+export declare function createTokenFetch(provider: TokenProvider, channelId: string, network?: typeof fetch): typeof fetch;

package/dist/esm/token.js

@@ -0,0 +1,38 @@
+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, abortable, checkSignal, fetchResponse } from './lifecycle';
+/** Browser-safe transport: no cache, HMAC headers, redirects, or automatic retries. */
+export function createTokenFetch(provider, channelId, network = globalThis.fetch) {
+    if (typeof provider !== 'function')
+        throw new Error('tokenProvider must be a function');
+    return (input, init) => __awaiter(this, void 0, void 0, function* () {
+        const request = new Request(input, init);
+        checkSignal(request.signal);
+        if (new URL(request.url).pathname.endsWith('/presign'))
+            throw new ApiError('POST', '/presign', undefined, '{"message":"presign requires HMAC authentication"}', { kind: 'authentication' });
+        if (Array.from(request.headers.keys()).some(name => name.toLowerCase().startsWith('x-openapi-'))) {
+            throw new Error('Authentication headers are managed by the SDK');
+        }
+        let token;
+        try {
+            token = yield abortable(Promise.resolve().then(() => provider({ channelId, signal: request.signal, fetch: network })), request.signal);
+        }
+        catch (_a) {
+            checkSignal(request.signal);
+            throw Object.assign(new ApiError('', '', undefined, '', { kind: 'authentication' }), { message: 'OpenAPI token provider failed' });
+        }
+        checkSignal(request.signal);
+        if (typeof token !== 'string' || !/^[\x21-\x7e]+$/.test(token))
+            throw Object.assign(new ApiError('', '', undefined, '', { kind: 'authentication' }), { message: 'Invalid OpenAPI token' });
+        const headers = new Headers(request.headers);
+        headers.set('X-OpenAPI-Token', token);
+        return fetchResponse(network, new Request(request, { headers, redirect: 'error' }));
+    });
+}

package/dist/events.js

@@ -4,7 +4,7 @@ exports.decodeAiChatBriefEvent = decodeAiChatBriefEvent;
 exports.decodeToolExtension = decodeToolExtension;
 const knownEventTypes = new Set([
     'user-query', 'compressor-context-start', 'compressor-context-end', 'compactor-warning', 'manual-interrupt',
-    'error', 'start', 'think', 'chat-client-request', 'chat-client-response', 'message', 'tool-execution',
+    'error', 'start', 'think', 'message', 'tool-execution',
     'tool-execution-sub-agent-call', 'tool-execution-awaiting-user-input', 'end',
 ]);
 const knownToolCategories = new Set([

package/dist/hmac.d.ts

@@ -14,7 +14,7 @@ export interface OpenApiCredentials {
  * @param externalUserId - UTF-8 编码后为 1..256 字节且不含 NUL 的外部用户 ID。
  * @returns 与原生 fetch 兼容的签名 transport。
  */
-export declare function createSignedFetch(credentials: OpenApiCredentials, externalUserId: string): typeof fetch;
+export declare function createSignedFetch(credentials: OpenApiCredentials, externalUserId: string, network?: typeof fetch): typeof fetch;
 /**
  * 对固定 canonical string 计算 HMAC。 / Computes HMAC for a fixed canonical string.
  *

package/dist/hmac.js

@@ -11,6 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSignedFetch = createSignedFetch;
 exports.signCanonical = signCanonical;
+const lifecycle_1 = require("./lifecycle");
 const node_crypto_1 = require("node:crypto");
 /**
  * 构造已签名 fetch；每次调用都会重新生成 timestamp、nonce 和签名。 / Creates a fetch that signs every attempt independently.
@@ -21,7 +22,7 @@ const node_crypto_1 = require("node:crypto");
  * @param externalUserId - UTF-8 编码后为 1..256 字节且不含 NUL 的外部用户 ID。
  * @returns 与原生 fetch 兼容的签名 transport。
  */
-function createSignedFetch(credentials, externalUserId) {
+function createSignedFetch(credentials, externalUserId, network = globalThis.fetch) {
     const userBytes = Buffer.from(externalUserId, 'utf8');
     if (userBytes.length < 1 || userBytes.length > 256 || userBytes.includes(0)) {
         throw new Error('externalUserId must contain 1 to 256 UTF-8 bytes and no NUL');
@@ -52,7 +53,7 @@ function createSignedFetch(credentials, externalUserId) {
         headers.set('X-OpenAPI-Nonce', nonce);
         headers.set('X-OpenAPI-User', encodedUser);
         headers.set('X-OpenAPI-Signature', (0, node_crypto_1.createHmac)('sha256', credentials.secretKey).update(canonical).digest('hex'));
-        return fetch(new Request(request, { headers }));
+        return (0, lifecycle_1.fetchResponse)(network, new Request(request, { headers, redirect: 'error' }));
     });
 }
 /**

package/dist/lifecycle.d.ts

@@ -0,0 +1,55 @@
+export type ErrorKind = 'http' | 'network' | 'authentication' | 'protocol' | 'cancelled' | 'timeout' | 'unexpected_eof';
+export interface RequestOptions {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}
+export interface ErrorDetails {
+    kind?: ErrorKind;
+    code?: string;
+    fields?: Array<{
+        field: string;
+        message: string;
+    }>;
+    requestId?: string;
+    cause?: unknown;
+}
+export declare class ApiError extends Error {
+    readonly method: string;
+    readonly path: string;
+    readonly status: number | undefined;
+    readonly responseBody: string;
+    readonly kind: ErrorKind;
+    readonly code?: string;
+    readonly fields?: Array<{
+        field: string;
+        message: string;
+    }>;
+    readonly requestId?: string;
+    readonly cause?: unknown;
+    constructor(method: string, path: string, status: number | undefined, responseBody?: string, details?: ErrorDetails);
+}
+export declare function abortError(signal: AbortSignal): ApiError;
+export declare function checkSignal(signal?: AbortSignal): void;
+export declare function abortable<T>(promise: PromiseLike<T>, signal?: AbortSignal): Promise<T>;
+export declare class RequestScope {
+    private readonly options;
+    readonly controller: AbortController;
+    readonly signal: AbortSignal;
+    private timer?;
+    private readonly abort;
+    constructor(options?: RequestOptions);
+    dispose(): void;
+}
+export declare function normalizeError(error: unknown, signal?: AbortSignal): Promise<ApiError>;
+export declare function execute<T>(options: RequestOptions, operation: (signal: AbortSignal) => Promise<T>): Promise<T>;
+export interface DownloadResponse {
+    bytes: Uint8Array;
+    filename?: string;
+    contentType?: string;
+    headers: Headers;
+    status: number;
+    requestId?: string;
+}
+export declare function downloadResponse(response: Response): Promise<DownloadResponse>;
+/** Enforce cancellation even when an injected Fetch ignores its signal. */
+export declare function fetchResponse(network: typeof fetch, request: Request): Promise<Response>;

package/dist/lifecycle.js

@@ -0,0 +1,175 @@
+"use strict";
+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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestScope = exports.ApiError = void 0;
+exports.abortError = abortError;
+exports.checkSignal = checkSignal;
+exports.abortable = abortable;
+exports.normalizeError = normalizeError;
+exports.execute = execute;
+exports.downloadResponse = downloadResponse;
+exports.fetchResponse = fetchResponse;
+class ApiError extends Error {
+    constructor(method, path, status, responseBody = '', details = {}) {
+        var _a, _b, _c, _d;
+        let parsed = {};
+        try {
+            parsed = JSON.parse(responseBody);
+        }
+        catch ( /* Preserve non-JSON bodies. */_e) { /* Preserve non-JSON bodies. */ }
+        super(typeof (parsed === null || parsed === void 0 ? void 0 : parsed.message) === 'string' ? parsed.message : `${method} ${path} ${status === undefined ? (_a = details.kind) !== null && _a !== void 0 ? _a : 'failed' : `returned HTTP ${status}`}`);
+        this.method = method;
+        this.path = path;
+        this.status = status;
+        this.responseBody = responseBody;
+        this.name = 'ApiError';
+        this.kind = (_b = details.kind) !== null && _b !== void 0 ? _b : (status === undefined ? 'network' : 'http');
+        this.code = (_c = details.code) !== null && _c !== void 0 ? _c : (typeof (parsed === null || parsed === void 0 ? void 0 : parsed.code) === 'string' ? parsed.code : undefined);
+        this.fields = (_d = details.fields) !== null && _d !== void 0 ? _d : (Array.isArray(parsed === null || parsed === void 0 ? void 0 : parsed.fields) ? parsed.fields.filter((v) => typeof (v === null || v === void 0 ? void 0 : v.field) === 'string' && typeof (v === null || v === void 0 ? void 0 : v.message) === 'string') : undefined);
+        this.requestId = details.requestId;
+        this.cause = details.cause;
+    }
+}
+exports.ApiError = ApiError;
+function abortError(signal) {
+    return signal.reason instanceof ApiError ? signal.reason : new ApiError('', '', undefined, '', { kind: 'cancelled' });
+}
+function checkSignal(signal) { if (signal === null || signal === void 0 ? void 0 : signal.aborted)
+    throw abortError(signal); }
+function abortable(promise, signal) {
+    checkSignal(signal);
+    if (!signal)
+        return Promise.resolve(promise);
+    return new Promise((resolve, reject) => {
+        const aborted = () => { signal.removeEventListener('abort', aborted); reject(abortError(signal)); };
+        signal.addEventListener('abort', aborted, { once: true });
+        Promise.resolve(promise).then(value => { signal.removeEventListener('abort', aborted); resolve(value); }, error => { signal.removeEventListener('abort', aborted); reject(error); });
+    });
+}
+class RequestScope {
+    constructor(options = {}) {
+        var _a, _b;
+        this.options = options;
+        this.controller = new AbortController();
+        this.signal = this.controller.signal;
+        if (options.timeoutMs !== undefined && (!Number.isFinite(options.timeoutMs) || options.timeoutMs <= 0))
+            throw new RangeError('timeoutMs must be positive');
+        this.abort = () => { var _a; return this.controller.abort(((_a = options.signal) === null || _a === void 0 ? void 0 : _a.reason) instanceof ApiError ? options.signal.reason : new ApiError('', '', undefined, '', { kind: 'cancelled' })); };
+        (_a = options.signal) === null || _a === void 0 ? void 0 : _a.addEventListener('abort', this.abort, { once: true });
+        if ((_b = options.signal) === null || _b === void 0 ? void 0 : _b.aborted)
+            this.abort();
+        if (options.timeoutMs !== undefined)
+            this.timer = setTimeout(() => this.controller.abort(new ApiError('', '', undefined, '', { kind: 'timeout' })), options.timeoutMs);
+    }
+    dispose() { var _a; clearTimeout(this.timer); (_a = this.options.signal) === null || _a === void 0 ? void 0 : _a.removeEventListener('abort', this.abort); }
+}
+exports.RequestScope = RequestScope;
+function normalizeError(error, signal) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        if (signal === null || signal === void 0 ? void 0 : signal.aborted)
+            return abortError(signal);
+        if (error instanceof ApiError)
+            return error;
+        const response = error === null || error === void 0 ? void 0 : error.response;
+        if (response)
+            return new ApiError('', '', response.status, (yield response.text()).slice(0, 65536), { requestId: (_a = response.headers.get('X-Request-ID')) !== null && _a !== void 0 ? _a : undefined });
+        return new ApiError('', '', undefined, '', { kind: error instanceof SyntaxError ? 'protocol' : 'network', cause: error });
+    });
+}
+function execute(options, operation) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const scope = new RequestScope(options);
+        try {
+            checkSignal(scope.signal);
+            return yield abortable(operation(scope.signal), scope.signal);
+        }
+        catch (error) {
+            throw yield normalizeError(error, scope.signal);
+        }
+        finally {
+            scope.dispose();
+        }
+    });
+}
+function downloadResponse(response) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const disposition = (_a = response.headers.get('Content-Disposition')) !== null && _a !== void 0 ? _a : '';
+        let filename = (_c = (_b = /filename="([^"]*)"/i.exec(disposition)) === null || _b === void 0 ? void 0 : _b[1]) !== null && _c !== void 0 ? _c : (_d = /filename=([^;\s]+)/i.exec(disposition)) === null || _d === void 0 ? void 0 : _d[1];
+        const encoded = (_e = /filename\*=UTF-8''([^;]+)/i.exec(disposition)) === null || _e === void 0 ? void 0 : _e[1];
+        if (encoded) {
+            try {
+                filename = decodeURIComponent(encoded);
+            }
+            catch ( /* Use fallback. */_h) { /* Use fallback. */ }
+        }
+        return { bytes: new Uint8Array(yield response.arrayBuffer()), filename, contentType: (_f = response.headers.get('Content-Type')) !== null && _f !== void 0 ? _f : undefined,
+            headers: response.headers, status: response.status, requestId: (_g = response.headers.get('X-Request-ID')) !== null && _g !== void 0 ? _g : undefined };
+    });
+}
+/** Enforce cancellation even when an injected Fetch ignores its signal. */
+function fetchResponse(network, request) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        checkSignal(request.signal);
+        const response = yield network(request);
+        if (request.signal.aborted) {
+            yield ((_a = response.body) === null || _a === void 0 ? void 0 : _a.cancel().catch(() => undefined));
+            throw abortError(request.signal);
+        }
+        if (!response.body)
+            return response;
+        const reader = response.body.getReader();
+        let controller;
+        let finished = false;
+        const cleanup = () => { finished = true; request.signal.removeEventListener('abort', abort); };
+        const abort = () => {
+            if (finished)
+                return;
+            cleanup();
+            void reader.cancel().catch(() => undefined);
+            controller.error(abortError(request.signal));
+        };
+        const body = new ReadableStream({
+            start(value) { controller = value; request.signal.addEventListener('abort', abort, { once: true }); if (request.signal.aborted)
+                abort(); },
+            pull(value) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    try {
+                        const chunk = yield reader.read();
+                        if (finished)
+                            return;
+                        if (chunk.done) {
+                            cleanup();
+                            value.close();
+                            reader.releaseLock();
+                        }
+                        else
+                            value.enqueue(chunk.value);
+                    }
+                    catch (error) {
+                        if (!finished) {
+                            cleanup();
+                            value.error(error);
+                        }
+                    }
+                });
+            },
+            cancel(reason) {
+                return __awaiter(this, void 0, void 0, function* () { cleanup(); yield reader.cancel(reason); reader.releaseLock(); });
+            },
+        });
+        const wrapped = new Response(body, { status: response.status, statusText: response.statusText, headers: response.headers });
+        Object.defineProperties(wrapped, { url: { value: response.url }, redirected: { value: response.redirected }, type: { value: response.type } });
+        return wrapped;
+    });
+}

package/dist/models/AgentAsyncTaskSync.d.ts

@@ -1,8 +1,8 @@
 /**
  * Lingya Agents OpenAPI
- * 本契约描述灵涯 Agents 面向可信服务端的公开渠道 API，使用 OPENAPI-HMAC-SHA256-V1 验证请求，不包含 Studio 管理接口。在线文档只展示请求，不会在浏览器中收集或保存 secret。  This contract describes the public Lingya Agents channel API for trusted servers. Requests use OPENAPI-HMAC-SHA256-V1, and Studio administration endpoints are excluded. The online reference only displays requests and never collects or stores a secret in the browser.  ## 快速开始 / Quick start  1. 读取 Configuration，确认模型和附件限制。 / Read Configuration to discover model and attachment limits.  2. 在本地固定最终 method、raw path、raw query、Content-Type 和 body 字节，再生成签名。 / Finalize method, raw path, raw query, Content-Type, and body bytes locally before signing.  3. 按业务分组调用接口；SSE 断开后使用 Events 补取。 / Call the appropriate business group and use Events for recovery after an SSE disconnect.  ## 公共错误 / Common errors  `401` 签名、时间戳或 nonce 无效；`403` 资源不属于当前渠道用户；`413` 请求体过大；`422` 参数校验失败；`429` 请求过于频繁；`500` 服务内部错误；`503` 依赖或执行服务暂不可用。  `401` invalid signature, timestamp, or nonce; `403` resource not owned by the current channel user; `413` request body too large; `422` validation failed; `429` rate limited; `500` internal error; `503` dependency or execution service unavailable.
+ * Public Lingya Agents channel API. HMAC credentials belong on trusted servers; client tokens are single-use.
  *
- * The version of the OpenAPI document: 0.1.5
+ * The version of the OpenAPI document: 0.1.7
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/models/AgentAsyncTaskSync.js

@@ -3,9 +3,9 @@
 /* eslint-disable */
 /**
  * Lingya Agents OpenAPI
- * 本契约描述灵涯 Agents 面向可信服务端的公开渠道 API，使用 OPENAPI-HMAC-SHA256-V1 验证请求，不包含 Studio 管理接口。在线文档只展示请求，不会在浏览器中收集或保存 secret。  This contract describes the public Lingya Agents channel API for trusted servers. Requests use OPENAPI-HMAC-SHA256-V1, and Studio administration endpoints are excluded. The online reference only displays requests and never collects or stores a secret in the browser.  ## 快速开始 / Quick start  1. 读取 Configuration，确认模型和附件限制。 / Read Configuration to discover model and attachment limits.  2. 在本地固定最终 method、raw path、raw query、Content-Type 和 body 字节，再生成签名。 / Finalize method, raw path, raw query, Content-Type, and body bytes locally before signing.  3. 按业务分组调用接口；SSE 断开后使用 Events 补取。 / Call the appropriate business group and use Events for recovery after an SSE disconnect.  ## 公共错误 / Common errors  `401` 签名、时间戳或 nonce 无效；`403` 资源不属于当前渠道用户；`413` 请求体过大；`422` 参数校验失败；`429` 请求过于频繁；`500` 服务内部错误；`503` 依赖或执行服务暂不可用。  `401` invalid signature, timestamp, or nonce; `403` resource not owned by the current channel user; `413` request body too large; `422` validation failed; `429` rate limited; `500` internal error; `503` dependency or execution service unavailable.
+ * Public Lingya Agents channel API. HMAC credentials belong on trusted servers; client tokens are single-use.
  *
- * The version of the OpenAPI document: 0.1.5
+ * The version of the OpenAPI document: 0.1.7
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/models/AgentFile.d.ts

@@ -1,8 +1,8 @@
 /**
  * Lingya Agents OpenAPI
- * 本契约描述灵涯 Agents 面向可信服务端的公开渠道 API，使用 OPENAPI-HMAC-SHA256-V1 验证请求，不包含 Studio 管理接口。在线文档只展示请求，不会在浏览器中收集或保存 secret。  This contract describes the public Lingya Agents channel API for trusted servers. Requests use OPENAPI-HMAC-SHA256-V1, and Studio administration endpoints are excluded. The online reference only displays requests and never collects or stores a secret in the browser.  ## 快速开始 / Quick start  1. 读取 Configuration，确认模型和附件限制。 / Read Configuration to discover model and attachment limits.  2. 在本地固定最终 method、raw path、raw query、Content-Type 和 body 字节，再生成签名。 / Finalize method, raw path, raw query, Content-Type, and body bytes locally before signing.  3. 按业务分组调用接口；SSE 断开后使用 Events 补取。 / Call the appropriate business group and use Events for recovery after an SSE disconnect.  ## 公共错误 / Common errors  `401` 签名、时间戳或 nonce 无效；`403` 资源不属于当前渠道用户；`413` 请求体过大；`422` 参数校验失败；`429` 请求过于频繁；`500` 服务内部错误；`503` 依赖或执行服务暂不可用。  `401` invalid signature, timestamp, or nonce; `403` resource not owned by the current channel user; `413` request body too large; `422` validation failed; `429` rate limited; `500` internal error; `503` dependency or execution service unavailable.
+ * Public Lingya Agents channel API. HMAC credentials belong on trusted servers; client tokens are single-use.
  *
- * The version of the OpenAPI document: 0.1.5
+ * The version of the OpenAPI document: 0.1.7
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/models/AgentFile.js

@@ -3,9 +3,9 @@
 /* eslint-disable */
 /**
  * Lingya Agents OpenAPI
- * 本契约描述灵涯 Agents 面向可信服务端的公开渠道 API，使用 OPENAPI-HMAC-SHA256-V1 验证请求，不包含 Studio 管理接口。在线文档只展示请求，不会在浏览器中收集或保存 secret。  This contract describes the public Lingya Agents channel API for trusted servers. Requests use OPENAPI-HMAC-SHA256-V1, and Studio administration endpoints are excluded. The online reference only displays requests and never collects or stores a secret in the browser.  ## 快速开始 / Quick start  1. 读取 Configuration，确认模型和附件限制。 / Read Configuration to discover model and attachment limits.  2. 在本地固定最终 method、raw path、raw query、Content-Type 和 body 字节，再生成签名。 / Finalize method, raw path, raw query, Content-Type, and body bytes locally before signing.  3. 按业务分组调用接口；SSE 断开后使用 Events 补取。 / Call the appropriate business group and use Events for recovery after an SSE disconnect.  ## 公共错误 / Common errors  `401` 签名、时间戳或 nonce 无效；`403` 资源不属于当前渠道用户；`413` 请求体过大；`422` 参数校验失败；`429` 请求过于频繁；`500` 服务内部错误；`503` 依赖或执行服务暂不可用。  `401` invalid signature, timestamp, or nonce; `403` resource not owned by the current channel user; `413` request body too large; `422` validation failed; `429` rate limited; `500` internal error; `503` dependency or execution service unavailable.
+ * Public Lingya Agents channel API. HMAC credentials belong on trusted servers; client tokens are single-use.
  *
- * The version of the OpenAPI document: 0.1.5
+ * The version of the OpenAPI document: 0.1.7
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/models/AgentGoal.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Lingya Agents OpenAPI
+ * Public Lingya Agents channel API. HMAC credentials belong on trusted servers; client tokens are single-use.
+ *
+ * The version of the OpenAPI document: 0.1.7
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * AgentGoal 的公开协议结构。 / Public contract for agent goal.
+ * @export
+ * @interface AgentGoal
+ */
+export interface AgentGoal {
+    /**
+     * 字段 goalId / goal id field。
+     */
+    goalId: string;
+    /**
+     * 字段 goalRevision / goal revision field。
+     */
+    goalRevision: number;
+    /**
+     * 字段 objective / objective field。
+     */
+    objective: string;
+    /**
+     * 字段 phase / phase field。
+     */
+    phase: AgentGoalPhaseEnum;
+    /**
+     * 字段 recordState / record state field。
+     */
+    recordState: AgentGoalRecordStateEnum;
+    /**
+     * 字段 activationState / activation state field。
+     */
+    activationState: AgentGoalActivationStateEnum;
+    /**
+     * 字段 effectivelyArmed / effectively armed field。
+     */
+    effectivelyArmed: boolean;
+    /**
+     * 字段 blockedCode / blocked code field。
+     */
+    blockedCode: AgentGoalBlockedCodeEnum | null;
+    /**
+     * 字段 blockedMessage / blocked message field。
+     */
+    blockedMessage: string | null;
+    /**
+     * 字段 completionMessage / completion message field。
+     */
+    completionMessage: string | null;
+    /**
+     * 字段 statusVersion / status version field。
+     */
+    statusVersion: number;
+    /**
+     * 字段 nextExecutionDueTime / next execution due time field。
+     */
+    nextExecutionDueTime: Date | null;
+}
+/**
+ * @export
+ */
+export declare const AgentGoalPhaseEnum: {
+    readonly Active: "ACTIVE";
+    readonly Paused: "PAUSED";
+    readonly Blocked: "BLOCKED";
+    readonly Complete: "COMPLETE";
+};
+export type AgentGoalPhaseEnum = typeof AgentGoalPhaseEnum[keyof typeof AgentGoalPhaseEnum];
+/**
+ * @export
+ */
+export declare const AgentGoalRecordStateEnum: {
+    readonly Current: "CURRENT";
+    readonly Cleared: "CLEARED";
+    readonly Replaced: "REPLACED";
+};
+export type AgentGoalRecordStateEnum = typeof AgentGoalRecordStateEnum[keyof typeof AgentGoalRecordStateEnum];
+/**
+ * @export
+ */
+export declare const AgentGoalActivationStateEnum: {
+    readonly Armed: "ARMED";
+    readonly Disarmed: "DISARMED";
+};
+export type AgentGoalActivationStateEnum = typeof AgentGoalActivationStateEnum[keyof typeof AgentGoalActivationStateEnum];
+/**
+ * @export
+ */
+export declare const AgentGoalBlockedCodeEnum: {
+    readonly RoundLimit: "ROUND_LIMIT";
+    readonly StepLimit: "STEP_LIMIT";
+    readonly ArtifactCommitFailed: "ARTIFACT_COMMIT_FAILED";
+    readonly HumanInputRequired: "HUMAN_INPUT_REQUIRED";
+    readonly QueueFailed: "QUEUE_FAILED";
+    readonly PromptRejected: "PROMPT_REJECTED";
+    readonly AuthRevoked: "AUTH_REVOKED";
+    readonly StorageUnavailable: "STORAGE_UNAVAILABLE";
+    readonly ExecutionFailed: "EXECUTION_FAILED";
+    readonly ModelReported: "MODEL_REPORTED";
+};
+export type AgentGoalBlockedCodeEnum = typeof AgentGoalBlockedCodeEnum[keyof typeof AgentGoalBlockedCodeEnum];
+/**
+ * Check if a given object implements the AgentGoal interface.
+ */
+export declare function instanceOfAgentGoal(value: object): value is AgentGoal;
+export declare function AgentGoalFromJSON(json: any): AgentGoal;
+export declare function AgentGoalFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentGoal;
+export declare function AgentGoalToJSON(json: any): AgentGoal;
+export declare function AgentGoalToJSONTyped(value?: AgentGoal | null, ignoreDiscriminator?: boolean): any;

package/dist/models/AgentGoal.js

@@ -0,0 +1,135 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Lingya Agents OpenAPI
+ * Public Lingya Agents channel API. HMAC credentials belong on trusted servers; client tokens are single-use.
+ *
+ * The version of the OpenAPI document: 0.1.7
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentGoalBlockedCodeEnum = exports.AgentGoalActivationStateEnum = exports.AgentGoalRecordStateEnum = exports.AgentGoalPhaseEnum = void 0;
+exports.instanceOfAgentGoal = instanceOfAgentGoal;
+exports.AgentGoalFromJSON = AgentGoalFromJSON;
+exports.AgentGoalFromJSONTyped = AgentGoalFromJSONTyped;
+exports.AgentGoalToJSON = AgentGoalToJSON;
+exports.AgentGoalToJSONTyped = AgentGoalToJSONTyped;
+const runtime_1 = require("../runtime");
+/**
+ * @export
+ */
+exports.AgentGoalPhaseEnum = {
+    Active: 'ACTIVE',
+    Paused: 'PAUSED',
+    Blocked: 'BLOCKED',
+    Complete: 'COMPLETE',
+};
+/**
+ * @export
+ */
+exports.AgentGoalRecordStateEnum = {
+    Current: 'CURRENT',
+    Cleared: 'CLEARED',
+    Replaced: 'REPLACED',
+};
+/**
+ * @export
+ */
+exports.AgentGoalActivationStateEnum = {
+    Armed: 'ARMED',
+    Disarmed: 'DISARMED',
+};
+/**
+ * @export
+ */
+exports.AgentGoalBlockedCodeEnum = {
+    RoundLimit: 'ROUND_LIMIT',
+    StepLimit: 'STEP_LIMIT',
+    ArtifactCommitFailed: 'ARTIFACT_COMMIT_FAILED',
+    HumanInputRequired: 'HUMAN_INPUT_REQUIRED',
+    QueueFailed: 'QUEUE_FAILED',
+    PromptRejected: 'PROMPT_REJECTED',
+    AuthRevoked: 'AUTH_REVOKED',
+    StorageUnavailable: 'STORAGE_UNAVAILABLE',
+    ExecutionFailed: 'EXECUTION_FAILED',
+    ModelReported: 'MODEL_REPORTED',
+};
+/**
+ * Check if a given object implements the AgentGoal interface.
+ */
+function instanceOfAgentGoal(value) {
+    if (!('goalId' in value) || value['goalId'] === undefined)
+        return false;
+    if (!('goalRevision' in value) || value['goalRevision'] === undefined)
+        return false;
+    if (!('objective' in value) || value['objective'] === undefined)
+        return false;
+    if (!('phase' in value) || value['phase'] === undefined)
+        return false;
+    if (!('recordState' in value) || value['recordState'] === undefined)
+        return false;
+    if (!('activationState' in value) || value['activationState'] === undefined)
+        return false;
+    if (!('effectivelyArmed' in value) || value['effectivelyArmed'] === undefined)
+        return false;
+    if (!('blockedCode' in value) || value['blockedCode'] === undefined)
+        return false;
+    if (!('blockedMessage' in value) || value['blockedMessage'] === undefined)
+        return false;
+    if (!('completionMessage' in value) || value['completionMessage'] === undefined)
+        return false;
+    if (!('statusVersion' in value) || value['statusVersion'] === undefined)
+        return false;
+    if (!('nextExecutionDueTime' in value) || value['nextExecutionDueTime'] === undefined)
+        return false;
+    return true;
+}
+function AgentGoalFromJSON(json) {
+    return AgentGoalFromJSONTyped(json, false);
+}
+function AgentGoalFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'goalId': json['goalId'],
+        'goalRevision': json['goalRevision'],
+        'objective': json['objective'],
+        'phase': json['phase'],
+        'recordState': json['recordState'],
+        'activationState': json['activationState'],
+        'effectivelyArmed': json['effectivelyArmed'],
+        'blockedCode': json['blockedCode'],
+        'blockedMessage': json['blockedMessage'],
+        'completionMessage': json['completionMessage'],
+        'statusVersion': json['statusVersion'],
+        'nextExecutionDueTime': (json['nextExecutionDueTime'] == null ? null : (0, runtime_1.parseDateTime)(json['nextExecutionDueTime'])),
+    };
+}
+function AgentGoalToJSON(json) {
+    return AgentGoalToJSONTyped(json, false);
+}
+function AgentGoalToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'goalId': value['goalId'],
+        'goalRevision': value['goalRevision'],
+        'objective': value['objective'],
+        'phase': value['phase'],
+        'recordState': value['recordState'],
+        'activationState': value['activationState'],
+        'effectivelyArmed': value['effectivelyArmed'],
+        'blockedCode': value['blockedCode'],
+        'blockedMessage': value['blockedMessage'],
+        'completionMessage': value['completionMessage'],
+        'statusVersion': value['statusVersion'],
+        'nextExecutionDueTime': value['nextExecutionDueTime'] == null ? value['nextExecutionDueTime'] : (0, runtime_1.serializeDateTime)(value['nextExecutionDueTime']),
+    };
+}