@leaflow/sdk 0.1.3 → 0.3.0

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

@@ -2,155 +2,183 @@
  * 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/index.js';
+import type { AnswerRequestBody, BindingResource, ChannelResource, CheckSenderParams, ClaimCodeResponseBody, CreateChannelRequestBody, CreateThreadRequestBody, DecideRequestBody, DocumentResource, EarlierResponseBody, LengthAwarePageBindingResource, LengthAwarePageChannelResource, ListBindingsParams, ListChannelRejectionsParams, ListChannelsParams, ListEarlierItemsParams, ListThreadsParams, LoginResource, ModelListResponseBody, PlatformListResponseBody, RejectionListResponseBody, RevertRequestBody, RevertedCountResponseBody, RotateSecretRequestBody, SendMessageRequestBody, SenderCheckResource, ThreadListResponseBody, ThreadSummaryResource, TurnIDResponseBody, UpdateChannelRequestBody, UpdateThreadRequestBody, UploadedResource, VerifyCodeRequestBody, WebhookSecretResponseBody } from './models/index.js';
+import { request } from '../../http.js';
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 /**
 * 请求体直接是文件字节，不使用 multipart 封装，一次上传一个文件。类型由内容判定，与 Content-Type 无关。返回的 id 在发送消息时放进 attachmentIds；从未被任何消息引用的附件会被定期清除。
 * @summary 上传图片
 */
-export declare const uploadAttachment: (uploadAttachmentBody: Blob) => Promise<UploadedView>;
+export declare const uploadAttachment: (uploadAttachmentBody: Blob, options?: SecondParameter<typeof request<UploadedResource>>) => Promise<UploadedResource>;
 /**
  * 按附件 id 取回原始字节，可直接作为 <img> 的地址使用。响应带长期缓存头，附件内容不会变化。附件不存在或不属于当前用户时返回 404。
  * @summary 取回图片
  */
-export declare const downloadAttachment: (attachment: string) => Promise<void>;
+export declare const downloadAttachment: (attachment: string, options?: SecondParameter<typeof request<void>>) => Promise<void>;
 /**
+ * 接入面那张表按通道列出各自绑了谁时用 channelId 过滤。
  * @summary 列出绑定
  */
-export declare const listBindings: (params?: ListBindingsParams) => Promise<ListBindingsOutputBody>;
+export declare const listBindings: (params?: ListBindingsParams, options?: SecondParameter<typeof request<LengthAwarePageBindingResource>>) => Promise<LengthAwarePageBindingResource>;
 /**
  * @summary 解除绑定
  */
-export declare const deleteBinding: (binding: string) => Promise<void>;
+export declare const deleteBinding: (binding: string, options?: SecondParameter<typeof request<void>>) => Promise<void>;
+/**
+ * @summary 查看绑定
+ */
+export declare const getBinding: (binding: string, options?: SecondParameter<typeof request<BindingResource>>) => Promise<BindingResource>;
 /**
  * @summary 列出通道
  */
-export declare const listChannels: (params?: ListChannelsParams) => Promise<ListChannelsOutputBody>;
+export declare const listChannels: (params?: ListChannelsParams, options?: SecondParameter<typeof request<LengthAwarePageChannelResource>>) => Promise<LengthAwarePageChannelResource>;
 /**
  * @summary 创建通道
  */
-export declare const createChannel: (createChannelInputBody: CreateChannelInputBody) => Promise<ChannelView>;
+export declare const createChannel: (createChannelRequestBody: CreateChannelRequestBody, options?: SecondParameter<typeof request<ChannelResource>>) => Promise<ChannelResource>;
 /**
  * 删除后该通道不再接收入站消息，其上的绑定一并失效。项目处于停服或清理状态时本接口仍然可用。
  * @summary 删除通道
  */
-export declare const deleteChannel: (channel: string) => Promise<void>;
+export declare const deleteChannel: (channel: string, options?: SecondParameter<typeof request<void>>) => Promise<void>;
 /**
  * @summary 查看通道
  */
-export declare const getChannel: (channel: string) => Promise<ChannelView>;
+export declare const getChannel: (channel: string, options?: SecondParameter<typeof request<ChannelResource>>) => Promise<ChannelResource>;
 /**
+ * 只修改传了的字段。senderPolicy 与 allowFrom 是一对，由 senderPolicy 决定是否替换；改动对常驻连接要等连接重建后才生效，回调型平台立即生效。
  * @summary 修改通道
  */
