@leaflow/sdk 0.5.1 → 0.6.0

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

@@ -28,7 +28,7 @@ GET /v1/turns/{turn}/stream?ticket=<ticket>&cursor=<cursor>
 - 三种结束事件：`done` 本次 turn 完成（附带最终状态）、`paused` 助手在等待用户处理（重新取回对话文档读 `wait`）、`stalled` 执行已中断且不会恢复，不要重连。
  * OpenAPI spec version: 1.0.0
  */
-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 type { AnswerRequestBody, BindingCodeResponseBody, BindingResource, ChannelResource, ChannelWithSecretResponseBody, CheckSenderParams, 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];
 /**
@@ -59,9 +59,10 @@ export declare const getBinding: (binding: string, options?: SecondParameter<typ
  */
 export declare const listChannels: (params?: ListChannelsParams, options?: SecondParameter<typeof request<LengthAwarePageChannelResource>>) => Promise<LengthAwarePageChannelResource>;
 /**
+ * 回调密钥归谁定由平台决定，见 list-platforms 的 secretSource：generated 的平台不要传 webhookSecret，我们生成的那把仅在本次响应中返回一次、之后无法再次取回，错过了只能调轮换接口换一把新的；supplied 的平台必须把平台后台那把传进来，此时响应里的webhookSecret 为 null。
  * @summary 创建通道
  */
-export declare const createChannel: (createChannelRequestBody: CreateChannelRequestBody, options?: SecondParameter<typeof request<ChannelResource>>) => Promise<ChannelResource>;
+export declare const createChannel: (createChannelRequestBody: CreateChannelRequestBody, options?: SecondParameter<typeof request<ChannelWithSecretResponseBody>>) => Promise<ChannelWithSecretResponseBody>;
 /**
  * 删除后该通道不再接收入站消息，其上的绑定一并失效。项目处于停服或清理状态时本接口仍然可用。
  * @summary 删除通道
@@ -77,10 +78,10 @@ export declare const getChannel: (channel: string, options?: SecondParameter<typ
  */
 export declare const updateChannel: (channel: string, updateChannelRequestBody: UpdateChannelRequestBody, options?: SecondParameter<typeof request<ChannelResource>>) => Promise<ChannelResource>;
 /**
- * 生成一个一次性认领码交给待绑定的人，他在该平台上用自己的账号把这个码发给助手即完成绑定。绑定只能由本人以这种方式建立，不能直接指定平台账号。认领码有有效期，过期后需重新签发。
- * @summary 签发认领码
+ * 生成一个一次性绑定码交给待绑定的人，他在该平台上用自己的账号把这个码发给助手即完成绑定。绑定只能由本人以这种方式建立，不能直接指定平台账号。绑定码有有效期，过期后需重新签发。
+ * @summary 签发绑定码
  */
-export declare const createClaimCode: (channel: string, options?: SecondParameter<typeof request<ClaimCodeResponseBody>>) => Promise<ClaimCodeResponseBody>;
+export declare const createBindingCode: (channel: string, options?: SecondParameter<typeof request<BindingCodeResponseBody>>) => Promise<BindingCodeResponseBody>;
 /**
  * 排查「发了消息但助手没有响应」时使用。按时间倒序返回最近被这条通道拒绝的入站消息及其拒绝原因，最常见的原因是发送方尚未绑定。
  * @summary 查看最近被拒绝的入站消息
@@ -92,7 +93,7 @@ export declare const listChannelRejections: (channel: string, params?: ListChann
  */
 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>;
@@ -184,7 +185,7 @@ export type CreateChannelResult = NonNullable<Awaited<ReturnType<typeof createCh
 export type DeleteChannelResult = NonNullable<Awaited<ReturnType<typeof deleteChannel>>>;
 export type GetChannelResult = NonNullable<Awaited<ReturnType<typeof getChannel>>>;
 export type UpdateChannelResult = NonNullable<Awaited<ReturnType<typeof updateChannel>>>;
