@leaflow/sdk 0.17.0 → 0.19.0

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

@@ -46,6 +46,8 @@ export type GetWeixinLoginResult = operations["get-weixin-login"]["responses"][2
 export type SubmitWeixinVerifyCodeResult = operations["submit-weixin-verify-code"]["responses"][200]["content"]["application/json"];
 /** `POST /api/v1/weixin-logins/{login}/verify-code` 的请求体。 */
 export type SubmitWeixinVerifyCodeBody = NonNullable<operations["submit-weixin-verify-code"]["requestBody"]>["content"]["application/json"];
+/** `POST /api/v1/dynamic-calls/{call}/result` 的请求体。 */
+export type SubmitDynamicCallResultBody = NonNullable<operations["submit-dynamic-call-result"]["requestBody"]>["content"]["application/json"];
 /** `GET /api/v1/memories` 成功时的响应体。 */
 export type ListMemoriesResult = operations["list-memories"]["responses"][200]["content"]["application/json"];
 /** `GET /api/v1/models` 成功时的响应体。 */

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

@@ -287,6 +287,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/dynamic-calls/{call}/result": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Report what an action produced
+         * @description The assistant asks the client to run an action by adding a tool call to the conversation
+         *     with the namespace `dynamic`; the client acts when that entry turns in_progress and reports
+         *     back here.
+         *
+         *     The first result is the one that counts. A later one is refused rather than replacing it.
+         */
+        post: operations["submit-dynamic-call-result"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/memories": {
         parameters: {
             query?: never;
@@ -387,7 +411,7 @@ export interface paths {
         head?: never;
         /**
          * Update conversation settings
-         * @description Changes the model, reasoning level, approval mode and archived state. A change takes effect from the next turn; a turn already running keeps the settings it started with. reasoningEffort only applies when model is given as well.
+         * @description Changes the model, reasoning level, approval mode and archived state. A change takes effect from the next turn; a turn already running keeps the settings it started with. Model and reasoning level change independently: sending one leaves the other alone.
          */
         patch: operations["update-thread"];
         trace?: never;
@@ -795,6 +819,8 @@ export interface components {
             models: components["schemas"]["ModelResource"][] | null;
         };
         ThreadSummaryResource: {
+            /** @description The tier this conversation runs at, or null when it follows the model's own default. */
+            reasoningEffort: string | null;
             /** @enum {string} */
             approvalMode: "guardian" | "manual" | "yolo";
             archived: boolean;
@@ -818,6 +844,8 @@ export interface components {
             approvalMode?: "guardian" | "manual" | "yolo";
         };
         ContextResource: {
+            /** @description The tier this conversation runs at, or null when it follows the model's own default. */
+            reasoningEffort: string | null;
             /** Format: int64 */
             compactAt: number | null;
             model: string;
@@ -846,6 +874,17 @@ export interface components {
             approvalReason?: string | null;
             arguments?: string;
             attachments?: components["schemas"]["AttachmentResource"][] | null;
+            /**
+             * @description The context blocks the client attached to this message.
+             *
+             *     **Not part of what the operator wrote** — `text` is. Render the message from `text` and
+             *     leave these out of the bubble; they are here so a client that did not send them, or one
+             *     that reloaded, can still read what the assistant was given.
+             *
+             *     The actions declared alongside them are not returned: they are re-declared as they
+             *     change and would make every fetch of the conversation carry them again.
+             */
+            clientContext?: components["schemas"]["ClientContextPart"][] | null;
             /** Format: date-time */
             createdAt: string;
             detail?: string | null;
@@ -916,7 +955,13 @@ export interface components {
             approvalMode?: "guardian" | "manual" | "yolo";
             archived?: boolean;
             model?: string;
-            reasoningEffort?: string;
+            /**
+             * @description Which reasoning tier to run at, from the model's `reasoningTiers`. Null puts it back to
+             *     the model's own default; leaving it out keeps whatever is set.
+             *
+             *     Independent of `model` — sending one does not touch the other.
+             */
+            reasoningEffort?: string | null;
         };
         DecideRequestBody: {
             approved: boolean;
@@ -927,9 +972,97 @@ export interface components {
             items: components["schemas"]["ItemResource"][] | null;
         };
         SendMessageRequestBody: {
-            /** @description Ids of attachments uploaded earlier that are not yet bound to any message */
-            attachmentIds?: string[] | null;
-            text: string;
+            client?: components["schemas"]["ClientContextRequest"];
+            /**
+             * @description The message, in the order it was written. A message with nothing but text is a single
+             *     text part; that is the ordinary case and nothing else is required.
+             */
+            parts: components["schemas"]["MessagePart"][];
+        };
+        /**
+         * @description One piece of a message. `type` says which of the fields below carries it:
+         *
+         *     - `text` — the words, in `text`
+         *     - `file` — an attachment uploaded earlier, by id in `attachmentId`
+         *     - `data-<something>` — context from the client, in `data`. The name after `data-` is yours;
+         *       it is shown to the assistant so it can tell one kind of block from another.
+         *
+         *     Order matters: an image belongs where it was written, not at the end.
+         */
+        MessagePart: {
+            /** @description For `file` parts. The attachment must have been uploaded and not yet bound to another message. */
+            attachmentId?: string | null;
+            /** @description For `data-*` parts. Any object; its keys reach the assistant as they are. */
+            data?: {
+                [key: string]: unknown;
+            } | null;
+            /** @description For `text` parts. */
+            text?: string | null;
+            type: string;
+        };
+        /**
+         * @description Which client this is and what it can do, so the assistant can ask it to do those things
+         *     while it answers. What the operator is looking at travels as `data-*` parts on the message.
+         *
+         *     Send `actions` only when they differ from the last message on this conversation. Sending the
+         *     block without `actions` keeps whatever was declared before.
+         */
+        ClientContextRequest: {
+            /** @description The actions on offer right now. Omit when unchanged since the last message. */
+            actions?: components["schemas"]["ClientActionRequest"][] | null;
+            /** @description Identifies this client while it stays open. Any stable string; one per tab or process. */
+            clientId: string;
+            /** @description How the client calls itself, for example "Leaflow console (web)". */
+            label?: string;
+        };
+        /** @description A `data-*` part as it was sent. */
+        ClientContextPart: {
+            data: {
+                [key: string]: unknown;
+            };
+            type: string;
+        };
+        /** @description The shape of a tool in the OpenAI Chat Completions API, plus `readOnly` and `timeoutMs`. */
+        ClientActionRequest: {
+            function: components["schemas"]["ClientFunctionRequest"];
+            /** @description True when the action changes nothing outside the client. Anything else goes through this conversation's approval before it runs. */
+            readOnly: boolean;
+            /**
+             * Format: int64
+             * @description How long the assistant should wait for this action. Omit for the default; longer values are capped.
+             */
+            timeoutMs?: number;
+            /**
+             * @description Only functions are supported.
+             * @default function
+             * @enum {string}
+             */
+            type?: "function";
+        };
+        /** @description The function object from the OpenAI tools format. */
+        ClientFunctionRequest: {
+            /** @description What the action does, written for the model. An action without one can only be guessed at from its name. */
+            description: string;
+            /** @description The MCP and Anthropic spelling of `parameters`. Give one or the other, not both. */
+            inputSchema?: {
+                [key: string]: unknown;
+            } | null;
+            name: string;
+            /** @description JSON Schema for the arguments. Omit for an action that takes none. */
+            parameters?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        DynamicCallResultRequestBody: {
+            /** @description The same value sent with the message. A result from a different client is refused. */
+            clientId: string;
+            /** @description Why it failed, when `ok` is false. It reaches the assistant, so write it for a reader who cannot see the screen. */
+            error?: string;
+            /** @description Pass back when there is more to read. The assistant will call again with it. */
+            nextCursor?: string;
+            ok: boolean;
+            /** @description What the action produced. At most 64 KiB; use `nextCursor` for anything larger. */
+            output?: string;
         };
         TodoResource: {
             /** @description The same step phrased as happening now — "Installing nginx". Show this one while the item is in progress. */
@@ -1569,6 +1702,40 @@ export interface operations {
             };
         };
     };
+    "submit-dynamic-call-result": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The id of the tool call entry in the conversation. */
+                call: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DynamicCallResultRequestBody"];
+            };
+        };
+        responses: {
+            /** @description No Content */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "list-memories": {
         parameters: {
             query?: never;

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

@@ -368,7 +368,9 @@ export interface paths {
          *
          *     Instances are created one by one in order. If the sequence stops part way through, because of a quota limit for example, **the instances already created are kept** and `failure` states why it stopped. A failure on the first instance is treated as a failure of the whole request and no instance is created.
          *
-         *     Exactly one image source must be given: `image_id` for a platform image, `private_image_id` for a private image. Supplying both or neither is rejected.
+         *     Exactly one source must be given: `image_id` for a platform image, `private_image_id` for a private image, or `boot_disk_id` to boot a disk you already have. Supplying more than one, or none, is rejected.
+         *
+         *     `boot_disk_id` recovers an instance that can no longer be repaired from the inside. Snapshot its disk, restore that snapshot into a new disk, attach the new disk to another instance and repair it there, then create an instance from it. That disk is not deleted when the instance is released; it is detached and returned to you.
          *
          *     Instances are created in the availability zone of the instance type. Disks to be attached later must reside in the same zone.
          *
@@ -1494,6 +1496,11 @@ export interface components {
             hostname: string;
             /** Format: uuid */
             id: string;
+            /**
+             * Format: uuid
+             * @description Non-empty when the instance was created from a disk you already had, instead of from an image
+             */
+            boot_disk_id: string | null;
             /**
              * Format: uuid
              * @description Non-empty when the instance was created from a platform image
@@ -1564,13 +1571,20 @@ export interface components {
             generate_password?: boolean;
             /**
              * Format: uuid
-             * @description A platform image. Exactly one of this and `private_image_id`
+             * @description Boot a disk you already have instead of installing an image. The disk must be available, unattached, and in the same availability zone as the instance type. Exactly one of this, `image_id` and `private_image_id`
+             */
+            boot_disk_id?: string;
+            /**
+             * Format: uuid
+             * @description A platform image. Exactly one of this, `private_image_id` and `boot_disk_id`
              */
             image_id?: string;
             /** Format: uuid */
             instance_type_id: string;
+            /** @description The account the disk lets you log in as. Required with `boot_disk_id`, and rejected without it since an image states its own */
+            login_username?: string;
             name: string;
-            /** @description Root password. Only the SSH public keys of the project are used when omitted */
+            /** @description The password to set, on the login account and on root. Only the SSH public keys of the project are used when omitted */
             password?: string;
             /**
              * Format: uuid
@@ -1579,12 +1593,12 @@ export interface components {
             port_id?: string;
             /**
              * Format: uuid
-             * @description A private image. Exactly one of this and `image_id`
+             * @description A private image. Exactly one of this, `image_id` and `boot_disk_id`
              */
             private_image_id?: string;
             /**
              * Format: int64
-             * @description System disk capacity in GB. Chosen automatically from the requirement of the image and the platform minimum when omitted
+             * @description System disk capacity in GB. Chosen automatically from the requirement of the image and the platform minimum when omitted. Ignored with `boot_disk_id`, since that disk already has its capacity
              */
             root_disk_gb?: number;
             /** @description Required when a primary network interface is created, at least one; the default security group is not applied automatically. Ignored together with `port_id`, as the security groups of that interface were fixed when it was created */

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

@@ -14,6 +14,8 @@ export interface paths {
          * 查看本项目的四层隧道
          * @description 还没生成过时返回 `TUNNEL_NOT_FOUND`——首屏据此决定画「生成订阅链接」那个按钮还是画结果。
          *
+         *     项目未获开放时返回 403 `TUNNEL_NOT_ENTITLED`，那是另一件事：控制台据此把四层隧道的入口整个收起来，而不是画那个按钮。
+         *
          *     订阅地址、用量、配额各有自己的接口，这里不重复返回。
          */
         get: operations["get-l4-tunnel"];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leaflow/sdk",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "Leaflow 平台 API 的 TypeScript SDK",
   "license": "MIT",
   "repository": {