@withpica/mcp-server 2.1.0

package/dist/tools/registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.js","sourceRoot":"","sources":["../../src/tools/registration.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,OAAO,iBAAiB;IACpB,IAAI,CAAa;IAEzB,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,QAAQ;QACN,OAAO;YACL;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,4BAA4B;oBAClC,WAAW,EACT,0GAA0G;wBAC1G,sHAAsH;oBACxH,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE,EAAE;qBACf;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;aAC/C;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,+BAA+B;oBACrC,WAAW,EACT,iHAAiH;oBACnH,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,OAAO,EAAE;gCACP,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,8CAA8C;6BAC5D;yBACF;wBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;qBACtB;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC;aACjD;SACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAChC,KAA0B;QAE1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;QAC1D,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAEO,KAAK,CAAC,sBAAsB,CAClC,IAAyB;QAEzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,oBAAoB,CAC9D,IAAI,CAAC,OAAO,CACb,CAAC;QACF,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/tools/releases.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Releases Tools — manage releases (albums, EPs, singles with release dates, labels, and UPCs)
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class ReleasesTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listReleases;
+    private getRelease;
+    private createRelease;
+    private updateRelease;
+}
+//# sourceMappingURL=releases.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"releases.d.ts","sourceRoot":"","sources":["../../src/tools/releases.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YA8G3D,YAAY;YAQZ,UAAU;YAKV,aAAa;YAMb,aAAa;CAK5B"}

package/dist/tools/releases.js

@@ -0,0 +1,138 @@
+/**
+ * Releases Tools — manage releases (albums, EPs, singles with release dates, labels, and UPCs)
+ */
+import { formatSuccess, formatStructuredList } from "../utils/formatting.js";
+export class ReleasesTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_releases_list",
+                    description: "List releases — albums, EPs, and singles with release dates, labels, and UPCs.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            limit: {
+                                type: "number",
+                                description: "Max results to return (default 50)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listReleases.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_releases_get",
+                    description: "Get release details including tracks.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Release ID" },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.getRelease.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_releases_create",
+                    description: "Create a new release — set the title, date, format, label, and UPC.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            title: {
+                                type: "string",
+                                description: "Release title",
+                            },
+                            release_date: {
+                                type: "string",
+                                description: "Release date (YYYY-MM-DD)",
+                            },
+                            format: {
+                                type: "string",
+                                description: "Release format (e.g. album, ep, single)",
+                            },
+                            upc: {
+                                type: "string",
+                                description: "Universal Product Code (UPC/EAN barcode)",
+                            },
+                            label: {
+                                type: "string",
+                                description: "Record label name",
+                            },
+                            catalog_number: {
+                                type: "string",
+                                description: "Label catalog number",
+                            },
+                        },
+                        required: ["title"],
+                    },
+                },
+                executor: this.createRelease.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_releases_update",
+                    description: "Update release details — title, date, format, label, UPC, or catalog number.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Release ID" },
+                            title: { type: "string", description: "Updated title" },
+                            release_date: {
+                                type: "string",
+                                description: "Updated release date (YYYY-MM-DD)",
+                            },
+                            format: {
+                                type: "string",
+                                description: "Updated format",
+                            },
+                            upc: {
+                                type: "string",
+                                description: "Updated UPC",
+                            },
+                            label: {
+                                type: "string",
+                                description: "Updated label",
+                            },
+                            catalog_number: {
+                                type: "string",
+                                description: "Updated catalog number",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.updateRelease.bind(this),
+            },
+        ];
+    }
+    async listReleases(args) {
+        const result = await this.pica.releases.list({
+            limit: args.limit,
+        });
+        const releases = Array.isArray(result) ? result : [];
+        return formatStructuredList(releases, "release");
+    }
+    async getRelease(args) {
+        const release = await this.pica.releases.get(args.id);
+        return formatSuccess("Release retrieved", release);
+    }
+    async createRelease(args) {
+        const { id, ...data } = args;
+        const release = await this.pica.releases.create(data);
+        return formatSuccess("Release created", release);
+    }
+    async updateRelease(args) {
+        const { id, ...updates } = args;
+        const release = await this.pica.releases.update(id, updates);
+        return formatSuccess("Release updated", release);
+    }
+}
+//# sourceMappingURL=releases.js.map

