@arbidocs/client 0.3.72 → 0.3.74

package/dist/index.d.cts

@@ -1413,19 +1413,18 @@ interface paths {
         };
         /**
          * List user-invocable skills in the active workspace
-         * @description List skills the caller can invoke via ``/<slug>`` in the active
-         *     workspace.
+         * @description List skills the caller can invoke via ``/<slug>``.
          *
-         *     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.
+         *     Returns lightweight metadata only (name, description, arg hint,
+         *     visibility) — never the SKILL.md body. Clients pull this 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.
+         *     Skills are documents with ``wp_type='skill'`` living in the deployment
+         *     skill marketplace (a public workspace). The listing is the union of the
+         *     caller's own skills (``visibility='mine'``) and skills shared into the
+         *     marketplace (``visibility='global'``); a same-named own skill shadows the
+         *     global one. When no marketplace is configured the lookup falls back to the
+         *     caller's active workspace.
          *
          *     The endpoint decrypts one main-file per skill to parse frontmatter;
          *     companion bodies are skipped to keep the response cheap.
@@ -2355,8 +2354,8 @@ interface components {
             MEMORY_ENABLED: boolean;
             /**
              * Skills Enabled
-             * @description Enable the skills system: /skill (create) and /<skill-name> (invoke) commands.
-             * @default false
+             * @description Enable the skills system: /skill (create) and /<skill-name> (invoke) commands. Skills are a global feature (the marketplace); on by default. Command dispatch no longer gates on this flag, but it remains for config-level introspection.
+             * @default true
              */
             SKILLS_ENABLED: boolean;
             /**
@@ -2549,7 +2548,7 @@ interface components {
              *       "VISION_ENABLED": false,
              *       "PERSONAL_AGENT": false,
              *       "MEMORY_ENABLED": false,
-             *       "SKILLS_ENABLED": false,
+             *       "SKILLS_ENABLED": true,
              *       "SKILL_CREATION": false,
              *       "MEMORY_CREATION": false,
              *       "GOALS_ENABLED": false,
@@ -5075,7 +5074,7 @@ interface components {
          *     Type is self-descriptive, no need to parse content field.
          * @enum {string}
          */
-        NotificationType: 'user_message' | 'workspaceuser_added_owner' | 'workspaceuser_added_collaborator' | 'workspaceuser_added_guest' | 'workspaceuser_removed' | 'workspaceuser_updated_owner' | 'workspaceuser_updated_collaborator' | 'workspaceuser_updated_guest' | 'contact_accepted' | 'email_reply' | 'quota_threshold_50' | 'quota_threshold_90' | 'quota_threshold_100';
+        NotificationType: 'user_message' | 'workspaceuser_added_owner' | 'workspaceuser_added_collaborator' | 'workspaceuser_added_guest' | 'workspaceuser_removed' | 'workspaceuser_updated_owner' | 'workspaceuser_updated_collaborator' | 'workspaceuser_updated_guest' | 'contact_accepted' | 'email_reply' | 'quota_threshold_50' | 'quota_threshold_90' | 'quota_threshold_100' | 'doc_shared';
         /**
          * NotificationUpdate
          * @description Single notification update for bulk PATCH.
@@ -6963,6 +6962,18 @@ interface components {
              * @description Last modification time of the main file
              */
             updated_at: string;
+            /**
+             * Visibility
+             * @description ``mine`` (private to the caller) or ``global`` (shared into the marketplace)
+             * @default mine
+             */
+            visibility: string;
+            /**
+             * Is Owner
+             * @description Whether the caller owns the skill (gates edit/publish/unpublish in the UI)
+             * @default true
+             */
+            is_owner: boolean;
         };
         /**
          * SkillsListResponse
@@ -6974,6 +6985,23 @@ interface components {
             /** Skills */
             skills: components['schemas']['SkillSummaryResponse'][];
         };
+        /**
+         * SkillsUpdatedMessage
+         * @description A skill changed server-side (agent ``save_skill``, delete, publish) —
+         *     frontend should refetch the marketplace skills list.
+         */
+        SkillsUpdatedMessage: {
+            /**
+             * Type
+             * @default skills_updated
+             * @constant
+             */
+            type: 'skills_updated';
+            /** Reason */
+            reason: string;
+            /** Slug */
+            slug?: string | null;
+        };
         /**
          * SkippedFile
          * @description A file that was skipped during upload with the reason.
@@ -7862,7 +7890,7 @@ interface components {
             show_mcp_connectors: boolean;
             /**
              * Show Hints
-             * @default true
+             * @default false
              */
             show_hints: boolean;
             /**
@@ -8093,6 +8121,7 @@ interface components {
             batch_complete?: components['schemas']['BatchCompleteMessage'] | null;
             response_complete?: components['schemas']['ResponseCompleteMessage'] | null;
             conversation_title_updated?: components['schemas']['ConversationTitleUpdatedMessage'] | null;
+            skills_updated?: components['schemas']['SkillsUpdatedMessage'] | null;
             notification?: components['schemas']['NotificationResponse'] | null;
             auth?: components['schemas']['AuthMessage'] | null;
             send_message?: components['schemas']['SendMessageRequest'] | null;
@@ -8108,6 +8137,7 @@ interface components {
              * @default false
              */
             is_public: boolean;
