@leaflow/sdk 0.1.3 → 0.2.0

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

@@ -2,357 +2,115 @@
  * Generated by orval v7.21.0 🍺
  * Do not edit manually.
  * Leaflow Assistant 用户 API
- * 助手对话及其接入面：线程、逐字稿、一次 turn 的执行与流式输出、工具调用与审批、追问、技能，以及通道、绑定和微信扫码登录。
+ * 控制台里的 AI 助手：对话、消息、工具调用与审批、附件，以及把助手接到微信、飞书、Telegram 等即时通讯平台上。
 
-## 认证
+## 一次对话
 
-所有接口都要求 `Authorization: Bearer <项目令牌>`。项目令牌向 `POST /api/v1/projects/{projectId}/token` 换取，登录服务是 auth.leaflow.net。一张项目令牌同时确定当前用户和当前项目，因此路径上不带 `project_id`。
+1. `POST /v1/threads` 创建对话；
+2. `POST /v1/threads/{thread}/messages` 发送消息，立即返回 `turnId`，助手的执行在后台进行；
+3. `GET /v1/threads/{thread}` 取回对话文档用于渲染，并按其中的 `stream` 连上实时输出；
+4. 助手需要用户参与时，文档中的 `wait` 会说明是哪一种：审批一批工具调用（`POST /v1/threads/{thread}/approvals/{batch}`），或回答几个问题（`POST /v1/threads/{thread}/questions/{item}`）。处理完成后助手自动继续。
 
-令牌无效或过期返回 401，不是当前项目的成员返回 403。这两种都应重新换取令牌后重试；仍然失败说明这个账号在该项目里已没有权限。
+发送图片分两步：先 `POST /v1/attachments` 上传拿到 id，发送消息时放进 `attachmentIds`。
 
-## 一次对话
+## 实时输出
+
+```
+GET /v1/turns/{turn}/stream?ticket=<ticket>&cursor=<cursor>
+```
 
-1. `POST /v1/threads` 创建线程；
-2. `POST /v1/threads/{thread}/messages` 发送消息。它立即返回 `turnId`，不等待执行完成——一次 turn 可能持续数十分钟；
-3. `GET /v1/threads/{thread}` 取回线程文档。文档中的 `stream` 给出实时输出的地址和入场票据；流推送的是对该文档的增量编辑，客户端渲染逻辑只有一套；
-4. turn 需要人工介入时，文档中的 `wait` 说明介入类型：批准一批工具调用（`POST /v1/threads/{thread}/approvals/{batch}`），或回答提出的问题（`POST /v1/threads/{thread}/questions/{item}`）。
+这是一条 Server-Sent Events 流，因此不在下方的接口列表中。
 
-图片分两步发送：先 `POST /v1/attachments` 取得附件 id，再在发送消息时放进 `attachmentIds`。
+- `path` 与 `ticket` 都取自对话文档的 `stream`。`path` 是相对路径，按取回文档的地址解析；
+- `cursor` 是起始位置，取自对话文档的 `cursor`。不传则从可用范围的开头开始；
+- 推送的每一条都是对那份对话文档的一次增量编辑，套用同一套渲染逻辑即可；
+- 连接有生存期，到时会正常关闭。使用 `EventSource` 时浏览器会自动携带 `Last-Event-ID` 重连并从断点续传，无需额外处理；
+- 三种结束事件：`done` 本次 turn 完成（附带最终状态）、`paused` 助手在等待用户处理（重新取回对话文档读 `wait`）、`stalled` 执行已中断且不会恢复，不要重连。
  * OpenAPI spec version: 1.0.0
  */
