@withpica/mcp-server 1.3.0

package/dist/tools/licensing.js

@@ -0,0 +1,436 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatAsText, formatList, formatSuccess } from "@withpica/mcp-utils";
+export class LicensingTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    /**
+     * Get all licensing tools
+     */
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_search_for_sync",
+                    description: "Search for licensable tracks by audio characteristics. " +
+                        "This is a powerful sync licensing search that finds tracks based on " +
+                        "mood, genre, BPM, musical key, energy level, and other audio features. " +
+                        "Use this when a music supervisor or client is looking for specific types of music.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            mood: {
+                                type: "string",
+                                description: "Comma-separated mood tags to search for (e.g., 'uplifting,energetic' or 'melancholic,introspective')",
+                            },
+                            genre: {
+                                type: "string",
+                                description: "Genre to filter by (e.g., 'electronic', 'acoustic', 'orchestral')",
+                            },
+                            min_bpm: {
+                                type: "number",
+                                description: "Minimum BPM (beats per minute)",
+                            },
+                            max_bpm: {
+                                type: "number",
+                                description: "Maximum BPM (beats per minute)",
+                            },
+                            key: {
+                                type: "string",
+                                description: "Musical key to filter by (e.g., 'C', 'Am', 'F#', 'Bb')",
+                            },
+                            min_energy: {
+                                type: "number",
+                                description: "Minimum energy level (0.0 to 1.0, where 1.0 is highest energy)",
+                            },
+                            max_energy: {
+                                type: "number",
+                                description: "Maximum energy level (0.0 to 1.0)",
+                            },
+                            min_valence: {
+                                type: "number",
+                                description: "Minimum valence/positivity (0.0 to 1.0, where 1.0 is most positive/happy)",
+                            },
+                            max_valence: {
+                                type: "number",
+                                description: "Maximum valence/positivity (0.0 to 1.0)",
+                            },
+                            min_duration: {
+                                type: "number",
+                                description: "Minimum duration in seconds",
+                            },
+                            max_duration: {
+                                type: "number",
+                                description: "Maximum duration in seconds",
+                            },
+                            instrumental_only: {
+                                type: "boolean",
+                                description: "Only return instrumental tracks (no vocals)",
+                            },
+                            available_for_sync: {
+                                type: "boolean",
+                                description: "Only return tracks marked as available for sync licensing",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Maximum number of results (default: 20, max: 100)",
+                            },
+                        },
+                    },
+                },
+                executor: this.searchForSync.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_submit_license_enquiry",
+                    description: "Submit a license enquiry for a track. Use this when a client wants to " +
+                        "license a specific track for their project. Captures project details, " +
+                        "territory, duration, and proposed budget.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "ID of the work to license",
+                            },
+                            track_title: {
+                                type: "string",
+                                description: "Title of the track (for reference)",
+                            },
+                            contact_name: {
+                                type: "string",
+                                description: "Name of the person making the enquiry",
+                            },
+                            contact_email: {
+                                type: "string",
+                                description: "Email address for contact",
+                            },
+                            company_name: {
+                                type: "string",
+                                description: "Company or organization name (optional)",
+                            },
+                            project_type: {
+                                type: "string",
+                                description: "Type of project",
+                                enum: [
+                                    "tv_ad",
+                                    "film",
+                                    "social_media",
+                                    "game",
+                                    "podcast",
+                                    "corporate",
+                                    "other",
+                                ],
+                            },
+                            project_description: {
+                                type: "string",
+                                description: "Description of how the music will be used in the project",
+                            },
+                            territory: {
+                                type: "string",
+                                description: "Geographic territory for the license (e.g., 'uk', 'eu', 'worldwide', 'north_america')",
+                            },
+                            duration: {
+                                type: "string",
+                                description: "License duration (e.g., '1_year', '3_years', 'perpetual')",
+                            },
+                            distribution: {
+                                type: "array",
+                                description: "Distribution channels (e.g., ['streaming', 'broadcast', 'cinema', 'social', 'web'])",
+                                items: {
+                                    type: "string",
+                                },
+                            },
+                            proposed_budget_amount: {
+                                type: "number",
+                                description: "Proposed license fee amount",
+                            },
+                            proposed_budget_currency: {
+                                type: "string",
+                                description: "Currency for the budget (e.g., 'GBP', 'USD', 'EUR')",
+                            },
+                            budget_notes: {
+                                type: "string",
+                                description: "Additional notes about the budget or negotiation flexibility",
+                            },
+                        },
+                        required: [
+                            "work_id",
+                            "track_title",
+                            "contact_name",
+                            "contact_email",
+                            "project_type",
+                            "project_description",
+                            "territory",
+                            "duration",
+                            "proposed_budget_amount",
+                            "proposed_budget_currency",
+                        ],
+                    },
+                },
+                executor: this.submitLicenseEnquiry.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_list_license_enquiries",
+                    description: "List license enquiries with optional filters. View pending, reviewed, " +
+                        "quoted, accepted, or declined enquiries.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "Filter by work ID",
+                            },
+                            status: {
+                                type: "string",
+                                description: "Filter by status",
+                                enum: [
+                                    "pending",
+                                    "reviewing",
+                                    "quoted",
+                                    "accepted",
+                                    "declined",
+                                    "expired",
+                                ],
+                            },
+                            project_type: {
+                                type: "string",
+                                description: "Filter by project type",
+                                enum: [
+                                    "tv_ad",
+                                    "film",
+                                    "social_media",
+                                    "game",
+                                    "podcast",
+                                    "corporate",
+                                    "other",
+                                ],
+                            },
+                            territory: {
+                                type: "string",
+                                description: "Filter by territory",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Maximum number of results (default: 50)",
+                            },
+                            offset: {
+                                type: "number",
+                                description: "Pagination offset (default: 0)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listLicenseEnquiries.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_get_license_enquiry",
+                    description: "Get details of a specific license enquiry by ID",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "License enquiry ID",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.getLicenseEnquiry.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_update_license_enquiry_status",
+                    description: "Update the status of a license enquiry. Use this to move enquiries " +
+                        "through the workflow (reviewing, quoted, accepted, declined).",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "License enquiry ID",
+                            },
+                            status: {
+                                type: "string",
+                                description: "New status",
+                                enum: [
+                                    "pending",
+                                    "reviewing",
+                                    "quoted",
+                                    "accepted",
+                                    "declined",
+                                    "expired",
+                                ],
+                            },
+                            notes: {
+                                type: "string",
+                                description: "Internal notes about the status change",
+                            },
+                        },
+                        required: ["id", "status"],
+                    },
+                },
+                executor: this.updateLicenseEnquiryStatus.bind(this),
+            },
+        ];
+    }
+    /**
+     * Search for sync-licensable tracks
+     */
+    async searchForSync(args) {
+        const result = await this.pica.licensing.searchForSync({
+            mood: args.mood,
+            genre: args.genre,
+            min_bpm: args.min_bpm,
+            max_bpm: args.max_bpm,
+            key: args.key,
+            min_energy: args.min_energy,
+            max_energy: args.max_energy,
+            min_valence: args.min_valence,
+            max_valence: args.max_valence,
+            min_duration: args.min_duration,
+            max_duration: args.max_duration,
+            instrumental_only: args.instrumental_only,
+            available_for_sync: args.available_for_sync,
+            limit: args.limit,
+        });
+        // Format tracks for display
+        const formattedTracks = result.tracks.map((track) => ({
+            id: track.id,
+            title: track.title,
+            work: track.work?.title || "No linked work",
+            artist: track.work?.primary_artist || "Unknown",
+            bpm: track.detected_bpm
+                ? `${Math.round(track.detected_bpm)} BPM`
+                : "Unknown",
+            key: track.detected_key || "Unknown",
+            energy: track.detected_energy
+                ? `${Math.round(track.detected_energy * 100)}%`
+                : "Unknown",
+            mood: track.detected_mood?.join(", ") || "Not analyzed",
+            duration: track.duration_seconds
+                ? `${Math.floor(track.duration_seconds / 60)}:${String(Math.floor(track.duration_seconds % 60)).padStart(2, "0")}`
+                : "Unknown",
+            available: track.published ? "Yes" : "No",
+        }));
+        return formatList(formattedTracks, {
+            title: "Sync Licensing Search Results",
+            total: result.count,
+            filters: result.filters,
+        });
+    }
+    /**
+     * Submit a license enquiry
+     */
+    async submitLicenseEnquiry(args) {
+        const enquiry = await this.pica.licensing.submitEnquiry({
+            work_id: args.work_id,
+            track_title: args.track_title,
+            contact_name: args.contact_name,
+            contact_email: args.contact_email,
+            company_name: args.company_name,
+            project_type: args.project_type,
+            project_description: args.project_description,
+            territory: args.territory,
+            duration: args.duration,
+            distribution: args.distribution,
+            proposed_budget_amount: args.proposed_budget_amount,
+            proposed_budget_currency: args.proposed_budget_currency,
+            budget_notes: args.budget_notes,
+        });
+        return formatSuccess("License enquiry submitted successfully", {
+            id: enquiry.id,
+            track: enquiry.track_title,
+            project_type: enquiry.project_type,
+            territory: enquiry.territory,
+            proposed_budget: `${enquiry.proposed_budget_currency} ${enquiry.proposed_budget_amount}`,
+            status: enquiry.status,
+        });
+    }
+    /**
+     * List license enquiries
+     */
+    async listLicenseEnquiries(args) {
+        const enquiries = await this.pica.licensing.listEnquiries({
+            work_id: args.work_id,
+            status: args.status,
+            project_type: args.project_type,
+            territory: args.territory,
+            limit: args.limit || 50,
+            offset: args.offset || 0,
+        });
+        // Format enquiries for display
+        const formattedEnquiries = enquiries.map((enquiry) => ({
+            id: enquiry.id,
+            track: enquiry.track_title,
+            contact: `${enquiry.contact_name} (${enquiry.contact_email})`,
+            company: enquiry.company_name || "Individual",
+            project: enquiry.project_type,
+            territory: enquiry.territory,
+            budget: `${enquiry.proposed_budget_currency} ${enquiry.proposed_budget_amount}`,
+            status: enquiry.status,
+            created: new Date(enquiry.created_at).toLocaleDateString(),
+        }));
+        return formatList(formattedEnquiries, {
+            title: "License Enquiries",
+            total: enquiries.length,
+        });
+    }
+    /**
+     * Get license enquiry by ID
+     */
+    async getLicenseEnquiry(args) {
+        const enquiry = await this.pica.licensing.getEnquiry(args.id);
+        const formatted = {
+            id: enquiry.id,
+            track: enquiry.track_title,
+            work_id: enquiry.work_id,
+            contact: {
+                name: enquiry.contact_name,
+                email: enquiry.contact_email,
+                company: enquiry.company_name,
+            },
+            project: {
+                type: enquiry.project_type,
+                description: enquiry.project_description,
+                territory: enquiry.territory,
+                duration: enquiry.duration,
+                distribution: enquiry.distribution,
+            },
+            budget: {
+                proposed: `${enquiry.proposed_budget_currency} ${enquiry.proposed_budget_amount}`,
+                counter_offer: enquiry.your_counter_offer
+                    ? `${enquiry.proposed_budget_currency} ${enquiry.your_counter_offer}`
+                    : null,
+                notes: enquiry.budget_notes,
+            },
+            status: enquiry.status,
+            internal_notes: enquiry.your_notes,
+            responded_at: enquiry.responded_at,
+            created_at: enquiry.created_at,
+        };
+        return formatAsText(formatted);
+    }
+    /**
+     * Update license enquiry status
+     */
+    async updateLicenseEnquiryStatus(args) {
+        const enquiry = await this.pica.licensing.updateEnquiryStatus(args.id, args.status, args.notes);
+        return formatSuccess("License enquiry status updated", {
+            id: enquiry.id,
+            track: enquiry.track_title,
+            status: enquiry.status,
+            notes: enquiry.your_notes,
+        });
+    }
+}
+//# sourceMappingURL=licensing.js.map

