@leaflow/sdk 0.1.2 → 0.2.0

package/dist/generated/assistant/models/index.d.ts

@@ -2,105 +2,115 @@
  * Generated by orval v7.21.0 🍺
  * Do not edit manually.
  * Leaflow Assistant 用户 API
- * 助手对话及其接入面：线程、逐字稿、一次 turn 的执行与流式输出、工具调用与审批、追问、技能，以及通道、绑定和微信扫码登录。
+ * 控制台里的 AI 助手：对话、消息、工具调用与审批、附件，以及把助手接到微信、飞书、Telegram 等即时通讯平台上。
 
-## 认证
+## 一次对话
 
-所有接口都要求 `Authorization: Bearer <项目令牌>`。项目令牌向 `POST /api/v1/projects/{projectId}/token` 换取，登录服务是 auth.leaflow.net。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 `project_id`。
+1. `POST /v1/threads` 创建对话；
+2. `POST /v1/threads/{thread}/messages` 发送消息，立即返回 `turnId`，助手的执行在后台进行；
+3. `GET /v1/threads/{thread}` 取回对话文档用于渲染，并按其中的 `stream` 连上实时输出；
+4. 助手需要用户参与时，文档中的 `wait` 会说明是哪一种：审批一批工具调用（`POST /v1/threads/{thread}/approvals/{batch}`），或回答几个问题（`POST /v1/threads/{thread}/questions/{item}`）。处理完成后助手自动继续。
 
-令牌无效或过期返回 401，不是当前项目的成员返回 403。这两种都应重新换取令牌后重试；仍然失败说明这个账号在该项目里已没有权限。
+发送图片分两步：先 `POST /v1/attachments` 上传拿到 id，发送消息时放进 `attachmentIds`。
 
-## 一次对话
+## 实时输出
+
+```
+GET /v1/turns/{turn}/stream?ticket=<ticket>&cursor=<cursor>
+```
 
-1. `POST /v1/threads` 创建线程；
-2. `POST /v1/threads/{thread}/messages` 发送消息。它立即返回 `turnId`，不等待执行完成——一次 turn 可能持续数十分钟；
-3. `GET /v1/threads/{thread}` 取回线程文档。文档中的 `stream` 给出实时输出的地址和入场票据；流推送的是对该文档的增量编辑，客户端渲染逻辑只有一套；
-4. turn 需要人工介入时，文档中的 `wait` 说明介入类型：批准一批工具调用（`POST /v1/threads/{thread}/approvals/{batch}`），或回答提出的问题（`POST /v1/threads/{thread}/questions/{item}`）。
+这是一条 Server-Sent Events 流，因此不在下方的接口列表中。
 
-图片分两步发送：先 `POST /v1/attachments` 取得附件 id，再在发送消息时放进 `attachmentIds`。
+- `path` 与 `ticket` 都取自对话文档的 `stream`。`path` 是相对路径，按取回文档的地址解析；
+- `cursor` 是起始位置，取自对话文档的 `cursor`。不传则从可用范围的开头开始；
+- 推送的每一条都是对那份对话文档的一次增量编辑，套用同一套渲染逻辑即可；
+- 连接有生存期，到时会正常关闭。使用 `EventSource` 时浏览器会自动携带 `Last-Event-ID` 重连并从断点续传，无需额外处理；
+- 三种结束事件：`done` 本次 turn 完成（附带最终状态）、`paused` 助手在等待用户处理（重新取回对话文档读 `wait`）、`stalled` 执行已中断且不会恢复，不要重连。
  * OpenAPI spec version: 1.0.0
  */
