@withpica/mcp-server 2.1.0

package/dist/tools/send.js

@@ -0,0 +1,189 @@
+/**
+ * Send Tools - MCP tools for sending messages, invites, and file requests through PICA's Send Hub
+ */
+import { formatSuccess, formatList, } from "../utils/formatting.js";
+export class SendTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_send_message",
+                    description: "Send a message through PICA's Send Hub. Supports portal invites, team invites, " +
+                        "project invites, file requests, and audio shares. Each send_type requires different fields.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            send_type: {
+                                type: "string",
+                                description: "Type of message to send",
+                                enum: [
+                                    "portal_invite",
+                                    "team_invite",
+                                    "project_invite",
+                                    "file_request",
+                                    "audio_share",
+                                ],
+                            },
+                            // Portal invite fields
+                            person_id: {
+                                type: "string",
+                                description: "Person ID to send to (required for portal_invite, optional for file_request/audio_share)",
+                            },
+                            email: {
+                                type: "string",
+                                description: "Email address (required for portal_invite, team_invite)",
+                            },
+                            message: {
+                                type: "string",
+                                description: "Optional personal message to include",
+                            },
+                            // Team invite fields
+                            name: {
+                                type: "string",
+                                description: "Recipient name (for team_invite)",
+                            },
+                            permissions: {
+                                type: "string",
+                                description: "Permission level for team_invite (e.g. 'admin', 'editor', 'viewer')",
+                            },
+                            // Project invite fields
+                            project_id: {
+                                type: "string",
+                                description: "Project ID (required for project_invite)",
+                            },
+                            participant_ids: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "List of person IDs to invite to the project",
+                            },
+                            // File request fields
+                            title: {
+                                type: "string",
+                                description: "Title for file_request",
+                            },
+                            recipient_email: {
+                                type: "string",
+                                description: "Recipient email for file_request/audio_share",
+                            },
+                            recipient_name: {
+                                type: "string",
+                                description: "Recipient name for file_request/audio_share",
+                            },
+                            // Audio share fields
+                            work_id: {
+                                type: "string",
+                                description: "Work ID (required for audio_share)",
+                            },
+                            allow_download: {
+                                type: "boolean",
+                                description: "Allow downloading shared audio files",
+                            },
+                        },
+                        required: ["send_type"],
+                    },
+                },
+                executor: this.sendMessage.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_send_list",
+                    description: "List items from the Send Hub with optional filters. Returns sent messages, " +
+                        "invites, file requests, and audio shares.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            type: {
+                                type: "string",
+                                description: "Filter by type (comma-separated for multiple)",
+                                enum: [
+                                    "portal_invite",
+                                    "team_invite",
+                                    "project_invite",
+                                    "file_request",
+                                    "audio_share",
+                                ],
+                            },
+                            status: {
+                                type: "string",
+                                description: "Filter by status (e.g. 'pending', 'sent', 'accepted', 'expired')",
+                            },
+                            person_id: {
+                                type: "string",
+                                description: "Filter by recipient person ID",
+                            },
+                            work_id: {
+                                type: "string",
+                                description: "Filter by related work ID",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Max results (default: 50)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listSent.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_send_pending",
+                    description: "List pending Send Hub items awaiting response (invites not yet accepted, " +
+                        "file requests not yet fulfilled, etc.).",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.listPending.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_send_resend",
+                    description: "Resend a Send Hub item (re-send an invite, file request, or audio share).",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Send Hub item ID to resend",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.resendItem.bind(this),
+            },
+        ];
+    }
+    async sendMessage(args) {
+        const result = await this.pica.send.send(args);
+        return formatSuccess(`${args.send_type} sent successfully.`, result);
+    }
+    async listSent(args) {
+        const result = await this.pica.send.list({
+            type: args.type,
+            status: args.status,
+            personId: args.person_id,
+            workId: args.work_id,
+            limit: args.limit,
+        });
+        return formatList(result.items, {
+            total: result.total,
+            type: args.type,
+            status: args.status,
+        });
+    }
+    async listPending(_args) {
+        const items = await this.pica.send.listPending();
+        return formatList(items, { status: "pending" });
+    }
+    async resendItem(args) {
+        const result = await this.pica.send.resend(args.id);
+        return formatSuccess(`Item ${args.id} resent.`, result);
+    }
+}
+//# sourceMappingURL=send.js.map

