@leaflow/sdk 0.19.0 → 0.21.0

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

@@ -50,8 +50,18 @@ export type SubmitWeixinVerifyCodeBody = NonNullable<operations["submit-weixin-v
 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` 成功时的响应体。 */
-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

@@ -351,7 +351,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/v1/models": {
+    "/api/v1/skills": {
         parameters: {
             query?: never;
             header?: never;
@@ -359,18 +359,63 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * List available models
-         * @description The models currently offered, with their context window, reasoning levels and supported input types. Use it to populate the model picker in conversation settings.
+         * 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-models"];
+        get: operations["list-skills"];
         put?: never;
-        post?: 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;
@@ -411,7 +456,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. Model and reasoning level change independently: sending one leaves the other alone.
+         * @description Changes the approval mode and archived state. A change takes effect from the next turn; a turn already running keeps the settings it started with.
          */
         patch: operations["update-thread"];
         trace?: never;
@@ -792,35 +837,62 @@ export interface components {
         VerifyCodeRequestBody: {
             code: string;
         };
-        ModelResource: {
-            /** Format: int64 */
-            contextWindow: number;
-            inputModalities: string[] | null;
-            key: string;
-            reasoningTiers: string[] | 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;
         };
-        MemoryListResponseBody: {
-            items: components["schemas"]["MemoryResource"][];
+        SkillListResponseBody: {
+            skills: components["schemas"]["SkillResource"][];
         };
-        MemoryResource: {
-            /** @description The fact itself */
-            body: string;
-            /** Format: date-time */
-            createdAt: string;
-            id: string;
-            /** @description The name the assistant gave this fact; it overwrites or deletes its own entries by that name */
+        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;
-            /** @description Which conversation the assistant learned it in. That conversation may since have been deleted */
-            sourceThreadId?: string;
-            /** Format: date-time */
-            updatedAt: string;
+            shortDescription?: string;
         };
-        ModelListResponseBody: {
-            models: components["schemas"]["ModelResource"][] | null;
+        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;
@@ -844,8 +916,6 @@ 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;
@@ -954,14 +1024,6 @@ export interface components {
             /** @enum {string} */
             approvalMode?: "guardian" | "manual" | "yolo";
             archived?: boolean;
-            model?: 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;
@@ -979,6 +1041,22 @@ export interface components {
              */
             parts: components["schemas"]["MessagePart"][];
         };
+        MemoryListResponseBody: {
+            items: components["schemas"]["MemoryResource"][];
+        };
+        MemoryResource: {
+            /** @description The fact itself */
+            body: string;
+            /** Format: date-time */
+            createdAt: string;
+            id: string;
+            /** @description The name the assistant gave this fact; it overwrites or deletes its own entries by that name */
+            name: string;
+            /** @description Which conversation the assistant learned it in. That conversation may since have been deleted */
+            sourceThreadId?: string;
+            /** Format: date-time */
+            updatedAt: string;
+        };
         /**
          * @description One piece of a message. `type` says which of the fields below carries it:
          *
@@ -1794,13 +1872,78 @@ export interface operations {
             };
         };
     };
-    "list-models": {
+    "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 */
@@ -1809,7 +1952,71 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ModelListResponseBody"];
+                    "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 */

package/package.json

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