-export * from './answerInputBody';
-export * from './answerInputBodyAnswers';
-export * from './attachmentView';
-export * from './bindingView';
-export * from './bindingViewVerifiedAt';
-export * from './channelView';
-export * from './channelViewAllowFrom';
-export * from './choice';
-export * from './claimCodeOutputBody';
-export * from './contextView';
-export * from './contextViewCompactAt';
-export * from './contextViewUsed';
-export * from './contextViewWindow';
-export * from './createChannelInputBody';
-export * from './createChannelInputBodyAllowFrom';
-export * from './createChannelInputBodyCredentials';
-export * from './createThreadInputBody';
-export * from './createThreadInputBodyApprovalMode';
-export * from './decideInputBody';
-export * from './documentView';
-export * from './documentViewCursor';
-export * from './documentViewItems';
-export * from './documentViewTurnId';
-export * from './earlierView';
-export * from './entry';
-export * from './error';
-export * from './errorMeta';
-export * from './itemView';
-export * from './itemViewApproval';
-export * from './itemViewApprovalReason';
-export * from './itemViewAttachments';
-export * from './itemViewDetail';
-export * from './itemViewDurationMs';
-export * from './itemViewModel';
-export * from './itemViewNamespace';
-export * from './itemViewStatus';
-export * from './itemViewTarget';
-export * from './itemViewTool';
-export * from './itemViewType';
-export * from './listBindingsOutputBody';
-export * from './listBindingsOutputBodyBindings';
-export * from './listBindingsParams';
-export * from './listChannelRejectionsParams';
-export * from './listChannelsOutputBody';
-export * from './listChannelsOutputBodyChannels';
-export * from './listChannelsParams';
-export * from './listModelsOutputBody';
-export * from './listModelsOutputBodyModels';
-export * from './listPlatformsOutputBody';
-export * from './listPlatformsOutputBodyPlatforms';
-export * from './listRejectionsOutputBody';
-export * from './listRejectionsOutputBodyRejections';
-export * from './listThreadsOutputBody';
-export * from './listThreadsOutputBodyThreads';
-export * from './listThreadsParams';
-export * from './loginView';
-export * from './modelView';
-export * from './modelViewInputModalities';
-export * from './modelViewReasoningTiers';
-export * from './platformView';
-export * from './question';
-export * from './questionChoices';
-export * from './revertInputBody';
-export * from './revertOutputBody';
-export * from './rotateSecretOutputBody';
-export * from './sendMessageInputBody';
-export * from './sendMessageInputBodyAttachmentIds';
-export * from './sendMessageOutputBody';
-export * from './streamView';
-export * from './threadSummaryView';
-export * from './threadSummaryViewApprovalMode';
-export * from './threadSummaryViewTitle';
-export * from './turnView';
-export * from './turnViewApprovalMode';
-export * from './updateChannelInputBody';
-export * from './updateChannelInputBodyCredentials';
-export * from './updateThreadInputBody';
-export * from './updateThreadInputBodyApprovalMode';
-export * from './uploadedView';
-export * from './verifyCodeInputBody';
-export * from './waitView';
-export * from './waitViewItemIds';
-export * from './waitViewKind';
-export * from './waitViewQuestions';
+export * from './answerRequestBody.js';
+export * from './answerRequestBodyAnswers.js';
+export * from './attachmentResource.js';
+export * from './bindingListResponseBody.js';
+export * from './bindingListResponseBodyBindings.js';
+export * from './bindingResource.js';
+export * from './bindingResourceVerifiedAt.js';
+export * from './channelListResponseBody.js';
+export * from './channelListResponseBodyChannels.js';
+export * from './channelResource.js';
+export * from './channelResourceAllowFrom.js';
+export * from './channelResourceWebhookUrl.js';
+export * from './choice.js';
+export * from './claimCodeResponseBody.js';
+export * from './contextResource.js';
+export * from './contextResourceCompactAt.js';
+export * from './contextResourceUsed.js';
+export * from './contextResourceWindow.js';
+export * from './createChannelRequestBody.js';
+export * from './createChannelRequestBodyAllowFrom.js';
+export * from './createChannelRequestBodyCredentials.js';
+export * from './createThreadRequestBody.js';
+export * from './createThreadRequestBodyApprovalMode.js';
+export * from './decideRequestBody.js';
+export * from './documentResource.js';
+export * from './documentResourceCursor.js';
+export * from './documentResourceItems.js';
+export * from './documentResourceTurnId.js';
+export * from './earlierResource.js';
+export * from './entry.js';
+export * from './error.js';
+export * from './errorMeta.js';
+export * from './itemResource.js';
+export * from './itemResourceApproval.js';
+export * from './itemResourceApprovalReason.js';
+export * from './itemResourceAttachments.js';
+export * from './itemResourceDetail.js';
+export * from './itemResourceDurationMs.js';
+export * from './itemResourceModel.js';
+export * from './itemResourceNamespace.js';
+export * from './itemResourceStatus.js';
+export * from './itemResourceTarget.js';
+export * from './itemResourceTool.js';
+export * from './itemResourceType.js';
+export * from './listBindingsParams.js';
+export * from './listChannelRejectionsParams.js';
+export * from './listChannelsParams.js';
+export * from './listThreadsParams.js';
+export * from './loginResource.js';
+export * from './modelListResponseBody.js';
+export * from './modelListResponseBodyModels.js';
+export * from './modelResource.js';
+export * from './modelResourceInputModalities.js';
+export * from './modelResourceReasoningTiers.js';
+export * from './platformListResponseBody.js';
+export * from './platformListResponseBodyPlatforms.js';
+export * from './platformResource.js';
+export * from './platformResourceWebhookUrlTemplate.js';
+export * from './question.js';
+export * from './questionChoices.js';
+export * from './rejectionListResponseBody.js';
+export * from './rejectionListResponseBodyRejections.js';
+export * from './revertRequestBody.js';
+export * from './revertedCountResponseBody.js';
+export * from './sendMessageRequestBody.js';
+export * from './sendMessageRequestBodyAttachmentIds.js';
+export * from './streamResource.js';
+export * from './threadListResponseBody.js';
+export * from './threadListResponseBodyThreads.js';
+export * from './threadSummaryResource.js';
+export * from './threadSummaryResourceApprovalMode.js';
+export * from './threadSummaryResourceTitle.js';
+export * from './turnIDResponseBody.js';
+export * from './turnResource.js';
+export * from './turnResourceApprovalMode.js';
+export * from './updateChannelRequestBody.js';
+export * from './updateChannelRequestBodyCredentials.js';
+export * from './updateThreadRequestBody.js';
+export * from './updateThreadRequestBodyApprovalMode.js';
+export * from './uploadedResource.js';
+export * from './verifyCodeRequestBody.js';
+export * from './waitResource.js';
+export * from './waitResourceItemIds.js';
+export * from './waitResourceKind.js';
+export * from './waitResourceQuestions.js';
+export * from './webhookSecretResponseBody.js';

