@leaflow/sdk 0.0.0-dev.113.g5d6fb99 → 0.0.0-dev.13.g732c6b7

package/README.md

@@ -0,0 +1,24 @@
+# leaflow-ts
+
+Leaflow 平台的 TypeScript SDK(`@leaflow/sdk`)。
+`gen/` 下全是产物,源在 `LeaflowNET/leaflowapis`。
+
+## 为什么和 Go 分开在两个仓库
+
+**它们在同一个仓库里会抢同一个 tag 空间。** Go 的子目录模块要 `go/v1.2.3` 这种带前缀的 tag,
+npm 要 `v1.2.3`——上一版两者挤在一个仓库里,结果是 Go 那半从来没被正确发布过,而没有任何东西
+会报错(`go get` 只是拿不到)。
+
+## 契约是一个 submodule
+
+```
+leaflowapis/    钉在某一个 commit 上——那个指针就是「这版 SDK 出自哪版契约」的答案
+```
+
+```
+git submodule update --remote leaflowapis   # 要跟进新契约时才做
+npm run generate
+```
+
+产物由人在本地跑完提交,CI 只验证不写回:一个会 commit 回来的流水线,在两次推送挨得近时只能靠
+重试或者强推——前者会打架,后者会丢东西。

package/dist/account/v1/index.d.ts

