@withpica/mcp-server 2.6.2 → 2.7.0

package/dist/tools/licensing.js

@@ -1,431 +0,0 @@
-// 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.",
-                    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.",
-                    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.",
-                    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",
-                    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).",
-                    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

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

package/dist/tools/memory.d.ts

@@ -1,21 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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;YA8F3D,YAAY;YAKZ,cAAc;YAKd,UAAU;YAUV,YAAY;CAI3B"}

package/dist/tools/memory.js

@@ -1,116 +0,0 @@
-// 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 + organisation-wide). Use to recall stored context.",
-                    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.",
-                    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.",
-                    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.",
-                    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

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

package/dist/tools/metadata.d.ts

@@ -1,15 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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,CAgkCtD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEtE"}