@jskit-ai/workspaces-core 0.1.161 → 0.1.163

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/workspaces-core",
-  "version": "0.1.161",
+  "version": "0.1.163",
   "type": "module",
   "scripts": {
     "test": "node --test"
@@ -18,11 +18,11 @@
     "./shared/resources/workspaceSettingsResource": "./src/shared/resources/workspaceSettingsResource.js"
   },
   "dependencies": {
-    "@jskit-ai/database-runtime": "0.1.183",
-    "@jskit-ai/json-rest-api-core": "0.1.127",
-    "@jskit-ai/resource-core": "0.1.125",
-    "@jskit-ai/resource-crud-core": "0.1.125",
-    "@jskit-ai/users-core": "0.1.196",
+    "@jskit-ai/database-runtime": "0.1.185",
+    "@jskit-ai/json-rest-api-core": "0.1.129",
+    "@jskit-ai/resource-core": "0.1.127",
+    "@jskit-ai/resource-crud-core": "0.1.127",
+    "@jskit-ai/users-core": "0.1.198",
     "json-rest-schema": "^1.0.17"
   },
   "description": "Workspace tenancy runtime plus HTTP routes, role catalog, and workspace config scaffolding.",
@@ -169,8 +169,8 @@
     }
   },
   "peerDependencies": {
-    "@jskit-ai/auth-core": "0.1.181",
-    "@jskit-ai/http-runtime": "0.1.181",
-    "@jskit-ai/kernel": "0.1.183"
+    "@jskit-ai/auth-core": "0.1.183",
+    "@jskit-ai/http-runtime": "0.1.183",
+    "@jskit-ai/kernel": "0.1.185"
   }
 }

package/src/server/workspaceDirectory/workspaceDirectoryActions.js

@@ -8,6 +8,10 @@ import { workspaceResource } from "../../shared/resources/workspaceResource.js";
 import { workspaceSlugParamsValidator } from "../common/validators/routeParamsValidator.js";
 import { resolveActionUser } from "../common/support/resolveActionUser.js";
 