-export * from './answerInputBody.js';
-export * from './answerInputBody.js';
-export * from './answerInputBody.js';
-export * from './answerInputBody.js';
-export * from './answerInputBodyAnswers.js';
-export * from './answerInputBodyAnswers.js';
-export * from './answerInputBodyAnswers.js';
-export * from './answerInputBodyAnswers.js';
-export * from './attachmentView.js';
-export * from './attachmentView.js';
-export * from './attachmentView.js';
-export * from './attachmentView.js';
-export * from './bindingView.js';
-export * from './bindingView.js';
-export * from './bindingView.js';
-export * from './bindingView.js';
-export * from './bindingViewVerifiedAt.js';
-export * from './bindingViewVerifiedAt.js';
-export * from './bindingViewVerifiedAt.js';
-export * from './bindingViewVerifiedAt.js';
-export * from './channelView.js';
-export * from './channelView.js';
-export * from './channelView.js';
-export * from './channelView.js';
-export * from './channelViewAllowFrom.js';
-export * from './channelViewAllowFrom.js';
-export * from './channelViewAllowFrom.js';
-export * from './channelViewAllowFrom.js';
-export * from './choice.js';
-export * from './choice.js';
+export * from './answerRequestBody.js';
+export * from './answerRequestBodyAnswers.js';
+export * from './attachmentResource.js';
+export * from './bindingListResponseBody.js';
+export * from './bindingListResponseBodyBindings.js';
+export * from './bindingResource.js';
+export * from './bindingResourceVerifiedAt.js';
+export * from './channelListResponseBody.js';
+export * from './channelListResponseBodyChannels.js';
+export * from './channelResource.js';
+export * from './channelResourceAllowFrom.js';
+export * from './channelResourceWebhookUrl.js';
 export * from './choice.js';
-export * from './choice.js';
-export * from './claimCodeOutputBody.js';
-export * from './claimCodeOutputBody.js';
-export * from './claimCodeOutputBody.js';
-export * from './claimCodeOutputBody.js';
-export * from './contextView.js';
-export * from './contextView.js';
-export * from './contextView.js';
-export * from './contextView.js';
-export * from './contextViewCompactAt.js';
-export * from './contextViewCompactAt.js';
-export * from './contextViewCompactAt.js';
-export * from './contextViewCompactAt.js';
-export * from './contextViewUsed.js';
-export * from './contextViewUsed.js';
-export * from './contextViewUsed.js';
-export * from './contextViewUsed.js';
-export * from './contextViewWindow.js';
-export * from './contextViewWindow.js';
-export * from './contextViewWindow.js';
-export * from './contextViewWindow.js';
-export * from './createChannelInputBody.js';
-export * from './createChannelInputBody.js';
-export * from './createChannelInputBody.js';
-export * from './createChannelInputBody.js';
-export * from './createChannelInputBodyAllowFrom.js';
-export * from './createChannelInputBodyAllowFrom.js';
-export * from './createChannelInputBodyAllowFrom.js';
-export * from './createChannelInputBodyAllowFrom.js';
-export * from './createChannelInputBodyCredentials.js';
-export * from './createChannelInputBodyCredentials.js';
-export * from './createChannelInputBodyCredentials.js';
-export * from './createChannelInputBodyCredentials.js';
-export * from './createThreadInputBody.js';
-export * from './createThreadInputBody.js';
-export * from './createThreadInputBody.js';
-export * from './createThreadInputBody.js';
-export * from './createThreadInputBodyApprovalMode.js';
-export * from './createThreadInputBodyApprovalMode.js';
-export * from './createThreadInputBodyApprovalMode.js';
-export * from './createThreadInputBodyApprovalMode.js';
-export * from './decideInputBody.js';
-export * from './decideInputBody.js';
-export * from './decideInputBody.js';
-export * from './decideInputBody.js';
-export * from './documentView.js';
-export * from './documentView.js';
-export * from './documentView.js';
-export * from './documentView.js';
-export * from './documentViewCursor.js';
-export * from './documentViewCursor.js';
-export * from './documentViewCursor.js';
-export * from './documentViewCursor.js';
-export * from './documentViewItems.js';
-export * from './documentViewItems.js';
-export * from './documentViewItems.js';
-export * from './documentViewItems.js';
-export * from './documentViewTurnId.js';
-export * from './documentViewTurnId.js';
-export * from './documentViewTurnId.js';
-export * from './documentViewTurnId.js';
-export * from './earlierView.js';
-export * from './earlierView.js';
-export * from './earlierView.js';
-export * from './earlierView.js';
-export * from './entry.js';
-export * from './entry.js';
-export * from './entry.js';
+export * from './claimCodeResponseBody.js';
+export * from './contextResource.js';
+export * from './contextResourceCompactAt.js';
+export * from './contextResourceUsed.js';
+export * from './contextResourceWindow.js';
+export * from './createChannelRequestBody.js';
+export * from './createChannelRequestBodyAllowFrom.js';
+export * from './createChannelRequestBodyCredentials.js';
+export * from './createThreadRequestBody.js';
+export * from './createThreadRequestBodyApprovalMode.js';
+export * from './decideRequestBody.js';
+export * from './documentResource.js';
+export * from './documentResourceCursor.js';
+export * from './documentResourceItems.js';
+export * from './documentResourceTurnId.js';
+export * from './earlierResource.js';
 export * from './entry.js';
 export * from './error.js';
