@withpica/mcp-server 1.3.0

package/dist/tools/agreement-types.js

@@ -0,0 +1,281 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatAsText, formatList, formatSuccess } from "@withpica/mcp-utils";
+import { notifyParties, summarizeNotifications, withBillingGate, } from "@withpica/mcp-utils";
+import { AGREEMENT_TYPES_WRITE_PROPERTIES, AGREEMENT_TYPES_CREATE_REQUIRED, AGREEMENT_TYPES_UPDATE_REQUIRED, } from "@withpica/mcp-utils";
+export class AgreementTypesTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getResource(type) {
+        switch (type) {
+            case "template":
+                return this.pica.agreementTemplates;
+            case "producer":
+                return this.pica.producerAgreements;
+            case "work_for_hire":
+                return this.pica.workForHire;
+            default:
+                throw new Error(`Unknown agreement type: ${type}`);
+        }
+    }
+    labelFor(type) {
+        switch (type) {
+            case "template":
+                return "Agreement template";
+            case "producer":
+                return "Producer agreement";
+            case "work_for_hire":
+                return "Work-for-hire agreement";
+        }
+    }
+    getTools() {
+        return [
+            // ── Unified CRUD ────────────────────────────────────────────────
+            {
+                definition: {
+                    name: "pica_agreement_types_query",
+                    description: "List agreements by type — templates, producer agreements, or work-for-hire contracts.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            type: {
+                                type: "string",
+                                enum: ["template", "producer", "work_for_hire"],
+                                description: "Agreement sub-type to query",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Max results",
+                            },
+                        },
+                        required: ["type"],
+                    },
+                },
+                executor: this.query.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_agreement_types_inspect",
+                    description: "Get a specific agreement by type and ID — full details including body, terms, and metadata.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            type: {
+                                type: "string",
+                                enum: ["template", "producer", "work_for_hire"],
+                                description: "Agreement sub-type",
+                            },
+                            id: {
+                                type: "string",
+                                description: "Agreement ID",
+                            },
+                        },
+                        required: ["type", "id"],
+                    },
+                },
+                executor: this.inspect.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_agreement_types_create",
+                    description: "Create a new agreement of the specified type. Three branches dispatched via 'type': " +
+                        "template (→ agreement_templates, needs name + category + templateText), " +
+                        "producer (→ producer_agreements, needs producer_id + royalty_points + deliverables + work_id|recording_id), " +
+                        "work_for_hire (→ work_for_hire_agreements, needs contractor_id + contractor_role + fee_amount + services_description + work_id|recording_id). " +
+                        "Per-branch field applicability is documented on each property.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: AGREEMENT_TYPES_WRITE_PROPERTIES,
+                        required: [...AGREEMENT_TYPES_CREATE_REQUIRED],
+                    },
+                },
+                executor: withBillingGate(this.pica, "agreement type creation", this.create.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_agreement_types_update",
+                    description: "Update an existing agreement by type and ID. " +
+                        "Note: PATCH on producer_agreements and work_for_hire_agreements is action-only " +
+                        "(send_for_signature / countersign / mark_advance_paid / mark_paid / record_recoupment / " +
+                        "calculate_royalty), not generic field-level. Template branch accepts field updates.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: AGREEMENT_TYPES_WRITE_PROPERTIES,
+                        required: [...AGREEMENT_TYPES_UPDATE_REQUIRED],
+                    },
+                },
+                executor: withBillingGate(this.pica, "agreement type update", this.update.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_agreement_types_delete",
+                    description: "Delete an agreement by type and ID.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            type: {
+                                type: "string",
+                                enum: ["template", "producer", "work_for_hire"],
+                                description: "Agreement sub-type",
+                            },
+                            id: {
+                                type: "string",
+                                description: "Agreement ID",
+                            },
+                        },
+                        required: ["type", "id"],
+                    },
+                },
+                executor: withBillingGate(this.pica, "agreement type deletion", this.delete.bind(this)),
+            },
+            // ── Template-specific operations ────────────────────────────────
+            {
+                definition: {
+                    name: "pica_agreement_templates_render",
+                    description: "Fill an agreement template with work and people data — generates a ready-to-send agreement. Pass the template ID plus work_id and/or people_ids to populate the placeholders with real catalog data.",
+                    workflows: ["agreement-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Template ID to render",
+                            },
+                            work_id: {
+                                type: "string",
+                                description: "Work ID to pull title, credits, and metadata from",
+                            },
+                            people_ids: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "People IDs to include as parties in the agreement",
+                            },
+                            variables: {
+                                type: "object",
+                                description: "Additional variables to substitute — keys match placeholder names in the template body",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.renderTemplate.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_agreement_templates_duplicate",
+                    description: "Duplicate an agreement template — creates a copy you can customise without changing the original.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Template ID to duplicate",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: withBillingGate(this.pica, "template duplication", this.duplicateTemplate.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_agreement_templates_set_default",
+                    description: "Set a template as the default for its type — when creating agreements of that type, this template will be suggested first.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Template ID to set as default",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: withBillingGate(this.pica, "template default", this.setDefaultTemplate.bind(this)),
+            },
+        ];
+    }
+    // ── Unified CRUD executors ──────────────────────────────────────────
+    async query(args) {
+        const resource = this.getResource(args.type);
+        const items = await resource.list();
+        return formatList(items, { total: items.length });
+    }
+    async inspect(args) {
+        const resource = this.getResource(args.type);
+        const item = await resource.get(args.id);
+        return formatAsText(item);
+    }
+    async create(args) {
+        const { type, ...fields } = args;
+        const resource = this.getResource(type);
+        const item = await resource.create(fields);
+        // Notification for producer agreements
+        if (type === "producer" && fields.producer_id) {
+            const results = await notifyParties(this.pica, [
+                {
+                    person_id: fields.producer_id,
+                    message: `a producer agreement has been created for "${fields.title || "untitled"}" — please review the terms`,
+                    work_id: fields.work_id,
+                    notification_type: "agreement_created",
+                },
+            ]);
+            const notifySummary = summarizeNotifications(results);
+            if (notifySummary) {
+                return formatSuccess(`Producer agreement created. ${notifySummary}`, item);
+            }
+        }
+        // Notification for work-for-hire
+        if (type === "work_for_hire" && fields.contractor_id) {
+            const results = await notifyParties(this.pica, [
+                {
+                    person_id: fields.contractor_id,
+                    message: `a work-for-hire agreement has been created: "${fields.title || "untitled"}" — please review`,
+                    work_id: fields.work_id,
+                    notification_type: "agreement_created",
+                },
+            ]);
+            const notifySummary = summarizeNotifications(results);
+            if (notifySummary) {
+                return formatSuccess(`Work-for-hire agreement created. ${notifySummary}`, item);
+            }
+        }
+        return formatSuccess(`${this.labelFor(type)} created`, item);
+    }
+    async update(args) {
+        const { type, id, ...updates } = args;
+        const resource = this.getResource(type);
+        const item = await resource.update(id, updates);
+        return formatSuccess(`${this.labelFor(type)} updated`, item);
+    }
+    async delete(args) {
+        const { type, id } = args;
+        const resource = this.getResource(type);
+        await resource.delete(id);
+        return formatSuccess(`${this.labelFor(type)} ${id} deleted`);
+    }
+    // ── Template-specific executors ─────────────────────────────────────
+    async renderTemplate(args) {
+        const { id, ...renderData } = args;
+        const rendered = await this.pica.agreementTemplates.render(id, renderData);
+        return formatSuccess("Template rendered with catalog data", rendered);
+    }
+    async duplicateTemplate(args) {
+        const duplicate = await this.pica.agreementTemplates.duplicate(args.id);
+        return formatSuccess("Template duplicated", duplicate);
+    }
+    async setDefaultTemplate(args) {
+        const result = await this.pica.agreementTemplates.setDefault(args.id);
+        return formatSuccess("Template set as default for its type", result);
+    }
+}
+//# sourceMappingURL=agreement-types.js.map