package/dist/tools/licensing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"licensing.js","sourceRoot":"","sources":["../../src/tools/licensing.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAW7D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9E,MAAM,OAAO,cAAc;IACjB,IAAI,CAAa;IAEzB,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,sBAAsB;oBAC5B,WAAW,EACT,yDAAyD;wBACzD,sEAAsE;wBACtE,yEAAyE;wBACzE,oFAAoF;oBACtF,SAAS,EAAE,gBAAgB;oBAC3B,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,IAAI,EAAE;gCACJ,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,sGAAsG;6BACzG;4BACD,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,mEAAmE;6BACtE;4BACD,OAAO,EAAE;gCACP,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,gCAAgC;6BAC9C;4BACD,OAAO,EAAE;gCACP,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,gCAAgC;6BAC9C;4BACD,GAAG,EAAE;gCACH,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,wDAAwD;6BAC3D;4BACD,UAAU,EAAE;gCACV,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,gEAAgE;6BACnE;4BACD,UAAU,EAAE;gCACV,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,mCAAmC;6BACjD;4BACD,WAAW,EAAE;gCACX,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,2EAA2E;6BAC9E;4BACD,WAAW,EAAE;gCACX,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,yCAAyC;6BACvD;4BACD,YAAY,EAAE;gCACZ,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,6BAA6B;6BAC3C;4BACD,YAAY,EAAE;gCACZ,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,6BAA6B;6BAC3C;4BACD,iBAAiB,EAAE;gCACjB,IAAI,EAAE,SAAS;gCACf,WAAW,EAAE,6CAA6C;6BAC3D;4BACD,kBAAkB,EAAE;gCAClB,IAAI,EAAE,SAAS;gCACf,WAAW,EACT,2DAA2D;6BAC9D;4BACD,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,mDAAmD;6BACtD;yBACF;qBACF;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;aACxC;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,6BAA6B;oBACnC,WAAW,EACT,wEAAwE;wBACxE,wEAAwE;wBACxE,2CAA2C;oBAC7C,SAAS,EAAE,gBAAgB;oBAC3B,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,OAAO,EAAE;gCACP,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,2BAA2B;6BACzC;4BACD,WAAW,EAAE;gCACX,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,oCAAoC;6BAClD;4BACD,YAAY,EAAE;gCACZ,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,uCAAuC;6BACrD;4BACD,aAAa,EAAE;gCACb,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,2BAA2B;6BACzC;4BACD,YAAY,EAAE;gCACZ,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,yCAAyC;6BACvD;4BACD,YAAY,EAAE;gCACZ,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,iBAAiB;gCAC9B,IAAI,EAAE;oCACJ,OAAO;oCACP,MAAM;oCACN,cAAc;oCACd,MAAM;oCACN,SAAS;oCACT,WAAW;oCACX,OAAO;iCACR;6BACF;4BACD,mBAAmB,EAAE;gCACnB,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,0DAA0D;6BAC7D;4BACD,SAAS,EAAE;gCACT,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,uFAAuF;6BAC1F;4BACD,QAAQ,EAAE;gCACR,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,2DAA2D;6BAC9D;4BACD,YAAY,EAAE;gCACZ,IAAI,EAAE,OAAO;gCACb,WAAW,EACT,qFAAqF;gCACvF,KAAK,EAAE;oCACL,IAAI,EAAE,QAAQ;iCACf;6BACF;4BACD,sBAAsB,EAAE;gCACtB,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,6BAA6B;6BAC3C;4BACD,wBAAwB,EAAE;gCACxB,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,qDAAqD;6BACxD;4BACD,YAAY,EAAE;gCACZ,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,8DAA8D;6BACjE;yBACF;wBACD,QAAQ,EAAE;4BACR,SAAS;4BACT,aAAa;4BACb,cAAc;4BACd,eAAe;4BACf,cAAc;4BACd,qBAAqB;4BACrB,WAAW;4BACX,UAAU;4BACV,wBAAwB;4BACxB,0BAA0B;yBAC3B;qBACF;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;aAC/C;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,6BAA6B;oBACnC,WAAW,EACT,wEAAwE;wBACxE,0CAA0C;oBAC5C,SAAS,EAAE,gBAAgB;oBAC3B,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,OAAO,EAAE;gCACP,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,mBAAmB;6BACjC;4BACD,MAAM,EAAE;gCACN,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,kBAAkB;gCAC/B,IAAI,EAAE;oCACJ,SAAS;oCACT,WAAW;oCACX,QAAQ;oCACR,UAAU;oCACV,UAAU;oCACV,SAAS;iCACV;6BACF;4BACD,YAAY,EAAE;gCACZ,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,wBAAwB;gCACrC,IAAI,EAAE;oCACJ,OAAO;oCACP,MAAM;oCACN,cAAc;oCACd,MAAM;oCACN,SAAS;oCACT,WAAW;oCACX,OAAO;iCACR;6BACF;4BACD,SAAS,EAAE;gCACT,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,qBAAqB;6BACnC;4BACD,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,yCAAyC;6BACvD;4BACD,MAAM,EAAE;gCACN,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,gCAAgC;6BAC9C;yBACF;qBACF;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;aAC/C;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,0BAA0B;oBAChC,WAAW,EAAE,iDAAiD;oBAC9D,SAAS,EAAE,gBAAgB;oBAC3B,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,EAAE,EAAE;gCACF,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,oBAAoB;6BAClC;yBACF;wBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;qBACjB;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;aAC5C;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,oCAAoC;oBAC1C,WAAW,EACT,qEAAqE;wBACrE,+DAA+D;oBACjE,SAAS,EAAE,gBAAgB;oBAC3B,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,EAAE,EAAE;gCACF,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,oBAAoB;6BAClC;4BACD,MAAM,EAAE;gCACN,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,YAAY;gCACzB,IAAI,EAAE;oCACJ,SAAS;oCACT,WAAW;oCACX,QAAQ;oCACR,UAAU;oCACV,UAAU;oCACV,SAAS;iCACV;6BACF;4BACD,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,wCAAwC;6BACtD;yBACF;wBACD,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC;qBAC3B;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC;aACrD;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CAAC,IAAyB;QACnD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;YACrD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;YAC3C,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QAEH,4BAA4B;QAC5B,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACpD,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,gBAAgB;YAC3C,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,cAAc,IAAI,SAAS;YAC/C,GAAG,EAAE,KAAK,CAAC,YAAY;gBACrB,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM;gBACzC,CAAC,CAAC,SAAS;YACb,GAAG,EAAE,KAAK,CAAC,YAAY,IAAI,SAAS;YACpC,MAAM,EAAE,KAAK,CAAC,eAAe;gBAC3B,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,GAAG,GAAG,CAAC,GAAG;gBAC/C,CAAC,CAAC,SAAS;YACb,IAAI,EAAE,KAAK,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,cAAc;YACvD,QAAQ,EAAE,KAAK,CAAC,gBAAgB;gBAC9B,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,GAAG,EAAE,CAAC,IAAI,MAAM,CAClD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,GAAG,EAAE,CAAC,CACxC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;gBACtB,CAAC,CAAC,SAAS;YACb,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;SAC1C,CAAC,CAAC,CAAC;QAEJ,OAAO,UAAU,CAAC,eAAe,EAAE;YACjC,KAAK,EAAE,+BAA+B;YACtC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,oBAAoB,CAChC,IAAyB;QAEzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;YACtD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;YAC7C,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;YACnD,wBAAwB,EAAE,IAAI,CAAC,wBAAwB;YACvD,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;QAEH,OAAO,aAAa,CAAC,wCAAwC,EAAE;YAC7D,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,KAAK,EAAE,OAAO,CAAC,WAAW;YAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,eAAe,EAAE,GAAG,OAAO,CAAC,wBAAwB,IAAI,OAAO,CAAC,sBAAsB,EAAE;YACxF,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,oBAAoB,CAChC,IAAyB;QAEzB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;YACxD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC;SACzB,CAAC,CAAC;QAEH,+BAA+B;QAC/B,MAAM,kBAAkB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACrD,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,KAAK,EAAE,OAAO,CAAC,WAAW;YAC1B,OAAO,EAAE,GAAG,OAAO,CAAC,YAAY,KAAK,OAAO,CAAC,aAAa,GAAG;YAC7D,OAAO,EAAE,OAAO,CAAC,YAAY,IAAI,YAAY;YAC7C,OAAO,EAAE,OAAO,CAAC,YAAY;YAC7B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,GAAG,OAAO,CAAC,wBAAwB,IAAI,OAAO,CAAC,sBAAsB,EAAE;YAC/E,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,kBAAkB,EAAE;SAC3D,CAAC,CAAC,CAAC;QAEJ,OAAO,UAAU,CAAC,kBAAkB,EAAE;YACpC,KAAK,EAAE,mBAAmB;YAC1B,KAAK,EAAE,SAAS,CAAC,MAAM;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB,CAC7B,IAAyB;QAEzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAE9D,MAAM,SAAS,GAAG;YAChB,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,KAAK,EAAE,OAAO,CAAC,WAAW;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE;gBACP,IAAI,EAAE,OAAO,CAAC,YAAY;gBAC1B,KAAK,EAAE,OAAO,CAAC,aAAa;gBAC5B,OAAO,EAAE,OAAO,CAAC,YAAY;aAC9B;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,OAAO,CAAC,YAAY;gBAC1B,WAAW,EAAE,OAAO,CAAC,mBAAmB;gBACxC,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC;YACD,MAAM,EAAE;gBACN,QAAQ,EAAE,GAAG,OAAO,CAAC,wBAAwB,IAAI,OAAO,CAAC,sBAAsB,EAAE;gBACjF,aAAa,EAAE,OAAO,CAAC,kBAAkB;oBACvC,CAAC,CAAC,GAAG,OAAO,CAAC,wBAAwB,IAAI,OAAO,CAAC,kBAAkB,EAAE;oBACrE,CAAC,CAAC,IAAI;gBACR,KAAK,EAAE,OAAO,CAAC,YAAY;aAC5B;YACD,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,cAAc,EAAE,OAAO,CAAC,UAAU;YAClC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC;QAEF,OAAO,YAAY,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,0BAA0B,CACtC,IAAyB;QAEzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAC3D,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,KAAK,CACX,CAAC;QAEF,OAAO,aAAa,CAAC,gCAAgC,EAAE;YACrD,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,KAAK,EAAE,OAAO,CAAC,WAAW;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,OAAO,CAAC,UAAU;SAC1B,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/tools/memory.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Memory Tools — MCP tools for persistent workspace memory
+ *
+ * Backed by the assistant_memory system via REST routes (/api/admin/memory/*).
+ * Allows AI agents to save and retrieve workspace-specific knowledge.
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class MemoryTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listMemories;
+    private searchMemories;
+    private saveMemory;
+    private deleteMemory;
+}
+//# sourceMappingURL=memory.d.ts.map

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

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

package/dist/tools/memory.js

@@ -0,0 +1,120 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatSuccess, formatStructuredList, } from "@withpica/mcp-utils";
+export class MemoryTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_memory_list",
+                    description: "List all memories for this workspace (personal + workspace-wide). Use to recall stored context.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.listMemories.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_memory_search",
+                    description: "Search memories by keyword. Use when you need to find specific stored context.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            query: {
+                                type: "string",
+                                description: "Search query to match against memory keys and content",
+                            },
+                        },
+                        required: ["query"],
+                    },
+                },
+                executor: this.searchMemories.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_memory_save",
+                    description: "Save a memory for this workspace. Use to store important context, decisions, or preferences.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            key: {
+                                type: "string",
+                                description: "Short identifier for this memory (e.g., 'sync_licensing_priority', 'publisher_x_requirements')",
+                            },
+                            content: {
+                                type: "string",
+                                description: "The memory content to store",
+                            },
+                            scope: {
+                                type: "string",
+                                enum: ["personal", "organisation"],
+                                description: "Scope: 'personal' (only this user) or 'organisation' (shared with team). Default: personal.",
+                            },
+                            type: {
+                                type: "string",
+                                enum: [
+                                    "preference",
+                                    "business_rule",
+                                    "catalog_fact",
+                                    "decision",
+                                    "relationship",
+                                ],
+                                description: "Type of memory. Default: preference.",
+                            },
+                        },
+                        required: ["key", "content"],
+                    },
+                },
+                executor: this.saveMemory.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_memory_delete",
+                    description: "Delete a memory by ID. Use to remove outdated or incorrect stored context.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Memory ID to delete",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.deleteMemory.bind(this),
+            },
+        ];
+    }
+    async listMemories(_args) {
+        const memories = await this.pica.memory.list();
+        return formatStructuredList(memories, "memory");
+    }
+    async searchMemories(args) {
+        const memories = await this.pica.memory.search(args.query);
+        return formatStructuredList(memories, "memory", { query: args.query });
+    }
+    async saveMemory(args) {
+        const memory = await this.pica.memory.save({
+            key: args.key,
+            content: args.content,
+            scope: args.scope,
+            type: args.type,
+        });
+        return formatSuccess("Memory saved successfully", memory);
+    }
+    async deleteMemory(args) {
+        await this.pica.memory.delete(args.id);
+        return formatSuccess(`Memory ${args.id} deleted successfully`);
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/tools/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/tools/memory.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAW7D,OAAO,EAEL,aAAa,EACb,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,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,kBAAkB;oBACxB,WAAW,EACT,iGAAiG;oBACnG,SAAS,EAAE,gBAAgB;oBAC3B,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE,EAAE;qBACf;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;aACvC;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,oBAAoB;oBAC1B,WAAW,EACT,gFAAgF;oBAClF,SAAS,EAAE,gBAAgB;oBAC3B,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,uDAAuD;6BAC1D;yBACF;wBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;qBACpB;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;aACzC;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,kBAAkB;oBACxB,WAAW,EACT,8FAA8F;oBAChG,SAAS,EAAE,gBAAgB;oBAC3B,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,GAAG,EAAE;gCACH,IAAI,EAAE,QAAQ;gCACd,WAAW,EACT,gGAAgG;6BACnG;4BACD,OAAO,EAAE;gCACP,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,6BAA6B;6BAC3C;4BACD,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,IAAI,EAAE,CAAC,UAAU,EAAE,cAAc,CAAC;gCAClC,WAAW,EACT,6FAA6F;6BAChG;4BACD,IAAI,EAAE;gCACJ,IAAI,EAAE,QAAQ;gCACd,IAAI,EAAE;oCACJ,YAAY;oCACZ,eAAe;oCACf,cAAc;oCACd,UAAU;oCACV,cAAc;iCACf;gCACD,WAAW,EAAE,sCAAsC;6BACpD;yBACF;wBACD,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC;qBAC7B;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;aACrC;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,oBAAoB;oBAC1B,WAAW,EACT,4EAA4E;oBAC9E,SAAS,EAAE,gBAAgB;oBAC3B,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,EAAE,EAAE;gCACF,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,qBAAqB;6BACnC;yBACF;wBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;qBACjB;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;aACvC;SACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,KAA0B;QACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC/C,OAAO,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,IAAyB;QACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3D,OAAO,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,IAAyB;QAChD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACzC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;QACH,OAAO,aAAa,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,IAAyB;QAClD,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvC,OAAO,aAAa,CAAC,UAAU,IAAI,CAAC,EAAE,uBAAuB,CAAC,CAAC;IACjE,CAAC;CACF"}

package/dist/tools/metadata.d.ts

@@ -0,0 +1,15 @@
+import type { ToolMetadata } from "./index.js";
+/**
+ * Metadata registry for all 193 MCP tools.
+ *
+ * Categories: catalog, enrichment, business, discovery, media, comms, settings
+ * Risk: safe (read-only), mutating (creates/modifies), destructive (deletes/merges)
+ * retry_safe: true for safe tools, false for destructive, varies for mutating
+ */
+export declare const TOOL_METADATA: Record<string, ToolMetadata>;
+/**
+ * Look up metadata for a tool by name.
+ * Returns undefined if the tool is not registered.
+ */
+export declare function getToolMetadata(name: string): ToolMetadata | undefined;
+//# sourceMappingURL=metadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/tools/metadata.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAuhDtD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEtE"}