+            workspace_type?: components['schemas']['WorkspaceType'] | null;
             /** Workspace Key */
             workspace_key: string;
             /** Project Ext Id */
@@ -8147,6 +8177,8 @@ interface components {
             description: string | null;
             /** Is Public */
             is_public: boolean;
+            /** @default private */
+            workspace_type: components['schemas']['WorkspaceType'];
             /** Created By Ext Id */
             created_by_ext_id: string;
             /** Updated By Ext Id */
@@ -8213,6 +8245,28 @@ interface components {
          * @enum {string}
          */
         WorkspaceRole: 'owner' | 'collaborator' | 'guest';
+        /**
+         * WorkspaceType
+         * @description Kind of workspace — the source of truth for visibility and special roles.
+         *
+         *     RLS and all visibility logic ride on this classification, NOT on the presence
+         *     of ``shared_key`` (which is only the encryption *mechanism* — the key bytes
+         *     the server needs to decrypt public content).
+         *
+         *     - ``private``: members-only (``shared_key`` is NULL).
+         *     - ``public``: readable by any authenticated user (``shared_key`` set, so the
+         *       deployment can decrypt for everyone).
+         *     - ``skills``: the deployment-wide skill marketplace. A specialization of
+         *       ``public`` (also readable by all), of which there is at most ONE — enforced
+         *       by a partial unique index. The skill subsystem resolves the marketplace
+         *       with a simple ``WHERE workspace_type = 'skills'`` lookup (no env var); a
+         *       deployment with none designated simply has no marketplace.
+         *
+         *     ``public`` and ``skills`` both require ``shared_key`` set; ``private`` requires
+         *     it NULL. Designating ``public`` or ``skills`` is developer-gated.
+         * @enum {string}
+         */
+        WorkspaceType: 'private' | 'public' | 'skills';
         /** WorkspaceUpdateRequest */
         WorkspaceUpdateRequest: {
             /** Name */
@@ -8221,6 +8275,7 @@ interface components {
             description?: string | null;
             /** Is Public */
             is_public?: boolean | null;
+            workspace_type?: components['schemas']['WorkspaceType'] | null;
             /** Project Ext Id */
             project_ext_id?: string | null;
         };

package/dist/index.d.ts

@@ -1413,19 +1413,18 @@ interface paths {
         };
         /**
          * List user-invocable skills in the active workspace
-         * @description List skills the caller can invoke via ``/<slug>`` in the active
-         *     workspace.
+         * @description List skills the caller can invoke via ``/<slug>``.
          *
-         *     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.
+         *     Returns lightweight metadata only (name, description, arg hint,
+         *     visibility) — never the SKILL.md body. Clients pull this 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.
+         *     Skills are documents with ``wp_type='skill'`` living in the deployment
+         *     skill marketplace (a public workspace). The listing is the union of the
+         *     caller's own skills (``visibility='mine'``) and skills shared into the
+         *     marketplace (``visibility='global'``); a same-named own skill shadows the
+         *     global one. When no marketplace is configured the lookup falls back to the
+         *     caller's active workspace.
          *
          *     The endpoint decrypts one main-file per skill to parse frontmatter;
          *     companion bodies are skipped to keep the response cheap.
@@ -2355,8 +2354,8 @@ interface components {
             MEMORY_ENABLED: boolean;
             /**
              * Skills Enabled
-             * @description Enable the skills system: /skill (create) and /<skill-name> (invoke) commands.
-             * @default false
+             * @description Enable the skills system: /skill (create) and /<skill-name> (invoke) commands. Skills are a global feature (the marketplace); on by default. Command dispatch no longer gates on this flag, but it remains for config-level introspection.
+             * @default true
              */
             SKILLS_ENABLED: boolean;
             /**
@@ -2549,7 +2548,7 @@ interface components {
              *       "VISION_ENABLED": false,
              *       "PERSONAL_AGENT": false,
              *       "MEMORY_ENABLED": false,
-             *       "SKILLS_ENABLED": false,
+             *       "SKILLS_ENABLED": true,
              *       "SKILL_CREATION": false,
              *       "MEMORY_CREATION": false,
              *       "GOALS_ENABLED": false,
@@ -5075,7 +5074,7 @@ interface components {
          *     Type is self-descriptive, no need to parse content field.
          * @enum {string}
          */
-        NotificationType: 'user_message' | 'workspaceuser_added_owner' | 'workspaceuser_added_collaborator' | 'workspaceuser_added_guest' | 'workspaceuser_removed' | 'workspaceuser_updated_owner' | 'workspaceuser_updated_collaborator' | 'workspaceuser_updated_guest' | 'contact_accepted' | 'email_reply' | 'quota_threshold_50' | 'quota_threshold_90' | 'quota_threshold_100';
+        NotificationType: 'user_message' | 'workspaceuser_added_owner' | 'workspaceuser_added_collaborator' | 'workspaceuser_added_guest' | 'workspaceuser_removed' | 'workspaceuser_updated_owner' | 'workspaceuser_updated_collaborator' | 'workspaceuser_updated_guest' | 'contact_accepted' | 'email_reply' | 'quota_threshold_50' | 'quota_threshold_90' | 'quota_threshold_100' | 'doc_shared';
         /**
          * NotificationUpdate
          * @description Single notification update for bulk PATCH.
@@ -6963,6 +6962,18 @@ interface components {
              * @description Last modification time of the main file
              */
             updated_at: string;
+            /**
+             * Visibility
+             * @description ``mine`` (private to the caller) or ``global`` (shared into the marketplace)
+             * @default mine
+             */
+            visibility: string;
+            /**
+             * Is Owner
+             * @description Whether the caller owns the skill (gates edit/publish/unpublish in the UI)
+             * @default true
+             */
+            is_owner: boolean;
         };
         /**
          * SkillsListResponse
@@ -6974,6 +6985,23 @@ interface components {
             /** Skills */
             skills: components['schemas']['SkillSummaryResponse'][];
         };
+        /**
+         * SkillsUpdatedMessage
+         * @description A skill changed server-side (agent ``save_skill``, delete, publish) —
+         *     frontend should refetch the marketplace skills list.
+         */
+        SkillsUpdatedMessage: {
+            /**
+             * Type
+             * @default skills_updated
+             * @constant
+             */
+            type: 'skills_updated';
+            /** Reason */
+            reason: string;
+            /** Slug */
+            slug?: string | null;
+        };
         /**
          * SkippedFile
          * @description A file that was skipped during upload with the reason.
@@ -7862,7 +7890,7 @@ interface components {
             show_mcp_connectors: boolean;
             /**
              * Show Hints
-             * @default true
+             * @default false
              */
             show_hints: boolean;
             /**
@@ -8093,6 +8121,7 @@ interface components {
             batch_complete?: components['schemas']['BatchCompleteMessage'] | null;
             response_complete?: components['schemas']['ResponseCompleteMessage'] | null;
             conversation_title_updated?: components['schemas']['ConversationTitleUpdatedMessage'] | null;
+            skills_updated?: components['schemas']['SkillsUpdatedMessage'] | null;
             notification?: components['schemas']['NotificationResponse'] | null;
             auth?: components['schemas']['AuthMessage'] | null;
             send_message?: components['schemas']['SendMessageRequest'] | null;
@@ -8108,6 +8137,7 @@ interface components {
              * @default false
              */
             is_public: boolean;
+            workspace_type?: components['schemas']['WorkspaceType'] | null;
             /** Workspace Key */
             workspace_key: string;
             /** Project Ext Id */
@@ -8147,6 +8177,8 @@ interface components {
             description: string | null;
             /** Is Public */
             is_public: boolean;
+            /** @default private */
+            workspace_type: components['schemas']['WorkspaceType'];
             /** Created By Ext Id */
             created_by_ext_id: string;
             /** Updated By Ext Id */
@@ -8213,6 +8245,28 @@ interface components {
          * @enum {string}
          */
         WorkspaceRole: 'owner' | 'collaborator' | 'guest';
+        /**
+         * WorkspaceType
+         * @description Kind of workspace — the source of truth for visibility and special roles.
+         *
+         *     RLS and all visibility logic ride on this classification, NOT on the presence
+         *     of ``shared_key`` (which is only the encryption *mechanism* — the key bytes
+         *     the server needs to decrypt public content).
+         *
+         *     - ``private``: members-only (``shared_key`` is NULL).
+         *     - ``public``: readable by any authenticated user (``shared_key`` set, so the
+         *       deployment can decrypt for everyone).
+         *     - ``skills``: the deployment-wide skill marketplace. A specialization of
+         *       ``public`` (also readable by all), of which there is at most ONE — enforced
+         *       by a partial unique index. The skill subsystem resolves the marketplace
+         *       with a simple ``WHERE workspace_type = 'skills'`` lookup (no env var); a
+         *       deployment with none designated simply has no marketplace.
+         *
+         *     ``public`` and ``skills`` both require ``shared_key`` set; ``private`` requires
+         *     it NULL. Designating ``public`` or ``skills`` is developer-gated.
+         * @enum {string}
+         */
+        WorkspaceType: 'private' | 'public' | 'skills';
         /** WorkspaceUpdateRequest */
         WorkspaceUpdateRequest: {
             /** Name */
@@ -8221,6 +8275,7 @@ interface components {
             description?: string | null;
             /** Is Public */
             is_public?: boolean | null;
+            workspace_type?: components['schemas']['WorkspaceType'] | null;
             /** Project Ext Id */
             project_ext_id?: string | null;
         };

package/package.json

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