@lingya-ai/agents-sdk 0.5.0 → 0.7.0

package/README.md

@@ -1,19 +1,52 @@
 # 灵涯 Agents TypeScript SDK
 Lingya Agents SDK for TypeScript
 
-用于在 Node.js 可信服务端调用灵涯 Agents OpenAPI。
-Use this SDK to call Lingya Agents OpenAPI from a trusted Node.js server.
+支持 Node.js 服务端 HMAC 认证及浏览器一次性令牌认证。
+Use HMAC on trusted Node.js servers or single-use tokens in browsers.
 
 ## 安装
 Installation
 
 ```bash
-npm install @lingya-ai/agents-sdk@0.5.0
+npm install @lingya-ai/agents-sdk@0.7.0
 ```
 
-运行环境需要 Node.js 20 或更高版本。
+Node 入口需要 Node.js 20 或更高版本；浏览器入口使用现代 Web API。
 The runtime requires Node.js 20 or later.
 
+## 一次性令牌与浏览器
+
+浏览器使用专用入口；支持浏览器条件导出的打包器也会自动选择此入口。它不包含 `node:crypto`，只接受 token 回调。服务端入口同时支持 HMAC 和 token。
+The browser entry excludes Node crypto and only accepts token callbacks. The Node entry supports both authentication modes.
+
+```typescript
+import { AgentsClient } from '@lingya-ai/agents-sdk/browser';
+
+const client = new AgentsClient({
+    baseUrl: 'https://agents.example.com',
+    channelId: 'channel-id',
+    auth: {
+        type: 'token',
+        tokenProvider: async ({ fetch, signal }) => {
+            // 自己的业务服务端根据登录用户签发一枚新令牌。
+            const response = await fetch('/api/agents-token', {
+                method: 'POST', credentials: 'same-origin', signal,
+            });
+            if (!response.ok) throw new Error('获取令牌失败');
+            const { token } = await response.json();
+            return token;
+        },
+    },
+});
+await client.chat.createChat({ query: '你好' });
+```
+
+Node 新选项构造支持 `auth: { type: 'hmac', accessKey, secretKey, externalUserId }`，并在 `client` 上直接提供业务分组；原有三参数构造加 `forUser` 保持兼容。选项构造已绑定身份，不能再调用 `forUser` 切换用户。浏览器部署需要服务端 CORS 放行页面来源和 `X-OpenAPI-Token` 请求头。浏览器 SSE 使用 Fetch 响应流和增量 `TextDecoder` 解码，不依赖 `TextDecoderStream`；取消与计时由 SDK 管理，不依赖 `AbortSignal.any/timeout` 或 `throwIfAborted`。浏览器仍需提供 Fetch、ReadableStream、TextDecoder 和 AbortController。
+Node options also accept HMAC credentials and an external user ID. Legacy constructors remain supported. Options clients already bind identity. Configure CORS for your browser origin and token header; Fetch-based SSE uses incremental TextDecoder decoding without TextDecoderStream. The SDK manages cancellation and timers without AbortSignal.any/timeout or throwIfAborted; Fetch, ReadableStream, TextDecoder, and AbortController are still required.
+
+令牌有效期十分钟，但只允许认证一次；每次请求、手动重试和 SSE/WebSocket 重新连接都独立调用回调，不缓存、不合并并发签发、不自动重试或跟随重定向。认证成功后即消费，业务失败不能复用。Token 模式不携带 HMAC 头，不能调用 `createOpenApiToken`；需由持有 AK/SK 的可信服务端签发。回调异常及非法 token 会在业务请求发出前拒绝。`/api/agents-token`、`issue_fresh_token` / `issueFreshToken` 都是业务系统示意，并非 SDK 新增接口。签发服务应从登录态确定用户和允许的渠道。
+Tokens expire after ten minutes but authenticate only once. Each request, explicit retry, and SSE/WebSocket reconnection invokes the provider independently. Token clients do not cache, share issuance, retry automatically, follow redirects, send HMAC headers, or call presign. Use a trusted server to issue tokens for the authenticated business user and permitted channel; the example issuer functions/routes belong to your application.
+
 ## 快速开始
 Quick start
 
@@ -62,9 +95,34 @@ import { ApiError } from '@lingya-ai/agents-sdk';
 try {
   await user.conversations.getConversationTitle('conversation-id');
 } catch (error) {
-  if (error instanceof ApiError) console.error(error.status, error.responseBody);
+  if (error instanceof ApiError) console.error(error.kind, error.status, error.code, error.message, error.fields, error.requestId);
 }
 ```
 
 请只在可信服务端保存 `secretKey`，不要将其放入浏览器、移动端、桌面端或日志。
 Keep `secretKey` on trusted servers only; never put it in browsers, mobile apps, desktop apps, or logs.
+
+
+## 0.7 请求生命周期与订阅
+
+```typescript
+const client = new AgentsClient({
+    baseUrl, channelId, fetch: customFetch,
+    auth: { type: 'token', tokenProvider: async ({ fetch, signal }) => {
+        const response = await fetch('/api/agents-token', { method: 'POST', signal });
+        if (!response.ok) throw new Error('Token issuance failed');
+        return (await response.json()).token;
+    } },
+});
+const controller = new AbortController();
+await client.configuration.getAgentsConfig({ signal: controller.signal, timeoutMs: 5000 });
+const subscription = client.chat.subscribeChatEvents(conversationId, { messageId }, {
+    transport: 'websocket', signal: controller.signal, idleTimeoutMs: 30000,
+    onConnectionEvent: event => console.debug(event),
+});
+try { for await (const event of subscription) consume(event); }
+finally { subscription.close(); await subscription.closed; }
+const download = await client.sql.exportSqlQueryResultWithMetadata(conversationId, resultId, { format: 'CSV' });
+```
+
+超时覆盖获取令牌、建连和完整响应；SDK 不自动重试或重连。业务 End 立即释放连接，WebSocket complete/1000 不补造 End。错误包含可判别分类、HTTP 状态和可取得的业务错误及请求标识。详见 [生命周期、错误和生成机制](docs/request-lifecycle.md)。运行时由契约项目统一生成，修改生成产物会被 CI 检出。

package/dist/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
      */