@arbidocs/client 0.3.65 → 0.3.67

package/dist/index.d.cts

@@ -1404,6 +1404,41 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/assistant/skills': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List user-invocable skills in the active workspace
+         * @description List skills the caller can invoke via ``/<slug>`` in the active
+         *     workspace.
+         *
+         *     Returns lightweight metadata only (name, description, arg hint) —
+         *     never the SKILL.md body. Clients pull this once per workspace switch
+         *     to populate slash-command autocomplete in the TUI / CLI / React UI.
+         *
+         *     Skills are workspace documents with ``wp_type='skill'``; the scope
+         *     matches the workspace the caller has open. Cross-workspace listing
+         *     (skills from workspace A surfaced while in workspace B) is
+         *     intentionally out of scope — each workspace has its own encryption
+         *     key and surfacing a skill the caller can see but can't decrypt
+         *     would be a confusing UX.
+         *
+         *     The endpoint decrypts one main-file per skill to parse frontmatter;
+         *     companion bodies are skipped to keep the response cheap.
+         */
+        get: operations['list_skills'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/assistant/query': {
         parameters: {
             query?: never;
@@ -6681,6 +6716,77 @@ interface components {
              */
             detail: string;
         };
+        /**
+         * SkillSummaryResponse
+         * @description One row of ``GET /v1/assistant/skills``.
+         *
+         *     Lightweight projection — never includes the SKILL.md body. Clients
+         *     use this to populate slash-command autocomplete (name / description
+         *     / arg_hint) and to know which doc to fetch when the user wants to
+         *     inspect the full source via ``GET /v1/document/.../parsed-content``.
+         */
+        SkillSummaryResponse: {
+            /**
+             * Name
+             * @description Skill display name (frontmatter ``name``, falls back to slug)
+             */
+            name: string;
+            /**
+             * Slug
+             * @description Folder-safe identifier used by ``/<slug>`` slash invocation
+             */
+            slug: string;
+            /**
+             * Description
+             * @description One-line description from frontmatter
+             * @default
+             */
+            description: string;
+            /**
+             * User Invocable
+             * @description Whether the skill appears in slash menus
+             * @default true
+             */
+            user_invocable: boolean;
+            /**
+             * Arg Hint
+             * @description Optional args hint (e.g. ``"<env> [--dry-run]"``)
+             * @default
+             */
+            arg_hint: string;
+            /**
+             * Skill Type
+             * @description ``markdown`` | ``python`` | ``shell`` | ``javascript`` | ``typescript``
+             * @default markdown
+             */
+            skill_type: string;
+            /**
+             * Workspace Ext Id
+             * @description External ID of the workspace the skill lives in
+             */
+            workspace_ext_id: string;
+            /**
+             * Doc Ext Id
+             * @description External ID of the SKILL.md doc (use for /parsed-content)
+             */
+            doc_ext_id: string;
+            /**
+             * Updated At
+             * Format: date-time
+             * @description Last modification time of the main file
+             */
+            updated_at: string;
+        };
+        /**
+         * SkillsListResponse
+         * @description Wrapper for ``GET /v1/assistant/skills`` — mirrors the
+         *     ``{ skills: [...] }`` shape rather than a bare array so we can add
+         *     paging or aggregate fields later without breaking clients.
+         */
+        SkillsListResponse: {
+            /** Skills */
+            skills: components['schemas']['SkillSummaryResponse'][];
+        };
         /**
          * SkippedFile
          * @description A file that was skipped during upload with the reason.
@@ -10066,6 +10172,38 @@ interface operations {
             };
         };
     };
+    list_skills: {
+        parameters: {
+            query?: {
+                /** @description Include skills whose frontmatter sets ``user-invocable: false``. Off by default — those are typically agent-only or in-progress skills that shouldn't surface in slash-command menus. */
+                include_hidden?: boolean;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['SkillsListResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     generate: {
         parameters: {
             query?: never;

package/dist/index.d.ts

@@ -1404,6 +1404,41 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/assistant/skills': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List user-invocable skills in the active workspace
+         * @description List skills the caller can invoke via ``/<slug>`` in the active
+         *     workspace.
+         *
+         *     Returns lightweight metadata only (name, description, arg hint) —
+         *     never the SKILL.md body. Clients pull this once per workspace switch
+         *     to populate slash-command autocomplete in the TUI / CLI / React UI.
+         *
+         *     Skills are workspace documents with ``wp_type='skill'``; the scope
+         *     matches the workspace the caller has open. Cross-workspace listing
+         *     (skills from workspace A surfaced while in workspace B) is
+         *     intentionally out of scope — each workspace has its own encryption
+         *     key and surfacing a skill the caller can see but can't decrypt
+         *     would be a confusing UX.
+         *
+         *     The endpoint decrypts one main-file per skill to parse frontmatter;
+         *     companion bodies are skipped to keep the response cheap.
+         */
+        get: operations['list_skills'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/assistant/query': {
         parameters: {
             query?: never;
@@ -6681,6 +6716,77 @@ interface components {
              */
             detail: string;
         };
+        /**
+         * SkillSummaryResponse
+         * @description One row of ``GET /v1/assistant/skills``.
+         *
+         *     Lightweight projection — never includes the SKILL.md body. Clients
+         *     use this to populate slash-command autocomplete (name / description
+         *     / arg_hint) and to know which doc to fetch when the user wants to
+         *     inspect the full source via ``GET /v1/document/.../parsed-content``.
+         */
+        SkillSummaryResponse: {
+            /**
+             * Name
+             * @description Skill display name (frontmatter ``name``, falls back to slug)
+             */
+            name: string;
+            /**
+             * Slug
+             * @description Folder-safe identifier used by ``/<slug>`` slash invocation
+             */
+            slug: string;
+            /**
+             * Description
+             * @description One-line description from frontmatter
+             * @default
+             */
+            description: string;
+            /**
+             * User Invocable
+             * @description Whether the skill appears in slash menus
+             * @default true
+             */
+            user_invocable: boolean;
+            /**
+             * Arg Hint
+             * @description Optional args hint (e.g. ``"<env> [--dry-run]"``)
+             * @default
+             */
+            arg_hint: string;
+            /**
+             * Skill Type
+             * @description ``markdown`` | ``python`` | ``shell`` | ``javascript`` | ``typescript``
+             * @default markdown
+             */
+            skill_type: string;
+            /**
+             * Workspace Ext Id
+             * @description External ID of the workspace the skill lives in
+             */
+            workspace_ext_id: string;
+            /**
+             * Doc Ext Id
+             * @description External ID of the SKILL.md doc (use for /parsed-content)
+             */
+            doc_ext_id: string;
+            /**
+             * Updated At
+             * Format: date-time
+             * @description Last modification time of the main file
+             */
+            updated_at: string;
+        };
+        /**
+         * SkillsListResponse
+         * @description Wrapper for ``GET /v1/assistant/skills`` — mirrors the
+         *     ``{ skills: [...] }`` shape rather than a bare array so we can add
+         *     paging or aggregate fields later without breaking clients.
+         */
+        SkillsListResponse: {
+            /** Skills */
+            skills: components['schemas']['SkillSummaryResponse'][];
+        };
         /**
          * SkippedFile
          * @description A file that was skipped during upload with the reason.
@@ -10066,6 +10172,38 @@ interface operations {
             };
         };
     };
+    list_skills: {
+        parameters: {
+            query?: {
+                /** @description Include skills whose frontmatter sets ``user-invocable: false``. Off by default — those are typically agent-only or in-progress skills that shouldn't surface in slash-command menus. */
+                include_hidden?: boolean;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['SkillsListResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     generate: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbidocs/client",
-  "version": "0.3.65",
+  "version": "0.3.67",
   "description": "TypeScript SDK for the ARBI API — zero-knowledge auth, E2E encryption, and type-safe REST client",
   "type": "module",
   "main": "dist/index.cjs",