package/dist/generated/assistant/models/index.js

@@ -2,105 +2,115 @@
  * Generated by orval v7.21.0 🍺
  * Do not edit manually.
  * Leaflow Assistant 用户 API
- * 助手对话及其接入面：线程、逐字稿、一次 turn 的执行与流式输出、工具调用与审批、追问、技能，以及通道、绑定和微信扫码登录。
+ * 控制台里的 AI 助手：对话、消息、工具调用与审批、附件，以及把助手接到微信、飞书、Telegram 等即时通讯平台上。
 
-## 认证
+## 一次对话
 
-所有接口都要求 `Authorization: Bearer <项目令牌>`。项目令牌向 `POST /api/v1/projects/{projectId}/token` 换取，登录服务是 auth.leaflow.net。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 `project_id`。
+1. `POST /v1/threads` 创建对话；
+2. `POST /v1/threads/{thread}/messages` 发送消息，立即返回 `turnId`，助手的执行在后台进行；
+3. `GET /v1/threads/{thread}` 取回对话文档用于渲染，并按其中的 `stream` 连上实时输出；
+4. 助手需要用户参与时，文档中的 `wait` 会说明是哪一种：审批一批工具调用（`POST /v1/threads/{thread}/approvals/{batch}`），或回答几个问题（`POST /v1/threads/{thread}/questions/{item}`）。处理完成后助手自动继续。
 
-令牌无效或过期返回 401，不是当前项目的成员返回 403。这两种都应重新换取令牌后重试；仍然失败说明这个账号在该项目里已没有权限。
+发送图片分两步：先 `POST /v1/attachments` 上传拿到 id，发送消息时放进 `attachmentIds`。
 
-## 一次对话
+## 实时输出
+
+```
+GET /v1/turns/{turn}/stream?ticket=<ticket>&cursor=<cursor>
+```
 
