@leaflow/sdk 0.1.2 → 0.2.0

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

@@ -2,30 +2,38 @@
  * 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
  */
-import type { AnswerInputBody, ChannelView, ClaimCodeOutputBody, CreateChannelInputBody, CreateThreadInputBody, DecideInputBody, DocumentView, ListBindingsOutputBody, ListBindingsParams, ListChannelRejectionsParams, ListChannelsOutputBody, ListChannelsParams, ListModelsOutputBody, ListPlatformsOutputBody, ListRejectionsOutputBody, ListThreadsOutputBody, ListThreadsParams, LoginView, RevertInputBody, RevertOutputBody, RotateSecretOutputBody, SendMessageInputBody, SendMessageOutputBody, ThreadSummaryView, UpdateChannelInputBody, UpdateThreadInputBody, UploadedView, VerifyCodeInputBody } from './models';
+import type { AnswerRequestBody, BindingListResponseBody, ChannelListResponseBody, ChannelResource, ClaimCodeResponseBody, CreateChannelRequestBody, CreateThreadRequestBody, DecideRequestBody, DocumentResource, ListBindingsParams, ListChannelRejectionsParams, ListChannelsParams, ListThreadsParams, LoginResource, ModelListResponseBody, PlatformListResponseBody, RejectionListResponseBody, RevertRequestBody, RevertedCountResponseBody, SendMessageRequestBody, ThreadListResponseBody, ThreadSummaryResource, TurnIDResponseBody, UpdateChannelRequestBody, UpdateThreadRequestBody, UploadedResource, VerifyCodeRequestBody, WebhookSecretResponseBody } from './models/index.js';
 /**
 * 请求体直接是文件字节，不使用 multipart 封装，一次上传一个文件。类型由内容判定，与 Content-Type 无关。返回的 id 在发送消息时放进 attachmentIds；从未被任何消息引用的附件会被定期清除。
 * @summary 上传图片
 */
-export declare const uploadAttachment: (uploadAttachmentBody: Blob) => Promise<UploadedView>;
+export declare const uploadAttachment: (uploadAttachmentBody: Blob) => Promise<UploadedResource>;
 /**
  * 按附件 id 取回原始字节，可直接作为 <img> 的地址使用。响应带长期缓存头，附件内容不会变化。附件不存在或不属于当前用户时返回 404。
  * @summary 取回图片
@@ -34,7 +42,7 @@ export declare const downloadAttachment: (attachment: string) => Promise<void>;
 /**
  * @summary 列出绑定
  */
-export declare const listBindings: (params?: ListBindingsParams) => Promise<ListBindingsOutputBody>;
+export declare const listBindings: (params?: ListBindingsParams) => Promise<BindingListResponseBody>;
 /**
  * @summary 解除绑定
  */
@@ -42,11 +50,11 @@ export declare const deleteBinding: (binding: string) => Promise<void>;
 /**
  * @summary 列出通道
  */
-export declare const listChannels: (params?: ListChannelsParams) => Promise<ListChannelsOutputBody>;
+export declare const listChannels: (params?: ListChannelsParams) => Promise<ChannelListResponseBody>;
 /**
  * @summary 创建通道
  */
-export declare const createChannel: (createChannelInputBody: CreateChannelInputBody) => Promise<ChannelView>;
+export declare const createChannel: (createChannelRequestBody: CreateChannelRequestBody) => Promise<ChannelResource>;
 /**
  * 删除后该通道不再接收入站消息，其上的绑定一并失效。项目处于停服或清理状态时本接口仍然可用。
  * @summary 删除通道
@@ -55,64 +63,64 @@ export declare const deleteChannel: (channel: string) => Promise<void>;
 /**
  * @summary 查看通道
  */
-export declare const getChannel: (channel: string) => Promise<ChannelView>;
+export declare const getChannel: (channel: string) => Promise<ChannelResource>;
 /**
  * @summary 修改通道
  */
