@leaflow/sdk 0.6.0 → 0.7.0

package/dist/assistant/v1/schema.d.ts

@@ -0,0 +1,1888 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/api/v1/attachments": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 上传图片
+         * @description 请求体直接是文件字节，不使用 multipart 封装，一次上传一个文件。类型由内容判定，与 Content-Type 无关。返回的 id 在发送消息时放进 attachmentIds；从未被任何消息引用的附件会被定期清除。
+         */
+        post: operations["upload-attachment"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/attachments/{attachment}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 取回图片
+         * @description 按附件 id 取回原始字节，可直接作为 <img> 的地址使用。响应带长期缓存头，附件内容不会变化。附件不存在或不属于当前用户时返回 404。
+         */
+        get: operations["download-attachment"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/bindings": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 列出绑定
+         * @description 接入面那张表按通道列出各自绑了谁时用 channelId 过滤。
+         */
+        get: operations["list-bindings"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/bindings/{binding}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 查看绑定 */
+        get: operations["get-binding"];
+        put?: never;
+        post?: never;
+        /** 解除绑定 */
+        delete: operations["delete-binding"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/channels": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 列出通道 */
+        get: operations["list-channels"];
+        put?: never;
+        /**
+         * 创建通道
+         * @description 回调密钥归谁定由平台决定，见 list-platforms 的 secretSource：generated 的平台不要传 webhookSecret，我们生成的那把仅在本次响应中返回一次、之后无法再次取回，错过了只能调轮换接口换一把新的；supplied 的平台必须把平台后台那把传进来，此时响应里的webhookSecret 为 null。
+         */
+        post: operations["create-channel"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/channels/{channel}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 查看通道 */
+        get: operations["get-channel"];
+        put?: never;
+        post?: never;
+        /**
+         * 删除通道
+         * @description 删除后该通道不再接收入站消息，其上的绑定一并失效。项目处于停服或清理状态时本接口仍然可用。
+         */
+        delete: operations["delete-channel"];
+        options?: never;
+        head?: never;
+        /**
+         * 修改通道
+         * @description 只修改传了的字段。senderPolicy 与 allowFrom 是一对，由 senderPolicy 决定是否替换；改动对常驻连接要等连接重建后才生效，回调型平台立即生效。
+         */
+        patch: operations["update-channel"];
+        trace?: never;
+    };
+    "/api/v1/channels/{channel}/binding-codes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 签发绑定码
+         * @description 生成一个一次性绑定码交给待绑定的人，他在该平台上用自己的账号把这个码发给助手即完成绑定。绑定只能由本人以这种方式建立，不能直接指定平台账号。绑定码有有效期，过期后需重新签发。
+         */
+        post: operations["create-binding-code"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/channels/{channel}/rejections": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 查看最近被拒绝的入站消息
+         * @description 排查「发了消息但助手没有响应」时使用。按时间倒序返回最近被这条通道拒绝的入站消息及其拒绝原因，最常见的原因是发送方尚未绑定。
+         */
+        get: operations["list-channel-rejections"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/channels/{channel}/secret": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 轮换回调密钥
+         * @description 换一把新的回调密钥，旧的立即失效，通道降回待平台确认状态。密钥归谁定由平台决定，见 list-platforms 的 secretSource：generated 的平台不要传请求体，新密钥仅在本次响应中返回、之后无法再次取回；supplied 的平台必须把平台后台那把新密钥传进来。
+         */
+        post: operations["rotate-channel-secret"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/channels/{channel}/sender-check": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 推演一个发件人会不会被放行
+         * @description 改完发件人策略之后用来自查，不发送任何消息、也不改变任何状态：它走的是和真实入站完全相同的那份判定，并说明结论由哪一条规则得出。无法推演绑定码那一条——是否是绑定码取决于对方发来的内容。
+         */
+        get: operations["check-sender"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/channels/{channel}/weixin-logins": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 发起微信扫码登录
+         * @description 微信个人号通道需要本人扫码登录后才能收发消息。本接口返回二维码，之后轮询 `GET /v1/weixin-logins/{login}` 获取进度；状态提示需要验证码时，调用 `POST /v1/weixin-logins/{login}/verify-code` 补交。
+         */
+        post: operations["begin-weixin-login"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/platforms": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 列出可接入的平台
+         * @description 返回本平台当前支持接入的即时通讯平台，以及各自建通道时要走的流程和要填的凭据字段。新建通道表单完全由这份响应驱动：setupMethod 决定展示录入表单还是扫码流程，credentialFields 是要填的字段，secretSource 决定要不要有回调密钥那一栏。
+         */
+        get: operations["list-platforms"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/weixin-logins/{login}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 查询扫码登录状态
+         * @description 轮询本接口直到状态变为成功或失败。状态提示需要验证码时，调用补交验证码接口。
+         */
+        get: operations["get-weixin-login"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/weixin-logins/{login}/verify-code": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 补交登录验证码
+         * @description 微信在扫码后要求短信或设备验证码时使用。验证码由登录发起人在自己手机上获取。
+         */
+        post: operations["submit-weixin-verify-code"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/models": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 列出可用模型
+         * @description 返回本平台当前提供的模型及其上下文窗口、推理档位和支持的输入类型。用于填充对话设置里的模型选择。
+         */
+        get: operations["list-models"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/threads": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 列出对话
+         * @description 按最近活动排序，只返回当前账号在当前项目里的对话。archived 是一个二选一的开关而不是「包含归档」：归档的对话不出现在默认列表里，要看它们就把这个参数打开。
+         */
+        get: operations["list-threads"];
+        put?: never;
+        /** 创建对话 */
+        post: operations["create-thread"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/threads/{thread}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 取回对话文档
+         * @description 对话的完整当前状态，用于首屏渲染。文档中的 stream 给出实时输出地址和入场票据，流推送的是对这份文档的增量编辑，可直接套用同一套渲染逻辑。
+         */
+        get: operations["get-thread"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * 修改对话设置
+         * @description 可修改模型、推理档位、审批模式和归档状态。改动从下一次 turn 起生效，正在执行的 turn 沿用它启动时的设置。reasoningEffort 仅在同时提供 model 时生效。
+         */
+        patch: operations["update-thread"];
+        trace?: never;
+    };
+    "/api/v1/threads/{thread}/approvals/{batch}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 批准或拒绝一批工具调用
+         * @description 批次 id 来自对话文档的 wait 字段。本接口是幂等的：重复提交同一批次不会改变已经生效的决定，也不会报错。批次不属于该对话时返回 404。
+         */
+        post: operations["decide-approval"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/threads/{thread}/earlier": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 取回更早的对话内容
+         * @description 首屏只给对话最新的那一段，再往上的内容用本接口按需取回，一次一段。before 用文档里的 earlier.before，响应里的 earlier 是再往上那一段的游标，为 null 表示已经到顶。返回的条目和文档里的 items 是同一种形状，顺序也一样（由旧到新），直接接在现有内容前面即可。
+         */
+        get: operations["list-earlier-items"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/threads/{thread}/interrupt": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 中断正在执行的 turn
+         * @description 对没有正在执行的 turn 的对话调用同样返回 204，不视为错误——用户点击停止与 turn 自然结束之间存在竞争，两种结果一致。项目处于停服或清理状态时本接口仍然可用。
+         */
+        post: operations["interrupt-thread"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/threads/{thread}/messages": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 发送消息并触发一次 turn
+         * @description 立即返回 turnId，不等待执行完成——一次 turn 可能持续数十分钟。执行进度通过对话文档中 stream 指向的实时流获取，不在本响应里。
+         */
+        post: operations["send-message"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/threads/{thread}/questions/{item}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 回答助手提出的问题
+         * @description 问题 id 来自对话文档的 wait 字段。已被回答过的问题同样返回 204——可能是另一个页面提交在先，也可能是自动应答窗口已到期，两种情况下 turn 都已带着答案继续执行。
+         */
+        post: operations["answer-question"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/threads/{thread}/read": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** 标记对话已读 */
+        post: operations["mark-thread-read"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/threads/{thread}/revert": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 从指定位置起撤回
+         * @description 撤回 ordinal 及其之后的全部条目。被撤回的条目仍留在逐字稿中并标记 reverted，序号不会重排。返回实际撤回的条目数。
+         */
+        post: operations["revert-thread"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        Error: {
+            code?: string;
+            message: string;
+            meta?: {
+                [key: string]: unknown;
+            };
+            /** Format: int64 */
+            status: number;
+        };
+        UploadedResource: {
+            /** Format: int64 */
+            height: number;
+            id: string;
+            /** Format: int64 */
+            width: number;
+        };
+        BindingResource: {
+            /** Format: uuid */
+            channelId: string;
+            /** @enum {string} */
+            connState: "logged_out" | "qr_pending" | "online" | "expired";
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: uuid */
+            id: string;
+            peerName: string;
+            platform: string;
+            /** @enum {string} */
+            status: "pending" | "active" | "revoked";
+            /** Format: date-time */
+            verifiedAt: string | null;
+        };
+        LengthAwarePageBindingResource: {
+            /** @description 这一页的内容 */
+            items: components["schemas"]["BindingResource"][];
+            /**
+             * Format: int64
+             * @description 这一页最多几条，回显请求里的值
+             */
+            limit: number;
+            /**
+             * Format: int64
+             * @description 跳过了多少条，回显请求里的值
+             */
+            offset: number;
+            /**
+             * Format: int64
+             * @description 命中的总条数，不只是这一页
+             */
+            total: number;
+        };
+        ChannelResource: {
+            allowFrom: string[] | null;
+            /**
+             * @description 平台接入状态。只有 online 才收得到消息、也才签得出绑定码
+             * @enum {string}
+             */
+            connState: "logged_out" | "qr_pending" | "online" | "expired";
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: uuid */
+            id: string;
+            name: string;
+            platform: string;
+            /**
+             * @description 常驻连接此刻的状态。回调型平台恒为 stopped
+             * @enum {string}
+             */
+            runtimeState: "stopped" | "running";
+            /** @enum {string} */
+            senderPolicy: "bound_only" | "open";
+            /** @enum {string} */
+            status: "active" | "suspended" | "disabled";
+            /** Format: date-time */
+            updatedAt: string;
+            /** @description 回调路径，网关配置和排查时用 */
+            webhookPath: string;
+            /** @description 填到平台后台的回调地址。部署未声明公网入口时为 null */
+            webhookUrl: string | null;
+        };
+        LengthAwarePageChannelResource: {
+            /** @description 这一页的内容 */
+            items: components["schemas"]["ChannelResource"][];
+            /**
+             * Format: int64
+             * @description 这一页最多几条，回显请求里的值
+             */
+            limit: number;
+            /**
+             * Format: int64
+             * @description 跳过了多少条，回显请求里的值
+             */
+            offset: number;
+            /**
+             * Format: int64
+             * @description 命中的总条数，不只是这一页
+             */
+            total: number;
+        };
+        CreateChannelRequestBody: {
+            allowFrom?: string[] | null;
+            /** @description 平台侧凭据。只写不读，创建后无法取回 */
+            credentials?: {
+                [key: string]: string;
+            };
+            name: string;
+            platform: string;
+            /** @enum {string} */
+            senderPolicy?: "bound_only" | "open";
+            /** @description 平台生成密钥的平台（secretSource=supplied）必须传；我们生成的（generated）不能传，那把会在本次响应的 webhookSecret 里返回一次 */
+            webhookSecret?: string;
+        };
+        ChannelWithSecretResponseBody: {
+            allowFrom: string[] | null;
+            /**
+             * @description 平台接入状态。只有 online 才收得到消息、也才签得出绑定码
+             * @enum {string}
+             */
+            connState: "logged_out" | "qr_pending" | "online" | "expired";
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: uuid */
+            id: string;
+            name: string;
+            platform: string;
+            /**
+             * @description 常驻连接此刻的状态。回调型平台恒为 stopped
+             * @enum {string}
+             */
+            runtimeState: "stopped" | "running";
+            /** @enum {string} */
+            senderPolicy: "bound_only" | "open";
+            /** @enum {string} */
+            status: "active" | "suspended" | "disabled";
+            /** Format: date-time */
+            updatedAt: string;
+            /** @description 回调路径，网关配置和排查时用 */
+            webhookPath: string;
+            /** @description 我们生成的那把回调密钥，拿去粘到平台后台。**之后无法再次取回**，只能轮换出新的一把。密钥由平台生成（secretSource=supplied）或该平台不走回调时为 null */
+            webhookSecret: string | null;
+            /** @description 填到平台后台的回调地址。部署未声明公网入口时为 null */
+            webhookUrl: string | null;
+        };
+        UpdateChannelRequestBody: {
+            /** @description 放行名单。仅在同时传了 senderPolicy 时生效 */
+            allowFrom?: string[] | null;
+            /** @description 整份替换而不是逐键合并。不传表示不动 */
+            credentials?: {
+                [key: string]: string;
+            };
+            enabled?: boolean;
+            name?: string;
+            /**
+             * @description 传了才会连同 allowFrom 一起替换
+             * @enum {string}
+             */
+            senderPolicy?: "bound_only" | "open";
+        };
+        BindingCodeResponseBody: {
+            code: string;
+            /** Format: date-time */
+            expiresAt: string;
+        };
+        RejectionResource: {
+            /** Format: date-time */
+            at: string;
+            peerId: string;
+            peerName: string;
+            peerUsername: string;
+            platform: string;
+            /** Format: int64 */
+            textLength: number;
+            verdict: string;
+        };
+        RejectionListResponseBody: {
+            rejections: components["schemas"]["RejectionResource"][] | null;
+        };
+        RotateSecretRequestBody: {
+            /** @description 平台生成密钥的平台（secretSource=supplied）必须传新的那把；我们生成的（generated）不能传 */
+            webhookSecret?: string;
+        };
+        WebhookSecretResponseBody: {
+            webhookSecret: string;
+        };
+        SenderCheckResource: {
+            allowFrom: string[] | null;
+            allowed: boolean;
+            bindingId: string | null;
+            senderPolicy: string;
+            /** @enum {string} */
+            verdict: "ALLOWED_BY_BINDING" | "ALLOWED_BY_ALLOW_FROM" | "ALLOWED_BY_POLICY" | "REJECTED_NOT_ALLOWED";
+        };
+        LoginResource: {
+            /**
+             * Format: date-time
+             * @description 这条登录流的截止时间。到点之后不要再轮询，重新发起一次
+             */
+            expiresAt: string;
+            /** Format: uuid */
+            id: string;
+            /** @description 二维码的内容，由客户端编码成二维码图形渲染（不是图片地址，也不是 data URI）。码过期时这条流会自己换一张接着等，所以每次轮询拿到的可能是新的一串 */
+            qrcodeData: string;
+            /** @description 失败原因。仅在 status 为 error 或 expired 时有内容 */
+            reason: string;
+            /** @enum {string} */
+            status: "wait" | "scanned" | "confirmed" | "expired" | "error" | "need_verify_code";
+        };
+        CredentialFieldResource: {
+            help: string;
+            key: string;
+            label: string;
+            required: boolean;
+            secret: boolean;
+        };
+        PlatformResource: {
+            credentialFields: components["schemas"]["CredentialFieldResource"][] | null;
+            name: string;
+            resident: boolean;
+            /** @enum {string} */
+            secretSource: "generated" | "supplied" | "none";
+            /** @enum {string} */
+            setupChallenge: "none" | "webhook" | "scan";
+            /** @enum {string} */
+            setupMethod: "credentials" | "scan";
+            /** @description 回调路径模板，{channel} 处替换为通道 id */
+            webhookPath: string;
+            /** @description 完整回调地址模板。部署未声明公网入口时为 null */
+            webhookUrlTemplate: string | null;
+        };
+        PlatformListResponseBody: {
+            platforms: components["schemas"]["PlatformResource"][] | null;
+        };
+        VerifyCodeRequestBody: {
+            code: string;
+        };
+        ModelResource: {
+            /** Format: int64 */
+            contextWindow: number;
+            inputModalities: string[] | null;
+            key: string;
+            reasoningTiers: string[] | null;
+        };
+        ModelListResponseBody: {
+            models: components["schemas"]["ModelResource"][] | null;
+        };
+        ThreadSummaryResource: {
+            /** @enum {string} */
+            approvalMode: "guardian" | "manual" | "yolo";
+            archived: boolean;
+            /** Format: date-time */
+            createdAt: string;
+            id: string;
+            model: string;
+            title: string | null;
+            unread: boolean;
+            /** Format: date-time */
+            updatedAt: string;
+        };
+        ThreadListResponseBody: {
+            threads: components["schemas"]["ThreadSummaryResource"][] | null;
+        };
+        CreateThreadRequestBody: {
+            /**
+             * @description 不传则使用平台默认审批模式
+             * @enum {string}
+             */
+            approvalMode?: "guardian" | "manual" | "yolo";
+        };
+        ContextResource: {
+            /** Format: int64 */
+            compactAt: number | null;
+            model: string;
+            /** Format: int64 */
+            used: number | null;
+            /** Format: int64 */
+            warnAt: number;
+            /** Format: int64 */
+            window: number | null;
+        };
+        EarlierResource: {
+            /** Format: int64 */
+            before: number;
+            foldedAbove: boolean;
+        };
+        AttachmentResource: {
+            /** Format: int64 */
+            height: number;
+            id: string;
+            /** Format: int64 */
+            width: number;
+        };
+        ItemResource: {
+            /** @enum {string|null} */
+            approval?: "approved" | "declined" | "auto_approved" | "unreviewed" | null;
+            approvalReason?: string | null;
+            arguments?: string;
+            attachments?: components["schemas"]["AttachmentResource"][] | null;
+            /** Format: date-time */
+            createdAt: string;
+            detail?: string | null;
+            /** Format: int64 */
+            durationMs?: number | null;
+            id: string;
+            /** @description 产出这一条的模型。用户自己发的消息为 null */
+            model: string | null;
+            namespace?: string | null;
+            /** Format: int64 */
+            ordinal: number;
+            reverted: boolean;
+            /** @enum {string} */
+            status: "pending" | "in_progress" | "completed" | "failed" | "declined" | "interrupted";
+            target?: string | null;
+            text?: string;
+            tool?: string | null;
+            /**
+             * @description 决定这一条包含哪些字段
+             * @enum {string}
+             */
+            type: "user_message" | "agent_message" | "reasoning" | "dynamic_tool_call" | "context_compaction" | "token_budget_reminder" | "turn_failure";
+        };
+        StreamResource: {
+            path: string;
+            ticket: string;
+        };
+        TurnResource: {
+            /** @enum {string} */
+            approvalMode: "guardian" | "manual" | "yolo";
+        };
+        Choice: {
+            description: string;
+            label: string;
+        };
+        Question: {
+            choices: components["schemas"]["Choice"][] | null;
+            header: string;
+            id: string;
+            question: string;
+        };
+        WaitResource: {
+            /** Format: int64 */
+            autoResolutionMs?: number;
+            batchId?: string;
+            itemId?: string;
+            itemIds?: string[] | null;
+            /** @enum {string} */
+            kind: "tool_approval" | "user_input";
+            questions?: components["schemas"]["Question"][] | null;
+            turnId: string;
+        };
+        DocumentResource: {
+            context: components["schemas"]["ContextResource"];
+            cursor: string | null;
+            earlier: components["schemas"]["EarlierResource"] | null;
+            items: components["schemas"]["ItemResource"][] | null;
+            status: string;
+            stream: components["schemas"]["StreamResource"] | null;
+            turn: components["schemas"]["TurnResource"] | null;
+            turnId: string | null;
+            wait: components["schemas"]["WaitResource"] | null;
+        };
+        UpdateThreadRequestBody: {
+            /** @enum {string} */
+            approvalMode?: "guardian" | "manual" | "yolo";
+            archived?: boolean;
+            model?: string;
+            reasoningEffort?: string;
+        };
+        DecideRequestBody: {
+            approved: boolean;
+            reason?: string;
+        };
+        EarlierResponseBody: {
+            earlier: components["schemas"]["EarlierResource"];
+            items: components["schemas"]["ItemResource"][] | null;
+        };
+        SendMessageRequestBody: {
+            /** @description 此前上传、尚未绑定到任何消息的附件 id */
+            attachmentIds?: string[] | null;
+            text: string;
+        };
+        TurnIDResponseBody: {
+            turnId: string;
+        };
+        AnswerRequestBody: {
+            /** @description 问题 id 到所选答案的映射 */
+            answers: {
+                [key: string]: string;
+            };
+        };
+        RevertRequestBody: {
+            /**
+             * Format: int64
+             * @description 起始序号，该条及其之后的全部条目都会被撤回
+             */
+            ordinal: number;
+        };
+        RevertedCountResponseBody: {
+            /** Format: int64 */
+            reverted: number;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    "upload-attachment": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/octet-stream": string;
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UploadedResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "download-attachment": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                attachment: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    /** @description 私有而且长缓存：这些字节按 id 寻址而 id 永不复用，所以它们永远不会变；而它们属于一个人，所以不能进任何共享缓存。 */
+                    "Cache-Control"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "image/*": string;
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-bindings": {
+        parameters: {
+            query?: {
+                /** @description 这一页最多返回多少条 */
+                limit?: number;
+                /** @description 跳过多少条。要翻得更深请改用游标翻页的接口 */
+                offset?: number;
+                platform?: string;
+                channelId?: string;
+                /** @description 仅返回处于活跃状态的绑定 */
+                active?: boolean;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LengthAwarePageBindingResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-binding": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                binding: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BindingResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "delete-binding": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                binding: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description No Content */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-channels": {
+        parameters: {
+            query?: {
+                /** @description 这一页最多返回多少条 */
+                limit?: number;
+                /** @description 跳过多少条。要翻得更深请改用游标翻页的接口 */
+                offset?: number;
+                platform?: string;
+                /** @description 仅返回处于启用状态的通道 */
+                active?: boolean;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LengthAwarePageChannelResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "create-channel": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateChannelRequestBody"];
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ChannelWithSecretResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-channel": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                channel: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ChannelResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "delete-channel": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                channel: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description No Content */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "update-channel": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                channel: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateChannelRequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ChannelResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "create-binding-code": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                channel: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BindingCodeResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-channel-rejections": {
+        parameters: {
+            query?: {
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                channel: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RejectionListResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "rotate-channel-secret": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                channel: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["RotateSecretRequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookSecretResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "check-sender": {
+        parameters: {
+            query: {
+                /** @description 平台上那个人的 id，和绑定、被拒记录里的是同一个值 */
+                peerId: string;
+                /** @description 仅 Telegram 这类有用户名的平台填得出来，不带 @。留空即当作没有用户名 */
+                username?: string;
+            };
+            header?: never;
+            path: {
+                channel: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SenderCheckResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "begin-weixin-login": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                channel: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LoginResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-platforms": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PlatformListResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-weixin-login": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                login: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LoginResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "submit-weixin-verify-code": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                login: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["VerifyCodeRequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LoginResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-models": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ModelListResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-threads": {
+        parameters: {
+            query?: {
+                /** @description 按标题搜索，大小写不敏感。留空则返回最近的对话 */
+                q?: string;
+                /** @description 为真时**只**返回已归档的对话，否则只返回未归档的 */
+                archived?: boolean;
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ThreadListResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "create-thread": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateThreadRequestBody"];
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ThreadSummaryResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-thread": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                thread: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DocumentResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "update-thread": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                thread: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateThreadRequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ThreadSummaryResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "decide-approval": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                thread: string;
+                batch: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DecideRequestBody"];
+            };
+        };
+        responses: {
+            /** @description No Content */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-earlier-items": {
+        parameters: {
+            query: {
+                /** @description 来自文档里的 earlier.before，取这个序号之前的条目 */
+                before: number;
+            };
+            header?: never;
+            path: {
+                thread: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EarlierResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "interrupt-thread": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                thread: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description No Content */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "send-message": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                thread: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SendMessageRequestBody"];
+            };
+        };
+        responses: {
+            /** @description Accepted */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TurnIDResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "answer-question": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                thread: string;
+                item: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AnswerRequestBody"];
+            };
+        };
+        responses: {
+            /** @description No Content */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "mark-thread-read": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                thread: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description No Content */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "revert-thread": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                thread: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RevertRequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RevertedCountResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+}