-1. `POST /v1/threads` 创建线程；
-2. `POST /v1/threads/{thread}/messages` 发送消息。它立即返回 `turnId`，不等待执行完成——一次 turn 可能持续数十分钟；
-3. `GET /v1/threads/{thread}` 取回线程文档。文档中的 `stream` 给出实时输出的地址和入场票据；流推送的是对该文档的增量编辑，客户端渲染逻辑只有一套；
-4. turn 需要人工介入时，文档中的 `wait` 说明介入类型：批准一批工具调用（`POST /v1/threads/{thread}/approvals/{batch}`），或回答提出的问题（`POST /v1/threads/{thread}/questions/{item}`）。
+这是一条 Server-Sent Events 流，因此不在下方的接口列表中。
 
-图片分两步发送：先 `POST /v1/attachments` 取得附件 id，再在发送消息时放进 `attachmentIds`。
+- `path` 与 `ticket` 都取自对话文档的 `stream`。`path` 是相对路径，按取回文档的地址解析；
+- `cursor` 是起始位置，取自对话文档的 `cursor`。不传则从可用范围的开头开始；
+- 推送的每一条都是对那份对话文档的一次增量编辑，套用同一套渲染逻辑即可；
+- 连接有生存期，到时会正常关闭。使用 `EventSource` 时浏览器会自动携带 `Last-Event-ID` 重连并从断点续传，无需额外处理；
+- 三种结束事件：`done` 本次 turn 完成（附带最终状态）、`paused` 助手在等待用户处理（重新取回对话文档读 `wait`）、`stalled` 执行已中断且不会恢复，不要重连。
  * OpenAPI spec version: 1.0.0
  */