+function workspaceAssistantSummary({ id, slug, name, ownerUserId, avatarUrl }) {
+  return { id, slug, name, ownerUserId, avatarUrl };
+}
+
 const workspaceUpdateInputValidator = composeSchemaDefinitions([
   workspaceSlugParamsValidator,
   workspaceResource.operations.patch.body
@@ -28,16 +32,18 @@ const workspaceDirectoryActionSpecifications = Object.freeze([
     },
     input: workspaceResource.operations.create.body,
     output: null,
+    extensions: {
+      assistant: {
+        description: "Create a workspace for the signed-in user.",
+        output: workspaceResource.operations.create.output,
+        transformResult: (result) => workspaceAssistantSummary(result.value)
+      }
+    },
     idempotency: "none",
     audit: {
       actionName: "workspace.workspaces.create"
     },
     observability: {},
-    extensions: {
-      assistant: {
-        description: "Create a workspace for the authenticated user."
-      }
-    },
     async run(workspaceService, input, context) {
       return returnJsonApiData(await workspaceService.createWorkspaceForAuthenticatedUser(resolveActionUser(context, input), input, {
         request: resolveRequest(context),
@@ -56,6 +62,17 @@ const workspaceDirectoryActionSpecifications = Object.freeze([
     },
     input: emptyInputValidator,
     output: null,
+    extensions: {
+      assistant: {
+        description: "List workspaces accessible to the signed-in user.",
+        output: workspaceResource.operations.list.output,
+        transformResult: (result) => ({
+          items: result.value.items.map(({ id, slug, name, avatarUrl, roleSid, isAccessible }) =>
+            ({ id, slug, name, avatarUrl, roleSid, isAccessible })),
+          nextCursor: result.value.nextCursor
+        })
+      }
+    },
     idempotency: "none",
     audit: {
       actionName: "workspace.workspaces.list"
@@ -83,6 +100,13 @@ const workspaceDirectoryActionSpecifications = Object.freeze([
     },
     input: workspaceSlugParamsValidator,
     output: null,
+    extensions: {
+      assistant: {
+        description: "Read the active workspace profile.",
+        output: workspaceResource.operations.view.output,
+        transformResult: (result) => workspaceAssistantSummary(result.value)
+      }
+    },
     idempotency: "none",
     audit: {
       actionName: "workspace.workspaces.read"
@@ -111,16 +135,18 @@ const workspaceDirectoryActionSpecifications = Object.freeze([
     },
     input: workspaceUpdateInputValidator,
     output: null,
+    extensions: {
+      assistant: {
+        description: "Update the active workspace name or avatar URL.",
+        output: workspaceResource.operations.patch.output,
+        transformResult: (result) => workspaceAssistantSummary(result.value)
+      }
+    },
     idempotency: "optional",
     audit: {
       actionName: "workspace.workspaces.update"
     },
     observability: {},
-    extensions: {
-      assistant: {
-        description: "Update workspace profile fields."
-      }
-    },
     async run(workspaceService, input, context) {
       const { workspaceSlug, ...patch } = input;
       return returnJsonApiData(await workspaceService.updateWorkspaceForAuthenticatedUser(

package/src/server/workspaceMembers/workspaceMembersActions.js

@@ -1,3 +1,4 @@
+import { workspaceInviteAssistantOutput } from "../../shared/resources/workspaceAssistantOutputs.js";
 import { composeSchemaDefinitions } from "@jskit-ai/kernel/shared/validators";
 import { returnJsonApiData } from "@jskit-ai/http-runtime/shared";
 import { resolveWorkspace } from "../support/resolveWorkspace.js";
@@ -76,6 +77,13 @@ const workspaceMembersActionSpecifications = Object.freeze([
     },
     input: workspaceSlugParamsValidator,
     output: null,
+    extensions: {
+      assistant: {
+        description: "List the active workspace roles and assignable permissions.",
+        output: workspaceMembersResource.operations.rolesList.output,
+        transformResult: (result) => result.value
+      }
+    },
     idempotency: "none",
     audit: {
       actionName: "workspace.roles.list"
@@ -97,6 +105,13 @@ const workspaceMembersActionSpecifications = Object.freeze([
     },
     input: workspaceSlugParamsValidator,
     output: null,
+    extensions: {
+      assistant: {
+        description: "List members of the active workspace.",
+        output: workspaceMembersResource.operations.membersList.output,
+        transformResult: (result) => result.value
+      }
+    },
     idempotency: "none",
     audit: {
       actionName: "workspace.members.list"
@@ -120,6 +135,13 @@ const workspaceMembersActionSpecifications = Object.freeze([
     },
     input: updateMemberRoleActionInput,
     output: null,
+    extensions: {
+      assistant: {
+        description: "Change a member’s role in the active workspace.",
+        output: workspaceMembersResource.operations.updateMemberRole.output,
+        transformResult: (result) => result.value
+      }
+    },
     idempotency: "optional",
     audit: {
       actionName: "workspace.member.role.update"
@@ -147,6 +169,13 @@ const workspaceMembersActionSpecifications = Object.freeze([
     },
     input: removeMemberActionInput,
     output: null,
+    extensions: {
+      assistant: {
+        description: "Remove a member from the active workspace.",
+        output: workspaceMembersResource.operations.removeMember.output,
+        transformResult: (result) => result.value
+      }
+    },
     idempotency: "optional",
     audit: {
       actionName: "workspace.member.remove"
@@ -173,6 +202,13 @@ const workspaceMembersActionSpecifications = Object.freeze([
     },
     input: workspaceSlugParamsValidator,
     output: null,
+    extensions: {
+      assistant: {
+        description: "List invitations for the active workspace without invitation tokens.",
+        output: workspaceMembersResource.operations.invitesList.output,
+        transformResult: (result) => result.value
+      }
+    },
     idempotency: "none",
     audit: {
       actionName: "workspace.invites.list"
@@ -196,17 +232,24 @@ const workspaceMembersActionSpecifications = Object.freeze([
     },
     input: createInviteActionInput,
     output: null,
+    extensions: {
+      assistant: {
+        description: "Invite a person to the active workspace and report delivery status without exposing invitation links.",
+        output: workspaceInviteAssistantOutput,
+        transformResult: (result) => ({
+          createdInviteId: result.value.createdInviteId,
+          invites: result.value.invites.map(({ id, email, roleSid, status, expiresAt }) =>
+            ({ id, email, roleSid, status, expiresAt })),
+          deliveryStatus: result.value.inviteDelivery.status
+        })
+      }
+    },
     idempotency: "optional",
     audit: {
       actionName: "workspace.invite.create"
     },
     observability: {},
     events: WORKSPACE_INVITE_CREATED_EVENTS,
-    extensions: {
-      assistant: {
-        description: "Invite a person to the workspace."
-      }
-    },
     async run(workspaceMembersService, input, context) {
       return returnJsonApiData(await workspaceMembersService.createInvite(
         resolveWorkspace(context, input),
@@ -233,6 +276,13 @@ const workspaceMembersActionSpecifications = Object.freeze([
     },
     input: revokeInviteActionInput,
     output: null,
+    extensions: {
+      assistant: {
+        description: "Revoke an invitation to the active workspace.",
+        output: workspaceMembersResource.operations.revokeInvite.output,
+        transformResult: (result) => result.value
+      }
+    },
     idempotency: "optional",
     audit: {
       actionName: "workspace.invite.revoke"

package/src/server/workspacePendingInvitations/workspacePendingInvitationsActions.js

@@ -1,3 +1,4 @@
+import { pendingInvitationsAssistantOutput } from "../../shared/resources/workspaceAssistantOutputs.js";
 import {
   emptyInputValidator
 } from "@jskit-ai/kernel/shared/actions/actionContributorHelpers";
@@ -21,6 +22,11 @@ const workspacePendingInvitationsActionSpecifications = Object.freeze([
     },
     input: workspacePendingInvitationsResource.operations.resolve.query,
     output: null,
+    extensions: {
+      assistant: {
+        exclude: "Use the invitation screen; raw invitation tokens must not enter assistant arguments."
+      }
+    },
     idempotency: "none",
     audit: {
       actionName: "workspace.invitation.resolve"
@@ -45,6 +51,18 @@ const workspacePendingInvitationsActionSpecifications = Object.freeze([
     },
     input: emptyInputValidator,
     output: null,
+    extensions: {
+      assistant: {
+        description: "List pending workspace invitations for the signed-in user without invitation tokens.",
+        output: pendingInvitationsAssistantOutput,
+        transformResult: (result) => ({
+          pendingInvites: result.value.pendingInvites.map(
+            ({ id, workspaceId, workspaceSlug, workspaceName, roleSid, status, expiresAt }) =>
+              ({ id, workspaceId, workspaceSlug, workspaceName, roleSid, status, expiresAt })
+          )
+        })
+      }
+    },
     idempotency: "none",
     audit: {
       actionName: "workspace.invitations.pending.list"
@@ -69,6 +87,11 @@ const workspacePendingInvitationsActionSpecifications = Object.freeze([
     },
     input: workspaceMembersResource.operations.redeemInvite.body,
     output: null,
+    extensions: {
+      assistant: {
+        exclude: "Use the authenticated invitation screen to accept or refuse; raw invitation tokens must not enter assistant arguments."
+      }
+    },
     idempotency: "optional",
     audit: {
       actionName: "workspace.invite.redeem"

package/src/server/workspaceSettings/workspaceSettingsActions.js

@@ -32,6 +32,13 @@ const workspaceSettingsActionSpecifications = Object.freeze([
     },
     input: workspaceSlugParamsValidator,
     output: null,
+    extensions: {
+      assistant: {
+        description: "Read the active workspace appearance and invitation settings.",
+        output: workspaceSettingsResource.operations.view.output,
+        transformResult: (result) => result.value
+      }
+    },
     idempotency: "none",
     audit: {
       actionName: "workspace.settings.read"
@@ -57,17 +64,19 @@ const workspaceSettingsActionSpecifications = Object.freeze([
     },
     input: workspaceSettingsUpdateInputValidator,
     output: null,
+    extensions: {
+      assistant: {
+        description: "Update the active workspace appearance and invitation settings.",
+        output: workspaceSettingsResource.operations.patch.output,
+        transformResult: (result) => result.value
+      }
+    },
     idempotency: "optional",
     audit: {
       actionName: "workspace.settings.update"
     },
     observability: {},
     events: WORKSPACE_SETTINGS_CHANGED_EVENTS,
-    extensions: {
-      assistant: {
-        description: "Update workspace settings."
-      }
-    },
     async run(workspaceSettingsService, input, context) {
       const { workspaceSlug, ...patch } = input;
       const response = await workspaceSettingsService.updateWorkspaceSettings(

package/src/shared/resources/workspaceAssistantOutputs.js

@@ -0,0 +1,35 @@
+import { createSchema } from "json-rest-schema";
+import { createSchemaDefinition } from "@jskit-ai/resource-core/shared/resource";
+
+// Deliberate assistant allowlists: HTTP invitation responses also contain credentials.
+const workspaceInviteAssistantOutput = createSchemaDefinition(createSchema({
+  createdInviteId: { type: "string", required: true, minLength: 1 },
+  invites: {
+    type: "array", required: true,
+    items: createSchema({
+      id: { type: "string", required: true },
+      email: { type: "string", required: true },
+      roleSid: { type: "string", required: true },
+      status: { type: "string", required: true },
+      expiresAt: { type: "string", required: true }
+    })
+  },
+  deliveryStatus: { type: "string", required: true, enum: ["sent", "failed", "mailer_unconfigured"] }
+}), "replace");
+
+const pendingInvitationsAssistantOutput = createSchemaDefinition(createSchema({
+  pendingInvites: {
+    type: "array", required: true,
+    items: createSchema({
+      id: { type: "string", required: true },
+      workspaceId: { type: "string", required: true },
+      workspaceSlug: { type: "string", required: true },
+      workspaceName: { type: "string", required: true },
+      roleSid: { type: "string", required: true },
+      status: { type: "string", required: true },
+      expiresAt: { type: "string", required: false, nullable: true }
+    })
+  }
+}), "replace");
+
+export { workspaceInviteAssistantOutput, pendingInvitationsAssistantOutput };

package/test/workspaceSettingsActions.test.js

@@ -13,7 +13,7 @@ test("workspace settings action specifications stay explicit", () => {
   assert.deepEqual(workspaceSettingsActionSpecifications[0].surfaces, ["*"]);
   assert.deepEqual(workspaceSettingsActionSpecifications[1].surfaces, ["*"]);
   assert.deepEqual(workspaceSettingsActionSpecifications[1].channels, ["api", "assistant_tool", "automation", "internal"]);
-  assert.equal(workspaceSettingsActionSpecifications[1].extensions?.assistant?.description, "Update workspace settings.");
+  assert.equal(workspaceSettingsActionSpecifications[1].extensions?.assistant?.description, "Update the active workspace appearance and invitation settings.");
 });
 
 test("workspace actions array excludes workspace settings actions", () => {