-export type CreateClaimCodeResult = NonNullable<Awaited<ReturnType<typeof createClaimCode>>>;
+export type CreateBindingCodeResult = NonNullable<Awaited<ReturnType<typeof createBindingCode>>>;
 export type ListChannelRejectionsResult = NonNullable<Awaited<ReturnType<typeof listChannelRejections>>>;
 export type RotateChannelSecretResult = NonNullable<Awaited<ReturnType<typeof rotateChannelSecret>>>;
 export type CheckSenderResult = NonNullable<Awaited<ReturnType<typeof checkSender>>>;

package/dist/generated/assistant/index.js

@@ -49,6 +49,7 @@ export const listChannels = (params, options) => {
     }, options);
 };
 /**
+ * 回调密钥归谁定由平台决定，见 list-platforms 的 secretSource：generated 的平台不要传 webhookSecret，我们生成的那把仅在本次响应中返回一次、之后无法再次取回，错过了只能调轮换接口换一把新的；supplied 的平台必须把平台后台那把传进来，此时响应里的webhookSecret 为 null。
  * @summary 创建通道
  */
 export const createChannel = (createChannelRequestBody, options) => {
@@ -83,11 +84,11 @@ export const updateChannel = (channel, updateChannelRequestBody, options) => {
     }, options);
 };
 /**
- * 生成一个一次性认领码交给待绑定的人，他在该平台上用自己的账号把这个码发给助手即完成绑定。绑定只能由本人以这种方式建立，不能直接指定平台账号。认领码有有效期，过期后需重新签发。
- * @summary 签发认领码
+ * 生成一个一次性绑定码交给待绑定的人，他在该平台上用自己的账号把这个码发给助手即完成绑定。绑定只能由本人以这种方式建立，不能直接指定平台账号。绑定码有有效期，过期后需重新签发。
+ * @summary 签发绑定码
  */
