@withpica/mcp-server 2.7.0 → 2.8.0

package/dist/tools/documents.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Document Tools - MCP tools for document AI analysis
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class DocumentTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private analyseDocument;
+}
+//# sourceMappingURL=documents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/tools/documents.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,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;YAyB3D,eAAe;CAM9B"}

package/dist/tools/documents.js

@@ -0,0 +1,36 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatSuccess } from "@withpica/mcp-utils";
+export class DocumentTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_documents_analyse",
+                    description: "Trigger AI analysis on an uploaded document. Extracts metadata such as document type, " +
+                        "agreement terms, parties, dates, and key fields. Uses AI when available (credit-gated), " +
+                        "falls back to rule-based extraction otherwise. Upload documents first with pica_upload_file + pica_upload_complete.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Document ID to analyse",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.analyseDocument.bind(this),
+            },
+        ];
+    }
+    async analyseDocument(args) {
+        const result = await this.pica.documents.analyse(args.id);
+        return formatSuccess(`Document ${args.id} analysed successfully.`, result);
+    }
+}
+//# sourceMappingURL=documents.js.map

package/dist/tools/documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAQ7D,OAAO,EAAE,aAAa,EAAgB,MAAM,qBAAqB,CAAC;AAElE,MAAM,OAAO,aAAa;IAChB,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,wBAAwB;oBAC9B,WAAW,EACT,wFAAwF;wBACxF,0FAA0F;wBAC1F,qHAAqH;oBACvH,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,EAAE,EAAE;gCACF,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,wBAAwB;6BACtC;yBACF;wBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;qBACjB;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;aAC1C;SACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,eAAe,CAC3B,IAAyB;QAEzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1D,OAAO,aAAa,CAAC,YAAY,IAAI,CAAC,EAAE,yBAAyB,EAAE,MAAM,CAAC,CAAC;IAC7E,CAAC;CACF"}

package/dist/tools/duplicates.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Duplicate Detection & Merge Tools - MCP tools for finding and merging duplicates
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class DuplicatesTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private findDuplicates;
+    private mergeDuplicates;
+}
+//# sourceMappingURL=duplicates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duplicates.d.ts","sourceRoot":"","sources":["../../src/tools/duplicates.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAOtE,qBAAa,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;YAuD3D,cAAc;YAKd,eAAe;CAsC9B"}

package/dist/tools/duplicates.js

@@ -0,0 +1,87 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatAsText, formatSuccess, formatValidationError, } from "@withpica/mcp-utils";
+export class DuplicatesTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_find_duplicates",
+                    description: "Detect duplicate works or people in the catalog by exact title/name match. Returns groups of duplicates with suggested winners. " +
+                        "→ then: pica_merge_duplicates (merge confirmed duplicates)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            entity_type: {
+                                type: "string",
+                                enum: ["works", "people"],
+                                description: "Type of entity to check for duplicates",
+                            },
+                        },
+                        required: ["entity_type"],
+                    },
+                },
+                executor: this.findDuplicates.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_merge_duplicates",
+                    description: "Merge duplicate works or people into a single winner. Moves all credits, recordings, agreements, and metadata to the winner. Requires admin scope.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            entity_type: {
+                                type: "string",
+                                enum: ["work", "person"],
+                                description: "Type of entity to merge",
+                            },
+                            winner_id: {
+                                type: "string",
+                                description: "ID of the entity to keep (all data will be merged into this one)",
+                            },
+                            loser_ids: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "IDs of duplicate entities to merge into the winner and then delete",
+                            },
+                        },
+                        required: ["entity_type", "winner_id", "loser_ids"],
+                    },
+                },
+                executor: this.mergeDuplicates.bind(this),
+            },
+        ];
+    }
+    async findDuplicates(args) {
+        const result = await this.pica.duplicates.findDuplicates(args.entity_type);
+        return formatAsText(result);
+    }
+    async mergeDuplicates(args) {
+        if (!args.loser_ids?.length) {
+            return formatValidationError({ loser_ids: "must be a non-empty array" });
+        }
+        const loserIds = args.loser_ids;
+        if (loserIds && loserIds.length > 25) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "VALIDATION_ERROR",
+                            message: `maximum 25 loser IDs per merge — received ${loserIds.length}`,
+                            retry_safe: false,
+                            suggestion: "split into multiple merge operations with 25 or fewer IDs each",
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const result = await this.pica.duplicates.merge(args.entity_type, args.winner_id, args.loser_ids);
+        return formatSuccess(`Merged ${args.loser_ids.length} duplicate ${args.entity_type}(s) into ${args.winner_id}`, result);
+    }
+}
+//# sourceMappingURL=duplicates.js.map