-export declare const updateChannel: (channel: string, updateChannelInputBody: UpdateChannelInputBody) => Promise<ChannelView>;
+export declare const updateChannel: (channel: string, updateChannelRequestBody: UpdateChannelRequestBody, options?: SecondParameter<typeof request<ChannelResource>>) => Promise<ChannelResource>;
 /**
  * 生成一个一次性认领码交给待绑定的人，他在该平台上用自己的账号把这个码发给助手即完成绑定。绑定只能由本人以这种方式建立，不能直接指定平台账号。认领码有有效期，过期后需重新签发。
  * @summary 签发认领码
  */
-export declare const createClaimCode: (channel: string) => Promise<ClaimCodeOutputBody>;
+export declare const createClaimCode: (channel: string, options?: SecondParameter<typeof request<ClaimCodeResponseBody>>) => Promise<ClaimCodeResponseBody>;
 /**
  * 排查「发了消息但助手没有响应」时使用。按时间倒序返回最近被这条通道拒绝的入站消息及其拒绝原因，最常见的原因是发送方尚未绑定。
  * @summary 查看最近被拒绝的入站消息
  */
-export declare const listChannelRejections: (channel: string, params?: ListChannelRejectionsParams) => Promise<ListRejectionsOutputBody>;
+export declare const listChannelRejections: (channel: string, params?: ListChannelRejectionsParams, options?: SecondParameter<typeof request<RejectionListResponseBody>>) => Promise<RejectionListResponseBody>;
 /**
- * 生成新的回调密钥并立即使旧密钥失效。新密钥仅在本次响应中返回，之后无法再次取回，请先在平台侧完成配置。
+ * 换一把新的回调密钥，旧的立即失效，通道降回待平台确认状态。密钥归谁定由平台决定，见 list-platforms 的 secretSource：generated 的平台不要传请求体，新密钥仅在本次响应中返回、之后无法再次取回；supplied 的平台必须把平台后台那把新密钥传进来。
  * @summary 轮换回调密钥
  */
-export declare const rotateChannelSecret: (channel: string) => Promise<RotateSecretOutputBody>;
+export declare const rotateChannelSecret: (channel: string, rotateSecretRequestBody: RotateSecretRequestBody, options?: SecondParameter<typeof request<WebhookSecretResponseBody>>) => Promise<WebhookSecretResponseBody>;
+/**
+ * 改完发件人策略之后用来自查，不发送任何消息、也不改变任何状态：它走的是和真实入站完全相同的那份判定，并说明结论由哪一条规则得出。无法推演认领码那一条——是否是认领码取决于对方发来的内容。
+ * @summary 推演一个发件人会不会被放行
+ */
+export declare const checkSender: (channel: string, params: CheckSenderParams, options?: SecondParameter<typeof request<SenderCheckResource>>) => Promise<SenderCheckResource>;
 /**
  * 微信个人号通道需要本人扫码登录后才能收发消息。本接口返回二维码，之后轮询 `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, options?: SecondParameter<typeof request<LoginResource>>) => Promise<LoginResource>;
 /**
- * 返回本平台当前提供的模型及其上下文窗口、推理档位和支持的输入类型。用于填充对话设置里的模型选择。清单与项目无关，但仍需要有效的项目令牌。
+ * 返回本平台当前提供的模型及其上下文窗口、推理档位和支持的输入类型。用于填充对话设置里的模型选择。
  * @summary 列出可用模型
  */
-export declare const listModels: () => Promise<ListModelsOutputBody>;
+export declare const listModels: (options?: SecondParameter<typeof request<ModelListResponseBody>>) => Promise<ModelListResponseBody>;
 /**
- * 返回本平台当前支持接入的即时通讯平台，以及各自建通道时需要提供的凭据字段。用于填充新建通道表单。
+ * 返回本平台当前支持接入的即时通讯平台，以及各自建通道时要走的流程和要填的凭据字段。新建通道表单完全由这份响应驱动：setupMethod 决定展示录入表单还是扫码流程，credentialFields 是要填的字段，secretSource 决定要不要有回调密钥那一栏。
  * @summary 列出可接入的平台
  */
