@leaflow/sdk 0.1.0

package/openapi/assistant.yaml

@@ -0,0 +1,1736 @@
+components:
+  schemas:
+    AnswerInputBody:
+      additionalProperties: false
+      properties:
+        answers:
+          additionalProperties:
+            type: string
+          description: 问题 id 到所选答案的映射
+          type: object
+      required:
+        - answers
+      type: object
+    AttachmentView:
+      additionalProperties: false
+      properties:
+        height:
+          format: int64
+          type: integer
+        id:
+          type: string
+        width:
+          format: int64
+          type: integer
+      required:
+        - id
+        - width
+        - height
+      type: object
+    BindingView:
+      additionalProperties: false
+      properties:
+        channelId:
+          format: uuid
+          type: string
+        createdAt:
+          format: date-time
+          type: string
+        id:
+          format: uuid
+          type: string
+        peerName:
+          type: string
+        platform:
+          type: string
+        status:
+          type: string
+        verifiedAt:
+          format: date-time
+          type:
+            - string
+            - "null"
+      required:
+        - id
+        - channelId
+        - platform
+        - peerName
+        - status
+        - verifiedAt
+        - createdAt
+      type: object
+    ChannelView:
+      additionalProperties: false
+      properties:
+        allowFrom:
+          items:
+            type: string
+          type:
+            - array
+            - "null"
+        createdAt:
+          format: date-time
+          type: string
+        id:
+          format: uuid
+          type: string
+        name:
+          type: string
+        platform:
+          type: string
+        senderPolicy:
+          type: string
+        status:
+          type: string
+        updatedAt:
+          format: date-time
+          type: string
+        webhookPath:
+          type: string
+      required:
+        - id
+        - platform
+        - name
+        - status
+        - senderPolicy
+        - allowFrom
+        - webhookPath
+        - createdAt
+        - updatedAt
+      type: object
+    Choice:
+      additionalProperties: false
+      properties:
+        description:
+          type: string
+        label:
+          type: string
+      required:
+        - label
+        - description
+      type: object
+    ClaimCodeOutputBody:
+      additionalProperties: false
+      properties:
+        code:
+          type: string
+        expiresAt:
+          format: date-time
+          type: string
+      required:
+        - code
+        - expiresAt
+      type: object
+    ContextView:
+      additionalProperties: false
+      properties:
+        compactAt:
+          format: int64
+          type:
+            - integer
+            - "null"
+        model:
+          type: string
+        used:
+          format: int64
+          type:
+            - integer
+            - "null"
+        warnAt:
+          format: int64
+          type: integer
+        window:
+          format: int64
+          type:
+            - integer
+            - "null"
+      required:
+        - model
+        - used
+        - window
+        - compactAt
+        - warnAt
+      type: object
+    CreateChannelInputBody:
+      additionalProperties: false
+      properties:
+        allowFrom:
+          items:
+            type: string
+          type:
+            - array
+            - "null"
+        credentials:
+          additionalProperties:
+            type: string
+          description: 平台侧凭据。只写不读，创建后无法取回
+          type: object
+        name:
+          maxLength: 128
+          type: string
+        platform:
+          type: string
+        senderPolicy:
+          type: string
+        webhookSecret:
+          description: 不提供则自动生成。仅在本次响应中返回一次
+          type: string
+      required:
+        - platform
+        - name
+      type: object
+    CreateThreadInputBody:
+      additionalProperties: false
+      properties:
+        approvalMode:
+          description: 不传则使用平台默认审批模式
+          enum:
+            - guardian
+            - manual
+            - yolo
+          type: string
+      type: object
+    DecideInputBody:
+      additionalProperties: false
+      properties:
+        approved:
+          type: boolean
+        reason:
+          type: string
+      required:
+        - approved
+      type: object
+    DocumentView:
+      additionalProperties: false
+      properties:
+        context:
+          $ref: "#/components/schemas/ContextView"
+        cursor:
+          type:
+            - string
+            - "null"
+        earlier:
+          $ref: "#/components/schemas/EarlierView"
+        items:
+          items:
+            $ref: "#/components/schemas/ItemView"
+          type:
+            - array
+            - "null"
+        status:
+          type: string
+        stream:
+          $ref: "#/components/schemas/StreamView"
+        turn:
+          $ref: "#/components/schemas/TurnView"
+        turnId:
+          type:
+            - string
+            - "null"
+        wait:
+          $ref: "#/components/schemas/WaitView"
+      required:
+        - turnId
+        - stream
+        - status
+        - cursor
+        - earlier
+        - context
+        - items
+        - wait
+        - turn
+      type: object
+    EarlierView:
+      additionalProperties: false
+      properties:
+        before:
+          format: int64
+          type: integer
+        foldedAbove:
+          type: boolean
+      required:
+        - before
+        - foldedAbove
+      type: object
+    Entry:
+      additionalProperties: false
+      properties:
+        at:
+          format: date-time
+          type: string
+        peer_id:
+          type: string
+        peer_name:
+          type: string
+        peer_username:
+          type: string
+        platform:
+          type: string
+        text_length:
+          format: int64
+          type: integer
+        verdict:
+          type: string
+      required:
+        - peer_id
+        - platform
+        - verdict
+        - text_length
+        - at
+      type: object
+    Error:
+      additionalProperties: false
+      properties:
+        code:
+          type: string
+        message:
+          type: string
+        meta:
+          additionalProperties: {}
+          type: object
+        status:
+          format: int64
+          type: integer
+      required:
+        - status
+        - message
+      type: object
+    ItemView:
+      additionalProperties: false
+      properties:
+        approval:
+          enum:
+            - approved
+            - declined
+            - auto_approved
+            - unreviewed
+          type:
+            - string
+            - "null"
+        approvalReason:
+          type:
+            - string
+            - "null"
+        arguments:
+          type: string
+        attachments:
+          items:
+            $ref: "#/components/schemas/AttachmentView"
+          type:
+            - array
+            - "null"
+        createdAt:
+          format: date-time
+          type: string
+        detail:
+          type:
+            - string
+            - "null"
+        durationMs:
+          format: int64
+          type:
+            - integer
+            - "null"
+        id:
+          type: string
+        model:
+          description: 这一行是哪个模型产出的。人打的字上是 null
+          type:
+            - string
+            - "null"
+        namespace:
+          type:
+            - string
+            - "null"
+        ordinal:
+          format: int64
+          type: integer
+        reverted:
+          type: boolean
+        status:
+          enum:
+            - pending
+            - in_progress
+            - completed
+            - failed
+            - declined
+            - aborted
+          type: string
+        target:
+          type:
+            - string
+            - "null"
+        text:
+          type: string
+        tool:
+          type:
+            - string
+            - "null"
+        type:
+          description: 客户端按它 switch 出这一行的形状
+          enum:
+            - user_message
+            - agent_message
+            - reasoning
+            - dynamic_tool_call
+            - context_compaction
+            - token_budget_reminder
+          type: string
+      required:
+        - id
+        - ordinal
+        - type
+        - status
+        - createdAt
+        - reverted
+        - model
+      type: object
+    ListBindingsOutputBody:
+      additionalProperties: false
+      properties:
+        bindings:
+          items:
+            $ref: "#/components/schemas/BindingView"
+          type:
+            - array
+            - "null"
+        total:
+          format: int64
+          type: integer
+      required:
+        - bindings
+        - total
+      type: object
+    ListChannelsOutputBody:
+      additionalProperties: false
+      properties:
+        channels:
+          items:
+            $ref: "#/components/schemas/ChannelView"
+          type:
+            - array
+            - "null"
+        total:
+          format: int64
+          type: integer
+      required:
+        - channels
+        - total
+      type: object
+    ListModelsOutputBody:
+      additionalProperties: false
+      properties:
+        models:
+          items:
+            $ref: "#/components/schemas/ModelView"
+          type:
+            - array
+            - "null"
+      required:
+        - models
+      type: object
+    ListPlatformsOutputBody:
+      additionalProperties: false
+      properties:
+        platforms:
+          items:
+            $ref: "#/components/schemas/PlatformView"
+          type:
+            - array
+            - "null"
+      required:
+        - platforms
+      type: object
+    ListRejectionsOutputBody:
+      additionalProperties: false
+      properties:
+        rejections:
+          items:
+            $ref: "#/components/schemas/Entry"
+          type:
+            - array
+            - "null"
+      required:
+        - rejections
+      type: object
+    ListThreadsOutputBody:
+      additionalProperties: false
+      properties:
+        threads:
+          items:
+            $ref: "#/components/schemas/ThreadSummaryView"
+          type:
+            - array
+            - "null"
+      required:
+        - threads
+      type: object
+    LoginView:
+      additionalProperties: false
+      properties:
+        expiresAt:
+          format: date-time
+          type: string
+        id:
+          format: uuid
+          type: string
+        qrcode:
+          type: string
+        qrcodeData:
+          type: string
+        reason:
+          type: string
+        status:
+          type: string
+      required:
+        - id
+        - status
+        - qrcode
+        - qrcodeData
+        - reason
+        - expiresAt
+      type: object
+    ModelView:
+      additionalProperties: false
+      properties:
+        contextWindow:
+          format: int64
+          type: integer
+        inputModalities:
+          items:
+            type: string
+          type:
+            - array
+            - "null"
+        key:
+          type: string
+        reasoningTiers:
+          items:
+            type: string
+          type:
+            - array
+            - "null"
+      required:
+        - key
+        - contextWindow
+        - reasoningTiers
+        - inputModalities
+      type: object
+    PlatformView:
+      additionalProperties: false
+      properties:
+        name:
+          type: string
+        resident:
+          type: boolean
+        webhookPath:
+          type: string
+      required:
+        - name
+        - resident
+        - webhookPath
+      type: object
+    Question:
+      additionalProperties: false
+      properties:
+        choices:
+          items:
+            $ref: "#/components/schemas/Choice"
+          type:
+            - array
+            - "null"
+        header:
+          type: string
+        id:
+          type: string
+        question:
+          type: string
+      required:
+        - id
+        - header
+        - question
+        - choices
+      type: object
+    RevertInputBody:
+      additionalProperties: false
+      properties:
+        ordinal:
+          description: 起始序号，该条及其之后的全部条目都会被撤回
+          format: int64
+          type: integer
+      required:
+        - ordinal
+      type: object
+    RevertOutputBody:
+      additionalProperties: false
+      properties:
+        reverted:
+          format: int64
+          type: integer
+      required:
+        - reverted
+      type: object
+    RotateSecretOutputBody:
+      additionalProperties: false
+      properties:
+        webhookSecret:
+          type: string
+      required:
+        - webhookSecret
+      type: object
+    SendMessageInputBody:
+      additionalProperties: false
+      properties:
+        attachmentIds:
+          description: 此前上传、尚未绑定到任何消息的附件 id
+          items:
+            type: string
+          type:
+            - array
+            - "null"
+        text:
+          type: string
+      required:
+        - text
+      type: object
+    SendMessageOutputBody:
+      additionalProperties: false
+      properties:
+        turnId:
+          type: string
+      required:
+        - turnId
+      type: object
+    StreamView:
+      additionalProperties: false
+      properties:
+        ticket:
+          type: string
+        url:
+          type: string
+      required:
+        - url
+        - ticket
+      type: object
+    ThreadSummaryView:
+      additionalProperties: false
+      properties:
+        approvalMode:
+          enum:
+            - guardian
+            - manual
+            - yolo
+          type: string
+        archived:
+          type: boolean
+        createdAt:
+          format: date-time
+          type: string
+        id:
+          type: string
+        model:
+          type: string
+        title:
+          type:
+            - string
+            - "null"
+        unread:
+          type: boolean
+        updatedAt:
+          format: date-time
+          type: string
+      required:
+        - id
+        - title
+        - model
+        - createdAt
+        - updatedAt
+        - archived
+        - unread
+        - approvalMode
+      type: object
+    TurnView:
+      additionalProperties: false
+      properties:
+        approvalMode:
+          enum:
+            - guardian
+            - manual
+            - yolo
+          type: string
+      required:
+        - approvalMode
+      type: object
+    UpdateChannelInputBody:
+      additionalProperties: false
+      properties:
+        credentials:
+          additionalProperties:
+            type: string
+          type: object
+        enabled:
+          type: boolean
+        name:
+          maxLength: 128
+          type: string
+      type: object
+    UpdateThreadInputBody:
+      additionalProperties: false
+      properties:
+        approvalMode:
+          enum:
+            - guardian
+            - manual
+            - yolo
+          type: string
+        archived:
+          type: boolean
+        model:
+          type: string
+        reasoningEffort:
+          type: string
+      type: object
+    UploadedView:
+      additionalProperties: false
+      properties:
+        height:
+          format: int64
+          type: integer
+        id:
+          type: string
+        width:
+          format: int64
+          type: integer
+      required:
+        - id
+        - width
+        - height
+      type: object
+    VerifyCodeInputBody:
+      additionalProperties: false
+      properties:
+        code:
+          type: string
+      required:
+        - code
+      type: object
+    WaitView:
+      additionalProperties: false
+      properties:
+        autoResolutionMs:
+          format: int64
+          type: integer
+        batchId:
+          type: string
+        itemId:
+          type: string
+        itemIds:
+          items:
+            type: string
+          type:
+            - array
+            - "null"
+        kind:
+          enum:
+            - tool_approval
+            - user_input
+          type: string
+        questions:
+          items:
+            $ref: "#/components/schemas/Question"
+          type:
+            - array
+            - "null"
+        turnId:
+          type: string
+      required:
+        - kind
+        - turnId
+      type: object
+info:
+  description: |-
+    助手对话及其接入面：线程、逐字稿、一次 turn 的执行与流式输出、工具调用与审批、追问、技能，以及通道、绑定和微信扫码登录。
+
+    ## 认证
+
+    所有接口都要求 `Authorization: Bearer <项目令牌>`。项目令牌向 `POST /api/v1/projects/{projectId}/token` 换取，登录服务是 auth.leaflow.net。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 `project_id`。
+
+    令牌无效或过期返回 401，不是当前项目的成员返回 403。这两种都应重新换取令牌后重试；仍然失败说明这个账号在该项目里已没有权限。
+
+    ## 一次对话
+
+    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}`）。
+
+    图片分两步发送：先 `POST /v1/attachments` 取得附件 id，再在发送消息时放进 `attachmentIds`。
+  title: Leaflow Assistant 用户 API
+  version: 1.0.0
+openapi: 3.1.0
+paths:
+  /v1/attachments:
+    post:
+      description: 请求体直接是文件字节，不使用 multipart 封装，一次上传一个文件。类型由内容判定，与 Content-Type 无关。返回的 id 在发送消息时放进 attachmentIds；从未被任何消息引用的附件会被定期清除。
+      operationId: upload-attachment
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+      requestBody:
+        content:
+          application/octet-stream:
+            schema:
+              contentMediaType: application/octet-stream
+              format: binary
+              type: string
+        required: true
+      responses:
+        "201":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/UploadedView"
+          description: Created
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 上传图片
+      tags:
+        - Attachment
+  /v1/attachments/{attachment}:
+    get:
+      description: 按附件 id 取回原始字节，可直接作为 <img> 的地址使用。响应带长期缓存头，附件内容不会变化。附件不存在或不属于当前用户时返回 404。
+      operationId: download-attachment
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: attachment
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 取回图片
+      tags:
+        - Attachment
+  /v1/bindings:
+    get:
+      operationId: list-bindings
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - explode: false
+          in: query
+          name: limit
+          schema:
+            default: 50
+            format: int64
+            maximum: 100
+            minimum: 0
+            type: integer
+        - explode: false
+          in: query
+          name: offset
+          schema:
+            format: int64
+            minimum: 0
+            type: integer
+        - explode: false
+          in: query
+          name: platform
+          schema:
+            type: string
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ListBindingsOutputBody"
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 列出绑定
+      tags:
+        - Onboarding
+  /v1/bindings/{binding}:
+    delete:
+      operationId: delete-binding
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: binding
+          required: true
+          schema:
+            format: uuid
+            type: string
+      responses:
+        "204":
+          description: No Content
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 解除绑定
+      tags:
+        - Onboarding
+  /v1/channels:
+    get:
+      operationId: list-channels
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - explode: false
+          in: query
+          name: limit
+          schema:
+            default: 50
+            format: int64
+            maximum: 100
+            minimum: 0
+            type: integer
+        - explode: false
+          in: query
+          name: offset
+          schema:
+            format: int64
+            minimum: 0
+            type: integer
+        - explode: false
+          in: query
+          name: platform
+          schema:
+            type: string
+        - description: 仅返回处于启用状态的通道
+          explode: false
+          in: query
+          name: active
+          schema:
+            description: 仅返回处于启用状态的通道
+            type: boolean
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ListChannelsOutputBody"
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 列出通道
+      tags:
+        - Onboarding
+    post:
+      operationId: create-channel
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateChannelInputBody"
+        required: true
+      responses:
+        "201":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ChannelView"
+          description: Created
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 创建通道
+      tags:
+        - Onboarding
+  /v1/channels/{channel}:
+    delete:
+      description: 删除后该通道不再接收入站消息，其上的绑定一并失效。项目处于停服或清理状态时本接口仍然可用。
+      operationId: delete-channel
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: channel
+          required: true
+          schema:
+            format: uuid
+            type: string
+      responses:
+        "204":
+          description: No Content
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 删除通道
+      tags:
+        - Onboarding
+    get:
+      operationId: get-channel
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: channel
+          required: true
+          schema:
+            format: uuid
+            type: string
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ChannelView"
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 查看通道
+      tags:
+        - Onboarding
+    patch:
+      operationId: update-channel
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: channel
+          required: true
+          schema:
+            format: uuid
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UpdateChannelInputBody"
+        required: true
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ChannelView"
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 修改通道
+      tags:
+        - Onboarding
+  /v1/channels/{channel}/claim-codes:
+    post:
+      description: 生成一个一次性认领码交给待绑定的人，他在该平台上用自己的账号把这个码发给助手即完成绑定。绑定只能由本人以这种方式建立，不能直接指定平台账号。认领码有有效期，过期后需重新签发。
+      operationId: create-claim-code
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: channel
+          required: true
+          schema:
+            format: uuid
+            type: string
+      responses:
+        "201":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ClaimCodeOutputBody"
+          description: Created
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 签发认领码
+      tags:
+        - Onboarding
+  /v1/channels/{channel}/rejections:
+    get:
+      description: 排查「发了消息但助手没有响应」时使用。按时间倒序返回最近被这条通道拒绝的入站消息及其拒绝原因，最常见的原因是发送方尚未绑定。
+      operationId: list-channel-rejections
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: channel
+          required: true
+          schema:
+            format: uuid
+            type: string
+        - explode: false
+          in: query
+          name: limit
+          schema:
+            default: 50
+            format: int64
+            maximum: 100
+            minimum: 0
+            type: integer
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ListRejectionsOutputBody"
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 查看最近被拒绝的入站消息
+      tags:
+        - Onboarding
+  /v1/channels/{channel}/secret:
+    post:
+      description: 生成新的回调密钥并立即使旧密钥失效。新密钥仅在本次响应中返回，之后无法再次取回，请先在平台侧完成配置。
+      operationId: rotate-channel-secret
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: channel
+          required: true
+          schema:
+            format: uuid
+            type: string
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/RotateSecretOutputBody"
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 轮换回调密钥
+      tags:
+        - Onboarding
+  /v1/channels/{channel}/weixin-logins:
+    post:
+      description: 微信个人号通道需要本人扫码登录后才能收发消息。本接口返回二维码，之后轮询 `GET /v1/weixin-logins/{login}` 获取进度；状态提示需要验证码时，调用 `POST /v1/weixin-logins/{login}/verify-code` 补交。
+      operationId: begin-weixin-login
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: channel
+          required: true
+          schema:
+            format: uuid
+            type: string
+      responses:
+        "201":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LoginView"
+          description: Created
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 发起微信扫码登录
+      tags:
+        - Onboarding
+  /v1/models:
+    get:
+      description: 返回本平台当前提供的模型及其上下文窗口、推理档位和支持的输入类型。用于填充对话设置里的模型选择。清单与项目无关，但仍需要有效的项目令牌。
+      operationId: list-models
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ListModelsOutputBody"
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 列出可用模型
+      tags:
+        - Thread
+  /v1/platforms:
+    get:
+      description: 返回本平台当前支持接入的即时通讯平台，以及各自建通道时需要提供的凭据字段。用于填充新建通道表单。
+      operationId: list-platforms
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ListPlatformsOutputBody"
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 列出可接入的平台
+      tags:
+        - Onboarding
+  /v1/threads:
+    get:
+      operationId: list-threads
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - description: 仅返回已归档的对话
+          explode: false
+          in: query
+          name: archived
+          schema:
+            description: 仅返回已归档的对话
+            type: boolean
+        - explode: false
+          in: query
+          name: limit
+          schema:
+            format: int64
+            maximum: 200
+            minimum: 0
+            type: integer
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ListThreadsOutputBody"
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 列出对话
+      tags:
+        - Thread
+    post:
+      operationId: create-thread
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateThreadInputBody"
+        required: true
+      responses:
+        "201":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ThreadSummaryView"
+          description: Created
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 创建对话
+      tags:
+        - Thread
+  /v1/threads/{thread}:
+    get:
+      description: 对话的完整当前状态，用于首屏渲染。文档中的 stream 给出实时输出地址和入场票据，流推送的是对这份文档的增量编辑，可直接套用同一套渲染逻辑。
+      operationId: get-thread
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: thread
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/DocumentView"
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 取回对话文档
+      tags:
+        - Thread
+    patch:
+      description: 可修改模型、推理档位、审批模式和归档状态。改动从下一次 turn 起生效，正在执行的 turn 沿用它启动时的设置。reasoningEffort 仅在同时提供 model 时生效。
+      operationId: update-thread
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: thread
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UpdateThreadInputBody"
+        required: true
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ThreadSummaryView"
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 修改对话设置
+      tags:
+        - Thread
+  /v1/threads/{thread}/approvals/{batch}:
+    post:
+      description: 批次 id 来自对话文档的 wait 字段。本接口是幂等的：重复提交同一批次不会改变已经生效的决定，也不会报错。批次不属于该对话时返回 404。
+      operationId: decide-approval
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: thread
+          required: true
+          schema:
+            type: string
+        - in: path
+          name: batch
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/DecideInputBody"
+        required: true
+      responses:
+        "204":
+          description: No Content
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 批准或拒绝一批工具调用
+      tags:
+        - Thread
+  /v1/threads/{thread}/interrupt:
+    post:
+      description: 对没有正在执行的 turn 的对话调用同样返回 204，不视为错误——用户点击停止与 turn 自然结束之间存在竞争，两种结果一致。项目处于停服或清理状态时本接口仍然可用。
+      operationId: interrupt-thread
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: thread
+          required: true
+          schema:
+            type: string
+      responses:
+        "204":
+          description: No Content
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 中断正在执行的 turn
+      tags:
+        - Thread
+  /v1/threads/{thread}/messages:
+    post:
+      description: 立即返回 turnId，不等待执行完成——一次 turn 可能持续数十分钟。执行进度通过对话文档中 stream 指向的实时流获取，不在本响应里。
+      operationId: send-message
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: thread
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/SendMessageInputBody"
+        required: true
+      responses:
+        "202":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/SendMessageOutputBody"
+          description: Accepted
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 发送消息并触发一次 turn
+      tags:
+        - Thread
+  /v1/threads/{thread}/questions/{item}:
+    post:
+      description: 问题 id 来自对话文档的 wait 字段。已被回答过的问题同样返回 204——可能是另一个页面提交在先，也可能是自动应答窗口已到期，两种情况下 turn 都已带着答案继续执行。
+      operationId: answer-question
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: thread
+          required: true
+          schema:
+            type: string
+        - in: path
+          name: item
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/AnswerInputBody"
+        required: true
+      responses:
+        "204":
+          description: No Content
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 回答助手提出的问题
+      tags:
+        - Thread
+  /v1/threads/{thread}/read:
+    post:
+      operationId: mark-thread-read
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: thread
+          required: true
+          schema:
+            type: string
+      responses:
+        "204":
+          description: No Content
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 标记对话已读
+      tags:
+        - Thread
+  /v1/threads/{thread}/revert:
+    post:
+      description: 撤回 ordinal 及其之后的全部条目。被撤回的条目仍留在逐字稿中并标记 reverted，序号不会重排。返回实际撤回的条目数。
+      operationId: revert-thread
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: thread
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/RevertInputBody"
+        required: true
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/RevertOutputBody"
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 从指定位置起撤回
+      tags:
+        - Thread
+  /v1/weixin-logins/{login}:
+    get:
+      description: 轮询本接口直到状态变为成功或失败。状态提示需要验证码时，调用补交验证码接口。
+      operationId: get-weixin-login
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: login
+          required: true
+          schema:
+            format: uuid
+            type: string
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LoginView"
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 查询扫码登录状态
+      tags:
+        - Onboarding
+  /v1/weixin-logins/{login}/verify-code:
+    post:
+      description: 微信在扫码后要求短信或设备验证码时使用。验证码由登录发起人在自己手机上获取。
+      operationId: submit-weixin-verify-code
+      parameters:
+        - description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+          in: header
+          name: Authorization
+          required: true
+          schema:
+            description: Bearer + 项目令牌。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 project_id
+            type: string
+        - in: path
+          name: login
+          required: true
+          schema:
+            format: uuid
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/VerifyCodeInputBody"
+        required: true
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LoginView"
+          description: OK
+        default:
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+          description: Error
+      summary: 补交登录验证码
+      tags:
+        - Onboarding
+