-export declare const updateChannel: (channel: string, updateChannelInputBody: UpdateChannelInputBody) => Promise<ChannelView>;
+export declare const updateChannel: (channel: string, updateChannelRequestBody: UpdateChannelRequestBody) => Promise<ChannelResource>;
 /**
  * 生成一个一次性认领码交给待绑定的人，他在该平台上用自己的账号把这个码发给助手即完成绑定。绑定只能由本人以这种方式建立，不能直接指定平台账号。认领码有有效期，过期后需重新签发。
  * @summary 签发认领码
  */
-export declare const createClaimCode: (channel: string) => Promise<ClaimCodeOutputBody>;
+export declare const createClaimCode: (channel: string) => Promise<ClaimCodeResponseBody>;
 /**
  * 排查「发了消息但助手没有响应」时使用。按时间倒序返回最近被这条通道拒绝的入站消息及其拒绝原因，最常见的原因是发送方尚未绑定。
  * @summary 查看最近被拒绝的入站消息
  */
-export declare const listChannelRejections: (channel: string, params?: ListChannelRejectionsParams) => Promise<ListRejectionsOutputBody>;
+export declare const listChannelRejections: (channel: string, params?: ListChannelRejectionsParams) => Promise<RejectionListResponseBody>;
 /**
  * 生成新的回调密钥并立即使旧密钥失效。新密钥仅在本次响应中返回，之后无法再次取回，请先在平台侧完成配置。
  * @summary 轮换回调密钥
  */
-export declare const rotateChannelSecret: (channel: string) => Promise<RotateSecretOutputBody>;
+export declare const rotateChannelSecret: (channel: string) => Promise<WebhookSecretResponseBody>;
 /**
  * 微信个人号通道需要本人扫码登录后才能收发消息。本接口返回二维码，之后轮询 `GET /v1/weixin-logins/{login}` 获取进度；状态提示需要验证码时，调用 `POST /v1/weixin-logins/{login}/verify-code` 补交。
  * @summary 发起微信扫码登录
  */
-export declare const beginWeixinLogin: (channel: string) => Promise<LoginView>;
+export declare const beginWeixinLogin: (channel: string) => Promise<LoginResource>;
 /**
- * 返回本平台当前提供的模型及其上下文窗口、推理档位和支持的输入类型。用于填充对话设置里的模型选择。清单与项目无关，但仍需要有效的项目令牌。
+ * 返回本平台当前提供的模型及其上下文窗口、推理档位和支持的输入类型。用于填充对话设置里的模型选择。
  * @summary 列出可用模型
  */
-export declare const listModels: () => Promise<ListModelsOutputBody>;
+export declare const listModels: () => Promise<ModelListResponseBody>;
 /**
  * 返回本平台当前支持接入的即时通讯平台，以及各自建通道时需要提供的凭据字段。用于填充新建通道表单。
  * @summary 列出可接入的平台
  */
-export declare const listPlatforms: () => Promise<ListPlatformsOutputBody>;
+export declare const listPlatforms: () => Promise<PlatformListResponseBody>;
 /**
  * @summary 列出对话
  */
-export declare const listThreads: (params?: ListThreadsParams) => Promise<ListThreadsOutputBody>;
+export declare const listThreads: (params?: ListThreadsParams) => Promise<ThreadListResponseBody>;
 /**
  * @summary 创建对话
  */
-export declare const createThread: (createThreadInputBody: CreateThreadInputBody) => Promise<ThreadSummaryView>;
+export declare const createThread: (createThreadRequestBody: CreateThreadRequestBody) => Promise<ThreadSummaryResource>;
 /**
  * 对话的完整当前状态，用于首屏渲染。文档中的 stream 给出实时输出地址和入场票据，流推送的是对这份文档的增量编辑，可直接套用同一套渲染逻辑。
  * @summary 取回对话文档
  */
-export declare const getThread: (thread: string) => Promise<DocumentView>;
+export declare const getThread: (thread: string) => Promise<DocumentResource>;
 /**
  * 可修改模型、推理档位、审批模式和归档状态。改动从下一次 turn 起生效，正在执行的 turn 沿用它启动时的设置。reasoningEffort 仅在同时提供 model 时生效。
  * @summary 修改对话设置
  */