package/dist/tools/releases.js.map

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

package/dist/tools/royalties.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Royalties & Statements MCP Tools — ADR-139 Step 2
+ *
+ * Un-cuts the royalty data layer that was archived in the March 2026
+ * UI simplification. The API routes and services still exist — these
+ * tools expose them to AI assistants.
+ */
+import { PicaClient } from "../pica-sdk.js";
+import type { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class RoyaltiesTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listPayments;
+    private getEarnings;
+    private getGaps;
+    private listStatements;
+    private getStatement;
+}
+//# sourceMappingURL=royalties.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"royalties.d.ts","sourceRoot":"","sources":["../../src/tools/royalties.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAO3E,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;YAsL3D,YAAY;YA2BZ,WAAW;YAWX,OAAO;YAkCP,cAAc;YAiBd,YAAY;CAW3B"}

package/dist/tools/royalties.js

@@ -0,0 +1,263 @@
+/**
+ * Royalties & Statements MCP Tools — ADR-139 Step 2
+ *
+ * Un-cuts the royalty data layer that was archived in the March 2026
+ * UI simplification. The API routes and services still exist — these
+ * tools expose them to AI assistants.
+ */
+import { formatSuccess, formatAsText, } from "../utils/formatting.js";
+export class RoyaltiesTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_royalties_list",
+                    description: "List royalty payment records with optional filters. " +
+                        "Returns individual payment entries from imported statements.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            source: {
+                                type: "string",
+                                description: "Filter by payment source: prs, ppl, mcps, ascap, bmi, sesac, " +
+                                    "spotify, apple_music, youtube, distrokid, tunecore, cdbaby, etc.",
+                            },
+                            work_id: {
+                                type: "string",
+                                description: "Filter by work ID (UUID)",
+                            },
+                            from_date: {
+                                type: "string",
+                                description: "Filter payments from date (ISO format YYYY-MM-DD)",
+                            },
+                            to_date: {
+                                type: "string",
+                                description: "Filter payments to date (ISO format YYYY-MM-DD)",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Number of results (default 50, max 100)",
+                            },
+                            offset: {
+                                type: "number",
+                                description: "Pagination offset (default 0)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listPayments.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_royalties_get",
+                    description: "Get detailed earnings summary with breakdown by source and tax category. " +
+                        "Includes recent payment records and pagination. " +
+                        "Use this for questions like 'how much did I earn?' or 'what are my earnings?'.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            start_date: {
+                                type: "string",
+                                description: "Filter from date (ISO format YYYY-MM-DD)",
+                            },
+                            end_date: {
+                                type: "string",
+                                description: "Filter to date (ISO format YYYY-MM-DD)",
+                            },
+                            source: {
+                                type: "string",
+                                description: "Filter by source (prs, ppl, spotify, etc.)",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Number of recent payments to return (default 50)",
+                            },
+                        },
+                    },
+                },
+                executor: this.getEarnings.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_royalties_summary",
+                    description: "Get royalty gap analysis — identifies missing registrations, " +
+                        "unlinked credits, and payment gaps. Answers questions like " +
+                        "'what am I missing?' or 'where should I register?'.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            priority: {
+                                type: "string",
+                                description: "Filter by priority: high, medium, low",
+                            },
+                            gap_type: {
+                                type: "string",
+                                description: "Filter by gap type: prs_missing, ppl_missing, mcps_missing, " +
+                                    "spotify_missing, isrc_missing, iswc_missing, tunecode_missing, " +
+                                    "payment_missing, credit_unlinked",
+                            },
+                            work_id: {
+                                type: "string",
+                                description: "Filter gaps for a specific work",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Number of gaps to return (default 20)",
+                            },
+                        },
+                    },
+                },
+                executor: this.getGaps.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_statements_list",
+                    description: "List past statement imports — shows which PRO/NRO statements " +
+                        "have been imported and when. Supported sources: PRS, PPL, MCPS, " +
+                        "ASCAP, BMI, SESAC, SoundExchange, SOCAN, APRA.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            source: {
+                                type: "string",
+                                description: "Filter by source (prs, ppl, ascap, etc.)",
+                            },
+                            date_from: {
+                                type: "string",
+                                description: "Filter imports after this date (ISO format)",
+                            },
+                            date_to: {
+                                type: "string",
+                                description: "Filter imports before this date (ISO format)",
+                            },
+                            search: {
+                                type: "string",
+                                description: "Search by filename",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Number of results (default 20, max 50)",
+                            },
+                            offset: {
+                                type: "number",
+                                description: "Pagination offset",
+                            },
+                            sort: {
+                                type: "string",
+                                description: "Sort order: newest (default) or oldest",
+                            },
+                        },
+                    },
+                },
+                executor: this.listStatements.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_statements_get",
+                    description: "Get details of a specific statement import batch, including " +
+                        "line items with per-work/territory breakdowns.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            batch_id: {
+                                type: "string",
+                                description: "The import batch ID (UUID)",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Number of line items to return (default 50, max 100)",
+                            },
+                            offset: {
+                                type: "number",
+                                description: "Pagination offset for line items",
+                            },
+                        },
+                        required: ["batch_id"],
+                    },
+                },
+                executor: this.getStatement.bind(this),
+            },
+        ];
+    }
+    async listPayments(args) {
+        const data = await this.pica.royalties.payments({
+            source: args.source,
+            workId: args.work_id,
+            fromDate: args.from_date,
+            toDate: args.to_date,
+            limit: args.limit || 50,
+            offset: args.offset || 0,
+        });
+        const hints = [];
+        if (!data?.length) {
+            hints.push({
+                gap: "no_payments",
+                suggestion: "Import a royalty statement to start tracking earnings (upload a PRS/PPL/ASCAP CSV)",
+                severity: "important",
+            });
+        }
+        return formatSuccess(`Found ${data?.length || 0} payment records`, data, hints);
+    }
+    async getEarnings(args) {
+        const data = await this.pica.royalties.earnings({
+            start_date: args.start_date,
+            end_date: args.end_date,
+            source: args.source,
+            limit: args.limit || 50,
+        });
+        return formatSuccess("Earnings summary", data);
+    }
+    async getGaps(args) {
+        const data = await this.pica.royalties.gaps({
+            priority: args.priority,
+            gapType: args.gap_type,
+            workId: args.work_id,
+            limit: args.limit || 20,
+        });
+        const hints = [];
+        const gaps = Array.isArray(data) ? data : [];
+        const prsGaps = gaps.filter((g) => g.gap_type === "prs_missing");
+        if (prsGaps.length > 0) {
+            hints.push({
+                gap: "prs_missing",
+                suggestion: `Register ${prsGaps.length} work(s) with PRS (pica_registration_coverage)`,
+                count: prsGaps.length,
+                severity: "critical",
+            });
+        }
+        const isrcGaps = gaps.filter((g) => g.gap_type === "isrc_missing");
+        if (isrcGaps.length > 0) {
+            hints.push({
+                gap: "isrc_missing",
+                suggestion: `Add ISRCs to ${isrcGaps.length} recording(s) for royalty tracking`,
+                count: isrcGaps.length,
+                severity: "important",
+            });
+        }
+        return formatSuccess(`Found ${gaps.length} royalty gaps`, data, hints);
+    }
+    async listStatements(args) {
+        const data = await this.pica.statements.history({
+            source: args.source,
+            dateFrom: args.date_from,
+            dateTo: args.date_to,
+            search: args.search,
+            limit: args.limit || 20,
+            offset: args.offset || 0,
+            sort: args.sort,
+        });
+        return formatSuccess(`Found ${data?.imports?.length || data?.total || 0} statement imports`, data);
+    }
+    async getStatement(args) {
+        if (!args.batch_id) {
+            return formatAsText({ error: "batch_id is required" });
+        }
+        const data = await this.pica.statements.get(args.batch_id);
+        return formatSuccess(`Statement batch: ${data?.sourceName || data?.source || "unknown"} — ${data?.lineItemCount || 0} line items`, data);
+    }
+}
+//# sourceMappingURL=royalties.js.map

