@withpica/mcp-server 2.7.0 → 2.8.0

package/dist/tools/auth.js.map

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

package/dist/tools/bulk.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Bulk Operations Tools - MCP tools for batch updates
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class BulkTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private bulkUpdateWorks;
+    private bulkUpdatePeopleRoles;
+}
+//# sourceMappingURL=bulk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bulk.d.ts","sourceRoot":"","sources":["../../src/tools/bulk.ts"],"names":[],"mappings":"AAEA;;GAEG;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;YA0D3D,eAAe;YAkBf,qBAAqB;CAmBpC"}

package/dist/tools/bulk.js

@@ -0,0 +1,85 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatSuccess, formatValidationError } from "@withpica/mcp-utils";
+export class BulkTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_works_bulk_update",
+                    description: "Batch update multiple works at once (status, type, or other fields)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_ids: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "Array of work IDs to update",
+                            },
+                            updates: {
+                                type: "object",
+                                description: "Fields to update on all works (e.g. { status: 'verified', work_type: 'composition' })",
+                            },
+                        },
+                        required: ["work_ids", "updates"],
+                    },
+                },
+                executor: this.bulkUpdateWorks.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_people_bulk_update_roles",
+                    description: "Batch update roles for multiple people at once",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            person_ids: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "Array of person IDs to update",
+                            },
+                            action: {
+                                type: "string",
+                                enum: ["add", "remove"],
+                                description: "Whether to add or remove the specified roles",
+                            },
+                            roles: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "Roles to add/remove (e.g. ['writer', 'composer', 'performer'])",
+                            },
+                        },
+                        required: ["person_ids", "action", "roles"],
+                    },
+                },
+                executor: this.bulkUpdatePeopleRoles.bind(this),
+            },
+        ];
+    }
+    async bulkUpdateWorks(args) {
+        if (!args.work_ids?.length) {
+            return formatValidationError({ work_ids: "must be a non-empty array" });
+        }
+        if (!args.updates || Object.keys(args.updates).length === 0) {
+            return formatValidationError({
+                updates: "must contain at least one field",
+            });
+        }
+        const result = await this.pica.bulk.updateWorks(args.work_ids, args.updates);
+        return formatSuccess(`Bulk updated ${args.work_ids.length} works`, result);
+    }
+    async bulkUpdatePeopleRoles(args) {
+        if (!args.person_ids?.length) {
+            return formatValidationError({ person_ids: "must be a non-empty array" });
+        }
+        if (!args.roles?.length) {
+            return formatValidationError({ roles: "must be a non-empty array" });
+        }
+        const result = await this.pica.bulk.updatePeopleRoles(args.person_ids, args.roles, args.action || "add");
+        return formatSuccess(`Bulk updated roles for ${args.person_ids.length} people`, result);
+    }
+}
+//# sourceMappingURL=bulk.js.map

package/dist/tools/bulk.js.map

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

package/dist/tools/calendar.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Calendar Tools — view upcoming events, deadlines, and scheduled sessions
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class CalendarTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private getEvents;
+}
+//# sourceMappingURL=calendar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/tools/calendar.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,qBAAa,aAAa;IACxB,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;YA4C3D,SAAS;CAqBxB"}

package/dist/tools/calendar.js

@@ -0,0 +1,67 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatStructuredList } from "@withpica/mcp-utils";
+export class CalendarTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_calendar_events",
+                    description: "Get upcoming calendar events — sessions, agreement deadlines, release dates, " +
+                        "invoice due dates, and Google Calendar events. Defaults to the next 30 days.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            start_date: {
+                                type: "string",
+                                description: "Start date (YYYY-MM-DD). Defaults to today.",
+                            },
+                            end_date: {
+                                type: "string",
+                                description: "End date (YYYY-MM-DD). Defaults to 30 days from start.",
+                            },
+                            types: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "Filter by event type: session, invoice_due, invoice_sent, " +
+                                    "payment_received, agreement_expiry, agreement_signing, " +
+                                    "work_release, google_calendar",
+                            },
+                            work_id: {
+                                type: "string",
+                                description: "Filter events linked to a specific work",
+                            },
+                            search: {
+                                type: "string",
+                                description: "Search events by title",
+                            },
+                        },
+                    },
+                },
+                executor: this.getEvents.bind(this),
+            },
+        ];
+    }
+    async getEvents(args) {
+        const today = new Date().toISOString().split("T")[0];
+        const thirtyDays = new Date(Date.now() + 30 * 86400000)
+            .toISOString()
+            .split("T")[0];
+        const result = await this.pica.calendar.getEvents({
+            startDate: args.start_date || today,
+            endDate: args.end_date || thirtyDays,
+            types: args.types,
+            workId: args.work_id,
+            search: args.search,
+        });
+        const events = Array.isArray(result) ? result : result?.events || [];
+        return formatStructuredList(events, "event", {
+            startDate: args.start_date || today,
+            endDate: args.end_date || thirtyDays,
+        });
+    }
+}
+//# sourceMappingURL=calendar.js.map

