@withpica/mcp-server 2.7.0 → 2.8.0

package/dist/tools/custody.js

@@ -0,0 +1,274 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatSuccess } from "@withpica/mcp-utils";
+export class CustodyTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_custody_claim",
+                    description: "Request custody of a work's composition or master chain. " +
+                        "If another org currently holds custody, creates a pending claim; the current " +
+                        "custodian has 7 days to accept, decline, or dispute before the claim auto-approves. " +
+                        "If you already hold custody, this errors. Admin/owner access required.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "UUID of the work to claim.",
+                            },
+                            chain: {
+                                type: "string",
+                                enum: ["composition", "master"],
+                                description: "'composition' = publishing rights; 'master' = recording rights.",
+                            },
+                            reason: {
+                                type: "string",
+                                description: "Optional freetext shown to the current custodian in the notification.",
+                            },
+                        },
+                        required: ["work_id", "chain"],
+                    },
+                    annotations: {
+                        title: "claim custody",
+                        destructiveHint: false,
+                        idempotentHint: false,
+                    },
+                },
+                executor: this.claim.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_custody_respond",
+                    description: "Respond to an incoming custody claim. Actions: 'accept' transfers custody " +
+                        "to the claimant; 'decline' rejects the claim (custody unchanged); 'dispute' " +
+                        "freezes the claim for human review. reason is required for dispute. Only the " +
+                        "current custodian can accept or decline; the custodian OR any credited party " +
+                        "can dispute. Admin/owner access required.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            claim_id: {
+                                type: "string",
+                                description: "UUID of the custody_claims row to respond to.",
+                            },
+                            action: {
+                                type: "string",
+                                enum: ["accept", "decline", "dispute"],
+                            },
+                            reason: {
+                                type: "string",
+                                description: "Required when action='dispute'. Optional for decline.",
+                            },
+                        },
+                        required: ["claim_id", "action"],
+                    },
+                    annotations: {
+                        title: "respond to a custody claim",
+                        destructiveHint: false,
+                        idempotentHint: false,
+                    },
+                },
+                executor: this.respond.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_custody_list",
+                    description: "List custody claims for your organisation — both incoming " +
+                        "(claims others filed against your custody) and outgoing (claims you filed). " +
+                        "Defaults to pending claims only. Available to any authenticated org member.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            direction: {
+                                type: "string",
+                                enum: ["incoming", "outgoing", "both"],
+                                description: "Default: both.",
+                            },
+                            status: {
+                                type: "string",
+                                description: "Filter by status (pending|accepted|declined|disputed|auto_approved|withdrawn|expired|all). Default: pending.",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "1..200. Default 50.",
+                            },
+                        },
+                    },
+                    annotations: {
+                        title: "list custody claims",
+                        readOnlyHint: true,
+                        idempotentHint: true,
+                    },
+                },
+                executor: this.list.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_custody_history",
+                    description: "Return custody-related provenance_history rows for a work. Every row " +
+                        "includes an attestation_hash so the history is cryptographically anchored. " +
+                        "Use this to audit who changed custody when. Available to any authenticated org member.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "UUID of the work whose history to fetch.",
+                            },
+                            change_type: {
+                                type: "string",
+                                description: "Filter to one change_type (custody_claimed|custody_transferred|custody_released|custody_expired|custody_transfer_auto) or 'all'. Default 'all'.",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "1..500. Default 100.",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                    annotations: {
+                        title: "custody history",
+                        readOnlyHint: true,
+                        idempotentHint: true,
+                    },
+                },
+                executor: this.history.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_custody_resolve_pending",
+                    description: "Preview works where this org (or a specific global_publisher_id) is named " +
+                        "as canonical custodian via work_custodians.custodian_global_publisher_id but " +
+                        "has not yet been claimed via a PICA org membership. The 'Warner Chappell signs " +
+                        "up and finds 38 works waiting' view. Read-only — use pica_custody_reconcile " +
+                        "to actually claim them. Admin/owner access required.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            global_publisher_id: {
+                                type: "string",
+                                description: "Optional. If omitted, uses the caller org's own global_publisher_id bridge.",
+                            },
+                        },
+                    },
+                    annotations: {
+                        title: "resolve pending custody",
+                        readOnlyHint: true,
+                        idempotentHint: true,
+                    },
+                },
+                executor: this.resolvePending.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_custody_reconcile",
+                    description: "Bulk-claim every work where your org (or a specific global_publisher_id) " +
+                        "is named as canonical custodian but hasn't been locally claimed yet. Writes " +
+                        "one custody_claims row per matching work. Default is dry-run — pass confirm=true " +
+                        "to execute. Admin/owner access required.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            global_publisher_id: { type: "string" },
+                            confirm: {
+                                type: "boolean",
+                                description: "Required to actually write claims. Default false = dry-run.",
+                            },
+                        },
+                    },
+                    annotations: {
+                        title: "reconcile custody",
+                        destructiveHint: false,
+                        idempotentHint: false,
+                    },
+                },
+                executor: this.reconcile.bind(this),
+            },
+        ];
+    }
+    async claim(args) {
+        const data = await this.pica.custody.claim({
+            work_id: args.work_id,
+            chain: args.chain,
+            reason: args.reason,
+        });
+        return formatSuccess(`Custody claim created (${args.chain} chain). The current custodian has 7 days to respond before the claim auto-approves.`, data);
+    }
+    async respond(args) {
+        const data = await this.pica.custody.respond({
+            claim_id: args.claim_id,
+            action: args.action,
+            reason: args.reason,
+        });
+        const verb = args.action === "accept"
+            ? "accepted"
+            : args.action === "decline"
+                ? "declined"
+                : "disputed";
+        return formatSuccess(`Custody claim ${verb}.`, data);
+    }
+    async list(args) {
+        const data = await this.pica.custody.list({
+            direction: args.direction,
+            status: args.status,
+            limit: args.limit,
+        });
+        const incoming = data?.incoming ?? [];
+        const outgoing = data?.outgoing ?? [];
+        const hints = [];
+        if (incoming.length > 0) {
+            hints.push({
+                gap: "custody_claims_incoming",
+                suggestion: `You have ${incoming.length} incoming custody claim(s) — respond via pica_custody_respond before the 7-day window closes.`,
+                count: incoming.length,
+                severity: "important",
+            });
+        }
+        return formatSuccess(`Found ${incoming.length} incoming + ${outgoing.length} outgoing custody claim(s).`, data, hints);
+    }
+    async history(args) {
+        const data = await this.pica.custody.history({
+            work_id: args.work_id,
+            change_type: args.change_type,
+            limit: args.limit,
+        });
+        const count = data?.count ?? 0;
+        return formatSuccess(count > 0
+            ? `Returned ${count} custody history row(s) for the work.`
+            : "No custody history rows for this work.", data);
+    }
+    async resolvePending(args) {
+        const data = await this.pica.custody.resolvePending({
+            global_publisher_id: args.global_publisher_id,
+        });
+        const count = data?.count ?? 0;
+        const hints = [];
+        if (count > 0) {
+            hints.push({
+                gap: "custody_inheritable",
+                suggestion: `${count} work(s) reference your publisher identity but haven't been claimed — run pica_custody_reconcile with confirm=true to claim them in bulk.`,
+                count,
+                severity: "important",
+            });
+        }
+        return formatSuccess(count > 0
+            ? `${count} inheritable work(s) found.`
+            : "No inheritable works found.", data, hints);
+    }
+    async reconcile(args) {
+        const data = await this.pica.custody.reconcile({
+            global_publisher_id: args.global_publisher_id,
+            confirm: args.confirm === true,
+        });
+        if (data?.dry_run) {
+            return formatSuccess(`Dry run — ${data.would_claim ?? 0} claim(s) would be created. Pass confirm=true to execute.`, data);
+        }
+        return formatSuccess(`Reconciliation complete — ${data?.claimed ?? 0} claimed, ${data?.failed ?? 0} failed.`, data);
+    }
+}
+//# sourceMappingURL=custody.js.map