-export * from './answerInputBody';
-export * from './answerInputBodyAnswers';
-export * from './attachmentView';
-export * from './bindingView';
-export * from './bindingViewVerifiedAt';
-export * from './channelView';
-export * from './channelViewAllowFrom';
-export * from './choice';
-export * from './claimCodeOutputBody';
-export * from './contextView';
-export * from './contextViewCompactAt';
-export * from './contextViewUsed';
-export * from './contextViewWindow';
-export * from './createChannelInputBody';
-export * from './createChannelInputBodyAllowFrom';
-export * from './createChannelInputBodyCredentials';
-export * from './createThreadInputBody';
-export * from './createThreadInputBodyApprovalMode';
-export * from './decideInputBody';
-export * from './documentView';
-export * from './documentViewCursor';
-export * from './documentViewItems';
-export * from './documentViewTurnId';
-export * from './earlierView';
-export * from './entry';
-export * from './error';
-export * from './errorMeta';
-export * from './itemView';
-export * from './itemViewApproval';
-export * from './itemViewApprovalReason';
-export * from './itemViewAttachments';
-export * from './itemViewDetail';
-export * from './itemViewDurationMs';
-export * from './itemViewModel';
-export * from './itemViewNamespace';
-export * from './itemViewStatus';
-export * from './itemViewTarget';
-export * from './itemViewTool';
-export * from './itemViewType';
-export * from './listBindingsOutputBody';
-export * from './listBindingsOutputBodyBindings';
-export * from './listBindingsParams';
-export * from './listChannelRejectionsParams';
-export * from './listChannelsOutputBody';
-export * from './listChannelsOutputBodyChannels';
-export * from './listChannelsParams';
-export * from './listModelsOutputBody';
-export * from './listModelsOutputBodyModels';
-export * from './listPlatformsOutputBody';
-export * from './listPlatformsOutputBodyPlatforms';
-export * from './listRejectionsOutputBody';
-export * from './listRejectionsOutputBodyRejections';
-export * from './listThreadsOutputBody';
-export * from './listThreadsOutputBodyThreads';
-export * from './listThreadsParams';
-export * from './loginView';
-export * from './modelView';
-export * from './modelViewInputModalities';
-export * from './modelViewReasoningTiers';
-export * from './platformView';
-export * from './question';
-export * from './questionChoices';
-export * from './revertInputBody';
-export * from './revertOutputBody';
-export * from './rotateSecretOutputBody';
-export * from './sendMessageInputBody';
-export * from './sendMessageInputBodyAttachmentIds';
-export * from './sendMessageOutputBody';
-export * from './streamView';
-export * from './threadSummaryView';
-export * from './threadSummaryViewApprovalMode';
-export * from './threadSummaryViewTitle';
-export * from './turnView';
-export * from './turnViewApprovalMode';
-export * from './updateChannelInputBody';
-export * from './updateChannelInputBodyCredentials';
-export * from './updateThreadInputBody';
-export * from './updateThreadInputBodyApprovalMode';
-export * from './uploadedView';
-export * from './verifyCodeInputBody';
-export * from './waitView';
-export * from './waitViewItemIds';
-export * from './waitViewKind';
-export * from './waitViewQuestions';
+export * from './answerRequestBody.js';
+export * from './answerRequestBodyAnswers.js';
+export * from './attachmentResource.js';
+export * from './bindingListResponseBody.js';
+export * from './bindingListResponseBodyBindings.js';
+export * from './bindingResource.js';
+export * from './bindingResourceVerifiedAt.js';
+export * from './channelListResponseBody.js';
+export * from './channelListResponseBodyChannels.js';
+export * from './channelResource.js';
+export * from './channelResourceAllowFrom.js';
+export * from './channelResourceWebhookUrl.js';
+export * from './choice.js';
+export * from './claimCodeResponseBody.js';
+export * from './contextResource.js';
+export * from './contextResourceCompactAt.js';
+export * from './contextResourceUsed.js';
+export * from './contextResourceWindow.js';
+export * from './createChannelRequestBody.js';
+export * from './createChannelRequestBodyAllowFrom.js';
+export * from './createChannelRequestBodyCredentials.js';
+export * from './createThreadRequestBody.js';
+export * from './createThreadRequestBodyApprovalMode.js';
+export * from './decideRequestBody.js';
+export * from './documentResource.js';
+export * from './documentResourceCursor.js';
+export * from './documentResourceItems.js';
+export * from './documentResourceTurnId.js';
+export * from './earlierResource.js';
+export * from './entry.js';
+export * from './error.js';
+export * from './errorMeta.js';
+export * from './itemResource.js';
+export * from './itemResourceApproval.js';
+export * from './itemResourceApprovalReason.js';
+export * from './itemResourceAttachments.js';
+export * from './itemResourceDetail.js';
+export * from './itemResourceDurationMs.js';
+export * from './itemResourceModel.js';
+export * from './itemResourceNamespace.js';
+export * from './itemResourceStatus.js';
+export * from './itemResourceTarget.js';
+export * from './itemResourceTool.js';
+export * from './itemResourceType.js';
+export * from './listBindingsParams.js';
+export * from './listChannelRejectionsParams.js';
+export * from './listChannelsParams.js';
+export * from './listThreadsParams.js';
+export * from './loginResource.js';
+export * from './modelListResponseBody.js';
+export * from './modelListResponseBodyModels.js';
+export * from './modelResource.js';
+export * from './modelResourceInputModalities.js';
+export * from './modelResourceReasoningTiers.js';
+export * from './platformListResponseBody.js';
+export * from './platformListResponseBodyPlatforms.js';
+export * from './platformResource.js';
+export * from './platformResourceWebhookUrlTemplate.js';
+export * from './question.js';
+export * from './questionChoices.js';
+export * from './rejectionListResponseBody.js';
+export * from './rejectionListResponseBodyRejections.js';
+export * from './revertRequestBody.js';
+export * from './revertedCountResponseBody.js';
+export * from './sendMessageRequestBody.js';
+export * from './sendMessageRequestBodyAttachmentIds.js';
+export * from './streamResource.js';
+export * from './threadListResponseBody.js';
+export * from './threadListResponseBodyThreads.js';
+export * from './threadSummaryResource.js';
+export * from './threadSummaryResourceApprovalMode.js';
+export * from './threadSummaryResourceTitle.js';
+export * from './turnIDResponseBody.js';
+export * from './turnResource.js';
+export * from './turnResourceApprovalMode.js';
+export * from './updateChannelRequestBody.js';
+export * from './updateChannelRequestBodyCredentials.js';
+export * from './updateThreadRequestBody.js';
+export * from './updateThreadRequestBodyApprovalMode.js';
+export * from './uploadedResource.js';
+export * from './verifyCodeRequestBody.js';
+export * from './waitResource.js';
+export * from './waitResourceItemIds.js';
+export * from './waitResourceKind.js';
+export * from './waitResourceQuestions.js';
+export * from './webhookSecretResponseBody.js';