package/dist/tools/royalties.js.map

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

package/dist/tools/search.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Search Tools - MCP tools for searching across all entities
+ *
+ * Uses the chain service for unified fuzzy search with pg_trgm across
+ * works, people, recordings, physical assets, audio files, and work sessions.
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class SearchTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    /**
+     * Unified search via chain service — single request, all entity types,
+     * fuzzy matching with pg_trgm, ranked by similarity.
+     */
+    private searchAll;
+    /**
+     * Get catalog statistics (uses dedicated SQL count endpoint, no pagination limits)
+     */
+    private getCatalogStats;
+    /**
+     * Traverse the global identity graph from any identifier
+     */
+    private graphTraverse;
+}
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,qBAAa,WAAW;IACtB,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;IAsEzE;;;OAGG;YACW,SAAS;IASvB;;OAEG;YACW,eAAe;IAO7B;;OAEG;YACW,aAAa;CAoB5B"}

package/dist/tools/search.js

@@ -0,0 +1,117 @@
+/**
+ * Search Tools - MCP tools for searching across all entities
+ *
+ * Uses the chain service for unified fuzzy search with pg_trgm across
+ * works, people, recordings, physical assets, audio files, and work sessions.
+ */
+import { formatAsText, formatSuccess } from "../utils/formatting.js";
+export class SearchTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_search_all",
+                    description: "Fuzzy search across the entire catalog: works, people, recordings, physical assets, audio files, studio sessions, agreements, multimedia, and releases. " +
+                        "Supports free text, ISRC, ISWC, and IPI lookups. Returns ranked results with the top match expanded to full chain detail. " +
+                        "→ then: pica_works_get_full (work details), pica_people_get_full (person details), pica_recordings_get (recording details)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            query: {
+                                type: "string",
+                                description: "Search query — free text, ISRC, ISWC, or IPI number",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Maximum results (default: 10, max: 50)",
+                            },
+                            expand_first: {
+                                type: "boolean",
+                                description: "Expand the top result to full chain detail (default: true)",
+                            },
+                        },
+                        required: ["query"],
+                    },
+                },
+                executor: this.searchAll.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_catalog_stats",
+                    description: "Get statistics about the catalog (total counts, etc.)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.getCatalogStats.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_graph_traverse",
+                    description: "Traverse the global identity graph from any identifier (IPI, ISNI, ISRC, ISWC, MusicBrainz UUID). " +
+                        "Returns the canonical global entity + all connected works, recordings, creators, and publishers across the graph. " +
+                        "Also shows which entities exist in your catalog. " +
+                        "Use this to answer: 'show me everything connected to this IPI/ISRC/ISWC' or 'what else has this person written?'\n\n" +
+                        "→ then: pica_works_get_full (deep-dive a work), pica_enrich_work (enrich a discovered work)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            identifier: {
+                                type: "string",
+                                description: "The identifier to traverse from. Supports: IPI (9-11 digits), ISNI (16 digits), " +
+                                    "ISRC (e.g. GBUM71804829), ISWC (e.g. T-123.456.789-0), MusicBrainz UUID.",
+                            },
+                        },
+                        required: ["identifier"],
+                    },
+                },
+                executor: this.graphTraverse.bind(this),
+            },
+        ];
+    }
+    /**
+     * Unified search via chain service — single request, all entity types,
+     * fuzzy matching with pg_trgm, ranked by similarity.
+     */
+    async searchAll(args) {
+        const result = await this.pica.chain.search({
+            q: args.query,
+            limit: args.limit,
+            expand_first: args.expand_first,
+        });
+        return formatAsText(result);
+    }
+    /**
+     * Get catalog statistics (uses dedicated SQL count endpoint, no pagination limits)
+     */
+    async getCatalogStats(_args) {
+        const stats = await this.pica.catalogStats();
+        return formatAsText(stats);
+    }
+    /**
+     * Traverse the global identity graph from any identifier
+     */
+    async graphTraverse(args) {
+        const result = await this.pica.chain.traverse(args.identifier);
+        const data = result.data || result;
+        if (!data.global_entity) {
+            return formatAsText({
+                message: `No entity found in the global identity graph for identifier "${args.identifier}" (detected type: ${data.identifier_type}).`,
+                hint: "Check the identifier format. IPI = 9-11 digits, ISNI = 16 digits, ISRC = 12 chars (e.g. GBUM71804829), ISWC = T + 10 digits.",
+            });
+        }
+        const summary = [
+            `Found ${data.global_entity.type}: ${data.global_entity.name}`,
+            `Identifier type: ${data.identifier_type}`,
+            `Connected: ${data.connected.works.length} works, ${data.connected.recordings.length} recordings, ${data.connected.creators.length} creators, ${data.connected.publishers.length} publishers`,
+            `In your catalog: ${data.org_matches.works} works, ${data.org_matches.people} people, ${data.org_matches.recordings} recordings`,
+        ].join("\n");
+        return formatSuccess(summary, data);
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAErE,MAAM,OAAO,WAAW;IACd,IAAI,CAAa;IAEzB,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,QAAQ;QACN,OAAO;YACL;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,iBAAiB;oBACvB,WAAW,EACT,0JAA0J;wBAC1J,4HAA4H;wBAC5H,4HAA4H;oBAC9H,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,qDAAqD;6BACxD;4BACD,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,wCAAwC;6BACtD;4BACD,YAAY,EAAE;gCACZ,IAAI,EAAE,SAAS;gCACf,WAAW,EACT,4DAA4D;6BAC/D;yBACF;wBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;qBACpB;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;aACpC;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,oBAAoB;oBAC1B,WAAW,EAAE,uDAAuD;oBACpE,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE,EAAE;qBACf;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;aAC1C;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,qBAAqB;oBAC3B,WAAW,EACT,oGAAoG;wBACpG,oHAAoH;wBACpH,mDAAmD;wBACnD,sHAAsH;wBACtH,6FAA6F;oBAC/F,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,UAAU,EAAE;gCACV,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,kFAAkF;oCAClF,0EAA0E;6BAC7E;yBACF;wBACD,QAAQ,EAAE,CAAC,YAAY,CAAC;qBACzB;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;aACxC;SACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,SAAS,CAAC,IAAyB;QAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YAC1C,CAAC,EAAE,IAAI,CAAC,KAAK;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;QACH,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAC3B,KAA0B;QAE1B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7C,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CAAC,IAAyB;QACnD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAoB,CAAC,CAAC;QACzE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC;QAEnC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,OAAO,YAAY,CAAC;gBAClB,OAAO,EAAE,gEAAgE,IAAI,CAAC,UAAU,qBAAqB,IAAI,CAAC,eAAe,IAAI;gBACrI,IAAI,EAAE,8HAA8H;aACrI,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAG;YACd,SAAS,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE;YAC9D,oBAAoB,IAAI,CAAC,eAAe,EAAE;YAC1C,cAAc,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,WAAW,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,gBAAgB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,cAAc,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,aAAa;YAC7L,oBAAoB,IAAI,CAAC,WAAW,CAAC,KAAK,WAAW,IAAI,CAAC,WAAW,CAAC,MAAM,YAAY,IAAI,CAAC,WAAW,CAAC,UAAU,aAAa;SACjI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/tools/send.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Send Tools - MCP tools for sending messages, invites, and file requests through PICA's Send Hub
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class SendTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private sendMessage;
+    private listSent;
+    private listPending;
+    private resendItem;
+}
+//# sourceMappingURL=send.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../src/tools/send.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAOtE,qBAAa,SAAS;IACpB,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;YAiK3D,WAAW;YAKX,QAAQ;YAeR,WAAW;YAKX,UAAU;CAIzB"}