package/dist/tools/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../../src/tools/send.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EACL,aAAa,EAEb,UAAU,GACX,MAAM,wBAAwB,CAAC;AAEhC,MAAM,OAAO,SAAS;IACZ,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,mBAAmB;oBACzB,WAAW,EACT,iFAAiF;wBACjF,6FAA6F;oBAC/F,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,SAAS,EAAE;gCACT,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,yBAAyB;gCACtC,IAAI,EAAE;oCACJ,eAAe;oCACf,aAAa;oCACb,gBAAgB;oCAChB,cAAc;oCACd,aAAa;iCACd;6BACF;4BACD,uBAAuB;4BACvB,SAAS,EAAE;gCACT,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,0FAA0F;6BAC7F;4BACD,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,yDAAyD;6BAC5D;4BACD,OAAO,EAAE;gCACP,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,sCAAsC;6BACpD;4BACD,qBAAqB;4BACrB,IAAI,EAAE;gCACJ,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,kCAAkC;6BAChD;4BACD,WAAW,EAAE;gCACX,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,qEAAqE;6BACxE;4BACD,wBAAwB;4BACxB,UAAU,EAAE;gCACV,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,0CAA0C;6BACxD;4BACD,eAAe,EAAE;gCACf,IAAI,EAAE,OAAO;gCACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gCACzB,WAAW,EAAE,6CAA6C;6BAC3D;4BACD,sBAAsB;4BACtB,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,wBAAwB;6BACtC;4BACD,eAAe,EAAE;gCACf,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,8CAA8C;6BAC5D;4BACD,cAAc,EAAE;gCACd,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,6CAA6C;6BAC3D;4BACD,qBAAqB;4BACrB,OAAO,EAAE;gCACP,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,oCAAoC;6BAClD;4BACD,cAAc,EAAE;gCACd,IAAI,EAAE,SAAS;gCACf,WAAW,EAAE,sCAAsC;6BACpD;yBACF;wBACD,QAAQ,EAAE,CAAC,WAAW,CAAC;qBACxB;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;aACtC;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,gBAAgB;oBACtB,WAAW,EACT,6EAA6E;wBAC7E,2CAA2C;oBAC7C,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,IAAI,EAAE;gCACJ,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,+CAA+C;gCAC5D,IAAI,EAAE;oCACJ,eAAe;oCACf,aAAa;oCACb,gBAAgB;oCAChB,cAAc;oCACd,aAAa;iCACd;6BACF;4BACD,MAAM,EAAE;gCACN,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,kEAAkE;6BACrE;4BACD,SAAS,EAAE;gCACT,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,+BAA+B;6BAC7C;4BACD,OAAO,EAAE;gCACP,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,2BAA2B;6BACzC;4BACD,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,2BAA2B;6BACzC;yBACF;qBACF;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;aACnC;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,mBAAmB;oBACzB,WAAW,EACT,2EAA2E;wBAC3E,yCAAyC;oBAC3C,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE,EAAE;qBACf;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;aACtC;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,kBAAkB;oBACxB,WAAW,EACT,2EAA2E;oBAC7E,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,EAAE,EAAE;gCACF,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,4BAA4B;6BAC1C;yBACF;wBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;qBACjB;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;aACrC;SACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,IAAyB;QACjD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,OAAO,aAAa,CAAC,GAAG,IAAI,CAAC,SAAS,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACvE,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,IAAyB;QAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YACvC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,OAAO,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE;YAC9B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,KAA0B;QAClD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjD,OAAO,UAAU,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAClD,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,IAAyB;QAChD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpD,OAAO,aAAa,CAAC,QAAQ,IAAI,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/tools/sessions.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Work Sessions Tools - MCP tools for tracking studio sessions
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class SessionsTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listSessions;
+    private getSession;
+    private createSession;
+    private getSessionTypes;
+}
+//# sourceMappingURL=sessions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/tools/sessions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAOtE,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;YAsF3D,YAAY;YAQZ,UAAU;YAKV,aAAa;YAKb,eAAe;CAM9B"}

package/dist/tools/sessions.js