-export declare const updateThread: (thread: string, updateThreadInputBody: UpdateThreadInputBody) => Promise<ThreadSummaryView>;
+export declare const updateThread: (thread: string, updateThreadRequestBody: UpdateThreadRequestBody) => Promise<ThreadSummaryResource>;
 /**
  * 批次 id 来自对话文档的 wait 字段。本接口是幂等的：重复提交同一批次不会改变已经生效的决定，也不会报错。批次不属于该对话时返回 404。
  * @summary 批准或拒绝一批工具调用
  */
-export declare const decideApproval: (thread: string, batch: string, decideInputBody: DecideInputBody) => Promise<void>;
+export declare const decideApproval: (thread: string, batch: string, decideRequestBody: DecideRequestBody) => Promise<void>;
 /**
  * 对没有正在执行的 turn 的对话调用同样返回 204，不视为错误——用户点击停止与 turn 自然结束之间存在竞争，两种结果一致。项目处于停服或清理状态时本接口仍然可用。
  * @summary 中断正在执行的 turn
@@ -122,12 +130,12 @@ export declare const interruptThread: (thread: string) => Promise<void>;
  * 立即返回 turnId，不等待执行完成——一次 turn 可能持续数十分钟。执行进度通过对话文档中 stream 指向的实时流获取，不在本响应里。
  * @summary 发送消息并触发一次 turn
  */
-export declare const sendMessage: (thread: string, sendMessageInputBody: SendMessageInputBody) => Promise<SendMessageOutputBody>;
+export declare const sendMessage: (thread: string, sendMessageRequestBody: SendMessageRequestBody) => Promise<TurnIDResponseBody>;
 /**
  * 问题 id 来自对话文档的 wait 字段。已被回答过的问题同样返回 204——可能是另一个页面提交在先，也可能是自动应答窗口已到期，两种情况下 turn 都已带着答案继续执行。
  * @summary 回答助手提出的问题
  */
-export declare const answerQuestion: (thread: string, item: string, answerInputBody: AnswerInputBody) => Promise<void>;
+export declare const answerQuestion: (thread: string, item: string, answerRequestBody: AnswerRequestBody) => Promise<void>;
 /**
  * @summary 标记对话已读
  */
@@ -136,17 +144,17 @@ export declare const markThreadRead: (thread: string) => Promise<void>;
  * 撤回 ordinal 及其之后的全部条目。被撤回的条目仍留在逐字稿中并标记 reverted，序号不会重排。返回实际撤回的条目数。
  * @summary 从指定位置起撤回
  */
-export declare const revertThread: (thread: string, revertInputBody: RevertInputBody) => Promise<RevertOutputBody>;
+export declare const revertThread: (thread: string, revertRequestBody: RevertRequestBody) => Promise<RevertedCountResponseBody>;
 /**
  * 轮询本接口直到状态变为成功或失败。状态提示需要验证码时，调用补交验证码接口。
  * @summary 查询扫码登录状态
  */
-export declare const getWeixinLogin: (login: string) => Promise<LoginView>;
+export declare const getWeixinLogin: (login: string) => Promise<LoginResource>;
 /**
  * 微信在扫码后要求短信或设备验证码时使用。验证码由登录发起人在自己手机上获取。
  * @summary 补交登录验证码
  */
-export declare const submitWeixinVerifyCode: (login: string, verifyCodeInputBody: VerifyCodeInputBody) => Promise<LoginView>;
+export declare const submitWeixinVerifyCode: (login: string, verifyCodeRequestBody: VerifyCodeRequestBody) => Promise<LoginResource>;
 export type UploadAttachmentResult = NonNullable<Awaited<ReturnType<typeof uploadAttachment>>>;
 export type DownloadAttachmentResult = NonNullable<Awaited<ReturnType<typeof downloadAttachment>>>;
 export type ListBindingsResult = NonNullable<Awaited<ReturnType<typeof listBindings>>>;

package/dist/generated/assistant/index.js