-export declare const listPlatforms: () => Promise<ListPlatformsOutputBody>;
+export declare const listPlatforms: (options?: SecondParameter<typeof request<PlatformListResponseBody>>) => Promise<PlatformListResponseBody>;
 /**
+ * 按最近活动排序，只返回当前账号在当前项目里的对话。archived 是一个二选一的开关而不是「包含归档」：归档的对话不出现在默认列表里，要看它们就把这个参数打开。
  * @summary 列出对话
  */
-export declare const listThreads: (params?: ListThreadsParams) => Promise<ListThreadsOutputBody>;
+export declare const listThreads: (params?: ListThreadsParams, options?: SecondParameter<typeof request<ThreadListResponseBody>>) => Promise<ThreadListResponseBody>;
 /**
  * @summary 创建对话
  */
-export declare const createThread: (createThreadInputBody: CreateThreadInputBody) => Promise<ThreadSummaryView>;
+export declare const createThread: (createThreadRequestBody: CreateThreadRequestBody, options?: SecondParameter<typeof request<ThreadSummaryResource>>) => Promise<ThreadSummaryResource>;
 /**
  * 对话的完整当前状态，用于首屏渲染。文档中的 stream 给出实时输出地址和入场票据，流推送的是对这份文档的增量编辑，可直接套用同一套渲染逻辑。
  * @summary 取回对话文档
  */
-export declare const getThread: (thread: string) => Promise<DocumentView>;
+export declare const getThread: (thread: string, options?: SecondParameter<typeof request<DocumentResource>>) => 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, options?: SecondParameter<typeof request<ThreadSummaryResource>>) => 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, options?: SecondParameter<typeof request<void>>) => Promise<void>;
+/**
+ * 首屏只给对话最新的那一段，再往上的内容用本接口按需取回，一次一段。before 用文档里的 earlier.before，响应里的 earlier 是再往上那一段的游标，为 null 表示已经到顶。返回的条目和文档里的 items 是同一种形状，顺序也一样（由旧到新），直接接在现有内容前面即可。
+ * @summary 取回更早的对话内容
+ */
+export declare const listEarlierItems: (thread: string, params: ListEarlierItemsParams, options?: SecondParameter<typeof request<EarlierResponseBody>>) => Promise<EarlierResponseBody>;
 /**
  * 对没有正在执行的 turn 的对话调用同样返回 204，不视为错误——用户点击停止与 turn 自然结束之间存在竞争，两种结果一致。项目处于停服或清理状态时本接口仍然可用。
  * @summary 中断正在执行的 turn
  */
-export declare const interruptThread: (thread: string) => Promise<void>;
+export declare const interruptThread: (thread: string, options?: SecondParameter<typeof request<void>>) => 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, options?: SecondParameter<typeof request<TurnIDResponseBody>>) => 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, options?: SecondParameter<typeof request<void>>) => Promise<void>;
 /**
  * @summary 标记对话已读
  */
-export declare const markThreadRead: (thread: string) => Promise<void>;
+export declare const markThreadRead: (thread: string, options?: SecondParameter<typeof request<void>>) => Promise<void>;
 /**
  * 撤回 ordinal 及其之后的全部条目。被撤回的条目仍留在逐字稿中并标记 reverted，序号不会重排。返回实际撤回的条目数。
  * @summary 从指定位置起撤回
  */
-export declare const revertThread: (thread: string, revertInputBody: RevertInputBody) => Promise<RevertOutputBody>;
+export declare const revertThread: (thread: string, revertRequestBody: RevertRequestBody, options?: SecondParameter<typeof request<RevertedCountResponseBody>>) => Promise<RevertedCountResponseBody>;
 /**
  * 轮询本接口直到状态变为成功或失败。状态提示需要验证码时，调用补交验证码接口。
  * @summary 查询扫码登录状态
  */
-export declare const getWeixinLogin: (login: string) => Promise<LoginView>;
+export declare const getWeixinLogin: (login: string, options?: SecondParameter<typeof request<LoginResource>>) => Promise<LoginResource>;
 /**
  * 微信在扫码后要求短信或设备验证码时使用。验证码由登录发起人在自己手机上获取。
  * @summary 补交登录验证码
  */
-export declare const submitWeixinVerifyCode: (login: string, verifyCodeInputBody: VerifyCodeInputBody) => Promise<LoginView>;
+export declare const submitWeixinVerifyCode: (login: string, verifyCodeRequestBody: VerifyCodeRequestBody, options?: SecondParameter<typeof request<LoginResource>>) => 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>>>;
 export type DeleteBindingResult = NonNullable<Awaited<ReturnType<typeof deleteBinding>>>;