package/dist/generated/assistant/models/itemResource.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow Assistant 用户 API
+ * 控制台里的 AI 助手：对话、消息、工具调用与审批、附件，以及把助手接到微信、飞书、Telegram 等即时通讯平台上。
+
+## 一次对话
+
+1. `POST /v1/threads` 创建对话；
+2. `POST /v1/threads/{thread}/messages` 发送消息，立即返回 `turnId`，助手的执行在后台进行；
+3. `GET /v1/threads/{thread}` 取回对话文档用于渲染，并按其中的 `stream` 连上实时输出；
+4. 助手需要用户参与时，文档中的 `wait` 会说明是哪一种：审批一批工具调用（`POST /v1/threads/{thread}/approvals/{batch}`），或回答几个问题（`POST /v1/threads/{thread}/questions/{item}`）。处理完成后助手自动继续。
+
+发送图片分两步：先 `POST /v1/attachments` 上传拿到 id，发送消息时放进 `attachmentIds`。
+
+## 实时输出
+
+```
+GET /v1/turns/{turn}/stream?ticket=<ticket>&cursor=<cursor>
+```
+
+这是一条 Server-Sent Events 流，因此不在下方的接口列表中。
+
+- `path` 与 `ticket` 都取自对话文档的 `stream`。`path` 是相对路径，按取回文档的地址解析；
+- `cursor` 是起始位置，取自对话文档的 `cursor`。不传则从可用范围的开头开始；
+- 推送的每一条都是对那份对话文档的一次增量编辑，套用同一套渲染逻辑即可；
+- 连接有生存期，到时会正常关闭。使用 `EventSource` 时浏览器会自动携带 `Last-Event-ID` 重连并从断点续传，无需额外处理；
+- 三种结束事件：`done` 本次 turn 完成（附带最终状态）、`paused` 助手在等待用户处理（重新取回对话文档读 `wait`）、`stalled` 执行已中断且不会恢复，不要重连。
+ * OpenAPI spec version: 1.0.0
+ */
+import type { ItemResourceApproval } from './itemResourceApproval.js';
+import type { ItemResourceApprovalReason } from './itemResourceApprovalReason.js';
+import type { ItemResourceAttachments } from './itemResourceAttachments.js';
+import type { ItemResourceDetail } from './itemResourceDetail.js';
+import type { ItemResourceDurationMs } from './itemResourceDurationMs.js';
+import type { ItemResourceModel } from './itemResourceModel.js';
+import type { ItemResourceNamespace } from './itemResourceNamespace.js';
+import type { ItemResourceStatus } from './itemResourceStatus.js';
+import type { ItemResourceTarget } from './itemResourceTarget.js';
+import type { ItemResourceTool } from './itemResourceTool.js';
+import type { ItemResourceType } from './itemResourceType.js';
+export interface ItemResource {
+    approval?: ItemResourceApproval;
+    approvalReason?: ItemResourceApprovalReason;
+    arguments?: string;
+    attachments?: ItemResourceAttachments;
+    createdAt: string;
+    detail?: ItemResourceDetail;
+    durationMs?: ItemResourceDurationMs;
+    id: string;
+    /** 产出这一条的模型。用户自己发的消息为 null */
+    model: ItemResourceModel;
+    namespace?: ItemResourceNamespace;
+    ordinal: number;
+    reverted: boolean;
+    status: ItemResourceStatus;
+    target?: ItemResourceTarget;
+    text?: string;
+    tool?: ItemResourceTool;
+    /** 决定这一条包含哪些字段 */
+    type: ItemResourceType;
+}