package/dist/tools/custody.js.map

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

package/dist/tools/dashboard.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Dashboard & Discovery Tools — surface what needs attention, what PICA found, and daily briefings
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class DashboardTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private queryDiscoveries;
+    private reviewDiscovery;
+    private attentionItems;
+    private briefing;
+    private pulse;
+}
+//# sourceMappingURL=dashboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/tools/dashboard.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,cAAc;IACzB,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;YA2G3D,gBAAgB;YA8BhB,eAAe;YAaf,cAAc;YAYd,QAAQ;YAMR,KAAK;CAIpB"}

package/dist/tools/dashboard.js

@@ -0,0 +1,146 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatAsText, formatSuccess, formatStructuredList, } from "@withpica/mcp-utils";
+export class DashboardTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            // --- Discoveries ---
+            {
+                definition: {
+                    name: "pica_discoveries_query",
+                    description: "Query discoveries — system-computed findings like ISRC matches, " +
+                        "duplicate detection, enrichment opportunities, and registration gaps. " +
+                        "Filter by status to see all, pending (needing review), or reviewed items.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            status: {
+                                type: "string",
+                                enum: ["all", "pending", "reviewed"],
+                                description: "Filter by status: 'all' for everything, 'pending' for items needing review, 'reviewed' for already-handled (default: all)",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Max results (default 50)",
+                            },
+                        },
+                    },
+                },
+                executor: this.queryDiscoveries.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_discoveries_review",
+                    description: "Accept or reject a pending discovery. " +
+                        "Accepted discoveries update your catalog automatically.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            discovery_id: {
+                                type: "string",
+                                description: "The discovery ID to review",
+                            },
+                            status: {
+                                type: "string",
+                                enum: ["accepted", "rejected"],
+                                description: "Accept or reject the discovery",
+                            },
+                        },
+                        required: ["discovery_id", "status"],
+                    },
+                },
+                executor: this.reviewDiscovery.bind(this),
+            },
+            // --- Dashboard ---
+            {
+                definition: {
+                    name: "pica_dashboard_attention",
+                    description: "What needs my attention? Shows items requiring action — " +
+                        "incomplete works, unsigned agreements, overdue tasks, " +
+                        "pending invites, and quality issues.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            door: {
+                                type: "string",
+                                enum: ["respond", "catalog"],
+                                description: "Focus area: 'respond' for urgent items, 'catalog' for data quality",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Max items (default 10)",
+                            },
+                        },
+                    },
+                },
+                executor: this.attentionItems.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_dashboard_briefing",
+                    description: "Get your daily briefing — a summary of catalog health, " +
+                        "recent activity, upcoming deadlines, and recommended actions.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.briefing.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_dashboard_pulse",
+                    description: "Get the pulse of your catalog — works needing attention, " +
+                        "upcoming deadlines, provenance status, and background task progress.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.pulse.bind(this),
+            },
+        ];
+    }
+    async queryDiscoveries(args) {
+        const status = args.status || "all";
+        // "pending" delegates to the dedicated pending endpoint
+        if (status === "pending") {
+            const result = await this.pica.dashboard.pendingDiscoveries();
+            const items = result?.data || result || [];
+            return formatStructuredList(Array.isArray(items) ? items : [], "pending discovery");
+        }
+        // "all" or "reviewed" use the general discoveries endpoint
+        const result = await this.pica.dashboard.discoveries({
+            unread: status === "all" ? undefined : false,
+            limit: args.limit,
+        });
+        const items = result?.data || result || [];
+        const unreadCount = result?.unreadCount ?? 0;
+        return formatStructuredList(Array.isArray(items) ? items : [], "discovery", { unreadCount });
+    }
+    async reviewDiscovery(args) {
+        const result = await this.pica.dashboard.reviewDiscovery(args.discovery_id, args.status);
+        return formatSuccess(`Discovery ${args.discovery_id} ${args.status}`, result);
+    }
+    async attentionItems(args) {
+        const result = await this.pica.dashboard.attentionItems({
+            door: args.door,
+            limit: args.limit,
+        });
+        const items = result?.data?.items || result?.items || [];
+        return formatStructuredList(Array.isArray(items) ? items : [], "attention item");
+    }
+    async briefing(_args) {
+        const result = await this.pica.dashboard.briefing();
+        const insights = result?.data?.insights || result?.insights || result;
+        return formatSuccess("Daily briefing", insights);
+    }
+    async pulse(_args) {
+        const result = await this.pica.dashboard.pulse();
+        return formatAsText(result);
+    }
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/tools/dashboard.js.map

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