-export * from './error.js';
-export * from './error.js';
-export * from './error.js';
-export * from './errorMeta.js';
 export * from './errorMeta.js';
-export * from './errorMeta.js';
-export * from './errorMeta.js';
-export * from './itemView.js';
-export * from './itemView.js';
-export * from './itemView.js';
-export * from './itemView.js';
-export * from './itemViewApproval.js';
-export * from './itemViewApproval.js';
-export * from './itemViewApproval.js';
-export * from './itemViewApproval.js';
-export * from './itemViewApprovalReason.js';
-export * from './itemViewApprovalReason.js';
-export * from './itemViewApprovalReason.js';
-export * from './itemViewApprovalReason.js';
-export * from './itemViewAttachments.js';
-export * from './itemViewAttachments.js';
-export * from './itemViewAttachments.js';
-export * from './itemViewAttachments.js';
-export * from './itemViewDetail.js';
-export * from './itemViewDetail.js';
-export * from './itemViewDetail.js';
-export * from './itemViewDetail.js';
-export * from './itemViewDurationMs.js';
-export * from './itemViewDurationMs.js';
-export * from './itemViewDurationMs.js';
-export * from './itemViewDurationMs.js';
-export * from './itemViewModel.js';
-export * from './itemViewModel.js';
-export * from './itemViewModel.js';
-export * from './itemViewModel.js';
-export * from './itemViewNamespace.js';
-export * from './itemViewNamespace.js';
-export * from './itemViewNamespace.js';
-export * from './itemViewNamespace.js';
-export * from './itemViewStatus.js';
-export * from './itemViewStatus.js';
-export * from './itemViewStatus.js';
-export * from './itemViewStatus.js';
-export * from './itemViewTarget.js';
-export * from './itemViewTarget.js';
-export * from './itemViewTarget.js';
-export * from './itemViewTarget.js';
-export * from './itemViewTool.js';
-export * from './itemViewTool.js';
-export * from './itemViewTool.js';
-export * from './itemViewTool.js';
-export * from './itemViewType.js';
-export * from './itemViewType.js';
-export * from './itemViewType.js';
-export * from './itemViewType.js';
-export * from './listBindingsOutputBody.js';
-export * from './listBindingsOutputBody.js';
-export * from './listBindingsOutputBody.js';
-export * from './listBindingsOutputBody.js';
-export * from './listBindingsOutputBodyBindings.js';
-export * from './listBindingsOutputBodyBindings.js';
-export * from './listBindingsOutputBodyBindings.js';
-export * from './listBindingsOutputBodyBindings.js';
-export * from './listBindingsParams.js';
-export * from './listBindingsParams.js';
+export * from './itemResource.js';
+export * from './itemResourceApproval.js';
+export * from './itemResourceApprovalReason.js';
+export * from './itemResourceAttachments.js';
+export * from './itemResourceDetail.js';
+export * from './itemResourceDurationMs.js';
+export * from './itemResourceModel.js';
+export * from './itemResourceNamespace.js';
+export * from './itemResourceStatus.js';
+export * from './itemResourceTarget.js';
+export * from './itemResourceTool.js';
+export * from './itemResourceType.js';
 export * from './listBindingsParams.js';
-export * from './listBindingsParams.js';
-export * from './listChannelRejectionsParams.js';
-export * from './listChannelRejectionsParams.js';
-export * from './listChannelRejectionsParams.js';
 export * from './listChannelRejectionsParams.js';
-export * from './listChannelsOutputBody.js';
-export * from './listChannelsOutputBody.js';
-export * from './listChannelsOutputBody.js';
-export * from './listChannelsOutputBody.js';
-export * from './listChannelsOutputBodyChannels.js';
-export * from './listChannelsOutputBodyChannels.js';
-export * from './listChannelsOutputBodyChannels.js';
-export * from './listChannelsOutputBodyChannels.js';
 export * from './listChannelsParams.js';
