@withpica/mcp-server 2.72.0 → 2.74.0

package/dist/tools/team.d.ts

@@ -1,22 +0,0 @@
-/**
- * Team Tools — manage team members via MCP
- *
- * Backed by REST routes: /api/admin/team/*
- * Supports listing, viewing, inviting, updating roles, and removing team members.
- */
-import { PicaClient } from "@withpica/mcp-sdk";
-import { ToolDefinition, ToolExecutor } from "./index.js";
-export declare class TeamTools {
-    private pica;
-    constructor(pica: PicaClient);
-    getTools(): Array<{
-        definition: ToolDefinition;
-        executor: ToolExecutor;
-    }>;
-    private listMembers;
-    private getMember;
-    private inviteMember;
-    private updateRole;
-    private removeMember;
-}
-//# sourceMappingURL=team.d.ts.map

package/dist/tools/team.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"team.d.ts","sourceRoot":"","sources":["../../src/tools/team.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YAgJ3D,WAAW;YAQX,SAAS;YAKT,YAAY;YAYZ,UAAU;YAUV,YAAY;CAI3B"}

package/dist/tools/team.js

@@ -1,169 +0,0 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
-import { formatSuccess, formatStructuredList } from "@withpica/mcp-utils";
-export class TeamTools {
-    pica;
-    constructor(pica) {
-        this.pica = pica;
-    }
-    getTools() {
-        return [
-            {
-                definition: {
-                    name: "pica_team_list",
-                    scope: "admin",
-                    audiences: ["stdio", "http", "public"],
-                    tier: "read",
-                    description: "List all team members with their roles, status (pending/active), and permissions. Use to answer 'who is on my team?'",
-                    workflows: "infrastructure",
-                    vernacular_kind: "specialist",
-                    vernacular_reason: "Specialist context; not yet covered by the Creator Question Atlas — pending telemetry-driven addition per ADR-226 Phase 4 substrate writes.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {},
-                    },
-                },
-                executor: this.listMembers.bind(this),
-            },
-            {
-                definition: {
-                    name: "pica_team_get",
-                    scope: "admin",
-                    audiences: ["stdio", "http", "public"],
-                    tier: "read",
-                    description: "Get details of a specific team member by membership ID, including permissions, status, and activity.",
-                    workflows: "infrastructure",
-                    vernacular_kind: "specialist",
-                    vernacular_reason: "Specialist context; not yet covered by the Creator Question Atlas — pending telemetry-driven addition per ADR-226 Phase 4 substrate writes.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            id: {
-                                type: "string",
-                                description: "Team membership ID",
-                            },
-                        },
-                        required: ["id"],
-                    },
-                },
-                executor: this.getMember.bind(this),
-            },
-            {
-                definition: {
-                    name: "pica_team_invite",
-                    scope: "admin",
-                    audiences: ["stdio", "http", "public"],
-                    tier: "write",
-                    description: "Invite someone to join your team by email. Sends an invitation email — a signup invite if they don't have a PICA account yet, or a team-invite notification if they do. Optionally set their name and permissions.",
-                    workflows: "infrastructure",
-                    vernacular_kind: "specialist",
-                    vernacular_reason: "Specialist context; not yet covered by the Creator Question Atlas — pending telemetry-driven addition per ADR-226 Phase 4 substrate writes.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            email: {
-                                type: "string",
-                                description: "Email address of the person to invite",
-                            },
-                            full_name: {
-                                type: "string",
-                                description: "Full name of the invitee (optional)",
-                            },
-                            permissions: {
-                                type: "object",
-                                description: "Permission flags for the team member (e.g. { can_edit_works: true, can_manage_team: false })",
-                            },
-                        },
-                        required: ["email"],
-                    },
-                },
-                executor: this.inviteMember.bind(this),
-            },
-            {
-                definition: {
-                    name: "pica_team_update_role",
-                    scope: "admin",
-                    audiences: ["stdio", "http", "public"],
-                    tier: "write",
-                    description: "Update a team member's role and/or permissions. Pass the membership ID and at least one of role or permissions.",
-                    workflows: "infrastructure",
-                    vernacular_kind: "specialist",
-                    vernacular_reason: "Specialist context; not yet covered by the Creator Question Atlas — pending telemetry-driven addition per ADR-226 Phase 4 substrate writes.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            id: {
-                                type: "string",
-                                description: "Team membership ID (required).",
-                            },
-                            role: {
-                                type: "string",
-                                description: "Updated role name on team_memberships.role (e.g. 'admin', 'editor', 'viewer'). Optional — omit to leave unchanged.",
-                            },
-                            permissions: {
-                                type: "object",
-                                additionalProperties: true,
-                                description: "Updated permission flags (e.g. { can_edit_works: true, can_manage_team: false }). Optional — omit to leave unchanged.",
-                            },
-                        },
-                        required: ["id"],
-                    },
-                },
-                executor: this.updateRole.bind(this),
-            },
-            {
-                definition: {
-                    name: "pica_team_remove",
-                    scope: "admin",
-                    audiences: ["stdio", "http", "public"],
-                    tier: "destructive",
-                    description: "Remove a team member by membership ID. This revokes their access.",
-                    workflows: "infrastructure",
-                    vernacular_kind: "specialist",
-                    vernacular_reason: "Destructive operation; invoked by exact name after explicit user confirmation in a specialist flow.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            id: {
-                                type: "string",
-                                description: "Team membership ID to remove",
-                            },
-                        },
-                        required: ["id"],
-                    },
-                },
-                executor: this.removeMember.bind(this),
-            },
-        ];
-    }
-    async listMembers(_args) {
-        const result = await this.pica.team.list();
-        const members = Array.isArray(result)
-            ? result
-            : (result?.data ?? result?.members ?? []);
-        return formatStructuredList(members, "team member");
-    }
-    async getMember(args) {
-        const member = await this.pica.team.get(args.id);
-        return formatSuccess("Team member retrieved", member?.data ?? member);
-    }
-    async inviteMember(args) {
-        const payload = { email: args.email };
-        if (args.full_name)
-            payload.full_name = args.full_name;
-        if (args.permissions)
-            payload.permissions = args.permissions;
-        const result = await this.pica.team.invite(payload);
-        return formatSuccess(`Invitation sent to ${args.email}`, result?.data ?? result);
-    }
-    async updateRole(args) {
-        const result = await this.pica.team.update(args.id, {
-            permissions: args.permissions,
-        });
-        return formatSuccess(`Permissions updated for membership ${args.id}`, result?.data ?? result);
-    }
-    async removeMember(args) {
-        await this.pica.team.remove(args.id);
-        return formatSuccess(`Team member ${args.id} removed`);
-    }
-}
-//# sourceMappingURL=team.js.map

package/dist/tools/team.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"team.js","sourceRoot":"","sources":["../../src/tools/team.ts"],"names":[],"mappings":"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"}