@@ -22,6 +22,8 @@ export type SubmitIdentityVerificationResult = operations["submit-identity-verif
 export type SubmitIdentityVerificationBody = NonNullable<operations["submit-identity-verification"]["requestBody"]>["content"]["application/json"];
 /** `GET /account/v1/me/invitations` 成功时的响应体。 */
 export type ListMyInvitationsResult = operations["list-my-invitations"]["responses"][200]["content"]["application/json"];
+/** `GET /account/v1/me/invitations` 的查询参数。 */
+export type ListMyInvitationsQuery = operations["list-my-invitations"]["parameters"]["query"];
 /** `POST /account/v1/me/invitations/accept` 成功时的响应体。 */
 export type AcceptInvitationByTokenResult = operations["accept-invitation-by-token"]["responses"][200]["content"]["application/json"];
 /** `POST /account/v1/me/invitations/accept` 的请求体。 */
@@ -30,6 +32,8 @@ export type AcceptInvitationByTokenBody = NonNullable<operations["accept-invitat
 export type AcceptInvitationResult = operations["accept-invitation"]["responses"][200]["content"]["application/json"];
 /** `GET /account/v1/projects` 成功时的响应体。 */
 export type ListProjectsResult = operations["list-projects"]["responses"][200]["content"]["application/json"];
+/** `GET /account/v1/projects` 的查询参数。 */
+export type ListProjectsQuery = operations["list-projects"]["parameters"]["query"];
 /** `POST /account/v1/projects` 成功时的响应体。 */
 export type CreateProjectResult = operations["create-project"]["responses"][201]["content"]["application/json"];
 /** `POST /account/v1/projects` 的请求体。 */

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

@@ -1,68 +1,80 @@
 export type { paths, components, operations, webhooks } from "./schema.js";
 import type { operations } from "./schema.js";
-/** `POST /v1/attachments` 成功时的响应体。 */
+/** `POST /api/v1/attachments` 成功时的响应体。 */
 export type UploadAttachmentResult = operations["upload-attachment"]["responses"][201]["content"]["application/json"];
-/** `GET /v1/bindings` 成功时的响应体。 */
+/** `GET /api/v1/bindings` 成功时的响应体。 */
 export type ListBindingsResult = operations["list-bindings"]["responses"][200]["content"]["application/json"];
-/** `GET /v1/bindings/{binding}` 成功时的响应体。 */
+/** `GET /api/v1/bindings` 的查询参数。 */
+export type ListBindingsQuery = operations["list-bindings"]["parameters"]["query"];
+/** `GET /api/v1/bindings/{binding}` 成功时的响应体。 */
 export type GetBindingResult = operations["get-binding"]["responses"][200]["content"]["application/json"];
-/** `GET /v1/channels` 成功时的响应体。 */
+/** `GET /api/v1/channels` 成功时的响应体。 */
 export type ListChannelsResult = operations["list-channels"]["responses"][200]["content"]["application/json"];
-/** `POST /v1/channels` 成功时的响应体。 */
+/** `GET /api/v1/channels` 的查询参数。 */
+export type ListChannelsQuery = operations["list-channels"]["parameters"]["query"];
+/** `POST /api/v1/channels` 成功时的响应体。 */
 export type CreateChannelResult = operations["create-channel"]["responses"][201]["content"]["application/json"];
-/** `POST /v1/channels` 的请求体。 */
+/** `POST /api/v1/channels` 的请求体。 */
 export type CreateChannelBody = NonNullable<operations["create-channel"]["requestBody"]>["content"]["application/json"];
-/** `GET /v1/channels/{channel}` 成功时的响应体。 */
+/** `GET /api/v1/channels/{channel}` 成功时的响应体。 */
 export type GetChannelResult = operations["get-channel"]["responses"][200]["content"]["application/json"];
-/** `PATCH /v1/channels/{channel}` 成功时的响应体。 */
+/** `PATCH /api/v1/channels/{channel}` 成功时的响应体。 */
 export type UpdateChannelResult = operations["update-channel"]["responses"][200]["content"]["application/json"];
-/** `PATCH /v1/channels/{channel}` 的请求体。 */
+/** `PATCH /api/v1/channels/{channel}` 的请求体。 */
 export type UpdateChannelBody = NonNullable<operations["update-channel"]["requestBody"]>["content"]["application/json"];
-/** `POST /v1/channels/{channel}/binding-codes` 成功时的响应体。 */
+/** `POST /api/v1/channels/{channel}/binding-codes` 成功时的响应体。 */
 export type CreateBindingCodeResult = operations["create-binding-code"]["responses"][201]["content"]["application/json"];
-/** `GET /v1/channels/{channel}/rejections` 成功时的响应体。 */
+/** `GET /api/v1/channels/{channel}/rejections` 成功时的响应体。 */
 export type ListChannelRejectionsResult = operations["list-channel-rejections"]["responses"][200]["content"]["application/json"];
-/** `POST /v1/channels/{channel}/secret` 成功时的响应体。 */
+/** `GET /api/v1/channels/{channel}/rejections` 的查询参数。 */
+export type ListChannelRejectionsQuery = operations["list-channel-rejections"]["parameters"]["query"];
+/** `POST /api/v1/channels/{channel}/secret` 成功时的响应体。 */
 export type RotateChannelSecretResult = operations["rotate-channel-secret"]["responses"][200]["content"]["application/json"];
-/** `POST /v1/channels/{channel}/secret` 的请求体。 */
+/** `POST /api/v1/channels/{channel}/secret` 的请求体。 */
 export type RotateChannelSecretBody = NonNullable<operations["rotate-channel-secret"]["requestBody"]>["content"]["application/json"];
-/** `GET /v1/channels/{channel}/sender-check` 成功时的响应体。 */
+/** `GET /api/v1/channels/{channel}/sender-check` 成功时的响应体。 */
 export type CheckSenderResult = operations["check-sender"]["responses"][200]["content"]["application/json"];
-/** `POST /v1/channels/{channel}/weixin-logins` 成功时的响应体。 */
+/** `GET /api/v1/channels/{channel}/sender-check` 的查询参数。 */
+export type CheckSenderQuery = operations["check-sender"]["parameters"]["query"];
+/** `POST /api/v1/channels/{channel}/weixin-logins` 成功时的响应体。 */
 export type BeginWeixinLoginResult = operations["begin-weixin-login"]["responses"][201]["content"]["application/json"];
-/** `GET /v1/platforms` 成功时的响应体。 */
+/** `GET /api/v1/platforms` 成功时的响应体。 */
 export type ListPlatformsResult = operations["list-platforms"]["responses"][200]["content"]["application/json"];
-/** `GET /v1/weixin-logins/{login}` 成功时的响应体。 */
+/** `GET /api/v1/weixin-logins/{login}` 成功时的响应体。 */
 export type GetWeixinLoginResult = operations["get-weixin-login"]["responses"][200]["content"]["application/json"];
-/** `POST /v1/weixin-logins/{login}/verify-code` 成功时的响应体。 */
+/** `POST /api/v1/weixin-logins/{login}/verify-code` 成功时的响应体。 */
 export type SubmitWeixinVerifyCodeResult = operations["submit-weixin-verify-code"]["responses"][200]["content"]["application/json"];
-/** `POST /v1/weixin-logins/{login}/verify-code` 的请求体。 */
+/** `POST /api/v1/weixin-logins/{login}/verify-code` 的请求体。 */
 export type SubmitWeixinVerifyCodeBody = NonNullable<operations["submit-weixin-verify-code"]["requestBody"]>["content"]["application/json"];
-/** `GET /v1/models` 成功时的响应体。 */
+/** `GET /api/v1/models` 成功时的响应体。 */
 export type ListModelsResult = operations["list-models"]["responses"][200]["content"]["application/json"];
-/** `GET /v1/threads` 成功时的响应体。 */
+/** `GET /api/v1/threads` 成功时的响应体。 */
 export type ListThreadsResult = operations["list-threads"]["responses"][200]["content"]["application/json"];
-/** `POST /v1/threads` 成功时的响应体。 */
+/** `GET /api/v1/threads` 的查询参数。 */
+export type ListThreadsQuery = operations["list-threads"]["parameters"]["query"];
+/** `POST /api/v1/threads` 成功时的响应体。 */
 export type CreateThreadResult = operations["create-thread"]["responses"][201]["content"]["application/json"];
-/** `POST /v1/threads` 的请求体。 */
+/** `POST /api/v1/threads` 的请求体。 */
 export type CreateThreadBody = NonNullable<operations["create-thread"]["requestBody"]>["content"]["application/json"];
-/** `GET /v1/threads/{thread}` 成功时的响应体。 */
+/** `GET /api/v1/threads/{thread}` 成功时的响应体。 */
 export type GetThreadResult = operations["get-thread"]["responses"][200]["content"]["application/json"];
-/** `PATCH /v1/threads/{thread}` 成功时的响应体。 */
+/** `PATCH /api/v1/threads/{thread}` 成功时的响应体。 */
 export type UpdateThreadResult = operations["update-thread"]["responses"][200]["content"]["application/json"];
-/** `PATCH /v1/threads/{thread}` 的请求体。 */
+/** `PATCH /api/v1/threads/{thread}` 的请求体。 */
 export type UpdateThreadBody = NonNullable<operations["update-thread"]["requestBody"]>["content"]["application/json"];
-/** `POST /v1/threads/{thread}/approvals/{batch}` 的请求体。 */
+/** `POST /api/v1/threads/{thread}/approvals/{batch}` 的请求体。 */
 export type DecideApprovalBody = NonNullable<operations["decide-approval"]["requestBody"]>["content"]["application/json"];
-/** `GET /v1/threads/{thread}/earlier` 成功时的响应体。 */
+/** `GET /api/v1/threads/{thread}/earlier` 成功时的响应体。 */
 export type ListEarlierItemsResult = operations["list-earlier-items"]["responses"][200]["content"]["application/json"];
-/** `POST /v1/threads/{thread}/messages` 成功时的响应体。 */
+/** `GET /api/v1/threads/{thread}/earlier` 的查询参数。 */
+export type ListEarlierItemsQuery = operations["list-earlier-items"]["parameters"]["query"];
+/** `POST /api/v1/threads/{thread}/messages` 成功时的响应体。 */
 export type SendMessageResult = operations["send-message"]["responses"][202]["content"]["application/json"];
-/** `POST /v1/threads/{thread}/messages` 的请求体。 */
+/** `POST /api/v1/threads/{thread}/messages` 的请求体。 */
 export type SendMessageBody = NonNullable<operations["send-message"]["requestBody"]>["content"]["application/json"];
-/** `POST /v1/threads/{thread}/questions/{item}` 的请求体。 */
+/** `POST /api/v1/threads/{thread}/questions/{item}` 的请求体。 */
 export type AnswerQuestionBody = NonNullable<operations["answer-question"]["requestBody"]>["content"]["application/json"];
-/** `POST /v1/threads/{thread}/revert` 成功时的响应体。 */
+/** `POST /api/v1/threads/{thread}/revert` 成功时的响应体。 */
 export type RevertThreadResult = operations["revert-thread"]["responses"][200]["content"]["application/json"];
-/** `POST /v1/threads/{thread}/revert` 的请求体。 */
+/** `POST /api/v1/threads/{thread}/revert` 的请求体。 */
 export type RevertThreadBody = NonNullable<operations["revert-thread"]["requestBody"]>["content"]["application/json"];

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

@@ -3,7 +3,7 @@
  * Do not make direct changes to the file.
  */
 export interface paths {
-    "/v1/attachments": {
+    "/api/v1/attachments": {
         parameters: {
             query?: never;
             header?: never;
@@ -23,7 +23,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/attachments/{attachment}": {
+    "/api/v1/attachments/{attachment}": {
         parameters: {
             query?: never;
             header?: never;
@@ -43,7 +43,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/bindings": {
+    "/api/v1/bindings": {
         parameters: {
             query?: never;
             header?: never;
@@ -63,7 +63,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/bindings/{binding}": {
+    "/api/v1/bindings/{binding}": {
         parameters: {
             query?: never;
             header?: never;
@@ -81,7 +81,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/channels": {
+    "/api/v1/channels": {
         parameters: {
             query?: never;
             header?: never;
@@ -102,7 +102,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/channels/{channel}": {
+    "/api/v1/channels/{channel}": {
         parameters: {
             query?: never;
             header?: never;
@@ -127,7 +127,7 @@ export interface paths {
         patch: operations["update-channel"];
         trace?: never;
     };
-    "/v1/channels/{channel}/binding-codes": {
+    "/api/v1/channels/{channel}/binding-codes": {
         parameters: {
             query?: never;
             header?: never;
@@ -147,7 +147,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/channels/{channel}/rejections": {
+    "/api/v1/channels/{channel}/rejections": {
         parameters: {
             query?: never;
             header?: never;
@@ -167,7 +167,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/channels/{channel}/secret": {
+    "/api/v1/channels/{channel}/secret": {
         parameters: {
             query?: never;
             header?: never;
@@ -187,7 +187,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/channels/{channel}/sender-check": {
+    "/api/v1/channels/{channel}/sender-check": {
         parameters: {
             query?: never;
             header?: never;
@@ -207,7 +207,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/channels/{channel}/weixin-logins": {
+    "/api/v1/channels/{channel}/weixin-logins": {
         parameters: {
             query?: never;
             header?: never;
@@ -227,7 +227,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/platforms": {
+    "/api/v1/platforms": {
         parameters: {
             query?: never;
             header?: never;
@@ -247,7 +247,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/weixin-logins/{login}": {
+    "/api/v1/weixin-logins/{login}": {
         parameters: {
             query?: never;
             header?: never;
@@ -267,7 +267,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/weixin-logins/{login}/verify-code": {
+    "/api/v1/weixin-logins/{login}/verify-code": {
         parameters: {
             query?: never;
             header?: never;
@@ -287,7 +287,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/models": {
+    "/api/v1/models": {
         parameters: {
             query?: never;
             header?: never;
@@ -307,7 +307,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/threads": {
+    "/api/v1/threads": {
         parameters: {
             query?: never;
             header?: never;
@@ -328,7 +328,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/threads/{thread}": {
+    "/api/v1/threads/{thread}": {
         parameters: {
             query?: never;
             header?: never;
@@ -352,7 +352,7 @@ export interface paths {
         patch: operations["update-thread"];
         trace?: never;
     };
-    "/v1/threads/{thread}/approvals/{batch}": {
+    "/api/v1/threads/{thread}/approvals/{batch}": {
         parameters: {
             query?: never;
             header?: never;
@@ -372,7 +372,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/threads/{thread}/earlier": {
+    "/api/v1/threads/{thread}/earlier": {
         parameters: {
             query?: never;
             header?: never;
@@ -392,7 +392,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/threads/{thread}/interrupt": {
+    "/api/v1/threads/{thread}/interrupt": {
         parameters: {
             query?: never;
             header?: never;
@@ -412,7 +412,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/threads/{thread}/messages": {
+    "/api/v1/threads/{thread}/messages": {
         parameters: {
             query?: never;
             header?: never;
@@ -432,7 +432,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/threads/{thread}/questions/{item}": {
+    "/api/v1/threads/{thread}/questions/{item}": {
         parameters: {
             query?: never;
             header?: never;
@@ -452,7 +452,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/threads/{thread}/read": {
+    "/api/v1/threads/{thread}/read": {
         parameters: {
             query?: never;
             header?: never;
@@ -469,7 +469,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/threads/{thread}/revert": {
+    "/api/v1/threads/{thread}/revert": {
         parameters: {
             query?: never;
             header?: never;
@@ -845,13 +845,13 @@ export interface components {
         DocumentResource: {
             context: components["schemas"]["ContextResource"];
             cursor: string | null;
-            earlier: components["schemas"]["EarlierResource"];
+            earlier: components["schemas"]["EarlierResource"] | null;
             items: components["schemas"]["ItemResource"][] | null;
             status: string;
-            stream: components["schemas"]["StreamResource"];
-            turn: components["schemas"]["TurnResource"];
+            stream: components["schemas"]["StreamResource"] | null;
+            turn: components["schemas"]["TurnResource"] | null;
             turnId: string | null;
-            wait: components["schemas"]["WaitResource"];
+            wait: components["schemas"]["WaitResource"] | null;
         };
         UpdateThreadRequestBody: {
             /** @enum {string} */
@@ -949,9 +949,13 @@ export interface operations {
             /** @description OK */
             200: {
                 headers: {
+                    /** @description 私有而且长缓存：这些字节按 id 寻址而 id 永不复用，所以它们永远不会变；而它们属于一个人，所以不能进任何共享缓存。 */
+                    "Cache-Control"?: string;
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "image/*": string;
+                };
             };
             /** @description Error */
             default: {

package/dist/canopy/v1/index.d.ts

@@ -2,6 +2,8 @@ export type { paths, components, operations, webhooks } from "./schema.js";
 import type { operations } from "./schema.js";
 /** `GET /api/v1/keys` 成功时的响应体。 */
 export type ListApiKeysResult = operations["list-api-keys"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/keys` 的查询参数。 */
+export type ListApiKeysQuery = operations["list-api-keys"]["parameters"]["query"];
 /** `POST /api/v1/keys` 成功时的响应体。 */
 export type CreateApiKeyResult = operations["create-api-key"]["responses"][201]["content"]["application/json"];
 /** `POST /api/v1/keys` 的请求体。 */
@@ -24,13 +26,23 @@ export type ListModelsResult = operations["list-models"]["responses"][200]["cont
 export type GetModelResult = operations["get-model"]["responses"][200]["content"]["application/json"];
 /** `GET /api/v1/requests` 成功时的响应体。 */
 export type ListRequestsResult = operations["list-requests"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/requests` 的查询参数。 */
+export type ListRequestsQuery = operations["list-requests"]["parameters"]["query"];
 /** `GET /api/v1/requests/{requestId}` 成功时的响应体。 */
 export type GetRequestResult = operations["get-request"]["responses"][200]["content"]["application/json"];
 /** `GET /api/v1/usage/by-api-key` 成功时的响应体。 */
 export type ListUsageByApiKeyResult = operations["list-usage-by-api-key"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/usage/by-api-key` 的查询参数。 */
+export type ListUsageByApiKeyQuery = operations["list-usage-by-api-key"]["parameters"]["query"];
 /** `GET /api/v1/usage/by-model` 成功时的响应体。 */
 export type ListUsageByModelResult = operations["list-usage-by-model"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/usage/by-model` 的查询参数。 */
+export type ListUsageByModelQuery = operations["list-usage-by-model"]["parameters"]["query"];
 /** `GET /api/v1/usage/summary` 成功时的响应体。 */
 export type GetUsageSummaryResult = operations["get-usage-summary"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/usage/summary` 的查询参数。 */
+export type GetUsageSummaryQuery = operations["get-usage-summary"]["parameters"]["query"];
 /** `GET /api/v1/usage/timeline` 成功时的响应体。 */
 export type GetUsageTimelineResult = operations["get-usage-timeline"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/usage/timeline` 的查询参数。 */
+export type GetUsageTimelineQuery = operations["get-usage-timeline"]["parameters"]["query"];

package/dist/compute/v1/index.d.ts

@@ -2,6 +2,8 @@ export type { paths, components, operations, webhooks } from "./schema.js";
 import type { operations } from "./schema.js";
 /** `GET /api/v1/backups` 成功时的响应体。 */
 export type ListBackupsResult = operations["list-backups"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/backups` 的查询参数。 */
+export type ListBackupsQuery = operations["list-backups"]["parameters"]["query"];
 /** `POST /api/v1/backups` 成功时的响应体。 */
 export type CreateBackupResult = operations["create-backup"]["responses"][201]["content"]["application/json"];
 /** `POST /api/v1/backups` 的请求体。 */
@@ -18,16 +20,24 @@ export type RestoreBackupResult = operations["restore-backup"]["responses"][201]
 export type RestoreBackupBody = NonNullable<operations["restore-backup"]["requestBody"]>["content"]["application/json"];
 /** `GET /api/v1/disk-types` 成功时的响应体。 */
 export type ListDiskTypesResult = operations["list-disk-types"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/disk-types` 的查询参数。 */
+export type ListDiskTypesQuery = operations["list-disk-types"]["parameters"]["query"];
 /** `GET /api/v1/images` 成功时的响应体。 */
 export type ListImagesResult = operations["list-images"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/images` 的查询参数。 */
+export type ListImagesQuery = operations["list-images"]["parameters"]["query"];
 /** `GET /api/v1/instance-types` 成功时的响应体。 */
 export type ListInstanceTypesResult = operations["list-instance-types"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/instance-types` 的查询参数。 */
+export type ListInstanceTypesQuery = operations["list-instance-types"]["parameters"]["query"];
 /** `GET /api/v1/regions` 成功时的响应体。 */
 export type ListRegionsResult = operations["list-regions"]["responses"][200]["content"]["application/json"];
 /** `GET /api/v1/regions/{regionCode}/availability-zones` 成功时的响应体。 */
 export type ListAvailabilityZonesResult = operations["list-availability-zones"]["responses"][200]["content"]["application/json"];
 /** `GET /api/v1/disks` 成功时的响应体。 */
 export type ListDisksResult = operations["list-disks"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/disks` 的查询参数。 */
+export type ListDisksQuery = operations["list-disks"]["parameters"]["query"];
 /** `POST /api/v1/disks` 成功时的响应体。 */
 export type CreateDiskResult = operations["create-disk"]["responses"][201]["content"]["application/json"];
 /** `POST /api/v1/disks` 的请求体。 */
@@ -84,6 +94,8 @@ export type ActOnInstanceBody = NonNullable<operations["act-on-instance"]["reque
 export type OpenInstanceConsoleResult = operations["open-instance-console"]["responses"][200]["content"]["application/json"];
 /** `GET /api/v1/instances/{instanceId}/console-output` 成功时的响应体。 */
 export type GetInstanceConsoleOutputResult = operations["get-instance-console-output"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/instances/{instanceId}/console-output` 的查询参数。 */
+export type GetInstanceConsoleOutputQuery = operations["get-instance-console-output"]["parameters"]["query"];
 /** `POST /api/v1/instances/{instanceId}/password` 成功时的响应体。 */
 export type ResetInstancePasswordResult = operations["reset-instance-password"]["responses"][200]["content"]["application/json"];
 /** `POST /api/v1/instances/{instanceId}/password` 的请求体。 */
@@ -124,6 +136,8 @@ export type AttachPortBody = NonNullable<operations["attach-port"]["requestBody"
 export type DetachPortResult = operations["detach-port"]["responses"][200]["content"]["application/json"];
 /** `GET /api/v1/operation-logs` 成功时的响应体。 */
 export type ListOperationLogsResult = operations["list-operation-logs"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/operation-logs` 的查询参数。 */
+export type ListOperationLogsQuery = operations["list-operation-logs"]["parameters"]["query"];
 /** `GET /api/v1/ports` 成功时的响应体。 */
 export type ListPortsResult = operations["list-ports"]["responses"][200]["content"]["application/json"];
 /** `POST /api/v1/ports` 成功时的响应体。 */
@@ -132,6 +146,8 @@ export type CreatePortResult = operations["create-port"]["responses"][201]["cont
 export type CreatePortBody = NonNullable<operations["create-port"]["requestBody"]>["content"]["application/json"];
 /** `GET /api/v1/private-images` 成功时的响应体。 */
 export type ListPrivateImagesResult = operations["list-private-images"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/private-images` 的查询参数。 */
+export type ListPrivateImagesQuery = operations["list-private-images"]["parameters"]["query"];
 /** `POST /api/v1/private-images` 成功时的响应体。 */
 export type CreatePrivateImageResult = operations["create-private-image"]["responses"][201]["content"]["application/json"];
 /** `POST /api/v1/private-images` 的请求体。 */
@@ -144,6 +160,8 @@ export type RenamePrivateImageResult = operations["rename-private-image"]["respo
 export type RenamePrivateImageBody = NonNullable<operations["rename-private-image"]["requestBody"]>["content"]["application/json"];
 /** `GET /api/v1/private-networks` 成功时的响应体。 */
 export type ListPrivateNetworksResult = operations["list-private-networks"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/private-networks` 的查询参数。 */
+export type ListPrivateNetworksQuery = operations["list-private-networks"]["parameters"]["query"];
 /** `POST /api/v1/private-networks` 成功时的响应体。 */
 export type CreatePrivateNetworkResult = operations["create-private-network"]["responses"][201]["content"]["application/json"];
 /** `POST /api/v1/private-networks` 的请求体。 */
@@ -172,8 +190,12 @@ export type CreateSubnetResult = operations["create-subnet"]["responses"][201]["
 export type CreateSubnetBody = NonNullable<operations["create-subnet"]["requestBody"]>["content"]["application/json"];
 /** `GET /api/v1/private-networks/{privateNetworkId}/subnets/next-free-cidr` 成功时的响应体。 */
 export type SuggestSubnetCidrResult = operations["suggest-subnet-cidr"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/private-networks/{privateNetworkId}/subnets/next-free-cidr` 的查询参数。 */
+export type SuggestSubnetCidrQuery = operations["suggest-subnet-cidr"]["parameters"]["query"];
 /** `GET /api/v1/security-groups` 成功时的响应体。 */
 export type ListSecurityGroupsResult = operations["list-security-groups"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/security-groups` 的查询参数。 */
+export type ListSecurityGroupsQuery = operations["list-security-groups"]["parameters"]["query"];
 /** `POST /api/v1/security-groups` 成功时的响应体。 */
 export type CreateSecurityGroupResult = operations["create-security-group"]["responses"][201]["content"]["application/json"];
 /** `POST /api/v1/security-groups` 的请求体。 */
@@ -188,6 +210,8 @@ export type CreateSecurityGroupRuleResult = operations["create-security-group-ru
 export type CreateSecurityGroupRuleBody = NonNullable<operations["create-security-group-rule"]["requestBody"]>["content"]["application/json"];
 /** `GET /api/v1/snapshots` 成功时的响应体。 */
 export type ListSnapshotsResult = operations["list-snapshots"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/snapshots` 的查询参数。 */
+export type ListSnapshotsQuery = operations["list-snapshots"]["parameters"]["query"];
 /** `POST /api/v1/snapshots` 成功时的响应体。 */
 export type CreateSnapshotResult = operations["create-snapshot"]["responses"][201]["content"]["application/json"];
 /** `POST /api/v1/snapshots` 的请求体。 */

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

@@ -1281,7 +1281,10 @@ export interface components {
             name: string;
             /** Format: int64 */
             size_gb: number;
-            /** @description 从该快照恢复。提供时容量只需不小于快照本身 */
+            /**
+             * Format: uuid
+             * @description 从该快照恢复。提供时容量只需不小于快照本身
+             */
             snapshot_id?: string;
         };
         RenameDiskRequestBody: {

package/dist/iam/v1/index.d.ts

@@ -14,12 +14,16 @@ export type UpdateProjectBody = NonNullable<operations["update-project"]["reques
 export type GetProjectMembershipResult = operations["get-project-membership"]["responses"][200]["content"]["application/json"];
 /** `GET /api/v1/invitations` 成功时的响应体。 */
 export type ListProjectInvitationsResult = operations["list-project-invitations"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/invitations` 的查询参数。 */
+export type ListProjectInvitationsQuery = operations["list-project-invitations"]["parameters"]["query"];
 /** `POST /api/v1/invitations` 成功时的响应体。 */
 export type IssueInvitationResult = operations["issue-invitation"]["responses"][201]["content"]["application/json"];
 /** `POST /api/v1/invitations` 的请求体。 */
 export type IssueInvitationBody = NonNullable<operations["issue-invitation"]["requestBody"]>["content"]["application/json"];
 /** `GET /api/v1/members` 成功时的响应体。 */
 export type ListMembersResult = operations["list-members"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/members` 的查询参数。 */
+export type ListMembersQuery = operations["list-members"]["parameters"]["query"];
 /** `PUT /api/v1/members/{userId}/roles` 成功时的响应体。 */
 export type SetMemberRolesResult = operations["set-member-roles"]["responses"][200]["content"]["application/json"];
 /** `PUT /api/v1/members/{userId}/roles` 的请求体。 */
@@ -42,6 +46,8 @@ export type UpdateRoleResult = operations["update-role"]["responses"][200]["cont
 export type UpdateRoleBody = NonNullable<operations["update-role"]["requestBody"]>["content"]["application/json"];
 /** `GET /api/v1/ssh-keys` 成功时的响应体。 */
 export type ListSshKeysResult = operations["list-ssh-keys"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/ssh-keys` 的查询参数。 */
+export type ListSshKeysQuery = operations["list-ssh-keys"]["parameters"]["query"];
 /** `POST /api/v1/ssh-keys` 成功时的响应体。 */
 export type CreateSshKeyResult = operations["create-ssh-key"]["responses"][201]["content"]["application/json"];
 /** `POST /api/v1/ssh-keys` 的请求体。 */

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

@@ -506,7 +506,7 @@ export interface components {
              * @default me
              * @enum {string}
              */
-            owner: "me" | "project";
+            owner?: "me" | "project";
             /** @description OpenSSH 格式的公钥。类型和指纹从它算出来，都不可改 */
             public_key: string;
             /** @description 用途标签，比如 ci、bastion */