@withpica/mcp-server 2.7.0 → 2.9.0

package/dist/tools/sessions.js

@@ -0,0 +1,115 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatAsText, formatSuccess, formatStructuredList, } from "@withpica/mcp-utils";
+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_id: {
+                                type: "string",
+                                description: "Session type UUID — get valid IDs from pica_sessions_types",
+                            },
+                            start_time: {
+                                type: "string",
+                                description: "ISO 8601 datetime",
+                            },
+                            end_time: {
+                                type: "string",
+                                description: "ISO 8601 datetime",
+                            },
+                            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", "start_time", "end_time"],
+                        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) {
+        // Derive start_time/end_time from date if not provided
+        if (!args.start_time && !args.end_time && args.date) {
+            args.start_time = `${args.date}T09:00:00`;
+            args.end_time = `${args.date}T17:00:00`;
+            delete args.date;
+        }
+        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 "@withpica/mcp-sdk";
+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":"AAEA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,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,96 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatSuccess, formatStructuredList, } from "@withpica/mcp-utils";
+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 "@withpica/mcp-sdk";
+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":"AAEA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,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,121 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatSuccess } from "@withpica/mcp-utils";
+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)",
+                            },
+                            personal_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,
+            personal_message: args.personal_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,25 @@
+/**
+ * Split Sheets & Recording Splits Tools
+ * MCP tools for managing publishing split sheets and master recording ownership splits
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+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 sendSplitSheet;
+    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":"AAEA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,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;YAwM3D,cAAc;YAmGd,eAAe;YAWf,kBAAkB;YAOlB,aAAa;YAUb,mBAAmB;YAWnB,oBAAoB;YAQpB,oBAAoB;CASnC"}