@withpica/mcp-server 2.7.0 → 2.8.0

package/dist/tools/agreements.js

@@ -0,0 +1,363 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatList, formatSuccess } from "@withpica/mcp-utils";
+import { notifyParties, summarizeNotifications } from "@withpica/mcp-utils";
+const AGREEMENT_TYPE_ENUM = [
+    "master_recording",
+    "library_music",
+    "publishing_admin",
+    "production",
+    "artist_contract",
+    "termination",
+    "report",
+    "other",
+    "sub_publishing",
+    "co_publishing",
+    "admin_only",
+    "distribution",
+];
+export class AgreementsTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_agreements_query",
+                    description: "List agreements with optional filters. Returns contracts, publishing deals, and other agreements.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            query: {
+                                type: "string",
+                                description: "Search by title or party name",
+                            },
+                            agreement_type: {
+                                type: "string",
+                                description: "Filter by agreement type",
+                                enum: [...AGREEMENT_TYPE_ENUM],
+                            },
+                            status: {
+                                type: "string",
+                                description: "Filter by status",
+                                enum: [
+                                    "draft",
+                                    "pending_signature",
+                                    "partially_signed",
+                                    "fully_executed",
+                                    "active",
+                                    "completed",
+                                    "terminated",
+                                    "expired",
+                                    "cancelled",
+                                    "unknown",
+                                ],
+                            },
+                            party_name: {
+                                type: "string",
+                                description: "Filter by other party name",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Maximum results (default: 50, max: 100)",
+                            },
+                            offset: {
+                                type: "number",
+                                description: "Pagination offset (default: 0)",
+                            },
+                        },
+                    },
+                },
+                executor: this.queryAgreements.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_agreements_inspect",
+                    description: "Get details for a specific agreement. Omit sections for everything. " +
+                        "→ then: pica_agreements_update (modify), pica_agreements_link_work (attach work)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Agreement ID",
+                            },
+                            sections: {
+                                type: "array",
+                                items: {
+                                    type: "string",
+                                    enum: ["basic", "works", "parties", "payments"],
+                                },
+                                description: "Which data sections to include. Omit for all sections.",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.inspectAgreement.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_agreements_create",
+                    description: "Create a new agreement. Requires title, type, and other party name.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            title: {
+                                type: "string",
+                                description: "Agreement title",
+                            },
+                            agreement_type: {
+                                type: "string",
+                                description: "Type of agreement",
+                                enum: [...AGREEMENT_TYPE_ENUM],
+                            },
+                            other_party_name: {
+                                type: "string",
+                                description: "Name of the other party (label, publisher, etc.)",
+                            },
+                            status: {
+                                type: "string",
+                                description: "Initial status (default: draft)",
+                                enum: [
+                                    "draft",
+                                    "pending_signature",
+                                    "partially_signed",
+                                    "fully_executed",
+                                    "active",
+                                    "completed",
+                                    "terminated",
+                                    "expired",
+                                    "cancelled",
+                                ],
+                            },
+                            other_party_type: {
+                                type: "string",
+                                description: "Type of the other party (e.g., label, publisher, distributor)",
+                            },
+                            signing_date: {
+                                type: "string",
+                                description: "Date the agreement was signed (ISO 8601)",
+                            },
+                            start_date: {
+                                type: "string",
+                                description: "Start date of the agreement term (ISO 8601)",
+                            },
+                            end_date: {
+                                type: "string",
+                                description: "End date of the agreement term (ISO 8601)",
+                            },
+                            description: {
+                                type: "string",
+                                description: "Description of the agreement",
+                            },
+                            notes: {
+                                type: "string",
+                                description: "Internal notes",
+                            },
+                        },
+                        required: ["title", "agreement_type", "other_party_name"],
+                    },
+                },
+                executor: this.createAgreement.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_agreements_update",
+                    description: "Update an existing agreement. Status changes trigger notifications.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Agreement ID",
+                            },
+                            title: {
+                                type: "string",
+                                description: "Updated title",
+                            },
+                            status: {
+                                type: "string",
+                                description: "Updated status",
+                                enum: [
+                                    "draft",
+                                    "pending_signature",
+                                    "partially_signed",
+                                    "fully_executed",
+                                    "active",
+                                    "completed",
+                                    "terminated",
+                                    "expired",
+                                    "cancelled",
+                                ],
+                            },
+                            other_party_name: {
+                                type: "string",
+                                description: "Updated other party name",
+                            },
+                            signing_date: {
+                                type: "string",
+                                description: "Updated signing date (ISO 8601)",
+                            },
+                            start_date: {
+                                type: "string",
+                                description: "Updated start date (ISO 8601)",
+                            },
+                            end_date: {
+                                type: "string",
+                                description: "Updated end date (ISO 8601)",
+                            },
+                            description: {
+                                type: "string",
+                                description: "Updated description",
+                            },
+                            notes: {
+                                type: "string",
+                                description: "Updated internal notes",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.updateAgreement.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_agreements_delete",
+                    description: "Delete an agreement",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Agreement ID",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.deleteAgreement.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_agreements_link_work",
+                    description: "Link a work to an agreement. Optionally set a royalty split percentage.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            agreement_id: {
+                                type: "string",
+                                description: "Agreement ID",
+                            },
+                            work_id: {
+                                type: "string",
+                                description: "Work ID to link",
+                            },
+                            royalty_split_percentage: {
+                                type: "number",
+                                description: "Royalty split percentage for this work (0-100)",
+                            },
+                            notes: {
+                                type: "string",
+                                description: "Notes about this work's inclusion in the agreement",
+                            },
+                        },
+                        required: ["agreement_id", "work_id"],
+                    },
+                },
+                executor: this.linkWork.bind(this),
+            },
+        ];
+    }
+    async queryAgreements(args) {
+        const agreements = await this.pica.agreements.list({
+            query: args.query,
+            agreement_type: args.agreement_type,
+            status: args.status,
+            party_name: args.party_name,
+            includeWorkCounts: true,
+            limit: args.limit,
+            offset: args.offset,
+        });
+        return formatList(agreements, { total: agreements.length });
+    }
+    async inspectAgreement(args) {
+        const sections = args.sections;
+        const includeAll = !sections || sections.length === 0;
+        const needsBasic = includeAll ||
+            sections.includes("basic") ||
+            sections.includes("parties") ||
+            sections.includes("payments");
+        const needsWorks = includeAll || sections.includes("works");
+        // Fetch data in parallel where possible
+        const [fullResult, works] = await Promise.all([
+            needsBasic ? this.pica.agreements.get(args.id) : null,
+            needsWorks ? this.pica.agreements.getWorks(args.id) : null,
+        ]);
+        const result = {};
+        if (includeAll || sections.includes("basic")) {
+            result.agreement = fullResult.agreement;
+            result.signatureStatus = fullResult.signatureStatus;
+        }
+        if (includeAll || sections.includes("works")) {
+            result.linkedWorks = works;
+        }
+        if (includeAll || sections.includes("parties")) {
+            // Parties are part of the agreement object
+            const agreement = fullResult.agreement;
+            result.parties = {
+                other_party_name: agreement.other_party_name,
+                other_party_type: agreement.other_party_type,
+            };
+        }
+        if (includeAll || sections.includes("payments")) {
+            // Payment info is part of the agreement object
+            const agreement = fullResult.agreement;
+            result.payments = {
+                royalty_rate: agreement.royalty_rate,
+                advance_amount: agreement.advance_amount,
+                payment_terms: agreement.payment_terms,
+            };
+        }
+        return formatSuccess("Agreement details", result);
+    }
+    async createAgreement(args) {
+        const agreement = await this.pica.agreements.create(args);
+        // Auto-notify other party if person_id provided
+        let notifySummary = "";
+        if (args.other_party_person_id) {
+            const results = await notifyParties(this.pica, [
+                {
+                    person_id: args.other_party_person_id,
+                    message: `a new ${args.agreement_type || "agreement"} has been created: "${args.title || "untitled"}" — please review`,
+                    work_id: args.work_id,
+                    notification_type: "agreement_created",
+                },
+            ]);
+            notifySummary = summarizeNotifications(results);
+        }
+        const msg = notifySummary
+            ? `Agreement created. ${notifySummary}`
+            : "Agreement created";
+        return formatSuccess(msg, agreement);
+    }
+    async updateAgreement(args) {
+        const { id, ...updates } = args;
+        const agreement = await this.pica.agreements.update(id, updates);
+        return formatSuccess("Agreement updated", agreement);
+    }
+    async deleteAgreement(args) {
+        await this.pica.agreements.delete(args.id);
+        return formatSuccess(`Agreement ${args.id} deleted`);
+    }
+    async linkWork(args) {
+        const link = await this.pica.agreements.linkWork(args.agreement_id, {
+            work_id: args.work_id,
+            royalty_split_percentage: args.royalty_split_percentage,
+            notes: args.notes,
+        });
+        return formatSuccess("Work linked to agreement", link);
+    }
+}
+//# sourceMappingURL=agreements.js.map