@@ -0,0 +1,107 @@
+/**
+ * Work Sessions Tools - MCP tools for tracking studio sessions
+ */
+import { formatAsText, formatSuccess, formatStructuredList, } from "../utils/formatting.js";
+export class SessionsTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_sessions_list",
+                    description: "List studio sessions — recording, mixing, mastering, writing sessions. Shows who was there, what was recorded, and when.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            limit: {
+                                type: "number",
+                                description: "Max results (default 50)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listSessions.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_sessions_get",
+                    description: "Get details of a specific studio session — participants, works recorded, audio files, documents.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Session ID" },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.getSession.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_sessions_create",
+                    description: "Log a new studio session — who was there, what was worked on, where it happened. Session types: recording, mixing, mastering, writing, production, rehearsal.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            title: {
+                                type: "string",
+                                description: "Session title (e.g. 'Vocal recording — Track 3')",
+                            },
+                            session_type: {
+                                type: "string",
+                                description: "Type: recording, mixing, mastering, writing, production, rehearsal",
+                            },
+                            date: {
+                                type: "string",
+                                description: "Session date (YYYY-MM-DD)",
+                            },
+                            location: {
+                                type: "string",
+                                description: "Studio or location name",
+                            },
+                            notes: {
+                                type: "string",
+                                description: "Session notes — what happened, what was achieved",
+                            },
+                            work_id: {
+                                type: "string",
+                                description: "Work this session was for (optional)",
+                            },
+                        },
+                        required: ["title"],
+                        additionalProperties: true,
+                    },
+                },
+                executor: this.createSession.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_sessions_types",
+                    description: "Get available session types (recording, mixing, mastering, etc.)",
+                    inputSchema: { type: "object", properties: {} },
+                },
+                executor: this.getSessionTypes.bind(this),
+            },
+        ];
+    }
+    async listSessions(args) {
+        const sessions = await this.pica.sessions.list({ limit: args.limit });
+        return formatStructuredList(Array.isArray(sessions) ? sessions : sessions?.data || [], "session");
+    }
+    async getSession(args) {
+        const session = await this.pica.sessions.get(args.id);
+        return formatSuccess(`Session: ${session?.title || args.id}`, session);
+    }
+    async createSession(args) {
+        const session = await this.pica.sessions.create(args);
+        return formatSuccess("Studio session logged successfully", session);
+    }
+    async getSessionTypes(_args) {
+        const types = await this.pica.sessions.getTypes();
+        return formatAsText(types);
+    }
+}
+//# sourceMappingURL=sessions.js.map

package/dist/tools/sessions.js.map

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

package/dist/tools/settings.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Settings & Usage Tools — credit history, storage, organisation profile
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class SettingsTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private creditsHistory;
+    private storageStatus;
+    private orgProfile;
+    private userProfile;
+}
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/tools/settings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAOtE,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;YAqE3D,cAAc;YAYd,aAAa;YAWb,UAAU;YASV,WAAW;CAQ1B"}

package/dist/tools/settings.js

@@ -0,0 +1,98 @@
+/**
+ * Settings & Usage Tools — credit history, storage, organisation profile
+ */
+import { formatSuccess, formatStructuredList, } from "../utils/formatting.js";
+export class SettingsTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_credits_history",
+                    description: "View credit transaction history — what you've spent credits on, " +
+                        "grants received, bonuses, and refunds. " +
+                        'Answers "what did I spend my credits on?"',
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            type: {
+                                type: "string",
+                                description: "Filter by type: spend, grant, bonus, refund, starter, collaboration, contribution, adjustment",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Max results (default 20)",
+                            },
+                        },
+                    },
+                },
+                executor: this.creditsHistory.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_storage_status",
+                    description: "Check storage configuration and usage — which cloud provider is active " +
+                        "(PICA default, your own S3, GCS, Azure, R2, or Backblaze), " +
+                        "bucket names, and how much storage you've used.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.storageStatus.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_organisation_profile",
+                    description: "Get your organisation profile — display name, tagline, IPI number, " +
+                        "default currency, social links, and carbon tracking status.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.orgProfile.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_user_profile",
+                    description: "Get your user profile — name, email, role, creative types, " +
+                        "AI disclosure defaults, and onboarding status.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.userProfile.bind(this),
+            },
+        ];
+    }
+    async creditsHistory(args) {
+        const result = await this.pica.settings.creditsHistory({
+            type: args.type,
+            limit: args.limit,
+        });
+        const transactions = result?.data || result || [];
+        return formatStructuredList(Array.isArray(transactions) ? transactions : [], "transaction");
+    }
+    async storageStatus(_args) {
+        const result = await this.pica.settings.storageConfig();
+        const config = result?.data || result;
+        const provider = config?.storage_provider || "pica_s3";
+        return formatSuccess(`Storage provider: ${provider}${provider === "pica_s3" ? " (PICA default)" : " (your own)"}`, config);
+    }
+    async orgProfile(_args) {
+        const result = await this.pica.settings.orgProfile();
+        const org = result?.data || result;
+        return formatSuccess(`Organisation: ${org?.display_name || "unnamed"}`, org);
+    }
+    async userProfile(_args) {
+        const result = await this.pica.settings.userProfile();
+        const profile = result?.data || result;
+        return formatSuccess(`User: ${profile?.full_name || profile?.email || "unknown"}`, profile);
+    }
+}
+//# sourceMappingURL=settings.js.map

package/dist/tools/settings.js.map

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

