@burdenoff/mcp-libs 2026.1012.1 → 2026.1013.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,114 +1,380 @@
1
- import { mcpToolName, errorResult } from '../../chunk-G76DKEPI.js';
1
+ import { mcpToolName, jsonResult, errorResult } from '../../chunk-G76DKEPI.js';
2
2
  import { z } from 'zod';
3
3
 
4
- function stubbedTool(server, toolName, title, description, featureNote, inputSchema, altSuggestions) {
4
+ // src/modules/groups/operations.ts
5
+ var LIST_GROUPS = `
6
+ query ListGroups($filter: GroupFilterInput, $first: Int, $after: String, $sort: GroupSortInput) {
7
+ groups(filter: $filter, first: $first, after: $after, sort: $sort) {
8
+ edges { node { id name groupType visibility status memberCount createdAt } }
9
+ pageInfo { hasNextPage endCursor }
10
+ }
11
+ }
12
+ `;
13
+ var GET_GROUP = `
14
+ query GetGroup($id: ID!) {
15
+ group(id: $id) {
16
+ id name description groupType visibility status scope membershipType memberCount createdAt updatedAt
17
+ }
18
+ }
19
+ `;
20
+ var CREATE_GROUP = `
21
+ mutation CreateGroup($input: CreateGroupInput!) {
22
+ createGroup(input: $input) {
23
+ id name groupType visibility status
24
+ }
25
+ }
26
+ `;
27
+ var UPDATE_GROUP = `
28
+ mutation UpdateGroup($id: ID!, $input: UpdateGroupInput!) {
29
+ updateGroup(id: $id, input: $input) {
30
+ id name description visibility status updatedAt
31
+ }
32
+ }
33
+ `;
34
+ var DELETE_GROUP = `
35
+ mutation DeleteGroup($id: ID!) {
36
+ deleteGroup(id: $id)
37
+ }
38
+ `;
39
+ var ARCHIVE_GROUP = `
40
+ mutation ArchiveGroup($id: ID!) {
41
+ archiveGroup(id: $id) { id status }
42
+ }
43
+ `;
44
+ var LIST_GROUP_MEMBERS = `
45
+ query ListGroupMembers($groupId: ID!, $first: Int, $after: String) {
46
+ groupMembers(groupId: $groupId, first: $first, after: $after) {
47
+ edges { node { id entityId entityType role status joinedAt } }
48
+ pageInfo { hasNextPage endCursor }
49
+ }
50
+ }
51
+ `;
52
+ var ADD_GROUP_MEMBERS = `
53
+ mutation AddGroupMembers($groupId: ID!, $members: [AddMemberInput!]!) {
54
+ addGroupMembers(groupId: $groupId, members: $members) {
55
+ added skipped failed
56
+ memberships { id entityId role status }
57
+ }
58
+ }
59
+ `;
60
+ var REMOVE_GROUP_MEMBERS = `
61
+ mutation RemoveGroupMembers($groupId: ID!, $membershipIds: [ID!]!) {
62
+ removeGroupMembers(groupId: $groupId, membershipIds: $membershipIds) {
63
+ removed
64
+ }
65
+ }
66
+ `;
67
+ var GROUP_AUDIT_LOGS = `
68
+ query GroupAuditLogs($groupId: ID!, $first: Int, $after: String) {
69
+ groupAuditLogs(groupId: $groupId, first: $first, after: $after) {
70
+ id action actorId summary createdAt
71
+ }
72
+ }
73
+ `;
74
+ var ENTITY_GROUPS = `
75
+ query EntityGroups($entityId: ID!, $entityType: GroupEntityType!, $first: Int) {
76
+ entityGroups(entityId: $entityId, entityType: $entityType, first: $first) {
77
+ edges { node { id name groupType visibility memberCount } }
78
+ }
79
+ }
80
+ `;
81
+
82
+ // src/modules/groups/tools.ts
83
+ var GroupTypeEnum = z.enum(["STANDARD", "TEAM", "SECURITY", "DISTRIBUTION", "PROJECT", "CUSTOM"]).describe("Group classification");
84
+ var VisibilityEnum = z.enum(["PUBLIC", "PRIVATE", "HIDDEN"]).describe("Group visibility");
85
+ var ScopeEnum = z.enum(["workspace", "organization"]).describe("Scope of the group");
86
+ var MembershipTypeEnum = z.enum(["OPEN", "INVITE_ONLY", "RULE_BASED"]).describe("How membership is granted");
87
+ var StatusEnum = z.string().describe("Group status (will be uppercased)");
88
+ var EntityTypeEnum = z.enum(["USER", "GROUP", "BOT", "INTEGRATION"]).describe("Entity type for membership");
89
+ var MemberRoleEnum = z.enum(["MEMBER", "OWNER", "ADMIN"]).describe("Role within the group");
90
+ function registerGroupsTools(server, ctx, track) {
5
91
  server.registerTool(
6
- toolName,
92
+ track(mcpToolName(ctx.productName, "groups_list")),
7
93
  {
8
- title,
9
- description: `${description} [STUB]`,
10
- inputSchema
94
+ title: "List Groups",
95
+ description: "List groups with optional type/status filters and pagination.",
96
+ inputSchema: {
97
+ type: GroupTypeEnum.optional().describe("Filter by groupType"),
98
+ status: z.string().optional().describe("Filter by status (will be uppercased)"),
99
+ limit: z.number().optional().describe("Page size (default 50)")
100
+ }
11
101
  },
12
- async () => errorResult(
13
- `[stubbed] ${featureNote} Use ${altSuggestions.join(", ")} instead. The tool remains registered so callers receive a meaningful response instead of a schema-validation error.`
14
- )
15
- );
16
- }
17
- function registerGroupsTools(server, ctx, track) {
18
- const featureNote = "Live alpha removed `Query.groups`; the groups module is being moved to its own service.";
19
- const alts = [
20
- "the next alpha release that re-exposes the groups surface",
21
- "the SDK groups API (which the MCP will mirror once it lands)"
22
- ];
23
- stubbedTool(
24
- server,
25
- track(mcpToolName(ctx.productName, "groups_list")),
26
- "List Groups",
27
- "List groups with optional type/status filters.",
28
- featureNote,
29
- {},
30
- alts
102
+ async ({ type, status, limit }) => {
103
+ try {
104
+ const filter = {};
105
+ if (type !== void 0) filter.groupType = type;
106
+ if (status !== void 0) filter.status = status.toUpperCase();
107
+ const data = await ctx.gql.workspace.request(LIST_GROUPS, {
108
+ filter: Object.keys(filter).length > 0 ? filter : void 0,
109
+ first: limit ?? 50
110
+ });
111
+ return jsonResult({
112
+ items: data.groups.edges.map((e) => e.node),
113
+ pageInfo: data.groups.pageInfo
114
+ });
115
+ } catch (error) {
116
+ ctx.logger.error("groups_list failed", { error: String(error) });
117
+ return errorResult(
118
+ `Failed to list groups: ${error instanceof Error ? error.message : String(error)}`
119
+ );
120
+ }
121
+ }
31
122
  );
32
- stubbedTool(
33
- server,
123
+ server.registerTool(
34
124
  track(mcpToolName(ctx.productName, "groups_get")),
35
- "Get Group",
36
- "Get a group by ID.",
37
- featureNote,
38
- { id: z.string() },
39
- alts
125
+ {
126
+ title: "Get Group",
127
+ description: "Get a group by its ID.",
128
+ inputSchema: { id: z.string().describe("Group ID") }
129
+ },
130
+ async ({ id }) => {
131
+ try {
132
+ const data = await ctx.gql.workspace.request(GET_GROUP, {
133
+ id
134
+ });
135
+ if (!data.group) {
136
+ return errorResult(`Group ${id} not found`);
137
+ }
138
+ return jsonResult(data.group);
139
+ } catch (error) {
140
+ ctx.logger.error("groups_get failed", { error: String(error) });
141
+ return errorResult(
142
+ `Failed to get group: ${error instanceof Error ? error.message : String(error)}`
143
+ );
144
+ }
145
+ }
40
146
  );
41
- stubbedTool(
42
- server,
147
+ server.registerTool(
43
148
  track(mcpToolName(ctx.productName, "groups_create")),
44
- "Create Group",
45
- "Create a new group.",
46
- featureNote,
47
- { name: z.string() },
48
- alts
149
+ {
150
+ title: "Create Group",
151
+ description: "Create a new group.",
152
+ inputSchema: {
153
+ name: z.string().describe("Group name"),
154
+ description: z.string().optional().describe("Group description"),
155
+ groupType: GroupTypeEnum.optional().describe("Group type (default STANDARD)"),
156
+ visibility: VisibilityEnum.optional().describe("Visibility (default PRIVATE)"),
157
+ scope: ScopeEnum.optional().describe("Scope (default workspace)"),
158
+ membershipType: MembershipTypeEnum.optional().describe(
159
+ "Membership type (default INVITE_ONLY)"
160
+ )
161
+ }
162
+ },
163
+ async ({ name, description, groupType, visibility, scope, membershipType }) => {
164
+ try {
165
+ const input = {
166
+ name,
167
+ groupType: groupType ?? "STANDARD",
168
+ visibility: visibility ?? "PRIVATE",
169
+ scope: scope ?? "workspace",
170
+ membershipType: membershipType ?? "INVITE_ONLY"
171
+ };
172
+ if (description !== void 0) input.description = description;
173
+ const data = await ctx.gql.workspace.request(CREATE_GROUP, {
174
+ input
175
+ });
176
+ return jsonResult(data.createGroup);
177
+ } catch (error) {
178
+ ctx.logger.error("groups_create failed", { error: String(error) });
179
+ return errorResult(
180
+ `Failed to create group: ${error instanceof Error ? error.message : String(error)}`
181
+ );
182
+ }
183
+ }
49
184
  );
50
- stubbedTool(
51
- server,
185
+ server.registerTool(
52
186
  track(mcpToolName(ctx.productName, "groups_update")),
53
- "Update Group",
54
- "Update a group.",
55
- featureNote,
56
- { id: z.string() },
57
- alts
187
+ {
188
+ title: "Update Group",
189
+ description: "Update a group. At least one mutable field must be provided.",
190
+ inputSchema: {
191
+ id: z.string().describe("Group ID"),
192
+ name: z.string().optional().describe("Updated name"),
193
+ description: z.string().optional().describe("Updated description"),
194
+ visibility: VisibilityEnum.optional().describe("Updated visibility"),
195
+ status: StatusEnum.optional()
196
+ }
197
+ },
198
+ async ({ id, name, description, visibility, status }) => {
199
+ try {
200
+ const input = {};
201
+ if (name !== void 0) input.name = name;
202
+ if (description !== void 0) input.description = description;
203
+ if (visibility !== void 0) input.visibility = visibility;
204
+ if (status !== void 0) input.status = status.toUpperCase();
205
+ if (Object.keys(input).length === 0) {
206
+ return errorResult(
207
+ "No updates specified \u2014 provide at least one of name/description/visibility/status"
208
+ );
209
+ }
210
+ const data = await ctx.gql.workspace.request(UPDATE_GROUP, {
211
+ id,
212
+ input
213
+ });
214
+ return jsonResult(data.updateGroup);
215
+ } catch (error) {
216
+ ctx.logger.error("groups_update failed", { error: String(error) });
217
+ return errorResult(
218
+ `Failed to update group: ${error instanceof Error ? error.message : String(error)}`
219
+ );
220
+ }
221
+ }
58
222
  );
59
- stubbedTool(
60
- server,
223
+ server.registerTool(
61
224
  track(mcpToolName(ctx.productName, "groups_delete")),
62
- "Delete Group",
63
- "Delete a group.",
64
- featureNote,
65
- { id: z.string() },
66
- alts
67
- );
68
- stubbedTool(
69
- server,
70
- track(mcpToolName(ctx.productName, "groups_hierarchy")),
71
- "Groups Hierarchy",
72
- "Return the hierarchy of a workspace's groups.",
73
- featureNote,
74
- { workspaceId: z.string().optional() },
75
- alts
225
+ {
226
+ title: "Delete Group",
227
+ description: "Delete a group. Use archive=true for a soft delete (status change only).",
228
+ inputSchema: {
229
+ id: z.string().describe("Group ID"),
230
+ archive: z.boolean().optional().describe("Archive instead of hard delete (default false)")
231
+ }
232
+ },
233
+ async ({ id, archive }) => {
234
+ try {
235
+ if (archive === true) {
236
+ const data2 = await ctx.gql.workspace.request(ARCHIVE_GROUP, { id });
237
+ return jsonResult({ archived: true, group: data2.archiveGroup });
238
+ }
239
+ const data = await ctx.gql.workspace.request(DELETE_GROUP, {
240
+ id
241
+ });
242
+ return jsonResult({ deleted: data.deleteGroup, groupId: id });
243
+ } catch (error) {
244
+ ctx.logger.error("groups_delete failed", { error: String(error) });
245
+ return errorResult(
246
+ `Failed to delete group: ${error instanceof Error ? error.message : String(error)}`
247
+ );
248
+ }
249
+ }
76
250
  );
77
- stubbedTool(
78
- server,
251
+ server.registerTool(
79
252
  track(mcpToolName(ctx.productName, "groups_members_list")),
80
- "List Group Members",
81
- "List members of a group.",
82
- featureNote,
83
- { groupId: z.string() },
84
- alts
253
+ {
254
+ title: "List Group Members",
255
+ description: "List members of a group.",
256
+ inputSchema: {
257
+ groupId: z.string().describe("Group ID"),
258
+ limit: z.number().optional().describe("Page size (default 100)")
259
+ }
260
+ },
261
+ async ({ groupId, limit }) => {
262
+ try {
263
+ const data = await ctx.gql.workspace.request(LIST_GROUP_MEMBERS, { groupId, first: limit ?? 100 });
264
+ return jsonResult({
265
+ items: data.groupMembers.edges.map((e) => e.node),
266
+ pageInfo: data.groupMembers.pageInfo
267
+ });
268
+ } catch (error) {
269
+ ctx.logger.error("groups_members_list failed", { error: String(error) });
270
+ return errorResult(
271
+ `Failed to list group members: ${error instanceof Error ? error.message : String(error)}`
272
+ );
273
+ }
274
+ }
85
275
  );
86
- stubbedTool(
87
- server,
276
+ server.registerTool(
88
277
  track(mcpToolName(ctx.productName, "groups_members_add")),
89
- "Add Group Members",
90
- "Add members to a group.",
91
- featureNote,
92
- { groupId: z.string() },
93
- alts
278
+ {
279
+ title: "Add Group Member",
280
+ description: "Add a single member to a group.",
281
+ inputSchema: {
282
+ groupId: z.string().describe("Group ID"),
283
+ entityId: z.string().describe("Entity (user/group/bot/integration) ID to add"),
284
+ entityType: EntityTypeEnum.optional().describe("Entity type (default USER)"),
285
+ role: MemberRoleEnum.optional().describe("Role (default MEMBER)")
286
+ }
287
+ },
288
+ async ({ groupId, entityId, entityType, role }) => {
289
+ try {
290
+ const member = {
291
+ entityId,
292
+ entityType: entityType ?? "USER",
293
+ role: role ?? "MEMBER"
294
+ };
295
+ const data = await ctx.gql.workspace.request(ADD_GROUP_MEMBERS, { groupId, members: [member] });
296
+ return jsonResult(data.addGroupMembers);
297
+ } catch (error) {
298
+ ctx.logger.error("groups_members_add failed", { error: String(error) });
299
+ return errorResult(
300
+ `Failed to add group member: ${error instanceof Error ? error.message : String(error)}`
301
+ );
302
+ }
303
+ }
94
304
  );
95
- stubbedTool(
96
- server,
305
+ server.registerTool(
97
306
  track(mcpToolName(ctx.productName, "groups_members_remove")),
98
- "Remove Group Members",
99
- "Remove members from a group.",
100
- featureNote,
101
- { groupId: z.string() },
102
- alts
307
+ {
308
+ title: "Remove Group Members",
309
+ description: "Remove one or more members from a group by membership ID.",
310
+ inputSchema: {
311
+ groupId: z.string().describe("Group ID"),
312
+ membershipIds: z.array(z.string()).describe("Membership IDs to remove")
313
+ }
314
+ },
315
+ async ({ groupId, membershipIds }) => {
316
+ try {
317
+ if (membershipIds.length === 0) {
318
+ return errorResult("At least one membershipId is required");
319
+ }
320
+ const data = await ctx.gql.workspace.request(REMOVE_GROUP_MEMBERS, { groupId, membershipIds });
321
+ return jsonResult(data.removeGroupMembers);
322
+ } catch (error) {
323
+ ctx.logger.error("groups_members_remove failed", { error: String(error) });
324
+ return errorResult(
325
+ `Failed to remove group members: ${error instanceof Error ? error.message : String(error)}`
326
+ );
327
+ }
328
+ }
329
+ );
330
+ server.registerTool(
331
+ track(mcpToolName(ctx.productName, "groups_hierarchy")),
332
+ {
333
+ title: "Entity Group Hierarchy",
334
+ description: "Show all groups an entity (user/group) belongs to.",
335
+ inputSchema: {
336
+ entityId: z.string().describe("Entity ID (user/group)"),
337
+ entityType: z.enum(["USER", "GROUP"]).optional().describe("Entity type (default USER)"),
338
+ limit: z.number().optional().describe("Page size (default 100)")
339
+ }
340
+ },
341
+ async ({ entityId, entityType, limit }) => {
342
+ try {
343
+ const data = await ctx.gql.workspace.request(ENTITY_GROUPS, {
344
+ entityId,
345
+ entityType: entityType ?? "USER",
346
+ first: limit ?? 100
347
+ });
348
+ return jsonResult(data.entityGroups.edges.map((e) => e.node));
349
+ } catch (error) {
350
+ ctx.logger.error("groups_hierarchy failed", { error: String(error) });
351
+ return errorResult(
352
+ `Failed to get group hierarchy: ${error instanceof Error ? error.message : String(error)}`
353
+ );
354
+ }
355
+ }
103
356
  );
104
- stubbedTool(
105
- server,
357
+ server.registerTool(
106
358
  track(mcpToolName(ctx.productName, "groups_activity")),
107
- "Group Activity",
108
- "Get activity log entries for a group.",
109
- featureNote,
110
- { groupId: z.string() },
111
- alts
359
+ {
360
+ title: "Group Audit Log",
361
+ description: "Audit log for a group.",
362
+ inputSchema: {
363
+ groupId: z.string().describe("Group ID"),
364
+ limit: z.number().optional().describe("Page size (default 100)")
365
+ }
366
+ },
367
+ async ({ groupId, limit }) => {
368
+ try {
369
+ const data = await ctx.gql.workspace.request(GROUP_AUDIT_LOGS, { groupId, first: limit ?? 100 });
370
+ return jsonResult(data.groupAuditLogs);
371
+ } catch (error) {
372
+ ctx.logger.error("groups_activity failed", { error: String(error) });
373
+ return errorResult(
374
+ `Failed to get group activity: ${error instanceof Error ? error.message : String(error)}`
375
+ );
376
+ }
377
+ }
112
378
  );
113
379
  }
114
380
 
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../src/modules/groups/tools.ts","../../../src/modules/groups/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Groups MCP tools — CRUD + members.{list,add,remove} + hierarchy + activity.\n * Surface mirrors cli-sdk/src/modules/groups/commands.ts.\n */\n\nimport { z } from 'zod';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { errorResult, mcpToolName, type McpContext } from '../../core/index.js';\n\ntype StubInputSchema = Record<string, z.ZodTypeAny>;\nfunction stubbedTool(\n server: McpServer,\n toolName: string,\n title: string,\n description: string,\n featureNote: string,\n inputSchema: StubInputSchema,\n altSuggestions: string[],\n): void {\n server.registerTool(\n toolName,\n {\n title,\n description: `${description} [STUB]`,\n inputSchema,\n },\n async () =>\n errorResult(\n `[stubbed] ${featureNote} Use ${altSuggestions.join(', ')} instead. The tool remains registered so callers receive a meaningful response instead of a schema-validation error.`,\n ),\n );\n}\n\nexport function registerGroupsTools(\n server: McpServer,\n ctx: McpContext,\n track: (n: string) => string,\n): void {\n // BOFF-8194: `Query.groups` is gone on the live alpha gateway\n // (the closest related field is `roles`, a different domain). The\n // whole groups module is unreachable today. Stub every tool so\n // callers get a clean \"[stubbed]\" error and the per-call wiring\n // is in place for the day alpha re-exposes the groups surface.\n const featureNote =\n 'Live alpha removed `Query.groups`; the groups module is being moved to its own service.';\n const alts = [\n 'the next alpha release that re-exposes the groups surface',\n 'the SDK groups API (which the MCP will mirror once it lands)',\n ];\n\n stubbedTool(\n server,\n track(mcpToolName(ctx.productName, 'groups_list')),\n 'List Groups',\n 'List groups with optional type/status filters.',\n featureNote,\n {},\n alts,\n );\n stubbedTool(\n server,\n track(mcpToolName(ctx.productName, 'groups_get')),\n 'Get Group',\n 'Get a group by ID.',\n featureNote,\n { id: z.string() },\n alts,\n );\n stubbedTool(\n server,\n track(mcpToolName(ctx.productName, 'groups_create')),\n 'Create Group',\n 'Create a new group.',\n featureNote,\n { name: z.string() },\n alts,\n );\n stubbedTool(\n server,\n track(mcpToolName(ctx.productName, 'groups_update')),\n 'Update Group',\n 'Update a group.',\n featureNote,\n { id: z.string() },\n alts,\n );\n stubbedTool(\n server,\n track(mcpToolName(ctx.productName, 'groups_delete')),\n 'Delete Group',\n 'Delete a group.',\n featureNote,\n { id: z.string() },\n alts,\n );\n stubbedTool(\n server,\n track(mcpToolName(ctx.productName, 'groups_hierarchy')),\n 'Groups Hierarchy',\n \"Return the hierarchy of a workspace's groups.\",\n featureNote,\n { workspaceId: z.string().optional() },\n alts,\n );\n stubbedTool(\n server,\n track(mcpToolName(ctx.productName, 'groups_members_list')),\n 'List Group Members',\n 'List members of a group.',\n featureNote,\n { groupId: z.string() },\n alts,\n );\n stubbedTool(\n server,\n track(mcpToolName(ctx.productName, 'groups_members_add')),\n 'Add Group Members',\n 'Add members to a group.',\n featureNote,\n { groupId: z.string() },\n alts,\n );\n stubbedTool(\n server,\n track(mcpToolName(ctx.productName, 'groups_members_remove')),\n 'Remove Group Members',\n 'Remove members from a group.',\n featureNote,\n { groupId: z.string() },\n alts,\n );\n stubbedTool(\n server,\n track(mcpToolName(ctx.productName, 'groups_activity')),\n 'Group Activity',\n 'Get activity log entries for a group.',\n featureNote,\n { groupId: z.string() },\n alts,\n );\n}\n","/**\n * Groups module — workspace groups CRUD + members + hierarchy + activity.\n * Surface mirrors cli-sdk/src/modules/groups/.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { McpContext, McpModule, ModuleRegistration } from '../../core/index.js';\nimport { registerGroupsTools } from './tools.js';\n\nconst groupsModule: McpModule = {\n id: 'groups',\n version: '0.0.1',\n displayName: 'Groups',\n dependsOn: ['auth'],\n capabilities: { tools: {} },\n\n register(server: McpServer, ctx: McpContext): ModuleRegistration {\n const tools: string[] = [];\n const track = (n: string): string => {\n tools.push(n);\n return n;\n };\n\n registerGroupsTools(server, ctx, track);\n\n return { tools, resources: [], prompts: [] };\n },\n};\n\nexport default groupsModule;\n"]}
1
+ {"version":3,"sources":["../../../src/modules/groups/operations.ts","../../../src/modules/groups/tools.ts","../../../src/modules/groups/index.ts"],"names":["data"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Groups module GraphQL operations.\n * Ported verbatim from cli-sdk/src/modules/groups/operations.ts.\n */\n\nexport const LIST_GROUPS = `\n query ListGroups($filter: GroupFilterInput, $first: Int, $after: String, $sort: GroupSortInput) {\n groups(filter: $filter, first: $first, after: $after, sort: $sort) {\n edges { node { id name groupType visibility status memberCount createdAt } }\n pageInfo { hasNextPage endCursor }\n }\n }\n`;\n\nexport const GET_GROUP = `\n query GetGroup($id: ID!) {\n group(id: $id) {\n id name description groupType visibility status scope membershipType memberCount createdAt updatedAt\n }\n }\n`;\n\nexport const CREATE_GROUP = `\n mutation CreateGroup($input: CreateGroupInput!) {\n createGroup(input: $input) {\n id name groupType visibility status\n }\n }\n`;\n\nexport const UPDATE_GROUP = `\n mutation UpdateGroup($id: ID!, $input: UpdateGroupInput!) {\n updateGroup(id: $id, input: $input) {\n id name description visibility status updatedAt\n }\n }\n`;\n\nexport const DELETE_GROUP = `\n mutation DeleteGroup($id: ID!) {\n deleteGroup(id: $id)\n }\n`;\n\nexport const ARCHIVE_GROUP = `\n mutation ArchiveGroup($id: ID!) {\n archiveGroup(id: $id) { id status }\n }\n`;\n\nexport const LIST_GROUP_MEMBERS = `\n query ListGroupMembers($groupId: ID!, $first: Int, $after: String) {\n groupMembers(groupId: $groupId, first: $first, after: $after) {\n edges { node { id entityId entityType role status joinedAt } }\n pageInfo { hasNextPage endCursor }\n }\n }\n`;\n\nexport const ADD_GROUP_MEMBERS = `\n mutation AddGroupMembers($groupId: ID!, $members: [AddMemberInput!]!) {\n addGroupMembers(groupId: $groupId, members: $members) {\n added skipped failed\n memberships { id entityId role status }\n }\n }\n`;\n\nexport const REMOVE_GROUP_MEMBERS = `\n mutation RemoveGroupMembers($groupId: ID!, $membershipIds: [ID!]!) {\n removeGroupMembers(groupId: $groupId, membershipIds: $membershipIds) {\n removed\n }\n }\n`;\n\nexport const GROUP_AUDIT_LOGS = `\n query GroupAuditLogs($groupId: ID!, $first: Int, $after: String) {\n groupAuditLogs(groupId: $groupId, first: $first, after: $after) {\n id action actorId summary createdAt\n }\n }\n`;\n\nexport const ENTITY_GROUPS = `\n query EntityGroups($entityId: ID!, $entityType: GroupEntityType!, $first: Int) {\n entityGroups(entityId: $entityId, entityType: $entityType, first: $first) {\n edges { node { id name groupType visibility memberCount } }\n }\n }\n`;\n","/**\n * Groups MCP tools — CRUD + members.{list,add,remove} + hierarchy + activity.\n * Surface mirrors cli-sdk/src/modules/groups/commands.ts.\n */\n\nimport { z } from 'zod';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { jsonResult, errorResult, mcpToolName, type McpContext } from '../../core/index.js';\nimport * as ops from './operations.js';\n\ninterface GroupNode {\n id: string;\n name: string;\n groupType?: string;\n visibility?: string;\n status?: string;\n memberCount?: number;\n createdAt?: string;\n}\n\ninterface MembershipNode {\n id: string;\n entityId: string;\n entityType?: string;\n role?: string;\n status?: string;\n joinedAt?: string;\n}\n\nconst GroupTypeEnum = z\n .enum(['STANDARD', 'TEAM', 'SECURITY', 'DISTRIBUTION', 'PROJECT', 'CUSTOM'])\n .describe('Group classification');\nconst VisibilityEnum = z.enum(['PUBLIC', 'PRIVATE', 'HIDDEN']).describe('Group visibility');\nconst ScopeEnum = z.enum(['workspace', 'organization']).describe('Scope of the group');\nconst MembershipTypeEnum = z\n .enum(['OPEN', 'INVITE_ONLY', 'RULE_BASED'])\n .describe('How membership is granted');\nconst StatusEnum = z.string().describe('Group status (will be uppercased)');\nconst EntityTypeEnum = z\n .enum(['USER', 'GROUP', 'BOT', 'INTEGRATION'])\n .describe('Entity type for membership');\nconst MemberRoleEnum = z.enum(['MEMBER', 'OWNER', 'ADMIN']).describe('Role within the group');\n\nexport function registerGroupsTools(\n server: McpServer,\n ctx: McpContext,\n track: (n: string) => string,\n): void {\n server.registerTool(\n track(mcpToolName(ctx.productName, 'groups_list')),\n {\n title: 'List Groups',\n description: 'List groups with optional type/status filters and pagination.',\n inputSchema: {\n type: GroupTypeEnum.optional().describe('Filter by groupType'),\n status: z.string().optional().describe('Filter by status (will be uppercased)'),\n limit: z.number().optional().describe('Page size (default 50)'),\n },\n },\n async ({ type, status, limit }) => {\n try {\n const filter: Record<string, unknown> = {};\n if (type !== undefined) filter.groupType = type;\n if (status !== undefined) filter.status = status.toUpperCase();\n\n const data = await ctx.gql.workspace.request<{\n groups: { edges: Array<{ node: GroupNode }>; pageInfo: { hasNextPage: boolean } };\n }>(ops.LIST_GROUPS, {\n filter: Object.keys(filter).length > 0 ? filter : undefined,\n first: limit ?? 50,\n });\n return jsonResult({\n items: data.groups.edges.map((e) => e.node),\n pageInfo: data.groups.pageInfo,\n });\n } catch (error) {\n ctx.logger.error('groups_list failed', { error: String(error) });\n return errorResult(\n `Failed to list groups: ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n },\n );\n\n server.registerTool(\n track(mcpToolName(ctx.productName, 'groups_get')),\n {\n title: 'Get Group',\n description: 'Get a group by its ID.',\n inputSchema: { id: z.string().describe('Group ID') },\n },\n async ({ id }) => {\n try {\n const data = await ctx.gql.workspace.request<{ group: GroupNode | null }>(ops.GET_GROUP, {\n id,\n });\n if (!data.group) {\n return errorResult(`Group ${id} not found`);\n }\n return jsonResult(data.group);\n } catch (error) {\n ctx.logger.error('groups_get failed', { error: String(error) });\n return errorResult(\n `Failed to get group: ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n },\n );\n\n server.registerTool(\n track(mcpToolName(ctx.productName, 'groups_create')),\n {\n title: 'Create Group',\n description: 'Create a new group.',\n inputSchema: {\n name: z.string().describe('Group name'),\n description: z.string().optional().describe('Group description'),\n groupType: GroupTypeEnum.optional().describe('Group type (default STANDARD)'),\n visibility: VisibilityEnum.optional().describe('Visibility (default PRIVATE)'),\n scope: ScopeEnum.optional().describe('Scope (default workspace)'),\n membershipType: MembershipTypeEnum.optional().describe(\n 'Membership type (default INVITE_ONLY)',\n ),\n },\n },\n async ({ name, description, groupType, visibility, scope, membershipType }) => {\n try {\n const input: Record<string, unknown> = {\n name,\n groupType: groupType ?? 'STANDARD',\n visibility: visibility ?? 'PRIVATE',\n scope: scope ?? 'workspace',\n membershipType: membershipType ?? 'INVITE_ONLY',\n };\n if (description !== undefined) input.description = description;\n\n const data = await ctx.gql.workspace.request<{ createGroup: GroupNode }>(ops.CREATE_GROUP, {\n input,\n });\n return jsonResult(data.createGroup);\n } catch (error) {\n ctx.logger.error('groups_create failed', { error: String(error) });\n return errorResult(\n `Failed to create group: ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n },\n );\n\n server.registerTool(\n track(mcpToolName(ctx.productName, 'groups_update')),\n {\n title: 'Update Group',\n description: 'Update a group. At least one mutable field must be provided.',\n inputSchema: {\n id: z.string().describe('Group ID'),\n name: z.string().optional().describe('Updated name'),\n description: z.string().optional().describe('Updated description'),\n visibility: VisibilityEnum.optional().describe('Updated visibility'),\n status: StatusEnum.optional(),\n },\n },\n async ({ id, name, description, visibility, status }) => {\n try {\n const input: Record<string, unknown> = {};\n if (name !== undefined) input.name = name;\n if (description !== undefined) input.description = description;\n if (visibility !== undefined) input.visibility = visibility;\n if (status !== undefined) input.status = status.toUpperCase();\n if (Object.keys(input).length === 0) {\n return errorResult(\n 'No updates specified — provide at least one of name/description/visibility/status',\n );\n }\n const data = await ctx.gql.workspace.request<{ updateGroup: GroupNode }>(ops.UPDATE_GROUP, {\n id,\n input,\n });\n return jsonResult(data.updateGroup);\n } catch (error) {\n ctx.logger.error('groups_update failed', { error: String(error) });\n return errorResult(\n `Failed to update group: ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n },\n );\n\n server.registerTool(\n track(mcpToolName(ctx.productName, 'groups_delete')),\n {\n title: 'Delete Group',\n description: 'Delete a group. Use archive=true for a soft delete (status change only).',\n inputSchema: {\n id: z.string().describe('Group ID'),\n archive: z.boolean().optional().describe('Archive instead of hard delete (default false)'),\n },\n },\n async ({ id, archive }) => {\n try {\n if (archive === true) {\n const data = await ctx.gql.workspace.request<{\n archiveGroup: { id: string; status: string };\n }>(ops.ARCHIVE_GROUP, { id });\n return jsonResult({ archived: true, group: data.archiveGroup });\n }\n const data = await ctx.gql.workspace.request<{ deleteGroup: boolean }>(ops.DELETE_GROUP, {\n id,\n });\n return jsonResult({ deleted: data.deleteGroup, groupId: id });\n } catch (error) {\n ctx.logger.error('groups_delete failed', { error: String(error) });\n return errorResult(\n `Failed to delete group: ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n },\n );\n\n // ── Members ─────────────────────────────────────────────────────────────\n server.registerTool(\n track(mcpToolName(ctx.productName, 'groups_members_list')),\n {\n title: 'List Group Members',\n description: 'List members of a group.',\n inputSchema: {\n groupId: z.string().describe('Group ID'),\n limit: z.number().optional().describe('Page size (default 100)'),\n },\n },\n async ({ groupId, limit }) => {\n try {\n const data = await ctx.gql.workspace.request<{\n groupMembers: {\n edges: Array<{ node: MembershipNode }>;\n pageInfo: { hasNextPage: boolean; endCursor?: string };\n };\n }>(ops.LIST_GROUP_MEMBERS, { groupId, first: limit ?? 100 });\n return jsonResult({\n items: data.groupMembers.edges.map((e) => e.node),\n pageInfo: data.groupMembers.pageInfo,\n });\n } catch (error) {\n ctx.logger.error('groups_members_list failed', { error: String(error) });\n return errorResult(\n `Failed to list group members: ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n },\n );\n\n server.registerTool(\n track(mcpToolName(ctx.productName, 'groups_members_add')),\n {\n title: 'Add Group Member',\n description: 'Add a single member to a group.',\n inputSchema: {\n groupId: z.string().describe('Group ID'),\n entityId: z.string().describe('Entity (user/group/bot/integration) ID to add'),\n entityType: EntityTypeEnum.optional().describe('Entity type (default USER)'),\n role: MemberRoleEnum.optional().describe('Role (default MEMBER)'),\n },\n },\n async ({ groupId, entityId, entityType, role }) => {\n try {\n const member: Record<string, unknown> = {\n entityId,\n entityType: entityType ?? 'USER',\n role: role ?? 'MEMBER',\n };\n const data = await ctx.gql.workspace.request<{\n addGroupMembers: {\n added: number;\n skipped: number;\n failed: number;\n memberships: MembershipNode[];\n };\n }>(ops.ADD_GROUP_MEMBERS, { groupId, members: [member] });\n return jsonResult(data.addGroupMembers);\n } catch (error) {\n ctx.logger.error('groups_members_add failed', { error: String(error) });\n return errorResult(\n `Failed to add group member: ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n },\n );\n\n server.registerTool(\n track(mcpToolName(ctx.productName, 'groups_members_remove')),\n {\n title: 'Remove Group Members',\n description: 'Remove one or more members from a group by membership ID.',\n inputSchema: {\n groupId: z.string().describe('Group ID'),\n membershipIds: z.array(z.string()).describe('Membership IDs to remove'),\n },\n },\n async ({ groupId, membershipIds }) => {\n try {\n if (membershipIds.length === 0) {\n return errorResult('At least one membershipId is required');\n }\n const data = await ctx.gql.workspace.request<{\n removeGroupMembers: { removed: number };\n }>(ops.REMOVE_GROUP_MEMBERS, { groupId, membershipIds });\n return jsonResult(data.removeGroupMembers);\n } catch (error) {\n ctx.logger.error('groups_members_remove failed', { error: String(error) });\n return errorResult(\n `Failed to remove group members: ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n },\n );\n\n // ── Hierarchy & activity ────────────────────────────────────────────────\n server.registerTool(\n track(mcpToolName(ctx.productName, 'groups_hierarchy')),\n {\n title: 'Entity Group Hierarchy',\n description: 'Show all groups an entity (user/group) belongs to.',\n inputSchema: {\n entityId: z.string().describe('Entity ID (user/group)'),\n entityType: z.enum(['USER', 'GROUP']).optional().describe('Entity type (default USER)'),\n limit: z.number().optional().describe('Page size (default 100)'),\n },\n },\n async ({ entityId, entityType, limit }) => {\n try {\n const data = await ctx.gql.workspace.request<{\n entityGroups: { edges: Array<{ node: GroupNode }> };\n }>(ops.ENTITY_GROUPS, {\n entityId,\n entityType: entityType ?? 'USER',\n first: limit ?? 100,\n });\n return jsonResult(data.entityGroups.edges.map((e) => e.node));\n } catch (error) {\n ctx.logger.error('groups_hierarchy failed', { error: String(error) });\n return errorResult(\n `Failed to get group hierarchy: ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n },\n );\n\n server.registerTool(\n track(mcpToolName(ctx.productName, 'groups_activity')),\n {\n title: 'Group Audit Log',\n description: 'Audit log for a group.',\n inputSchema: {\n groupId: z.string().describe('Group ID'),\n limit: z.number().optional().describe('Page size (default 100)'),\n },\n },\n async ({ groupId, limit }) => {\n try {\n const data = await ctx.gql.workspace.request<{\n groupAuditLogs: Array<Record<string, unknown>>;\n }>(ops.GROUP_AUDIT_LOGS, { groupId, first: limit ?? 100 });\n return jsonResult(data.groupAuditLogs);\n } catch (error) {\n ctx.logger.error('groups_activity failed', { error: String(error) });\n return errorResult(\n `Failed to get group activity: ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n },\n );\n}\n","/**\n * Groups module — workspace groups CRUD + members + hierarchy + activity.\n * Surface mirrors cli-sdk/src/modules/groups/.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { McpContext, McpModule, ModuleRegistration } from '../../core/index.js';\nimport { registerGroupsTools } from './tools.js';\n\nconst groupsModule: McpModule = {\n id: 'groups',\n version: '0.0.1',\n displayName: 'Groups',\n dependsOn: ['auth'],\n capabilities: { tools: {} },\n\n register(server: McpServer, ctx: McpContext): ModuleRegistration {\n const tools: string[] = [];\n const track = (n: string): string => {\n tools.push(n);\n return n;\n };\n\n registerGroupsTools(server, ctx, track);\n\n return { tools, resources: [], prompts: [] };\n },\n};\n\nexport default groupsModule;\n"]}