package/dist/tools/duplicates.js.map

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

package/dist/tools/enrichment.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Enrichment Tools - MCP tools for triggering and checking enrichment
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class EnrichmentTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private enrichmentCandidates;
+    private enrichWorkMlc;
+    private enrichWorkMusicBrainz;
+    private enrichWorkDiscogs;
+    private enrichWorkSpotify;
+    private enrichWorkYouTube;
+}
+//# sourceMappingURL=enrichment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enrichment.d.ts","sourceRoot":"","sources":["../../src/tools/enrichment.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAKtE,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;YAgJ3D,oBAAoB;YAOpB,aAAa;YAKb,qBAAqB;YASrB,iBAAiB;YAOjB,iBAAiB;YAuBjB,iBAAiB;CAMhC"}

package/dist/tools/enrichment.js

@@ -0,0 +1,154 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatAsText, formatSuccess } from "@withpica/mcp-utils";
+import { withCreditGate, withBillingGate } from "@withpica/mcp-utils";
+import { formatEnrichmentResult } from "@withpica/mcp-utils";
+export class EnrichmentTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_enrichment_candidates",
+                    description: "Find works and people that are candidates for enrichment (missing external identifiers or metadata). " +
+                        "→ then: pica_enrich_work_spotify (enrich from Spotify), pica_enrich_work_mlc (enrich from MLC)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.enrichmentCandidates.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_enrich_work_mlc",
+                    description: "Check MLC (Mechanical Licensing Collective) for publishing details on a work — writers, publishers, and splits. " +
+                        "Use this when you want to find out if a work has publishing registrations. Costs 1 pica credit.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to check MLC for",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: withBillingGate(this.pica, "MLC lookup", withCreditGate(this.pica, "external_mlc_lookup", "MLC lookup", this.enrichWorkMlc.bind(this))),
+            },
+            {
+                definition: {
+                    name: "pica_enrich_work_musicbrainz",
+                    description: "Look up MusicBrainz for release data, artist info, and cross-references for a work. " +
+                        "Returns release data, artist info, and cross-references.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to look up on MusicBrainz",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: withBillingGate(this.pica, "MusicBrainz lookup", this.enrichWorkMusicBrainz.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_enrich_work_discogs",
+                    description: "Search Discogs for release data, label, format, and catalogue numbers for a work. " +
+                        "Returns a preview of matches.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to search Discogs for",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: withBillingGate(this.pica, "Discogs lookup", this.enrichWorkDiscogs.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_enrich_work_spotify",
+                    description: "Enrich a work from Spotify — pulls track metadata, popularity, and streaming data. " +
+                        "Optionally pass spotify_url to link the track URI before enriching. " +
+                        "→ then: pica_works_inspect (check what changed), pica_credits_update (add credits)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to enrich from Spotify",
+                            },
+                            spotify_url: {
+                                type: "string",
+                                description: "Optional Spotify URL or URI to link before enriching",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: withBillingGate(this.pica, "Spotify enrichment", this.enrichWorkSpotify.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_enrich_work_youtube",
+                    description: "Enrich a work from YouTube — pulls view count, like count, channel info, and video duration. " +
+                        "The work must already have a youtube_video_id linked.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to enrich from YouTube",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: withBillingGate(this.pica, "YouTube enrichment", this.enrichWorkYouTube.bind(this)),
+            },
+        ];
+    }
+    async enrichmentCandidates(_args) {
+        const result = await this.pica.enrichment.getCandidates();
+        return formatAsText(result);
+    }
+    async enrichWorkMlc(args) {
+        const result = await this.pica.enrichment.enrichWorkMlc(args.work_id);
+        return formatEnrichmentResult("work", args.work_id, "MLC", result);
+    }
+    async enrichWorkMusicBrainz(args) {
+        const result = await this.pica.enrichment.enrichWorkMusicBrainz(args.work_id);
+        return formatEnrichmentResult("work", args.work_id, "MusicBrainz", result);
+    }
+    async enrichWorkDiscogs(args) {
+        const result = await this.pica.enrichment.enrichWorkDiscogs(args.work_id);
+        return formatEnrichmentResult("work", args.work_id, "Discogs", result);
+    }
+    async enrichWorkSpotify(args) {
+        const workId = args.work_id;
+        const spotifyUrl = args.spotify_url;
+        // If spotify_url provided, link it to the work first, then enrich
+        if (spotifyUrl) {
+            const result = await this.pica.enrichment.linkAndEnrichSpotify(workId, spotifyUrl);
+            return formatSuccess(`Linked Spotify track and enriched work ${workId}`, result);
+        }
+        // work_id only — enrich from already-linked Spotify data
+        const result = await this.pica.enrichment.enrichWorkSpotify(workId);
+        return formatEnrichmentResult("work", workId, "Spotify", result);
+    }
+    async enrichWorkYouTube(args) {
+        const result = await this.pica.enrichment.enrichWorkYouTube(args.work_id);
+        return formatEnrichmentResult("work", args.work_id, "YouTube", result);
+    }
+}
+//# sourceMappingURL=enrichment.js.map

package/dist/tools/enrichment.js.map

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

package/dist/tools/exports.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Export Tools - MCP tools for exporting catalog data
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class ExportTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private exportCatalogCsv;
+    private exportSongRegistration;
+    private exportIndustryReady;
+    private exportCatalogAssetReport;
+    private exportAiConsent;
+}
+//# sourceMappingURL=exports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../src/tools/exports.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAItE,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;YAmI3D,gBAAgB;YAShB,sBAAsB;YAuBtB,mBAAmB;YAOnB,wBAAwB;YAgDxB,eAAe;CAS9B"}