package/dist/tools/directory.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Directory Tools — manage directory visibility and settings
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class DirectoryTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private directorySettings;
+}
+//# sourceMappingURL=directory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../../src/tools/directory.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1D,qBAAa,cAAc;IACzB,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;YA6D3D,iBAAiB;CAkDhC"}

package/dist/tools/directory.js

@@ -0,0 +1,106 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatAsText, formatSuccess } from "@withpica/mcp-utils";
+export class DirectoryTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_directory_settings",
+                    description: "Get or update your organisation's directory visibility settings. " +
+                        "Controls whether your catalogue appears in the PICA public directory " +
+                        "and what information is shown (audio previews, splits, publishers, etc.).",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            action: {
+                                type: "string",
+                                enum: ["get", "update"],
+                                description: "Action to perform. 'get' returns current settings. 'update' changes settings.",
+                            },
+                            opted_in: {
+                                type: "boolean",
+                                description: "Make catalogue discoverable in the PICA directory. " +
+                                    "When true, sync supervisors and AI agents can find your recordings.",
+                            },
+                            show_audio_preview: {
+                                type: "boolean",
+                                description: "Allow audio previews in directory listings. " +
+                                    "When true, visitors can listen to your tracks.",
+                            },
+                            show_splits: {
+                                type: "boolean",
+                                description: "Show credit split percentages in directory.",
+                            },
+                            show_publishers: {
+                                type: "boolean",
+                                description: "Show publisher information in directory.",
+                            },
+                            show_agreements: {
+                                type: "boolean",
+                                description: "Show agreement details in directory.",
+                            },
+                            show_stems: {
+                                type: "boolean",
+                                description: "Show stems/instrumentals in directory.",
+                            },
+                            contact_enabled: {
+                                type: "boolean",
+                                description: "Allow licensing enquiries from the directory. " +
+                                    "When true, supervisors can send enquiries directly.",
+                            },
+                        },
+                        required: ["action"],
+                    },
+                },
+                executor: this.directorySettings.bind(this),
+            },
+        ];
+    }
+    async directorySettings(args) {
+        if (args.action === "get") {
+            const result = await this.pica.directory.getSettings();
+            const s = result.settings;
+            const status = s.opted_in ? "discoverable" : "private";
+            const summary = [
+                `Directory status: ${status}`,
+                `Eligible works: ${result.eligible_work_count}`,
+                s.show_audio_preview ? "Audio preview: on" : "Audio preview: off",
+                s.contact_enabled ? "Enquiries: on" : "Enquiries: off",
+                s.show_splits ? "Splits: visible" : "Splits: hidden",
+                s.show_publishers ? "Publishers: visible" : "Publishers: hidden",
+            ].join("\n");
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: result,
+            };
+        }
+        // Update
+        const updates = {};
+        const boolFields = [
+            "opted_in",
+            "show_audio_preview",
+            "show_splits",
+            "show_publishers",
+            "show_agreements",
+            "show_stems",
+            "contact_enabled",
+        ];
+        for (const field of boolFields) {
+            if (args[field] !== undefined)
+                updates[field] = Boolean(args[field]);
+        }
+        if (Object.keys(updates).length === 0) {
+            return formatAsText({
+                error: "No settings to update. Provide at least one setting field.",
+            });
+        }
+        const result = await this.pica.directory.updateSettings(updates);
+        const status = result.opted_in ? "discoverable" : "private";
+        return formatSuccess(`Directory settings updated. Your catalogue is now ${status}.`, result);
+    }
+}
+//# sourceMappingURL=directory.js.map

