@withpica/mcp-server 2.1.0

package/dist/resources/index.js

@@ -0,0 +1,310 @@
+/**
+ * Resource Registry for MCP Server
+ * Manages read-only data resources that AI assistants can access
+ */
+import { ResourceError } from "../utils/errors.js";
+import { readFileSync } from "fs";
+import { join } from "path";
+import { WITHPICA_PRIMER } from "./llms-primer.js";
+export class ResourceRegistry {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    /**
+     * List all available resources
+     */
+    listResources() {
+        return [
+            {
+                uri: "llms://primer",
+                name: "PICA Domain Primer",
+                description: "Plain-language description of PICA's domain model, entity relationships, and recommended agent workflows. Read this first.",
+                mimeType: "text/markdown",
+            },
+            {
+                uri: "works://list",
+                name: "All Works",
+                description: "Complete list of musical works in the catalog",
+                mimeType: "application/json",
+            },
+            {
+                uri: "people://list",
+                name: "All People",
+                description: "Complete list of people (artists, composers, etc.)",
+                mimeType: "application/json",
+            },
+            {
+                uri: "recordings://list",
+                name: "All Recordings",
+                description: "Complete list of recordings",
+                mimeType: "application/json",
+            },
+            {
+                uri: "catalog://stats",
+                name: "Catalog Statistics",
+                description: "Statistics and metrics about the catalog",
+                mimeType: "application/json",
+            },
+            {
+                uri: "catalog://health",
+                name: "Catalog Health (PICA Score)",
+                description: "PICA Score — composite legibility index (0-100) with grade, 4-pillar breakdown, and actionable suggestions",
+                mimeType: "application/json",
+            },
+            {
+                uri: "workspace://context",
+                name: "Workspace Context",
+                description: "Aggregated workspace orientation — org info, catalog stats, health score, and top priorities in one call",
+                mimeType: "application/json",
+            },
+            {
+                uri: "events://recent",
+                name: "Recent Events",
+                description: "Recent webhook delivery events — what happened in this workspace recently",
+                mimeType: "application/json",
+            },
+            {
+                uri: "api://openapi",
+                name: "OpenAPI Specification",
+                description: "OpenAPI 3.1 spec for the top 20 PICA API endpoints — works, people, recordings, agreements, credits, search, health",
+                mimeType: "text/yaml",
+            },
+        ];
+    }
+    /**
+     * Read a resource by URI
+     */
+    async readResource(uri) {
+        switch (uri) {
+            case "llms://primer":
+                return {
+                    contents: [
+                        {
+                            uri: "llms://primer",
+                            mimeType: "text/markdown",
+                            text: WITHPICA_PRIMER,
+                        },
+                    ],
+                };
+            case "works://list":
+                return await this.getWorksList();
+            case "people://list":
+                return await this.getPeopleList();
+            case "recordings://list":
+                return await this.getRecordingsList();
+            case "catalog://stats":
+                return await this.getCatalogStats();
+            case "catalog://health":
+                return await this.getCatalogHealth();
+            case "workspace://context":
+                return await this.getWorkspaceContext();
+            case "events://recent":
+                return await this.getRecentEvents();
+            case "api://openapi":
+                return this.getOpenAPISpec();
+            default:
+                throw new ResourceError(`Resource not found: ${uri}`);
+        }
+    }
+    /**
+     * Get OpenAPI specification resource
+     */
+    getOpenAPISpec() {
+        // Try multiple paths to find the spec file
+        const possiblePaths = [
+            join(process.cwd(), "docs/api/openapi.yaml"),
+            join(process.cwd(), "../docs/api/openapi.yaml"),
+        ];
+        for (const specPath of possiblePaths) {
+            try {
+                const yamlContent = readFileSync(specPath, "utf-8");
+                return {
+                    contents: [
+                        {
+                            uri: "api://openapi",
+                            mimeType: "text/yaml",
+                            text: yamlContent,
+                        },
+                    ],
+                };
+            }
+            catch {
+                // Try next path
+            }
+        }
+        throw new ResourceError("OpenAPI spec not found. Expected at docs/api/openapi.yaml");
+    }
+    /**
+     * Get works list resource
+     */
+    async getWorksList() {
+        const works = await this.pica.works.list({ limit: 1000 });
+        return {
+            contents: [
+                {
+                    uri: "works://list",
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        total: works.length,
+                        works: works.map((work) => ({
+                            id: work.id,
+                            title: work.title,
+                            work_type: work.work_type,
+                            iswc: work.iswc,
+                            is_verified: work.is_verified,
+                            duration_seconds: work.duration_seconds,
+                        })),
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * Get people list resource
+     */
+    async getPeopleList() {
+        const people = await this.pica.people.list({ limit: 1000 });
+        return {
+            contents: [
+                {
+                    uri: "people://list",
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        total: people.length,
+                        people: people.map((person) => ({
+                            id: person.id,
+                            first_name: person.first_name,
+                            last_name: person.last_name,
+                            email: person.email,
+                            isni: person.isni,
+                            musicbrainz_id: person.musicbrainz_id,
+                        })),
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * Get recordings list resource
+     */
+    async getRecordingsList() {
+        const recordings = await this.pica.recordings.list({ limit: 1000 });
+        return {
+            contents: [
+                {
+                    uri: "recordings://list",
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        total: recordings.length,
+                        recordings: recordings.map((recording) => ({
+                            id: recording.id,
+                            title: recording.title,
+                            isrc: recording.isrc,
+                            duration_seconds: recording.duration_seconds,
+                            work_id: recording.work_id,
+                        })),
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * Get catalog statistics resource
+     */
+    async getCatalogStats() {
+        const [works, people, recordings] = await Promise.all([
+            this.pica.works.list({ limit: 1000 }),
+            this.pica.people.list({ limit: 1000 }),
+            this.pica.recordings.list({ limit: 1000 }),
+        ]);
+        const stats = {
+            overview: {
+                total_works: works.length,
+                total_people: people.length,
+                total_recordings: recordings.length,
+                last_updated: new Date().toISOString(),
+            },
+            works: {
+                total: works.length,
+                verified: works.filter((w) => w.is_verified).length,
+                unverified: works.filter((w) => !w.is_verified).length,
+                with_iswc: works.filter((w) => w.iswc).length,
+                by_type: {
+                    composition: works.filter((w) => w.work_type === "composition")
+                        .length,
+                    arrangement: works.filter((w) => w.work_type === "arrangement")
+                        .length,
+                    adaptation: works.filter((w) => w.work_type === "adaptation").length,
+                    translation: works.filter((w) => w.work_type === "translation")
+                        .length,
+                },
+            },
+            people: {
+                total: people.length,
+                with_email: people.filter((p) => p.email).length,
+                with_isni: people.filter((p) => p.isni).length,
+                with_musicbrainz: people.filter((p) => p.musicbrainz_id).length,
+            },
+            recordings: {
+                total: recordings.length,
+                with_isrc: recordings.filter((r) => r.isrc).length,
+            },
+        };
+        return {
+            contents: [
+                {
+                    uri: "catalog://stats",
+                    mimeType: "application/json",
+                    text: JSON.stringify(stats, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * Get catalog health (PICA Score) resource
+     */
+    async getCatalogHealth() {
+        const score = await this.pica.picaScore.get();
+        return {
+            contents: [
+                {
+                    uri: "catalog://health",
+                    mimeType: "application/json",
+                    text: JSON.stringify(score, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * Get workspace context resource — aggregated orientation for agents
+     */
+    async getWorkspaceContext() {
+        const context = await this.pica.workspace.getContext();
+        return {
+            contents: [
+                {
+                    uri: "workspace://context",
+                    mimeType: "application/json",
+                    text: JSON.stringify(context, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * Get recent events resource — webhook deliveries
+     */
+    async getRecentEvents() {
+        const events = await this.pica.workspace.getRecentEvents(20);
+        return {
+            contents: [
+                {
+                    uri: "events://recent",
+                    mimeType: "application/json",
+                    text: JSON.stringify(events, null, 2),
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAW,MAAM,MAAM,CAAC;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAmBnD,MAAM,OAAO,gBAAgB;IACnB,IAAI,CAAa;IAEzB,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO;YACL;gBACE,GAAG,EAAE,eAAe;gBACpB,IAAI,EAAE,oBAAoB;gBAC1B,WAAW,EACT,4HAA4H;gBAC9H,QAAQ,EAAE,eAAe;aAC1B;YACD;gBACE,GAAG,EAAE,cAAc;gBACnB,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,+CAA+C;gBAC5D,QAAQ,EAAE,kBAAkB;aAC7B;YACD;gBACE,GAAG,EAAE,eAAe;gBACpB,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,oDAAoD;gBACjE,QAAQ,EAAE,kBAAkB;aAC7B;YACD;gBACE,GAAG,EAAE,mBAAmB;gBACxB,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EAAE,6BAA6B;gBAC1C,QAAQ,EAAE,kBAAkB;aAC7B;YACD;gBACE,GAAG,EAAE,iBAAiB;gBACtB,IAAI,EAAE,oBAAoB;gBAC1B,WAAW,EAAE,0CAA0C;gBACvD,QAAQ,EAAE,kBAAkB;aAC7B;YACD;gBACE,GAAG,EAAE,kBAAkB;gBACvB,IAAI,EAAE,6BAA6B;gBACnC,WAAW,EACT,4GAA4G;gBAC9G,QAAQ,EAAE,kBAAkB;aAC7B;YACD;gBACE,GAAG,EAAE,qBAAqB;gBAC1B,IAAI,EAAE,mBAAmB;gBACzB,WAAW,EACT,0GAA0G;gBAC5G,QAAQ,EAAE,kBAAkB;aAC7B;YACD;gBACE,GAAG,EAAE,iBAAiB;gBACtB,IAAI,EAAE,eAAe;gBACrB,WAAW,EACT,2EAA2E;gBAC7E,QAAQ,EAAE,kBAAkB;aAC7B;YACD;gBACE,GAAG,EAAE,eAAe;gBACpB,IAAI,EAAE,uBAAuB;gBAC7B,WAAW,EACT,qHAAqH;gBACvH,QAAQ,EAAE,WAAW;aACtB;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,GAAW;QAC5B,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,eAAe;gBAClB,OAAO;oBACL,QAAQ,EAAE;wBACR;4BACE,GAAG,EAAE,eAAe;4BACpB,QAAQ,EAAE,eAAe;4BACzB,IAAI,EAAE,eAAe;yBACtB;qBACF;iBACF,CAAC;YAEJ,KAAK,cAAc;gBACjB,OAAO,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YAEnC,KAAK,eAAe;gBAClB,OAAO,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAEpC,KAAK,mBAAmB;gBACtB,OAAO,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAExC,KAAK,iBAAiB;gBACpB,OAAO,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YAEtC,KAAK,kBAAkB;gBACrB,OAAO,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAEvC,KAAK,qBAAqB;gBACxB,OAAO,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAE1C,KAAK,iBAAiB;gBACpB,OAAO,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YAEtC,KAAK,eAAe;gBAClB,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC;YAE/B;gBACE,MAAM,IAAI,aAAa,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc;QACpB,2CAA2C;QAC3C,MAAM,aAAa,GAAG;YACpB,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,uBAAuB,CAAC;YAC5C,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,0BAA0B,CAAC;SAChD,CAAC;QAEF,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACpD,OAAO;oBACL,QAAQ,EAAE;wBACR;4BACE,GAAG,EAAE,eAAe;4BACpB,QAAQ,EAAE,WAAW;4BACrB,IAAI,EAAE,WAAW;yBAClB;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,gBAAgB;YAClB,CAAC;QACH,CAAC;QAED,MAAM,IAAI,aAAa,CACrB,2DAA2D,CAC5D,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY;QACxB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1D,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,cAAc;oBACnB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,KAAK,EAAE,KAAK,CAAC,MAAM;wBACnB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;4BAC1B,EAAE,EAAE,IAAI,CAAC,EAAE;4BACX,KAAK,EAAE,IAAI,CAAC,KAAK;4BACjB,SAAS,EAAE,IAAI,CAAC,SAAS;4BACzB,IAAI,EAAE,IAAI,CAAC,IAAI;4BACf,WAAW,EAAE,IAAI,CAAC,WAAW;4BAC7B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;yBACxC,CAAC,CAAC;qBACJ,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAE5D,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,eAAe;oBACpB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,KAAK,EAAE,MAAM,CAAC,MAAM;wBACpB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;4BAC9B,EAAE,EAAE,MAAM,CAAC,EAAE;4BACb,UAAU,EAAE,MAAM,CAAC,UAAU;4BAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;4BAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;4BACnB,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,cAAc,EAAE,MAAM,CAAC,cAAc;yBACtC,CAAC,CAAC;qBACJ,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB;QAC7B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpE,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,mBAAmB;oBACxB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,KAAK,EAAE,UAAU,CAAC,MAAM;wBACxB,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;4BACzC,EAAE,EAAE,SAAS,CAAC,EAAE;4BAChB,KAAK,EAAE,SAAS,CAAC,KAAK;4BACtB,IAAI,EAAE,SAAS,CAAC,IAAI;4BACpB,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;4BAC5C,OAAO,EAAE,SAAS,CAAC,OAAO;yBAC3B,CAAC,CAAC;qBACJ,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe;QAC3B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACpD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;SAC3C,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG;YACZ,QAAQ,EAAE;gBACR,WAAW,EAAE,KAAK,CAAC,MAAM;gBACzB,YAAY,EAAE,MAAM,CAAC,MAAM;gBAC3B,gBAAgB,EAAE,UAAU,CAAC,MAAM;gBACnC,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACvC;YACD,KAAK,EAAE;gBACL,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM;gBACnD,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM;gBACtD,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM;gBAC7C,OAAO,EAAE;oBACP,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,aAAa,CAAC;yBAC5D,MAAM;oBACT,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,aAAa,CAAC;yBAC5D,MAAM;oBACT,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,YAAY,CAAC,CAAC,MAAM;oBACpE,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,aAAa,CAAC;yBAC5D,MAAM;iBACV;aACF;YACD,MAAM,EAAE;gBACN,KAAK,EAAE,MAAM,CAAC,MAAM;gBACpB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM;gBAChD,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM;gBAC9C,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,MAAM;aAChE;YACD,UAAU,EAAE;gBACV,KAAK,EAAE,UAAU,CAAC,MAAM;gBACxB,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM;aACnD;SACF,CAAC;QAEF,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,iBAAiB;oBACtB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;iBACrC;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB;QAC5B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;QAE9C,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,kBAAkB;oBACvB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;iBACrC;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,mBAAmB;QAC/B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAEvD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,qBAAqB;oBAC1B,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvC;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe;QAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAE7D,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,iBAAiB;oBACtB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/resources/llms-primer.d.ts

@@ -0,0 +1,2 @@
+export declare const WITHPICA_PRIMER = "# PICA \u2014 Music Catalog Management Platform\n\nPICA helps music creators and publishers manage their catalog metadata,\ntrack royalties, and prepare works for registration with collection societies.\n\n## Core Entities\n\n### Work\nA musical composition (song, piece, library track). The central entity.\n- Has: title, ISWC, work_type (song/library/demo), genre, mood, BPM, key\n- Relationships: has many credits (writers/composers), has many recordings,\n  has many agreements, may have audio files, may have multimedia\n- Identifiers: ISWC (global), Tunecode (PRS), CAE/IPI (writer)\n\n### Person\nA human involved in music \u2014 writer, composer, performer, producer, publisher.\n- Has: name, email, IPI number, ISNI, MusicBrainz ID, PRO affiliation\n- Relationships: credited on many works, may have recordings, may have agreements\n- Can be enriched via: ISNI, MusicBrainz, Wikidata\n\n### Recording\nA specific audio capture of a work \u2014 the master/sound recording side.\n- Has: title, ISRC, duration, artist, label\n- Relationships: belongs to one work, has credits (performers/producers)\n- Distinct from the work: a work is the composition, a recording is the performance\n\n### Agreement\nA contract governing rights to works \u2014 publishing, sync, distribution.\n- Has: title, type, parties, dates, territory, terms\n- Relationships: covers many works\n- Types: publishing_admin, co_publishing, master_recording, sub_publishing,\n  admin_only, distribution, library_music, production, artist_contract,\n  termination, report, other\n\n### Import Document\nA canonical representation of an ingested file (royalty statement, CSV import).\n- Has: source (16 formats \u2014 PROs: PRS, ASCAP, BMI, SESAC, SOCAN, APRA, GEMA, SACEM; NROs: PPL, SoundExchange, GVL; Mechanical: MCPS; Distributors: DistroKid, TuneCore, CD Baby; Revenue: YouTube Content ID), period, line items, field mappings, warnings\n- Immutable snapshot of the import event \u2014 not a live view\n- Use pica_import_documents_list to find them, pica_import_documents_get to read\n\n## First Connection\n\nIf you're connecting to this workspace for the first time or don't know where to start,\ninvoke the **workspace-autopilot** prompt. It reads the workspace state and routes you\nto the most valuable workflow automatically.\n\n## Recommended Workflows\n\n1. **Catalog audit**: pica_catalog_stats \u2192 pica_works_health \u2192 pica_completeness_low\n2. **Enrichment**: pica_enrichment_candidates \u2192 pica_enrich_work/person \u2192 verify\n3. **Statement reconciliation**: pica_import_documents_list \u2192 pica_import_documents_diff\n4. **Duplicate cleanup**: pica_find_duplicates \u2192 review \u2192 pica_merge_duplicates\n5. **Registration readiness**: pica_registration_coverage \u2192 fix gaps \u2192 pica_export_song_registration\n\n## Key Concepts\n\n- **Organisation**: Multi-tenant \u2014 all data scoped to one org. Never cross org boundaries.\n- **PICA Score**: Composite catalog legibility index (0-100, grade A-F). Four pillars:\n  identification, documentation, registration, completeness.\n- **Enrichment cascade**: When an identifier is added, external sources\n  (MusicBrainz, ISNI, MLC) are queried automatically to fill gaps.\n- **Credits**: Work credits (writers/composers with splits) are distinct from\n  recording credits (performers/producers). Different tables, different role enums.\n  Work credit roles: writer, composer, arranger, lyricist, producer, performer.\n  Recording credit roles: Writer, Composer, Producer, Performer (PascalCase).\n";
+//# sourceMappingURL=llms-primer.d.ts.map

package/dist/resources/llms-primer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-primer.d.ts","sourceRoot":"","sources":["../../src/resources/llms-primer.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,8+GAiE3B,CAAC"}

package/dist/resources/llms-primer.js

@@ -0,0 +1,67 @@
+export const WITHPICA_PRIMER = `# PICA — Music Catalog Management Platform
+
+PICA helps music creators and publishers manage their catalog metadata,
+track royalties, and prepare works for registration with collection societies.
+
+## Core Entities
+
+### Work
+A musical composition (song, piece, library track). The central entity.
+- Has: title, ISWC, work_type (song/library/demo), genre, mood, BPM, key
+- Relationships: has many credits (writers/composers), has many recordings,
+  has many agreements, may have audio files, may have multimedia
+- Identifiers: ISWC (global), Tunecode (PRS), CAE/IPI (writer)
+
+### Person
+A human involved in music — writer, composer, performer, producer, publisher.
+- Has: name, email, IPI number, ISNI, MusicBrainz ID, PRO affiliation
+- Relationships: credited on many works, may have recordings, may have agreements
+- Can be enriched via: ISNI, MusicBrainz, Wikidata
+
+### Recording
+A specific audio capture of a work — the master/sound recording side.
+- Has: title, ISRC, duration, artist, label
+- Relationships: belongs to one work, has credits (performers/producers)
+- Distinct from the work: a work is the composition, a recording is the performance
+
+### Agreement
+A contract governing rights to works — publishing, sync, distribution.
+- Has: title, type, parties, dates, territory, terms
+- Relationships: covers many works
+- Types: publishing_admin, co_publishing, master_recording, sub_publishing,
+  admin_only, distribution, library_music, production, artist_contract,
+  termination, report, other
+
+### Import Document
+A canonical representation of an ingested file (royalty statement, CSV import).
+- Has: source (16 formats — PROs: PRS, ASCAP, BMI, SESAC, SOCAN, APRA, GEMA, SACEM; NROs: PPL, SoundExchange, GVL; Mechanical: MCPS; Distributors: DistroKid, TuneCore, CD Baby; Revenue: YouTube Content ID), period, line items, field mappings, warnings
+- Immutable snapshot of the import event — not a live view
+- Use pica_import_documents_list to find them, pica_import_documents_get to read
+
+## First Connection
+
+If you're connecting to this workspace for the first time or don't know where to start,
+invoke the **workspace-autopilot** prompt. It reads the workspace state and routes you
+to the most valuable workflow automatically.
+
+## Recommended Workflows
+
+1. **Catalog audit**: pica_catalog_stats → pica_works_health → pica_completeness_low
+2. **Enrichment**: pica_enrichment_candidates → pica_enrich_work/person → verify
+3. **Statement reconciliation**: pica_import_documents_list → pica_import_documents_diff
+4. **Duplicate cleanup**: pica_find_duplicates → review → pica_merge_duplicates
+5. **Registration readiness**: pica_registration_coverage → fix gaps → pica_export_song_registration
+
+## Key Concepts
+
+- **Organisation**: Multi-tenant — all data scoped to one org. Never cross org boundaries.
+- **PICA Score**: Composite catalog legibility index (0-100, grade A-F). Four pillars:
+  identification, documentation, registration, completeness.
+- **Enrichment cascade**: When an identifier is added, external sources
+  (MusicBrainz, ISNI, MLC) are queried automatically to fill gaps.
+- **Credits**: Work credits (writers/composers with splits) are distinct from
+  recording credits (performers/producers). Different tables, different role enums.
+  Work credit roles: writer, composer, arranger, lyricist, producer, performer.
+  Recording credit roles: Writer, Composer, Producer, Performer (PascalCase).
+`;
+//# sourceMappingURL=llms-primer.js.map

package/dist/resources/llms-primer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-primer.js","sourceRoot":"","sources":["../../src/resources/llms-primer.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiE9B,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,27 @@
+/**
+ * MCP Server for PICA Platform
+ * Enables AI assistants to interact with PICA via the Model Context Protocol
+ */
+import { ServerConfig } from "./config.js";
+export declare class PicaMcpServer {
+    private server;
+    private pica;
+    private toolRegistry;
+    private resourceRegistry;
+    private promptRegistry;
+    private config;
+    constructor(config: ServerConfig);
+    /**
+     * Set up MCP protocol handlers
+     */
+    private setupHandlers;
+    /**
+     * Start the MCP server
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the MCP server
+     */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,YAAY;IAiChC;;OAEG;IACH,OAAO,CAAC,aAAa;IAsFrB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAI5B"}

package/dist/server.js

@@ -0,0 +1,140 @@
+/**
+ * MCP Server for PICA Platform
+ * Enables AI assistants to interact with PICA via the Model Context Protocol
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { PicaClient } from "./pica-sdk.js";
+import { ToolRegistry } from "./tools/index.js";
+import { ResourceRegistry } from "./resources/index.js";
+import { PromptRegistry } from "./prompts/index.js";
+import { logError } from "./utils/errors.js";
+export class PicaMcpServer {
+    server;
+    pica;
+    toolRegistry;
+    resourceRegistry;
+    promptRegistry;
+    config;
+    constructor(config) {
+        this.config = config;
+        // Initialize PICA SDK client
+        this.pica = new PicaClient({
+            apiKey: config.picaApiKey,
+            baseUrl: config.picaApiUrl,
+            debug: config.debug,
+        });
+        // Initialize MCP server
+        this.server = new Server({
+            name: config.serverName,
+            version: config.version,
+        }, {
+            capabilities: {
+                tools: {},
+                resources: {},
+                prompts: {},
+            },
+        });
+        // Initialize registries
+        this.toolRegistry = new ToolRegistry(this.pica);
+        this.resourceRegistry = new ResourceRegistry(this.pica);
+        this.promptRegistry = new PromptRegistry();
+        this.setupHandlers();
+    }
+    /**
+     * Set up MCP protocol handlers
+     */
+    setupHandlers() {
+        // List available tools
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            if (this.config.debug) {
+                console.log("[MCP Server] Listing tools");
+            }
+            return {
+                tools: this.toolRegistry.listTools(),
+            };
+        });
+        // Execute tool
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args, _meta } = request.params;
+            if (this.config.debug) {
+                console.log(`[MCP Server] Executing tool: ${name}`, args);
+            }
+            // Thread _meta into args for MPP credential passing (credit-gate reads it)
+            const toolArgs = _meta ? { ...(args || {}), _meta } : args || {};
+            try {
+                return await this.toolRegistry.executeTool(name, toolArgs);
+            }
+            catch (error) {
+                logError(`Tool execution: ${name}`, error);
+                throw error;
+            }
+        });
+        // List available resources
+        this.server.setRequestHandler(ListResourcesRequestSchema, async () => {
+            if (this.config.debug) {
+                console.log("[MCP Server] Listing resources");
+            }
+            return {
+                resources: this.resourceRegistry.listResources(),
+            };
+        });
+        // Read resource
+        this.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+            const { uri } = request.params;
+            if (this.config.debug) {
+                console.log(`[MCP Server] Reading resource: ${uri}`);
+            }
+            try {
+                return await this.resourceRegistry.readResource(uri);
+            }
+            catch (error) {
+                logError(`Resource read: ${uri}`, error);
+                throw error;
+            }
+        });
+        // List available prompts
+        this.server.setRequestHandler(ListPromptsRequestSchema, async () => {
+            if (this.config.debug) {
+                console.log("[MCP Server] Listing prompts");
+            }
+            return {
+                prompts: this.promptRegistry.listPrompts(),
+            };
+        });
+        // Get prompt
+        this.server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            if (this.config.debug) {
+                console.log(`[MCP Server] Getting prompt: ${name}`, args);
+            }
+            try {
+                return await this.promptRegistry.getPrompt(name, args);
+            }
+            catch (error) {
+                logError(`Prompt get: ${name}`, error);
+                throw error;
+            }
+        });
+    }
+    /**
+     * Start the MCP server
+     */
+    async start() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error("[MCP Server] PICA MCP Server started");
+        console.error(`[MCP Server] Version: ${this.config.version}`);
+        console.error(`[MCP Server] API URL: ${this.config.picaApiUrl}`);
+        console.error("[MCP Server] Ready to accept connections");
+    }
+    /**
+     * Stop the MCP server
+     */
+    async stop() {
+        await this.server.close();
+        console.error("[MCP Server] Server stopped");
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/agreement-types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Agreement Types Tools — templates, producer agreements, and work-for-hire
+ *
+ * Groups three related agreement sub-types that extend the core agreements system:
+ * - Templates: reusable agreement blueprints that can be rendered with real data
+ * - Producer agreements: advance + points deals with recoupment tracking
+ * - Work-for-hire: flat-fee contracts where all rights are assigned
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class AgreementTypesTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listTemplates;
+    private getTemplate;
+    private createTemplate;
+    private updateTemplate;
+    private deleteTemplate;
+    private renderTemplate;
+    private duplicateTemplate;
+    private setDefaultTemplate;
+    private listProducerAgreements;
+    private getProducerAgreement;
+    private createProducerAgreement;
+    private updateProducerAgreement;
+    private deleteProducerAgreement;
+    private listWorkForHire;
+    private getWorkForHire;
+    private createWorkForHire;
+    private updateWorkForHire;
+    private deleteWorkForHire;
+}
+//# sourceMappingURL=agreement-types.d.ts.map

package/dist/tools/agreement-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agreement-types.d.ts","sourceRoot":"","sources":["../../src/tools/agreement-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAOtE,qBAAa,mBAAmB;IAC9B,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;YAigB3D,aAAa;YAKb,WAAW;YAKX,cAAc;YAKd,cAAc;YAMd,cAAc;YAKd,cAAc;YAMd,iBAAiB;YAOjB,kBAAkB;YASlB,sBAAsB;YAKtB,oBAAoB;YAOpB,uBAAuB;YAOvB,uBAAuB;YAQvB,uBAAuB;YASvB,eAAe;YAKf,cAAc;YAKd,iBAAiB;YAOjB,iBAAiB;YAQjB,iBAAiB;CAMhC"}