package/dist/tools/agreements.js.map

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

package/dist/tools/analytics.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Analytics & Reporting Tools — carbon footprint, provenance, catalog diligence
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class AnalyticsTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private carbonSummary;
+    private carbonLive;
+    private provenanceStats;
+    private provenanceWork;
+    private provenanceCertificate;
+    private catalogDiligence;
+}
+//# sourceMappingURL=analytics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/tools/analytics.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,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;YAkG3D,aAAa;YAKb,UAAU;YAKV,eAAe;YAOf,cAAc;YAKd,qBAAqB;YAYrB,gBAAgB;CAM/B"}

package/dist/tools/analytics.js

@@ -0,0 +1,124 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatAsText, formatSuccess } from "@withpica/mcp-utils";
+export class AnalyticsTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            // --- Carbon footprint ---
+            {
+                definition: {
+                    name: "pica_carbon_footprint",
+                    description: "Get the carbon footprint summary for your catalog — " +
+                        "streaming, physical distribution, and production emissions.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.carbonSummary.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_carbon_live",
+                    description: "Get live/real-time carbon metrics for ongoing streaming and distribution activity.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.carbonLive.bind(this),
+            },
+            // --- Provenance ---
+            {
+                definition: {
+                    name: "pica_provenance_stats",
+                    description: "Get provenance statistics — how many works have chain-of-title records, " +
+                        "attestation coverage, and verification status.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.provenanceStats.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_provenance_work",
+                    description: "Get the full provenance chain for a specific work — " +
+                        "creation history, ownership transfers, attestations, and verification entries.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to get provenance for",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: this.provenanceWork.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_provenance_certificate",
+                    description: "Generate a provenance certificate for a work — " +
+                        "a downloadable chain-of-title document with attestation details.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to generate a certificate for",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: this.provenanceCertificate.bind(this),
+            },
+            // --- Catalog diligence ---
+            {
+                definition: {
+                    name: "pica_catalog_diligence",
+                    description: "Generate a technical due diligence report for the catalog — " +
+                        "ownership clarity, registration coverage, identifier completeness, " +
+                        "and readiness for lending, licensing, or acquisition.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.catalogDiligence.bind(this),
+            },
+        ];
+    }
+    async carbonSummary(_args) {
+        const result = await this.pica.analytics.carbonSummary();
+        return formatSuccess("Carbon footprint summary", result);
+    }
+    async carbonLive(_args) {
+        const result = await this.pica.analytics.carbonLive();
+        return formatSuccess("Live carbon metrics", result);
+    }
+    async provenanceStats(_args) {
+        const result = await this.pica.analytics.provenanceStats();
+        return formatAsText(result);
+    }
+    async provenanceWork(args) {
+        const result = await this.pica.analytics.provenanceWork(args.work_id);
+        return formatAsText(result);
+    }
+    async provenanceCertificate(args) {
+        const result = await this.pica.analytics.provenanceCertificate(args.work_id);
+        return formatSuccess(`Provenance certificate generated for work ${args.work_id}`, result);
+    }
+    async catalogDiligence(_args) {
+        const result = await this.pica.analytics.catalogDiligence();
+        return formatSuccess("Catalog diligence report", result);
+    }
+}
+//# sourceMappingURL=analytics.js.map

package/dist/tools/analytics.js.map

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

package/dist/tools/app-tools.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MCP App Tools — tools with _meta.ui for interactive iframe rendering.
+ *
+ * ADR-152: scope reduced to two generic cards (pica_upload, pica_download).
+ * Previous harness cards (pica_briefing, pica_asset_register) removed in 2a.1.
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class AppTools {
+    private pica;
+    private exportTools;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private carPreview;
+    private upload;
+    private download;
+}
+//# sourceMappingURL=app-tools.d.ts.map

package/dist/tools/app-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-tools.d.ts","sourceRoot":"","sources":["../../src/tools/app-tools.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAYtE,qBAAa,QAAQ;IACnB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,WAAW,CAAc;gBAErB,IAAI,EAAE,UAAU;IAK5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YAqI3D,UAAU;YAuEV,MAAM;YAqBN,QAAQ;CA8BvB"}