-export * from './listChannelsParams.js';
-export * from './listChannelsParams.js';
-export * from './listChannelsParams.js';
-export * from './listModelsOutputBody.js';
-export * from './listModelsOutputBody.js';
-export * from './listModelsOutputBody.js';
-export * from './listModelsOutputBody.js';
-export * from './listModelsOutputBodyModels.js';
-export * from './listModelsOutputBodyModels.js';
-export * from './listModelsOutputBodyModels.js';
-export * from './listModelsOutputBodyModels.js';
-export * from './listPlatformsOutputBody.js';
-export * from './listPlatformsOutputBody.js';
-export * from './listPlatformsOutputBody.js';
-export * from './listPlatformsOutputBody.js';
-export * from './listPlatformsOutputBodyPlatforms.js';
-export * from './listPlatformsOutputBodyPlatforms.js';
-export * from './listPlatformsOutputBodyPlatforms.js';
-export * from './listPlatformsOutputBodyPlatforms.js';
-export * from './listRejectionsOutputBody.js';
-export * from './listRejectionsOutputBody.js';
-export * from './listRejectionsOutputBody.js';
-export * from './listRejectionsOutputBody.js';
-export * from './listRejectionsOutputBodyRejections.js';
-export * from './listRejectionsOutputBodyRejections.js';
-export * from './listRejectionsOutputBodyRejections.js';
-export * from './listRejectionsOutputBodyRejections.js';
-export * from './listThreadsOutputBody.js';
-export * from './listThreadsOutputBody.js';
-export * from './listThreadsOutputBody.js';
-export * from './listThreadsOutputBody.js';
-export * from './listThreadsOutputBodyThreads.js';
-export * from './listThreadsOutputBodyThreads.js';
-export * from './listThreadsOutputBodyThreads.js';
-export * from './listThreadsOutputBodyThreads.js';
-export * from './listThreadsParams.js';
 export * from './listThreadsParams.js';
-export * from './listThreadsParams.js';
-export * from './listThreadsParams.js';
-export * from './loginView.js';
-export * from './loginView.js';
-export * from './loginView.js';
-export * from './loginView.js';
-export * from './modelView.js';
-export * from './modelView.js';
-export * from './modelView.js';
-export * from './modelView.js';
-export * from './modelViewInputModalities.js';
-export * from './modelViewInputModalities.js';
-export * from './modelViewInputModalities.js';
-export * from './modelViewInputModalities.js';
-export * from './modelViewReasoningTiers.js';
-export * from './modelViewReasoningTiers.js';
-export * from './modelViewReasoningTiers.js';
-export * from './modelViewReasoningTiers.js';
-export * from './platformView.js';
-export * from './platformView.js';
-export * from './platformView.js';
-export * from './platformView.js';
-export * from './question.js';
-export * from './question.js';
+export * from './loginResource.js';
+export * from './modelListResponseBody.js';
+export * from './modelListResponseBodyModels.js';
+export * from './modelResource.js';
+export * from './modelResourceInputModalities.js';
+export * from './modelResourceReasoningTiers.js';
+export * from './platformListResponseBody.js';
+export * from './platformListResponseBodyPlatforms.js';
+export * from './platformResource.js';
+export * from './platformResourceWebhookUrlTemplate.js';
 export * from './question.js';
-export * from './question.js';
-export * from './questionChoices.js';
-export * from './questionChoices.js';
-export * from './questionChoices.js';
 export * from './questionChoices.js';
