@burdenoff/mcp-libs 2026.511.1

package/dist/modules/groups/index.js

@@ -0,0 +1,402 @@
+import { mcpToolName, jsonResult, errorResult } from '../../chunk-H2OYWLOA.js';
+import { z } from 'zod';
+
+// src/modules/groups/operations.ts
+var LIST_GROUPS = `
+  query ListGroups($filter: GroupFilterInput, $first: Int, $after: String, $sort: GroupSortInput) {
+    groups(filter: $filter, first: $first, after: $after, sort: $sort) {
+      edges { node { id name groupType visibility status memberCount createdAt } }
+      pageInfo { hasNextPage endCursor }
+    }
+  }
+`;
+var GET_GROUP = `
+  query GetGroup($id: ID!) {
+    group(id: $id) {
+      id name description groupType visibility status scope membershipType memberCount createdAt updatedAt
+    }
+  }
+`;
+var CREATE_GROUP = `
+  mutation CreateGroup($input: CreateGroupInput!) {
+    createGroup(input: $input) {
+      id name groupType visibility status
+    }
+  }
+`;
+var UPDATE_GROUP = `
+  mutation UpdateGroup($id: ID!, $input: UpdateGroupInput!) {
+    updateGroup(id: $id, input: $input) {
+      id name description visibility status updatedAt
+    }
+  }
+`;
+var DELETE_GROUP = `
+  mutation DeleteGroup($id: ID!) {
+    deleteGroup(id: $id)
+  }
+`;
+var ARCHIVE_GROUP = `
+  mutation ArchiveGroup($id: ID!) {
+    archiveGroup(id: $id) { id status }
+  }
+`;
+var LIST_GROUP_MEMBERS = `
+  query ListGroupMembers($groupId: ID!, $first: Int, $after: String) {
+    groupMembers(groupId: $groupId, first: $first, after: $after) {
+      edges { node { id entityId entityType role status joinedAt } }
+      pageInfo { hasNextPage endCursor }
+    }
+  }
+`;
+var ADD_GROUP_MEMBERS = `
+  mutation AddGroupMembers($groupId: ID!, $members: [AddMemberInput!]!) {
+    addGroupMembers(groupId: $groupId, members: $members) {
+      added skipped failed
+      memberships { id entityId role status }
+    }
+  }
+`;
+var REMOVE_GROUP_MEMBERS = `
+  mutation RemoveGroupMembers($groupId: ID!, $membershipIds: [ID!]!) {
+    removeGroupMembers(groupId: $groupId, membershipIds: $membershipIds) {
+      removed
+    }
+  }
+`;
+var GROUP_AUDIT_LOGS = `
+  query GroupAuditLogs($groupId: ID!, $first: Int, $after: String) {
+    groupAuditLogs(groupId: $groupId, first: $first, after: $after) {
+      id action actorId summary createdAt
+    }
+  }
+`;
+var ENTITY_GROUPS = `
+  query EntityGroups($entityId: ID!, $entityType: GroupEntityType!, $first: Int) {
+    entityGroups(entityId: $entityId, entityType: $entityType, first: $first) {
+      edges { node { id name groupType visibility memberCount } }
+    }
+  }
+`;
+
+// src/modules/groups/tools.ts
+var GroupTypeEnum = z.enum(["STANDARD", "TEAM", "SECURITY", "DISTRIBUTION", "PROJECT", "CUSTOM"]).describe("Group classification");
+var VisibilityEnum = z.enum(["PUBLIC", "PRIVATE", "HIDDEN"]).describe("Group visibility");
+var ScopeEnum = z.enum(["workspace", "organization"]).describe("Scope of the group");
+var MembershipTypeEnum = z.enum(["OPEN", "INVITE_ONLY", "RULE_BASED"]).describe("How membership is granted");
+var StatusEnum = z.string().describe("Group status (will be uppercased)");
+var EntityTypeEnum = z.enum(["USER", "GROUP", "BOT", "INTEGRATION"]).describe("Entity type for membership");
+var MemberRoleEnum = z.enum(["MEMBER", "OWNER", "ADMIN"]).describe("Role within the group");
+function registerGroupsTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "groups_list")),
+    {
+      title: "List Groups",
+      description: "List groups with optional type/status filters and pagination.",
+      inputSchema: {
+        type: GroupTypeEnum.optional().describe("Filter by groupType"),
+        status: z.string().optional().describe("Filter by status (will be uppercased)"),
+        limit: z.number().optional().describe("Page size (default 50)")
+      }
+    },
+    async ({ type, status, limit }) => {
+      try {
+        const filter = {};
+        if (type !== void 0) filter.groupType = type;
+        if (status !== void 0) filter.status = status.toUpperCase();
+        const data = await ctx.gql.workspace.request(LIST_GROUPS, {
+          filter: Object.keys(filter).length > 0 ? filter : void 0,
+          first: limit ?? 50
+        });
+        return jsonResult({
+          items: data.groups.edges.map((e) => e.node),
+          pageInfo: data.groups.pageInfo
+        });
+      } catch (error) {
+        ctx.logger.error("groups_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list groups: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "groups_get")),
+    {
+      title: "Get Group",
+      description: "Get a group by its ID.",
+      inputSchema: { id: z.string().describe("Group ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_GROUP, {
+          id
+        });
+        if (!data.group) {
+          return errorResult(`Group ${id} not found`);
+        }
+        return jsonResult(data.group);
+      } catch (error) {
+        ctx.logger.error("groups_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get group: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "groups_create")),
+    {
+      title: "Create Group",
+      description: "Create a new group.",
+      inputSchema: {
+        name: z.string().describe("Group name"),
+        description: z.string().optional().describe("Group description"),
+        groupType: GroupTypeEnum.optional().describe("Group type (default STANDARD)"),
+        visibility: VisibilityEnum.optional().describe("Visibility (default PRIVATE)"),
+        scope: ScopeEnum.optional().describe("Scope (default workspace)"),
+        membershipType: MembershipTypeEnum.optional().describe(
+          "Membership type (default INVITE_ONLY)"
+        )
+      }
+    },
+    async ({ name, description, groupType, visibility, scope, membershipType }) => {
+      try {
+        const input = {
+          name,
+          groupType: groupType ?? "STANDARD",
+          visibility: visibility ?? "PRIVATE",
+          scope: scope ?? "workspace",
+          membershipType: membershipType ?? "INVITE_ONLY"
+        };
+        if (description !== void 0) input.description = description;
+        const data = await ctx.gql.workspace.request(CREATE_GROUP, {
+          input
+        });
+        return jsonResult(data.createGroup);
+      } catch (error) {
+        ctx.logger.error("groups_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create group: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "groups_update")),
+    {
+      title: "Update Group",
+      description: "Update a group. At least one mutable field must be provided.",
+      inputSchema: {
+        id: z.string().describe("Group ID"),
+        name: z.string().optional().describe("Updated name"),
+        description: z.string().optional().describe("Updated description"),
+        visibility: VisibilityEnum.optional().describe("Updated visibility"),
+        status: StatusEnum.optional()
+      }
+    },
+    async ({ id, name, description, visibility, status }) => {
+      try {
+        const input = {};
+        if (name !== void 0) input.name = name;
+        if (description !== void 0) input.description = description;
+        if (visibility !== void 0) input.visibility = visibility;
+        if (status !== void 0) input.status = status.toUpperCase();
+        if (Object.keys(input).length === 0) {
+          return errorResult(
+            "No updates specified \u2014 provide at least one of name/description/visibility/status"
+          );
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_GROUP, {
+          id,
+          input
+        });
+        return jsonResult(data.updateGroup);
+      } catch (error) {
+        ctx.logger.error("groups_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update group: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "groups_delete")),
+    {
+      title: "Delete Group",
+      description: "Delete a group. Use archive=true for a soft delete (status change only).",
+      inputSchema: {
+        id: z.string().describe("Group ID"),
+        archive: z.boolean().optional().describe("Archive instead of hard delete (default false)")
+      }
+    },
+    async ({ id, archive }) => {
+      try {
+        if (archive === true) {
+          const data2 = await ctx.gql.workspace.request(ARCHIVE_GROUP, { id });
+          return jsonResult({ archived: true, group: data2.archiveGroup });
+        }
+        const data = await ctx.gql.workspace.request(DELETE_GROUP, {
+          id
+        });
+        return jsonResult({ deleted: data.deleteGroup, groupId: id });
+      } catch (error) {
+        ctx.logger.error("groups_delete failed", { error: String(error) });
+        return errorResult(
+          `Failed to delete group: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "groups_members_list")),
+    {
+      title: "List Group Members",
+      description: "List members of a group.",
+      inputSchema: {
+        groupId: z.string().describe("Group ID"),
+        limit: z.number().optional().describe("Page size (default 100)")
+      }
+    },
+    async ({ groupId, limit }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_GROUP_MEMBERS, { groupId, first: limit ?? 100 });
+        return jsonResult({
+          items: data.groupMembers.edges.map((e) => e.node),
+          pageInfo: data.groupMembers.pageInfo
+        });
+      } catch (error) {
+        ctx.logger.error("groups_members_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list group members: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "groups_members_add")),
+    {
+      title: "Add Group Member",
+      description: "Add a single member to a group.",
+      inputSchema: {
+        groupId: z.string().describe("Group ID"),
+        entityId: z.string().describe("Entity (user/group/bot/integration) ID to add"),
+        entityType: EntityTypeEnum.optional().describe("Entity type (default USER)"),
+        role: MemberRoleEnum.optional().describe("Role (default MEMBER)")
+      }
+    },
+    async ({ groupId, entityId, entityType, role }) => {
+      try {
+        const member = {
+          entityId,
+          entityType: entityType ?? "USER",
+          role: role ?? "MEMBER"
+        };
+        const data = await ctx.gql.workspace.request(ADD_GROUP_MEMBERS, { groupId, members: [member] });
+        return jsonResult(data.addGroupMembers);
+      } catch (error) {
+        ctx.logger.error("groups_members_add failed", { error: String(error) });
+        return errorResult(
+          `Failed to add group member: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "groups_members_remove")),
+    {
+      title: "Remove Group Members",
+      description: "Remove one or more members from a group by membership ID.",
+      inputSchema: {
+        groupId: z.string().describe("Group ID"),
+        membershipIds: z.array(z.string()).describe("Membership IDs to remove")
+      }
+    },
+    async ({ groupId, membershipIds }) => {
+      try {
+        if (membershipIds.length === 0) {
+          return errorResult("At least one membershipId is required");
+        }
+        const data = await ctx.gql.workspace.request(REMOVE_GROUP_MEMBERS, { groupId, membershipIds });
+        return jsonResult(data.removeGroupMembers);
+      } catch (error) {
+        ctx.logger.error("groups_members_remove failed", { error: String(error) });
+        return errorResult(
+          `Failed to remove group members: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "groups_hierarchy")),
+    {
+      title: "Entity Group Hierarchy",
+      description: "Show all groups an entity (user/group) belongs to.",
+      inputSchema: {
+        entityId: z.string().describe("Entity ID (user/group)"),
+        entityType: z.enum(["USER", "GROUP"]).optional().describe("Entity type (default USER)"),
+        limit: z.number().optional().describe("Page size (default 100)")
+      }
+    },
+    async ({ entityId, entityType, limit }) => {
+      try {
+        const data = await ctx.gql.workspace.request(ENTITY_GROUPS, {
+          entityId,
+          entityType: entityType ?? "USER",
+          first: limit ?? 100
+        });
+        return jsonResult(data.entityGroups.edges.map((e) => e.node));
+      } catch (error) {
+        ctx.logger.error("groups_hierarchy failed", { error: String(error) });
+        return errorResult(
+          `Failed to get group hierarchy: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "groups_activity")),
+    {
+      title: "Group Audit Log",
+      description: "Audit log for a group.",
+      inputSchema: {
+        groupId: z.string().describe("Group ID"),
+        limit: z.number().optional().describe("Page size (default 100)")
+      }
+    },
+    async ({ groupId, limit }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GROUP_AUDIT_LOGS, { groupId, first: limit ?? 100 });
+        return jsonResult(data.groupAuditLogs);
+      } catch (error) {
+        ctx.logger.error("groups_activity failed", { error: String(error) });
+        return errorResult(
+          `Failed to get group activity: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+
+// src/modules/groups/index.ts
+var groupsModule = {
+  id: "groups",
+  version: "0.0.1",
+  displayName: "Groups",
+  dependsOn: ["auth"],
+  capabilities: { tools: {} },
+  register(server, ctx) {
+    const tools = [];
+    const track = (n) => {
+      tools.push(n);
+      return n;
+    };
+    registerGroupsTools(server, ctx, track);
+    return { tools, resources: [], prompts: [] };
+  }
+};
+var groups_default = groupsModule;
+
+export { groups_default as default };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/modules/groups/index.js.map

@@ -0,0 +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"]}

package/dist/modules/health/index.cjs

@@ -0,0 +1,159 @@
+'use strict';
+
+require('graphql-request');
+require('cross-fetch');
+require('@modelcontextprotocol/sdk/server/mcp.js');
+require('@modelcontextprotocol/sdk/types.js');
+
+// src/core/auth/store.ts
+
+// src/core/errors.ts
+var McpUserError = class extends Error {
+  hint;
+  constructor(message, opts) {
+    super(message);
+    this.name = "McpUserError";
+    this.hint = opts?.hint;
+  }
+};
+var McpAuthError = class extends McpUserError {
+  constructor(message, opts) {
+    super(message, {
+      hint: opts?.hint ?? "Run the auth_login tool to authenticate."
+    });
+    this.name = "McpAuthError";
+  }
+};
+var McpInternalError = class extends Error {
+  cause;
+  constructor(message, cause) {
+    super(message);
+    this.name = "McpInternalError";
+    this.cause = cause;
+  }
+};
+
+// src/core/result.ts
+function jsonResult(data, structured) {
+  const result = {
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+  };
+  return result;
+}
+function textResult(text) {
+  return { content: [{ type: "text", text }] };
+}
+function errorResult(message, hint) {
+  const text = hint ? `${message}
+
+Hint: ${hint}` : message;
+  return { content: [{ type: "text", text }], isError: true };
+}
+function registerTool(server, ctx, name, metadata, handler) {
+  const sdkConfig = {
+    title: metadata.title,
+    description: metadata.description,
+    ...metadata.inputSchema ? { inputSchema: metadata.inputSchema } : {}
+  };
+  const wrapped = async (...callbackArgs) => {
+    const hasArgs = callbackArgs.length === 2;
+    const args = hasArgs ? callbackArgs[0] : {};
+    const extra = hasArgs ? callbackArgs[1] : callbackArgs[0];
+    const progressToken = extra?._meta?.progressToken;
+    const meta = progressToken !== void 0 ? { progressToken } : {};
+    try {
+      const result = await handler(args, ctx, meta);
+      if (isToolResult(result)) return result;
+      if (result === void 0) return textResult("OK");
+      return jsonResult(result);
+    } catch (error) {
+      return mapErrorToResult(error, ctx, name);
+    }
+  };
+  server.registerTool(name, sdkConfig, wrapped);
+}
+function isToolResult(value) {
+  return !!value && typeof value === "object" && "content" in value && Array.isArray(value.content);
+}
+function mapErrorToResult(error, ctx, toolName) {
+  if (error instanceof McpAuthError) {
+    ctx.logger.warn(`${toolName}: auth required`, { message: error.message });
+    return errorResult(error.message, error.hint);
+  }
+  if (error instanceof McpUserError) {
+    ctx.logger.info(`${toolName}: user error`, { message: error.message });
+    return errorResult(error.message, error.hint);
+  }
+  if (error instanceof McpInternalError) {
+    ctx.logger.error(`${toolName}: internal error`, {
+      message: error.message,
+      cause: stringifyCause(error.cause)
+    });
+    return errorResult(`Internal error in ${toolName}.`);
+  }
+  const message = error instanceof Error ? error.message : String(error);
+  ctx.logger.error(`${toolName}: unhandled error`, { message });
+  return errorResult(`${toolName}: ${message}`);
+}
+function stringifyCause(cause) {
+  if (cause === void 0 || cause === null) return void 0;
+  if (cause instanceof Error) return cause.message;
+  try {
+    return JSON.stringify(cause);
+  } catch {
+    return String(cause);
+  }
+}
+
+// src/core/tool-name.ts
+var MAX_TOOL_NAME_LENGTH = 63;
+function assertSafeName(name, kind) {
+  if (name.length > MAX_TOOL_NAME_LENGTH) {
+    throw new McpInternalError(
+      `Tool name '${name}' exceeds ${MAX_TOOL_NAME_LENGTH} characters (some MCP clients truncate at 64).`
+    );
+  }
+  return name;
+}
+function mcpToolName(productName, ...parts) {
+  if (!productName) {
+    throw new McpInternalError("mcpToolName: productName is required");
+  }
+  const name = [productName, ...parts].filter(Boolean).join("_");
+  return assertSafeName(name);
+}
+
+// src/modules/health/index.ts
+var healthModule = {
+  id: "health",
+  version: "0.0.1",
+  displayName: "Health",
+  capabilities: { tools: {} },
+  register(server, ctx) {
+    const pingName = mcpToolName(ctx.productName, "health", "ping");
+    registerTool(
+      server,
+      ctx,
+      pingName,
+      {
+        title: "Health ping",
+        description: "Returns OK and basic server identity. Use to verify MCP connectivity."
+      },
+      async () => jsonResult({
+        ok: true,
+        product: ctx.productName,
+        productVersion: ctx.productVersion,
+        server: ctx.serverName,
+        serverVersion: ctx.serverVersion,
+        env: ctx.env,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      })
+    );
+    return { tools: [pingName], resources: [], prompts: [] };
+  }
+};
+var health_default = healthModule;
+
+module.exports = health_default;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/modules/health/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/errors.ts","../../../src/core/result.ts","../../../src/core/tool-name.ts","../../../src/modules/health/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Error classes for MCP SDK.\n *\n * Modules MUST throw these instead of throwing raw Errors. The registerTool\n * wrapper in result.ts catches and maps them to MCP-protocol-compliant\n * `{ isError: true, content: [...] }` responses.\n *\n * Throwing past the wrapper to the protocol surfaces as JSON-RPC -32603 to\n * the client and is a protocol bug.\n */\n\nexport class McpUserError extends Error {\n  public readonly hint: string | undefined;\n\n  constructor(message: string, opts?: { hint?: string }) {\n    super(message);\n    this.name = 'McpUserError';\n    this.hint = opts?.hint;\n  }\n}\n\nexport class McpAuthError extends McpUserError {\n  constructor(message: string, opts?: { hint?: string }) {\n    super(message, {\n      hint: opts?.hint ?? 'Run the auth_login tool to authenticate.',\n    });\n    this.name = 'McpAuthError';\n  }\n}\n\nexport class McpInternalError extends Error {\n  public override readonly cause: unknown;\n\n  constructor(message: string, cause?: unknown) {\n    super(message);\n    this.name = 'McpInternalError';\n    this.cause = cause;\n  }\n}\n","/**\n * MCP tool result helpers + central handler.\n *\n * Modules NEVER call server.registerTool directly — they use registerTool()\n * from this module so the central try/catch wraps the handler and:\n *   - maps thrown McpUserError / McpAuthError / McpInternalError to\n *     MCP-protocol-compliant `{ isError: true, content: [...] }` shapes\n *   - threads `_meta.progressToken` into ctx.progress for long ops\n *   - emits a structured log line on every error\n *   - never leaks `cause` from McpInternalError to the client\n *\n * This is the analog of cli-sdk's createProgram() central error handler.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { ZodRawShape } from 'zod';\nimport type { McpContext } from './context.js';\nimport { McpAuthError, McpInternalError, McpUserError } from './errors.js';\n\nexport interface ToolTextContent {\n  type: 'text';\n  text: string;\n  [k: string]: unknown;\n}\n\nexport interface ToolResult {\n  content: ToolTextContent[];\n  isError?: boolean;\n  structuredContent?: Record<string, unknown>;\n  [k: string]: unknown;\n}\n\nexport interface ToolMeta {\n  progressToken?: string | number;\n}\n\n/**\n * Build a successful tool result with JSON content (pretty-printed).\n */\nexport function jsonResult(data: unknown, structured?: Record<string, unknown>): ToolResult {\n  const result: ToolResult = {\n    content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],\n  };\n  if (structured !== undefined) {\n    result.structuredContent = structured;\n  }\n  return result;\n}\n\n/**\n * Build a successful tool result with plain text content.\n */\nexport function textResult(text: string): ToolResult {\n  return { content: [{ type: 'text', text }] };\n}\n\n/**\n * Build an error tool result. Honors MCP's `{ isError: true, content }` shape.\n * Optional hint is appended on a new line so the LLM can react.\n */\nexport function errorResult(message: string, hint?: string): ToolResult {\n  const text = hint ? `${message}\\n\\nHint: ${hint}` : message;\n  return { content: [{ type: 'text', text }], isError: true };\n}\n\nexport interface ToolMetadata {\n  title: string;\n  description: string;\n  inputSchema?: ZodRawShape;\n}\n\nexport type ToolHandler<TArgs = Record<string, unknown>> = (\n  args: TArgs,\n  ctx: McpContext,\n  meta: ToolMeta,\n) => Promise<unknown>;\n\n/**\n * Register a tool with the central error wrapper.\n *\n * The handler returns a plain value or void. The wrapper:\n *   - wraps non-undefined returns in jsonResult()\n *   - if the value already looks like a ToolResult (has `content`), passes through\n *   - catches McpAuthError / McpUserError / McpInternalError / generic Error\n *   - logs every error via ctx.logger.error\n */\nexport function registerTool<TArgs extends Record<string, unknown>>(\n  server: McpServer,\n  ctx: McpContext,\n  name: string,\n  metadata: ToolMetadata,\n  handler: ToolHandler<TArgs>,\n): void {\n  const sdkConfig = {\n    title: metadata.title,\n    description: metadata.description,\n    ...(metadata.inputSchema ? { inputSchema: metadata.inputSchema } : {}),\n  };\n\n  // The MCP SDK's registerTool signature is `(name, config, handler)`. The\n  // handler arity depends on whether inputSchema is present (1-arg without,\n  // 2-arg with). We accept a unified handler shape and dispatch at runtime.\n  // The SDK's typing is strict and conditional on the inputSchema generic;\n  // bypass with a cast since runtime acceptance is unconditional.\n  const wrapped = async (...callbackArgs: unknown[]): Promise<ToolResult> => {\n    const hasArgs = callbackArgs.length === 2;\n    const args = (hasArgs ? callbackArgs[0] : {}) as TArgs;\n    const extra = (hasArgs ? callbackArgs[1] : callbackArgs[0]) as\n      | { _meta?: { progressToken?: string | number } }\n      | undefined;\n\n    const progressToken = extra?._meta?.progressToken;\n    const meta: ToolMeta = progressToken !== undefined ? { progressToken } : {};\n\n    try {\n      const result = await handler(args, ctx, meta);\n      if (isToolResult(result)) return result;\n      if (result === undefined) return textResult('OK');\n      return jsonResult(result);\n    } catch (error) {\n      return mapErrorToResult(error, ctx, name);\n    }\n  };\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  (server as any).registerTool(name, sdkConfig, wrapped);\n}\n\nfunction isToolResult(value: unknown): value is ToolResult {\n  return (\n    !!value &&\n    typeof value === 'object' &&\n    'content' in value &&\n    Array.isArray((value as ToolResult).content)\n  );\n}\n\nfunction mapErrorToResult(error: unknown, ctx: McpContext, toolName: string): ToolResult {\n  if (error instanceof McpAuthError) {\n    ctx.logger.warn(`${toolName}: auth required`, { message: error.message });\n    return errorResult(error.message, error.hint);\n  }\n  if (error instanceof McpUserError) {\n    ctx.logger.info(`${toolName}: user error`, { message: error.message });\n    return errorResult(error.message, error.hint);\n  }\n  if (error instanceof McpInternalError) {\n    ctx.logger.error(`${toolName}: internal error`, {\n      message: error.message,\n      cause: stringifyCause(error.cause),\n    });\n    return errorResult(`Internal error in ${toolName}.`);\n  }\n  const message = error instanceof Error ? error.message : String(error);\n  ctx.logger.error(`${toolName}: unhandled error`, { message });\n  return errorResult(`${toolName}: ${message}`);\n}\n\nfunction stringifyCause(cause: unknown): string | undefined {\n  if (cause === undefined || cause === null) return undefined;\n  if (cause instanceof Error) return cause.message;\n  try {\n    return JSON.stringify(cause);\n  } catch {\n    return String(cause);\n  }\n}\n","/**\n * Tool / resource / prompt naming helpers.\n *\n * Mandatory product prefix avoids collisions when Claude Desktop runs\n * multiple MCP servers concurrently (typical setup is ~6).\n *\n * Tool names are capped at 63 characters — Claude Desktop pre-1.x\n * truncated at 64 in some versions.\n */\n\nimport { McpInternalError } from './errors.js';\n\nconst MAX_TOOL_NAME_LENGTH = 63;\n\nfunction assertSafeName(name: string, kind: 'tool' | 'resource' | 'prompt'): string {\n  if (kind === 'tool' && name.length > MAX_TOOL_NAME_LENGTH) {\n    throw new McpInternalError(\n      `Tool name '${name}' exceeds ${MAX_TOOL_NAME_LENGTH} characters (some MCP clients truncate at 64).`,\n    );\n  }\n  return name;\n}\n\n/**\n * Build a tool name. Format: `<productName>_<...parts>` (snake_case).\n * Example: mcpToolName('vibecontrols', 'vibes', 'list') -> 'vibecontrols_vibes_list'\n */\nexport function mcpToolName(productName: string, ...parts: string[]): string {\n  if (!productName) {\n    throw new McpInternalError('mcpToolName: productName is required');\n  }\n  const name = [productName, ...parts].filter(Boolean).join('_');\n  return assertSafeName(name, 'tool');\n}\n\n/**\n * Build a resource URI. Format: `<productName>://<...parts>`.\n * Example: mcpResourceUri('vibecontrols', 'schema') -> 'vibecontrols://schema'\n */\nexport function mcpResourceUri(productName: string, ...parts: string[]): string {\n  if (!productName) {\n    throw new McpInternalError('mcpResourceUri: productName is required');\n  }\n  return `${productName}://${parts.filter(Boolean).join('/')}`;\n}\n\n/**\n * Build a prompt name. Format: `<productName>-<...parts>` (kebab-case).\n * Example: mcpPromptName('vibecontrols', 'setup') -> 'vibecontrols-setup'\n */\nexport function mcpPromptName(productName: string, ...parts: string[]): string {\n  if (!productName) {\n    throw new McpInternalError('mcpPromptName: productName is required');\n  }\n  return [productName, ...parts].filter(Boolean).join('-');\n}\n\nexport const TOOL_NAME_LIMIT = MAX_TOOL_NAME_LENGTH;\n","/**\n * Health module — Phase 0 trivial module exercising the contract end-end.\n *\n * Registers <product>_health_ping (returns ok + timestamp + product/server names).\n * No GraphQL calls, no auth — perfect smoke test for shell + transport wiring.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { McpContext, McpModule, ModuleRegistration } from '../../core/index.js';\nimport { jsonResult, mcpToolName, registerTool } from '../../core/index.js';\n\nconst healthModule: McpModule = {\n  id: 'health',\n  version: '0.0.1',\n  displayName: 'Health',\n  capabilities: { tools: {} },\n\n  register(server: McpServer, ctx: McpContext): ModuleRegistration {\n    const pingName = mcpToolName(ctx.productName, 'health', 'ping');\n\n    registerTool(\n      server,\n      ctx,\n      pingName,\n      {\n        title: 'Health ping',\n        description: 'Returns OK and basic server identity. Use to verify MCP connectivity.',\n      },\n      async () =>\n        jsonResult({\n          ok: true,\n          product: ctx.productName,\n          productVersion: ctx.productVersion,\n          server: ctx.serverName,\n          serverVersion: ctx.serverVersion,\n          env: ctx.env,\n          timestamp: new Date().toISOString(),\n        }),\n    );\n\n    return { tools: [pingName], resources: [], prompts: [] };\n  },\n};\n\nexport default healthModule;\n"]}