@lingya-ai/agents-sdk 0.5.0 → 0.7.1

package/dist/client.js

@@ -1,4 +1,18 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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);
+};
 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) {
@@ -9,173 +23,113 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LingyaApiError = exports.LingyaAgentsUserClient = exports.LingyaAgentsClient = exports.ApiError = exports.AgentsUserClient = exports.AgentsClient = void 0;
+exports.LingyaAgentsClient = exports.AgentsClient = void 0;
+const ws_1 = require("ws");
+const lifecycle_1 = require("./lifecycle");
+const client_core_1 = require("./client-core");
 const runtime_1 = require("./runtime");
-const apis_1 = require("./apis");
 const hmac_1 = require("./hmac");
-const bound_1 = require("./bound");
-/**
- * Lingya Agents SDK 入口，仅适用于可信服务端。 / Server-side Lingya Agents SDK entry point.
- *
- * 客户端保存 channel 范围的凭证，但只有 [forUser] 创建的用户客户端可以发起请求。
- */
+const token_1 = require("./token");
+__exportStar(require("./client-core"), exports);
+__exportStar(require("./token"), exports);
+/** Channel client; options construction binds authentication and exposes API groups directly. */
 class AgentsClient {
-    /**
-     * 创建 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.
-     */
-    constructor(baseUrl, channelId, credentials) {
-        this.baseUrl = baseUrl;
-        this.channelId = channelId;
-        this.credentials = credentials;
-        if (channelId.length === 0)
+    constructor(options, channelId, credentials) {
+        this.baseUrl = typeof options === 'string' ? options : options.baseUrl;
+        this.channelId = typeof options === 'string' ? channelId : options.channelId;
+        if (!this.channelId)
             throw new Error('channelId must not be empty');
+        if (typeof options === 'string') {
+            if (!credentials)
+                throw new Error('credentials are required');
+            this.credentials = credentials;
+        }
+        else {
+            const transport = options.auth.type === 'token'
+                ? (0, token_1.createTokenFetch)(options.auth.tokenProvider, this.channelId, options.fetch)
+                : (0, hmac_1.createSignedFetch)(options.auth, options.auth.externalUserId, options.fetch);
+            this.bound = this.bind(transport, options.auth.type === 'token', (url, signal, requestId) => __awaiter(this, void 0, void 0, function* () {
+                var _a;
+                const factory = (_a = options.webSocketFactory) !== null && _a !== void 0 ? _a : createNodeWebSocket;
+                if (options.auth.type === 'token') {
+                    let token;
+                    try {
+                        token = yield (0, lifecycle_1.abortable)(Promise.resolve().then(() => { var _a; return options.auth.type === 'token' ? options.auth.tokenProvider({ channelId: this.channelId, signal, fetch: (_a = options.fetch) !== null && _a !== void 0 ? _a : globalThis.fetch }) : ''; }), signal);
+                    }
+                    catch (error) {
+                        if (signal.aborted)
+                            throw error;
+                        throw new lifecycle_1.ApiError('', '', undefined, '', { kind: 'authentication' });
+                    }
+                    if (typeof token !== 'string' || !/^[!#-~]+$/.test(token))
+                        throw new lifecycle_1.ApiError('', '', undefined, '', { kind: 'authentication' });
+                    (0, lifecycle_1.checkSignal)(signal);
+                    return factory(url, { protocols: [`xlt-openapi-token.${token}`], headers: requestId ? { 'X-Request-ID': requestId } : undefined });
+                }
+                const httpUrl = url.replace(/^ws/, 'http');
+                const capture = (input) => __awaiter(this, void 0, void 0, function* () { return new Response(null, { headers: new Request(input).headers }); });
+                const response = yield (0, hmac_1.createSignedFetch)(options.auth, options.auth.externalUserId, capture)(httpUrl, { signal });
+                (0, lifecycle_1.checkSignal)(signal);
+                return factory(url, { protocols: [], headers: Object.assign(Object.assign({}, Object.fromEntries(response.headers.entries())), (requestId ? { 'X-Request-ID': requestId } : {})) });
+            }));
+        }
+    }
+    bind(transport, tokenAuth = false, connector) {
+        return new client_core_1.AgentsUserClient(this.channelId, new runtime_1.Configuration({
+            basePath: this.baseUrl.replace(/\/+$/, ''), fetchApi: transport,
+        }), transport, this.baseUrl, tokenAuth, connector);
     }
-    /**
-     * 绑定外部用户身份；后续所有请求都以该身份独立签名。 / Binds one external user to all subsequent signed calls.
-     *
-     * @param externalUserId - 调用方系统的稳定用户 ID，UTF-8 编码后为 1..256 字节且不能含 NUL。
-     * @returns 注入用户身份并可调用全部契约 API 的客户端。
-     */
     forUser(externalUserId) {
-        const signedFetch = (0, hmac_1.createSignedFetch)(this.credentials, externalUserId);
-        const configuration = new runtime_1.Configuration({ basePath: this.baseUrl.replace(/\/+$/, ''), fetchApi: signedFetch });
-        return new AgentsUserClient(this.channelId, configuration, signedFetch, this.baseUrl);
+        if (!this.credentials)
+            throw new Error('Options clients already bind identity; create a new client to switch users');
+        return new AgentsClient({ baseUrl: this.baseUrl, channelId: this.channelId, auth: Object.assign(Object.assign({ type: 'hmac' }, this.credentials), { externalUserId }) }).user;
     }
+    get user() {
+        if (!this.bound)
+            throw new Error('Call forUser before using a legacy channel client');
+        return this.bound;
+    }
+    get chat() { return this.user.chat; }
+    get configuration() { return this.user.configuration; }
+    get conversations() { return this.user.conversations; }
+    get events() { return this.user.events; }
+    get files() { return this.user.files; }
+    get interactions() { return this.user.interactions; }
+    get knowledge() { return this.user.knowledge; }
+    get messages() { return this.user.messages; }
+    get sql() { return this.user.sql; }
+    get workspace() { return this.user.workspace; }
+    get lowLevel() { return this.user.lowLevel; }
 }
 exports.AgentsClient = AgentsClient;
 exports.LingyaAgentsClient = AgentsClient;
-/** 已绑定外部用户的强类型 API 集合。 / Strongly typed API collection bound to one external user. */
-class AgentsUserClient {
-    constructor(channelId, configuration, signedFetch, baseUrl) {
-        this.channelId = channelId;
-        this.signedFetch = signedFetch;
-        this.baseUrl = baseUrl;
-        const chat = new apis_1.ChatApi(configuration);
-        const configurationApi = new apis_1.ConfigurationApi(configuration);
-        const conversations = new apis_1.ConversationsApi(configuration);
-        const events = new apis_1.EventsApi(configuration);
-        const files = new apis_1.FilesApi(configuration);
-        const interactions = new apis_1.InteractionsApi(configuration);
-        const knowledge = new apis_1.KnowledgeApi(configuration);
-        const messages = new apis_1.MessagesApi(configuration);
-        const sql = new apis_1.SQLApi(configuration);
-        const workspace = new apis_1.WorkspaceApi(configuration);
-        this.lowLevel = new bound_1.AgentsLowLevelApis(configurationApi, chat, conversations, sql, messages, events, interactions, files, knowledge, workspace);
-        const rawRequest = this.rawRequest.bind(this);
-        this.chat = new bound_1.ChatApi(channelId, chat, rawRequest);
-        this.configuration = new bound_1.ConfigurationApi(channelId, configurationApi);
-        this.conversations = new bound_1.ConversationsApi(channelId, conversations);
-        this.events = new bound_1.EventsApi(channelId, events);
-        this.files = new bound_1.FilesApi(channelId, files);
-        this.interactions = new bound_1.InteractionsApi(channelId, interactions);
-        this.knowledge = new bound_1.KnowledgeApi(channelId, knowledge);
-        this.messages = new bound_1.MessagesApi(channelId, messages);
-        this.sql = new bound_1.SqlApi(channelId, sql);
-        this.workspace = new bound_1.WorkspaceApi(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) {
-            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(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());
-            return response;
+function createNodeWebSocket(address, init) {
+    const socket = new ws_1.WebSocket(address, init.protocols, { headers: init.headers });
+    const result = socket;
+    // ws is an EventEmitter: termination while connecting must also have an error listener.
+    socket.on('error', () => undefined);
+    socket.on('upgrade', response => {
+        const id = response.headers['x-request-id'];
+        if (typeof id === 'string')
+            result.serverRequestId = id;
+    });
+    socket.on('unexpected-response', (_request, response) => {
+        const chunks = [];
+        let size = 0;
+        response.on('data', chunk => {
+            const bytes = Buffer.from(chunk);
+            if (size < 65536)
+                chunks.push(bytes.subarray(0, 65536 - size));
+            size += bytes.length;
         });
-    }
-}
-exports.AgentsUserClient = AgentsUserClient;
-exports.LingyaAgentsUserClient = AgentsUserClient;
-/** 不含凭证的 HTTP 错误。 / HTTP failure that never includes credentials. */
-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 = 'ApiError';
-    }
+        const fail = () => {
+            const id = response.headers['x-request-id'];
+            result.handshakeError = new lifecycle_1.ApiError('GET', '/stream/ws', response.statusCode, Buffer.concat(chunks).toString('utf8'), { kind: 'http', requestId: typeof id === 'string' ? id : undefined });
+            socket.terminate();
+        };
+        response.once('end', fail);
+        response.once('error', fail);
+        socket.once('close', () => response.destroy());
+    });
+    return result;
 }
-exports.ApiError = ApiError;
-exports.LingyaApiError = ApiError;

package/dist/esm/apis/ChatApi.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).
@@ -10,12 +10,31 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
+import { type AgentGoal } from '../models/AgentGoal';
+import { type AgentGoalHistory } from '../models/AgentGoalHistory';
+import { type AgentGoalRefInput } from '../models/AgentGoalRefInput';
+import { type AgentGoalView } from '../models/AgentGoalView';
 import { type AiChatBriefEvent } from '../models/AiChatBriefEvent';
 import { type AiChatInput } from '../models/AiChatInput';
 import { type AiChatStreamInput } from '../models/AiChatStreamInput';
 import { type AiChatSubmission } from '../models/AiChatSubmission';
 import { type ChatStreamProbeEvent } from '../models/ChatStreamProbeEvent';
 import { type ChatStreamProbeInput } from '../models/ChatStreamProbeInput';
+import { type EditAgentGoalInput } from '../models/EditAgentGoalInput';
+export interface ClearGoalRequest {
+    /**
+     * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
+     */
+    channelId: string;
+    /**
+     * 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     */
+    conversationId: string;
+    /**
+     *
+     */
+    agentGoalRefInput: AgentGoalRefInput;
+}
 export interface CompactConversationRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
@@ -54,6 +73,48 @@ export interface CreateChatRequest {
      */
     aiChatInput: AiChatInput;
 }
+export interface EditGoalRequest {
+    /**
+     * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
+     */
+    channelId: string;
+    /**
+     * 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     */
+    conversationId: string;
+    /**
+     *
+     */
+    editAgentGoalInput: EditAgentGoalInput;
+}
+export interface GetGoalRequest {
+    /**
+     * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
+     */
+    channelId: string;
+    /**
+     * 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     */
+    conversationId: string;
+}
+export interface GetGoalHistoryRequest {
+    /**
+     * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
+     */
+    channelId: string;
+    /**
+     * 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     */
+    conversationId: string;
+    /**
+     * 分页信息 / page metadata。
+     */
+    page?: number;
+    /**
+     * 单页记录数。 / Number of records per page.
+     */
+    size?: number;
+}
 export interface InterruptConversationRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
@@ -64,6 +125,20 @@ export interface InterruptConversationRequest {
      */
     conversationId: string;
 }
+export interface PauseGoalRequest {
+    /**
+     * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
+     */
+    channelId: string;
+    /**
+     * 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     */
+    conversationId: string;
+    /**
+     *
+     */
+    agentGoalRefInput: AgentGoalRefInput;
+}
 export interface ProbeEventStreamRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
@@ -78,6 +153,20 @@ export interface ProbeEventStreamRequest {
      */
     xRequestID?: string;
 }
+export interface ResumeGoalRequest {
+    /**
+     * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
+     */
+    channelId: string;
+    /**
+     * 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     */
+    conversationId: string;
+    /**
+     *
+     */
+    agentGoalRefInput: AgentGoalRefInput;
+}
 export interface StreamChatEventsRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
@@ -100,6 +189,20 @@ export interface StreamChatEventsRequest {
  *
  */
 export declare class ChatApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for clearGoal without sending the request
+     */
+    clearGoalRequestOpts(requestParameters: ClearGoalRequest): Promise<runtime.RequestOpts>;
+    /**
+     * ### 使用场景 携带目标标识与版本，清除目标并保留墓碑。  ### Use case Clear the identified goal at the expected revision and preserve its tombstone.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 携带目标标识与版本，清除目标并保留墓碑。  ### Behavior and side effects Clear the identified goal at the expected revision and preserve its tombstone.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 清除目标 / Clear goal  ### Operation summary 清除目标 / Clear goal
+     * 清除目标 / Clear goal
+     */
+    clearGoalRaw(requestParameters: ClearGoalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentGoal>>;
+    /**
+     * ### 使用场景 携带目标标识与版本，清除目标并保留墓碑。  ### Use case Clear the identified goal at the expected revision and preserve its tombstone.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 携带目标标识与版本，清除目标并保留墓碑。  ### Behavior and side effects Clear the identified goal at the expected revision and preserve its tombstone.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 清除目标 / Clear goal  ### Operation summary 清除目标 / Clear goal
+     * 清除目标 / Clear goal
+     */
+    clearGoal(requestParameters: ClearGoalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentGoal>;
     /**
      * Creates request options for compactConversation without sending the request
      */
@@ -142,6 +245,48 @@ export declare class ChatApi extends runtime.BaseAPI {
      * 创建会话并提交消息 / Create a conversation and submit a message
      */
     createChat(requestParameters: CreateChatRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AiChatSubmission>;
+    /**
+     * Creates request options for editGoal without sending the request
+     */
+    editGoalRequestOpts(requestParameters: EditGoalRequest): Promise<runtime.RequestOpts>;
+    /**
+     * ### 使用场景 携带 goalId 和 goalRevision 更新目标正文，不改变激活状态；陈旧版本返回 409，失效目标返回 410。  ### Use case Update the objective with goalId and goalRevision without changing activation; stale revisions return 409 and invalidated goals return 410.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 携带 goalId 和 goalRevision 更新目标正文，不改变激活状态；陈旧版本返回 409，失效目标返回 410。  ### Behavior and side effects Update the objective with goalId and goalRevision without changing activation; stale revisions return 409 and invalidated goals return 410.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 编辑目标 / Edit goal  ### Operation summary 编辑目标 / Edit goal
+     * 编辑目标 / Edit goal
+     */
+    editGoalRaw(requestParameters: EditGoalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentGoal>>;
+    /**
+     * ### 使用场景 携带 goalId 和 goalRevision 更新目标正文，不改变激活状态；陈旧版本返回 409，失效目标返回 410。  ### Use case Update the objective with goalId and goalRevision without changing activation; stale revisions return 409 and invalidated goals return 410.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 携带 goalId 和 goalRevision 更新目标正文，不改变激活状态；陈旧版本返回 409，失效目标返回 410。  ### Behavior and side effects Update the objective with goalId and goalRevision without changing activation; stale revisions return 409 and invalidated goals return 410.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 编辑目标 / Edit goal  ### Operation summary 编辑目标 / Edit goal
+     * 编辑目标 / Edit goal
+     */
+    editGoal(requestParameters: EditGoalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentGoal>;
+    /**
+     * Creates request options for getGoal without sending the request
+     */
+    getGoalRequestOpts(requestParameters: GetGoalRequest): Promise<runtime.RequestOpts>;
+    /**
+     * ### 使用场景 无当前目标时返回 goal=null。  ### Use case Return goal=null when no current goal exists.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 无当前目标时返回 goal=null。  ### Behavior and side effects Return goal=null when no current goal exists.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 读取当前目标 / Get current goal  ### Operation summary 读取当前目标 / Get current goal
+     * 读取当前目标 / Get current goal
+     */
+    getGoalRaw(requestParameters: GetGoalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentGoalView>>;
+    /**
+     * ### 使用场景 无当前目标时返回 goal=null。  ### Use case Return goal=null when no current goal exists.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 无当前目标时返回 goal=null。  ### Behavior and side effects Return goal=null when no current goal exists.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 读取当前目标 / Get current goal  ### Operation summary 读取当前目标 / Get current goal
+     * 读取当前目标 / Get current goal
+     */
+    getGoal(requestParameters: GetGoalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentGoalView>;
+    /**
+     * Creates request options for getGoalHistory without sending the request
+     */
+    getGoalHistoryRequestOpts(requestParameters: GetGoalHistoryRequest): Promise<runtime.RequestOpts>;
+    /**
+     * ### 使用场景 分页读取当前会话的目标历史。  ### Use case Read paged goal history for the conversation.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 分页读取当前会话的目标历史。  ### Behavior and side effects Read paged goal history for the conversation.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 查询目标历史 / Get goal history  ### Operation summary 查询目标历史 / Get goal history
+     * 查询目标历史 / Get goal history
+     */
+    getGoalHistoryRaw(requestParameters: GetGoalHistoryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentGoalHistory>>;
+    /**
+     * ### 使用场景 分页读取当前会话的目标历史。  ### Use case Read paged goal history for the conversation.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 分页读取当前会话的目标历史。  ### Behavior and side effects Read paged goal history for the conversation.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 查询目标历史 / Get goal history  ### Operation summary 查询目标历史 / Get goal history
+     * 查询目标历史 / Get goal history
+     */
+    getGoalHistory(requestParameters: GetGoalHistoryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentGoalHistory>;
     /**
      * Creates request options for interruptConversation without sending the request
      */
@@ -156,6 +301,20 @@ export declare class ChatApi extends runtime.BaseAPI {
      * 中断会话执行 / Interrupt conversation execution
      */
     interruptConversation(requestParameters: InterruptConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Creates request options for pauseGoal without sending the request
+     */
+    pauseGoalRequestOpts(requestParameters: PauseGoalRequest): Promise<runtime.RequestOpts>;
+    /**
+     * ### 使用场景 携带目标标识与版本，暂停并撤销自动续跑授权。  ### Use case Pause the identified goal at the expected revision and revoke automatic continuation.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 携带目标标识与版本，暂停并撤销自动续跑授权。  ### Behavior and side effects Pause the identified goal at the expected revision and revoke automatic continuation.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 暂停目标 / Pause goal  ### Operation summary 暂停目标 / Pause goal
+     * 暂停目标 / Pause goal
+     */
+    pauseGoalRaw(requestParameters: PauseGoalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentGoal>>;
+    /**
+     * ### 使用场景 携带目标标识与版本，暂停并撤销自动续跑授权。  ### Use case Pause the identified goal at the expected revision and revoke automatic continuation.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 携带目标标识与版本，暂停并撤销自动续跑授权。  ### Behavior and side effects Pause the identified goal at the expected revision and revoke automatic continuation.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 暂停目标 / Pause goal  ### Operation summary 暂停目标 / Pause goal
+     * 暂停目标 / Pause goal
+     */
+    pauseGoal(requestParameters: PauseGoalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentGoal>;
     /**
      * Creates request options for probeEventStream without sending the request
      */
@@ -170,6 +329,20 @@ export declare class ChatApi extends runtime.BaseAPI {
      * 探测 SSE 连接 / Probe the SSE connection
      */
     probeEventStream(requestParameters: ProbeEventStreamRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChatStreamProbeEvent>;
+    /**
+     * Creates request options for resumeGoal without sending the request
+     */
+    resumeGoalRequestOpts(requestParameters: ResumeGoalRequest): Promise<runtime.RequestOpts>;
+    /**
+     * ### 使用场景 携带目标标识与版本，恢复目标并重新授予自动续跑授权。  ### Use case Resume the identified goal at the expected revision and authorize automatic continuation.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 携带目标标识与版本，恢复目标并重新授予自动续跑授权。  ### Behavior and side effects Resume the identified goal at the expected revision and authorize automatic continuation.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 恢复目标 / Resume goal  ### Operation summary 恢复目标 / Resume goal
+     * 恢复目标 / Resume goal
+     */
+    resumeGoalRaw(requestParameters: ResumeGoalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentGoal>>;
+    /**
+     * ### 使用场景 携带目标标识与版本，恢复目标并重新授予自动续跑授权。  ### Use case Resume the identified goal at the expected revision and authorize automatic continuation.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 携带目标标识与版本，恢复目标并重新授予自动续跑授权。  ### Behavior and side effects Resume the identified goal at the expected revision and authorize automatic continuation.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 恢复目标 / Resume goal  ### Operation summary 恢复目标 / Resume goal
+     * 恢复目标 / Resume goal
+     */
+    resumeGoal(requestParameters: ResumeGoalRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentGoal>;
     /**
      * Creates request options for streamChatEvents without sending the request
      */