-export * from './revertInputBody.js';
-export * from './revertInputBody.js';
-export * from './revertInputBody.js';
-export * from './revertInputBody.js';
-export * from './revertOutputBody.js';
-export * from './revertOutputBody.js';
-export * from './revertOutputBody.js';
-export * from './revertOutputBody.js';
-export * from './rotateSecretOutputBody.js';
-export * from './rotateSecretOutputBody.js';
-export * from './rotateSecretOutputBody.js';
-export * from './rotateSecretOutputBody.js';
-export * from './sendMessageInputBody.js';
-export * from './sendMessageInputBody.js';
-export * from './sendMessageInputBody.js';
-export * from './sendMessageInputBody.js';
-export * from './sendMessageInputBodyAttachmentIds.js';
-export * from './sendMessageInputBodyAttachmentIds.js';
-export * from './sendMessageInputBodyAttachmentIds.js';
-export * from './sendMessageInputBodyAttachmentIds.js';
-export * from './sendMessageOutputBody.js';
-export * from './sendMessageOutputBody.js';
-export * from './sendMessageOutputBody.js';
-export * from './sendMessageOutputBody.js';
-export * from './streamView.js';
-export * from './streamView.js';
-export * from './streamView.js';
-export * from './streamView.js';
-export * from './threadSummaryView.js';
-export * from './threadSummaryView.js';
-export * from './threadSummaryView.js';
-export * from './threadSummaryView.js';
-export * from './threadSummaryViewApprovalMode.js';
-export * from './threadSummaryViewApprovalMode.js';
-export * from './threadSummaryViewApprovalMode.js';
-export * from './threadSummaryViewApprovalMode.js';
-export * from './threadSummaryViewTitle.js';
-export * from './threadSummaryViewTitle.js';
-export * from './threadSummaryViewTitle.js';
-export * from './threadSummaryViewTitle.js';
-export * from './turnView.js';
-export * from './turnView.js';
-export * from './turnView.js';
-export * from './turnView.js';
-export * from './turnViewApprovalMode.js';
-export * from './turnViewApprovalMode.js';
-export * from './turnViewApprovalMode.js';
-export * from './turnViewApprovalMode.js';
-export * from './updateChannelInputBody.js';
-export * from './updateChannelInputBody.js';
-export * from './updateChannelInputBody.js';
-export * from './updateChannelInputBody.js';
-export * from './updateChannelInputBodyCredentials.js';
-export * from './updateChannelInputBodyCredentials.js';
-export * from './updateChannelInputBodyCredentials.js';
-export * from './updateChannelInputBodyCredentials.js';
-export * from './updateThreadInputBody.js';
-export * from './updateThreadInputBody.js';
-export * from './updateThreadInputBody.js';
-export * from './updateThreadInputBody.js';
-export * from './updateThreadInputBodyApprovalMode.js';
-export * from './updateThreadInputBodyApprovalMode.js';
-export * from './updateThreadInputBodyApprovalMode.js';
-export * from './updateThreadInputBodyApprovalMode.js';
-export * from './uploadedView.js';
-export * from './uploadedView.js';
-export * from './uploadedView.js';
-export * from './uploadedView.js';
-export * from './verifyCodeInputBody.js';
-export * from './verifyCodeInputBody.js';
-export * from './verifyCodeInputBody.js';
-export * from './verifyCodeInputBody.js';
-export * from './waitView.js';
-export * from './waitView.js';
-export * from './waitView.js';
-export * from './waitView.js';
-export * from './waitViewItemIds.js';
-export * from './waitViewItemIds.js';
-export * from './waitViewItemIds.js';
-export * from './waitViewItemIds.js';
-export * from './waitViewKind.js';
-export * from './waitViewKind.js';
-export * from './waitViewKind.js';
-export * from './waitViewKind.js';
-export * from './waitViewQuestions.js';
-export * from './waitViewQuestions.js';
-export * from './waitViewQuestions.js';
-export * from './waitViewQuestions.js';
+export * from './rejectionListResponseBody.js';
+export * from './rejectionListResponseBodyRejections.js';
+export * from './revertRequestBody.js';
+export * from './revertedCountResponseBody.js';
+export * from './sendMessageRequestBody.js';
+export * from './sendMessageRequestBodyAttachmentIds.js';
+export * from './streamResource.js';
+export * from './threadListResponseBody.js';
+export * from './threadListResponseBodyThreads.js';
+export * from './threadSummaryResource.js';
+export * from './threadSummaryResourceApprovalMode.js';
+export * from './threadSummaryResourceTitle.js';
+export * from './turnIDResponseBody.js';
+export * from './turnResource.js';
+export * from './turnResourceApprovalMode.js';
+export * from './updateChannelRequestBody.js';
+export * from './updateChannelRequestBodyCredentials.js';
+export * from './updateThreadRequestBody.js';
+export * from './updateThreadRequestBodyApprovalMode.js';
+export * from './uploadedResource.js';
+export * from './verifyCodeRequestBody.js';
+export * from './waitResource.js';
+export * from './waitResourceItemIds.js';
+export * from './waitResourceKind.js';
+export * from './waitResourceQuestions.js';
+export * from './webhookSecretResponseBody.js';