package/dist/tools/agreement-types.js.map

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

package/dist/tools/agreements.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Agreements Tools - MCP tools for managing agreements and contracts
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class AgreementsTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private queryAgreements;
+    private inspectAgreement;
+    private createAgreement;
+    private updateAgreement;
+    private deleteAgreement;
+    private linkWork;
+}
+//# sourceMappingURL=agreements.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agreements.d.ts","sourceRoot":"","sources":["../../src/tools/agreements.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AA6BtE,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;YAwL3D,eAAe;YAef,gBAAgB;YAqEhB,eAAe;YAyBf,eAAe;YAQf,eAAe;YAOf,QAAQ;CAQvB"}

package/dist/tools/agreements.js

@@ -0,0 +1,282 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatList, formatSuccess, notifyParties, summarizeNotifications, withBillingGate, AGREEMENTS_WRITE_PROPERTIES, AGREEMENTS_CREATE_REQUIRED, AGREEMENTS_UPDATE_REQUIRED, } from "@withpica/mcp-utils";
+import { computeAgreementGapHints } from "./gap-hints.js";
+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.",
+                    workflows: "infrastructure",
+                    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)",
+                    workflows: "infrastructure",
+                    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 + agreement_type + other_party_name. " +
+                        "Prefer resolving the counterparty to a linked org via `counterparty_org_id` " +
+                        "(use pica_search_all to look up the org UUID) over free-text other_party_name — " +
+                        "the FK form enables aggregate reporting by counterparty.",
+                    workflows: ["agreement-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: AGREEMENTS_WRITE_PROPERTIES,
+                        required: [...AGREEMENTS_CREATE_REQUIRED],
+                    },
+                },
+                executor: withBillingGate(this.pica, "agreement creation", this.createAgreement.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_agreements_update",
+                    description: "Update an existing agreement. Status changes trigger notifications; " +
+                        "counterparty_org_id changes require the linked-org check at the route layer.",
+                    workflows: ["agreement-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: AGREEMENTS_WRITE_PROPERTIES,
+                        required: [...AGREEMENTS_UPDATE_REQUIRED],
+                    },
+                },
+                executor: withBillingGate(this.pica, "agreement update", this.updateAgreement.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_agreements_delete",
+                    description: "Delete an agreement (destructive — also removes linked work and party records).",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Agreement ID",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: withBillingGate(this.pica, "agreement deletion", this.deleteAgreement.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_agreements_link_work",
+                    description: "Link a work to an agreement. Optionally set a royalty split percentage.",
+                    workflows: ["agreement-required"],
+                    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: withBillingGate(this.pica, "agreement link", 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.
+            // ADR-201 Phase 2: dropped phantom `royalty_rate` and `payment_terms`
+            // columns (template-variable names from system-templates seed, never
+            // actual columns on `agreements`). Surfaced `advance_currency`,
+            // `is_recoupable`, `financial_terms` to match the write surface so
+            // the round-trip parity contract is satisfied. See
+            // docs/audits/2026-04-27-read-write-parity-audit.md § Agreements.
+            const agreement = fullResult.agreement;
+            result.payments = {
+                advance_amount: agreement.advance_amount,
+                advance_currency: agreement.advance_currency,
+                is_recoupable: agreement.is_recoupable,
+                financial_terms: agreement.financial_terms,
+            };
+        }
+        // ADR-193 Surface 2 — proactive peer-MCP hints when gaps are real.
+        const gap_hints = computeAgreementGapHints(result);
+        const enriched = gap_hints.length > 0 ? { ...result, gap_hints } : result;
+        return formatSuccess("Agreement details", enriched);
+    }
+    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;YAwG3D,aAAa;YAKb,UAAU;YAKV,eAAe;YAOf,cAAc;YAKd,qBAAqB;YAYrB,gBAAgB;CAM/B"}