package/dist/tools/directory.js.map

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

package/dist/tools/discovery.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Layered Discovery Tools — ADR-149 Phase 5d
+ *
+ * When MCP_LAYERED_DISCOVERY=1, the catalog server handshake exposes only:
+ *   pica_sign_in, pica_sign_out, pica_discover, pica_tool_details, pica_execute
+ *
+ * Agents use pica_discover → pica_tool_details → pica_execute to progressively
+ * discover and invoke the full tool set without overwhelming the context window.
+ */
+import type { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class DiscoveryTools {
+    private executeToolFn;
+    private getToolDef;
+    constructor(executeToolFn: (name: string, args: Record<string, any>) => Promise<any>, getToolDef: (name: string) => {
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+        metadata?: any;
+    } | undefined);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private buildDiscoverTool;
+    private buildToolDetailsTool;
+    private buildToolDetail;
+    private buildExecuteTool;
+}
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/tools/discovery.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAgS3E,qBAAa,cAAc;IAEvB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,UAAU;gBAJV,aAAa,EAAE,CACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KACtB,OAAO,CAAC,GAAG,CAAC,EACT,UAAU,EAAE,CAClB,IAAI,EAAE,MAAM,KAEV;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,CAAA;KAAE,GACtE,SAAS;IAGf,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;IAQzE,OAAO,CAAC,iBAAiB;IAqDzB,OAAO,CAAC,oBAAoB;IAuH5B,OAAO,CAAC,eAAe;IAoCvB,OAAO,CAAC,gBAAgB;CAiHzB"}