package/dist/tools/share-links.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Share Links MCP Tools — ADR-139 Step 3
+ *
+ * "Share my song with Tony" or "Send a link to Mark to upload stems"
+ * — conversational actions that need MCP tools.
+ */
+import { PicaClient } from "../pica-sdk.js";
+import type { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class ShareLinksTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listShareLinks;
+    private createShareLink;
+}
+//# sourceMappingURL=share-links.d.ts.map

package/dist/tools/share-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"share-links.d.ts","sourceRoot":"","sources":["../../src/tools/share-links.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAG3E,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;YA+E3D,cAAc;YAoBd,eAAe;CAiC9B"}

package/dist/tools/share-links.js

@@ -0,0 +1,126 @@
+/**
+ * Share Links MCP Tools — ADR-139 Step 3
+ *
+ * "Share my song with Tony" or "Send a link to Mark to upload stems"
+ * — conversational actions that need MCP tools.
+ */
+import { formatSuccess } from "../utils/formatting.js";
+export class ShareLinksTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_share_links_list",
+                    description: "List existing share links, optionally filtered by work. " +
+                        "Shows active links with view/download counts and expiry status.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "Filter share links for a specific work (UUID)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listShareLinks.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_share_links_create",
+                    description: "Create a share link for a work, playlist, or release. " +
+                        "The link can be password-protected, have a view limit, and expire. " +
+                        "Returns a URL the recipient can use to access the shared content.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "Single work ID to share (use this OR work_ids OR release_id)",
+                            },
+                            work_ids: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "Multiple work IDs for a playlist share link",
+                            },
+                            release_id: {
+                                type: "string",
+                                description: "Release ID for sharing an entire release",
+                            },
+                            name: {
+                                type: "string",
+                                description: "Display name for the share link (e.g. 'Demo for Tony')",
+                            },
+                            password: {
+                                type: "string",
+                                description: "Optional password to protect the link",
+                            },
+                            expires_at: {
+                                type: "string",
+                                description: "Expiry date (ISO format). Link becomes invalid after this date.",
+                            },
+                            max_views: {
+                                type: "number",
+                                description: "Maximum number of views before the link expires",
+                            },
+                            allow_download: {
+                                type: "boolean",
+                                description: "Whether recipients can download files (default: false)",
+                            },
+                            message: {
+                                type: "string",
+                                description: "Optional message shown to the recipient",
+                            },
+                        },
+                    },
+                },
+                executor: this.createShareLink.bind(this),
+            },
+        ];
+    }
+    async listShareLinks(args) {
+        const data = await this.pica.shareLinks.list({
+            work_id: args.work_id,
+        });
+        const links = Array.isArray(data) ? data : [];
+        const hints = [];
+        if (!links.length && args.work_id) {
+            hints.push({
+                gap: "no_share_links",
+                suggestion: "Create a share link for this work (pica_share_links_create)",
+                severity: "nice_to_have",
+            });
+        }
+        return formatSuccess(`Found ${links.length} share link(s)`, links, hints);
+    }
+    async createShareLink(args) {
+        if (!args.work_id && !args.work_ids?.length && !args.release_id) {
+            return formatSuccess("Please provide a work_id, work_ids (array), or release_id to create a share link", null);
+        }
+        const data = await this.pica.shareLinks.create({
+            work_id: args.work_id,
+            work_ids: args.work_ids,
+            release_id: args.release_id,
+            name: args.name,
+            password: args.password,
+            expires_at: args.expires_at,
+            max_views: args.max_views,
+            allow_download: args.allow_download ?? false,
+            message: args.message,
+        });
+        const hints = [];
+        if (data?.token) {
+            hints.push({
+                gap: "share_link_created",
+                suggestion: `Share link created — send the URL to the recipient`,
+                severity: "nice_to_have",
+            });
+        }
+        return formatSuccess("Share link created", data, hints);
+    }
+}
+//# sourceMappingURL=share-links.js.map

package/dist/tools/share-links.js.map

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

package/dist/tools/split-sheets.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Split Sheets & Recording Splits Tools
+ * MCP tools for managing publishing split sheets and master recording ownership splits
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class SplitSheetsTools {
+    private pica;
+    constructor(pica: PicaClient);
+    /**
+     * Get all split sheet and recording split tools
+     */
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listSplitSheets;
+    private generateSplitSheet;
+    private getSplitSheet;
+    private listRecordingSplits;
+    private createRecordingSplit;
+    private verifyRecordingSplit;
+}
+//# sourceMappingURL=split-sheets.d.ts.map

package/dist/tools/split-sheets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-sheets.d.ts","sourceRoot":"","sources":["../../src/tools/split-sheets.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAOtE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YAqJ3D,eAAe;YAWf,kBAAkB;YAOlB,aAAa;YAUb,mBAAmB;YAWnB,oBAAoB;YAQpB,oBAAoB;CASnC"}