+export type GetBindingResult = NonNullable<Awaited<ReturnType<typeof getBinding>>>;
 export type ListChannelsResult = NonNullable<Awaited<ReturnType<typeof listChannels>>>;
 export type CreateChannelResult = NonNullable<Awaited<ReturnType<typeof createChannel>>>;
 export type DeleteChannelResult = NonNullable<Awaited<ReturnType<typeof deleteChannel>>>;
@@ -159,6 +187,7 @@ export type UpdateChannelResult = NonNullable<Awaited<ReturnType<typeof updateCh
 export type CreateClaimCodeResult = NonNullable<Awaited<ReturnType<typeof createClaimCode>>>;
 export type ListChannelRejectionsResult = NonNullable<Awaited<ReturnType<typeof listChannelRejections>>>;
 export type RotateChannelSecretResult = NonNullable<Awaited<ReturnType<typeof rotateChannelSecret>>>;
+export type CheckSenderResult = NonNullable<Awaited<ReturnType<typeof checkSender>>>;
 export type BeginWeixinLoginResult = NonNullable<Awaited<ReturnType<typeof beginWeixinLogin>>>;
 export type ListModelsResult = NonNullable<Awaited<ReturnType<typeof listModels>>>;
 export type ListPlatformsResult = NonNullable<Awaited<ReturnType<typeof listPlatforms>>>;
@@ -167,6 +196,7 @@ export type CreateThreadResult = NonNullable<Awaited<ReturnType<typeof createThr
 export type GetThreadResult = NonNullable<Awaited<ReturnType<typeof getThread>>>;
 export type UpdateThreadResult = NonNullable<Awaited<ReturnType<typeof updateThread>>>;
 export type DecideApprovalResult = NonNullable<Awaited<ReturnType<typeof decideApproval>>>;
+export type ListEarlierItemsResult = NonNullable<Awaited<ReturnType<typeof listEarlierItems>>>;
 export type InterruptThreadResult = NonNullable<Awaited<ReturnType<typeof interruptThread>>>;
 export type SendMessageResult = NonNullable<Awaited<ReturnType<typeof sendMessage>>>;
 export type AnswerQuestionResult = NonNullable<Awaited<ReturnType<typeof answerQuestion>>>;
@@ -174,3 +204,4 @@ export type MarkThreadReadResult = NonNullable<Awaited<ReturnType<typeof markThr
 export type RevertThreadResult = NonNullable<Awaited<ReturnType<typeof revertThread>>>;
 export type GetWeixinLoginResult = NonNullable<Awaited<ReturnType<typeof getWeixinLogin>>>;
 export type SubmitWeixinVerifyCodeResult = NonNullable<Awaited<ReturnType<typeof submitWeixinVerifyCode>>>;
+export {};

package/dist/generated/assistant/index.js

@@ -3,230 +3,260 @@ import { request } from '../../http.js';
 * 请求体直接是文件字节，不使用 multipart 封装，一次上传一个文件。类型由内容判定，与 Content-Type 无关。返回的 id 在发送消息时放进 attachmentIds；从未被任何消息引用的附件会被定期清除。
 * @summary 上传图片
 */
-export const uploadAttachment = (uploadAttachmentBody) => {
+export const uploadAttachment = (uploadAttachmentBody, options) => {
     return request({ url: `/v1/attachments`, method: 'POST',
         headers: { 'Content-Type': 'application/octet-stream', },
         data: uploadAttachmentBody
-    });
+    }, options);
 };
 /**
  * 按附件 id 取回原始字节，可直接作为 <img> 的地址使用。响应带长期缓存头，附件内容不会变化。附件不存在或不属于当前用户时返回 404。
  * @summary 取回图片
  */
-export const downloadAttachment = (attachment) => {
+export const downloadAttachment = (attachment, options) => {
     return request({ url: `/v1/attachments/${attachment}`, method: 'GET'
-    });
+    }, options);
 };
 /**
+ * 接入面那张表按通道列出各自绑了谁时用 channelId 过滤。
  * @summary 列出绑定
  */
-export const listBindings = (params) => {
+export const listBindings = (params, options) => {
     return request({ url: `/v1/bindings`, method: 'GET',
         params
-    });
+    }, options);
 };
 /**
  * @summary 解除绑定
  */