package/dist/tools/calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../src/tools/calendar.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAQ7D,OAAO,EAAiB,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE1E,MAAM,OAAO,aAAa;IAChB,IAAI,CAAa;IAEzB,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,QAAQ;QACN,OAAO;YACL;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,sBAAsB;oBAC5B,WAAW,EACT,+EAA+E;wBAC/E,8EAA8E;oBAChF,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,UAAU,EAAE;gCACV,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,6CAA6C;6BAC3D;4BACD,QAAQ,EAAE;gCACR,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,wDAAwD;6BAC3D;4BACD,KAAK,EAAE;gCACL,IAAI,EAAE,OAAO;gCACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gCACzB,WAAW,EACT,4DAA4D;oCAC5D,yDAAyD;oCACzD,+BAA+B;6BAClC;4BACD,OAAO,EAAE;gCACP,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,yCAAyC;6BACvD;4BACD,MAAM,EAAE;gCACN,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,wBAAwB;6BACtC;yBACF;qBACF;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;aACpC;SACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,IAAyB;QAC/C,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC;aACpD,WAAW,EAAE;aACb,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAEjB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YAChD,SAAS,EAAE,IAAI,CAAC,UAAU,IAAI,KAAK;YACnC,OAAO,EAAE,IAAI,CAAC,QAAQ,IAAI,UAAU;YACpC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC;QAErE,OAAO,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE;YAC3C,SAAS,EAAE,IAAI,CAAC,UAAU,IAAI,KAAK;YACnC,OAAO,EAAE,IAAI,CAAC,QAAQ,IAAI,UAAU;SACrC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/tools/collaborators.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Collaborator Tools - MCP tools for inviting and managing collaborators
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class CollaboratorsTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private inviteCollaborator;
+    private listInvites;
+    private resendInvite;
+    private listIncoming;
+    private acceptInvite;
+    private disputeInvite;
+    private inviteBulk;
+}
+//# sourceMappingURL=collaborators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collaborators.d.ts","sourceRoot":"","sources":["../../src/tools/collaborators.ts"],"names":[],"mappings":"AAeA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,qBAAa,kBAAkB;IAC7B,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;YAiN3D,kBAAkB;YAgClB,WAAW;YAmCX,YAAY;YAQZ,YAAY;YAoBZ,YAAY;YAiBZ,aAAa;YAWb,UAAU;CAmBzB"}

package/dist/tools/collaborators.js