package/dist/tools/exports.js

@@ -0,0 +1,175 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatAsText, formatSuccess } from "@withpica/mcp-utils";
+import { withCreditGate, withBillingGate } from "@withpica/mcp-utils";
+export class ExportTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_export_catalog_csv",
+                    description: "Export the full works catalog as CSV data",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            format: {
+                                type: "string",
+                                enum: ["csv", "json"],
+                                description: "Export format (default: csv)",
+                            },
+                        },
+                    },
+                },
+                executor: this.exportCatalogCsv.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_export_song_registration",
+                    description: "Export catalog in song registration format (CWR-compatible) for PRO/CMO registration. Costs 1 pica credit.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: withBillingGate(this.pica, "song registration export", withCreditGate(this.pica, "export_song_registration", "song registration export", this.exportSongRegistration.bind(this))),
+            },
+            {
+                definition: {
+                    name: "pica_export_industry_ready",
+                    description: "Export industry-ready metadata package — formatted for distribution to publishers, labels, and sync agents. Costs 1 pica credit.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: withBillingGate(this.pica, "industry-ready export", withCreditGate(this.pica, "export_industry_csv", "industry-ready export", this.exportIndustryReady.bind(this))),
+            },
+            {
+                definition: {
+                    name: "pica_export_catalog_asset_report",
+                    description: "Generate a Catalog Asset Report (CAR) — a unified ZIP bundle with cover PDF, evidence folders, and integrity manifest. Maps creative portfolio data to property-lending equivalents for financial institutions, insurers, PROs, and distributors. Sections include: ownership (title deed equivalent), valuation (surveyor's report), physical assets (contents schedule), agreements (mortgage deed), catalog intelligence (condition report), and summary with equivalence map. Costs 5 pica credits. Check pica_credits_balance first.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            sections: {
+                                type: "object",
+                                description: "Which sections to include in the export. Ownership is always included.",
+                                properties: {
+                                    valuation: {
+                                        type: "boolean",
+                                        description: "Include earnings, audio intelligence, DSP presence, completeness scores",
+                                    },
+                                    assets: {
+                                        type: "boolean",
+                                        description: "Include physical asset register with insurance and valuations",
+                                    },
+                                    agreements: {
+                                        type: "boolean",
+                                        description: "Include agreements structure and AI consent status",
+                                    },
+                                    intelligence: {
+                                        type: "boolean",
+                                        description: "Include gap analysis, carbon footprint, diligence readiness",
+                                    },
+                                    audio: {
+                                        type: "boolean",
+                                        description: "Include audio master files (large, opt-in)",
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+                executor: withBillingGate(this.pica, "catalog asset report", withCreditGate(this.pica, "export_catalog_asset_report", "catalog asset report", this.exportCatalogAssetReport.bind(this))),
+            },
+            {
+                definition: {
+                    name: "pica_export_ai_consent",
+                    description: "Export AI usage consent declarations for all works — " +
+                        "shows which works are human-made, AI-assisted, or AI-generated, " +
+                        "with contributor-level consent tracking for AI model training and licensing.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.exportAiConsent.bind(this),
+            },
+        ];
+    }
+    async exportCatalogCsv(args) {
+        const result = await this.pica.exports.catalogCsv({
+            format: args.format,
+        });
+        return formatAsText(result);
+    }
+    async exportSongRegistration(_args) {
+        const result = await this.pica.exports.songRegistration();
+        const data = result?.data ?? result;
+        // ADR-146: Surface export gate warnings
+        const parts = ["Song registration export generated"];
+        if (data?.exportReadiness?.blockers?.length > 0) {
+            parts.push(`\n--- export gate (${data.exportReadiness.mode} mode) ---`);
+            for (const b of data.exportReadiness.blockers) {
+                parts.push(`${b.type}: ${b.workTitle} — ${b.resolutionHint}`);
+            }
+            if (data.exportReadiness.mode === "advisory") {
+                parts.push("These issues will block export when enforcement mode is enabled.");
+            }
+        }
+        return formatSuccess(parts.join("\n"), data);
+    }
+    async exportIndustryReady(_args) {
+        const result = await this.pica.exports.industryReady();
+        return formatSuccess("Industry-ready export generated", result);
+    }
+    async exportCatalogAssetReport(args) {
+        const sections = {
+            ownership: true,
+            valuation: args.sections?.valuation ?? true,
+            assets: args.sections?.assets ?? true,
+            agreements: args.sections?.agreements ?? true,
+            intelligence: args.sections?.intelligence ?? true,
+            audio: args.sections?.audio ?? false,
+        };
+        const result = await this.pica.exports.catalogAssetReport({
+            sections,
+            attestation: {
+                signer_name: "MCP Agent",
+                declaration_accepted: true,
+            },
+        });
+        const data = result?.data ?? result;
+        let summary = [
+            `Catalog Asset Report generated`,
+            `Stage: ${data.stage ?? "unknown"}`,
+            `PICA Score: ${data.pica_score ?? "N/A"}${data.pica_grade ? ` (${data.pica_grade})` : ""}`,
+            `Sections: ownership${sections.valuation ? ", valuation" : ""}${sections.assets ? ", assets" : ""}${sections.agreements ? ", agreements" : ""}${sections.intelligence ? ", intelligence" : ""}${sections.audio ? ", audio" : ""}`,
+            data.file_size_bytes
+                ? `Size: ${(data.file_size_bytes / 1024).toFixed(1)} KB`
+                : null,
+            data.download_url ? `Download: ${data.download_url}` : null,
+        ]
+            .filter(Boolean)
+            .join("\n");
+        // ADR-146: Surface export gate warnings
+        if (data?.exportReadiness?.blockers?.length > 0) {
+            summary += `\nExport gate (${data.exportReadiness.mode} mode): ${data.exportReadiness.blockers.length} blocker(s)`;
+            for (const b of data.exportReadiness.blockers.slice(0, 5)) {
+                summary += `\n  ${b.type}: ${b.workTitle} — ${b.resolutionHint}`;
+            }
+            if (data.exportReadiness.blockers.length > 5) {
+                summary += `\n  ... and ${data.exportReadiness.blockers.length - 5} more`;
+            }
+        }
+        return formatSuccess(summary, data);
+    }
+    async exportAiConsent(_args) {
+        const result = await this.pica.exports.aiConsent();
+        return formatSuccess("AI consent declarations exported — shows disclosure level and training rights per work", result);
+    }
+}
+//# sourceMappingURL=exports.js.map

package/dist/tools/exports.js.map

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

package/dist/tools/import-documents.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Import Documents Tools - MCP tools for canonical ingestion documents
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class ImportDocumentTools {
+    private pica;
+    constructor(pica: PicaClient);
+    /**
+     * Get all import document tools
+     */
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private queryImportDocuments;
+    private inspectImportDocument;
+    private ingestStatement;
+    private computeDiff;
+}
+//# sourceMappingURL=import-documents.d.ts.map

package/dist/tools/import-documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-documents.d.ts","sourceRoot":"","sources":["../../src/tools/import-documents.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,mBAAmB;IAC9B,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YA0F3D,oBAAoB;YAOpB,qBAAqB;YA+DrB,eAAe;IAgB7B,OAAO,CAAC,WAAW;CAyDpB"}