package/dist/generated/assistant/models/itemResource.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/assistant/models/itemResourceApproval.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow Assistant 用户 API
+ * 控制台里的 AI 助手：对话、消息、工具调用与审批、附件，以及把助手接到微信、飞书、Telegram 等即时通讯平台上。
+
+## 一次对话
+
+1. `POST /v1/threads` 创建对话；
+2. `POST /v1/threads/{thread}/messages` 发送消息，立即返回 `turnId`，助手的执行在后台进行；
+3. `GET /v1/threads/{thread}` 取回对话文档用于渲染，并按其中的 `stream` 连上实时输出；
+4. 助手需要用户参与时，文档中的 `wait` 会说明是哪一种：审批一批工具调用（`POST /v1/threads/{thread}/approvals/{batch}`），或回答几个问题（`POST /v1/threads/{thread}/questions/{item}`）。处理完成后助手自动继续。
+
+发送图片分两步：先 `POST /v1/attachments` 上传拿到 id，发送消息时放进 `attachmentIds`。
+
+## 实时输出
+
+```
+GET /v1/turns/{turn}/stream?ticket=<ticket>&cursor=<cursor>
+```
+
+这是一条 Server-Sent Events 流，因此不在下方的接口列表中。
+
+- `path` 与 `ticket` 都取自对话文档的 `stream`。`path` 是相对路径，按取回文档的地址解析；
+- `cursor` 是起始位置，取自对话文档的 `cursor`。不传则从可用范围的开头开始；
+- 推送的每一条都是对那份对话文档的一次增量编辑，套用同一套渲染逻辑即可；
+- 连接有生存期，到时会正常关闭。使用 `EventSource` 时浏览器会自动携带 `Last-Event-ID` 重连并从断点续传，无需额外处理；
+- 三种结束事件：`done` 本次 turn 完成（附带最终状态）、`paused` 助手在等待用户处理（重新取回对话文档读 `wait`）、`stalled` 执行已中断且不会恢复，不要重连。
+ * OpenAPI spec version: 1.0.0
+ */
+export type ItemResourceApproval = 'approved' | 'declined' | 'auto_approved' | 'unreviewed' | null;

package/dist/generated/assistant/models/itemResourceApproval.js

@@ -0,0 +1,31 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow Assistant 用户 API
+ * 控制台里的 AI 助手：对话、消息、工具调用与审批、附件，以及把助手接到微信、飞书、Telegram 等即时通讯平台上。
+
+## 一次对话
+
+1. `POST /v1/threads` 创建对话；
+2. `POST /v1/threads/{thread}/messages` 发送消息，立即返回 `turnId`，助手的执行在后台进行；
+3. `GET /v1/threads/{thread}` 取回对话文档用于渲染，并按其中的 `stream` 连上实时输出；
+4. 助手需要用户参与时，文档中的 `wait` 会说明是哪一种：审批一批工具调用（`POST /v1/threads/{thread}/approvals/{batch}`），或回答几个问题（`POST /v1/threads/{thread}/questions/{item}`）。处理完成后助手自动继续。
+
+发送图片分两步：先 `POST /v1/attachments` 上传拿到 id，发送消息时放进 `attachmentIds`。
+
+## 实时输出
+
+```
+GET /v1/turns/{turn}/stream?ticket=<ticket>&cursor=<cursor>
+```
+
+这是一条 Server-Sent Events 流，因此不在下方的接口列表中。
+
+- `path` 与 `ticket` 都取自对话文档的 `stream`。`path` 是相对路径，按取回文档的地址解析；
+- `cursor` 是起始位置，取自对话文档的 `cursor`。不传则从可用范围的开头开始；
+- 推送的每一条都是对那份对话文档的一次增量编辑，套用同一套渲染逻辑即可；
+- 连接有生存期，到时会正常关闭。使用 `EventSource` 时浏览器会自动携带 `Last-Event-ID` 重连并从断点续传，无需额外处理；
+- 三种结束事件：`done` 本次 turn 完成（附带最终状态）、`paused` 助手在等待用户处理（重新取回对话文档读 `wait`）、`stalled` 执行已中断且不会恢复，不要重连。
+ * OpenAPI spec version: 1.0.0
+ */
+export {};