@@ -0,0 +1,311 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatSuccess, formatList } from "@withpica/mcp-utils";
+export class CollaboratorsTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_collaborators_invite",
+                    description: "Invite a collaborator to a work by email. Creates the person if they don't exist, sends an invite email, and sets up their credit on the work. Requires the work ID, person details (name + email), the inviter's person ID, and credit details.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to invite the collaborator to",
+                            },
+                            name: {
+                                type: "string",
+                                description: "Full name of the collaborator",
+                            },
+                            email: {
+                                type: "string",
+                                description: "Email address of the collaborator",
+                            },
+                            role: {
+                                type: "string",
+                                description: "Role on the work (e.g. 'producer', 'songwriter', 'drummer', 'vocalist')",
+                            },
+                            invited_by: {
+                                type: "string",
+                                description: "Person ID of the person sending the invite (the catalog owner). Use pica_people_query to find this ID.",
+                            },
+                            credit_type: {
+                                type: "string",
+                                description: "Type of credit (e.g. 'production', 'songwriting', 'drums', 'vocals', 'mixing')",
+                            },
+                            percentage_split: {
+                                type: "number",
+                                description: "Percentage split for this credit (0-100)",
+                            },
+                        },
+                        required: ["work_id", "name", "email", "invited_by", "credit_type"],
+                    },
+                },
+                executor: this.inviteCollaborator.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_collaborators_invites_list",
+                    description: "Sender-side: list collaboration invites this organisation has sent. Filter by status (pending / verified / confirmed / expired / cancelled / disputed) or by work. For the recipient-side equivalent see pica_collaborators_incoming_list.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            status: {
+                                type: "string",
+                                description: "Filter by status (default: 'pending')",
+                                enum: [
+                                    "pending",
+                                    "verified",
+                                    "confirmed",
+                                    "expired",
+                                    "cancelled",
+                                    "disputed",
+                                ],
+                            },
+                            work_id: {
+                                type: "string",
+                                description: "Filter invites for a specific work",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Maximum results to return (default: 50, max: 100)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listInvites.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_collaborators_incoming_list",
+                    description: "ADR-157 warm path. List collaboration invites addressed to YOUR email across every inviting org. Returns pending invites by default — pass status to see disputed/confirmed history. Each row includes work_title, inviter_org_name, credit_type, and percentage_split so you can decide whether to accept.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            status: {
+                                type: "string",
+                                description: "Filter by status (default: 'pending')",
+                                enum: [
+                                    "pending",
+                                    "verified",
+                                    "confirmed",
+                                    "expired",
+                                    "cancelled",
+                                    "disputed",
+                                ],
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Maximum results to return (default: 50, max: 100)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listIncoming.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_collaborators_accept",
+                    description: "ADR-157 warm path. Accept a collaboration invite addressed to your email. Writes a real work_credits row on the inviter's work and notifies them. Fails if the invite is not addressed to your authenticated email. Use pica_collaborators_incoming_list to find the invite_id first.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            invite_id: {
+                                type: "string",
+                                description: "The invite id to accept",
+                            },
+                        },
+                        required: ["invite_id"],
+                    },
+                },
+                executor: this.acceptInvite.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_collaborators_dispute",
+                    description: 'ADR-157 warm path. Dispute a collaboration invite addressed to your email ("that\'s not me" or "I wasn\'t on this work"). Flips the invite to disputed and notifies the inviter. Does NOT create any credits.',
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            invite_id: {
+                                type: "string",
+                                description: "The invite id to dispute",
+                            },
+                            reason: {
+                                type: "string",
+                                description: "Optional freeform reason for the dispute",
+                            },
+                        },
+                        required: ["invite_id"],
+                    },
+                },
+                executor: this.disputeInvite.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_collaborators_invite_bulk",
+                    description: "ADR-157 warm path. Send multiple collaboration invites in one call. Thin wrapper over pica_collaborators_invite — same per-row schema, returns per-row { ok, email, invite?, error? } so partial failures are visible.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            invites: {
+                                type: "array",
+                                description: "Array of invites to send",
+                                items: {
+                                    type: "object",
+                                    properties: {
+                                        work_id: { type: "string" },
+                                        name: { type: "string" },
+                                        email: { type: "string" },
+                                        role: { type: "string" },
+                                        invited_by: { type: "string" },
+                                        credit_type: { type: "string" },
+                                        percentage_split: { type: "number" },
+                                    },
+                                    required: [
+                                        "work_id",
+                                        "name",
+                                        "email",
+                                        "invited_by",
+                                        "credit_type",
+                                    ],
+                                },
+                            },
+                        },
+                        required: ["invites"],
+                    },
+                },
+                executor: this.inviteBulk.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_collaborators_invite_resend",
+                    description: "Resend a pending collaboration invite. Regenerates the invite token and sends a new email.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            invite_id: {
+                                type: "string",
+                                description: "The invite ID to resend",
+                            },
+                        },
+                        required: ["invite_id"],
+                    },
+                },
+                executor: this.resendInvite.bind(this),
+            },
+        ];
+    }
+    async inviteCollaborator(args) {
+        const result = await this.pica.collaborators.invite({
+            workId: args.work_id,
+            personData: {
+                name: args.name,
+                email: args.email,
+                role: args.role,
+            },
+            invitedBy: args.invited_by,
+            creditData: {
+                credit_type: args.credit_type,
+                percentage_split: args.percentage_split,
+            },
+        });
+        const hints = [
+            {
+                gap: "collaborator_missing_identifiers",
+                suggestion: `Enrich ${args.name} with ISNI or IPI for royalty collection (pica_people_enrich_isni)`,
+                severity: "important",
+            },
+        ];
+        return formatSuccess(`Invite sent to ${args.name} (${args.email}) for credit "${args.credit_type}" on work ${args.work_id}.`, result, hints);
+    }
+    async listInvites(args) {
+        // ADR-157 sub-step 4b (superseded form): the original plan surfaced
+        // an "events since last review" watermark hint, but sub-step 4a
+        // already delivers confirmed/disputed receipts instantly via
+        // Telegram — making the duplicated completion-hint surface
+        // redundant. ADR-160 reinforces the receipts-layer principle. All
+        // that remains is nudging unpaired orgs towards Telegram, via a
+        // single parallel call to the existing telegram status endpoint.
+        // Status-check failure degrades to "no nudge" so the primary read
+        // path stays resilient.
+        const [invites, telegramStatus] = await Promise.all([
+            this.pica.collaborators.listInvites({
+                status: args.status,
+                workId: args.work_id,
+                limit: args.limit,
+            }),
+            this.pica.telegram.getStatus().catch(() => null),
+        ]);
+        const hints = [];
+        if (telegramStatus && telegramStatus.connected === false) {
+            hints.push({
+                gap: "telegram_not_connected",
+                suggestion: "Want collaborator accept/dispute receipts delivered instantly? Pair Telegram with pica_telegram_connect — the message body is the receipt, no dashboard trip.",
+                severity: "nice_to_have",
+            });
+        }
+        return formatList(invites, {
+            status: args.status || "pending",
+            completion_hints: hints,
+        });
+    }
+    async resendInvite(args) {
+        const result = await this.pica.collaborators.resendInvite(args.invite_id);
+        return formatSuccess(`Invite ${args.invite_id} resent successfully.`, result);
+    }
+    async listIncoming(args) {
+        const invites = await this.pica.collaborators.listIncoming({
+            status: args.status,
+            limit: args.limit,
+        });
+        const hints = [];
+        if (invites.length > 0) {
+            hints.push({
+                gap: "pending_incoming_invites",
+                suggestion: `You have ${invites.length} pending invite${invites.length === 1 ? "" : "s"}. Accept with pica_collaborators_accept or reject with pica_collaborators_dispute.`,
+                severity: "important",
+            });
+        }
+        return formatList(invites, {
+            status: args.status || "pending",
+            count: invites.length,
+            completion_hints: hints,
+        });
+    }
+    async acceptInvite(args) {
+        const result = await this.pica.collaborators.accept(args.invite_id);
+        const hints = [
+            {
+                gap: "credit_attested",
+                suggestion: "Your credit is now live on the inviter's work. Use pica_works_query to see works you're credited on.",
+                severity: "nice_to_have",
+            },
+        ];
+        return formatSuccess(`Invite ${args.invite_id} accepted. Credit written.`, result, hints);
+    }
+    async disputeInvite(args) {
+        const result = await this.pica.collaborators.dispute(args.invite_id, args.reason);
+        return formatSuccess(`Invite ${args.invite_id} disputed. The inviter has been notified.`, result);
+    }
+    async inviteBulk(args) {
+        const results = await this.pica.collaborators.inviteBulk(args.invites.map((i) => ({
+            workId: i.work_id,
+            personData: { name: i.name, email: i.email, role: i.role },
+            invitedBy: i.invited_by,
+            creditData: {
+                credit_type: i.credit_type,
+                percentage_split: i.percentage_split,
+            },
+        })));
+        const okCount = results.filter((r) => r.ok).length;
+        const failCount = results.length - okCount;
+        return formatSuccess(`Bulk invite complete: ${okCount} sent, ${failCount} failed.`, { results, ok: okCount, failed: failCount });
+    }
+}
+//# sourceMappingURL=collaborators.js.map

package/dist/tools/collaborators.js.map

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

package/dist/tools/comparisons.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Comparison Tools - MCP tools for comparing enrichment sources vs catalog data
+ * and registration status across PROs.
+ *
+ * ADR-116 Phase 2: Comparative views
+ *
+ * These tools return structured comparisons that agents can reason over directly,
+ * eliminating the need for 4-6 separate tool calls to assemble context manually.
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class ComparisonTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private enrichmentCompare;
+    private registrationsCompare;
+}
+//# sourceMappingURL=comparisons.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"comparisons.d.ts","sourceRoot":"","sources":["../../src/tools/comparisons.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,qBAAa,eAAe;IAC1B,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;YAoD3D,iBAAiB;YAqBjB,oBAAoB;CAkBnC"}