-export const deleteBinding = (binding) => {
+export const deleteBinding = (binding, options) => {
     return request({ url: `/v1/bindings/${binding}`, method: 'DELETE'
-    });
+    }, options);
+};
+/**
+ * @summary 查看绑定
+ */
+export const getBinding = (binding, options) => {
+    return request({ url: `/v1/bindings/${binding}`, method: 'GET'
+    }, options);
 };
 /**
  * @summary 列出通道
  */
-export const listChannels = (params) => {
+export const listChannels = (params, options) => {
     return request({ url: `/v1/channels`, method: 'GET',
         params
-    });
+    }, options);
 };
 /**
  * @summary 创建通道
  */
-export const createChannel = (createChannelInputBody) => {
+export const createChannel = (createChannelRequestBody, options) => {
     return request({ url: `/v1/channels`, method: 'POST',
         headers: { 'Content-Type': 'application/json', },
-        data: createChannelInputBody
-    });
+        data: createChannelRequestBody
+    }, options);
 };
 /**
  * 删除后该通道不再接收入站消息，其上的绑定一并失效。项目处于停服或清理状态时本接口仍然可用。
  * @summary 删除通道
  */
-export const deleteChannel = (channel) => {
+export const deleteChannel = (channel, options) => {
     return request({ url: `/v1/channels/${channel}`, method: 'DELETE'
-    });
+    }, options);
 };
 /**
  * @summary 查看通道
  */
-export const getChannel = (channel) => {
+export const getChannel = (channel, options) => {
     return request({ url: `/v1/channels/${channel}`, method: 'GET'
-    });
+    }, options);
 };
 /**
+ * 只修改传了的字段。senderPolicy 与 allowFrom 是一对，由 senderPolicy 决定是否替换；改动对常驻连接要等连接重建后才生效，回调型平台立即生效。
  * @summary 修改通道
  */
-export const updateChannel = (channel, updateChannelInputBody) => {
+export const updateChannel = (channel, updateChannelRequestBody, options) => {
     return request({ url: `/v1/channels/${channel}`, method: 'PATCH',
         headers: { 'Content-Type': 'application/json', },
-        data: updateChannelInputBody
-    });
+        data: updateChannelRequestBody
+    }, options);
 };
 /**
  * 生成一个一次性认领码交给待绑定的人，他在该平台上用自己的账号把这个码发给助手即完成绑定。绑定只能由本人以这种方式建立，不能直接指定平台账号。认领码有有效期，过期后需重新签发。
  * @summary 签发认领码
  */
-export const createClaimCode = (channel) => {
+export const createClaimCode = (channel, options) => {
     return request({ url: `/v1/channels/${channel}/claim-codes`, method: 'POST'
-    });
+    }, options);
 };
 /**
  * 排查「发了消息但助手没有响应」时使用。按时间倒序返回最近被这条通道拒绝的入站消息及其拒绝原因，最常见的原因是发送方尚未绑定。
  * @summary 查看最近被拒绝的入站消息
  */
-export const listChannelRejections = (channel, params) => {
+export const listChannelRejections = (channel, params, options) => {
     return request({ url: `/v1/channels/${channel}/rejections`, method: 'GET',
         params
-    });
+    }, options);
 };
 /**
- * 生成新的回调密钥并立即使旧密钥失效。新密钥仅在本次响应中返回，之后无法再次取回，请先在平台侧完成配置。
+ * 换一把新的回调密钥，旧的立即失效，通道降回待平台确认状态。密钥归谁定由平台决定，见 list-platforms 的 secretSource：generated 的平台不要传请求体，新密钥仅在本次响应中返回、之后无法再次取回；supplied 的平台必须把平台后台那把新密钥传进来。
  * @summary 轮换回调密钥
  */
