@jskit-ai/agent-docs 0.1.205 → 0.1.206

package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users-workspace/package.json

@@ -9,9 +9,9 @@
     "./shared": "./src/shared/index.js"
   },
   "dependencies": {
-    "@jskit-ai/crud-core": "0.1.244",
-    "@jskit-ai/resource-crud-core": "0.1.175",
-    "@jskit-ai/workspaces-core": "0.1.211"
+    "@jskit-ai/crud-core": "0.1.245",
+    "@jskit-ai/resource-crud-core": "0.1.176",
+    "@jskit-ai/workspaces-core": "0.1.212"
   },
   "jskit": {
     "kind": "runtime",

package/skills/jskit/references/patterns/workspaces/workspace-server/PATTERN.md

@@ -28,6 +28,26 @@ member permissions, personal-workspace behavior, and surface access rules.
 Use workspace routes, resources, scope helpers, tenancy profiles, and settings
 contracts exported by `@jskit-ai/workspaces-core`.
 
+## Role display labels
+
+Each `roleCatalog.roles[roleId]` definition may include an optional string
+`label`. JSKIT trims it and preserves nonempty labels in role descriptors,
+catalogue clones and Members/Workspace Settings responses. Labels are display
+metadata; they do not inherit from a parent role. Missing, blank or non-string
+labels keep the existing role-title fallback.
+
+Shared Members invitation and member-role selectors show the label but submit
+the role id. Pending invitation captions, workspace role captions and the
+default invitation email use the same configured labels. Pending invitation
+responses expose optional `roleLabel` alongside the unchanged `roleSid`.
+Applications with their own invitation renderer may use its optional
+`roleLabel` input; `roleSid` remains the stored role id.
+
+Keep existing permissions, inheritance, assignability and
+`workspace.defaultInviteRole` when adding a label. `owner` remains
+nonassignable. Custom roles, including specialised Training roles, are ordinary
+catalogue entries. Updating labels requires no database migration.
+
 ## Transactional invitation participation
 
 Through `workspaces.core`, register one callback during feature setup with

package/skills/jskit/references/patterns/workspaces/workspace-server/example/config/roles.js

@@ -8,6 +8,7 @@ export const roleCatalog = {
       permissions: ["*"]
     },
     admin: {
+      label: "Administrator",
       assignable: true,
       inherits: "member",
       permissions: [
@@ -20,6 +21,7 @@ export const roleCatalog = {
       ]
     },
     member: {
+      label: "Team member",
       assignable: true,
       permissions: ["workspace.settings.view"]
     }