@@ -1,4 +1,4 @@
-import { request } from '../../http';
+import { request } from '../../http.js';
 /**
 * 请求体直接是文件字节，不使用 multipart 封装，一次上传一个文件。类型由内容判定，与 Content-Type 无关。返回的 id 在发送消息时放进 attachmentIds；从未被任何消息引用的附件会被定期清除。
 * @summary 上传图片
@@ -43,10 +43,10 @@ export const listChannels = (params) => {
 /**
  * @summary 创建通道
  */
-export const createChannel = (createChannelInputBody) => {
+export const createChannel = (createChannelRequestBody) => {
     return request({ url: `/v1/channels`, method: 'POST',
         headers: { 'Content-Type': 'application/json', },
-        data: createChannelInputBody
+        data: createChannelRequestBody
     });
 };
 /**
@@ -67,10 +67,10 @@ export const getChannel = (channel) => {
 /**
  * @summary 修改通道
  */
-export const updateChannel = (channel, updateChannelInputBody) => {
+export const updateChannel = (channel, updateChannelRequestBody) => {
     return request({ url: `/v1/channels/${channel}`, method: 'PATCH',
         headers: { 'Content-Type': 'application/json', },
-        data: updateChannelInputBody
+        data: updateChannelRequestBody
     });
 };
 /**
@@ -107,7 +107,7 @@ export const beginWeixinLogin = (channel) => {
     });
 };
 /**
- * 返回本平台当前提供的模型及其上下文窗口、推理档位和支持的输入类型。用于填充对话设置里的模型选择。清单与项目无关，但仍需要有效的项目令牌。
+ * 返回本平台当前提供的模型及其上下文窗口、推理档位和支持的输入类型。用于填充对话设置里的模型选择。
  * @summary 列出可用模型
  */
 export const listModels = () => {
@@ -133,10 +133,10 @@ export const listThreads = (params) => {
 /**
  * @summary 创建对话
  */
-export const createThread = (createThreadInputBody) => {
+export const createThread = (createThreadRequestBody) => {
     return request({ url: `/v1/threads`, method: 'POST',
         headers: { 'Content-Type': 'application/json', },
-        data: createThreadInputBody
+        data: createThreadRequestBody
     });
 };
 /**
@@ -151,20 +151,20 @@ export const getThread = (thread) => {
  * 可修改模型、推理档位、审批模式和归档状态。改动从下一次 turn 起生效，正在执行的 turn 沿用它启动时的设置。reasoningEffort 仅在同时提供 model 时生效。
  * @summary 修改对话设置
  */
-export const updateThread = (thread, updateThreadInputBody) => {
+export const updateThread = (thread, updateThreadRequestBody) => {
     return request({ url: `/v1/threads/${thread}`, method: 'PATCH',
         headers: { 'Content-Type': 'application/json', },
-        data: updateThreadInputBody
+        data: updateThreadRequestBody
     });
 };
 /**
  * 批次 id 来自对话文档的 wait 字段。本接口是幂等的：重复提交同一批次不会改变已经生效的决定，也不会报错。批次不属于该对话时返回 404。
  * @summary 批准或拒绝一批工具调用
  */
-export const decideApproval = (thread, batch, decideInputBody) => {
+export const decideApproval = (thread, batch, decideRequestBody) => {
     return request({ url: `/v1/threads/${thread}/approvals/${batch}`, method: 'POST',
         headers: { 'Content-Type': 'application/json', },
-        data: decideInputBody
+        data: decideRequestBody
     });
 };
 /**
@@ -179,20 +179,20 @@ export const interruptThread = (thread) => {
  * 立即返回 turnId，不等待执行完成——一次 turn 可能持续数十分钟。执行进度通过对话文档中 stream 指向的实时流获取，不在本响应里。
  * @summary 发送消息并触发一次 turn
  */
-export const sendMessage = (thread, sendMessageInputBody) => {
+export const sendMessage = (thread, sendMessageRequestBody) => {
     return request({ url: `/v1/threads/${thread}/messages`, method: 'POST',
         headers: { 'Content-Type': 'application/json', },
-        data: sendMessageInputBody
+        data: sendMessageRequestBody
     });
 };
 /**
  * 问题 id 来自对话文档的 wait 字段。已被回答过的问题同样返回 204——可能是另一个页面提交在先，也可能是自动应答窗口已到期，两种情况下 turn 都已带着答案继续执行。
  * @summary 回答助手提出的问题
  */
-export const answerQuestion = (thread, item, answerInputBody) => {
+export const answerQuestion = (thread, item, answerRequestBody) => {
     return request({ url: `/v1/threads/${thread}/questions/${item}`, method: 'POST',
         headers: { 'Content-Type': 'application/json', },
-        data: answerInputBody
+        data: answerRequestBody
     });
 };
 /**
@@ -206,10 +206,10 @@ export const markThreadRead = (thread) => {
  * 撤回 ordinal 及其之后的全部条目。被撤回的条目仍留在逐字稿中并标记 reverted，序号不会重排。返回实际撤回的条目数。
  * @summary 从指定位置起撤回
  */
-export const revertThread = (thread, revertInputBody) => {
+export const revertThread = (thread, revertRequestBody) => {
     return request({ url: `/v1/threads/${thread}/revert`, method: 'POST',
         headers: { 'Content-Type': 'application/json', },
-        data: revertInputBody
+        data: revertRequestBody
     });
 };
 /**
@@ -224,9 +224,9 @@ export const getWeixinLogin = (login) => {
  * 微信在扫码后要求短信或设备验证码时使用。验证码由登录发起人在自己手机上获取。
  * @summary 补交登录验证码
  */
-export const submitWeixinVerifyCode = (login, verifyCodeInputBody) => {
+export const submitWeixinVerifyCode = (login, verifyCodeRequestBody) => {
     return request({ url: `/v1/weixin-logins/${login}/verify-code`, method: 'POST',
         headers: { 'Content-Type': 'application/json', },
-        data: verifyCodeInputBody
+        data: verifyCodeRequestBody
     });
 };

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

@@ -20,7 +20,7 @@
 图片分两步发送：先 `POST /v1/attachments` 取得附件 id，再在发送消息时放进 `attachmentIds`。
  * OpenAPI spec version: 1.0.0
  */
-import type { AnswerInputBodyAnswers } from './answerInputBodyAnswers';
+import type { AnswerInputBodyAnswers } from './answerInputBodyAnswers.js';
 export interface AnswerInputBody {
     /** 问题 id 到所选答案的映射 */
     answers: AnswerInputBodyAnswers;

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

@@ -0,0 +1,35 @@
+/**
+ * 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 { AnswerRequestBodyAnswers } from './answerRequestBodyAnswers.js';
+export interface AnswerRequestBody {
+    /** 问题 id 到所选答案的映射 */
+    answers: AnswerRequestBodyAnswers;
+}

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

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

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

@@ -0,0 +1,36 @@
+/**
+ * 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
+ */
+/**
+ * 问题 id 到所选答案的映射
+ */
+export type AnswerRequestBodyAnswers = {
+    [key: string]: string;
+};

package/dist/generated/assistant/models/answerRequestBodyAnswers.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/attachmentResource.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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 interface AttachmentResource {
+    height: number;
+    id: string;
+    width: number;
+}

package/dist/generated/assistant/models/attachmentResource.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/bindingListResponseBody.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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 { BindingListResponseBodyBindings } from './bindingListResponseBodyBindings.js';
+export interface BindingListResponseBody {
+    bindings: BindingListResponseBodyBindings;
+    total: number;
+}

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * 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 { BindingResource } from './bindingResource.js';
+export type BindingListResponseBodyBindings = BindingResource[] | null;

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

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

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

@@ -0,0 +1,40 @@
+/**
+ * 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 { BindingResourceVerifiedAt } from './bindingResourceVerifiedAt.js';
+export interface BindingResource {
+    channelId: string;
+    createdAt: string;
+    id: string;
+    peerName: string;
+    platform: string;
+    status: string;
+    verifiedAt: BindingResourceVerifiedAt;
+}

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

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