-export const rotateChannelSecret = (channel) => {
-    return request({ url: `/v1/channels/${channel}/secret`, method: 'POST'
-    });
+export const rotateChannelSecret = (channel, rotateSecretRequestBody, options) => {
+    return request({ url: `/v1/channels/${channel}/secret`, method: 'POST',
+        headers: { 'Content-Type': 'application/json', },
+        data: rotateSecretRequestBody
+    }, options);
+};
+/**
+ * 改完发件人策略之后用来自查，不发送任何消息、也不改变任何状态：它走的是和真实入站完全相同的那份判定，并说明结论由哪一条规则得出。无法推演认领码那一条——是否是认领码取决于对方发来的内容。
+ * @summary 推演一个发件人会不会被放行
+ */
+export const checkSender = (channel, params, options) => {
+    return request({ url: `/v1/channels/${channel}/sender-check`, method: 'GET',
+        params
+    }, options);
 };
 /**
  * 微信个人号通道需要本人扫码登录后才能收发消息。本接口返回二维码，之后轮询 `GET /v1/weixin-logins/{login}` 获取进度；状态提示需要验证码时，调用 `POST /v1/weixin-logins/{login}/verify-code` 补交。
  * @summary 发起微信扫码登录
  */
-export const beginWeixinLogin = (channel) => {
+export const beginWeixinLogin = (channel, options) => {
     return request({ url: `/v1/channels/${channel}/weixin-logins`, method: 'POST'
-    });
+    }, options);
 };
 /**
- * 返回本平台当前提供的模型及其上下文窗口、推理档位和支持的输入类型。用于填充对话设置里的模型选择。清单与项目无关，但仍需要有效的项目令牌。
+ * 返回本平台当前提供的模型及其上下文窗口、推理档位和支持的输入类型。用于填充对话设置里的模型选择。
  * @summary 列出可用模型
  */
-export const listModels = () => {
+export const listModels = (options) => {
     return request({ url: `/v1/models`, method: 'GET'
-    });
+    }, options);
 };
 /**
- * 返回本平台当前支持接入的即时通讯平台，以及各自建通道时需要提供的凭据字段。用于填充新建通道表单。
+ * 返回本平台当前支持接入的即时通讯平台，以及各自建通道时要走的流程和要填的凭据字段。新建通道表单完全由这份响应驱动：setupMethod 决定展示录入表单还是扫码流程，credentialFields 是要填的字段，secretSource 决定要不要有回调密钥那一栏。
  * @summary 列出可接入的平台
  */
-export const listPlatforms = () => {
+export const listPlatforms = (options) => {
     return request({ url: `/v1/platforms`, method: 'GET'
-    });
+    }, options);
 };
 /**
+ * 按最近活动排序，只返回当前账号在当前项目里的对话。archived 是一个二选一的开关而不是「包含归档」：归档的对话不出现在默认列表里，要看它们就把这个参数打开。
  * @summary 列出对话
  */
-export const listThreads = (params) => {
+export const listThreads = (params, options) => {
     return request({ url: `/v1/threads`, method: 'GET',
         params
-    });
+    }, options);
 };
 /**
  * @summary 创建对话
  */
-export const createThread = (createThreadInputBody) => {
+export const createThread = (createThreadRequestBody, options) => {
     return request({ url: `/v1/threads`, method: 'POST',
         headers: { 'Content-Type': 'application/json', },
-        data: createThreadInputBody
-    });
+        data: createThreadRequestBody
+    }, options);
 };
 /**
  * 对话的完整当前状态，用于首屏渲染。文档中的 stream 给出实时输出地址和入场票据，流推送的是对这份文档的增量编辑，可直接套用同一套渲染逻辑。
  * @summary 取回对话文档
  */
-export const getThread = (thread) => {
+export const getThread = (thread, options) => {
     return request({ url: `/v1/threads/${thread}`, method: 'GET'
-    });
+    }, options);
 };
 /**
  * 可修改模型、推理档位、审批模式和归档状态。改动从下一次 turn 起生效，正在执行的 turn 沿用它启动时的设置。reasoningEffort 仅在同时提供 model 时生效。
  * @summary 修改对话设置
  */
-export const updateThread = (thread, updateThreadInputBody) => {
+export const updateThread = (thread, updateThreadRequestBody, options) => {
     return request({ url: `/v1/threads/${thread}`, method: 'PATCH',
         headers: { 'Content-Type': 'application/json', },
-        data: updateThreadInputBody
-    });
+        data: updateThreadRequestBody
+    }, options);
 };
 /**
  * 批次 id 来自对话文档的 wait 字段。本接口是幂等的：重复提交同一批次不会改变已经生效的决定，也不会报错。批次不属于该对话时返回 404。
  * @summary 批准或拒绝一批工具调用
  */