package/dist/generated/assistant/models/itemResourceApprovalReason.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow Assistant 用户 API
+ * 控制台里的 AI 助手：对话、消息、工具调用与审批、附件，以及把助手接到微信、飞书、Telegram 等即时通讯平台上。
+
+## 一次对话
+
+1. `POST /v1/threads` 创建对话；
+2. `POST /v1/threads/{thread}/messages` 发送消息，立即返回 `turnId`，助手的执行在后台进行；
+3. `GET /v1/threads/{thread}` 取回对话文档用于渲染，并按其中的 `stream` 连上实时输出；
+4. 助手需要用户参与时，文档中的 `wait` 会说明是哪一种：审批一批工具调用（`POST /v1/threads/{thread}/approvals/{batch}`），或回答几个问题（`POST /v1/threads/{thread}/questions/{item}`）。处理完成后助手自动继续。
+
+发送图片分两步：先 `POST /v1/attachments` 上传拿到 id，发送消息时放进 `attachmentIds`。
+
+## 实时输出
+
+```
+GET /v1/turns/{turn}/stream?ticket=<ticket>&cursor=<cursor>
+```
+
+这是一条 Server-Sent Events 流，因此不在下方的接口列表中。
+
+- `path` 与 `ticket` 都取自对话文档的 `stream`。`path` 是相对路径，按取回文档的地址解析；
+- `cursor` 是起始位置，取自对话文档的 `cursor`。不传则从可用范围的开头开始；
+- 推送的每一条都是对那份对话文档的一次增量编辑，套用同一套渲染逻辑即可；
+- 连接有生存期，到时会正常关闭。使用 `EventSource` 时浏览器会自动携带 `Last-Event-ID` 重连并从断点续传，无需额外处理；
+- 三种结束事件：`done` 本次 turn 完成（附带最终状态）、`paused` 助手在等待用户处理（重新取回对话文档读 `wait`）、`stalled` 执行已中断且不会恢复，不要重连。
+ * OpenAPI spec version: 1.0.0
+ */
+export type ItemResourceApprovalReason = string | null;

package/dist/generated/assistant/models/itemResourceApprovalReason.js

@@ -0,0 +1,31 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow Assistant 用户 API
+ * 控制台里的 AI 助手：对话、消息、工具调用与审批、附件，以及把助手接到微信、飞书、Telegram 等即时通讯平台上。
+
+## 一次对话
+
+1. `POST /v1/threads` 创建对话；
+2. `POST /v1/threads/{thread}/messages` 发送消息，立即返回 `turnId`，助手的执行在后台进行；
+3. `GET /v1/threads/{thread}` 取回对话文档用于渲染，并按其中的 `stream` 连上实时输出；
+4. 助手需要用户参与时，文档中的 `wait` 会说明是哪一种：审批一批工具调用（`POST /v1/threads/{thread}/approvals/{batch}`），或回答几个问题（`POST /v1/threads/{thread}/questions/{item}`）。处理完成后助手自动继续。
+
+发送图片分两步：先 `POST /v1/attachments` 上传拿到 id，发送消息时放进 `attachmentIds`。
+
+## 实时输出
+
+```
+GET /v1/turns/{turn}/stream?ticket=<ticket>&cursor=<cursor>
+```
+
+这是一条 Server-Sent Events 流，因此不在下方的接口列表中。
+
+- `path` 与 `ticket` 都取自对话文档的 `stream`。`path` 是相对路径，按取回文档的地址解析；
+- `cursor` 是起始位置，取自对话文档的 `cursor`。不传则从可用范围的开头开始；
+- 推送的每一条都是对那份对话文档的一次增量编辑，套用同一套渲染逻辑即可；
+- 连接有生存期，到时会正常关闭。使用 `EventSource` 时浏览器会自动携带 `Last-Event-ID` 重连并从断点续传，无需额外处理；
+- 三种结束事件：`done` 本次 turn 完成（附带最终状态）、`paused` 助手在等待用户处理（重新取回对话文档读 `wait`）、`stalled` 执行已中断且不会恢复，不要重连。
+ * OpenAPI spec version: 1.0.0
+ */
+export {};