@leaflow/sdk 0.18.0 → 0.20.0

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

@@ -52,6 +52,18 @@ export type SubmitDynamicCallResultBody = NonNullable<operations["submit-dynamic
 export type ListMemoriesResult = operations["list-memories"]["responses"][200]["content"]["application/json"];
 /** `GET /api/v1/models` 成功时的响应体。 */
 export type ListModelsResult = operations["list-models"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/skills` 成功时的响应体。 */
+export type ListSkillsResult = operations["list-skills"]["responses"][200]["content"]["application/json"];
+/** `POST /api/v1/skills` 成功时的响应体。 */
+export type PutSkillResult = operations["put-skill"]["responses"][200]["content"]["application/json"];
+/** `POST /api/v1/skills` 的请求体。 */
+export type PutSkillBody = NonNullable<operations["put-skill"]["requestBody"]>["content"]["application/json"];
+/** `GET /api/v1/skills/{skill}` 成功时的响应体。 */
+export type GetSkillResult = operations["get-skill"]["responses"][200]["content"]["application/json"];
+/** `PATCH /api/v1/skills/{skill}` 成功时的响应体。 */
+export type SetSkillEnabledResult = operations["set-skill-enabled"]["responses"][200]["content"]["application/json"];
+/** `PATCH /api/v1/skills/{skill}` 的请求体。 */
+export type SetSkillEnabledBody = NonNullable<operations["set-skill-enabled"]["requestBody"]>["content"]["application/json"];
 /** `GET /api/v1/threads` 成功时的响应体。 */
 export type ListThreadsResult = operations["list-threads"]["responses"][200]["content"]["application/json"];
 /** `GET /api/v1/threads` 的查询参数。 */

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

@@ -302,8 +302,7 @@ export interface paths {
          *     with the namespace `dynamic`; the client acts when that entry turns in_progress and reports
          *     back here.
          *
-         *     The first result wins. A second one — from another tab, or a retried request — is refused
-         *     rather than replacing it, because the action already ran once.
+         *     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;
@@ -372,6 +371,71 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/skills": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List the skills this project can use
+         * @description Everything the assistant can reach in this project, including the ones that are turned off —
+         *     an entry that disappeared once it was switched off could not be switched back on.
+         *
+         *     `origin` says whether a skill can be edited here. Skills belonging to the project are
+         *     visible to everyone in it, whoever wrote them.
+         */
+        get: operations["list-skills"];
+        put?: never;
+        /**
+         * Write a skill for this project
+         * @description Creates it, or replaces the project's skill of that name. The whole package goes in each
+         *     time: files left out of a write are removed, so the stored skill is what was sent and not
+         *     what accumulated.
+         *
+         *     A project skill takes precedence over a built-in one of the same name for this project only.
+         *     The built-in is untouched and reappears if the project's is deleted.
+         */
+        post: operations["put-skill"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/skills/{skill}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read one skill, with its files
+         * @description Works for built-in skills too; they simply cannot be written.
+         */
+        get: operations["get-skill"];
+        put?: never;
+        post?: never;
+        /**
+         * Delete this project's skill
+         * @description A built-in skill of the same name, if there was one, becomes visible again.
+         */
+        delete: operations["delete-skill"];
+        options?: never;
+        head?: never;
+        /**
+         * Turn a skill on or off
+         * @description Separate from writing it, because this is the frequent one: a skill that is off costs
+         *     nothing and stays where it is.
+         *
+         *     Only skills belonging to the project can be switched. To keep a built-in one out of the
+         *     way, write a project skill of the same name and turn that off.
+         */
+        patch: operations["set-skill-enabled"];
+        trace?: never;
+    };
     "/api/v1/threads": {
         parameters: {
             query?: never;
@@ -412,7 +476,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;
@@ -819,7 +883,64 @@ export interface components {
         ModelListResponseBody: {
             models: components["schemas"]["ModelResource"][] | null;
         };
+        SkillResource: {
+            /**
+             * @description True when the assistant wrote this skill during a conversation rather than a person
+             *     writing it here.
+             *
+             *     Which conversation is deliberately not returned: skills are shared across the project
+             *     while conversations belong to one person, so naming one would tell everybody in the
+             *     project that a particular colleague had it.
+             */
+            authoredByAssistant: boolean;
+            /** @description Why the assistant would open this skill. It sits in every request, so it is the one field worth writing carefully. */
+            description: string;
+            enabled: boolean;
+            /** @description Path to contents, `SKILL.md` among them. Only returned by `get-skill`; the list leaves it out. */
+            files?: {
+                [key: string]: string;
+            } | null;
+            name: string;
+            /**
+             * @description `builtin` — provided by the platform and read-only here.
+             *     `project` — written for this project and editable by anyone in it.
+             * @enum {string}
+             */
+            origin: "builtin" | "project";
+            shortDescription: string | null;
+            /**
+             * Format: date-time
+             * @description Null for built-in skills, which have no edit history here.
+             */
+            updatedAt: string | null;
+        };
+        SkillListResponseBody: {
+            skills: components["schemas"]["SkillResource"][];
+        };
+        SkillRequestBody: {
+            /** @description Why the assistant would open this skill. It sits in every request; write it as the answer to "when do I need this", not "what does it contain". */
+            description: string;
+            /** @default true */
+            enabled?: boolean;
+            /**
+             * @description Path to contents. `SKILL.md` is required; anything else it references goes alongside it.
+             *
+             *     Paths are relative to the skill and cannot leave it. At most 32 files, 256 KiB each and
+             *     1 MiB in total.
+             */
+            files: {
+                [key: string]: string;
+            };
+            /** @description Also how the assistant refers to it, so renaming is deleting and writing again. */
+            name: string;
+            shortDescription?: string;
+        };
+        SkillEnabledRequestBody: {
+            enabled: boolean;
+        };
         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;
@@ -843,6 +964,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;
@@ -871,6 +994,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;
@@ -941,7 +1075,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;
@@ -952,57 +1092,96 @@ 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;
             client?: components["schemas"]["ClientContextRequest"];
-            text: string;
+            /**
+             * @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 What this client can do, so the assistant can ask it to do those things while it answers.
+         * @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.
          *
-         *     Send `actions` only when they differ from what was sent last — the list is repeated to the
-         *     model on every step of the turn, so an unchanged list costs more to resend than to omit.
-         *     Sending the block without `actions` keeps whatever was declared before.
+         *     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 is fine; a fresh one per tab is expected. */
+            /** @description Identifies this client while it stays open. Any stable string; one per tab or process. */
             clientId: string;
-            /** @description How the client calls itself, shown to the model so it can name it — for example "Leaflow console (web)". */
+            /** @description How the client calls itself, for example "Leaflow console (web)". */
             label?: string;
-            page?: components["schemas"]["ClientPageRequest"];
         };
+        /** @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;
-            /** @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. 0 uses the default; longer values are capped.
-             */
-            timeoutMs?: number;
-        };
-        /** @description What the operator is looking at. The address alone answers most questions about context. */
-        ClientPageRequest: {
-            title?: string;
-            url?: string;
         };
         DynamicCallResultRequestBody: {
-            /** @description The same value sent with the message. A result from a client that is no longer the attached one is refused. */
+            /** @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. This reaches the model, so write it for a reader who cannot see the screen. */
+            /** @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; paginate anything larger rather than truncating it. */
+            /** @description What the action produced. At most 64 KiB; use `nextCursor` for anything larger. */
             output?: string;
         };
         TodoResource: {
@@ -1764,6 +1943,164 @@ export interface operations {
             };
         };
     };
+    "list-skills": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SkillListResponseBody"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "put-skill": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SkillRequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SkillResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-skill": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The skill's name, as `list-skills` returned it. */
+                skill: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SkillResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "delete-skill": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                skill: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description No Content */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "set-skill-enabled": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                skill: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SkillEnabledRequestBody"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SkillResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "list-threads": {
         parameters: {
             query?: {

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.18.0",
+  "version": "0.20.0",
   "description": "Leaflow 平台 API 的 TypeScript SDK",
   "license": "MIT",
   "repository": {