-export const decideApproval = (thread, batch, decideInputBody) => {
+export const decideApproval = (thread, batch, decideRequestBody, options) => {
     return request({ url: `/v1/threads/${thread}/approvals/${batch}`, method: 'POST',
         headers: { 'Content-Type': 'application/json', },
-        data: decideInputBody
-    });
+        data: decideRequestBody
+    }, options);
+};
+/**
+ * 首屏只给对话最新的那一段，再往上的内容用本接口按需取回，一次一段。before 用文档里的 earlier.before，响应里的 earlier 是再往上那一段的游标，为 null 表示已经到顶。返回的条目和文档里的 items 是同一种形状，顺序也一样（由旧到新），直接接在现有内容前面即可。
+ * @summary 取回更早的对话内容
+ */
+export const listEarlierItems = (thread, params, options) => {
+    return request({ url: `/v1/threads/${thread}/earlier`, method: 'GET',
+        params
+    }, options);
 };
 /**
  * 对没有正在执行的 turn 的对话调用同样返回 204，不视为错误——用户点击停止与 turn 自然结束之间存在竞争，两种结果一致。项目处于停服或清理状态时本接口仍然可用。
  * @summary 中断正在执行的 turn
  */
-export const interruptThread = (thread) => {
+export const interruptThread = (thread, options) => {
     return request({ url: `/v1/threads/${thread}/interrupt`, method: 'POST'
-    });
+    }, options);
 };
 /**
  * 立即返回 turnId，不等待执行完成——一次 turn 可能持续数十分钟。执行进度通过对话文档中 stream 指向的实时流获取，不在本响应里。
  * @summary 发送消息并触发一次 turn
  */
-export const sendMessage = (thread, sendMessageInputBody) => {
+export const sendMessage = (thread, sendMessageRequestBody, options) => {
     return request({ url: `/v1/threads/${thread}/messages`, method: 'POST',
         headers: { 'Content-Type': 'application/json', },
-        data: sendMessageInputBody
-    });
+        data: sendMessageRequestBody
+    }, options);
 };
 /**
  * 问题 id 来自对话文档的 wait 字段。已被回答过的问题同样返回 204——可能是另一个页面提交在先，也可能是自动应答窗口已到期，两种情况下 turn 都已带着答案继续执行。
  * @summary 回答助手提出的问题
  */
-export const answerQuestion = (thread, item, answerInputBody) => {
+export const answerQuestion = (thread, item, answerRequestBody, options) => {
     return request({ url: `/v1/threads/${thread}/questions/${item}`, method: 'POST',
         headers: { 'Content-Type': 'application/json', },
-        data: answerInputBody
-    });
+        data: answerRequestBody
+    }, options);
 };
 /**
  * @summary 标记对话已读
  */
-export const markThreadRead = (thread) => {
+export const markThreadRead = (thread, options) => {
     return request({ url: `/v1/threads/${thread}/read`, method: 'POST'
-    });
+    }, options);
 };
 /**
  * 撤回 ordinal 及其之后的全部条目。被撤回的条目仍留在逐字稿中并标记 reverted，序号不会重排。返回实际撤回的条目数。
  * @summary 从指定位置起撤回
  */
-export const revertThread = (thread, revertInputBody) => {
+export const revertThread = (thread, revertRequestBody, options) => {
     return request({ url: `/v1/threads/${thread}/revert`, method: 'POST',
         headers: { 'Content-Type': 'application/json', },
-        data: revertInputBody
-    });
+        data: revertRequestBody
+    }, options);
 };
 /**
  * 轮询本接口直到状态变为成功或失败。状态提示需要验证码时，调用补交验证码接口。
  * @summary 查询扫码登录状态
  */
-export const getWeixinLogin = (login) => {
+export const getWeixinLogin = (login, options) => {
     return request({ url: `/v1/weixin-logins/${login}`, method: 'GET'
-    });
+    }, options);
 };
 /**
  * 微信在扫码后要求短信或设备验证码时使用。验证码由登录发起人在自己手机上获取。
  * @summary 补交登录验证码
  */
-export const submitWeixinVerifyCode = (login, verifyCodeInputBody) => {
+export const submitWeixinVerifyCode = (login, verifyCodeRequestBody, options) => {
     return request({ url: `/v1/weixin-logins/${login}/verify-code`, method: 'POST',
         headers: { 'Content-Type': 'application/json', },
-        data: verifyCodeInputBody
-    });
+        data: verifyCodeRequestBody
+    }, options);
 };

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 {};