-export const createClaimCode = (channel, options) => {
-    return request({ url: `/v1/channels/${channel}/claim-codes`, method: 'POST'
+export const createBindingCode = (channel, options) => {
+    return request({ url: `/v1/channels/${channel}/binding-codes`, method: 'POST'
     }, options);
 };
 /**
@@ -110,7 +111,7 @@ export const rotateChannelSecret = (channel, rotateSecretRequestBody, options) =
     }, options);
 };
 /**
- * 改完发件人策略之后用来自查，不发送任何消息、也不改变任何状态：它走的是和真实入站完全相同的那份判定，并说明结论由哪一条规则得出。无法推演认领码那一条——是否是认领码取决于对方发来的内容。
+ * 改完发件人策略之后用来自查，不发送任何消息、也不改变任何状态：它走的是和真实入站完全相同的那份判定，并说明结论由哪一条规则得出。无法推演绑定码那一条——是否是绑定码取决于对方发来的内容。
  * @summary 推演一个发件人会不会被放行
  */
 export const checkSender = (channel, params, options) => {

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

@@ -0,0 +1,34 @@
+/**
+ * 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 BindingCodeResponseBody {
+    code: string;
+    expiresAt: string;
+}

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

@@ -28,13 +28,16 @@ GET /v1/turns/{turn}/stream?ticket=<ticket>&cursor=<cursor>
 - 三种结束事件：`done` 本次 turn 完成（附带最终状态）、`paused` 助手在等待用户处理（重新取回对话文档读 `wait`）、`stalled` 执行已中断且不会恢复，不要重连。
  * OpenAPI spec version: 1.0.0
  */
+import type { BindingResourceConnState } from './bindingResourceConnState.js';
+import type { BindingResourceStatus } from './bindingResourceStatus.js';
 import type { BindingResourceVerifiedAt } from './bindingResourceVerifiedAt.js';
 export interface BindingResource {
     channelId: string;
+    connState: BindingResourceConnState;
     createdAt: string;
     id: string;
     peerName: string;
     platform: string;
-    status: string;
+    status: BindingResourceStatus;
     verifiedAt: BindingResourceVerifiedAt;
 }

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

@@ -0,0 +1,37 @@
+/**
+ * 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 BindingResourceConnState = typeof BindingResourceConnState[keyof typeof BindingResourceConnState];
+export declare const BindingResourceConnState: {
+    readonly logged_out: "logged_out";
+    readonly qr_pending: "qr_pending";
+    readonly online: "online";
+    readonly expired: "expired";
+};

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

@@ -0,0 +1,37 @@
+/**
+ * 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
+ */
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const BindingResourceConnState = {
+    logged_out: 'logged_out',
+    qr_pending: 'qr_pending',
+    online: 'online',
+    expired: 'expired',
+};

package/dist/generated/assistant/models/bindingResourceStatus.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
+ */
+export type BindingResourceStatus = typeof BindingResourceStatus[keyof typeof BindingResourceStatus];
+export declare const BindingResourceStatus: {
+    readonly pending: "pending";
+    readonly active: "active";
+    readonly revoked: "revoked";
+};

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

@@ -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
+ */
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const BindingResourceStatus = {
+    pending: 'pending',
+    active: 'active',
+    revoked: 'revoked',
+};

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

@@ -29,15 +29,23 @@ GET /v1/turns/{turn}/stream?ticket=<ticket>&cursor=<cursor>
  * OpenAPI spec version: 1.0.0
  */
 import type { ChannelResourceAllowFrom } from './channelResourceAllowFrom.js';
+import type { ChannelResourceConnState } from './channelResourceConnState.js';
+import type { ChannelResourceRuntimeState } from './channelResourceRuntimeState.js';
+import type { ChannelResourceSenderPolicy } from './channelResourceSenderPolicy.js';
+import type { ChannelResourceStatus } from './channelResourceStatus.js';
 import type { ChannelResourceWebhookUrl } from './channelResourceWebhookUrl.js';
 export interface ChannelResource {
     allowFrom: ChannelResourceAllowFrom;
+    /** 平台接入状态。只有 online 才收得到消息、也才签得出绑定码 */
+    connState: ChannelResourceConnState;
     createdAt: string;
     id: string;
     name: string;
     platform: string;
-    senderPolicy: string;
-    status: string;
+    /** 常驻连接此刻的状态。回调型平台恒为 stopped */
+    runtimeState: ChannelResourceRuntimeState;
+    senderPolicy: ChannelResourceSenderPolicy;
+    status: ChannelResourceStatus;
     updatedAt: string;
     /** 回调路径，网关配置和排查时用 */
     webhookPath: string;

package/dist/generated/assistant/models/channelResourceConnState.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
+ */
+/**
+ * 平台接入状态。只有 online 才收得到消息、也才签得出绑定码
+ */
+export type ChannelResourceConnState = typeof ChannelResourceConnState[keyof typeof ChannelResourceConnState];
+export declare const ChannelResourceConnState: {
+    readonly logged_out: "logged_out";
+    readonly qr_pending: "qr_pending";
+    readonly online: "online";
+    readonly expired: "expired";
+};

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

@@ -0,0 +1,37 @@
+/**
+ * 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
+ */
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const ChannelResourceConnState = {
+    logged_out: 'logged_out',
+    qr_pending: 'qr_pending',
+    online: 'online',
+    expired: 'expired',
+};

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

@@ -0,0 +1,38 @@
+/**
+ * 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
+ */
+/**
+ * 常驻连接此刻的状态。回调型平台恒为 stopped
+ */
+export type ChannelResourceRuntimeState = typeof ChannelResourceRuntimeState[keyof typeof ChannelResourceRuntimeState];
+export declare const ChannelResourceRuntimeState: {
+    readonly stopped: "stopped";
+    readonly running: "running";
+};

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

@@ -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
+ */
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const ChannelResourceRuntimeState = {
+    stopped: 'stopped',
+    running: 'running',
+};

package/dist/generated/assistant/models/channelResourceSenderPolicy.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 type ChannelResourceSenderPolicy = typeof ChannelResourceSenderPolicy[keyof typeof ChannelResourceSenderPolicy];
+export declare const ChannelResourceSenderPolicy: {
+    readonly bound_only: "bound_only";
+    readonly open: "open";
+};

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

@@ -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
+ */
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export const ChannelResourceSenderPolicy = {
+    bound_only: 'bound_only',
+    open: 'open',
+};

package/dist/generated/assistant/models/channelResourceStatus.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
+ */
+export type ChannelResourceStatus = typeof ChannelResourceStatus[keyof typeof ChannelResourceStatus];
+export declare const ChannelResourceStatus: {
+    readonly active: "active";
+    readonly suspended: "suspended";
+    readonly disabled: "disabled";
+};